Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
Watermarks
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
watermark kaynağı, belirli bir kanalın videolarının oynatılması sırasında gösterilen resmi tanımlar. Ayrıca, resmin bağlanacağı hedef kanalı ve filigranın video oynatma sırasında ne zaman görüneceğini ve ne kadar süreyle görünür kalacağını belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.
Yöntemler
API, watermarks kaynakları için aşağıdaki yöntemleri destekler:
- set
- YouTube'a filigran resmi yükler ve bunu bir kanal için ayarlar.
- unset
- Kanalın filigran resmini siler.
Hemen deneyin.
Özellikler
Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:
| Özellikler |
timing |
object
timing nesnesi, video oynatma sırasında kanalın filigran resminin gösterileceği zamanla ilgili bilgileri kapsar. |
timing.type |
string
Filigran resminin video oynatma sırasında ne zaman gösterileceğini belirleyen zamanlama yöntemi. Değer offsetFromStart ise offsetMs alanı, videonun başlangıcından itibaren geçen süreyi temsil eder. Değer offsetFromEnd ise offsetMs alanı, videonun sonundan itibaren bir uzaklığı temsil eder. |
timing.offsetMs |
unsigned long
Tanıtılan öğenin video oynatılırken ne zaman görüneceğini belirleyen ve milisaniye cinsinden belirtilen zaman farkı. type özelliğinin değeri, ofsetin videonun başından mı yoksa sonundan mı ölçüleceğini belirler. |
timing.durationMs |
unsigned long
Filigran resminin gösterilmesi gereken süre (milisaniye cinsinden). |
position |
object
position nesnesi, filigran resminin gösterileceği videodaki konumsal konum hakkında bilgileri kapsar. |
position.type |
string
Tanıtılan öğenin video oynatıcıda konumlandırılma şekli.
Bu özellik için geçerli değerler şunlardır: |
position.cornerPosition |
string
Tanıtılan öğenin görüneceği oynatıcının köşesi. Öğe her zaman oynatıcının sağ üst köşesinde görünür.
Bu özelliğin geçerli değerleri şunlardır: |
imageUrl |
string
Kanalın filigran resminin URL'si. YouTube bu URL'yi oluşturur ve watermark.set isteğine verilen API yanıtında döndürür. |
imageBytes |
bytes
Filigran resminin bayt cinsinden boyutu. |
targetChannelId |
string
Filigran resminin bağlandığı kanalın YouTube kanal kimliği. |
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: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-21 UTC."],[[["\u003cp\u003eA watermark resource displays an image during a channel's video playbacks, with the option to link to a target channel.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides \u003ccode\u003eset\u003c/code\u003e and \u003ccode\u003eunset\u003c/code\u003e methods to upload and delete watermark images respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etiming\u003c/code\u003e object controls when a watermark appears, using \u003ccode\u003etype\u003c/code\u003e to determine if it's measured from the start or end of a video and \u003ccode\u003eoffsetMs\u003c/code\u003e for the time offset, with \u003ccode\u003edurationMs\u003c/code\u003e defining its display length.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eposition\u003c/code\u003e object defines the watermark's location within the video, with \u003ccode\u003ecornerPosition\u003c/code\u003e specifically determining the corner.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etargetChannelId\u003c/code\u003e property is used to indicate the YouTube channel ID that the image links to when interacted with.\u003c/p\u003e\n"]]],["A watermark resource is an image displayed during a channel's video playbacks. Key actions include setting a watermark by uploading an image and specifying its `targetChannelId` for linking. The `timing` object defines when the image appears using `type`, `offsetMs`, and `durationMs`. The `position` object, set to 'corner', determines the spatial location, specifically `topRight`. Watermarks can be removed using the `unset` method. The API response provides an `imageUrl` and `imageBytes`.\n"],null,["# Watermarks\n\nA **watermark** resource identifies an image that displays during playbacks of a specified channel's videos. You can also specify a target channel to which the image will link as well as timing details that determine when the watermark appears during video playbacks and the length of time it is visible.\n\nMethods\n-------\n\nThe API supports the following methods for `watermarks` resources:\n\n[set](/youtube/v3/docs/watermarks/set)\n: Uploads a watermark image to YouTube and sets it for a channel.\n\n[unset](/youtube/v3/docs/watermarks/unset)\n: Deletes a channel's watermark image.\n [Try it now](/youtube/v3/docs/watermarks/unset#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `watermarks` resource: \n\n```carbon\n{\n \"#timing\": {\n \"#timing.type\": string,\n \"#timing.offsetMs\": unsigned long,\n \"#timing.durationMs\": unsigned long\n },\n \"#position\": {\n \"#position.type\": string,\n \"#position.cornerPosition\": string\n },\n \"#imageUrl\": string,\n \"#imageBytes\": bytes,\n \"#targetChannelId\": string\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `timing` | `object` The `timing` object encapsulates information about the time during a video playback when a channel's watermark image will display. |\n| timing.`type` | `string` The timing method that determines when the watermark image is displayed during the video playback. If the value is `offsetFromStart`, then the `offsetMs` field represents an offset from the start of the video. If the value is `offsetFromEnd`, then the `offsetMs` field represents an offset from the end of the video. |\n| timing.`offsetMs` | `unsigned long` The time offset, specified in milliseconds, that determines when the promoted item appears during video playbacks. The `type` property's value determines whether the offset is measured from the start or end of the video. |\n| timing.`durationMs` | `unsigned long` The length of time, in milliseconds, that the watermark image should display. |\n| `position` | `object` The `position` object encapsulates information about the spatial position within the video where the watermark image will display. |\n| position.`type` | `string` The manner in which the promoted item is positioned in the video player. Valid values for this property are: - corner |\n| position.`cornerPosition` | `string` The corner of the player where the promoted item will appear. The item always appears in the upper right corner of the player. Valid values for this property are: - `topRight` |\n| `imageUrl` | `string` The URL for the channel's watermark image. YouTube will generate this URL and return it in the API response to a `watermark.set` request. |\n| `imageBytes` | `bytes` The size of the watermark image, in bytes. |\n| `targetChannelId` | `string` The YouTube channel ID of the channel that the watermark image links to. |"]]
