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

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

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

تمثيل 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 التالية:

رمز الخطأ السبب الدقة
5xx حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

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

حدثت محاولة لتعديل عنصر قيد التعديل. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.

 أعِد محاولة إرسال طلبك.