このページは Cloud Translation API によって翻訳されました。

YouTube Content ID API - 変更履歴

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

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

2023 年 11 月 10 日

videoAdvertisingOption リソースの adFormats[] フィールドが更新され、そのフィールドの有効な値が third_party_ads のみになりました。次の広告フォーマットのサポートは終了しました: 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（get、list）
fetchMetadata（get、list）
fetchOwnership（get、list）

2022 年 9 月 28 日

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

2022 年 7 月 18 日

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

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 日

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

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

2022 年 5 月 12 日

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

2022 年 5 月 3 日

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

2022 年 5 月 2 日

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

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 プロパティの定義をご覧ください。
新しい studioInfo オブジェクトの追加を反映するように、claim リソースと claimSearch リソースのドキュメントが更新されました。このオブジェクトには、申し立てに関連する YouTube Studio ページへのリンクが含まれています。
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 を指定し、その共有がリンクされているすべての楽曲ビューのリストを取得します。
新しい楽曲アセットの管理ガイドでは、さまざまな API メソッドでリクエストの処理の仕組みについて説明しています。これは、それらのメソッドに送信されたアセット ID が楽曲のビューまたは楽曲権利保有率を識別するかどうかによって異なります。
contentOwnerAdvertisingOptions リソースの新しい claimedVideoOptions.autoGeneratedBreaks プロパティは、申し立てが行われた動画の長さが 10 分を超える場合に、YouTube がミッドロール挿入点を自動的に生成するかどうかを示します。このプロパティは、コンテンツ所有者の 10 分を超えるすべての動画に影響しますが、1 つの動画に複数の申し立てがある場合は、動画を最初に申し立てたパートナーが、その動画に関するこのプロパティのデフォルトの動作を設定します。

2016 年 8 月 11 日

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

YouTube のエンジニアリングとデベロッパーブログで詳しく説明されている、新しく公開された YouTube API サービス利用規約（以下「更新後の規約」）では、現在の利用規約に加えられたさまざまな更新内容を提供しています。2017 年 2 月 10 日より適用される更新された利用規約に加えて、この更新には、デベロッパーが従う必要のあるポリシーを説明するのに役立つ補足ドキュメントがいくつか含まれています。

新しいドキュメントのすべてについては、更新された利用規約の変更履歴をご覧ください。さらに、更新版規約や関連文書に対する今後の変更についても、その変更履歴に記載されています。ドキュメントのリンクから、変更履歴における変更内容をリストする RSS フィードに登録できます。

2016 年 5 月 31 日

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

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

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

assets.patch メソッドと assets.update メソッドで次のエラーがサポートされるようになりました。前述のように、1 つのメソッドで同じエラータイプを持つ複数のエラーをサポートできます。発生する可能性のあるエラーの一覧については、各メソッドのエラードキュメントまたはエラーのページをご覧ください。

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

2016 年 3 月 28 日

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

既存のリソースとメソッドの更新
- claim リソースの新しい matchInfo.matchSegments[] プロパティには、参照動画の一部と一致する申し立てが行われた動画のセグメントについて、各アイテムが記述したリストが含まれます。1 つの申し立てに複数の一致セグメントを含めることができます。たとえば、アップロードされた動画の音声と動画コンテンツが参照動画のものと一致する場合、2 つのマッチセグメントが存在することになります。一方のセグメントは音声の一致について説明し、もう一方のセグメントは動画の一致を説明します。
  
  API は、一致セグメントごとに、一致したコンテンツの再生時間とタイプ（音声または動画）を返します。この API は、申し立てが行われた動画と参照動画の両方において、各一致セグメントの開始時点と終了時点のタイムオフセットも特定します。
- contentOwnerAdvertisingOptions.patch メソッドまたは contentOwnerAdvertisingOptions.update メソッドを呼び出すときに、contentOwnerAdvertisingOptions リソースの claimedVideoOptions.newVideoDefaults[] プロパティ値を更新できるようになりました。
- contentOwnerAdvertisingOptions リソースの読み取り専用の allowedOptions.autoGeneratedBreaks プロパティが非推奨になりました。

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

API の claims.update メソッドで次のエラーがサポートされるようになりました。前述のように、1 つのメソッドで同じエラータイプを持つ複数のエラーをサポートできます。発生する可能性のあるエラーの一覧については、各メソッドのエラードキュメントまたはエラーのページをご覧ください。

エラー
`badRequest (400)`	`alreadyClaimed` 申し立てが別の既存の申し立てと重複しているため、更新できません。

特に、リクエストが多数のアセットのデータを取得し、fetchMatchPolicy パラメータの値が effective の場合、assets.list メソッドはタイムアウトして 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 がサポートする新しいエラーと、各エラーを返す可能性があるメソッドを次の表に示します。1 つのメソッドが、同じエラータイプを持つ複数のエラーを返すことがあります。詳細については、各メソッドのエラードキュメントまたはエラーのページをご覧ください。

エラー
`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 ユーザーの同意ポリシーに準拠する必要があります。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 がサポートする新しいエラーと、各エラーを返す可能性があるメソッドを示します。1 つのメソッドが、同じエラータイプを持つ複数のエラーを返すことがあります。

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

エラーのタイプ	エラーの詳細	説明
`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
```

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

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

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

この変更は 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 では、認証されたユーザーまたは API を通じて管理されるリソースに関連付けられているコンテンツ所有者を一意に識別するために、「qrs_network」などの人が読める形式のパートナーコードを使用していました。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 がサポートする新しいエラーと、各エラーを返す可能性があるメソッドを示します。1 つのメソッドが、同じエラータイプを持つ複数のエラーを返すことがあります。たとえば、必須のメタデータフィールドがない 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 によって自動的に決定されるミッドロール挿入点のインストリーム広告の表示をオプトインできるかどうかを示します。
- https://www.googleapis.com/auth/youtubepartner-content-owner-readonly スコープを指定する認証トークンを使用して contentOwners.list メソッドを呼び出すことができるようになりました。
- policy リソースの新しい timeUpdated プロパティは、ポリシーが最後に更新された時刻を指定します。
- policies.list メソッドでオプションの sort パラメータがサポートされるようになりました。このパラメータを使用すると、結果を最終更新日時の昇順または降順で並べ替えることができます。
- referenceConflict リソースの新しい expiryTime プロパティは、参照の競合の審査期間の終了日を指定します。これにより、競合は期限切れとなります。
- videoAdvertisingOption リソースの新しい autoGeneratedBreaks プロパティは、YouTube によって自動的に決定される中断のタイミングでミッドロールのインストリーム広告を表示するかどうかを示します。

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

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

メソッド	エラー
`assets.insert` `assets.update`	`badRequest` – API は、アートトラックアセットへの書き込みオペレーションをサポートしていません。
`claimSearch.list`	`invalidValue` – リクエストの `pageToken` パラメータが無効なページトークンを指定しています。
`claims.insert`	`badRequest` – 動画のチャンネルが有効でないため、作成しようとしている申し立ては無効です。 `badRequest` – 申し立てしようとしている動画は削除ポリシーの対象外です。お問い合わせについては、copyright@youtube.com までお問い合わせください。 `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 オブジェクトのプロパティでメタデータエラーが発生していると識別するようになりました。このオブジェクトは、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 メソッドについて、API で fetchMetadata と fetchOwnership リクエストパラメータのカンマ区切り値がサポートされ、メタデータまたは所有権データのセットを複数取得できるようになりました。
  
  以下のリストでは、asset リソースの構造に対する対応する変更と、それらの変更が get、list、insert、update、patch asset リソースの API メソッドに与える影響について説明します。
  - metadata オブジェクトが非推奨になり、metadataMine オブジェクトと metadataEffective オブジェクトに置き換えられました。新しいオブジェクトを使用すると、API リクエストを行うコンテンツ所有者が提供するメタデータセットと、そのアセットで最も正確で完全なメタデータセットであると YouTube が判断した正規のメタデータセットの両方を、asset リソースに含めることができるようになります。
  - 同様に、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 パラメータにも当てはまります。
  
  同様に、下位互換性を確保するため、insert、update、patch へのリクエストには、asset リソースに 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[] プロパティは、参照を照合するときに無視する必要がある参照中の時間間隔のリストを指定します。各間隔には、動画の開始からの開始時刻と終了時刻を秒単位で指定します。
- API では、references.update または references.patch リクエストの本文で送信される reference リソースに status プロパティを設定する必要がなくなりました。
- videoAdvertisingOptions.getEnabledAds メソッドの API レスポンス形式を適切に説明するように、ドキュメントを修正しました。レスポンス（youtubePartner#videoAdvertisingOptionGetEnabledAds リソース）には次の情報が含まれます。
  - id – 設定に関連付けられている申し立てを行った動画を一意に識別するために YouTube が使用する ID。
  - adBreaks – 広告の掲載が許可された動画の再生前、再生中、または再生後の各オブジェクトに関する情報を含むオブジェクトのリスト。各オブジェクトでは、広告ブレークの他の属性（広告ブレーク中に表示する広告スロットや、各スロットで掲載できる広告のタイプなど）を指定することもできます。
  - adsOnEmbeds – 動画が埋め込みプレーヤーで再生されたときに YouTube が広告を表示できるかどうかを示すブール値フィールド。
  - countriesRestriction – 各オブジェクトが地域のリストと、それらの地域で動画の再生中に使用される広告フォーマットを識別するオブジェクトのリスト。

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

以下の表に、API がサポートする新しいエラーと、各エラーを返す可能性があるメソッドを示します。変更されたエラーも特定します。1 つのメソッドが、同じエラータイプを持つ複数のエラーを返すことがあります。たとえば、必須のメタデータフィールドがない 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` のいずれかです。
`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 プロパティが削除されました。
メソッドを呼び出すときに policyId プロパティまたは rules[] オブジェクトのいずれかの値を設定できることを反映するように、assetMatchPolicy.update メソッドのドキュメントが更新されました。

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 メソッドがいくつかあります。以下の表に、メソッドと、新たにサポートされるエラーの種類を簡単に示します。多くの場合、1 つのタイプに対して複数のエラーが発生することがあります。たとえば、必須のメタデータフィールドがない 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`	指定された所有権データに無効な値が含まれています。