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

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

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

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

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

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

string (int64 format)

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

maxBytes

string (int64 format)

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

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

مطلوب. مصمّم شريحة المعالجة المركزية، على سبيل المثال يجب إدخال قيمة "Google" لسمة الإنشاء "ro.soc.manufacturer" https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER.

model

string

مطلوب. طراز وحدة المعالجة المركزية (SoC)، على سبيل المثال يجب أن تكون قيمة سمة الإنشاء "ro.soc.model" https://developer.android.com/reference/android/os/Build#SOC_MODEL هي "Tensor".

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

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