activities.list
non restituisce ancora i bollettini del canale e il metodo activities.insert
non è più supportato. Per ulteriori dettagli, visita il Centro assistenza YouTube.
Una risorsa activity
contiene informazioni su un'azione intrapresa da un determinato canale o utente su YouTube. Le azioni riportate nei feed attività includono la valutazione di un video, la condivisione di un video, l'aggiunta di un video ai preferiti, il caricamento di un video e così via. Ogni risorsa activity
identifica il tipo di azione, il canale associato all'azione e le risorse associate all'azione, ad esempio il video che è stato valutato o caricato.
Metodi
L'API supporta i seguenti metodi per le risorse activities
:
- list
- Restituisci un elenco di eventi di attività del canale che corrispondono ai criteri di richiesta. Ad esempio, puoi recuperare gli eventi associati a un determinato canale o al canale dell'utente. Prova subito.
Il metodo activities.insert
non è più supportato.
Rappresentazione delle risorse
La seguente struttura JSON mostra il formato di una risorsa activities
:
{ "kind": "youtube#activity", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "type": string, "groupId": string }, "contentDetails": { "upload": { "videoId": string }, "like": { "resourceId": { "kind": string, "videoId": string, } }, "favorite": { "resourceId": { "kind": string, "videoId": string, } }, "comment": { "resourceId": { "kind": string, "videoId": string, "channelId": string, } }, "subscription": { "resourceId": { "kind": string, "channelId": string, } }, "playlistItem": { "resourceId": { "kind": string, "videoId": string, }, "playlistId": string, "playlistItemId": string }, "recommendation": { "resourceId": { "kind": string, "videoId": string, "channelId": string, }, "reason": string, "seedResourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string } }, "social": { "type": string, "resourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "author": string, "referenceUrl": string, "imageUrl": string }, "channelItem": { "resourceId": { } }, } }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#activity . |
etag |
etag L'Etag di questa risorsa. |
id |
string L'ID utilizzato da YouTube per identificare in modo univoco l'attività. |
snippet |
object L'oggetto snippet contiene i dettagli di base dell'attività, inclusi il tipo e l'ID gruppo dell'attività. |
snippet.publishedAt |
datetime La data e l'ora in cui si è verificata l'attività. Il valore è specificato nel formato ISO 8601. |
snippet.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale associato all'attività. |
snippet.title |
string Il titolo della risorsa associata principalmente all'attività. |
snippet.description |
string La descrizione della risorsa associata principalmente all'attività. |
snippet.thumbnails |
object Una mappa delle immagini in miniatura associate alla risorsa principalmente associata all'attività. 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. |
snippet.channelTitle |
string Il titolo del canale responsabile di questa attività |
snippet.type |
string Il tipo di attività descritto dalla risorsa. I valori validi per questa proprietà sono:
|
snippet.groupId |
string L'ID gruppo associato all'attività. Un ID gruppo identifica gli eventi utente associati allo stesso utente e alla stessa risorsa. Ad esempio, se un utente valuta un video e lo contrassegna come preferito, le voci per quegli eventi avranno lo stesso ID gruppo nel feed attività dell'utente. Nell'interfaccia utente, puoi evitare ripetizioni raggruppando gli eventi con lo stesso valore di groupId . |
contentDetails |
object L'oggetto contentDetails contiene informazioni sui contenuti associati all'attività. Ad esempio, se il valore snippet.type è videoRated , i contenuti dell'oggetto contentDetails identificano il video classificato. |
contentDetails.upload |
object L'oggetto upload contiene informazioni sul video caricato. Questa proprietà è presente solo se snippet.type è upload . |
contentDetails.upload.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video caricato. |
contentDetails.like |
object L'oggetto like contiene informazioni su una risorsa che ha ricevuto una valutazione positiva (Mi piace). Questa proprietà è presente solo se snippet.type è like . |
contentDetails.like.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa valutata. |
contentDetails.like.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.like.resourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video, se la risorsa valutata è un video. Questa proprietà è presente solo se resourceId.kind è youtube#video . |
contentDetails.favorite |
object L'oggetto favorite contiene informazioni su un video contrassegnato come preferito. Questa proprietà è presente solo se snippet.type è favorite . |
contentDetails.favorite.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa contrassegnata come preferita. |
contentDetails.favorite.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.favorite.resourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video preferito. Questa proprietà è presente solo se resourceId.kind è youtube#video .Nota: il metodo activities.list attualmente non restituisce risorse per i nuovi commenti. |
contentDetails.comment |
object L'oggetto comment contiene informazioni su una risorsa che ha ricevuto un commento. Questa proprietà è presente solo se snippet.type è comment . |
contentDetails.comment.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa associata al commento. |
contentDetails.comment.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.comment.resourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video associato a un commento. Questa proprietà è presente solo se resourceId.kind è youtube#video . |
contentDetails.comment.resourceId.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale associato a un commento. Questa proprietà è presente solo se resourceId.kind è youtube#channel . |
contentDetails.subscription |
object L'oggetto subscription contiene informazioni su un canale a cui un utente si è iscritto. Questa proprietà è presente solo se snippet.type è subscription . |
contentDetails.subscription.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa a cui l'utente ha sottoscritto l'abbonamento. |
contentDetails.subscription.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.subscription.resourceId.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale a cui l'utente si è iscritto. Questa proprietà è presente solo se resourceId.kind è youtube#channel . |
contentDetails.playlistItem |
object L'oggetto playlistItem contiene informazioni su un nuovo elemento della playlist. Questa proprietà è presente solo se snippet.type è playlistItem . |
contentDetails.playlistItem.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa aggiunta alla playlist. |
contentDetails.playlistItem.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.playlistItem.resourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video aggiunto alla playlist. Questa proprietà è presente solo se resourceId.kind è youtube#video . |
contentDetails.playlistItem.playlistId |
string Il valore utilizzato da YouTube per identificare in modo univoco la playlist. |
contentDetails.playlistItem.playlistItemId |
string Il valore utilizzato da YouTube per identificare in modo univoco l'elemento nella playlist. |
contentDetails.recommendation |
object L'oggetto recommendation contiene informazioni su una risorsa consigliata. Questa proprietà è presente solo se snippet.type è recommendation . |
contentDetails.recommendation.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa consigliata. |
contentDetails.recommendation.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.recommendation.resourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video, se la risorsa consigliata è un video. Questa proprietà è presente solo se resourceId.kind è youtube#video . |
contentDetails.recommendation.resourceId.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale, se la risorsa consigliata è un canale. Questa proprietà è presente solo se resourceId.kind è youtube#channel . |
contentDetails.recommendation.reason |
string Il motivo per cui la risorsa è consigliata all'utente. I valori validi per questa proprietà sono:
|
contentDetails.recommendation.seedResourceId |
object L'oggetto seedResourceId contiene informazioni sulla risorsa che ha generato il suggerimento. |
contentDetails.recommendation.seedResourceId.kind |
string Il tipo di risorsa API. |
contentDetails.recommendation.seedResourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video, se il consiglio è derivato da un video specifico. Questa proprietà è presente solo se seedResourceId.kind è youtube#video . |
contentDetails.recommendation.seedResourceId.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale, se il consiglio è stato causato da un determinato canale. Questa proprietà è presente solo se seedResourceId.kind è youtube#channel . |
contentDetails.recommendation.seedResourceId.playlistId |
string L'ID utilizzato da YouTube per identificare in modo univoco la playlist, se il consiglio è derivato da una playlist specifica. Questa proprietà è presente solo se seedResourceId.kind è youtube#playlist . |
contentDetails.social |
object L'oggetto social contiene dettagli su un post su un social network. Questa proprietà è presente solo se snippet.type è social . |
contentDetails.social.type |
string Il nome del social network. I valori validi per questa proprietà sono:
|
contentDetails.social.resourceId |
object L'oggetto resourceId racchiude informazioni che identificano la risorsa associata a un post sul social network. |
contentDetails.social.resourceId.kind |
string Il tipo di risorsa API. |
contentDetails.social.resourceId.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco il video mostrato in un post di social network, se il post fa riferimento a un video. Questa proprietà sarà presente solo se il valore della proprietà social.resourceId.kind è youtube#video . |
contentDetails.social.resourceId.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale pubblicato in un post del social network, se il post fa riferimento a un canale. Questa proprietà sarà presente solo se il valore della proprietà social.resourceId.kind è youtube#channel . |
contentDetails.social.resourceId.playlistId |
string L'ID utilizzato da YouTube per identificare in modo univoco la playlist presentata in un post di social network, se il post fa riferimento a una playlist. Questa proprietà sarà presente solo se il valore della proprietà social.resourceId.kind è youtube#playlist . |
contentDetails.social.author |
string L'autore del post sui social network. |
contentDetails.social.referenceUrl |
string L'URL del post sul social network. |
contentDetails.social.imageUrl |
string Un'immagine dell'autore del post. |
contentDetails.channelItem |
object L'oggetto channelItem contiene i dettagli su una risorsa che è stata aggiunta a un canale. Questa proprietà è presente solo se snippet.type è channelItem . |
contentDetails.channelItem.resourceId |
object L'oggetto resourceId contiene informazioni che identificano la risorsa aggiunta al canale. |