Subscriptions

Una risorsa subscription contiene informazioni sull'abbonamento di un utente di YouTube. Un'iscrizione avvisa un utente quando vengono aggiunti nuovi video a un canale o quando un altro utente esegue una delle diverse azioni su YouTube, ad esempio caricare un video, valutare un video o commentare un video.

Metodi

L'API supporta i seguenti metodi per le risorse subscriptions:

list
Restituisce le risorse di abbonamento che corrispondono ai criteri della richiesta API. Prova subito.
insert
Aggiunge un abbonamento al canale dell'utente autenticato. Prova subito.
elimina
Elimina un abbonamento. Prova subito.

Rappresentazione delle risorse

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

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

Proprietà

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

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#subscription.
etag etag
L'ETag di questa risorsa.
id string
L'ID utilizzato da YouTube per identificare in modo univoco l'abbonamento.
snippet object
L'oggetto snippet contiene i dettagli di base dell'abbonamento, tra cui il titolo e il canale a cui l'utente si è abbonato.
snippet.publishedAt datetime
La data e l'ora in cui è stato creato l'abbonamento. Il valore è specificato nel formato ISO 8601.
snippet.title string
Il titolo dell'abbonamento.
snippet.description string
I dettagli dell'abbonamento.
snippet.resourceId object
L'oggetto id contiene informazioni sul canale a cui l'utente si è iscritto.
snippet.resourceId.kind string
Il tipo di risorsa API.
snippet.resourceId.channelId string
Il valore che YouTube utilizza per identificare in modo univoco il canale a cui l'utente si è iscritto.
snippet.channelId string
L'ID utilizzato da YouTube per identificare in modo univoco il canale dell'abbonato. L'oggetto resource_id identifica il canale a cui l'utente si è iscritto.
snippet.thumbnails object
Una mappa di immagini in miniatura associate all'abbonamento. Per ogni oggetto nella mappa, la chiave è il nome dell'immagine in miniatura e il valore è un oggetto che contiene altre informazioni sulla miniatura.
snippet.thumbnails.(key) object
I valori chiave validi sono:
  • default: l'immagine in miniatura predefinita per questa risorsa. La miniatura predefinita per un video o una risorsa che fa riferimento a un video, ad esempio un elemento di una playlist o un risultato di ricerca, ha una larghezza di 120 px e un'altezza di 90 px. La miniatura predefinita per un canale è larga 88 px e alta 88 px.
  • medium: una versione a risoluzione più elevata dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine misura 240 px di larghezza e 240 px di altezza.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine ha una larghezza di 800 px e un'altezza di 800 px.
snippet.thumbnails.(key).url string
L'URL dell'immagine.
snippet.thumbnails.(key).width unsigned integer
La larghezza dell'immagine.
snippet.thumbnails.(key).height unsigned integer
L'altezza dell'immagine.
contentDetails object
L'oggetto contentDetails contiene statistiche di base sull'abbonamento.
contentDetails.totalItemCount unsigned integer
Il numero approssimativo di elementi a cui fa riferimento l'abbonamento.
contentDetails.newItemCount unsigned integer
Il numero di nuovi elementi nell'abbonamento dall'ultima lettura dei contenuti.
contentDetails.activityType string
Il tipo di attività a cui si riferisce questo abbonamento (solo caricamenti, tutto).

I valori validi per questa proprietà sono:
  • all
  • uploads
subscriberSnippet object
L'oggetto subscriberSnippet contiene i dettagli di base sull'abbonato.
subscriberSnippet.title string
Il titolo del canale dell'abbonato.
subscriberSnippet.description string
La descrizione del canale dell'iscritto.
subscriberSnippet.channelId string
L'ID che YouTube assegna per identificare in modo univoco il canale dell'iscritto.
subscriberSnippet.thumbnails object
Immagini in miniatura del canale dell'iscritto.
subscriberSnippet.thumbnails.(key) object
I valori chiave validi sono:
  • default: l'immagine in miniatura predefinita per questa risorsa. La miniatura predefinita per un video o una risorsa che fa riferimento a un video, ad esempio un elemento di una playlist o un risultato di ricerca, ha una larghezza di 120 px e un'altezza di 90 px. La miniatura predefinita per un canale è larga 88 px e alta 88 px.
  • medium: una versione a risoluzione più elevata dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine misura 240 px di larghezza e 240 px di altezza.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine ha una larghezza di 800 px e un'altezza di 800 px.
subscriberSnippet.thumbnails.(key).url string
L'URL dell'immagine.
subscriberSnippet.thumbnails.(key).width unsigned integer
La larghezza dell'immagine.
subscriberSnippet.thumbnails.(key).height unsigned integer
L'altezza dell'immagine.