YouTube Content ID API

YouTube Content ID API を使用すると、YouTube アセットと、それに関連付けられたコンテンツ、リファレンス、所有権、権利、ポリシーを管理できます。

サービス: youtubepartner.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストの際に次の情報を使用してください。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械で読み取り可能仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://youtubepartner.googleapis.com

REST リソース: assetLabels

メソッド
insert POST /youtube/partner/v1/assetLabels
オーナーのアセットラベルを挿入します。
list GET /youtube/partner/v1/assetLabels
オーナーのすべてのアセットラベルのリストを取得します。

REST リソース: assetMatchPolicy

メソッド
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
認証済みユーザーに関連付けられているコンテンツ所有者によって、指定されたアセットに割り当てられた一致ポリシーを取得します。
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
アセットの一致ポリシーを修正します。
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
アセットの一致ポリシーを更新します。

REST リソース: assetRelationships

メソッド
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
2 つのアセット間の関係を削除します。
insert POST /youtube/partner/v1/assetRelationships
2 つのアセットをリンクする関係を作成します。
list GET /youtube/partner/v1/assetRelationships
指定されたアセットの関係のリストを取得します。

REST リソース: assetSearch

メソッド
list GET /youtube/partner/v1/assetSearch
アセットのメタデータに基づいてアセットを検索します。

REST リソース: assetShares

メソッド
list GET /youtube/partner/v1/assetShares
このメソッドは、パートナーが所有し、指定されたアセットビュー ID にマッピングされるアセットシェアのリストを取得するか、パートナーが所有する指定されたアセットシェア ID に関連付けられたアセットビューのリストを取得します。

REST リソース: assets

メソッド
get GET /youtube/partner/v1/assets/{assetId}
指定されたアセットのメタデータを取得します。
insert POST /youtube/partner/v1/assets
指定されたメタデータを持つアセットを挿入します。
list GET /youtube/partner/v1/assets
アセットのメタデータに基づいてアセットのリストを取得します。
patch PATCH /youtube/partner/v1/assets/{assetId}
指定されたアセットのメタデータをパッチ適用します。
update PUT /youtube/partner/v1/assets/{assetId}
指定されたアセットのメタデータを更新します。

REST リソース: campaigns

メソッド
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
オーナーの指定されたキャンペーンを削除します。
get GET /youtube/partner/v1/campaigns/{campaignId}
オーナーの特定のキャンペーンを取得します。
insert POST /youtube/partner/v1/campaigns
指定されたキャンペーン データを使用して、オーナーの新しいキャンペーンを挿入します。
list GET /youtube/partner/v1/campaigns
オーナーのキャンペーンのリストを取得します。
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
特定のキャンペーンのデータをパッチ適用します。
update PUT /youtube/partner/v1/campaigns/{campaignId}
特定のキャンペーンのデータを更新します。

REST リソース: claimHistory

メソッド
get GET /youtube/partner/v1/claimHistory/{claimId}
指定された請求の請求履歴を取得します。

REST リソース: claimSearch

メソッド
list GET /youtube/partner/v1/claimSearch
検索条件に一致するクレームのリストを取得します。

REST リソース: claims

メソッド
get GET /youtube/partner/v1/claims/{claimId}
ID で特定のクレームを取得します。
insert POST /youtube/partner/v1/claims
クレームを作成します。
list GET /youtube/partner/v1/claims
現在認証されているユーザーに関連付けられているコンテンツ所有者が管理する申し立てのリストを取得します。
patch PATCH /youtube/partner/v1/claims/{claimId}
ポリシーまたはステータスを変更して、既存の請求を修正します。
update PUT /youtube/partner/v1/claims/{claimId}
ポリシーまたはステータスを変更して、既存の申し立てを更新します。

REST リソース: contentOwners

メソッド
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
指定されたコンテンツ所有者に関する情報を取得します。
list GET /youtube/partner/v1/contentOwners
リクエスト条件に一致するコンテンツ所有者のリストを取得します。

REST リソース: liveCuepoints

メソッド
insert POST /youtube/partner/v1/liveCuepoints
ライブ配信にキューポイントを挿入します。

REST リソース: metadataHistory

メソッド
list GET /youtube/partner/v1/metadataHistory
どのコンテンツ所有者がデータを提供したかに関係なく、アセットに提供されたすべてのメタデータのリストを取得します。

REST リソース: musicChangeRequests

メソッド
create POST /youtube/partner/v1/music/changeRequests
リリースまたはトラックに報告された音楽変更リクエストを作成します。
list GET /youtube/partner/v1/music/changeRequests
リリースまたはトラックに報告された音楽の変更リクエストのリストを取得します。

REST リソース: musicReleases

メソッド
list GET /youtube/partner/v1/music/releases
音楽リリースのリストを取得します。

REST リソース: musicTracks

メソッド
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
音楽トラックのリストを取得します。

REST リソース: ownership

メソッド
get GET /youtube/partner/v1/assets/{assetId}/ownership
認証されたユーザーに関連付けられているコンテンツ所有者によって指定されたアセットに提供された所有権データを取得します。
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
指定されたアセットの新しい所有権情報を提供します。
update PUT /youtube/partner/v1/assets/{assetId}/ownership
指定されたアセットの新しい所有権情報を提供します。

REST リソース: ownershipHistory

メソッド
list GET /youtube/partner/v1/ownershipHistory
どのコンテンツ所有者がデータを提供したかに関係なく、アセットの所有権データのリストを取得します。

REST リソース: package

メソッド
get GET /youtube/partner/v1/package/{packageId}
指定されたパッケージの情報を取得します。
insert POST /youtube/partner/v1/package
メタデータのみのパッケージを挿入します。

REST リソース: policies

メソッド
get GET /youtube/partner/v1/policies/{policyId}
指定された保存済みポリシーを取得します。
insert POST /youtube/partner/v1/policies
保存済みポリシーを作成します。
list GET /youtube/partner/v1/policies
コンテンツ所有者の保存済みポリシーのリストを取得します。
patch PATCH /youtube/partner/v1/policies/{policyId}
指定された保存済みポリシーをパッチ適用します。
update PUT /youtube/partner/v1/policies/{policyId}
指定された保存済みポリシーを更新します。

REST リソース: referenceConflicts

メソッド
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
指定された参照の競合に関する情報を取得します。
list GET /youtube/partner/v1/referenceConflicts
未解決の参照競合のリストを取得します。

REST リソース: references

メソッド
get GET /youtube/partner/v1/references/{referenceId}
指定された参照に関する情報を取得します。
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references

次のいずれかの方法で参照を作成します。

  • リクエストが参照ファイルのアップロードである場合、YouTube は提供されたコンテンツから参照を作成します。
list GET /youtube/partner/v1/references
ID による参照のリスト、または指定されたアセットの参照のリストを取得します。
patch PATCH /youtube/partner/v1/references/{referenceId}
参照にパッチを適用します。
update PUT /youtube/partner/v1/references/{referenceId}
参照を更新します。

REST リソース: spreadsheetTemplate

メソッド
list GET /youtube/partner/v1/spreadsheetTemplate
コンテンツ所有者のスプレッドシート テンプレートのリストを取得します。

REST リソース: uploader

メソッド
list GET /youtube/partner/v1/uploader
コンテンツ所有者のアップローダーのリストを取得します。

REST リソース: validator

メソッド
validate POST /youtube/partner/v1/validator
メタデータ ファイルを検証します。
validateAsync POST /youtube/partner/v1/validatorAsync
メタデータ ファイルを非同期で検証します。
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
非同期検証ステータスを取得します。

REST リソース: videoAdvertisingOptions

メソッド
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
指定された動画の広告設定を取得します。
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
指定されたパートナーまたはユーザーがアップロードした動画で許可されている広告の種類に関する詳細情報を取得します。
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
指定された動画の広告設定を修正します。
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
指定された動画の広告設定を更新します。

REST リソース: whitelists

メソッド
delete DELETE /youtube/partner/v1/whitelists/{id}
コンテンツ所有者のホワイトリストに登録されているチャンネルを削除します。
get GET /youtube/partner/v1/whitelists/{id}
ID で特定のホワイトリスト登録済みチャンネルを取得します。
insert POST /youtube/partner/v1/whitelists
コンテンツ所有者の YouTube チャンネルをホワイトリストに登録します。
list GET /youtube/partner/v1/whitelists
コンテンツ所有者のホワイトリストに登録されているチャンネルのリストを取得します。