Playlists: update

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.