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$ . |