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