Jobs

يمثّل مورد job مهمة إعداد تقارير مُجدوَلة. تحدّد وظيفة إعداد التقارير تقريرًا محدّدًا ينشئه YouTube كل يوم لقناة معيّنة أو لمالك محتوى معيّن.

الطُرق

يعرض الجدول التالي الطرق التي تتيحها واجهة برمجة التطبيقات لموارد job.

الطُرق
create إنشاء مهمة إعداد تقارير من خلال إنشاء مهمة إعداد تقارير، أنت تطلب من YouTube إنشاء هذا التقرير بشكل يومي. يتوفّر التقرير خلال 24 ساعة من وقت إنشاء المهمة.
delete حذف مهمة إعداد تقارير
get لاسترداد معلومات حول مهمة إعداد تقارير محددة تمّت جدولتها لقناة أو مالك محتوى.
list يسرد وظائف إعداد التقارير التي تمّت جدولتها لقناة أو مالك محتوى. يتضمّن كل مورد في الردّ السمة id التي تحدّد المعرّف الذي يستخدمه YouTube لتحديد المهمة بشكل فريد. تحتاج إلى رقم التعريف هذا لاسترداد قائمة التقارير التي تم إنشاؤها للمهمة أو لحذفها.

تمثيل موارد JSON

توضِّح بنية JSON أدناه تنسيق مورد job:

{
  "id": string,
  "reportTypeId": string,
  "name": string,
  "createTime": timestamp,
  "expireTime": timestamp,
  "systemManaged": boolean
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
id
string المعرّف الذي تستخدمه منصة YouTube لتحديد وظيفة إعداد التقارير بشكل فريد يمكن أن تتألف القيمة من 40 حرفًا كحدّ أقصى.
reportTypeId
string نوع التقرير الذي تنشئه الوظيفة. تتطابق قيمة السمة مع id لـ id لـ reportType استنادًا إلى طريقة reportTypes.list.
name
string تمثّل هذه السمة اسمًا تنشئه منصة YouTube لوصف الوظيفة. تتألف القيمة من 100 حرف كحدّ أقصى.
createTime
timestamp تاريخ ووقت إنشاء المهمة قيمة السمة هي طابع زمني في RFC3339 UTC "Zulu" بتنسيق دقيق يصل إلى ميكرو ثانية. مثال: "2015-10-02T15:01:23.045678Z"
expireTime
timestamp تمثّل هذه السمة تاريخ ووقت انتهاء صلاحية الوظيفة أو انتهاء صلاحيتها. قيمة السمة هي طابع زمني في RFC3339 UTC "Zulu" بتنسيق دقيق يصل إلى ميكرو ثانية. مثال: "2015-10-02T15:01:23.045678Z".

تحتوي هذه السمة على قيمة إذا تم إيقاف نوع التقرير المرتبط بالمهمة نهائيًا أو إذا لم يتم تنزيل التقارير التي تم إنشاؤها لهذه المهمة لفترة زمنية طويلة. تشير القيمة إلى التاريخ الذي لن تنشئ بعده YouTube تقارير جديدة عن الوظيفة.

إذا كانت لديك وظيفة تحدد تاريخ انتهاء صلاحية، عليك تحديث أنظمتك للتوقف عن طلب التقرير بحلول ذلك التاريخ. وفي بعض الحالات، قد يتوفّر تقرير بديل.
systemManaged
boolean تكون هذه القيمة true إذا كانت المهمة تنشئ تقارير يديرها النظام. ينشئ YouTube تلقائيًا تقارير يديرها النظام لمالكي المحتوى في YouTube الذين يمكنهم الوصول إلى التقارير نفسها في استوديو YouTube لمبدعي المحتوى. ولا يمكن لمالكي المحتوى تعديل أو حذف المهام التي تنشئ هذه التقارير.