REST Resource: applications.deviceTierConfigs

المورد: DeviceTierConfig

إعدادات تصف معايير استهداف الأجهزة لمحتوى تطبيق.

تمثيل JSON 
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
الحقول
deviceTierConfigId

string (int64 format)

النتائج فقط. معرّف إعدادات فئة الجهاز
deviceGroups[]

object (DeviceGroup)

تعريف مجموعات الأجهزة للتطبيق
deviceTierSet

object (DeviceTierSet)

تعريف مجموعة فئات الأجهزة للتطبيق
userCountrySets[]

object (UserCountrySet)

تعريف مجموعات بُلدان المستخدمين للتطبيق

DeviceGroup

مجموعة من الأجهزة

يتم تحديد المجموعة من خلال مجموعة من أدوات اختيار الأجهزة. ينتمي الجهاز إلى المجموعة إذا كان يطابق أي محدّد (عامل التشغيل المنطقي OR).

تمثيل JSON 
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
الحقول
name

string

اسم المجموعة
deviceSelectors[]

object (DeviceSelector)

أدوات اختيار الأجهزة لهذه المجموعة يتم تضمين أي جهاز يطابق أيًا من أدوات الاختيار في هذه المجموعة.

DeviceSelector

أداة اختيار لمجموعة أجهزة يتألف أداة الاختيار من مجموعة من الشروط التي يجب أن تتطابق جميعها (عامل التشغيل المنطقي "و") على الجهاز لتحديد أهلية مجموعة الأجهزة.

على سبيل المثال، إذا كان أداة الاختيار تحدّد شروط ذاكرة الوصول العشوائي، وتضمين طراز الجهاز، واستبعاد طراز الجهاز، يُعد الجهاز مطابقًا إذا: كان الجهاز يستوفي شروط ذاكرة الوصول العشوائي، وكان الجهاز يطابق أحد طُرز الأجهزة المُضمَّنة، وكان الجهاز لا يطابق طُرز الأجهزة المُستبعَدة.

تمثيل JSON 
{
  "deviceRam": {
    object (DeviceRam)
  },
  "includedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "excludedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "requiredSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "forbiddenSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "systemOnChips": [
    {
      object (SystemOnChip)
    }
  ]
}
الحقول
deviceRam

object (DeviceRam)

شروط ذاكرة الوصول العشوائي (RAM) في الجهاز
includedDeviceIds[]

object (DeviceId)

طُرز الأجهزة التي يضمّها أداة الاختيار هذه
excludedDeviceIds[]

object (DeviceId)

طُرز الأجهزة المستبعَدة من خلال أداة الاختيار هذه، حتى إذا كانت تستوفي جميع الشروط الأخرى
requiredSystemFeatures[]

object (SystemFeature)

يجب أن يتضمّن الجهاز جميع ميزات النظام هذه لكي يدرجه أداة الاختيار.
forbiddenSystemFeatures[]

object (SystemFeature)

يستبعد هذا الاختيار أي جهاز يتضمّن أيًا من ميزات النظام هذه، حتى إذا كان يستوفي جميع الشروط الأخرى.
systemOnChips[]

object (SystemOnChip)

اختياريّ. شرائح النظام على الرقاقة (SoC) التي تتضمّنها أداة الاختيار هذه تعمل هذه الميزة على أجهزة Android الإصدار S والإصدارات الأحدث فقط.

DeviceRam

شروط حول إمكانات ذاكرة الوصول العشوائي للجهاز

تمثيل JSON 
{
  "minBytes": string,
  "maxBytes": string
}
الحقول
minBytes

string (int64 format)

الحد الأدنى لذاكرة الوصول العشوائي بالبايت (يشمل الحد).
maxBytes

string (int64 format)

الحد الأقصى لذاكرة الوصول العشوائي (RAM) بالبايت (لا يشمل الحد).

DeviceId

معرّف الجهاز

تمثيل JSON 
{
  "buildBrand": string,
  "buildDevice": string
}
الحقول
buildBrand

string

قيمة Build.BRAND
buildDevice

string

قيمة Build.DEVICE

SystemFeature

تمثيل لإحدى ميزات النظام.

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

اسم الميزة

SystemOnChip

تمثّل هذه السمة المنظومة على رقاقة (SoC) لجهاز Android. يمكن استخدامها لاستهداف الأجهزة التي تعمل بالإصدار S أو الإصدارات الأحدث.

تمثيل JSON 
{
  "manufacturer": string,
  "model": string
}
الحقول
manufacturer

string

الحقل مطلوب. مصمّم نظام SoC، مثل قيمة "Google" لخاصية الإنشاء "ro.soc.manufacturer" https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER مطلوبة.
model

string

الحقل مطلوب. طراز نظام SoC، مثل قيمة "Tensor" لخاصية الإصدار "ro.soc.model" https://developer.android.com/reference/android/os/Build#SOC_MODEL مطلوبة.

DeviceTierSet

مجموعة من فئات الأجهزة

تحدّد مجموعة الفئات نوع محتوى التطبيق الذي سيتم عرضه على جهاز معيّن، وذلك بالنسبة إلى المحتوى المستهدِف للأجهزة.

عليك تحديد مستوى أولوية لكل فئة، ما يحدّد ترتيب تقييم Play لها. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات DeviceTier.level.

تمثيل JSON 
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
الحقول
deviceTiers[]

object (DeviceTier)

فئات الأجهزة التي تنتمي إلى المجموعة

DeviceTier

فئة جهاز واحدة

تُعتبر الأجهزة التي تتطابق مع أي من مجموعات الأجهزة في deviceGroupNames متوافقة مع الفئة.

تمثيل JSON 
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
الحقول
deviceGroupNames[]

string

مجموعات الأجهزة المضمّنة في هذه الفئة يجب تحديد هذه المجموعات بشكل صريح ضمن deviceGroups في هذا الإعداد.
level

integer

مستوى أولوية الفئة

يتم تقييم المستويات حسب ترتيبها التنازلي: المستوى الأعلى له الأولوية القصوى. يتم اختيار أعلى فئة تتطابق مع جهاز معيّن لهذا الجهاز.

يجب استخدام نطاق متجاور من المستويات لفئاتك في مجموعة فئات، ويجب أن تكون مستويات الفئات في مجموعة الفئات فريدة. على سبيل المثال، إذا كانت مجموعة الفئات تتضمّن 4 فئات (بما في ذلك الفئة الاحتياطية العامة)، عليك تحديد الفئات 1 و2 و3 في هذا الإعداد.

ملاحظة: يتم تحديد المستوى 0 ضمنيًا كإعداد احتياطي عام ويتم اختياره للأجهزة التي لا تتطابق مع أي من المستويات المحددة هنا بشكل صريح. يجب عدم تحديد المستوى 0 بشكل صريح في هذا الإعداد.

UserCountrySet

مجموعة من بلدان المستخدمين

تحدّد مجموعة البلدان نوع محتوى التطبيق الذي سيتم عرضه في موقع جغرافي معيّن.

تمثيل JSON 
{
  "name": string,
  "countryCodes": [
    string
  ]
}
الحقول
name

string

اسم مجموعة البلدان
countryCodes[]

string

قائمة برموز البلدان التي تمثّل البلدان يتم تمثيل رمز البلد بتنسيق ISO 3166 alpha-2. على سبيل المثال: "IT" لإيطاليا، و"GE" لجورجيا.

الطُرق

create

 تنشئ هذه الطريقة إعدادات جديدة خاصة بفئات الأجهزة لأحد التطبيقات.

get

 تعرض هذه الطريقة إعدادات فئة جهاز معيّنة.

list

 تعرض هذه الطريقة إعدادات فئة الجهاز التي تم إنشاؤها، ويتم ترتيبها حسب وقت الإنشاء من الأحدث إلى الأقدم.

رموز الخطأ

تعرض عمليات هذا المرجع رموز خطأ HTTP التالية:

رمز الخطأ السبب الوصف الدقة
400 invalidValue تم إدخال قيمة غير صالحة في الطلب. يتم عرض هذا الرمز غالبًا عند تقديم رمز مميّز غير صالح أو غير مكتمل لعملية الشراء. صحِّح قيمة الحقل غير الصالحة في نص الطلب أو المَعلمات استنادًا إلى مرجع واجهة برمجة التطبيقات.
400 required لم يتم إدخال حقل أو مَعلمة مطلوبة في الطلب. راجِع مستندات واجهة برمجة التطبيقات للتأكّد من تضمين جميع الحقول والمَعلمات الإلزامية.
403 userInsufficientPermission لا يملك المستخدم الإذن الكافي لتنفيذ العملية المطلوبة. تأكَّد من أنّ المستخدم المصادَق عليه لديه الأذونات اللازمة في Google Play Console. لمزيد من التفاصيل، يُرجى الاطّلاع على استخدام حساب خدمة.
404 notFound تعذَّر العثور على المورد المطلوب. تأكَّد من صحة المعرّفات (مثل رمز الشراء أو اسم الحزمة أو معرّف المنتج أو معرّف الاشتراك).
409 concurrentUpdate تمت محاولة تعديل عنصر يتم تعديله في الوقت نفسه. أعِد محاولة إرسال الطلب باستخدام خوارزمية الرقود الأسي الثنائي. تجنَّب إجراء تعديلات متزامنة على المرجع نفسه.
5xx Generic error حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة أي انقطاع معروف في الخدمة.