Method: assets.get

指定したアセットのメタデータを取得します。別のアセットと統合されているアセットが識別された場合、つまりリクエストされたアセットが重複であると YouTube によって識別された場合は、統合済みまたは合成済みのアセットが取得されます。

HTTP リクエスト

GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
assetId

string

assetId パラメータには、取得するアセットの YouTube アセット ID を指定します。

クエリ パラメータ

パラメータ
fetchMatchPolicy

string

fetchMatchPolicy パラメータには、API レスポンスで返すアセット一致ポリシーのバージョンを指定します。

fetchMatchPolicy パラメータでは、API レスポンスで返すアセット一致ポリシーのバージョンのカンマ区切りのリストを指定します。非推奨フィールド matchPolicy は、fetchMatchPolicy の値が 1 つだけ指定された場合にのみ設定されます。有効な値は次のとおりです。

  • effective – YouTube がアセットに適用している一致ポリシーを取得します。
  • mine – 現在認証されているユーザーについて、デフォルトのコンテンツ所有者が設定した一致ポリシーを取得します。
  • none – アセットの一致ポリシーを取得しません。これがデフォルト値です。
fetchMetadata

string

fetchMetadata パラメータには、API レスポンスで返すアセットのメタデータのバージョンを指定します。YouTube は複数のソースからアセットのメタデータを受け取ることがあります。たとえば、異なる地域で異なるパートナーがアセットを所有している場合などです。

fetchOwnership

string

fetchOwnership パラメータでは、API レスポンスで返す必要があるアセットの所有権データのバージョンを指定します。アセットのメタデータと同様に、YouTube は複数のソースからアセット所有権データを受け取ることができます。

fetchOwnership パラメータには、API レスポンスで返すアセット所有権データのバージョンをカンマ区切りのリストで指定します。アセット メタデータと同様に、YouTube は複数のソースからアセット所有権データを受け取ることができます。

サポートが終了したフィールド ownership は、fetchOwnership の値を 1 つだけ指定した場合にのみ設定されます。

使用できる値は次のとおりです。

  • canonicalこのパラメータは非推奨になりましたeffectiveをご覧ください。
  • effective – そのアセットに対して最も正確であると YouTube がアルゴリズムによって判断した所有権データを取得します。
  • mine – 現在認証されているユーザーに関連付けられているデフォルトのコンテンツ所有者から提供された所有権データを取得します。
  • none – 所有権データを取得しません。これがデフォルト値です。
fetchOwnershipConflicts

boolean

fetchOwnershipConflicts パラメータを使用すると、所有権の競合に関する情報を取得できます。

onBehalfOfContentOwner

string

onBehalfOfContentOwner パラメータは、ユーザーが代理を務めるコンテンツ所有者を示します。このパラメータは、アカウントが複数のコンテンツ所有者に関連付けられているユーザーをサポートします。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には Asset のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/youtubepartner

詳細については、OAuth 2.0 の概要をご覧ください。