Method: references.insert

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

  • リクエストで参照ファイルをアップロードする場合は、提供されたコンテンツを元に YouTube が参照を作成します。動画ファイルまたは音声ファイル、あるいは事前に生成されたフィンガープリントを指定できます。事前に生成されたフィンガープリントを指定する場合は、リクエストの本文で reference リソースの fpDirect プロパティを true に設定します。このフローでは、マルチパート アップロード フローまたは 再開可能な アップロード フローを使用して、参照コンテンツを指定できます。
  • 申し立てを行った動画を参照コンテンツとして使用して参照を作成する場合は、claimId パラメータを使用して申し立てを特定します。

HTTP リクエスト

  • アップロード URI（メディアのアップロード リクエストの場合）:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • メタデータ URI（メタデータのみの追加リクエストの場合）:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

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

クエリ パラメータ

パラメータ
claimId

string

claimId パラメータは、参照の作成元となる既存の申し立ての YouTube 申し立て ID を指定します。（申し立てを行った動画が参照コンテンツとして使用されます）。
onBehalfOfContentOwner

string

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

リクエストの本文

リクエストの本文には Reference のインスタンスが含まれます。

レスポンスの本文

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

認可スコープ

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

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

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