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

חובה. הדגם של ה-SoC, למשל. ‫'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

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

קודי שגיאה

הפעולות של המשאב הזה מחזירות את קודי שגיאות ה-HTTP הבאים:

קוד שגיאה סיבה תיאור רזולוציה
400 invalidValue צוין ערך לא תקין בבקשה. השגיאה הזו מוחזרת לעיתים קרובות כשפורמט טוקן הרכישה שגוי או כשהוא לא תקין. מתקנים את הערך הלא תקין של השדה בגוף הבקשה או בפרמטרים על סמך הפניה ל-API.
400 required חסר שדה או פרמטר חובה בבקשה. כדאי לעיין במסמכי התיעוד בנושא API כדי לוודא שכללתם את כל שדות החובה והפרמטרים הנדרשים.
403 userInsufficientPermission למשתמש אין מספיק הרשאות לביצוע הפעולה המבוקשת. מוודאים שלמשתמש המאומת יש את ההרשאות הנדרשות ב-Google Play Console. פרטים נוספים מופיעים במאמר בנושא שימוש בחשבון שירות.
404 notFound לא נמצא המשאב המבוקש. מוודאים שהמזהים (לדוגמה: טוקן רכישה, שם חבילה, מזהה מוצר, מזהה מינוי) נכונים.
409 concurrentUpdate היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון בו-זמני. מנסים לשלוח שוב את הבקשה עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). מומלץ להימנע משינויים בו-זמניים באותו משאב.
5xx Generic error שגיאה כללית בשרת של Google Play. צריך לנסות לשלוח את הבקשה שוב.

אם הבעיה נמשכת, אפשר לפנות למנהל החשבון ב-Google Play או לשלוח בקשת תמיכה. כדאי לבדוק בלוח הבקרה של סטטוס Play אם יש הפסקות זמניות ידועות בשירות.