Supprime un élément de la playlist.
Impact sur les quotas:un appel à cette méthode entraîne un coût du quota de 50 unités.
Cas d'utilisation courants
Requête
Requête HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
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 répertorie les paramètres compatibles avec cette requête. Tous les paramètres répertoriés sont des paramètres de requête.
Paramètres | ||
---|---|---|
Paramètres obligatoires | ||
id |
string Le paramètre id spécifie l'ID d'élément de playlist YouTube correspondant à 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 contenu YouTube et ne peut être utilisé que dans une demande autorisée de façon appropriée.Il est conçu pour les partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube. Il permet aux utilisateurs affiliés au propriétaire de contenu de s'authentifier une seule fois, puis d'accéder à toutes les données vidéo et de chaîne du propriétaire 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 demande 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
Lorsque cette méthode fonctionne, elle renvoie un code de réponse 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 la documentation sur les messages d'erreur.
Type d'erreur | Détails de l'erreur | Description |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
La demande n'est pas autorisée pour supprimer l'élément de playlist spécifié. |
notFound (404) |
playlistItemNotFound |
Impossible de trouver l'élément de playlist identifié à l'aide du paramètre id de la requête. |
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 APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.