구독의 리소스 경로.
형식: universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}.
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
Subscription
구독 제품에 대한 사용자 구독을 나타냅니다. 구독 ID는 구독한 사용자의 사용자 ID와 동일합니다.
특성
구독이 생성된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.
구독이 마지막으로 업데이트된 시간戳. 이 문자열은 Timestamp 형식으로 지정됩니다.
구독이 활성 상태인지 여부.
이것은 state 가 SUBSCRIBED_WILL_RENEW, SUBSCRIBED_WILL_NOT_RENEW 또는 SUBSCRIBED_RENEWAL_PAYMENT_PENDING과 같은지 여부와 동일합니다.
구독이 갱신되는지 여부.
이는 state 가 SUBSCRIBED_WILL_RENEW 또는 SUBSCRIBED_RENEWAL_PAYMENT_PENDING과 같은지 여부와 동일합니다.
구독이 마지막으로 청구된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.
구독이 다음에 자동으로 갱신될 때의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.
구독이 만료되거나 만료될 때의 타임스탬프. The timestamp when the subscription will, or did, expire. 이 문자열은 Timestamp 형식으로 지정됩니다.
구독의 상태.
가능한 값:
| 값 | 설명 | | --- | --- | | STATE_UNSPECIFIED | 구독 상태가 지정되지 않았습니다.| | SUBSCRIBED_WILL_RENEW | 구독이 활성화되었으며 next_renew_time에서 자동으로 갱신됩니다.| | SUBSCRIBED_WILL_NOT_RENEW | 구독은 활성화되었지만 자동으로 갱신되지 않습니다.| | SUBSCRIBED_RENEWAL_PAYMENT_PENDING | 구독이 활성화되었으며 지불 확인을 기다리는 갱신 기간 내에 있습니다.| | 만료됨 | 구독이 만료되었습니다.자세한 내용은 expiration_details에 참조하십시오. |. 가능한 값:
구독 만료 정보.
구독이 구매된 플랫폼.
가능한 값:
| 값 | 설명 | | --- | --- | | PURCHASE_PLATFORM_UNSPECIFIED | 구매 플랫폼이 지정되지 않았습니다.| | DESKTOP | 구독은 Roblox 웹사이트에서 구매되었습니다.| | 모바일 | 구독은 Roblox 모바일 앱에서 구매되었습니다. |. 가능한 값:
구독을 구매하기 위해 사용된 지불 공급자.
가능한 값:
| 값 | 설명 | | --- | --- | | PAYMENT_PROVIDER_UNSPECIFIED | 지불 공급자가 지정되지 않았습니다.| | STRIPE | 구독은 Stripe를 사용하여 구매되었습니다.| | APPLE | 구독은 Apple을 사용하여 구매되었습니다.| | GOOGLE | 구독은 Google을 사용하여 구매되었습니다.| | ROBLOX_CREDIT | 구독은 Roblox 크레딧을 사용하여 구매되었습니다. |. 가능한 값:
구독에 가입한 사용자.
기본 URL
https://apis.roblox.comSubscription 리소스
{
"path": "universes/123/subscription-products/some-subscription-product-id/subscriptions/some-subscription-id",
"createTime": "2023-07-05T12:34:56Z",
"updateTime": "2023-07-05T12:34:56Z",
"active": true,
"willRenew": true,
"lastBillingTime": "2023-07-05T12:34:56Z",
"nextRenewTime": "2023-07-05T12:34:56Z",
"expireTime": "2023-07-05T12:34:56Z",
"state": "STATE_UNSPECIFIED",
"expirationDetails": {
"reason": "EXPIRATION_REASON_UNSPECIFIED"
},
"purchasePlatform": "PURCHASE_PLATFORM_UNSPECIFIED",
"paymentProvider": "PAYMENT_PROVIDER_UNSPECIFIED",
"user": "users/123"
}Subscription
구독 받기
GET /cloud/v2/universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}
구독을 가져옵니다.
범위 universe.subscription-product.subscription:read 는 자신의 구독만 가져올 수 있도록 허용하며, 구독 ID는 요청을 만드는 사용자 ID와 일치해야 하므로 가장 좋은 사용 사례는 API 키가 아닌 OAuth 2.0 인증과 함께 사용됩니다.우주에 대한 모든 구독을 읽으려면 universe:write 범위를 사용하십시오.
universe:writeuniverse.subscription-product.subscription:read
요청경로 매개 변수유니버스 ID.
구독 제품 ID.
구독 ID.
구독을 검색할 뷰.
기본과 전체를 지원합니다.
기본값은 BASIC입니다.
가능한 값:
| 값 | 설명 | | --- | --- | | VIEW_UNSPECIFIED | 구독 보기가 지정되지 않았으므로 기본값이 사용됩니다.| | 기본 | active 및 renewing 필드만 포함합니다.| | FULL | 모든 필드를 포함합니다. |. 가능한 값:
GET /cloud/v2/universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}?view={string}' \
-H 'x-api-key: {your-api-key}'응답
{
"path": "universes/123/subscription-products/some-subscription-product-id/subscriptions/some-subscription-id",
"createTime": "2023-07-05T12:34:56Z",
"updateTime": "2023-07-05T12:34:56Z",
"active": true,
"willRenew": true,
"lastBillingTime": "2023-07-05T12:34:56Z",
"nextRenewTime": "2023-07-05T12:34:56Z",
"expireTime": "2023-07-05T12:34:56Z",
"state": "STATE_UNSPECIFIED",
"expirationDetails": {
"reason": "EXPIRATION_REASON_UNSPECIFIED"
},
"purchasePlatform": "PURCHASE_PLATFORM_UNSPECIFIED",
"paymentProvider": "PAYMENT_PROVIDER_UNSPECIFIED",
"user": "users/123"
}