Exclui um item da playlist.
Impacto na cota: uma chamada para esse método tem um custo de cota de 50 unidades.
Casos de uso comuns
Solicitação
Solicitação HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
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 | ||
id |
string O parâmetro id especifica o ID do item da playlist do YouTube que está sendo excluído. Em um recurso playlistItem , a propriedade id especifica o ID do item da playlist. |
|
Parâmetros opcionais | ||
onBehalfOfContentOwner |
string 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.Esse parâmetro foi criado para parceiros de conteúdo do YouTube que têm e gerenciam muitos canais diferentes. Ele permite que os usuários afiliados ao proprietário do conteúdo façam a autenticação uma vez e acessem e gerenciem todos os dados de vídeo e canal do proprietário, sem precisar fornecer credenciais de autenticação para cada canal. Quando o parâmetro está presente, o valor dele identifica um proprietário do conteúdo, e as credenciais de autorização identificam um usuário do YouTube que está autorizado a agir em nome do proprietário do 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 Studio. |
Corpo da solicitação
Não forneça um corpo de solicitação ao chamar este método.
Resposta
Se for bem-sucedido, este método retornará um código de resposta HTTP 204
(No Content
).
Erros
A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
A solicitação não está devidamente autorizada a excluir o item da playlist especificado. |
notFound (404) |
playlistItemNotFound |
O item da playlist indicado com o parâmetro id da solicitação não pode ser encontrado. |
invalidValue (400) |
playlistOperationUnsupported |
A API não é compatível com a capacidade de excluir vídeos da playlist especificada. Por exemplo, não é possível excluir um vídeo da playlist de vídeos enviados. |
Confira!
Use o APIs Explorer para chamar a API e ver a solicitação e a resposta da API.