*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Subscription

Bir kullanıcının bir abonelik ürününe aboneliğini temsil eder. Abonelik kimliği, abone olan kullanıcının kullanıcı kimliği ile aynıdır.

Nitelikler

pathstring

Abonenin kaynak yolu.

Biçim: universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}.

createTimestring

Yalnızca Çıkış

Abonmanın oluşturulduğu tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

updateTimestring

Yalnızca Çıkış

Abonmanın son kez güncellendiği tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

activeboolean

Yalnızca Çıkış

Abonmanın aktif olup olmadığı.

Bu, state 'nin SUBSCRIBED_WILL_RENEW, SUBSCRIBED_WILL_NOT_RENEW veya SUBSCRIBED_RENEWAL_PAYMENT_PENDING ile eşit olup olmadığına eşdeğerdir.

willRenewboolean

Yalnızca Çıkış

Abonmanın yenilenmesi.

Bu, state 'nin SUBSCRIBED_WILL_RENEW veya SUBSCRIBED_RENEWAL_PAYMENT_PENDING ile eşit olup olmadığına eşdeğerdir.

lastBillingTimestring

Yalnızca Çıkış

Abonelik son kez faturalandığındaki zaman damgası. Bu dizi Timestamp olarak biçimlendirilmiş.

nextRenewTimestring

Yalnızca Çıkış

Abonmanın bir sonraki otomatik olarak yenilenmesi için zaman damgası. Bu dizi Timestamp olarak biçimlendirilmiş.

expireTimestring

Yalnızca Çıkış

Abonelik sona erdiğinde veya erdiğinde tarih zamanı. Bu dizi Timestamp olarak biçimlendirilmiş.

stateEnum<string>

Yalnızca Çıkış

Abonmanın durumu.

Olası değerler:

| Değer | Açıklama | | --- | --- | | STATE_UNSPECIFIED | Abonelik durumu belirlenmedi.| | SUBSCRIBED_WILL_RENEW | Abonelik aktif ve next_renew_time 'de otomatik olarak yenileniyor olacak.| | SUBSCRIBED_WILL_NOT_RENEW | Abonelik aktif, ancak otomatik olarak yenilenmeyecek.| | SUBSCRIBED_RENEWAL_PAYMENT_PENDING | Abonelik aktif ve yenileme bekleme süresinde ödeme onayı bekleyen süre içinde.| | SONA ERDİ | Abonelik sona erdi.Daha fazla bilgi için expiration_details bakın. |. Olası değerler:

expirationDetailsobject

Abonenin sona ermesiyle ilgili bilgiler.

purchasePlatformEnum<string>

Yalnızca Çıkış

Abonelik satın alınan platform.

Olası değerler:

| Değer | Açıklama | | --- | --- | | PURCHASE_PLATFORM_UNSPECIFIED | Satın alma platformu belirlenmedi.| | MASAÜSTÜ | Abonelik Roblox web sitesinde satın alındı.| | MOBİL | Abonelik Roblox mobil uygulamasında satın alındı. |. Olası değerler:

paymentProviderEnum<string>

Yalnızca Çıkış

Aboneliği satın almak için kullanılan ödeme sağlayıcı.

Olası değerler:

| Değer | Açıklama | | --- | --- | | PAYMENT_PROVIDER_UNSPECIFIED | Ödeme sağlayıcısı belirlenmedi.| | STRIPE | Abonelik Stripe kullanılarak satın alındı.| | APPLE | Abonelik Apple kullanılarak satın alındı.| | GOOGLE | Abonelik Google kullanılarak satın alındı.| | ROBLOX_CREDIT | Abonelik Roblox Kredisi kullanılarak satın alındı. |. Olası değerler:

userstring

Sabit

Aboneliğe abone olan kullanıcı.

Taban URL

https://apis.roblox.com

Subscription Kaynağı

{
  "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

Abonelik Alın
Beta

GET /cloud/v2/universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}

Aboneliği alın.

The universe.subscription-product.subscription:read alanı yalnızca kendi aboneliklerinizi almanıza izin verir - ya da daha doğrusu, abonelik kimliği isteği yapan kullanıcı kimliğine uymalıdır, bu yüzden en iyi kullanım durumu API anahtarı yerine OAuth 2.0 doğrulamasıdır.Bir evren için tüm abonelikleri okumak için, universe:write alanını kullanın.

Kapsamlar

universe:writeuniverse.subscription-product.subscription:read

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

subscription_product_idstring

Gerekli

Abonelik ürünü ID'si.

subscription_idstring

Gerekli

Abonelik kimliği.

Sorgu Parametreleri

viewEnum<string>

Aboneliği almak için görüntü.

BASIC ve FULL'u destekler.

Varsayılan BASIC'e.

Olası değerler:

| Değer | Açıklama | | --- | --- | | VIEW_UNSPECIFIED | Abonelik görünümü belirtilmedi; varsayılan kullanılacak.| | BASİT | Sadece active ve renewing alanlarını içerir.| | DOLU | Tüm alanları içerir. |. Olası değerler:

YanıtSubscription

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}'

Yanıt

{
  "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

Nitelikler

Subscription

Abonelik AlınBeta

Abonelik Alın
Beta