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

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

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

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

object (DeviceRam)

حالة ذاكرة الوصول العشوائي للجهاز

includedDeviceIds[]

object (DeviceId)

طُرز الأجهزة التي تم تضمينها في أداة الاختيار هذه.

excludedDeviceIds[]

object (DeviceId)

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

requiredSystemFeatures[]

object (SystemFeature)

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

forbiddenSystemFeatures[]

object (SystemFeature)

ويتم استبعاد الجهاز الذي يحتوي على أي من ميزات النظام هذه من خلال أداة الاختيار هذه، حتى إذا تطابقت مع جميع الشروط الأخرى.

DeviceRam

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

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

string (int64 format)

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

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

اسم العنصر.

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

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