Jobs

یک منبع job نشان دهنده یک کار گزارش برنامه ریزی شده است. کار گزارش‌دهی گزارش خاصی را مشخص می‌کند که YouTube هر روز برای یک کانال یا مالک محتوای خاص ایجاد می‌کند.

روش ها

جدول زیر روش هایی را نشان می دهد که API برای منابع 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» دسترسی دارند. صاحبان محتوا نمی‌توانند مشاغلی را که این گزارش‌ها را ایجاد می‌کنند تغییر یا حذف کنند.