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
コンテンツ所有者のホワイトリストに登録されているチャンネルのリストを取得します。