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 A/B OTA

PackageUploadState

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

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

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

เมธอด

delete

 ลบ package

get

 รับ package

list

 รายการ packages

listBatchGet

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

update

 อัปเดต package