ReportTypes

reportType リソースは、チャンネルまたはコンテンツ所有者が取得できる特定のレポートを識別します。

Methods

次の表に、API が report リソースをサポートしているメソッドを示します。

Methods
list チャンネルまたはコンテンツ所有者が取得できるレポートタイプのリストを返します。

JSON リソース表現

次の JSON 構造は、reportType リソースの形式を示しています。

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

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。

プロパティ
id string
レポートを一意に識別するために YouTube によって使用される ID。プロパティ値の最大長は 100 文字です。以下の表は、サポートされている各レポートタイプの最新バージョン(最大 100 文字)を示しています。

name string
レポートの名前。プロパティ値の最大長は 100 文字です。
deprecateTime timestamp
レポートが廃止された日時。非推奨のレポートタイプのジョブがある場合、非推奨日が発表されてから 3 か月間、そのジョブの新しいレポートが生成されます。

たとえば、content_owner_basic_a1 レポートの非推奨に関するお知らせは、2016 年 5 月 19 日に行われました。したがって、このレポートタイプの deprecateTime フィールドには 2016 年 8 月 19 日の時刻が指定されます。それ以降は、そのタイプのレポートは生成されなくなります。
systemManaged boolean
コンテンツ所有者が YouTube コンテンツ所有者向けのレポートを自動的に生成する場合、この値は最初に jobs.create メソッドを呼び出して YouTube に生成し、生成する必要があります。実際、reportTypeId プロパティがシステム管理のレポートを識別する場合、jobs.create メソッドはエラーを返します。