Actualizaremos la API de datos para que coincida con la forma en que YouTube cuenta las vistas de Shorts.
Más información
Watermarks
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Un recurso watermark identifica una imagen que se muestra durante la reproducción de los videos de un canal especificado. También puedes especificar un canal de destino al que vinculará la imagen, así como información de sincronización que determina cuándo aparece la marca de agua en las reproducciones de video y el período de tiempo que será visible.
Métodos
La API admite los siguientes métodos para los recursos watermarks:
- set
- Sube una imagen de marca de agua a YouTube y la configura para un canal.
- unset
- Borra la imagen de marca de agua de un canal.
Pruébala ahora.
Propiedades
La siguiente tabla define las propiedades que aparecen en este recurso:
| Propiedades |
timing |
object
El objeto timing encapsula información sobre el momento durante la reproducción de un video en el que se mostrará la imagen de marca de agua de un canal. |
timing.type |
string
Es el método de sincronización que determina cuándo se muestra la imagen de marca de agua durante la reproducción del video. Si el valor es offsetFromStart, el campo offsetMs representa una compensación desde el inicio del video. Si el valor es offsetFromEnd, el campo offsetMs representa un desplazamiento desde el final del video. |
timing.offsetMs |
unsigned long
Es la compensación de tiempo, especificada en milisegundos, que determina cuándo aparece el elemento promocionado durante la reproducción de videos. El valor de la propiedad type determina si la compensación se mide desde el inicio o el final del video. |
timing.durationMs |
unsigned long
Es la cantidad de tiempo, en milisegundos, durante la que se debe mostrar la imagen de marca de agua. |
position |
object
El objeto position encapsula información sobre la posición espacial dentro del video en la que se mostrará la imagen de marca de agua. |
position.type |
string
Es la forma en que se posiciona el elemento promocionado en el reproductor de video.
Los valores válidos para esta propiedad son los siguientes: |
position.cornerPosition |
string
Es la esquina del reproductor en la que aparecerá el elemento promocionado. El elemento siempre aparece en la esquina superior derecha del reproductor.
Los valores válidos para esta propiedad son los siguientes: |
imageUrl |
string
Es la URL de la imagen de marca de agua del canal. YouTube generará esta URL y la devolverá en la respuesta de la API a una solicitud watermark.set. |
imageBytes |
bytes
Tamaño de la imagen de marca de agua, en bytes. |
targetChannelId |
string
Es el ID del canal de YouTube al que se vincula la imagen de la marca de agua. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC)
[null,null,["Última actualización: 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. |"]]
