Subscriptions

Una risorsa subscription contiene informazioni su un'iscrizione di un utente di YouTube. Un'iscrizione notifica un utente quando vengono aggiunti nuovi video a un canale o quando un altro utente esegue una delle varie azioni su YouTube, ad esempio carica un video, vota un video o commenta un video.

Metodi

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

list
Restituisci le risorse di abbonamento che corrispondono ai criteri della richiesta API. Prova subito.
inserire
Aggiunge un'iscrizione 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à
kindstring
Identifica il tipo di risorsa API. Il valore sarà youtube#subscription.
etagetag
L'Etag di questa risorsa.
idstring
L'ID utilizzato da YouTube per identificare in modo univoco l'iscrizione.
snippetobject
L'oggetto snippet contiene i dettagli di base sull'iscrizione, inclusi il titolo e il canale a cui l'utente si è iscritto.
snippet.publishedAtdatetime
La data e l'ora di creazione dell'abbonamento. Il valore è specificato nel formato ISO 8601.
snippet.channelTitlestring
Il titolo del canale a cui appartiene l'iscrizione.
snippet.titlestring
Il titolo dell'abbonamento.
snippet.descriptionstring
Dettagli dell'abbonamento.
snippet.resourceIdobject
L'oggetto id contiene informazioni sul canale a cui l'utente si è iscritto.
snippet.resourceId.kindstring
Il tipo di risorsa API.
snippet.resourceId.channelIdstring
Il valore utilizzato da YouTube per identificare in modo univoco il canale a cui l'utente si è iscritto.
snippet.channelIdstring
L'ID utilizzato da YouTube per identificare in modo univoco il canale dell'iscritto. L'oggetto resource_id identifica il canale a cui l'utente si è iscritto.
snippet.thumbnailsobject
Una mappa delle immagini in miniatura associate all'iscrizione. Per ogni oggetto nella mappa, la chiave corrisponde al nome dell'immagine in miniatura, mentre il valore corrisponde a un oggetto contenente altre informazioni sulla miniatura.
snippet.thumbnails.(key)object
Le coppie chiave-valore valide sono:
  • default - L'immagine in miniatura predefinita per questa risorsa. La miniatura predefinita di un video, o una risorsa che fa riferimento a un video, come un elemento della playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è di 88 px di larghezza e 88 px di altezza.
  • medium - Una versione a risoluzione più alta dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 320 px e alta 180 px. Per un canale, questa immagine è larga 240 px e alta 240 px.
  • high - Una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 480 px e alta 360 px. Per un canale, questa immagine è larga 800 px e alta 800 px.
snippet.thumbnails.(key).urlstring
L'URL dell'immagine.
snippet.thumbnails.(key).widthunsigned integer
La larghezza dell'immagine.
snippet.thumbnails.(key).heightunsigned integer
L'altezza dell'immagine.
contentDetailsobject
L'oggetto contentDetails contiene statistiche di base sull'abbonamento.
contentDetails.totalItemCountunsigned integer
Il numero approssimativo di articoli a cui punta l'abbonamento.
contentDetails.newItemCountunsigned integer
Il numero di nuovi elementi nell'abbonamento dall'ultima lettura dei relativi contenuti.
contentDetails.activityTypestring
Il tipo di attività a cui fa riferimento questa iscrizione (solo i caricamenti e tutto).

I valori validi per questa proprietà sono:
  • all
  • uploads
subscriberSnippetobject
L'oggetto subscriberSnippet contiene i dettagli di base sull'abbonato.
subscriberSnippet.titlestring
Il titolo del canale dell'iscritto.
subscriberSnippet.descriptionstring
La descrizione del canale dell'iscritto.
subscriberSnippet.channelIdstring
L'ID assegnato da YouTube per identificare in modo univoco il canale dell'iscritto.
subscriberSnippet.thumbnailsobject
Immagini in miniatura del canale dell'iscritto.
subscriberSnippet.thumbnails.(key)object
Le coppie chiave-valore valide sono:
  • default - L'immagine in miniatura predefinita per questa risorsa. La miniatura predefinita di un video, o una risorsa che fa riferimento a un video, come un elemento della playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è di 88 px di larghezza e 88 px di altezza.
  • medium - Una versione a risoluzione più alta dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 320 px e alta 180 px. Per un canale, questa immagine è larga 240 px e alta 240 px.
  • high - Una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 480 px e alta 360 px. Per un canale, questa immagine è larga 800 px e alta 800 px.
subscriberSnippet.thumbnails.(key).urlstring
L'URL dell'immagine.
subscriberSnippet.thumbnails.(key).widthunsigned integer
La larghezza dell'immagine.
subscriberSnippet.thumbnails.(key).heightunsigned integer
L'altezza dell'immagine.