Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
Watermarks: unset
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kanalın filigran resmini siler.
Kota etkisi: Bu yönteme yapılan bir çağrının 50 birim kota maliyeti olur.
İstek
HTTP isteği
POST https://www.googleapis.com/youtube/v3/watermarks/unset
Parametreler
Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen parametrelerin tümü sorgu parametreleridir.
Parametreler |
Gerekli parametreler |
channelId |
string
channelId parametresi, filigranın ayarlanmadığı YouTube kanal kimliğini belirtir. |
İsteğe bağlı parametreler |
onBehalfOfContentOwner |
string
Not: Bu parametre yalnızca YouTube içerik iş ortaklarına yöneliktir.
onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yaparak tüm video ve kanal verilerine erişmelerine olanak tanır. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır. |
İstek içeriği
Bu yöntemi çağırırken istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem bir HTTP 204
yanıt kodu (No Content
) döndürür.
Hatalar
Aşağıdaki tabloda, API'nin bu yönteme yapılan çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.
Hata türü |
Hata ayrıntısı |
Açıklama |
forbidden (403) |
forbidden |
Filigran, belirtilen kanal için ayarlanamıyor. İstek düzgün şekilde yetkilendirilmemiş veya channelId parametresi geçersiz bir değere ayarlanmış olabilir. |
Deneyin.
Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer 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-04-26 UTC.
[null,null,["Son güncelleme tarihi: 2024-04-26 UTC."],[[["\u003cp\u003eThis API method removes a watermark image from a specified YouTube channel.\u003c/p\u003e\n"],["\u003cp\u003eA successful call to this API returns an HTTP \u003ccode\u003e204\u003c/code\u003e response, indicating no content.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization using \u003ccode\u003eyoutubepartner\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutube.force-ssl\u003c/code\u003e scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe required parameter \u003ccode\u003echannelId\u003c/code\u003e specifies the YouTube channel from which the watermark is being removed.\u003c/p\u003e\n"],["\u003cp\u003eThe optional \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter is available for YouTube content partners to manage multiple channels under one authorization.\u003c/p\u003e\n"]]],["This API method deletes a channel's watermark image. It requires authorization with specific scopes and incurs a quota cost of 50 units per call. The request is made via a POST request to the specified URL, requiring the `channelId` parameter, and optionally `onBehalfOfContentOwner`. A successful call returns a `204` response, while a `403` error indicates issues with authorization or an invalid `channelId`. No request body is used for the call.\n"],null,["# Watermarks: unset\n\nDeletes a channel's watermark image.\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/youtube/v3/watermarks/unset\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/guides/authentication)).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\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| **Required parameters** |||\n| `channelId` | `string` The **channelId** parameter specifies the YouTube channel ID for which the watermark is being unset. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **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 an HTTP `204` response code (`No Content`).\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. Please see the [error message](/youtube/v3/docs/errors) documentation for more detail.\n\n| Error type | Error detail | Description |\n|-------------------|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forbidden (403)` | `forbidden` | The watermark can't be unset for the specified channel. The request may not be properly authorized, or the `channelId` parameter is set to an invalid value. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]