PlaylistImages: update
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Modifica a imagem de uma lista de reprodução.
Impacto na cota:uma chamada para esse método tem um custo de cota de 50 unidades.
Solicitação
Solicitação HTTP
PUT https://www.googleapis.com/youtube/v3/playlistImages
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).
| Escopo |
|---|
https://www.googleapis.com/auth/youtubepartner |
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 |
part |
string
O parâmetro part especifica um
lista separada por vírgulas de um ou mais recursos playlistImage
que a resposta da API vai incluir.
Se o parâmetro
identifica uma propriedade que contém propriedades filhas, as propriedades filhas
serão incluídas na resposta.
|
| Parâmetros opcionais |
onBehalfOfContentOwner |
string e
Observação:o parâmetro onBehalfOfContentOwner é destinado exclusivamente a parceiros de conteúdo do YouTube e só pode ser usado em uma solicitação autorizada corretamente.
Esse parâmetro foi criado para parceiros de conteúdo do YouTube que têm e gerenciam vários canais do YouTube diferentes. Ele permite que usuários afiliados ao proprietário do conteúdo se autentiquem uma vez e acessem e gerenciem todos os dados de vídeo e canal do proprietário do conteúdo sem precisar fornecer credenciais de autenticação para cada canal.
Quando o parâmetro está presente, seu valor identifica um proprietário de conteúdo e as credenciais de autorização da solicitação identificam um usuário do YouTube que está autorizado a agir em nome desse proprietário de conteúdo. A conta de autenticação do usuário precisa estar vinculada ao proprietário do conteúdo especificado nas configurações do YouTube Creator Studio. |
Corpo da solicitação
Forneça um recurso playlistImages no corpo da solicitação.
Para esse recurso:
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-08-16 UTC.
[null,null,["Última atualização 2024-08-16 UTC."],[[["\u003cp\u003eThis method allows modification of a playlist image via the YouTube API.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this method incurs a quota cost of 50 units per call.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required, with scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e being necessary.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter is required, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter intended for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eplaylistImages\u003c/code\u003e resource with specified values for \u003ccode\u003esnippet.playlistId\u003c/code\u003e and \u003ccode\u003esnippet.type\u003c/code\u003e, and can optionally include \u003ccode\u003esnippet.width\u003c/code\u003e and \u003ccode\u003esnippet.height\u003c/code\u003e.\u003c/p\u003e\n"]]],["This outlines how to modify a playlist image via the YouTube API. A `PUT` request is sent to `playlistImages`, costing 50 quota units. Authorization is required, utilizing scopes like `youtubepartner`. The request needs the `part` parameter and can optionally include `onBehalfOfContentOwner`. The request body requires `snippet.playlistId` and `snippet.type` properties and can optionally have `snippet.width` and `snippet.height` set. A successful request returns a `playlistItem` resource.\n"],null,["# PlaylistImages: update\n\nModifies a playlist 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```\nPUT https://www.googleapis.com/youtube/v3/playlistImages\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| `part` | `string` The **part** parameter specifies a comma-separated list of one or more `playlistImage` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\n\n### Request body\n\nProvide a [playlistImages resource](/youtube/v3/docs/playlistImages#resource) in the request body.\n\nFor that resource:\n\n- You must specify a value for these properties:\n\n - `snippet.playlistId`\n - `snippet.type`\n- You can set values for these properties:\n\n - `snippet.width`\n - `snippet.height`\n\nResponse\n--------\n\nIf successful, this method returns a [playlistItem resource](/youtube/v3/docs/playlistImages#resource) in the response body."]]
