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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
uploadState

enum (PackageUploadState)

حالة تحميل الحزمة.
uploadError

string

حدث الخطأ أثناء تحميل الحزمة. ولن يتم ضبط الحقل إلا عندما تكون حالة التحميل 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)

نوع حزمة التحديث عبر الهواء، مثل المستندة إلى الكتلة.
requiredCache

string (int64 format)

يجب أن يكون حجم ذاكرة التخزين المؤقت عبر التحديث عبر الهواء بالبايت.
downgrade

boolean

ما إذا كانت حزمة التحديث عبر الهواء هي حزمة للرجوع إلى إصدار سابق.
wipe

boolean

ما إذا كانت حزمة التحديث عبر الهواء ستُطبِّق إجراء حجب البيانات.
streamingPropertyFiles

string

مواصفات ملفات الخصائص المستخدمة في بث OTA.

PackageType

نوع الحزمة في التحديث عبر الهواء.

عمليات التعداد
PACKAGE_TYPE_UNSPECIFIED غير محدد
FILE تحديث عبر الهواء المستند إلى الملفات.
BLOCK التحديث عبر الهواء المستند إلى حظر.
AB تحديث A/B عبر الهواء

PackageUploadState

حالة تحميل الحزمة.

بعد نقل ملف الحزمة بالكامل، سيتم إنشاء package وسيبدأ الخادم بمعالجة الملف لقراءة خصائص الحزمة منه. سيتم ضبط حالة التحميل على IN_PROGRESS إلى أن تكتمل عملية المعالجة. بعد المعالجة، سيتمّ ضبط حالة التحميل على SUCCESS أو FAILURE.

عمليات التعداد
PACKAGE_UPLOAD_STATE_UNSPECIFIED غير محدد
SUCCESS تم التحميل بنجاح.
FAILURE تعذّر التحميل. يعود السبب على الأرجح إلى أنّ الحزمة غير صالحة (لأسباب مختلفة، مثل عدم إمكانية فك ضغط الملف).
IN_PROGRESS لا تزال الحزمة قيد المعالجة.

الطُرق

delete

 يؤدي هذا الإجراء إلى حذف package.

get

 يحصل على package.

list

 يسرد packages.

listBatchGet

 يسرد جميع الإعدادات التي تستخدم الحزمة المحددة.

update

 يعدِّل package.