FanFundingEvents

Nota: Este es un anuncio de baja.

La función Financiación de fans dejó de estar disponible y la API de Financiación de fans dejará de estar disponible el 28 de febrero de 2017. Este anuncio de baja coincide con el lanzamiento de la nueva función de YouTube, Super Chat.

Un recurso fanFundingEvent representa un evento de financiación de fans en un canal de YouTube. La financiación de fans es una manera monetaria de apoyar a los creadores de YouTube. Los eventos de financiación de fans ocurren cuando un usuario realiza un pago único y voluntario a un canal. Consulta el Centro de ayuda de YouTube para obtener más información sobre la financiación de fans.

Métodos

La API admite los siguientes métodos para los recursos de fanFundingEvents:

list

Enumera los eventos de financiación de fans de un canal. El propietario del canal debe autorizar la solicitud a la API. Pruébala ahora.

Representación de recursos

La siguiente estructura JSON muestra el formato de un recurso 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
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind	string Identifica el tipo de recurso de API. El valor será youtube#fanFundingEvent.
etag	etag Es la Etag de este recurso.
id	string ID que asigna YouTube para identificar de forma exclusiva el evento de financiación de fans.
snippet	object El objeto snippet contiene información sobre el evento de financiación de fans.
snippet.channelId	string ID del canal que recibió la financiación
snippet.supporterDetails	object Detalles sobre el canal del colaborador. Este objeto solo está presente si el defensor hizo público el evento de financiación.
snippet.supporterDetails.channelId	string El ID del canal de YouTube del colaborador.
snippet.supporterDetails.channelUrl	string Es la URL del canal del colaborador.
snippet.supporterDetails.displayName	string Es el nombre visible del canal del colaborador.
snippet.supporterDetails.profileImageUrl	string Es la URL del avatar del canal del colaborador.
snippet.commentText	string El contenido textual del comentario del colaborador.
snippet.createdAt	datetime Fecha y hora en que se produjo la financiación. El valor se especifica en el formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros	unsigned long La cantidad de dinero que se contribuyó en el evento de financiación. El valor se expresa en micros de la moneda de financiación. Por ejemplo, si la persona que donó dinero contribuyó a un dólar (USD 1), el valor de la propiedad snippet.amountMicros es 1000000.
snippet.currency	string Es la moneda asociada con el importe de financiación. El valor debe ser un código de moneda ISO 4217.
snippet.displayString	string Es una string diseñada para mostrarse que muestra el importe del fondo y la moneda. Si la solicitud fanFundingEvents.list especificó un idioma de aplicación con el parámetro hl, la string de visualización se localiza para mostrarla en ese idioma. Por ejemplo, en inglés, la moneda se mostraría como $1.50, pero en francés se mostraría como 1,50$.