FanFundingEvents

Remarque:Ceci est une annonce d'abandon.

La fonctionnalité de financement par les fans a été abandonnée et l'API de financement par les fans sera désactivée le 28 février 2017. Cette annonce coïncide avec le lancement de la nouvelle fonctionnalité Super Chat de YouTube.

Une ressource fanFundingEvent représente un événement de financement par les fans sur une chaîne YouTube. Le financement par les fans permet de soutenir financièrement les créateurs YouTube. Un événement de financement par les fans est effectué lorsqu'un utilisateur effectue un paiement volontaire unique à une chaîne. Consultez le Centre d'aide YouTube pour en savoir plus sur le financement par les fans.

Méthodes

L'API accepte les méthodes suivantes pour les ressources fanFundingEvents:

list
Répertorie les événements de financement par les fans d'une chaîne. La demande d'API doit être autorisée par le propriétaire de la chaîne. Essayer

Représentation des ressources

La structure JSON suivante montre le format d'une ressource fanFundingEvents:

{
  "kind": "youtube#fanFundingEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind string
Identifie le type de ressource de l'API. La valeur sera youtube#fanFundingEvent.
etag etag
ETag de cette ressource.
id string
Identifiant attribué par YouTube afin d'identifier de manière unique l'événement de financement par les fans.
snippet object
L'objet snippet contient des informations sur l'événement de financement par les fans.
snippet.channelId string
ID de la chaîne ayant reçu le financement.
snippet.supporterDetails object
Informations sur la chaîne du sponsor. Cet objet n'est présent que si le support a rendu l'événement de financement public.
snippet.supporterDetails.channelId string
L'ID de la chaîne du sponsor.
snippet.supporterDetails.channelUrl string
URL de la chaîne du sponsor.
snippet.supporterDetails.displayName string
Nom à afficher de la chaîne du sponsor.
snippet.supporterDetails.profileImageUrl string
URL de l'avatar de la chaîne du sponsor.
snippet.commentText string
Contenu textuel du commentaire du sympathisant.
snippet.createdAt datetime
Date et heure du financement La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros unsigned long
La somme d'argent a contribué à l'événement de financement. La valeur est en micro-unités de la devise de financement. Par exemple, si le donateur a contribué à un dollar (1 $), la valeur de la propriété snippet.amountMicros est 1000000.
snippet.currency string
Devise associée au montant du financement. La valeur est un code de devise ISO 4217.
snippet.displayString string
Chaîne à afficher, indiquant le montant et la devise du fonds. Si la requête fanFundingEvents.list spécifie une langue d'application avec le paramètre hl, la chaîne d'affichage est localisée pour l'affichage dans cette langue. Par exemple, en anglais, la devise sera affichée sous la forme $1.50, alors qu'en français, elle sera affichée en tant que 1,50$.