Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
ChannelBanners: insert
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
YouTube'a kanal banner'ı resmi yükler. Bu yöntem, bir kanalın banner resmini güncellemeyle ilgili üç adımlı sürecin ilk iki adımını temsil eder:
- İkili görüntü verilerini YouTube'a yüklemek için
channelBanners.insert yöntemini çağırın. Resim en boy oranı 16:9 ve en az 2048x1152 piksel olmalıdır. 2560 piksel x 1440 piksel boyutunda bir resim yüklemenizi öneririz. - 1. adımda API'nin döndürdüğü yanıttan
url mülkünün değerini ayıklayın. - Kanalın marka öğelerini güncellemek için
channels.update yöntemini çağırın. brandingSettings.image.bannerExternalUrl mülkünün değerini 2. adımda elde edilen URL olarak ayarlayın.
Bu yöntem, medya yüklemeyi destekler. Yüklenen dosyalar aşağıdaki kısıtlamalara uygun olmalıdır:
- Maksimum dosya boyutu: 6 MB
- Kabul edilen medya MIME türleri:
image/jpeg, image/png, application/octet-stream
Kota etkisi: Bu yöntemin çağrısı 50 birim kota maliyetine sahiptir.
İstek
HTTP isteği
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
Yetkilendirme
Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 yetkilendirmesini uygulama başlıklı makaleyi inceleyin.
| Kapsam |
|---|
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametreler
Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.
| Parametreler |
| İsteğe bağlı parametreler |
onBehalfOfContentOwner |
string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.
Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.
onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube içerik yönetim sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulama yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimlik doğrulaması yaptığı İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır. |
İstek içeriği
Bu yöntemi çağırırken istek gövdesi sağlamaz.
Yanıt
Başarılı olursa bu yöntem, yanıt gövdesinde bir channelBanner kaynağı döndürür.
Hatalar
Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için YouTube Data API - Errors başlıklı makaleyi inceleyin.
| Hata türü |
Hata ayrıntısı |
Açıklama |
badRequest (400) |
bannerAlbumFull |
YouTube kanal resmi albümünüzde çok fazla resim var. Bu sorunu düzeltmek için Google Fotoğraflar'a gidin, ardından albümler sayfasına gidip albümden bazı resimleri kaldırın. |
badRequest (400) |
mediaBodyRequired |
İstek, resim içeriğini içermiyor. |
Deneyin!
Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-12-21 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
