- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- اللعبة
- StaticContent
- الصورة
- المقاس
- الفيديو
- المقاس
- الاتجاه
- النوع
يسرد المباريات في مركز ألعاب معين.
طلب HTTP
GET https://gamesnackspartner.googleapis.com/v1/{parent=accounts/*/gamecenters/*}/games
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. مركز الألعاب الذي يملك مجموعة الألعاب التنسيق: accounts/{account}/gamecenters/{gamecenter} |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
تعريف الاستجابة لقائمة الألعاب لكل ألف ظهور
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"games": [
{
object ( |
الحقول | |
---|---|
games[] |
الألعاب التي تم عرضها في استجابة القائمة |
لعبة
تمثّل هذه السمة اللعبة.
تمثيل JSON |
---|
{ "name": string, "orientation": enum ( |
الحقول | |
---|---|
name |
مطلوب. اسم اللعبة التنسيق: accounts/{account}/gamecenters/{gamecenter}/ألعاب/{game} |
orientation |
اتجاهات الشاشة التي توفّرها اللعبة |
genres[] |
قائمة الأنواع المستخدَمة لتصنيف اللعبة. |
displayName |
تمثّل هذه السمة اسم اللعبة الذي قدّمه المطوّر. |
version |
إصدار اللعبة الذي وفّره المطوّر، مثل |
description |
وصف اللعبة الذي قدّمه مطوّر البرامج. |
embedUri |
معرّف الموارد المنتظم (URI) لـ GameCenter الذي يتضمّن اللعبة لمركز ألعاب معيّن. |
staticContent |
الصور والفيديوهات الخاصة باللعبة. |
publishTime |
الوقت الذي تم فيه بث المباراة لأول مرة. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
StaticContent
تمثيل المحتوى الثابت الخاص باللعبة، على سبيل المثال: الصور ومقاطع الفيديو.
تمثيل JSON |
---|
{ "icons": [ { object ( |
الحقول | |
---|---|
icons[] |
الرموز المستخدَمة لتمثيل اللعبة تمثل القيم المتعددة أحجامًا مختلفة. |
horizontalBanners[] |
البانر الأفقي للعبة. يجب أن يكون عرض الصورة أكبر من ارتفاعها. |
verticalBanners[] |
إعلان البانر العمودي للعبة. يجب أن يكون ارتفاع الصورة أكبر من عرضها. |
trailers[] |
المقاطع الدعائية للعبة |
صورة
تمثل هذه السمة صورة.
تمثيل JSON |
---|
{
"size": {
object ( |
الحقول | |
---|---|
size |
حجم الصورة |
uri |
معرّف الموارد المنتظم (URI) للصورة يجب أن تكون الصور بتنسيق صورة نقطية (مثل PNG) أو بتنسيق متّجه (مثل SVG). |
حجم الملف
تمثيل أبعاد الصور
تمثيل JSON |
---|
{ "widthPixels": string, "heightPixels": string } |
الحقول | |
---|---|
widthPixels |
عرض الصورة بالبكسل. |
heightPixels |
ارتفاع الصورة بالبكسل. |
فيديو
محتوى الفيديو
تمثيل JSON |
---|
{
"uri": string,
"size": {
object ( |
الحقول | |
---|---|
uri |
معرّف الموارد المنتظم (URI) الخاص بالفيديو قد تكون الفيديوهات بتنسيق MP4. |
size |
حجم الفيديو |
حجم الملف
تمثّل هذه السمة أبعاد الفيديوهات.
تمثيل JSON |
---|
{ "widthPixels": string, "heightPixels": string } |
الحقول | |
---|---|
widthPixels |
عرض الفيديو بالبكسل. |
heightPixels |
ارتفاع الفيديو بالبكسل. |
الاتجاه
اتجاهات الشاشة التي توفّرها اللعبة
عمليات التعداد | |
---|---|
ORIENTATION_UNSPECIFIED |
القيمة التلقائية هي عدم الاستخدام. |
ANY |
اللعبة متاحة في الوضعَين الأفقي والعمودي. |
LANDSCAPE |
اللعبة متاحة في الوضع الأفقي. |
PORTRAIT |
تعمل اللعبة بالوضع العمودي. |
النوع
فئات الألعاب المستخدَمة لتصنيف الألعاب.
عمليات التعداد | |
---|---|
GENRE_UNSPECIFIED |
القيمة التلقائية هي عدم الاستخدام. |
ACTION |
يركز على القتال وردود الفعل. |
ADVENTURE |
تركّز هذه التطبيقات على الاستكشاف والقصص وحلّ الألغاز. |
ARCADE |
تؤكد هذه اللعبة على الحركة السريعة الوتيرة وعناصر التحكّم البسيطة وتصعيد الصعوبة. |
BOARD |
وهو ينسخ القطع على لوح وفقًا لقواعد محددة. |
CARD |
تتضمّن هذه اللعبة مجموعة من البطاقات المخصَّصة كأداة رئيسية لتجربة اللعب. |
CASINO |
يعرض خدمات محاكاة لتجارب الكازينو التقليدية. |
CASUAL |
تركّز هذه الألعاب على توفير أسلوب لعب بسيط وسهل التعلّم. |
EDUCATIONAL |
مصمَّمة لتعليم المهارات والمفاهيم من خلال أسلوب اللعب التفاعلي. |
MUSIC |
يركّز على التفاعلات الموسيقية في أسلوب اللعب. |
PUZZLE |
تتحدى مهارات اللاعب في حل المشكلات. |
RACING |
يتحكم اللاعبون في مركبة ويحاولون الوصول إلى خط النهاية أولاً. |
ROLE_PLAYING |
في عالم خيالي أو خيال علمي يتخذ فيه اللاعبون خيارات تساهم في تشكيل القصة. |
SIMULATION |
محاكاة الأنشطة أو السيناريوهات الواقعية |
SPORTS |
أعِد ابتكار مباريات رياضية حقيقية من خلال أسلوب لعب واقعي. |
STRATEGY |
يركز على التخطيط والتكتيكات وإدارة الموارد |
TRIVIA |
تختبر المعرفة من خلال أسئلة حول موضوعات مختلفة. |
WORD |
تركّز هذه التطبيقات على المفردات وصياغة الكلمات والإملاء. |