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 لصنّاع المحتوى. ولا يمكن لمالكي المحتوى تعديل أو حذف الوظائف التي تنشئ تلك التقارير.