*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

Subscription

แทนที่การสมัครสมาชิกของผู้ใช้กับผลิตภัณฑ์สมัครสมาชิก รหัสสมัครสมาชิกจะเหมือนกับรหัสผู้ใช้ของผู้ใช้ที่สมัคร

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของสมัครสมาชิก

รูปแบบ: universes/{universe_id}/subscription-products/{subscription_product_id}/subscriptions/{subscription_id}.

createTimestring

เอาต์พุตเท่านั้น

เวลาที่สร้างสมัครสมาชิก เมื่อสร้างแล้ว. สตริงนี้มีรูปแบบประทับเวลา

updateTimestring

เอาต์พุตเท่านั้น

เวลาที่ลงทะเบียนอัปเดตล่าสุด เมื่อสมัครสมาชิกอัปเดตล่าสุด. สตริงนี้มีรูปแบบประทับเวลา

activeboolean

เอาต์พุตเท่านั้น

ว่าการสมัครสมาชิกมีอยู่แล้วหรือไม่

นี่เทียบเท่ากับว่า state เท่ากับ SUBSCRIBED_WILL_RENEW, SUBSCRIBED_WILL_NOT_RENEW หรือ SUBSCRIBED_RENEWAL_PAYMENT_PENDING.

willRenewboolean

เอาต์พุตเท่านั้น

ว่าการสมัครสมาชิกจะต่ออายุหรือไม่

นี่เทียบเท่ากับว่า state เท่ากับ SUBSCRIBED_WILL_RENEW หรือ SUBSCRIBED_RENEWAL_PAYMENT_PENDING.

lastBillingTimestring

เอาต์พุตเท่านั้น

เวลาที่ลงทะเบียนครั้งล่าสุดเสียค่าบริการ. สตริงนี้มีรูปแบบประทับเวลา

nextRenewTimestring

เอาต์พุตเท่านั้น

เวลาที่ลงทะเบียนจะถูกต่ออายุโดยอัตโนมัติเมื่อถึงกำหนดถัดไป. สตริงนี้มีรูปแบบประทับเวลา

expireTimestring

เอาต์พุตเท่านั้น

เวลาที่เซิร์ฟเวอร์สมัครสมาชิกจะหมดอายุ หรือทำได้. สตริงนี้มีรูปแบบประทับเวลา

stateEnum<string>

เอาต์พุตเท่านั้น

สถานะของการสมัครสมาชิก

มูลค่าที่เป็นไปได้:

| ค่า | คำอธิบาย | | --- | --- | | STATE_UNSPECIFIED | สถานะการสมัครไม่ได้ระบุไว้| | SUBSCRIBED_WILL_RENEW | การสมัครสมาชิกมีอยู่และจะได้รับการต่ออายุอัตโนมัติที่ next_renew_time| | SUBSCRIBED_WILL_NOT_RENEW | การสมัครสมาชิกมีอยู่แล้ว แต่จะไม่ถูกต่ออายุโดยอัตโนมัติ| | SUBSCRIBED_RENEWAL_PAYMENT_PENDING | การสมัครสมาชิกมีอยู่และอยู่ภายในระยะเวลาของการต่ออายุที่รอการชำระเงินยืนยัน| | หมดอายุแล้ว | สมัครสมาชิกหมดอายุแล้วดู expiration_details สำหรับข้อมูลเพิ่มเติม |. ค่าที่เป็นไปได้:

expirationDetailsobject

ข้อมูลเกี่ยวกับการหมดอายุของสมาชิก.

purchasePlatformEnum<string>

เอาต์พุตเท่านั้น

แพลตฟอร์มที่ซื้อสมัครสมาชิก บน

มูลค่าที่เป็นไปได้:

| ค่า | คำอธิบาย | | --- | --- | | PURCHASE_PLATFORM_UNSPECIFIED | แพลตฟอร์มการซื้อไม่ได้ระบุ| | DESKTOP | การสมัครสมาชิกถูกซื้อบนเว็บไซต์ Roblox| | มือถือ | การสมัครสมาชิกถูกซื้อจากแอปมือถือ Roblox |. ค่าที่เป็นไปได้:

paymentProviderEnum<string>

เอาต์พุตเท่านั้น

ผู้ให้บริการชำระเงินที่ใช้ซื้อสมาชิกสมาชิก

มูลค่าที่เป็นไปได้:

| ค่า | คำอธิบาย | | --- | --- | | PAYMENT_PROVIDER_UNSPECIFIED | ผู้ให้บริการการชำระเงินไม่ได้ระบุ| | STRIPE | การสมัครสมาชิกถูกซื้อโดยใช้ Stripe| | APPLE | สมัครสมาชิกถูกซื้อโดยใช้ Apple| | GOOGLE | การสมัครสมาชิกถูกซื้อโดยใช้ Google| | ROBLOX_CREDIT | การสมัครสมาชิกถูกซื้อโดยใช้ Roblox Credit |. ค่าที่เป็นไปได้:

userstring

ไม่สามารถเปลี่ยนแปลงได้

ผู้ใช้ที่สมัครสมาชิกสำหรับการสมัครสมาชิก.

URL หลัก

https://apis.roblox.com

แหล่งข้อมูล Subscription

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

รับสมัครสมาชิก
เวอร์ชัน Beta

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

รับสมัครสมาชิก

ขอบเขต universe.subscription-product.subscription:read อนุญาตให้คุณรับสมัครของตัวเองเท่านั้น—หรือกล่าวอีกนัยหนึ่ง ID สมัครจะต้องตรงกับรหัสผู้ใช้ที่ทําให้คําขอ—ดังนั้นกรณีการใช้งานที่ดีที่สุดคือการใช้การตรวจสอบด้วย OAuth 2.0 แทนที่จะใช้กุญแจ APIเพื่ออ่านการสมัครสมาชิกทั้งหมดสำหรับจักรวาลให้ใช้ขอบเขต universe:write

ขอบเขต

universe:writeuniverse.subscription-product.subscription:read

คำขอพารามิเตอร์เส้นทาง

universe_idstring

จำเป็นต้องมี

ID ของจักรวาล.

subscription_product_idstring

จำเป็นต้องมี

รหัสผลิตภัณฑ์สมัครสมาชิก.

subscription_idstring

จำเป็นต้องมี

รหัสสมัครสมาชิก.

พารามิเตอร์คิวรี

viewEnum<string>

มุมมองที่จะดึงการสมัครสมาชิก

รองรับพื้นฐานและเต็ม

ค่าเริ่มต้นเป็น BASIC

มูลค่าที่เป็นไปได้:

| ค่า | คําอธิบาย | | --- | --- | | VIEW_UNSPECIFIED | มุมมองการสมัครไม่ได้ระบุ; ค่าเริ่มต้นจะถูกใช้| | พื้นฐาน | รวมเฉพาะฟิลด์ active และ renewing เท่านั้น| | เต็ม | รวมถึงทุกฟิลด์ |. ค่าที่เป็นไปได้:

การตอบกลับSubscription

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

Subscription

คุณลักษณะ

Subscription

รับสมัครสมาชิกเวอร์ชัน Beta

รับสมัครสมาชิก
เวอร์ชัน Beta