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à | |
---|---|
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'iscrizione. |
snippet |
object L'oggetto snippet contiene i dettagli di base sull'iscrizione, inclusi il titolo e il canale a cui l'utente si è iscritto. |
snippet.publishedAt |
datetime La data e l'ora di creazione dell'abbonamento. Il valore è specificato nel formato ISO 8601. |
snippet.channelTitle |
string Il titolo del canale a cui appartiene l'iscrizione. |
snippet.title |
string Il titolo dell'abbonamento. |
snippet.description |
string 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 utilizzato da YouTube 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'iscritto. L'oggetto resource_id identifica il canale a cui l'utente si è iscritto. |
snippet.thumbnails |
object 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:
|
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 articoli a cui punta l'abbonamento. |
contentDetails.newItemCount |
unsigned integer Il numero di nuovi elementi nell'abbonamento dall'ultima lettura dei relativi contenuti. |
contentDetails.activityType |
string Il tipo di attività a cui fa riferimento questa iscrizione (solo i caricamenti e tutto). I valori validi per questa proprietà sono:
|
subscriberSnippet |
object L'oggetto subscriberSnippet contiene i dettagli di base sull'abbonato. |
subscriberSnippet.title |
string Il titolo del canale dell'iscritto. |
subscriberSnippet.description |
string La descrizione del canale dell'iscritto. |
subscriberSnippet.channelId |
string L'ID assegnato da YouTube per identificare in modo univoco il canale dell'iscritto. |
subscriberSnippet.thumbnails |
object Immagini in miniatura del canale dell'iscritto. |
subscriberSnippet.thumbnails.(key) |
object Le coppie chiave-valore valide sono:
|
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. |