REST Resource: deployments.packages

Tài nguyên: Gói

Một gói trong cấu hình OTA.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "title": string,
  "disabled": boolean,
  "deviceBuildRestrictions": [
    {
      object (IncludeExclude)
    }
  ],
  "details": {
    object (PackageDetails)
  }
}
Trường
name

string

Chỉ có đầu ra. Tên của gói được lưu trữ. Lưu ý rằng đây là giá trị nhận dạng duy nhất của các đối tượng Package và sẽ do máy chủ tạo khi Package mới được tạo.

title

string

Tiêu đề của gói; tức là tên hiển thị.

disabled

boolean

Liệu gói có bị vô hiệu hoá cho lần triển khai cụ thể hay không.

deviceBuildRestrictions[]

object (IncludeExclude)

Không bắt buộc. Biểu thị các hạn chế về vân tay số của bản dựng chỉ có thể áp dụng cho các gói đầy đủ. Lưu ý rằng tất cả giá trị lặp lại phải giống nhau; tức là tất cả đều bao gồm hoặc loại trừ toàn bộ. Các giá trị này có thể là chuỗi con của vân tay số của bản dựng, chẳng hạn như giá trị hạn chế của "ABC" sẽ khớp với mọi vân tay số của bản dựng có chứa chuỗi "ABC".

details

object (PackageDetails)

Thông tin chi tiết khác về gói. Trường này ở chế độ chỉ đọc.

IncludeExclude

Bao gồm hoặc loại trừ một số mẫu nhất định.

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp include_exclude. Quy tắc bao gồm hoặc loại trừ. include_exclude chỉ có thể là một trong những trạng thái sau đây:
include

string

Hoa văn đi kèm.

exclude

string

Mẫu bị loại trừ.

PackageDetails

Thông tin chi tiết về một gói OTA.

Biểu diễn dưới dạng 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)
  }
}
Trường
sizeBytes

string (int64 format)

Kích thước gói tính bằng byte.

originalFilename

string

Tên tệp gốc đã tải lên.

preConditions[]

object (Condition)

Điều kiện tiên quyết của gói.

postConditions[]

object (Condition)

Gói sau điều kiện.

properties

object (PackageProperties)

Thuộc tính gói.

webDownloadUrl

string

Đường liên kết để tải gói xuống ngay từ Google. Dùng cho Trang tổng quan / Bảng điều khiển.

updateTime

string (Timestamp format)

Thời gian mục nhập gói được sửa đổi lần gần đây nhất.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

uploadState

enum (PackageUploadState)

Trạng thái tải lên của gói.

uploadError

string

Đã xảy ra lỗi khi tải gói lên. Trường này sẽ chỉ được thiết lập khi uploadState là FAILURE.

uploadUser

string

Email của người dùng đã tải gói lên

uploadTime

string (Timestamp format)

Thời điểm gói được tải lên. Một số gói có thể không dùng được cách này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

approved

boolean

Liệu gói có được phê duyệt trong APFE hay không.

beta

boolean

Liệu gói đó có được đánh dấu là gói beta hay không.

versionTag

object (VersionTag)

Phiên bản của gói.

PackageProperties

Các thuộc tính của gói OTA.

Biểu diễn dưới dạng JSON
{
  "type": enum (PackageType),
  "requiredCache": string,
  "downgrade": boolean,
  "wipe": boolean,
  "streamingPropertyFiles": string
}
Trường
type

enum (PackageType)

Loại gói OTA, chẳng hạn như dựa trên khối.

requiredCache

string (int64 format)

Dung lượng bộ nhớ đệm bắt buộc của mạng không dây (OTA) tính bằng byte.

downgrade

boolean

Liệu gói OTA có phải là gói hạ cấp hay không.

wipe

boolean

Liệu gói OTA có áp dụng thao tác xoá sạch hay không.

streamingPropertyFiles

string

Thông số kỹ thuật của các tệp thuộc tính dùng trong luồng OTA.

PackageType

Loại gói trong OTA này.

Enum
PACKAGE_TYPE_UNSPECIFIED Không xác định.
FILE OTA dựa trên tệp.
BLOCK OTA dựa trên khối.
AB A/B OTA.

PackageUploadState

Trạng thái tải gói lên.

Sau khi tệp của gói được chuyển hoàn toàn, package sẽ được tạo và máy chủ sẽ bắt đầu xử lý tệp để đọc các thuộc tính của gói qua đó. Trạng thái tải lên sẽ được đặt thành IN_PROGRESS cho đến khi quá trình xử lý hoàn tất. Sau khi xử lý xong, trạng thái tải lên sẽ được đặt thành SUCCESS hoặc FAILURE.

Enum
PACKAGE_UPLOAD_STATE_UNSPECIFIED Không xác định.
SUCCESS Tải lên thành công.
FAILURE Không tải được video lên. Nhiều khả năng là do gói không hợp lệ (do nhiều lý do, chẳng hạn như không thể giải nén tệp).
IN_PROGRESS Gói này vẫn đang được xử lý.

Phương thức

delete

Xoá một package.

get

Nhận được một package.

list

Liệt kê packages.

listBatchGet

Liệt kê mọi cấu hình sử dụng gói đã chỉ định.

update

Cập nhật một package.