REST Resource: deployments.packages

資源：套件

OTA 設定中的套件。

JSON 表示法 
{
  "name": string,
  "title": string,
  "disabled": boolean,
  "deviceBuildRestrictions": [
    {
      object (IncludeExclude)
    }
  ],
  "details": {
    object (PackageDetails)
  }
}
欄位
name

string

僅供輸出。儲存的套件名稱。請注意，這是 Package 物件的專屬 ID，在建立新的 Package 時，伺服器會產生這個 ID。
title

string

檔案包的標題，也就是顯示名稱。
disabled

boolean

套件是否針對指定部署作業停用。
deviceBuildRestrictions[]

object (IncludeExclude)

選用設定。代表版本指紋限制，可能只會套用至完整套件。請注意，所有重複的值必須相同，也就是全部加入或全部排除。這些值可以是版本指紋的子字串，例如，"ABC" 的限制值會符合任何包含 "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 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："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 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
approved

boolean

套件是否在 APFE 中獲得核准。
beta

boolean

套件是否已標示為 Beta 版套件。
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 中的套件類型。

列舉
PACKAGE_TYPE_UNSPECIFIED 未指明
FILE 檔案型 OTA。
BLOCK 區塊式 OTA。
AB A/B OTA。

PackageUploadState

套件上傳的狀態。

套件檔案完全轉移後，系統會建立 package，伺服器會開始處理檔案，進而讀取其中的套件屬性。在處理作業完成前，上傳狀態會設為 IN_PROGRESS。處理完畢後，上傳狀態會設為 SUCCESS 或 FAILURE。

列舉
PACKAGE_UPLOAD_STATE_UNSPECIFIED 未指明
SUCCESS 上傳成功。
FAILURE 上傳失敗，這可能是因為套件無效 (原因包括無法解壓縮檔案等)。
IN_PROGRESS 包裹仍在處理中。

方法

delete

 刪除 package。

get

 取得 package。

list

 清單 packages。

listBatchGet

 列出使用指定套件的所有設定。

update

 更新 package。