YouTube Content ID API - 変更履歴

注: YouTube Data API は YouTube コンテンツ パートナーによる使用を想定していますので、すべてのデベロッパーやすべての YouTube ユーザーがアクセスできるわけではありません。アクセスするには、YouTube コンテンツ マネージャ アカウントが必要です。YouTube コンテンツ マネージャー アカウントをお持ちで、Google Cloud コンソールに表示されるサービスのリストに YouTube Data API が含まれていない場合は、担当のパートナー マネージャーまたはパートナー サポートにお問い合わせください。

このページでは、YouTube Content ID API の変更内容とドキュメントの更新内容の一覧を示します。

2026 年 8 月 27 日

YouTube は、すべての動画フォーマット（長尺動画、ライブ配信、ショート動画）の公開視聴回数のカウント方法を統一します。YouTube では、動画の再生が開始された時点で公開視聴回数がカウントされます。

収益化の対象となる条件と、主要なパフォーマンス指標の大部分は、エンゲージメント指標に引き続き基づいているため、影響を受けません。クリエイターの収益は、引き続き「ショート動画のエンゲージ ビュー」と「エンゲージ総再生時間」に基づいて計算されます。これらの指標は、YouTube アナリティクス > [詳細モード] で確認できます。

YouTube パートナー プログラムの利用資格に変更はありません。YouTube パートナー プログラムの参加基準は、以前は「有効な公開ショート動画の視聴回数」と「有効な公開動画の総再生時間」でしたが、今後は「対象となるショート動画の視聴回数」と「対象となる動画の総再生時間」となります。

詳しくは、YouTube コンテンツのパフォーマンスを把握するをご覧ください。

指標	ステータス	トリガー	用途
表示	更新	動画が最初のフレームから再生される（自動再生、ポインタを合わせる、クリック/タップして再生など）。	標準の公開視聴回数。
エンゲージ ビュー	変更なし	最初のフレームを超えて再生が続行されるか、ユーザーがクリックまたはタップして再生する。	YouTube パートナー プログラムによる収益化、主要な分析情報の大部分（クリック率、平均視聴時間）、エンゲージメント レポート。
サムネイルのインプレッション数	変更なし	サムネイルは操作や自動再生なしで表示されます。	フィードレベルの露出とパッケージングを測定します。

2026 年 8 月 4 日

YouTube Content ID API のドキュメントが更新され、別のコンテンツ所有者がすでに所有しているアセットを更新する際のオペレーションの順序が明確になりました。

• アセットがすでに別のコンテンツ所有者に所有されている場合は、メタデータや一致ポリシーを設定または更新する前に、ownership.update または ownership.patch を使用してアセットに所有権を追加する必要があります。
• 所有権を主張する前にメタデータ（assets.update または assets.patch）または一致ポリシー（assetMatchPolicy.update または assetMatchPolicy.patch）を更新しようとすると、リクエストは失敗し、PERMISSION_DENIED エラーが返されます。
• アセットのラベルを更新するガイドを更新し、別のコンテンツ所有者が所有するアセットにラベルを追加する手順を記載しました。

2025 年 3 月 26 日

2025 年 3 月 31 日より、YouTube はショート動画の視聴回数のカウント方法を変更します。これまで、ショート動画の視聴回数は、ショート動画が一定の秒数再生された後にカウントされていました。最低再生時間の要件がなくなり、ショート動画の再生および繰り返し再生が開始された回数が視聴回数としてカウントされるようになります。詳細

この変更に伴い、2025 年 6 月 30 日までに Content ID API が次のように更新されます。

• claimSearch.list.sort の並べ替え順序が更新されます。
  • 以前の視聴回数のカウント方法に基づく 1 日の視聴回数に DAILY_ENGAGED_VIEWS が追加されます。
  • LIFETIME_ENGAGED_VIEWS は、以前の視聴回数のカウント方法に基づいて総視聴回数に追加されます。
• assetSearch.list.sort の並べ替え順序が更新されます。
  • 以前の視聴回数のカウント方法に基づく 1 日の視聴回数に DAILY_ENGAGED_VIEWS が追加されます。

この変更に伴い、2025 年 9 月 30 日までに Content ID API が次のように更新されます。

• assetSearch.list.sort 並べ替え順序 VIEWS は非推奨になります。
• claimSearch.list.sort 並べ替え順序 VIEW_COUNT は非推奨になります。
• claimSearch.claimSnippet.videoViews が更新され、ショート動画の視聴回数のカウント方法の更新が反映されます。
• 以前の視聴回数のカウント方法に基づく視聴回数に claimSearch.claimSnippet.engagedViews が追加されます

2025 年 1 月 14 日

videoAdvertisingOption リソースの autoGeneratedBreaks[] フィールドが更新されました。これは、ad_breaks と autoGeneratedBreaks を同時に指定できるようになったためです。adBreaks が定義されている動画で autoGeneratedBreaks が true に設定されている場合、手動で配置された広告スロットに加えて、広告を表示するスロットがシステムによって特定されます。詳しくは、サポート記事をご覧ください。

2023 年 11 月 10 日

videoAdvertisingOption リソースの adFormats[] フィールドが更新され、そのフィールドで有効な値が third_party のみになりました。次の広告フォーマットはサポートされなくなりました: instream_trueview、instream_standard、display、preroll、postroll。詳しくは、サポート記事をご覧ください。

2023 年 6 月 1 日

注: これは非推奨のお知らせです。

この更新には以下の変更が含まれます。

• 既存のリソースとメソッドの更新

  • videoAdvertisingOption リソースの breakPosition[] フィールドは非推奨としてマークされており、2024 年に削除されます。
    videoAdvertisingOptions.update メソッドと videoAdvertisingOptions.patch メソッドは、すでにこのフィールドを無視しています。
  • videoAdvertisingOption リソースの非推奨の adBreaks[].slot[] フィールドが削除されました。
  • asset リソースの非推奨の category フィールドと showCustomId フィールドが削除されました。
  • 新しい claim リソースの timeStatusLastModified フィールドには、請求が最後に変更された時刻が報告されます。
  • 新しい claimSearch.list メソッドの isVideoShortsEligible パラメータを使用すると、YouTube ショートの対象となるかどうかで申し立てを行った動画をフィルタできます。

• 新しいリソースとメソッド

  • API で YouTube Music リソースのリスト表示がサポートされるようになりました。
    • musicRelease リソースは musicReleases.list メソッドで一覧表示できます。
    • musicTrack リソースは musicTracks.list メソッドで一覧表示できます。
    • musicChangeRequest リソースは musicChangeRequests.list メソッドで一覧表示できます。

2022 年 12 月 20 日

assetSearch.list メソッドの ownershipRestriction クエリ パラメータの定義が更新され、そのパラメータの値が none の場合、metadataSearchFields パラメータの値でも少なくとも 1 つの ID フィルタを使用する必要があることが明確になりました。このドキュメントの変更は、API の動作の変更を反映したものではありません。

2022 年 11 月 9 日

asset.get メソッドと asset.list メソッドのドキュメントを更新し、次の複数の値がどのようにサポートされるかを明確にしました。

• fetchMatchPolicy （取得、 リスト）
• fetchMetadata （取得、 リスト）
• fetchOwnership （取得、 リスト）

2022 年 9 月 28 日

ライセンス可否に関する情報が asset resource に追加されました。

2022 年 7 月 18 日

claimSearch.list メソッドの inactiveReasons のドキュメントが更新され、YouTube Studio との整合性を高めるための改善が反映されました。

• Studio では、以前に Audio Swap と Song Erase のサポートが削除されています。対応する API 値 audio_removed と song_erased は、通知なしで無視されていましたが、ドキュメントから削除されました。
• channel_whitelisted を channel_allowlisted に置き換えました。以前の値はドキュメントに記載されていませんが、引き続きサポートされています。
• closed_disabled_monetization、closed_manually、closed_no_adsense、closed_own_video_match、reference_removed、replaced、video_modified の値がサポートされるようになりました。

2022 年 6 月 14 日

assetSearch リソースのドキュメントが更新され、2 つの新しいプロパティ isrcs[] と iswcs[] が反映されました。新しい isrcs[] プロパティ値と iswcs[] プロパティ値にはそれぞれ、検索結果で特定されたアセットにマッピングされる ISRC または ISWC を指定する文字列値の配列が含まれます。

新しいプロパティは、assetSearch リソースにすでに含まれている isrc プロパティと iswc プロパティよりも正確なデータを提供するため、新しいプロパティを使用することをおすすめします。新しいプロパティでは文字列値の配列をリストできる可能性がありますが、isrc プロパティと iswc プロパティはそれぞれ、検索結果に関連付けられた ISRC コードまたは ISWC コードを 1 つだけ識別します。

2022 年 5 月 12 日

クライアント ライブラリへのリンクが更新され、標準の Google APIs クライアント ライブラリを指すようになりました。PHP 用の事前生成バインディングが更新されました。

2022 年 5 月 3 日

claimSearch.list メソッドの status パラメータで、申し立ての可能性に関する詳細情報に基づくフィルタがさらにサポートされるようになりました。

2022 年 5 月 2 日

assetSearch.list メソッドの Response のドキュメントが更新され、AIP-158 との整合性を高めるための改善が反映されました。

• pageInfo.totalResults の説明には、値は推定値であり、実際の値ではないことが明示的に記載されています。
• pageInfo.resultsPerPage フィールドと pageInfo.startIndex フィールドが削除されました

2022 年 4 月 25 日

assetLabels.list リソースのドキュメントが更新され、labelPrefix と q のリクエスト パラメータの意味が明確になり、リクエスト / レスポンスでページネーションがサポートされていることが記載されました。

2021 年 12 月 8 日

claimSearch.list リソースのドキュメントが更新され、このメソッドが対象とする 2 つのユースケースが適切に反映されました。

• ID（アセット、参照、動画）またはクエリ文字列で検索する
• 申し立ての作成日、変更日、ステータスで検索する

ユースケースごとに、異なるクエリ パラメータのセットがサポートされています。claimSearch.list メソッドのドキュメントが更新され、各ユースケースでサポートされているパラメータが説明されるようになりました。

2021 年 11 月 17 日

この更新には以下の変更が含まれます。

• claims.update メソッドで、無効な申し立てまたは潜在的な申し立てのステータスを active に更新できるようになりました。claim リソースの status プロパティの定義で、詳細を確認してください。
• claim リソースと claimSearch リソースのドキュメントが更新され、申し立てに関連する YouTube Studio ページへのリンクを含む新しい studioInfo オブジェクトの追加が反映されました。
• claimSearch.list メソッドの origin パラメータでサポートされている値のリストが変更されました。このパラメータは、batchTool、inProductShorts、melodyMatch、youTubeAdmin の 4 つの値を追加でサポートするようになりました。また、dropboxUpload 値と webUpload 値はサポートされなくなりました。

2021 年 2 月 26 日

claimSearch.list メソッドの videoId パラメータのドキュメントが更新され、パラメータ値で最大 10 個の動画 ID をカンマ区切りで指定できるようになりました。値に 10 個を超える動画 ID が含まれている場合、API は badRequest エラー（400 HTTP レスポンス コード）を返します。

2018 年 12 月 6 日

注: これは非推奨のお知らせです。

API ドキュメントが更新され、contentOwnerAdvertisingOptions リソースとそのメソッドへの参照が削除されました。これらのメソッドはごく限定的に使用されており、使用していた API ユーザーにはこのお知らせの前に別途連絡しています。

2018 年 3 月 21 日

この改訂での変更内容は次のとおりです:

• ミュージック ビデオまたはサウンド レコーディングのアセットを挿入、更新、またはパッチ適用するたびに、metadataMine.artist プロパティを設定する必要があります。これらのリソースタイプにプロパティが設定されていない場合、API はエラーを返すようになりました。また、metadataMine.artist プロパティは、ミュージック ビデオとサウンド レコーディングのアーティストでのみサポートされます。

2017 年 7 月 24 日

この改訂での変更内容は次のとおりです:

• 新しい package リソースは、ウェブ、SFTP、またはその他の配信メカニズムで配信されるファイルのグループを表します。この API は、このリソースに対して次の 2 つのメソッドをサポートしています。

  • package.insert メソッドは、メタデータ ファイルを 1 つだけ含むメタデータのみのパッケージを検証してアップロードします。
  • package.get メソッドは、以前にアップロードされたパッケージに関する情報を取得します。

• validator.validate メソッドでは、uploaderName プロパティの定義が更新され、値はデータをアップロードするコンテンツ パートナーではなく、コンテンツ所有者が使用している特定のアップローダー アカウントを識別する web-google や yt-google などの値であることを示すようになりました。

• reference リソースの status プロパティは、参照が別の参照の重複であることを示すために値 duplicate_on_hold を使用しなくなりました。代わりに、参照が重複している場合、status プロパティの値は inactive に設定され、statusReason プロパティの値は REASON_DUPLICATE_FOR_OWNERS になります。

  ただし、以前と同様に、リソースの duplicateLeader プロパティは、参照が重複している場合にのみ設定されます。設定されている場合、そのプロパティの値は重複した参照を識別します。

2017 年 4 月 17 日

この改訂での変更内容は次のとおりです:

• 新しい assetShare リソースは、コンポジション アセットにのみ関連し、アセット リソースの 2 つの表現間の関係を識別します。これらの表示は、ユーザーの所有権とサウンド レコーディング アセットとの関連付けをより明確にし、より詳細に管理できるようにするための新しい公開データモデルを反映したものです。

  新しいモデルでは、各サウンド レコーディングは 1 つの一意のアセット（楽曲ビュー）にマッピングされます。そのアセットのメタデータは、特定の録音に関連付けられた楽曲の権利について YouTube が表示する標準的な情報のセットを表します。また、複数のデータ プロバイダからの情報を統合している場合もあります。

  また、楽曲の各所有者は独自の楽曲権利保有率アセットを所持します。楽曲権利保有率は、特定のパブリッシャーが楽曲アセットに対して提供した情報を表します。楽曲権利保有率は複数のサウンド レコーディングに関連付けることができます。

  assetShare リソースは、コンポジション ビューとコンポジション共有の関係を識別します。新しい assetShares.list メソッドを使用すると、次のいずれかを行うことができます。

  • 楽曲ビューの ID を指定し、リクエストを承認したパートナーが所有する対応する楽曲シェアを取得します（そのようなシェアが存在する場合）。
  • コンテンツ パートナーが所有する楽曲権利保有率の ID を指定して、その権利保有率がリンクされているすべての楽曲ビューのリストを取得します。

• 新しい楽曲アセットの管理ガイドでは、メソッドに送信されたアセット ID が楽曲ビューと楽曲権利保有率のどちらを識別するかによって、さまざまな API メソッドがリクエストを処理する方法について説明しています。

• contentOwnerAdvertisingOptions リソースの新しい claimedVideoOptions.autoGeneratedBreaks プロパティは、10 分を超える申し立て済みの動画で YouTube が自動的に広告の挿入点を生成するかどうかを示します。このプロパティは、コンテンツ所有者の 10 分を超えるすべての動画に影響しますが、動画に複数の申し立てがある場合は、その動画に対して最初に申し立てを行ったパートナーが、このプロパティのデフォルトの動作を設定します。

2016 年 8 月 11 日

この改訂での変更内容は次のとおりです:

• YouTube エンジニアリングとデベロッパーのブログで詳しく説明されている、新たに公開された YouTube API サービスの利用規約（以下「更新された規約」）では、現在の利用規約にさまざまな更新が加えられています。2017 年 2 月 10 日より発効する更新された利用規約に加え、今回の更新には、デベロッパーが遵守すべきポリシーを説明する複数の補足文書が含まれています。

  新しいドキュメントの完全なセットについては、更新された利用規約の変更履歴をご覧ください。また、更新された規約またはその補足資料の今後の変更についても、その変更履歴で説明します。ドキュメント内のリンクから、その改訂履歴の変更を一覧表示する RSS フィードを購読できます。

2016 年 5 月 31 日

この改訂での変更内容は次のとおりです:

• 新しいリソースとメソッド

  • 新しい validator.validate メソッドを使用すると、メタデータ ファイルに YouTube が正常に処理できない検証エラーが含まれているかどうかを判断できます。ファイルにエラーが含まれている場合、API レスポンスの errors プロパティには、各エラーの重大度、原因、場所を示す検証エラーのリストが含まれます。

• 新しいエラーと更新されたエラー

  • assets.patch メソッドと assets.update メソッドで、次のエラーがサポートされるようになりました。メソッドは、同じエラータイプの複数のエラーをサポートできます。考えられるエラーの完全なリストについては、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

    エラー
    invalidValue (400)	parameters.assetId 更新中のアセットが別のアセットと統合されたため、リクエストが失敗しました。エラー メッセージで返されたアセットの ID を assetId パラメータの値として使用して、リクエストを再送信します。

2016 年 3 月 28 日

この改訂での変更内容は次のとおりです:

• 既存のリソースとメソッドの更新

  • claim リソースの新しい matchInfo.matchSegments[] プロパティには、リストが含まれています。このリストの各項目は、参照動画の一部と一致する申し立てを行った動画のセグメントを表します。申し立てには複数の一致セグメントを含めることができます。たとえば、アップロードした動画の音声と動画のコンテンツが参照動画のコンテンツと一致する場合、一致するセグメントは 2 つになります。1 つのセグメントで音声の一致を説明し、もう 1 つのセグメントで動画の一致を説明します。

    一致するセグメントごとに、API は一致するコンテンツの長さとタイプ（音声または動画）を返します。API は、申し立てを行った動画と参照動画の両方で、各一致セグメントの開始時間と終了時間のオフセットも特定します。

  • contentOwnerAdvertisingOptions.patch メソッドまたは contentOwnerAdvertisingOptions.update メソッドを呼び出すときに、contentOwnerAdvertisingOptions リソースの claimedVideoOptions.newVideoDefaults[] プロパティ値を更新できるようになりました。

  • contentOwnerAdvertisingOptions リソースの読み取り専用の allowedOptions.autoGeneratedBreaks プロパティが非推奨になりました。

• 新しいエラーと更新されたエラー

  • API の claims.update メソッドで、次のエラーがサポートされるようになりました。メソッドは、同じエラータイプの複数のエラーをサポートできます。考えられるエラーの完全なリストについては、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

    エラー
    badRequest (400)	alreadyClaimed このクレームは既存の別のクレームと重複しており、更新できません。

  • assets.list メソッドは、特にリクエストが多数のアセットのデータを取得し、fetchMatchPolicy パラメータの値が effective の場合に、タイムアウトして 500 HTTP レスポンス コード（Internal Server Error）を返すことがあります。assets.list リクエストで複数のアセット ID を指定して 500 エラーが返された場合は、単一のアセットまたは少数のアセットに対してリクエストを再送信してみてください。

  • references.insert エラーのドキュメントが更新され、リクエストで破損した参照ファイルがアップロードされた場合、参照自体が処理されるまで問題が特定されないことが記載されました。そのため、references.insert リクエストが成功したレスポンスを返しても、参照が正常に処理されないことがあります。参照を挿入したら、references.list メソッドを使用してポーリングし、参照が想定どおりに有効になっていることを確認することをおすすめします。

2016 年 2 月 3 日

この改訂での変更内容は次のとおりです:

• 既存のリソースとメソッドの更新

  • この API が商品リスティング広告に対応しました。商品リスティング広告は、動画のコンテンツに関連する商品や動画のコンテンツに登場した商品をハイライト表示します。これらの広告は、動画再生中に表示されるスポンサー カードです。スポンサー カードは、広告システムによって自動的に追加されます。視聴者にはカードのティーザーが数秒間表示されます。また、動画の右上のアイコンをクリックして、動画のカードを閲覧することもできます。

    この変更により、product_listing を次のプロパティの値に含めることができるようになりました。

    リソース/API メソッド	プロパティ
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • assetSearch.list メソッドの新しい createdBefore と createdAfter は、特定の日付の前後に作成されたアセットのみを返すように API に指示します。

  • assetSearch.list リクエストに対する API レスポンスで、type プロパティが art_track_video の値をサポートするようになりました。アートトラック動画について詳しくは、YouTube ヘルプセンターをご覧ください。

  • claimSearch.list メソッドは、次の新しいパラメータをサポートしています。

    パラメータ
    referenceId	このフィルタ パラメータは、申し立てを取得する参照の YouTube 参照 ID を指定します。
    inactiveReasons	この省略可能なパラメータを使用すると、指定した理由で無効になった請求のみを API レスポンスに含めるように制限できます。パラメータ定義には、検索可能な無効な申し立てのタイプが一覧表示されます。
    partnerUploaded	この省略可能なブール値パラメータを使用すると、API レスポンスにパートナーがアップロードした申し立てのみを含めるか、パートナーがアップロードしていない申し立てのみを含めるかを指定できます。

  • reference リソースの新しい references#origination オブジェクトには、参照元を説明する情報が含まれています。

  • references.insert メソッドで、YouTube の gfp_gen ソフトウェアを使用して生成された参照をアップロードできるようになりました。事前に生成されたフィンガープリントを指定する場合は、アップロードされた reference リソースの fpDirect プロパティの値を true に設定します。

    この変更により、リファレンスをアップロードするときに fpDirect プロパティを設定しようとしても、API はエラーを返さなくなります。

• 新しいエラーと更新されたエラー

  ドキュメントに、whitelist リソースのメソッドから返されるエラーが記載されるようになりました。

  また、次の表に、API がサポートする新しいエラーと、各エラーを返す可能性のあるメソッドを示します。メソッドは、同じエラータイプの複数のエラーを返すことがあります。詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

  エラー
  badRequest (400)	inappropriateCampaignTarget 一部のユーザーに適さない可能性がある動画をキャンペーンで特集しようとすると、campaigns.insert メソッドと campaigns.update メソッドはこのエラーを返します。このエラーを解決するには、別のコンテンツを選択してハイライト表示してください。
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets claims.insert メソッドは、楽曲アセットまたはサウンド レコーディング アセットを使用してパートナーがアップロードした動画に対する申し立てを作成しようとすると、このエラーを返します。
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim 指定された動画の録音された音楽に対して申し立てがすでに存在する場合、claims.insert メソッドはこのエラーを返します。API を使用して直接構成の申し立てを追加することはできません。
  badRequest (400)	asset_id references.insert メソッドは、リクエストがファイルを通じて参照を作成しようとしたが、リクエストで assetId が指定されなかった場合に、このエラーを返します。
  badRequest (400)	canNotBeActivated 参照のステータスまたは所有権の条件が原因で参照を有効にできない場合、references.update メソッドはこのエラーを返します。
  badRequest (400)	videoNotClaimed 広告オプションを取得しようとしている動画の申し立てを行っていない場合、videoAdvertisingOptions.get メソッドはこのエラーを返します。これにより、リクエストされた情報が利用できなくなります。

2015 年 12 月 18 日

欧州連合（EU）の法律では、EU のエンドユーザーに対して一定の情報を開示し、同意を得ることを義務付けています。そのため、欧州連合のエンドユーザーに対しては、EU ユーザーの同意ポリシーを遵守する必要があります。この要件に関する通知を YouTube API 利用規約に追加しました。

2015 年 4 月 21 日

この改訂での変更内容は次のとおりです:

• 新しい campaign リソースは、特定のコンテンツ所有者キャンペーンを表します。これにより、コンテンツ所有者は、申し立てが行われたユーザー アップロード動画でアノテーションを使用してコンテンツを宣伝できます。たとえば、コンテンツ所有者は、映画のシーンを含む申し立て済みのユーザー アップロード動画に対して、その映画の動画再生ページへのリンクを追加するキャンペーンを作成できます。

  この API は、get、list、insert、update、patch、delete の campaign リソースに対するメソッドをサポートしています。

• API は、新しい campaigns.get、campaigns.insert、campaigns.update、campaigns.delete メソッドの新しいエラーをいくつかサポートしています。

2015 年 3 月 30 日

この改訂での変更内容は次のとおりです:

• 既存のリソースとメソッドの更新

  • assetSearch.list メソッドの新しい isrcs パラメータを使用すると、最大 50 個の ISRC のリストを指定できます。API レスポンスには、これらの ISRC に関連付けられているアセットが含まれます。

  • claimHistory リソースの event[].reason プロパティは、次の新しい値をサポートしています。各理由では、申し立てに関連する特定のイベントが発生した理由を説明します。

    • closed_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • closed_reference_conflict

  • claimSearch.list メソッドの新しい sort パラメータは、API レスポンスでリソースを並べ替えるために使用されるメソッドを指定します。デフォルトでは、リソースは作成された日付に基づいて逆の年代順（新しい順）で並べ替えられます。申し立てを行ったコンテンツの視聴回数が多い順にリソースを並べ替えることもできます。

    claimSearch.list リクエストで status パラメータ値が appealed、disputed、pending、potential、routedForReview のいずれかに設定されている場合、結果は申し立て審査期間の終了時刻で並べ替えられます。

  • ownership.update メソッドと ownership.patch メソッドで、これらのメソッドを呼び出すときに更新できるすべてのプロパティが正しく一覧表示されるようになりました。この変更は API ドキュメントの修正であり、API の機能の変更を示すものではありません。

  • assets.get メソッドと assets.list メソッドの fetchMatchPolicy パラメータで、サポートされている値として effective がリストされるようになりました。この値は、YouTube がアセットに適用する一致ポリシーを取得するよう API サーバーに指示します。

  • assets.list、claims.list、contentOwners.list、policies.list、publishers.list、references.list の各メソッドの id パラメータで、パラメータ値に最大 50 個のカンマ区切り ID を含めることができることが明記されました。

• 新しいエラーと更新されたエラー

  次の表に、API がサポートする新しいエラーと、各エラーを返す可能性のあるメソッドを示します。メソッドは、同じエラータイプの複数のエラーを返すことがあります。

  詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

  エラーのタイプ	エラーの詳細	説明
  badRequest (400)	tooManyIsrcs	isrcs パラメータで 50 個を超える ISRC が指定されている場合、assetSearch.list メソッドはこのエラーを返します。
  badRequest (400)	videoIsPrivate	非公開動画の所有権を主張しようとすると、claims.insert メソッドはこのエラーを返します。動画のプライバシー ステータスが public または unlisted の場合にのみ、申し立てを行うことができます。
  notModified (304)	blockOutsideOwnershipUnchanged	クレームの blockOutsideOwnership フラグが正常に変更されなかった場合、claims.update メソッドはこのエラーを返します。このエラーが発生する原因はいくつか考えられます。一般的な例としては、指定された変更が申し立てられた動画に影響しない場合などがあります。

2014 年 11 月 7 日

この改訂での変更内容は次のとおりです:

• 既存のリソースとメソッドの更新

  • claimSearch.list メソッドの status パラメータで routedForReview の値がサポートされるようになりました。この値は、アセットの一致ポリシーのルールに基づいて人間による審査が必要な申し立てに結果を制限します。

  • claimHistory リソースの event[].reason プロパティは、次の新しい値をサポートしています。各理由では、申し立てに関連する特定のイベントが発生した理由を説明します。

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • クレームのソースを識別する claim リソースの origin.source プロパティで、値 melodyMatch がサポートされるようになりました。メロディーの一致による申し立ては、申し立てを行った動画が参照と楽曲を共有していることを示します。

  • references.insert メソッドのドキュメントが更新され、API がそのメソッドに 2 つの異なるエンドポイントを使用していることが正しく反映されるようになりました。これは API の機能の変更ではなく、既存のドキュメントの修正です。

    • リクエストで新しい参照ファイルをアップロードする場合は、正しいエンドポイントは次のとおりです。

      POST https://www.googleapis.com/upload/youtube/partner/v1/references

    • リクエストが、申し立てを行った動画を参照コンテンツとして使用して参照を作成する場合、正しいエンドポイントは次のとおりです。

      POST https://www.googleapis.com/youtube/partner/v1/references

• 新しいエラーと更新されたエラー

  次の表に、API がサポートする新しいエラーと、各エラーを返す可能性のあるメソッドを示します。メソッドは、同じエラータイプの複数のエラーを返すことがあります。

  詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

  エラーのタイプ	エラーの詳細	説明
  badRequest (400)	invalidLabelName	アセットラベルの名前が無効な場合、assets.insert、assets.update、assetLabels.insert メソッドはこのエラーを返します。ラベル名は 2 ～ 30 文字にしてください。角括弧（<>）、カンマ（,）、コロン（:）、アンパサンド（&）、縦線（|）は使用できません。
  badRequest (400)	ownerHaveMaximumNumberOfLabels	コンテンツ所有者が現在許可されている最大数である 2,500 個の一意のアセットラベルをすでに定義している場合、assets.insert、assets.update、assetLabels.insert メソッドはこのエラーを返します。
  badRequest (400)	tooManyLabelsOnOneAsset	assets.insert メソッドと assets.update メソッドは、アセットが現在許可されている最大数である 30 個のアセットラベルにすでに関連付けられている場合に、このエラーを返します。
  badRequest (400)	channelMonetizationSuspended	動画のチャンネルがパートナーの申し立てにより停止されている場合、claims.insert メソッドと claims.update メソッドはこのエラーを返します。
  badRequest (400)	channelNotActive	動画のチャンネルが有効でない場合、claims.update メソッドはこのエラーを返します。

• リクエスト本文のリソースに metadataMine.contentType プロパティが含まれていない場合、assets.insert メソッドと assets.update メソッドは一部のアセットに対して badRequest エラーを返さなくなりました。

2014 年 9 月 23 日

この改訂での変更内容は次のとおりです:

• コンテンツ所有者 ID の変更

  2014 年 7 月 9 日の改訂履歴で発表されたコンテンツ所有者 ID の変更が有効になりました。この変更により、API は、認証済みユーザーまたは API を介して管理されるリソースに関連付けられたコンテンツ所有者を識別するために、生成された一意の ID を返すようになりました。以前は、API は「qrs_network」などの人間が読める名前を ID として返していました。

  この変更は次の API 機能に影響し、アプリケーションにパートナー コードをハードコードしているパートナーに影響する可能性があります。

  • API は、以前にパートナー コードを返していたリソース プロパティ（contentOwner リソースの id プロパティなど）の値として新しい ID を返すようになりました。
  • API のすべてのメソッドは、API リクエストが実行されるコンテンツ所有者を識別する onBehalfOfContentOwner パラメータをサポートしています。変更後は、パラメータをパートナー コードではなく新しい ID に設定する必要があります。コードの破損を防ぐため、移行期間中はパラメータでどちらの値も受け付けます。
  • 変更後は、contentOwners.list メソッドの contentOwnerId パラメータで、パートナー コードではなく新しい ID を指定する必要があります。

• 既存のリソースとメソッドの更新

  • assetSearch.list メソッドの新しい metadataSearchFields パラメータを使用すると、検索するアセットのメタデータ フィールドと、それらのフィールドで検索する値を指定できます。パラメータ値は、フィールドと値のペアのカンマ区切りのリストです。ペア内では、フィールドと値はコロンで区切られます。

  • claim リソースの新しい appliedPolicy オブジェクトは、YouTube が申し立てに実際に適用するポリシーを指定します。オブジェクトの値は policy リソースです。このリソースには、リクエストを送信したコンテンツ所有者が申し立てられたアセットを所有している国のポリシー情報が含まれています。

    適用されるポリシーは、コンテンツ所有者が定義したポリシーと次の 2 つの点で異なる可能性があります。

    1. このポリシーは、API リクエストを送信したコンテンツ所有者と同じ地域で、申し立てられたアセットの所有権を一部所有している他の所有者が設定したポリシーを考慮します。

    2. コンテンツ所有者が申し立てられたアセットを所有している地域に適用される YouTube の管理ポリシーが考慮されます。

  • claimHistory リソースの新しい uploaderChannelId プロパティは、申し立てが行われた動画がアップロードされたチャンネルのチャンネル ID を示します。

2014 年 9 月 8 日

この改訂での変更内容は次のとおりです:

• 新しいリソースとメソッド

  • 新しい assetLabel リソースは、アセットに割り当てることができるテキストラベルを識別します。アセットラベルを使用すると、アセットをカスタム カテゴリに分類して、アセット ライブラリを簡単に整理できます。ラベルに基づいてアセットを検索できるため、特定のアセットのグループの更新が必要な場合の操作も容易になります。

    • assetLabels.list メソッドを使用すると、コンテンツ所有者のラベルのリストを取得できます。
    • assetLabels.insert メソッドを使用すると、新しいアセットラベルを作成できます。assets.update メソッドを呼び出してアセットのラベルを更新することで、新しいラベルを作成することもできます。API サーバーは、以前に定義されていないラベルに対して新しい assetLabel リソースを自動的に作成します。

• 既存のリソースとメソッドの更新

  • asset リソースの label[] プロパティが更新され、assets.update メソッドを呼び出してアセットのラベルを更新できることが記載されました。ただし、assets.insert メソッドを呼び出すときにアセットのラベルを設定することはできません。

    新しいアセットラベルの使用ガイドでは、アセットラベルの作成と取得、アセットのラベルの更新、特定ラベルに関連付けられたアセットの検索方法について説明しています。

• 新しいエラーと更新されたエラー

  API は、新しい assetLabels.list メソッドと assetLabels.insert メソッドの新しいエラーをいくつかサポートしています。

2014 年 7 月 9 日

この改訂での変更内容は次のとおりです:

• コンテンツ所有者 ID の変更

  これまで、API では「qrs_network」などの人間が読めるパートナー コードを使用して、認証済みユーザーまたは API で管理されるリソースに関連付けられたコンテンツ所有者を一意に識別していました。2014 年第 3 四半期に、API はコンテンツ所有者を識別するために、一意の 22 文字の ID を使用するように切り替わります。この変更は次の API 機能に影響し、アプリケーションにパートナー コードをハードコードしているパートナーに影響する可能性があります。

  • API は、以前にパートナー コードを返していたリソース プロパティ（contentOwner リソースの id プロパティなど）の値として 22 文字の ID を返します。
  • API のすべてのメソッドは、API リクエストが実行されるコンテンツ所有者を識別する onBehalfOfContentOwner パラメータをサポートしています。変更後は、パラメータはパートナー コードではなく 22 文字の ID に設定されます。コードの破損を防ぐため、移行期間中はパラメータでどちらの値も受け付けます。
  • 変更後は、contentOwners.list メソッドの contentOwnerId パラメータで、パートナー コードではなく 22 文字の ID を指定する必要があります。

• 既存のリソースとメソッドの更新

  • asset リソースで、アセットに関連付けられているアセットラベルのリストを指定する label プロパティがサポートされるようになりました。複数のアセットに同じラベルを適用することでグループ化することができます。一括更新、レポートのダウンロード、YouTube アナリティクスのフィルタリングなどをする際に、このラベルを検索フィルタとして使用できます。

  • assetSearch.list メソッドで次のオプションのパラメータがサポートされるようになりました。

    • labels: 結果を、指定されたラベルに関連付けられているアセットのみに制限します。デフォルトでは、API は指定されたすべてのラベルに一致するアセットを返します。ただし、includeAnyProvidedLabel パラメータを使用すると、指定されたラベルのいずれかに一致するアセットを返すように API に指示できます。
    • includeAnyProvidedLabel: labels パラメータと組み合わせて使用されます。このパラメータは、labels パラメータ値で指定されたラベルのいずれかに関連付けられているアセットを返すよう API に指示します。

  • claimHistory リソースに次の新しいプロパティが追加されました。

    • event[].source.userEmail プロパティは、イベントを開始したユーザーのメールアドレスを提供します。
    • event[].typeDetails.disputeNotes プロパティには、dispute_create イベントの異議申し立てメモが含まれます。

  • claimSearch.list メソッドで次のオプションのパラメータがサポートされるようになりました。

    • createdAfter: 指定した日付以降に作成されたクレームのみが結果に含まれるように制限します。
    • createdBefore: 指定した日付より前に作成されたクレームのみが結果に含まれるように制限します。
    • includeThirdPartyClaims: videoId パラメータと組み合わせて使用されるこのパラメータは、API の結果にサードパーティのクレームを含めるかどうかを示します。

• エラーの詳細情報

  エラーに関するドキュメントで、各エラータイプの HTTP レスポンス コードが指定されるようになりました。

• 新しいエラーと更新されたエラー

  次の表に、API がサポートする新しいエラーと、各エラーを返す可能性のあるメソッドを示します。メソッドは、同じエラータイプの複数のエラーを返すことがあります。たとえば、必須のメタデータ フィールドがない asset リソースを挿入しようとすると、required エラーが返されます。実際には、必須のメタデータ フィールドが複数存在する場合があり、それぞれが少し異なるメッセージでエラーを返します。

  詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

  メソッド	エラー
  assetSearch.list	invalidValue - この API は、番組やシーズンのアセットを検索する機能をサポートしていません。type パラメータの値をサポートされている値に変更します。
  assets.insert	conflict - 同じ識別子（カスタム ID、ISRC など）を持つアセットが多すぎます。 conflict - 指定されたアセットのコピーが多すぎます。 invalidValue - API を呼び出すユーザーに、指定されたタイプのアセットを作成する権限がありません。
  assets.patch assets.update	badRequest - 試みたアセットタイプの変換は API でサポートされていません。
  claimSearch.list	badRequest - includeThirdPartyClaims パラメータは、videoId フィルタと組み合わせてのみ使用できます。
  ownership.patch ownership.update	badRequest - アートトラック アセットの所有権を更新することはできません。
  references.patch references.update	badRequest - 参照が、試行しているオペレーションに対して無効な状態です。

2014 年 2 月 3 日

この改訂での変更内容は次のとおりです:

• 既存のリソースとメソッドの更新

  • asset リソースの type 値を art_track_video に設定できるようになりました。

  • claimSearch リソースに次の新しいプロパティが追加されました。

    • origin オブジェクトには、申し立ての作成方法を説明する情報が含まれています。
    • thirdPartyClaim プロパティには、検索を実行しているユーザーに関連付けられているコンテンツ所有者以外のコンテンツ所有者によって申し立てが行われたかどうかを示すブール値が含まれます。

  • claimSearch.list メソッドで次のオプションのパラメータがサポートされるようになりました。

    • contentType: 結果を音声のみの申し立て、動画のみの申し立て、音声と映像の申し立てのいずれかのみに制限します。
    • origin: クレームを検索する 1 つ以上のクレーム オリジン（descriptiveSearch、videoMatch など）を指定します。
    • status: 指定されたステータスの申し立てのみが結果に含まれるように制限します。

  • claim リソースの status プロパティで、appealed、disputed、potential、takedown、unknown の値が追加でサポートされるようになりました。

  • claim リソースの新しい blockOutsideOwnership プロパティは、申し立てを行った動画が明示的に所有されていない地域でブロックされるかどうかを示します。デフォルトでは、申し立てが行われた動画は、申し立てに関連付けられたアセットの所有権データが定義されていない国でも引き続き視聴できます。

  • contentOwnerAdvertisingOption リソースの新しい allowedOptions.autoGeneratedBreaks プロパティは、パートナーが YouTube によって自動的に決定された中断のタイミングでミッドロール広告やインストリーム広告を表示するかどうかを指定できるかどうかを示します。

  • contentOwners.list メソッドを、https://www.googleapis.com/auth/youtubepartner-content-owner-readonly スコープを指定する認証トークンを使用して呼び出せるようになりました。

  • policy リソースの新しい timeUpdated プロパティは、ポリシーが最後に更新された時刻を指定します。

  • policies.list メソッドで、省略可能な sort パラメータがサポートされるようになりました。このパラメータを使用すると、結果を最終更新日時の昇順または降順で並べ替えるように指定できます。

  • referenceConflict リソースの新しい expiryTime プロパティは、参照競合の審査期間が終了し、競合が期限切れになる時刻を指定します。

  • videoAdvertisingOption リソースの新しい autoGeneratedBreaks プロパティは、YouTube によって自動的に決定された中断のタイミングで動画にミッドロール広告やインストリーム広告を表示するかどうかを示します。

• 新しいエラーと更新されたエラー

  次の表に、API がサポートする新しいエラーと、各エラーを返す可能性のあるメソッドを示します。メソッドは、同じエラータイプの複数のエラーを返すことがあります。たとえば、必須のメタデータ フィールドがない asset リソースを挿入しようとすると、required エラーが返されます。実際には、必須のメタデータ フィールドが複数存在する場合があり、それぞれが少し異なるメッセージでエラーを返します。

  詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

  メソッド	エラー
  assets.insert assets.update	badRequest - API はアートトラック アセットに対する書き込みオペレーションをサポートしていません。
  claimSearch.list	invalidValue - リクエストの pageToken パラメータで無効なページトークンが指定されています。
  claims.insert	badRequest - 動画のチャンネルが有効でないため、作成しようとしている申し立てが無効です。 badRequest - 申し立てを行おうとしている動画は、削除ポリシーの対象外です。お問い合わせは [e-mail] までお願いいたします。 badRequest - 指定された動画に対して第三者からの申し立てを作成できないため、リクエストを処理できません。 conflict - 動画が削除通知に対して異議申し立てを行ったため、YouTube はリクエストされた申し立てを作成できません。 conflict - 動画に有効な削除通知の申し立てがあるため、YouTube はリクエストされた申し立てを作成できません。
  references.insert	badRequest - 使用しようとしている申し立てを行った動画が削除されたか、不承認になったか、処理に失敗しました。

• 特定の API メソッドに固有ではない contentOwnerNotProvided エラーと internalError エラーは、各メソッドのページに表示されなくなりました。これらの説明は、API のエラー ドキュメントの一般的なエラーのセクションで確認できます。

2013 年 9 月 12 日

この改訂での変更内容は次のとおりです:

• 新しいリソースとメソッド

  • 新しい referenceConflict リソースは、2 つの参照ファイルの競合を特定し、競合が特定されたときにそれらのファイル間に存在した一致を一覧表示します。referenceConflicts.list メソッドを使用すると、承認されたコンテンツ所有者に関連付けられている未解決の参照ファイルの競合のリストを取得できます。referenceConflicts.get メソッドを使用すると、一意の参照競合 ID を指定して参照競合を取得できます。

  既存のリソースとメソッドの更新

  • この API で、アセットの有効な一致ポリシーを取得できるようになりました。この変更は、2013 年 7 月 16 日にリリースされた変更と並行して行われます。この変更では、アセットの正規のメタデータと所有権データのセットを取得するためのサポートが含まれていました。

    アセットの有効な一致ポリシーを取得するには、assets.get メソッドまたは assets.list メソッドのいずれかを呼び出すときに、fetchMatchPolicy パラメータ値を effective に設定します。API レスポンスで、返された各 asset リソースの matchPolicyEffective オブジェクトには、そのアセットの有効な一致ポリシーが含まれています。

  • asset リソースの新しい ownershipConflicts オブジェクトには、アセットの所有権の競合に関する情報が含まれています。オブジェクトの構造は ownership リソースの構造と似ています。リソースは、アセット オーナーが保持できるさまざまなタイプの権限を識別します。（ほとんどのアセット タイプでは、オーナーはアセットの一般的な所有権のみを保有できますが、楽曲アセットでは、オーナーは演奏権、シンクロ権、複製権の所有権を明示できます）。

    同様に、ownershipConflicts オブジェクトには、一般的な所有権、演奏権、同期権、複製権の競合を識別する個別のリストが含まれています。競合ごとに、競合が発生している地域、競合する所有権データを提供した所有者、競合する各所有者が所有権を主張しているアセットの割合がデータで特定されます。

  • assets.get メソッドと assets.get メソッドが新しい fetchOwnershipConflicts パラメータをサポートするようになりました。このパラメータは、API レスポンスでアセットの所有権の競合を取得するかどうかを示すブール値を持ちます。デフォルト値は false で、所有権の競合は返されません。

  • YouTube が検索するメタデータ フィールドを特定するために、assetSearch.list メソッドの q パラメータの定義が更新されました。

  • references.insert メソッドのリクエスト本文のドキュメントで、contentType プロパティの値を設定する必要があることが明記されました。この変更により、ドキュメントが更新され、実際の API 機能が適切に反映されますが、API 機能の変更はありません。

• 新しいエラーと更新されたエラー

  • この API は、特定のメソッドに固有ではない新しい forbidden エラーをサポートしています。このエラーは、リクエストされたオペレーションをサービス アカウントで承認できないことを示します。

  • assets.insert メソッドは、メタデータ エラーを metadata オブジェクトではなく metadataMine オブジェクトのプロパティで発生したものとして識別するようになりました。オブジェクトは、2013 年 7 月 16 日の API アップデートで非推奨になりました。

  • エラー ページが更新され、update メソッドと patch メソッドをサポートする各リソースについて、これらの 2 つのメソッドから返されるエラーを一覧表示するテーブルが 1 つ含まれるようになりました。以前は、リストは常に同じでしたが、ページには各メソッドのエラーが個別にリストされていました。

2013 年 7 月 16 日

この改訂での変更内容は次のとおりです:

• 新しいリソースとメソッド

  • 新しい claimHistory.get メソッドを使用すると、特定の申し立てを特定して、その情報を取得できます。返される claimHistory リソースには、申し立ての作成、更新、異議申し立て、終了など、申し立てに関連するイベントのリストが含まれます。

  • 新しい claimSearch.list メソッドを使用すると、次の条件のいずれかまたはすべてを満たす申し立てを検索できます。

    • 申し立ては特定のアセットに関連付けられます。
    • 申し立ては特定の動画に関連付けられます。
    • クレームがリクエストで指定されたクエリ文字列と一致する。

    API レスポンスの各 claimSnippet リソースには、申し立ての一意の申し立て ID、ステータス、タイプ（audio、video、または audiovisual）、申し立てに関連付けられているアセットと動画など、申し立てに関する詳細が含まれています。このリソースでは、申し立てを行った動画の視聴回数とタイトルも指定します。

• 既存のリソースとメソッドの更新

  • 列挙型の値のセットを持つプロパティでサポートされている値が、ドキュメントに記載されるようになりました。このようなプロパティには、asset リソースの type プロパティや claim リソースの status プロパティなどがあります。

  • assets.get メソッドと assets.list メソッドで、fetchMetadata リクエスト パラメータと fetchOwnership リクエスト パラメータのカンマ区切り値がサポートされるようになりました。これにより、複数のメタデータまたは所有権データのセットを取得できます。

    次のリストでは、asset リソースの構造に対する対応する変更と、get、list、insert、update、patch の asset リソースを使用する API メソッドに対する変更の影響について説明します。

    • metadata オブジェクトは非推奨となり、metadataMine オブジェクトと metadataEffective オブジェクトに置き換えられました。新しいオブジェクトを使用すると、asset リソースに、API リクエストを行うコンテンツ所有者が提供するメタデータのセットと、YouTube がアセットの最も正確で完全なメタデータのセットであると判断した標準メタデータのセットの両方を含めることができます。

    • 同様に、ownership オブジェクトは ownershipMine オブジェクトと ownershipEffective オブジェクトに置き換えられました。

    • matchPolicy オブジェクトが matchPolicyMine オブジェクトに置き換えられました。（現在、API ではアセットの有効な一致ポリシーを取得できません）。

    注: 後方互換性を確保するため、アセットに対して 1 つのメタデータ バージョン、1 つの所有権データセット、または 1 つの一致ポリシーのみがリクエストされた場合、API レスポンスには非推奨のオブジェクトと新しくサポートされるオブジェクトの両方が含まれます。たとえば、リクエストで fetchMetadata パラメータが mine に設定されている場合、API レスポンスには metadata オブジェクトと metadataMine オブジェクトが含まれます。どちらのオブジェクトにも同じデータが含まれます。（fetchMetadata=mine を設定する機能は、複数のメタデータ バージョンを取得できる機能の更新前からサポートされていました）。
    
    ただし、fetchMetadata パラメータが mine,effective に設定されている場合、API レスポンスには metadataMine オブジェクトと metadataEffective オブジェクトが含まれますが、metadata オブジェクトは含まれません。（この機能の更新前は fetchMetadata=mine,effective を設定する機能がサポートされていなかったため、後方互換性のために metadata オブジェクトを返す必要はありません）。この原則は、fetchOwnership パラメータと fetchMatchPolicy パラメータにも適用されます。
    
    同様に、下位互換性のため、asset リソースの insert、update、patch へのリクエストには、metadataMine オブジェクトまたは metadata オブジェクトのいずれかを含めることができます。この原則は、asset リソースの所有権データまたは一致ポリシーの設定にも当てはまります。

  • claims.list メソッドの assetId、q、videoId パラメータが非推奨になりました。これらの条件のいずれかを使用して申し立てを検索するには、これらのパラメータをすべてサポートする claimSearch.list メソッドを使用します。

  • ownership リソースでは、general[].ratio、performance[].ratio、synchronization[].ratio、mechanical[].ratio プロパティの値のコンテンツ形式が integer ではなく double になりました。

  • policy リソースの rules[].action プロパティの定義に、そのプロパティの有効な値（block、monetize、takedown、track）が一覧表示されるようになりました。ただし、API を使用して申し立てに削除ポリシーを適用することはできません。

  • 参照が、CMS アカウントにリンクされている YouTube チャンネルにアップロードされた既存の YouTube 動画にアセットを関連付けて作成された場合、reference リソースの新しい claimId プロパティが存在します。その場合、このフィールドには、アセットと動画の関連付けを表す申し立ての ID が含まれます。

  • reference リソースの新しい excludedIntervals[] プロパティは、参照の一致を試みる際に YouTube が無視する必要がある参照内の時間間隔のリストを指定します。各間隔では、動画の開始からの秒数で測定された開始時間と終了時間が指定されます。

  • API では、references.update リクエストまたは references.patch リクエストの本文で送信される reference リソースに status プロパティを設定する必要がなくなりました。

  • videoAdvertisingOptions.getEnabledAds メソッドの API レスポンス形式を正しく説明するようにドキュメントを修正しました。レスポンス（youtubePartner#videoAdvertisingOptionGetEnabledAds リソース）には、次の情報が含まれます。

    • id - 設定に関連付けられている申し立てを行った動画を一意に識別するために YouTube が使用する ID。

    • adBreaks - 各オブジェクトに、動画再生の前後または途中で広告の実行が許可される時点に関する情報が含まれるオブジェクトのリスト。各オブジェクトでは、ミッドロール挿入点の他の属性（ブレーク中に表示される広告スロットや、各スロットで実行できる広告のタイプなど）を指定することもできます。

    • adsOnEmbeds - 動画が埋め込みプレーヤーで再生されたときに YouTube が広告を表示できるかどうかを示すブール値フィールド。

    • countriesRestriction - 各オブジェクトが地域リストと、その地域での動画再生時に使用される広告フォーマットのリストを識別するオブジェクトのリスト。

• 新しいエラーと更新されたエラー

  • 次の表に、API がサポートする新しいエラーと、各エラーを返す可能性のあるメソッドを示します。また、変更されたエラーも特定します。メソッドは、同じエラータイプの複数のエラーを返すことがあります。たとえば、必須のメタデータ フィールドがない asset リソースを挿入しようとすると、required エラーが返されます。実際には、必須のメタデータ フィールドが複数存在する場合があり、それぞれが少し異なるメッセージでエラーを返します。

    詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

    メソッド	エラー
    assets.insert assets.update assets.patch	以前は metadata オブジェクトの子プロパティに関連付けられていた invalidValue エラーと required エラーが、metadataMine オブジェクトの同じ子プロパティに関連付けられるようになりました。
    claimHistory.get	notFound - 履歴を取得しようとしている申し立てが見つかりません。 required - リクエストで claimId パラメータの値が指定されていません。
    claimSearch.list claims.list	badRequest - リクエストで無効な条件が指定されています。指定できるフィルタ パラメータは、q、assetId、videoId のうち最大 1 つです。
    claims.insert	badRequest - リクエストされたコンテンツ所有者が申し立てに関連付けられたアセットの所有者ではないため、作成しようとしている申し立てが無効です。 badRequest - 代理で操作しているコンテンツ所有者には、指定されたアクションを含むポリシーを作成する権限がありません。 invalidValue - 代理で行動しているコンテンツ所有者には、API を介してユーザーがアップロードした動画を申し立てる権限がありません。
    contentOwners.list	badRequest - リクエストで無効な条件が指定されています。fetchMine、id のいずれかのフィルタ パラメータを 1 つだけ指定する必要があります。（以前は、エラーに別のフィルタ パラメータ セット（has_conflicts_with、restrict_to_user、name_prefix、id）がリストされていました）。
    ownership.update ownership.patch	badRequest - 構成アセットの所有権データを更新するリクエストでは、general 所有権ではなく、mechanical、performance、synchronization、lyric のいずれかの権利を指定する必要があります。lyric 権限タイプが新たにサポートされました。
    policies.insert policies.update policies.patch	invalidValue - API が takedown アクションを指定するポリシーの作成または変更をサポートしていないため、リクエストに無効なポリシー ルールが含まれています。このエラー（理由として invalidPolicyTakedownAction を報告）は、サポートが終了した invalidPolicyConditionalTakedown エラーに代わるものです。
    references.insert	badRequest - リクエストでメディア ファイルを送信するか、claimId リクエスト パラメータの値を指定する必要があります。ただし、リクエストでメディア ファイルを送信し、claimId リクエスト パラメータの値を指定することはできません。 badRequest - 同じコンテンツの参照が、同じ YouTube 動画に対する別の申し立てからすでに作成されています。 badRequest - API は、参照の作成時に fpDirect プロパティの値を設定する機能をサポートしていません。 internalError - アップロードされたメディア ファイルに問題があります。 invalidValue - contentType、assetId、または claimId リクエスト パラメータの値が無効です。エラーは無効な値を特定します。 notFound - 指定したアセットまたは申し立てが見つかりません。リクエストの assetId パラメータと claimId パラメータの値を確認してください。 required - リクエストで contentType パラメータの値を指定する必要があります。
    references.insert references.update references.patch	invalidValue - 参照に指定された excludedIntervals が無効です。参照を無効にする際に除外間隔を指定することはできません。

2013 年 5 月 10 日

この改訂での変更内容は次のとおりです。

• YouTube では、試験的な API の機能とサービスを識別しなくなりました。代わりに、非推奨ポリシーが適用される YouTube API の一覧を提供しています。

2013 年 4 月 8 日

この改訂での変更内容は次のとおりです:

• API の名前が YouTube Content ID API に変更されました。

• assetMatchPolicy リソースでいくつかのプロパティが変更されました。

  • kind プロパティの値が youtubePartner#policy から youtubePartner#assetMatchPolicy に変更されました。
  • 新しい policyId プロパティには、保存済みポリシー リソースを一意に識別する値が含まれています。
  • rules[].subaction プロパティの値が文字列ではなく文字列のリストになりました。
  • rules[].conditions.contentMatchType プロパティの値が文字列ではなく文字列のリストになりました。
  • id、name、description プロパティが削除されました。

• assetMatchPolicy.update メソッドのドキュメントが更新され、メソッドの呼び出し時に policyId プロパティまたは rules[] オブジェクトのいずれかの値を設定できることが反映されました。

• claims リソースで、次の新しいプロパティがサポートされるようになりました。

  プロパティ名	値	説明
  timeCreated	datetime	申し立てが作成された日時。
  matchInfo	object	matchInfo オブジェクトには、申し立てを生成した一致するコンテンツに関する情報が含まれます。この情報は、アップロードされた動画が既存の参照ファイルと一致したために申し立てが自動的に生成された場合にのみ、claim リソースに含まれます。
  matchInfo.referenceId	string	一致を生成した参照 reference を識別するために YouTube が使用する一意の ID。
  matchInfo.longestMatch	object	longestMatch オブジェクトには、参照ファイルとアップロードされた動画の最長一致に関する情報が含まれます。
  matchInfo.longestMatch.durationSecs	unsigned long	試合の長さ（秒単位）。
  matchInfo.longestMatch.userVideoOffset	unsigned long	アップロードされた動画の先頭からの秒数で表した、試合の開始時の時間オフセット。
  matchInfo.longestMatch.referenceOffset	unsigned long	一致が開始されるときの時間オフセット。参照の開始からの秒単位で測定されます。
  matchInfo.totalMatch	object	totalMatch オブジェクトには、参照コンテンツと一致したアップロード動画の合計量と、アップロード動画と一致した参照コンテンツの合計量に関する情報が含まれます。アップロードされた動画または参照で一致するコンテンツがループで実行されている場合、これらの値は異なることがあります。たとえば、アップロードされた動画に参照の 10 秒のクリップが含まれていて、そのクリップが 6 回繰り返されている場合、アップロードされた動画の合計一致コンテンツは 60 秒ですが、参照の合計一致コンテンツは 10 秒のみです。
  matchInfo.totalMatch.userVideoDurationSecs	unsigned long	参照ファイルと一致するアップロード動画のコンテンツの合計時間（秒単位）。
  matchInfo.totalMatch.referenceDurationSecs	unsigned long	アップロードされた動画と一致する参照コンテンツの合計時間（秒単位）。
  origin	object	origin オブジェクトには、クレームのソースを記述する情報が含まれています。
  origin.source	string	クレームのソース。

• claims リソースの policy プロパティが更新され、AudioSwap の申し立てでは値を更新できないことが明記されました。

• metadataHistory リソースの timeProvidedMs プロパティの名前が timeProvided に変更されました。

• ownershipHistory リソースの timeProvidedMs プロパティの名前が timeProvided に変更されました。

• ownershipHistory.list メソッドの定義が更新され、このメソッドは各コンテンツ所有者の最新の所有権データのみを取得することが明記されました。ただし、コンテンツ所有者が複数のデータ ソース（API、コンテンツ フィードなど）を通じて所有権データを送信した場合は、各コンテンツ所有者とデータ ソースの最新データがリストに含まれます。

• policy リソースでいくつかのプロパティが変更されました。

  • rule プロパティの名前が rules に変更されました。
  • rules[].subaction プロパティの値が文字列ではなく文字列のリストになりました。
  • rules[].conditions.contentMatchType プロパティの値が文字列ではなく文字列のリストになりました。

• policies.insert メソッドと policies.update メソッドのドキュメントが更新され、これらのメソッドを呼び出すときに rules[] オブジェクトの値を設定できることが反映されました。

• いくつかの API メソッドが新しいエラータイプをサポートしています。次の表に、メソッドと、新たにサポートされるエラーの種類を簡単に示します。多くの場合、特定のエラーが複数発生することがあります。たとえば、必須のメタデータ フィールドがない asset リソースを挿入しようとすると、required エラーが返されます。実際には、必須のメタデータ フィールドが複数存在する場合があり、それぞれが少し異なるメッセージでエラーを返します。

  詳細については、各メソッドのエラー ドキュメントまたはエラーのページをご覧ください。

  メソッド	エラー
  assets.insert	invalidValue - アセットのメタデータ フィールドに無効な値が含まれています。 required - 必須のアセットのメタデータ フィールドがありません。
  assets.update assets.patch	forbidden - 更新しようとしているアセットは、更新を完了しようとしているパートナーが所有していません。 invalidValue - アセットのメタデータ フィールドに無効な値が含まれています。 notFound - アセットが、見つからないシーズン アセットまたは番組アセットに関連付けられています。 required - 必須のアセットのメタデータ フィールドがありません。
  claims.insert	badRequest - リクエストで動画の申し立てが試みられましたが、申し立ては許可されていません。
  ownership.update ownership.patch	badRequest - リクエストで、地域内の所有権の合計が 100% を超えるように定義されています。
  policies.insert policies.patch policies.update	conflictingPolicyRules - ポリシーに競合するポリシー ルールが含まれています。

• 新しい [エラー] ページには、API が返す可能性があるエラーが一覧表示されます。このページには、複数の異なる API メソッドで発生する可能性のある一般的なエラーと、メソッド固有のエラーが記載されています。

2013 年 1 月 18 日

この改訂での変更内容は次のとおりです:

• 新たにドキュメント化された videoAdvertisingOptions.getEnabledAds メソッドを使用すると、指定されたパートナーまたはユーザーがアップロードした動画で許可されている広告の種類に関する詳細情報を取得できます。

• assetSearch.list メソッドの ownershipRestriction パラメータの定義が更新され、デフォルトのパラメータ値が mine であることが明記されました。これは、API が現在のユーザーが所有するアセットのみを取得する必要があることを示します。

• assets.list メソッドのドキュメントには、次の変更が反映されています。

  • id パラメータが必須になりました。

  • 新たにサポートされた fetchMatchPolicy パラメータを使用すると、API リクエストでアセットに設定した一致ポリシーも取得するかどうかを指定できます。

  • 新たにサポートされた fetchOwnership パラメータを使用すると、API リクエストでアセットの所有権データも取得するかどうかを指定できます。

  • API が返すアセットのリストに、ページネーション データが含まれなくなりました。その結果、nextPageToken プロパティと pageInfo オブジェクトの両方が API レスポンスから削除されました。pageInfo オブジェクトには、totalResults、resultsPerPage、startIndex の各プロパティが含まれていました。

• claims リソースのドキュメントが更新され、請求を作成するときにポリシーを指定する必要があることが記載されました。（以前のドキュメントでは、挿入された申し立てでポリシーが指定されていない場合、デフォルトの利用ポリシーが適用されると記載されていましたが、現在、YouTube ではそのようなことはありません）。

• policy リソースの hasUnpublishedDraft プロパティは非推奨になりました。

• policies.list メソッドで新たにサポートされる id パラメータを使用すると、API リクエストで取得する保存済みポリシーを特定できます。取得できるのは、現在認証済みのコンテンツ所有者に属するポリシーのみです。

• references.patch メソッドと references.update メソッドの両方の releaseClaims パラメータの定義が更新され、パラメータは請求のステータスが inactive に更新される場合にのみ機能することが明記されました。その場合は、releaseClaims パラメータの値を true に設定して、参照によって生成されたすべての照合請求をリリースすることもできます。

• references.patch メソッドと references.update メソッドの両方が更新され、これらのオペレーションのいずれかを実行するときに参照のステータスを指定する必要があることが明記されました。

• いくつかの API メソッドが新しいエラータイプをサポートしています。次の表に、メソッドと新たにサポートされるエラーを示します。

  メソッド	エラーのタイプ	エラーの詳細	説明
  guideCategories.list	notFound	Unavailable	一致ポリシーを取得しようとしているアセットが見つかりません。
  claims.get	notFound	Unavailable	取得しようとしている申し立てが見つかりません。
  ownership.patch	invalidValue	Unavailable	提供された所有権データに無効な値が含まれています。
  ownership.update	invalidValue	Unavailable	提供された所有権データに無効な値が含まれています。