ReportTypes

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

روش‌ها

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

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

نمایش منابع JSON

ساختار JSON زیر فرمت یک منبع reportType را نشان می‌دهد:

{
  "id": string,
  "name": string,
  "deprecateTime": timestamp,
  "systemManaged": boolean
}

خواص

جدول زیر ویژگی‌هایی را که در این منبع ظاهر می‌شوند، تعریف می‌کند:

خواص
id string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد گزارش استفاده می‌کند. مقدار ویژگی حداکثر ۱۰۰ کاراکتر دارد. جدول زیر جدیدترین نسخه هر نوع گزارش پشتیبانی شده (حداکثر ۱۰۰ کاراکتر) را مشخص می‌کند.

name string
نام گزارش. مقدار ویژگی حداکثر ۱۰۰ کاراکتر دارد.
deprecateTime timestamp
تاریخ و زمانی که گزارش منسوخ شده یا منسوخ خواهد شد. اگر کاری برای نوع گزارش منسوخ شده دارید، یوتیوب گزارش‌های جدیدی را برای آن کار به مدت سه ماه پس از اعلام تاریخ منسوخ شدن تولید می‌کند.

برای مثال، اعلام منسوخ شدن گزارش content_owner_basic_a1 در تاریخ ۱۹ می ۲۰۱۶ بود. بنابراین، فیلد deprecateTime برای آن نوع گزارش، زمانی را در ۱۹ آگوست ۲۰۱۶ مشخص می‌کند که پس از آن، یوتیوب تولید گزارش‌هایی از آن نوع را متوقف خواهد کرد.
systemManaged boolean
این مقدار در صورتی true است که یوتیوب به طور خودکار گزارش را برای مالکان محتوای یوتیوب تولید کند، بدون اینکه مالکان محتوا نیاز داشته باشند ابتدا متد jobs.create را برای دستور دادن به یوتیوب جهت تولید گزارش فراخوانی کنند. در واقع، اگر ویژگی reportTypeId یک گزارش مدیریت‌شده توسط سیستم را شناسایی کند، متد jobs.create خطایی را برمی‌گرداند.