PlaylistItems: insert

Adiciona um recurso a uma playlist. Faça um teste agora.

Solicitação

Solicitação HTTP

POST 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.

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:

    • snippet.playlistId
    • snippet.resourceId

  • Você pode definir valores para estas propriedades:

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

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
duplicate videoAlreadyInPlaylist O vídeo que você está tentando adicionar à playlist já foi adicionado.
forbidden playlistContainsMaximumNumberOfVideos A playlist já contém o número máximo permitido de itens.
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 - por exemplo, youtube#video.
notFound playlistNotFound A playlist identificada com o parâmetro playlistId da solicitação não pode ser encontrada.
notFound videoNotFound O vídeo que você está tentando adicionar à playlist não pode ser encontrado. Verifique o valor da propriedade videoId para garantir que ele esteja correto.
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 resourceIdRequired A solicitação deve conter um recurso em que o objeto snippet especifica um resourceId.

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.