Method: metagame.listCategoriesByPlayer

داده‌های پخش انباشته شده در هر دسته را برای بازیکن مربوط به playerId فهرست کنید.

درخواست HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/categories/{collection}

پارامترهای مسیر

مولفه های
playerId

string

شناسه بازیکن ممکن است به جای شناسه بازیکن تایید شده از مقدار me استفاده شود.

collection

enum ( Collection )

مجموعه ای از دسته هایی که داده ها برای آنها بازگردانده می شود.

پارامترهای پرس و جو

مولفه های
language

string

زبان ترجیحی برای استفاده برای رشته های برگردانده شده توسط این روش.

maxResults

integer

حداکثر تعداد منابع دسته برای بازگشت در پاسخ، استفاده شده برای صفحه بندی. برای هر پاسخی، ممکن است تعداد واقعی منابع دسته برگردانده شده کمتر از maxResults مشخص شده باشد.

pageToken

string

توکن با درخواست قبلی بازگردانده شد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ دسته‌های متاگیم لیست شخص ثالث.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
زمینه های
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. مقدار همیشه games#categoryListResponse .

nextPageToken

string

نشانه مربوط به صفحه بعدی نتایج.

items[]

object ( MetagameCategory )

فهرست دسته‌ها با داده‌های استفاده.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

مجموعه

دسته بندی هایی را که داده ها برای آنها بازگردانده می شود، تعریف می کند.

Enums
ALL بازیابی داده ها برای همه دسته ها این پیش فرض است.

MetagameCategory

داده‌های مربوط به دسته‌های بازی فردی.

نمایندگی JSON
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
زمینه های
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#category ثابت است.

category

string

نام دسته.

experiencePoints

string ( int64 format)

امتیازات کسب شده در این دسته.