REST Resource: package

المرجع: الحزمة

يمثّل package مورد مجموعة من الملفات يتم تسليمها عبر الويب أو بروتوكول SFTP أو آلية تسليم أخرى. تتيح واجهة برمجة التطبيقات حاليًا إمكانية تحميل حزمة تحتوي على ملف بيانات وصفية واحد بالضبط أو استرداد معلومات حول حزمة تم تحميلها سابقًا.

تمثيل JSON 
{
  "kind": string,
  "uploaderName": string,
  "content": string,
  "locale": string,
  "customIds": [
    string
  ],
  "name": string,
  "type": string,
  "timeCreated": string,
  "status": string,
  "statusReports": [
    {
      object (StatusReport)
    }
  ],
  "id": string
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات بالنسبة إلى موارد package، تكون هذه القيمة youtubePartner#package.
uploaderName

string

اسم القائم بالتحميل
content

string

محتوى ملف البيانات الوصفية للحزمة
locale

string

اللغة المطلوبة لرسائل الخطأ كما هو محدّد في BCP 47 (http: //tools.ietf.org/html/bcp47). على سبيل المثال، "en-US" أو "de". في حال عدم تحديدها، سنعرض رسائل الخطأ باللغة الإنجليزية ("en").
customIds[]

string

قائمة أرقام تعريف العملاء
name

string

اسم الحزمة
type

string

نوع الحزمة القيم المقبولة هي:

  • ‫Art Track: تحتوي الحزمة على البيانات الوصفية للمقطع الصوتي الفني والوسائط.
  • ‫Composition: تحتوي الحزمة على بيانات وصفية للمقطوعات الموسيقية.
  • ‫Movie: تحتوي الحزمة على بيانات وصفية وأوساط خاصة بالأفلام.
  • ‫Music Video: تحتوي الحزمة على البيانات الوصفية والفيديوهات الموسيقية.
  • ‫Sound Recording: تحتوي الحزمة على بيانات وصفية للتسجيل الصوتي.
  • TV Episode - تحتوي الحزمة على بيانات وصفية ووسائط لحلقة تلفزيونية.
  • ‫Unknown media type - نوع وسائط الحزمة غير معروف.
  • ‫Web: تحتوي الحزمة على بيانات وصفية ووسائط خاصة بفيديوهات الويب.
timeCreated

string

وقت إنشاء الحزمة يتم تحديد القيمة بتنسيق RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).
status

string

تمثّل هذه السمة حالة الحزمة. القيم المقبولة هي:

  • ‫Draft: يتم إعداد البيانات الوصفية للحزمة.
  • Errors: تعذّر التحقّق من صحة الحزمة أو معالجتها.
  • ‫Processing: تتم حاليًا معالجة الحزمة.
  • Successful: تمّت معالجة الحزمة بنجاح.
  • ‫Unknown status: حالة الحزمة غير معروفة.
statusReports[]

object (StatusReport)

تقارير حالة الحزمة
id

string

معرّف يحدّده YouTube ويستخدمه لتحديد الحزمة بشكلٍ فريد.

StatusReport

يحتوي هذا العنصر على معلومات تصف مصدر تقرير حالة الحزمة.

تمثيل JSON 
{
  "statusContent": string,
  "statusFileName": string
}
الحقول
statusContent

string

محتوى رسالة الإبلاغ يُستخدم في السيارات الهجينة فقط.
statusFileName

string

اسم ملف الحالة. يُستخدم في السيارات الهجينة فقط.

الطُرق

get

 تسترد هذه الطريقة معلومات عن الحزمة المحدّدة.

insert

 يُدرِج حزمة بيانات وصفية فقط.