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