Method: accounts.gamecenters.games.list

בתיבת הדו-שיח הזו מפורטים המשחקים של אוסף משחקים נתון.

בקשת HTTP

GET https://gamesnackspartner.googleapis.com/v1/{parent=accounts/*/gamecenters/*}/games

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. מרכז המשחקים שהוא הבעלים של אוסף המשחקים. פורמט: accounts/{account}/gamecenters/{gamecenter}

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

הגדרת תשובות ל-rpc ברשימת המשחקים.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "games": [
    {
      object (Game)
    }
  ]
}
שדות
games[]

object (Game)

המשחקים שהוחזרו בתגובה לרשימה.

משחק

ייצוג של משחק.

ייצוג JSON 
{
  "name": string,
  "orientation": enum (Orientation),
  "genres": [
    enum (Genre)
  ],
  "displayName": string,
  "version": string,
  "description": string,
  "embedUri": string,
  "staticContent": {
    object (StaticContent)
  },
  "publishTime": string
}
שדות
name

string

חובה. שם המשחק. פורמט: accounts/{account}/gamecenters/{gamecenter}/games/{game}
orientation

enum (Orientation)

כיוונים של המסך שנתמכים במשחק.
genres[]

enum (Genre)

רשימת הז'אנרים שמשמשים לסיווג המשחק.
displayName

string

שם המשחק שסופק על ידי המפתח.
version

string

גרסת המשחק שסופקה על ידי המפתח, למשל: v0.9.1
description

string

תיאור המשחק שסופק על ידי המפתח.
embedUri

string

מזהה URI של GameCenter שמטמיע את המשחק עבור מרכז משחקים נתון.
staticContent

object (StaticContent)

התמונות והסרטונים של המשחק.
publishTime

string (Timestamp format)

המועד שבו המשחק עלה לאוויר לראשונה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

StaticContent

ייצוג התוכן הסטטי של המשחק, למשל תמונות וסרטונים.

ייצוג JSON 
{
  "icons": [
    {
      object (Image)
    }
  ],
  "horizontalBanners": [
    {
      object (Image)
    }
  ],
  "verticalBanners": [
    {
      object (Image)
    }
  ],
  "trailers": [
    {
      object (Video)
    }
  ]
}
שדות
icons[]

object (Image)

הסמלים שמשמשים לייצוג המשחק. ערכים מרובים מייצגים גדלים שונים.
horizontalBanners[]

object (Image)

הבאנר האופקי של המשחק. רוחב התמונה צריך להיות גדול מהגובה שלה.
verticalBanners[]

object (Image)

הבאנר האנכי של המשחק. גובה התמונה צריך להיות גדול מהרוחב שלה.
trailers[]

object (Video)

הטריילרים למשחק.

תמונה

ייצוג תמונה.

ייצוג JSON 
{
  "size": {
    object (Size)
  },
  "uri": string
}
שדות
size

object (Size)

גודל התמונה.
uri

string

ה-URI של התמונה. התמונות יכולות להיות בפורמט של מפת סיביות (למשל, PNG) או בפורמט וקטורי (למשל, SVG).

גודל

ייצוג מידות של תמונות.

ייצוג JSON 
{
  "widthPixels": string,
  "heightPixels": string
}
שדות
widthPixels

string (int64 format)

רוחב התמונה בפיקסלים.
heightPixels

string (int64 format)

גובה התמונה בפיקסלים.

וידאו

ייצוג של סרטון.

ייצוג JSON 
{
  "uri": string,
  "size": {
    object (Size)
  }
}
שדות
uri

string

ה-URI של הסרטון. הסרטונים יכולים להיות בפורמט MP4.
size

object (Size)

גודל הסרטון.

גודל

ייצוג מידות הסרטונים.

ייצוג JSON 
{
  "widthPixels": string,
  "heightPixels": string
}
שדות
widthPixels

string (int64 format)

רוחב הסרטון בפיקסלים.
heightPixels

string (int64 format)

גובה הסרטון בפיקסלים.

כיוון

כיוונים של המסך שנתמכים במשחק.

טיפוסים בני מנייה (enum)
ORIENTATION_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
ANY יש תמיכה במשחק בפריסה לאורך ובפריסה לרוחב.
LANDSCAPE המשחק נתמך בפריסה לרוחב.
PORTRAIT המשחק נתמך בפריסה לאורך.

ז'אנר

קטגוריות המשחקים שמשמשות לסיווג המשחק.

טיפוסים בני מנייה (enum)
GENRE_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
ACTION שם המשחק הוא לחימה ורפלקסים.
ADVENTURE התמקדות בחקירה, בסיפור ובפתרון חידות.
ARCADE המשחק כולל אקשן מהיר במיוחד, פקדים פשוטים ורמת קושי שהולכת וגדלה.
BOARD מכפילים חלקים על לוח לפי כללים ספציפיים.
CARD כולל חפיסה של קלפים מיוחדים בתור הכלי הראשי לגיימפליי.
CASINO במלון יש סימולציות של חוויות קזינו מסורתיות.
CASUAL שיטה המתמקדת ביצירת גיימפליי אינטואיטיבי וקל ללמידה.
EDUCATIONAL נועד ללמד מיומנויות או מושגים באמצעות מהלכי משחק מעניינים.
MUSIC התמקדות באינטראקציות עם מוזיקה במהלך הגיימפליי.
PUZZLE מאתגר את כישורי פתרון הבעיות של השחקן.
RACING השחקנים שולטים ברכב ומנסים להגיע קודם לקו הסיום.
ROLE_PLAYING עולם פנטזיה או מדע בדיוני שבו השחקנים מקבלים החלטות שמעצבות את העלילה.
SIMULATION חיקוי פעילויות או תרחישים מהעולם האמיתי.
SPORTS יצירה מחדש של ספורט בעולם האמיתי עם גיימפליי מציאותי.
STRATEGY התמקדות בתכנון, בטקטיקות ובניהול משאבים
TRIVIA בחינת ידע באמצעות שאלות בנושאים שונים.
WORD מתמקדת באוצר מילים, ביצירת מילים ובאיות.