Activities

Una risorsa activity contiene informazioni su un'azione che un determinato canale o utente ha eseguito su YouTube. Le azioni segnalate nei feed delle attività includono la condivisione di un video, 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 valutato o caricato.

Metodi

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

list
Restituisce un elenco di eventi di attività del canale che corrispondono ai criteri della richiesta. Ad esempio, puoi recuperare gli eventi associati a un canale specifico o al canale dell'utente. Prova subito.

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
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": 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à che appaiono 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 che YouTube utilizza 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 che YouTube utilizza per identificare in modo univoco il canale associato all'attività.
snippet.title string
Il titolo della risorsa principalmente associata all'attività.
snippet.description string
La descrizione della risorsa principalmente associata 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 è 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. La miniatura predefinita per un video o una risorsa che fa riferimento a un video, ad esempio un elemento della playlist o un risultato di ricerca, ha una larghezza di 120 px e un'altezza di 90 px. La miniatura predefinita per un canale ha una larghezza di 88 px e un'altezza di 88 px.
  • 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 ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine ha una larghezza di 240 px e un'altezza di 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 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.
  • standard : una versione dell'immagine in miniatura con una risoluzione ancora più alta rispetto all'immagine con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi della playlist o i risultati di ricerca. Questa immagine ha una larghezza di 640 px e un'altezza di 480 px.
  • maxres : la versione con la risoluzione più alta dell'immagine in miniatura. Questa dimensione dell'immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi della playlist o i risultati di ricerca. Questa immagine ha una larghezza di 1280 px e un'altezza di 720 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.
snippet.channelTitle string
Il titolo del canale responsabile di questa attività.
snippet.type string
Il tipo di attività descritta dalla risorsa.

I valori validi per questa proprietà sono:
  • channelItem
  • comment : (non restituito al momento)
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • upload
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 carica un video e guarda lo stesso video, le voci di questi eventi avranno lo stesso ID gruppo nel feed delle attività dell'utente. Nell'interfaccia utente, puoi evitare la ripetizione raggruppando gli eventi con lo stesso valore 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 valutato.
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 che YouTube utilizza per identificare in modo univoco il video caricato.
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 che YouTube utilizza 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 che YouTube utilizza per identificare in modo univoco il canale associato a un commento. 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 che YouTube utilizza 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 che YouTube utilizza per identificare in modo univoco la playlist.
contentDetails.playlistItem.playlistItemId string
Il valore che YouTube utilizza 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 che YouTube utilizza 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 che YouTube utilizza 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:
  • videoWatched
contentDetails.recommendation.seedResourceId object
L'oggetto seedResourceId contiene informazioni sulla risorsa che ha causato il consiglio.
contentDetails.recommendation.seedResourceId.kind string
Il tipo di risorsa API.
contentDetails.recommendation.seedResourceId.videoId string
L'ID che YouTube utilizza per identificare in modo univoco il video, se il consiglio è stato causato da un video specifico. Questa proprietà è presente solo se seedResourceId.kind è youtube#video.
contentDetails.recommendation.seedResourceId.channelId string
L'ID che YouTube utilizza per identificare in modo univoco il canale, se il consiglio è stato causato da un canale specifico. Questa proprietà è presente solo se seedResourceId.kind è youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId string
L'ID che YouTube utilizza per identificare in modo univoco la playlist, se il consiglio è stato causato da una playlist specifica. Questa proprietà è presente solo se seedResourceId.kind è youtube#playlist.
contentDetails.social object
L'oggetto social contiene i dettagli di un post di 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:
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
L'oggetto resourceId incapsula le informazioni che identificano la risorsa associata a un post di un social network.
contentDetails.social.resourceId.kind string
Il tipo di risorsa API.
contentDetails.social.resourceId.videoId string
L'ID che YouTube utilizza per identificare in modo univoco il video presente in un post di un 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 che YouTube utilizza per identificare in modo univoco il canale presente in un post di un 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 che YouTube utilizza per identificare in modo univoco la playlist presente in un post di un 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 del social network.
contentDetails.social.referenceUrl string
L'URL del post del social network.
contentDetails.social.imageUrl string
Un'immagine dell'autore del post.
contentDetails.channelItem object
L'oggetto channelItem contiene i dettagli di una risorsa 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.