ReportTypes

منبع reportType گزارش خاصی را مشخص می کند که یک کانال یا صاحب محتوا می تواند آن را بازیابی کند.

روش ها

جدول زیر روش هایی را نشان می دهد که API برای منابع report پشتیبانی می کند.

روش ها
list فهرستی از انواع گزارش را که مالک کانال یا محتوا می تواند بازیابی کند، برمی گرداند.

نمایندگی منابع JSON

ساختار 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 یک خطا برمی‌گرداند.