REST Resource: deployments.groups.configs

משאב: הגדרה

תצורה של פריסה.

ייצוג JSON
{
  "name": string,
  "title": string,
  "description": string,
  "defaultUpdateDescription": {
    object (UpdateDescription)
  },
  "localizedUpdateDescriptions": [
    {
      object (LocalizedUpdateDescription)
    }
  ],
  "urgencyMode": enum (UrgencyMode),
  "scheduledInstallDelay": enum (ScheduledInstallDelay),
  "wifiOnlyTime": enum (WifiOnlyTime),
  "updateMaintenanceWindow": {
    object (TimeWindow)
  },
  "packageSizeAwareBatteryThreshold": boolean,
  "offPeakUpdate": {
    object (OffPeakUpdate)
  },
  "countryRestriction": {
    object (IncludeExclude)
  },
  "mobileNetworkRestriction": {
    object (IncludeExclude)
  },
  "deviceBuildPropertyRestriction": {
    object (IncludeExclude)
  },
  "mobileNetworkCarrierRestriction": {
    object (IncludeExclude)
  },
  "updateRequiredSetup": boolean,
  "minimalSpaceRequired": enum (SpaceNeed),
  "immediateRelease": boolean,
  "rolloutSteps": [
    {
      object (RolloutStep)
    }
  ],
  "securityUpdate": boolean,
  "details": {
    object (ConfigDetails)
  },
  "allowEncryptedScheduledInstall": boolean,
  "reminderDialogSettings": {
    object (ReminderDialogSettings)
  }
}
שדות
name

string

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

title

string

זה שינוי אופציונלי. כותרת ההגדרה.

description

string

זה שינוי אופציונלי. תיאור ההגדרה.

defaultUpdateDescription

object (UpdateDescription)

חובה. הטקסט המוגדר כברירת מחדל בממשק המשתמש כאשר הלוקאל של המכשיר לא תואם ללוקאלים שצוינו ב-localizedUpdateDescriptions.

localizedUpdateDescriptions[]

object (LocalizedUpdateDescription)

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

urgencyMode

enum (UrgencyMode)

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

scheduledInstallDelay

enum (ScheduledInstallDelay)

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

wifiOnlyTime

enum (WifiOnlyTime)

זה שינוי אופציונלי. ברירת המחדל היא SEVEN_DAYS אם נשאר WIFI_ONLY_TIME_UNSPECIFIED.

הערה: ההגדרה הזו תוגדר ל-FOREVER אם urgencyMode הוא RECOMMENDED.

updateMaintenanceWindow

object (TimeWindow)

זה שינוי אופציונלי. חלון הזמן להתקנה של ה-OTA.

packageSizeAwareBatteryThreshold

boolean

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

offPeakUpdate

object (OffPeakUpdate)

זה שינוי אופציונלי. אובייקט העדכון מחוץ לנקודת השיא.

countryRestriction

object (IncludeExclude)

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

mobileNetworkRestriction

object (IncludeExclude)

זה שינוי אופציונלי. הרשתות הסלולריות האפשריות או לא נכללות שמזוהות באמצעות קודי mcc/mnc. לתשומת ליבכם: צריך להשתמש באפשרות הזו רק ב-mobileNetworkCarrierRestriction. לא ניתן להגדיר את שני השדות בו-זמנית.

deviceBuildPropertyRestriction

object (IncludeExclude)

זה שינוי אופציונלי. ההגבלה האפשרית של נכס ה-build של המכשיר שנכלל או לא נכלל.

mobileNetworkCarrierRestriction

object (IncludeExclude)

זה שינוי אופציונלי. ספקי הרשת הסלולרית האפשריים או שאינם נכללים. לתשומת ליבכם: צריך להשתמש באפשרות הזו רק ב-mobileNetworkRestriction. לא ניתן להגדיר את שני השדות בו-זמנית.

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

updateRequiredSetup

boolean

זה שינוי אופציונלי. השדה הזה מציין אם נדרש עדכון במהלך אשף ההגדרה. ברירת המחדל היא False.

minimalSpaceRequired

enum (SpaceNeed)

זה שינוי אופציונלי. דרישת המקום המינימלית. כשהערך הוא UNSPECIFIED, השרת לא יגדיר הגבלה. נדרשת גרסה 6.1.11 ואילך של Google Play Services.

immediateRelease

boolean

זה שינוי אופציונלי. חובה להזין אחד מהערכים immediateRelease או rolloutSteps. האם יש להשיק את העדכון באופן מיידי. אם זה נכון, צריך לבטל את ההגדרה של rolloutSteps.

rolloutSteps[]

object (RolloutStep)

זה שינוי אופציונלי. חובה להזין אחד מהערכים rolloutSteps או immediateRelease. שלב ההשקה חייב להיות בסדר: גם הפרמטר time_ms וגם השבר לא צריכים להיות יקטן. בשלב האחרון צריך להיות השבר == 100.

securityUpdate

boolean

זה שינוי אופציונלי. מסמן את העדכון כעדכון אבטחה. הפרטים האלה מועברים למכשיר כדי לתאם את ההצגה של הודעת העדכון הנכונה. כלומר, להציג את הטקסט "מחיל את עדכון האבטחה" ולא "להחיל עדכון מערכת". נדרשת רמת API 22 ואילך ו-Google Play Services מגרסה 9.4 ואילך.

details

object (ConfigDetails)

פלט בלבד. פרטים נוספים על הגדרה השרת אמור להחזיר את זה רק במהלך החזרת ה-config.

allowEncryptedScheduledInstall

boolean

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

reminderDialogSettings

object (ReminderDialogSettings)

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

שיטות

list

ליצירת רשימה של הגדרות הקבוצה.