Aktualizujemy interfejs Data API, aby był zgodny ze sposobem zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
Watermarks
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
watermark zasób identyfikuje obraz wyświetlany podczas odtwarzania filmów z określonego kanału. Możesz też określić kanał docelowy, do którego będzie prowadzić link z obrazu, oraz szczegóły dotyczące czasu, które określają, kiedy znak wodny ma się pojawiać podczas odtwarzania filmów i jak długo ma być widoczny.
Metody
Interfejs API obsługuje te metody w przypadku zasobów watermarks:
- set
- Przesyła obraz znaku wodnego do YouTube i ustawia go na kanale.
- unset
- Usuwa obraz znaku wodnego kanału.
Wypróbuj teraz
Właściwości
Poniższa tabela zawiera definicje właściwości, które pojawiają się w tym zasobie:
| Właściwości |
timing |
object
Obiekt timing zawiera informacje o czasie odtwarzania filmu, w którym będzie wyświetlany obraz znaku wodnego kanału. |
timing.type |
string
Metoda określania czasu, która decyduje o tym, kiedy obraz znaku wodnego jest wyświetlany podczas odtwarzania filmu. Jeśli wartość to offsetFromStart, pole offsetMs reprezentuje przesunięcie od początku filmu. Jeśli wartość to offsetFromEnd, pole offsetMs reprezentuje przesunięcie od końca filmu. |
timing.offsetMs |
unsigned long
Przesunięcie czasowe w milisekundach, które określa, kiedy promowany produkt pojawia się podczas odtwarzania filmu. Wartość właściwości type określa, czy przesunięcie jest mierzone od początku czy od końca filmu. |
timing.durationMs |
unsigned long
Czas wyświetlania obrazu znaku wodnego (w milisekundach). |
position |
object
Obiekt position zawiera informacje o położeniu w filmie, w którym będzie wyświetlany obraz znaku wodnego. |
position.type |
string
Sposób pozycjonowania promowanego produktu w odtwarzaczu wideo.
Prawidłowe wartości tej właściwości to: |
position.cornerPosition |
string
Róg odtwarzacza, w którym będzie się wyświetlać promowany element. Element zawsze pojawia się w prawym górnym rogu odtwarzacza.
Prawidłowe wartości tej właściwości to: |
imageUrl |
string
Adres URL obrazu znaku wodnego kanału. YouTube wygeneruje ten adres URL i zwróci go w odpowiedzi interfejsu API na żądanie watermark.set. |
imageBytes |
bytes
Rozmiar obrazu znaku wodnego w bajtach. |
targetChannelId |
string
Identyfikator kanału w YouTube, do którego prowadzi link z obrazu znaku wodnego. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
