Pour en savoir plus, consultez le Centre d'aide YouTube.
publie un bulletin pour une chaîne spécifique ; (L'utilisateur qui envoie la demande doit être autorisé à agir au nom de la chaîne.)
Remarque:Même si une ressource activity
peut contenir des informations sur des actions comme un avis sur une vidéo ou l'ajout d'une vidéo aux favoris, vous devez utiliser d'autres méthodes d'API pour générer ces ressources activity
. Par exemple, vous pouvez utiliser la méthode videos.rate()
de l'API pour évaluer une vidéo, et la méthode playlistItems.insert()
pour l'ajouter à vos favoris.
Impact du quota:un appel à cette méthode a un coût de quota de 50 unités.
Demande
Requête HTTP :
POST https://www.googleapis.com/youtube/v3/activities
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
Portée |
---|
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 listés sont des paramètres de requête.
Paramètres | ||
---|---|---|
Réglages obligatoires | ||
part |
string Le paramètre part a une double finalité. Elle identifie les propriétés que l'opération d'écriture définira, ainsi que les propriétés que la réponse de l'API inclura.La liste suivante contient les noms part que vous pouvez inclure dans la valeur du paramètre:
|
Corps de la requête
Indiquez une ressource d'activité dans le corps de la requête. Pour cette ressource:
-
Vous devez spécifier une valeur pour ces propriétés:
snippet.description
-
Vous pouvez définir des valeurs pour les propriétés suivantes:
snippet.description
contentDetails.bulletin.resourceId
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource d'activité dans le corps de la réponse.
Erreurs
Le tableau suivant identifie les messages d'erreur que l'API pourrait renvoyer en réponse à un appel à cette méthode. Veuillez consulter la documentation sur les messages d'erreur pour en savoir plus.
Type d'erreur | Détails de l'erreur | Description |
---|---|---|
badRequest (400) |
bulletinTextRequired |
La requête doit utiliser la propriété description de l'objet snippet pour fournir le texte du post du bulletin. |
badRequest (400) |
invalidMetadata |
La propriété kind ne correspond pas au type d'ID fourni. |
forbidden (403) |
forbidden |
La requête n'est pas correctement autorisée. |
notFound (404) |
playlistNotFound |
YouTube ne trouve pas la vidéo que vous essayez d'associer au post du bulletin. Vérifiez la valeur de la propriété contentDetails.bulletinPosted.playlistId . |
notFound (404) |
videoNotFound |
YouTube ne trouve pas la vidéo que vous essayez d'associer au post du bulletin. Vérifiez la valeur de la propriété contentDetails.bulletinPosted.videoId . |
userRateLimitExceeded (403) |
rateLimitExceeded |
La requête ne peut pas être traitée, car vous avez dépassé votre quota. |