PlaylistItems: delete

Supprime un élément de playlist.

Impact sur le quota : 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.

Champ d'application
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 acceptés par 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 à supprimer. Dans une ressource playlistItem, la propriété id spécifie l'ID de l'élément de playlist.
Paramètres facultatifs
onBehalfOfContentOwner string
Remarque: Le paramètre onBehalfOfContentOwner est exclusivement destiné aux partenaires de contenu YouTube et ne peut être utilisé que dans une requête correctement autorisée.

Ce paramètre est conçu pour les partenaires de contenu 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 la vidéo et de la chaîne du propriétaire du contenu 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 de contenu. Le compte avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu spécifié dans les paramètres de YouTube Creator Studio.

Corps de la requête

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

Réponse

Si l'opération aboutit, cette méthode 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 à cette méthode. Pour en savoir plus, consultez Erreurs de l'API YouTube Data.

Type d'erreur Détail de l'erreur Description
forbidden (403) playlistItemsNotAccessible La requête n'est pas correctement autorisée à supprimer l'élément de playlist spécifié.
notFound (404) playlistItemNotFound L'élément de playlist identifié avec 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 votre playlist de vidéos mises en ligne.

Essayer

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