PlaylistItems: update

Modifica um item da playlist. Por exemplo, você poderia atualizar a posição do item na playlist. Faça um teste agora.

Solicitação

Solicitação HTTP

PUT https://www.googleapis.com/youtube/v3/playlistItems

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, contentDetails 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, um item de playlist pode especificar uma tempo de início e de término que identificam a parte do vídeo que será reproduzida quando os usuários assistirem a ele na playlist. Se sua solicitação atualizar um item da playlist que define esses valores, e o valor do parâmetro part da solicitação incluir a parte contentDetails, os tempos de início e de término do item da playlist serão atualizados para qualquer valor especificado pelo corpo da solicitação. Se o corpo da solicitação não especificar valores, os tempos de início e de término existentes serão removidos e substituídos pelas configurações padrão.

Corpo de solicitação

Forneça um recurso playlistItem no corpo da solicitação. Para esse recurso:

  • É necessário especificar um valor para essas propriedades:

    • id
    • snippet.playlistId
    • snippet.resourceId

  • Você pode definir valores para estas propriedades:

    • snippet.position
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

    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 playlistItem 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 invalidPlaylistItemPosition A solicitação tenta definir a posição do item da playlist com um valor inválido ou não suportado. Verifique o valor da propriedade position no snippet do recurso.
invalidValue invalidResourceType O type especificado para o ID do recurso não é suportado para esta operação. O ID do recurso identifica o item que está sendo adicionado à playlist (youtube#video, por exemplo).
invalidValue invalidSnippet A solicitação não especifica uma propriedade snippet válida.
notFound playlistItemNotFound O item da playlist indicado com a propriedade id da solicitação não pode ser encontrado.
notFound playlistNotFound A playlist identificada com o parâmetro playlistId da solicitação não pode ser encontrada.
required channelIdRequired A solicitação não especifica um valor para a propriedade channelId necessária.
required playlistIdRequired A solicitação não especifica um valor para a propriedade playlistId necessária.
required playlistItemIdRequired O recurso do item da playlist especificado na solicitação deve usar a propriedade id para indicar o item da playlist que está sendo atualizado.

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.