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

AssetQuota

แทนที่ความจำกัดสำหรับการดำเนินการที่เกี่ยวข้องกับสินทรัพย์

ตัวอย่างเช่นผู้ใช้อาจสามารถอัปโหลดไฟล์เสียง 100 ไฟล์ต่อเดือนและอัปโหลดไปแล้ว 15 ไฟล์แล้ว ในตัวอย่างนี้:

  • quotaType is RATE_LIMIT_UPLOAD
  • assetType is AUDIO
  • usage is 15
  • capacity is 100
  • period คือ MONTH``usageResetTime บ่งบอกเมื่อระยะเวลาใหม่เริ่มต้นและการใช้งานรีเซ็ตเป็น 0ค่านี้ ไม่จำเป็นต้องมีความสัมพันธ์กับวันแรกของเดือนปฏิทินหรือเที่ยงคืนในวันใดวันหนึ่งสำหรับข้อมูลเพิ่มเติมเกี่ยวกับกระบวนการอัปโหลด ดูคู่มือการใช้งาน

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของความถูกต้องของสินทรัพย์

รูปแบบ: users/{user_id}/asset-quotas/{asset_quota_id}.

quotaTypeEnum<string>

ประเภทของความจำกัดจำนวน

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

| ค่า | คำอธิบาย | | --- | --- | | QUOTA_TYPE_UNSPECIFIED | ประเภทความจำเป็นเริ่มต้น| | RATE_LIMIT_UPLOAD | ขีดจํากัดอัตราในการอัปโหลดสินทรัพย์ที่บ่อยเพียงใด| | RATE_LIMIT_CREATOR_STORE_DISTRIBUTE | ขีดจํากัดอัตราในการจัดจำหน่ายสินทรัพย์บน Creator Store บ่อยแค่ไหน |. ค่าที่เป็นไปได้:

assetTypeEnum<string>

ประเภทสินทรัพย์ที่ความจำกัดสําหรับ

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

| ค่า | คำอธิบาย | | --- | --- | | ASSET_TYPE_UNSPECIFIED | ประเภทสินทรัพย์เริ่มต้น การูประบรูปภาพื่อุประบรูประบรูปรูประบรูประบรูประบรูประบรูปรูปรูประบรูปรูประบรูประบรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูปรูpรูปรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูpรูรูpรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรูรู. ค่าที่เป็นไปได้:

usagenumber

การใช้งานปัจจุบันของความจุ.

capacitynumber

ความสามารถของส่วนแบ่ง.

periodEnum<string>

ระยะเวลาที่สำหรับความจำกัดเวลา

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

| ค่า | คำอธิบาย | | --- | --- | | PERIOD_UNSPECIFIED | ระยะเวลาเริ่มต้นซึ่งไม่ถูกต้องระบุมูลค่าอื่น| | เดือน | เดือน | | วัน | วัน |. ค่าที่เป็นไปได้:

usageResetTimestring

เวลาที่การใช้งานจะรีเซ็ตสําหรับความถี่นี้. สตริงนี้มีรูปแบบประทับเวลา

URL หลัก
https://apis.roblox.com
แหล่งข้อมูล AssetQuota
{

  "path": "users/123/asset-quotas/some-asset-quota",

  "quotaType": "QUOTA_TYPE_UNSPECIFIED",

  "assetType": "ASSET_TYPE_UNSPECIFIED",

  "usage": "integer",

  "capacity": "integer",

  "period": "PERIOD_UNSPECIFIED",

  "usageResetTime": "2023-07-05T12:34:56Z"

}

AssetQuota

รายการความต้องการทรัพยากร
เวอร์ชัน Beta

GET /cloud/v2/users/{user_id}/asset-quotas

ส่งคืนรายการของความสามารถในการใช้ทรัพยากร

ขอบเขต
asset:read
การจำกัด
  • คีย์ API: 60 คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม
  • OAuth 2.0: 60 คำขอต่อนาทีต่อผู้ใช้แอป

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด

คำขอพารามิเตอร์เส้นทาง
user_idstring
จำเป็นต้องมี

ID ผู้ใช้.

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

จํานวนส่วนแบ่งสินทรัพย์สูงสุดที่จะส่งคืนบริการอาจ返回值น้อยกว่านี้หากไม่ได้ระบุ จะมีการส่งคืนความจุสินทรัพย์สูงสุด 10 รายการมูลค่าสูงสุดคือ 100 และมูลค่าที่สูงกว่าจะถูกตั้งเป็น 100.

pageTokenstring

โทเค็นหน้าที่ได้รับจากการโทรก่อนหน้านี้เพื่อดึงหน้าต่อไป

เมื่อจัดหน้า พารามิเตอร์อื่น ๆ ทั้งหมดที่ให้กับการโทรต่อไปจะต้องตรงกับการโทรที่ให้โทเค็นหน้า.

filterstring

ฟิลด์นี้อาจถูกตั้งค่าเพื่อกรองทรัพยากรที่ส่งคืน

สนับสนุนชุดย่อยต่อไปนี้ของ CEL:

  • สนับสนุนเฉพาะฟิลด์ quotaType และ assetType เท่านั้น
  • สนับสนุนเฉพาะผู้ปฏิบัติการ == และ && เท่านั้น

ตัวอย่างเช่น: quotaType == RateLimitUpload && assetType == Audio.

การตอบกลับ

รายการของ AssetQuotas ในคอลเลกชันรากฐาน

assetQuotasarray<AssetQuota>

ส่วนแบ่งทรัพย์สินจากผู้ใช้ที่ระบุ.

nextPageTokenstring

โทเคนที่คุณสามารถส่งเป็นพารามิเตอร์ pageToken เพื่อดึงหน้าถัดไป หากฟิลด์นี้ถูกข้ามไป จะไม่มีหน้าต่อไป.

GET /cloud/v2/users/{user_id}/asset-quotas
curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}/asset-quotas?maxPageSize=10&pageToken={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
การตอบกลับ
{

  "assetQuotas": [

    {

      "path": "users/123/asset-quotas/some-asset-quota",

      "quotaType": "QUOTA_TYPE_UNSPECIFIED",

      "assetType": "ASSET_TYPE_UNSPECIFIED",

      "usage": "integer",

      "capacity": "integer",

      "period": "PERIOD_UNSPECIFIED",

      "usageResetTime": "2023-07-05T12:34:56Z"

    }

  ],

  "nextPageToken": "string"

}