ChannelBanners: insert
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
YouTube にチャンネル バナー画像をアップロードします。このメソッドは、チャンネル用のバナー画像を更新する 3 ステップのプロセスのうち、最初の 2 つのステップを示したものです。
channelBanners.insert メソッドを呼び出して、バイナリ画像データを YouTube にアップロードします。画像のアスペクト比は 16:9 で、2048 x 1152 ピクセル以上である必要があります。2,560×1,440 ピクセルの画像をアップロードすることをおすすめします。- ステップ 1 で API が返すレスポンスから
url プロパティの値を抽出します。 channels.update メソッドを呼び出して、チャンネルのブランディング設定を更新します。brandingSettings.image.bannerExternalUrl プロパティの値を、手順 2 で取得した URL に設定します。
このメソッドはメディア アップロードをサポートしています。アップロードするファイルには、以下の制約が適用されます。
- 最大ファイルサイズ: 6 MB
- 有効なメディア MIME タイプ:
image/jpeg、image/png、application/octet-stream
割り当てへの影響: このメソッドの呼び出しでは、50 ユニットの割り当て費用が発生します。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
承認
このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。認証と承認の詳細については、OAuth 2.0 承認の実装をご覧ください。
| 範囲 |
|---|
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
パラメータ
次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
| パラメータ |
| オプション パラメータ |
onBehalfOfContentOwner |
string
このパラメータは、適切に承認されたリクエストでのみ使用できます。
注: このパラメータは YouTube コンテンツ パートナー専用です。
onBehalfOfContentOwner パラメータは、リクエストの認証情報で、パラメータ値で指定されたコンテンツ所有者の代理で行動している YouTube CMS ユーザーを識別することを示します。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。 |
リクエスト本文
このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。
エラー
次の表に、このメソッドの呼び出しに対する応答として API から返される可能性のあるエラー メッセージを示します。詳細については、YouTube Data API - エラーをご覧ください。
| エラーのタイプ |
エラーの詳細 |
説明 |
badRequest (400) |
bannerAlbumFull |
YouTube チャンネル アート アルバムに画像が多すぎます。この問題を解決するには、Google フォトに移動し、アルバム ページに移動して、そのアルバムから一部の画像を削除します。 |
badRequest (400) |
mediaBodyRequired |
リクエストに画像コンテンツが含まれていません。 |
試してみよう:
APIs Explorer を使用してこの API を呼び出し、API リクエストとレスポンスを確認します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-21 UTC。
[null,null,["最終更新日 2024-12-21 UTC。"],[[["\u003cp\u003eThis method allows you to upload a channel banner image to YouTube, which is the initial stage of a three-step process for updating a channel's banner image.\u003c/p\u003e\n"],["\u003cp\u003eThe image uploaded must adhere to specific constraints, requiring a 16:9 aspect ratio, a minimum resolution of 2048x1152 pixels (recommended 2560x1440), a maximum file size of 6MB, and supported MIME types including \u003ccode\u003eimage/jpeg\u003c/code\u003e, \u003ccode\u003eimage/png\u003c/code\u003e, and \u003ccode\u003eapplication/octet-stream\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading the image, you need to extract the URL from the API response and use it in the \u003ccode\u003echannels.update\u003c/code\u003e method to set the channel's \u003ccode\u003ebannerExternalUrl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this API method will incur a quota cost of 50 units, and it necessitates authorization with one of the specified scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.upload\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe content owner can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e optional parameter to make the request, by authenticating with their CMS account, allowing to manage multiple channels.\u003c/p\u003e\n"]]],["To update a YouTube channel banner, first, use the `channelBanners.insert` method to upload a 16:9 aspect ratio image (at least 2048x1152 pixels, recommended 2560x1440px). The image file must be under 6MB and of `image/jpeg`, `image/png`, or `application/octet-stream` type. Then, extract the image URL from the API response. Finally, use the `channels.update` method to set the `brandingSettings.image.bannerExternalUrl` to the extracted URL. This method has a quota cost of 50 units.\n"],null,["# ChannelBanners: insert\n\nUploads a channel banner image to YouTube. This method represents the first two steps in a three-step process to update the banner image for a channel:\n\n\u003cbr /\u003e\n\n1. Call the `channelBanners.insert` method to upload the binary image data to YouTube. The image must have a 16:9 aspect ratio and be at least 2048x1152 pixels. We recommend uploading a 2560px by 1440px image.\n2. Extract the `url` property's value from the response that the API returns for step 1.\n3. Call the [channels.update](/youtube/v3/docs/channels/update) method to update the channel's branding settings. Set the [brandingSettings.image.bannerExternalUrl](/youtube/v3/docs/channels#brandingSettings.image.bannerExternalUrl) property's value to the URL obtained in step 2.\n\n\u003cbr /\u003e\n\nThis method supports media upload. Uploaded files must conform to these constraints:\n\n- **Maximum file size:** 6MB\n- **Accepted Media MIME types:** `image/jpeg`, `image/png`, `application/octet-stream`\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authorization](/youtube/v3/guides/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtube.upload` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` This parameter can only be used in a properly [authorized request](/youtube/v3/guides/authentication). **Note:** This parameter is intended exclusively for YouTube content partners. The **onBehalfOfContentOwner** parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. |\n\n### Request body\n\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns a [channelBanner](/youtube/v3/docs/channelBanners#resource) resource in the response body.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Data API - Errors](/youtube/v3/docs/errors).\n\n| Error type | Error detail | Description |\n|--------------------|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `badRequest (400)` | `bannerAlbumFull` | Your YouTube Channel Art album has too many images. To fix this, go to [Google Photos](http://photos.google.com), then navigate to the albums page and remove some images from that album. |\n| `badRequest (400)` | `mediaBodyRequired` | The request does not include the image content. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
