Questa pagina è stata tradotta dall'API Cloud Translation.

Activities

YouTube ha ritirato la funzionalità dei bollettini del canale. Il metodo activities.list non restituisce ancora bollettini del canale e il metodo activities.insert non è più supportato. Per maggiori dettagli, consulta 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 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 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.
`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 associato 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 principalmente associata all'attività. Per ogni oggetto nella 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 si riferisce a un video, come un elemento di una playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita per un canale è di 88 px di larghezza e 88 px di altezza. `medium`: una versione a risoluzione più elevata 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 a risoluzione ancora più elevata dell'immagine in miniatura rispetto all'immagine con risoluzione `high`. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, ad esempio elementi di 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 delle immagini sono disponibili per alcuni video e altre risorse che fanno riferimento ai video, ad esempio 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` 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` – (non attualmente 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 contrassegna lo stesso video come preferito, le voci per quegli 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 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 (like). 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 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` al momento 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: `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 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 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 dettagli su 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` racchiude informazioni che identificano la risorsa associata a un post del 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 del 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 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 presente in un post del 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 sul 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 che è stata aggiunta al canale.