Modifica uma playlist. Por exemplo, você pode alterar o título, a descrição ou o status de privacidade de uma playlist. Faça um teste agora.
Solicitação
Solicitação HTTP
PUT https://www.googleapis.com/youtube/v3/playlists
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos (saiba mais sobre autenticação e autorização).
Escopo |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
Parâmetros
A tabela a seguir lista os parâmetros que esta consulta suporta. Todos os parâmetros listados são os parâmetros de consulta.
Parâmetros | ||
---|---|---|
Parâmetros obrigatórios | ||
part |
string O parâmetro part tem duas finalidades nesta operação: identifica as propriedades que serão definidas pela operação de gravação e as propriedades que serão incluídas pela resposta da API.Os nomes part que podem ser incluídos no valor do parâmetro são snippet e status .Este método substituirá os valores existentes de todas as propriedades mutáveis contidas em todas as peças especificadas pelo valor do parâmetro. Por exemplo, a configuração de privacidade de uma playlist está contida na parte status . Como tal, se sua solicitação estiver atualizando uma playlist privada, e o valor do parâmetro part da solicitação incluir a part e status , a configuração de privacidade da playlist será atualizada para qualquer valor especificado pelo corpo da solicitação. Se o corpo da solicitação não especificar um valor, a configuração de privacidade existente será removida e a playlist será revertida para a configuração de privacidade padrão. |
Corpo de solicitação
Forneça um recurso de playlist no corpo da solicitação. Para esse recurso:
-
É necessário especificar um valor para essas propriedades:
id
snippet.title
-
Você pode definir valores para estas propriedades:
snippet.title
snippet.description
status.privacyStatus
snippet.tags[]
Se você estiver enviando uma solicitação de atualização e ela não especificar um valor para uma propriedade que já tenha um, o valor existente da propriedade será excluído.
Resposta
Se for bem-sucedido, este método retorna um recurso de playlist no corpo da resposta.
Erros
A tabela abaixo identifica as mensagens de erro que a API pode retornar em resposta a uma chamada para este método. Consulte a documentação mensagem de erro para mais detalhes.
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
invalidValue |
invalidPlaylistSnippet |
A solicitação fornece um snippet de playlist inválido. |
notFound |
playlistNotFound |
A playlist indicada com o parâmetro id da solicitação não pode ser encontrada. |
required |
playlistTitleRequired |
A solicitação deve especificar um título da playlist. |
Conheça agora.
Use o Explorador de API para chamar este método em dados ativos e ver a solicitação e a resposta da API.