*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

AssetQuota

자산 관련 작업에 대한 할당량을 나타냅니다.

예를 들어, 사용자는 한 달에 100개의 오디오 파일을 업로드할 수 있고 이미 15개를 업로드했을 수 있습니다. 이 예제에서는:

  • quotaType is RATE_LIMIT_UPLOAD
  • assetType is AUDIO
  • usage is 15
  • capacity is 100
  • 는 새로운 기간이 시작되고 사용이 0으로 재설정되는 시기를 나타냅니다.이 값 은 반드시 달력 월의 첫날이나 특정 날의 자정과 상관이 없습니다.This value doesn't necessarily correlate with the first day of a calendar month or midnight on a given day.업로드 프로세스에 대한 자세한 정보는 사용 가이드를 참조하십시오.

특성

pathstring

자산 할당량의 리소스 경로.

형식: users/{user_id}/asset-quotas/{asset_quota_id}.

quotaTypeEnum<string>

할당량 유형.

가능한 값:

| 값 | 설명 | | --- | --- | | QUOTA_TYPE_UNSPECIFIED | 기본 할당량 유형.| | RATE_LIMIT_UPLOAD | 자산을 업로드할 수 있는 빈도에 대한 속도 제한.| | RATE_LIMIT_CREATOR_STORE_DISTRIBUTE | 크리에이터 스토어에서 자산을 배포할 수 있는 빈도에 대한 속도 제한. |. 가능한 값:

assetTypeEnum<string>

할당량을 위한 자산 유형.

가능한 값:

| 값 | 설명 | | --- | --- | | ASSET_TYPE_UNSPECIFIED | 기본 자산 유형. IMAGE | 이미디자 | | IMAGE | 이미디자 | 이미디자 | Korean: 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디자 | 이미디미디자 | 이미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디미디 |. 가능한 값:

usagenumber

할당량의 현재 사용.

capacitynumber

할당량의 용량.

periodEnum<string>

할당량이 있는 기간.

가능한 값:

| 값 | 설명 | | --- | --- | | PERIOD_UNSPECIFIED | 무효한 기본 기간.다른 값을 지정합니다.| | 달 | 달 | | 일 | 일 |. 가능한 값:

usageResetTimestring

사용량이 이 할당량에 대해 재설정되는 시간. 이 문자열은 Timestamp 형식으로 지정됩니다.

기본 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

자산 할당량 목록
베타

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

자산 할당량 목록을 반환합니다.

범위
asset:read
요청경로 매개 변수
user_idstring
필수

사용자 ID.

쿼리 매개 변수
maxPageSizenumber

반환할 자산 할당량의 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 자산 할당량이 반환됩니다.최대 값은 100이며 더 높은 값은 100으로 설정됩니다.

pageTokenstring

이전 호출에서 받은 페이지 토큰으로, 이후 페이지를 검색합니다.

페이징할 때 후속 호출에 제공된 모든 다른 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filterstring

이 필드는 반환된 리소스를 필터링하기 위해 설정될 수 있습니다.

다음 하위 집합의 CEL을 지원합니다:

  • 오직 quotaTypeassetType 필드만 지원됩니다.
  • 오직 ==&& 연산자가 지원됩니다.

예를 들어: quotaType == RateLimitUpload && assetType == Audio.

응답

부모 컬렉션의 자산 할당량 목록입니다.

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