PlaylistImages: insert

再生リストに画像を追加します。

このメソッドはメディア アップロードをサポートしています。アップロードするファイルには、以下の制約が適用されます。

  • 最大ファイル サイズ: 2 MB
  • 使用可能なアスペクト比: 1:1（スクエア）
  • 使用できるメディア MIME タイプ: image/jpeg、image/png

割り当ての影響: このメソッドを呼び出すと、50 ユニットの割り当てコストが発生します。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/youtube/v3/playlistImages

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です（認証と承認の詳細をご確認ください）。

スコープ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part string

part パラメータは、 1 つ以上の playlistImage リソースのカンマ区切りリスト API レスポンスに含まれるプロパティを指定します。

パラメータに は、子プロパティを含むプロパティを識別します。 含まれるようになります。
オプション パラメータ
onBehalfOfContentOwner string
このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwner パラメータは、リクエストの認証情報が、パラメータ値で指定されたコンテンツ所有者の代理を務める YouTube CMS ユーザーを識別することを示します。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
onBehalfOfContentOwnerChannel string
このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwnerChannel パラメータ 動画が送信されるチャンネルの YouTube チャンネル ID を指定します。 追加されました。このパラメータは、リクエストで値が onBehalfOfContentOwner パラメータです。このパラメータは、 そのパラメータを指定しますまた、リクエストは コンテンツの権利を所有しているコンテンツ所有者にリンクされた CMS アカウントを使用して、 onBehalfOfContentOwner パラメータで指定します。最後に、 onBehalfOfContentOwnerChannel パラメータ値が は、 onBehalfOfContentOwner パラメータを指定します。

これは、 このパラメータは、数多く所有、管理する YouTube コンテンツ パートナー向けです。 おすすめしますコンテンツ所有者は一度認証されると パラメータで指定されたチャンネルに代わってアクションを実行します。 認証情報を提供する必要はありません。 できます。

リクエスト本文

リクエストの本文には playlistImages リソースを指定します。

リソース:

  • 以下のプロパティの値を指定する必要があります。

    • snippet.playlistId
    • snippet.type

  • 以下のプロパティの値を設定することができます。

    • snippet.width
    • snippet.height

レスポンス

成功すると、このメソッドはレスポンスの本文で playlistImages リソースを返します。