Estamos atualizando a API Data para corresponder à forma como o YouTube conta as visualizações dos Shorts.
Saiba mais
Watermarks: set
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Carrega uma imagem de marca d'água para o YouTube e a define para um canal.
Este método oferece suporte ao envio de mídia. Os arquivos enviados devem estar de acordo com estas restrições:
- Tamanho máximo do arquivo: 10 MB
- Tipos de MIME de mídia aceitos:
image/jpeg, image/png, application/octet-stream
Impacto na cota:uma chamada para esse método tem um custo de cota de 50 unidades.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/upload/youtube/v3/watermarks/set
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos. Para saber mais sobre autenticação e autorização, consulte Como implementar a autorização do OAuth 2.0.
| Escopo |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parâmetros
A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.
| Parâmetros |
| Parâmetros obrigatórios |
channelId |
string
O parâmetro channelId especifica o ID do canal do YouTube para o qual a marca d'água está sendo fornecida. |
| Parâmetros opcionais |
onBehalfOfContentOwner |
string
Observação:esse parâmetro é destinado exclusivamente a parceiros de conteúdo do YouTube.
O parâmetro onBehalfOfContentOwner indica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. Este parâmetro destina-se a parceiros de conteúdo do YouTube que possuem e gerenciam vários canais do YouTube diferentes. Ele permite que os proprietários de conteúdo autentiquem uma vez e tenham acesso a todos os dados de seu canal e de seus vídeos sem ter que fornecer credenciais de autenticação para cada canal. A conta do CMS com a qual o usuário autentica deve estar vinculada ao proprietário do conteúdo do YouTube especificado. |
Corpo da solicitação
Forneça um recurso watermark no corpo da solicitação.
Resposta
Se for bem-sucedido, esse método vai retornar um código de status HTTP 204 No Content.
Erros
A tabela a seguir identifica as mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Para mais detalhes, consulte API Data do YouTube: erros.
| Tipo de erro |
Detalhe do erro |
Descrição |
badRequest (400) |
imageFormatUnsupported |
A imagem que você forneceu está em um formato não suportado. |
badRequest (400) |
imageTooTall |
A imagem que você forneceu é muito alta. |
badRequest (400) |
imageTooWide |
A imagem que você forneceu é muito grande. |
badRequest (400) |
mediaBodyRequired |
A solicitação não inclui o conteúdo da imagem. |
forbidden (403) |
forbidden |
A marca d'água não pode ser definida para o canal especificado. Talvez a solicitação não esteja autorizada corretamente ou o parâmetro channelId esteja definido como um valor inválido. |
Confira!
Use APIs Explorer para chamar essa API e conferir a solicitação e a resposta dela.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-23 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-11-23 UTC."],[[["\u003cp\u003eThis method enables uploading a watermark image to YouTube and applying it to a specific channel, supporting file sizes up to 10MB.\u003c/p\u003e\n"],["\u003cp\u003eAccepted image formats for the watermark include JPEG and PNG, and the method uses \u003ccode\u003eapplication/octet-stream\u003c/code\u003e as an accepted MIME type.\u003c/p\u003e\n"],["\u003cp\u003eSetting a watermark using this method consumes 50 quota units, and requires proper authorization using at least one of the specified scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003echannelId\u003c/code\u003e is a required parameter, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter meant only for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a \u003ccode\u003e204 No Content\u003c/code\u003e status, and common errors include unsupported image format, incorrect image dimensions, and missing image content.\u003c/p\u003e\n"]]],["The content describes uploading a watermark image to a YouTube channel using the `watermarks/set` method. This process involves a POST request to the API endpoint, requiring a `channelId` parameter and authorization with specific scopes. The image file must be under 10MB and of `image/jpeg`, `image/png`, or `application/octet-stream` MIME type. This operation costs 50 quota units. A successful request returns a `204` status; errors can include invalid format, size issues, or authorization problems.\n"],null,["# Watermarks: set\n\nUploads a watermark image to YouTube and sets it for a channel.\n\nThis method supports media upload. Uploaded files must conform to these constraints:\n\n- **Maximum file size:** 10MB\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/watermarks/set\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/youtubepartner` |\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| **Required parameters** |||\n| `channelId` | `string` The **channelId** parameter specifies the YouTube channel ID for which the watermark is being provided. |\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\nProvide a [watermark](/youtube/v3/docs/watermarks#resource) resource in the request body.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204 No Content` status code.\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)` | `imageFormatUnsupported` | The image you provided is in an unsupported format. |\n| `badRequest (400)` | `imageTooTall` | The image you provided is too tall. |\n| `badRequest (400)` | `imageTooWide` | The image you provided is too wide. |\n| `badRequest (400)` | `mediaBodyRequired` | The request does not include the image content. |\n| `forbidden (403)` | `forbidden` | The watermark can't be set 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."]]
