Activities: insert

YouTube a abandonné la fonctionnalité de bulletin de chaîne. Cette méthode n'est donc plus disponible.

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 telles que l'évaluation d'une vidéo par un utilisateur ou le fait de marquer une vidéo comme favorite, 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 marquer une vidéo comme favorite.

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

Requête

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

Champ d'application
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Paramètres

Le tableau suivant répertorie 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
part string
Le paramètre part a une double finalité dans cette opération. Il identifie les propriétés que l'opération d'écriture définira, ainsi que celles 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 :
  • contentDetails
  • id
  • snippet

Corps de la requête

Fournissez une ressource d'activité dans le corps de la requête. Pour cette ressource :

  • Vous devez spécifier une valeur pour les propriétés suivantes :

    • snippet.description

  • Vous pouvez définir des valeurs pour ces propriétés :

    • snippet.description
    • contentDetails.bulletin.resourceId

Réponse

En cas de succès, cette méthode renvoie une ressource d'activité dans le corps de la réponse.

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, veuillez consulter la documentation sur les messages d'erreur.

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 de 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. 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. Vérifiez la valeur de la propriété contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded La demande ne peut pas être traitée, car vous avez dépassé votre quota.