PlaylistItems: delete

Supprime un élément de playlist.

Impact sur les quotas:un appel à cette méthode a un coût de quota de 50 unités.

Cas d'utilisation courants

Requête

Requête HTTP

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

Autorisation

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants. Pour en savoir plus sur l'authentification et l'autorisation, consultez Implémenter l'autorisation OAuth 2.0.

Portée
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Paramètres

Le tableau suivant présente les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
id string
Le paramètre id spécifie l'ID de l'élément de playlist YouTube pour l'élément de playlist en cours de suppression. Dans une ressource playlistItem, la propriété id spécifie l'ID de l'élément de la playlist.
Paramètres facultatifs
onBehalfOfContentOwner string
Remarque:Le paramètre onBehalfOfContentOwner est destiné exclusivement aux partenaires de contenus YouTube et ne peut être utilisé que dans une requête autorisée.

Ce paramètre est conçu pour les partenaires de contenus YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux utilisateurs affiliés au propriétaire du contenu de s'authentifier une seule fois, puis d'accéder à toutes les données de ses vidéos et de ses chaînes, et de les gérer, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.

Lorsque le paramètre est présent, sa valeur identifie un propriétaire de contenu, et les identifiants d'autorisation de la requête identifient un utilisateur YouTube autorisé à agir au nom de ce propriétaire. Le compte avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu spécifié dans les paramètres de YouTube Studio.

Corps de la requête

Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.

Réponse

Si la méthode aboutit, elle renvoie un code d'état HTTP 204 No Content.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel de cette méthode. Pour en savoir plus, consultez API YouTube Data - Erreurs.

Type d'erreur Détail de l'erreur Description
forbidden (403) playlistItemsNotAccessible La demande n'est pas correctement autorisée à supprimer l'élément de playlist spécifié.
notFound (404) playlistItemNotFound L'élément de playlist identifié par le paramètre id de la requête est introuvable.
invalidValue (400) playlistOperationUnsupported L'API ne permet pas de supprimer des vidéos de la playlist spécifiée. Par exemple, vous ne pouvez pas supprimer une vidéo de la playlist de vidéos que vous avez mises en ligne.

Essayer

Utilisez APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.