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)
    }
  ],
  "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)

נפח ה-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' – הערך של מאפיין ה-build 'ro.soc.manufacturer' https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER חובה.

model

string

חובה. הדגם של המעבד המובנה, למשל 'Tensor' – הערך של מאפיין ה-build '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' לג'ורג'יה.

Methods

create

יצירת הגדרה חדשה של רמת מכשיר לאפליקציה.

get

הפונקציה מחזירה הגדרה ספציפית של רמת מכשיר.

list

הפונקציה מחזירה הגדרות של רמות מכשיר שנוצרו, בסדר יורד לפי זמן היצירה.