Activities

YouTube ha ritirato la funzionalità bollettino sul canale. Il metodo activities.list non restituiscono ancora bollettini del canale e Il metodo activities.insert non è più a lungo. Per ulteriori dettagli, consulta 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 delle attività includono la valutazione di un video, la sua condivisione, il contrassegno di un video come preferito, 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 della 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 della risorsa

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 di attività e l'ID gruppo.
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 di immagini in miniatura associate alla risorsa associata principalmente all'attività. Per ogni oggetto della mappa, la chiave è il nome dell'immagine in miniatura, mentre il valore è un oggetto che contiene altre informazioni sulla miniatura.
snippet.thumbnails.(key) object
Le coppie chiave-valore valide sono:
  • default - L'immagine in miniatura predefinita. 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 è larga 88 px in larghezza e 88 px in 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.
  • standard - Una versione dell'immagine in miniatura con una risoluzione ancora più elevata rispetto all'immagine con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come elementi delle playlist o risultati di ricerca. Questa immagine è larga 640 px e alta 480 px.
  • maxres - La versione con la massima risoluzione dell'immagine in miniatura. Queste dimensioni dell'immagine sono disponibili per alcuni video e altre risorse che fanno riferimento ai video, come elementi di playlist o risultati di ricerca. Questa immagine è larga 1280 px e alta 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à descritto dalla risorsa.

I valori validi per questa proprietà sono:
    .
  • channelItem
  • comment - (attualmente non restituito)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
  • bulletin (deprecato)
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 relative a questi eventi avranno lo stesso ID gruppo nel feed attività dell'utente. Nell'interfaccia utente, puoi evitare le ripetizioni 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 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 (simile). Questa proprietà è presente solo se snippet.type è like.
contentDetails.like.resourceId object
L'oggetto resourceId contiene informazioni che identificano la risorsa classificata.
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 classificata è 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 è iscritto un utente. 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 della 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:
    .
  • videoFavorited
  • videoLiked
  • videoWatched
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 è stato generato da un determinato video. 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 generato da un canale specifico. 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 è stato generato da una determinata playlist. Questa proprietà è presente solo se seedResourceId.kind è youtube#playlist.
contentDetails.social object
L'oggetto social contiene i dettagli di un post sui 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 informazioni che identificano la risorsa associata a un post su un 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 presente in un post sui 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 presente in un post sui 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 presente in un post sui 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 di 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.