Sponsors

Nota: Este recurso está obsoleto desde el 31 de marzo de 2020. Se reemplazó por el recurso member. Puedes encontrar información sobre ese recurso en la documentación de la API de datos de YouTube.

Como parte de esta baja, el método sponsors.list dejará de ser compatible a partir del 30 de septiembre de 2020. Los clientes de API deben actualizar las llamadas al método sponsors.list para usar el método members.list en su lugar.

Un recurso sponsor representa a un miembro del canal (anteriormente conocido como “patrocinador”) de un canal de YouTube. Un miembro proporciona asistencia monetaria recurrente a un creador y recibe beneficios especiales. Por ejemplo, los miembros pueden chatear cuando el creador activa el modo exclusivo para miembros.

Métodos

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

list
Enumera los patrocinadores 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 sponsors:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

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#sponsor.
etag etag
Es la Etag de este recurso.
id string
ID que asigna YouTube para identificar de forma exclusiva al patrocinador.
snippet object
El objeto snippet contiene detalles sobre el patrocinador.
snippet.channelId string
Este ID identifica el canal patrocinado.
snippet.sponsorDetails object
Este objeto contiene detalles sobre el patrocinador.
snippet.sponsorDetails.channelId string
ID del canal de YouTube.
snippet.sponsorDetails.channelUrl string
Es la URL del canal.
snippet.sponsorDetails.displayName string
Es el nombre visible del canal.
snippet.sponsorDetails.profileImageUrl string
La URL del avatar del canal.
snippet.sponsorSince datetime
La fecha y hora en que el usuario se convirtió en patrocinador. El valor se especifica en el formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).