REST Resource: deployments.packages

משאב: Package

חבילה בהגדרת ה-OTA.

ייצוג JSON
{
  "name": string,
  "title": string,
  "disabled": boolean,
  "deviceBuildRestrictions": [
    {
      object (IncludeExclude)
    }
  ],
  "details": {
    object (PackageDetails)
  }
}
שדות
name

string

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

title

string

שם החבילה, כלומר השם המוצג.

disabled

boolean

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

deviceBuildRestrictions[]

object (IncludeExclude)

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

details

object (PackageDetails)

פרטים נוספים על החבילה. השדה הזה הוא לקריאה בלבד.

IncludeExclude

כוללת או מחריגה דפוסים מסוימים.

ייצוג JSON
{

  // Union field include_exclude can be only one of the following:
  "include": string,
  "exclude": string
  // End of list of possible types for union field include_exclude.
}
שדות
שדה איחוד include_exclude. כלל של הכללה או החרגה. הערך של include_exclude יכול להיות רק אחת מהאפשרויות הבאות:
include

string

דפוס כלול.

exclude

string

דפוס מוחרג.

PackageDetails

פרטים על חבילת OTA.

ייצוג JSON
{
  "sizeBytes": string,
  "originalFilename": string,
  "preConditions": [
    {
      object (Condition)
    }
  ],
  "postConditions": [
    {
      object (Condition)
    }
  ],
  "properties": {
    object (PackageProperties)
  },
  "webDownloadUrl": string,
  "updateTime": string,
  "uploadState": enum (PackageUploadState),
  "uploadError": string,
  "uploadUser": string,
  "uploadTime": string,
  "approved": boolean,
  "beta": boolean,
  "versionTag": {
    object (VersionTag)
  }
}
שדות
sizeBytes

string (int64 format)

גודל החבילה בבייטים.

originalFilename

string

שם הקובץ המקורי שהועלה.

preConditions[]

object (Condition)

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

postConditions[]

object (Condition)

התנאים שלאחר התנאים של החבילה.

properties

object (PackageProperties)

מאפייני החבילה.

webDownloadUrl

string

הקישור להורדת החבילה ישירות מ-Google. לשימוש במרכז הבקרה / בקונסולה.

updateTime

string (Timestamp format)

מועד השינוי האחרון של הרשומה של החבילה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

uploadState

enum (PackageUploadState)

מצב ההעלאה של החבילה.

uploadError

string

אירעה שגיאה בהעלאת החבילה. השדה יוגדר רק כאשר ה-uploadState הוא FAILURE.

uploadUser

string

כתובת האימייל של המשתמש שהעלה את החבילה

uploadTime

string (Timestamp format)

השעה שבה החבילה הועלתה. יכול להיות שהאפשרות הזו לא תהיה זמינה לכל החבילות.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

approved

boolean

האם החבילה אושרה ב-APFE.

beta

boolean

האם החבילה סומנה כחבילת בטא.

versionTag

object (VersionTag)

גרסת החבילה.

PackageProperties

המאפיינים של חבילת OTA.

ייצוג JSON
{
  "type": enum (PackageType),
  "requiredCache": string,
  "downgrade": boolean,
  "wipe": boolean,
  "streamingPropertyFiles": string
}
שדות
type

enum (PackageType)

סוג חבילת OTA, כמו כללים שמבוססים על בלוקים.

requiredCache

string (int64 format)

ה-OTA דורש את גודל המטמון בבייטים.

downgrade

boolean

האם חבילת OTA היא חבילת שדרוג לאחור.

wipe

boolean

אם חבילת ה-OTA תחיל את פעולת המחיקה.

streamingPropertyFiles

string

המפרט של קובצי הנכס שנעשה בהם שימוש בסטרימינג OTA.

PackageType

סוג החבילה ב-OTA הזה.

טיפוסים בני מנייה (enums)
PACKAGE_TYPE_UNSPECIFIED לא צוינה.
FILE OTA מבוססת קבצים.
BLOCK OTA מבוססת-בלוק.
AB A/B OTA.

PackageUploadState

מצב העלאת החבילה.

לאחר העברה מלאה של קובץ החבילה, יווצר package והשרת יתחיל לעבד את הקובץ כדי לקרוא ממנו מאפייני חבילה. מצב ההעלאה יהיה IN_PROGRESS עד לסיום העיבוד. לאחר העיבוד, מצב ההעלאה יוגדר כSUCCESS או FAILURE.

טיפוסים בני מנייה (enums)
PACKAGE_UPLOAD_STATE_UNSPECIFIED לא צוינה.
SUCCESS ההעלאה בוצעה בהצלחה.
FAILURE ההעלאה נכשלה. סביר להניח שהסיבה לכך היא שהחבילה לא חוקית (מסיבות שונות, למשל, לא ניתן לפתוח את הקובץ).
IN_PROGRESS החבילה עדיין בעיבוד.

שיטות

delete

מוחק package.

get

מקבל package.

list

הרשימה packages.

listBatchGet

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

update

מתבצע עדכון של package.