منبع reportType
گزارش خاصی را مشخص می کند که یک کانال یا صاحب محتوا می تواند آن را بازیابی کند.
جدول زیر روش هایی را نشان می دهد که API برای منابع report
پشتیبانی می کند.
مواد و روش ها | |
---|---|
list | فهرستی از انواع گزارش را که مالک کانال یا محتوا می تواند بازیابی کند، برمی گرداند. |
ساختار JSON زیر فرمت یک منبع reportType
را نشان می دهد:
{ "id": string, "name": string, "deprecateTime": timestamp, "systemManaged": boolean }
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
خواص | |
---|---|
id | string شناسهای که YouTube برای شناسایی منحصربهفرد گزارش استفاده میکند. مقدار ویژگی حداکثر 100 کاراکتر طول دارد. جدول زیر جدیدترین نسخه از هر نوع گزارش پشتیبانی شده (حداکثر 100 نویسه) را مشخص می کند. |
name | string نام گزارش. مقدار ویژگی حداکثر 100 کاراکتر طول دارد. |
deprecateTime | timestamp تاریخ و زمانی که گزارش منسوخ شده یا خواهد بود. اگر شغلی برای نوع گزارش منسوخ دارید، YouTube گزارشهای جدیدی را برای آن شغل به مدت سه ماه پس از اعلام تاریخ منسوخ شدن تولید میکند. به عنوان مثال، اعلان لغو برای گزارش content_owner_basic_a1 در 19 مه 2016 بود. بنابراین، فیلد deprecateTime برای آن نوع گزارش زمانی را در 19 اوت 2016 مشخص میکند، پس از آن YouTube تولید گزارشهایی از این نوع را متوقف میکند. |
systemManaged | boolean این مقدار در صورتی true است که YouTube به طور خودکار گزارش را برای صاحبان محتوای YouTube ایجاد کند، بدون اینکه صاحبان محتوا ابتدا با روش jobs.create تماس بگیرند تا به YouTube دستور تولید گزارش را بدهد. در واقع، اگر ویژگی reportTypeId گزارش مدیریت شده توسط سیستم را شناسایی کند، متد jobs.create یک خطا برمیگرداند. |