YouTube Content ID API - 変更履歴

注: YouTube Content ID API は YouTube コンテンツ パートナーが使用することを目的としており、すべてのデベロッパーやすべての YouTube ユーザーが利用できる API ではありません。Google API コンソールに表示されるサービスに YouTube Content ID API が表示されない場合は、YouTube ヘルプセンターで YouTube パートナー プログラムの詳細をご覧ください。

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

2025 年 3 月 26 日

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

2025 年 6 月 30 日までに、Content ID API は以下の変更に沿って更新されます。

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

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 API クライアント ライブラリを参照するようにしました。PHP の事前生成バインディングが更新されました。

2022 年 5 月 3 日

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

2022 年 5 月 2 日

assetSearch.list メソッドのレスポンスのドキュメントを更新し、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 パラメータのドキュメントが更新され、パラメータ値としてカンマ区切りの動画 ID を最大 10 個指定できるようになったことが記載されました。値に 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 API サービスの利用規約（「更新された利用規約」）は、YouTube エンジニアリングとデベロッパーの Blog で詳しく説明されていますが、現在の利用規約の多くの更新が含まれています。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[] プロパティには、リストが含まれます。各アイテムは、参照動画の一部と一致する申し立て対象動画のセグメントを表します。1 つの申し立てに複数の一致セグメントを含めることができます。たとえば、アップロードした動画の音声と動画コンテンツが参照動画のものと一致する場合、一致セグメントは 2 つになります。1 つのセグメントは音声の一致を記述し、もう 1 つのセグメントは動画の一致を記述します。

    一致セグメントごとに、一致したコンテンツの長さとタイプ（音声または動画）が 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 エラーが返された場合は、1 つのアセットまたは少数のアセットのリクエストを再送信してみてください。

  • 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 リクエストでファイル経由で参照を作成しようとしたが、リクエストで assetId が指定されていない場合、references.insert メソッドはこのエラーを返します。
  badRequest (400)	canNotBeActivated 参照のステータスや所有権の条件が原因で参照を有効にできない場合、references.update メソッドはこのエラーを返します。
  badRequest (400)	videoNotClaimed 広告オプションの取得を試みる動画を申し立てていない場合、videoAdvertisingOptions.get メソッドはこのエラーを返します。これにより、リクエストされた情報を利用できません。

2015 年 12 月 18 日

欧州連合（EU）の法律では、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 がリストされるようになりました。この値は、アセットに適用される一致ポリシーを API サーバーが取得するように指示します。

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

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

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

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

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

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 がサポートされるようになりました。メロディーの一致に関する申し立ては、申し立てを受けた動画が参照動画と楽曲を共有していることを示します。

  • API がこのメソッドに 2 つの異なるエンドポイントを使用することを適切に反映するように、references.insert メソッドのドキュメントが更新されました。これは 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 は生成された一意の ID を返すようになりました。この ID は、認証されたユーザーまたは API で管理されるリソースに関連付けられたコンテンツ所有者を識別します。以前は、API は ID として人間が読める名前（「qrs_network」など）を返していました。

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

  • API は、以前はパートナー コードを返していたリソース プロパティ（contentOwner リソースの id プロパティなど）の値として、新しい ID を返すようになりました。
  • API のすべてのメソッドは onBehalfOfContentOwner パラメータをサポートしています。このパラメータは、API リクエストを行うコンテンツ所有者を識別します。変更後、パラメータはパートナー コードではなく新しい 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 のすべてのメソッドは onBehalfOfContentOwner パラメータをサポートしています。このパラメータは、API リクエストを行うコンテンツ所有者を識別します。変更後、パラメータはパートナー コードではなく 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: クレームを検索するクレームのオリジン（descriptiveSearch や videoMatch など）を 1 つ以上指定します。
    • 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 リクエストで API レスポンス内のアセットの所有権の競合を取得するかどうかを示すブール値を指定します。デフォルト値は false です。これは、所有権の競合が返されないことを意味します。

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

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

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

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

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

  • errors ページが更新され、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 を使用して削除通知ポリシーを申し立てに適用することはできません。

  • reference リソースの新しい claimId プロパティは、アセットを CMS アカウントにリンクされている YouTube チャンネルにアップロードされた既存の YouTube 動画に関連付けることで参照が作成された場合に存在します。その場合、このフィールドには、アセットと動画との関連性を示す申し立ての 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	指定された所有権データに無効な値が含まれています。