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