REST Resource: deployments.packages

ทรัพยากร: แพ็กเกจ

แพ็กเกจในการกำหนดค่า 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)

ไม่บังคับ แสดงข้อจํากัดลายนิ้วมือของบิลด์ที่อาจนําไปใช้กับแพ็กเกจที่สมบูรณ์เท่านั้น โปรดทราบว่าค่าที่ซ้ำกันทั้งหมดต้องเป็นค่าเดียวกัน ซึ่งหมายความว่าจะรวมทั้งหมดหรือยกเว้นทั้งหมด ค่าอาจเป็นสตริงย่อยของลายนิ้วมือของบิลด์ เช่น ค่าข้อจำกัด "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 UTC "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 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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 นี้

Enum
PACKAGE_TYPE_UNSPECIFIED ไม่ระบุ
FILE OTA ที่ใช้ไฟล์
BLOCK OTA แบบบล็อก
AB OTA แบบ A/B

PackageUploadState

สถานะการอัปโหลดแพ็กเกจ

หลังจากโอนไฟล์แพ็กเกจเสร็จสมบูรณ์แล้ว ระบบจะสร้าง package และเซิร์ฟเวอร์จะเริ่มประมวลผลไฟล์เพื่ออ่านพร็อพเพอร์ตี้ของแพ็กเกจ ระบบจะตั้งค่าสถานะการอัปโหลดเป็น IN_PROGRESS จนกว่าการประมวลผลจะเสร็จสิ้น หลังจากประมวลผล ระบบจะตั้งค่าสถานะการอัปโหลดเป็น SUCCESS หรือ FAILURE

Enum
PACKAGE_UPLOAD_STATE_UNSPECIFIED ไม่ระบุ
SUCCESS อัปโหลดสำเร็จแล้ว
FAILURE อัปโหลดไม่สำเร็จ ซึ่งน่าจะเป็นเพราะแพ็กเกจไม่ถูกต้อง (ด้วยเหตุผลหลายประการ เช่น ไม่สามารถแตกไฟล์)
IN_PROGRESS ระบบยังคงประมวลผลแพ็กเกจอยู่

วิธีการ

delete

 ลบ package

get

 รับ package

list

 รายการ packages

listBatchGet

 แสดงการกำหนดค่าทั้งหมดที่ใช้แพ็กเกจที่ระบุ

update

 อัปเดต package