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. אפשר להשתמש בהם כדי לטרגט מכשירים עם 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

קבוצה של רמות מכשירים.

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

צריך להקצות רמת עדיפות לכל רמה, כדי לקבוע את הסדר שבו המערכת בודקת אותן. פרטים נוספים זמינים במסמכי התיעוד של 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 הבאים:

קוד שגיאה סיבה רזולוציה
5xx שגיאה כללית בשרת של Google Play. מנסים לשלוח את הבקשה שוב.

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

409 שגיאה בעדכון של מספר החיבורים בו-זמנית.

היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון. לדוגמה, רכישה מאושרת על ידי הפעלת המתודה acknowledgePurchase() של Play Billing Library והפעלת המתודה purchases.products.acknowledge של Play Developer API בו-זמנית.

מנסים לשלוח את הבקשה שוב.