Sponsors

Nota: questa risorsa è deprecata dal 31 marzo 2020. È stato sostituito dalla risorsa member. Puoi trovare informazioni sulla risorsa nella documentazione dell'API YouTube Data.

Nell'ambito di questo ritiro, il metodo sponsors.list non sarà più supportato a partire dal 30 settembre 2020. I client API devono aggiornare le chiamate al metodo sponsors.list per utilizzare il metodo members.list.

Una risorsa sponsor rappresenta un abbonato al canale (in precedenza noto come "sponsor") di un canale YouTube. Un membro fornisce un supporto monetario ricorrente a un creator e riceve vantaggi speciali. Ad esempio, gli abbonati possono chattare quando il creator attiva la modalità riservata agli abbonati per una chat.

Metodi

L'API supporta i seguenti metodi per le risorse di sponsors:

list
Elenca gli sponsor di un canale. La richiesta API deve essere autorizzata dal proprietario del canale. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa sponsors:

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

Proprietà

La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#sponsor.
etag etag
L'Etag di questa risorsa.
id string
L'ID assegnato da YouTube per identificare in modo univoco lo sponsor.
snippet object
L'oggetto snippet contiene dettagli sullo sponsor.
snippet.channelId string
Questo ID identifica il canale sponsorizzato.
snippet.sponsorDetails object
Questo oggetto contiene dettagli sullo sponsor.
snippet.sponsorDetails.channelId string
L'ID del canale YouTube.
snippet.sponsorDetails.channelUrl string
L'URL del canale.
snippet.sponsorDetails.displayName string
Il nome visualizzato del canale.
snippet.sponsorDetails.profileImageUrl string
L'URL dell'avatar del canale.
snippet.sponsorSince datetime
La data e l'ora in cui l'utente è diventato sponsor. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).