Activities

Zasób activity zawiera informacje o działaniu, które dany kanał lub użytkownik wykonał w YouTube. Działania zgłaszane w plikach danych o aktywności obejmują udostępnianie filmu, przesyłanie filmu itp. Każdy zasób activity określa typ działania, kanał powiązany z działaniem oraz zasoby powiązane z działaniem, takie jak oceniony lub przesłany film.

Metody

Interfejs API obsługuje te metody w przypadku zasobów activities:

list

Zwraca listę zdarzeń aktywności na kanale, które spełniają kryteria żądania. Możesz na przykład pobrać zdarzenia powiązane z konkretnym kanałem lub z kanałem użytkownika. Wypróbuj teraz.

Prezentacja zasobów

Ta struktura JSON przedstawia format zasobu 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": {
      }
    },
  }
}

Właściwości

Ta tabela zawiera definicje właściwości, które występują w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość to youtube#activity.
etag	etag Etag tego zasobu.
id	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania aktywności.
snippet	object Obiekt snippet zawiera podstawowe informacje o aktywności, w tym jej typ i identyfikator grupy.
snippet.publishedAt	datetime Data i godzina wystąpienia aktywności. Wartość jest podana w formacie ISO 8601.
snippet.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału powiązanego z aktywnością.
snippet.title	string Tytuł zasobu powiązanego głównie z aktywnością.
snippet.description	string Opis zasobu powiązanego głównie z aktywnością.
snippet.thumbnails	object Mapa miniatur powiązanych z zasobem, który jest głównie powiązany z aktywnością. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością – obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key)	object Prawidłowe wartości klucza: default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odwołuje się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma szerokość 88 pikseli i wysokość 88 pikseli. medium – miniatura w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału ten obraz ma szerokość 240 pikseli i wysokość 240 pikseli. high – miniatura w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału ten obraz ma szerokość 800 pikseli i wysokość 800 pikseli. standard – miniatura w jeszcze wyższej rozdzielczości niż high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, np. elementów playlisty lub wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli. maxres – miniatura w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, np. elementów playlisty lub wyników wyszukiwania. Ten obraz ma szerokość 1280 pikseli i wysokość 720 pikseli.
snippet.thumbnails.(key).url	string Adres URL obrazu.
snippet.thumbnails.(key).width	unsigned integer Szerokość obrazu.
snippet.thumbnails.(key).height	unsigned integer Wysokość obrazu.
snippet.channelTitle	string Tytuł kanału odpowiedzialnego za tę aktywność.
snippet.type	string Typ aktywności, którą opisuje zasób. Prawidłowe wartości tej właściwości: channelItem comment – (obecnie nie jest zwracana) playlistItem promotedItem recommendation social upload
snippet.groupId	string Identyfikator grupy powiązany z aktywnością. Identyfikator grupy określa zdarzenia użytkownika, które są powiązane z tym samym użytkownikiem i zasobem. Jeśli na przykład użytkownik prześle film i obejrzy ten sam film, wpisy dotyczące tych zdarzeń będą miały ten sam identyfikator grupy w pliku danych o aktywności użytkownika. W interfejsie użytkownika możesz uniknąć powtórzeń, grupując zdarzenia o tej samej wartości groupId.
contentDetails	object Obiekt contentDetails zawiera informacje o treści powiązanej z aktywnością. Jeśli na przykład wartość snippet.type to videoRated, zawartość obiektu contentDetails określa oceniony film.
contentDetails.upload	object Obiekt upload zawiera informacje o przesłanym filmie. Ta właściwość jest obecna tylko wtedy, gdy snippet.type ma wartość upload.
contentDetails.upload.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania przesłanego filmu.
contentDetails.comment	object Obiekt comment zawiera informacje o zasobie, który otrzymał komentarz. Ta właściwość jest obecna tylko wtedy, gdy snippet.type ma wartość comment.
contentDetails.comment.resourceId	object Obiekt resourceId zawiera informacje, które identyfikują zasób powiązany z komentarzem.
contentDetails.comment.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.comment.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu powiązanego z komentarzem. Ta właściwość jest obecna tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.comment.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału powiązanego z komentarzem. Ta właściwość jest obecna tylko wtedy, gdy resourceId.kind ma wartość youtube#channel.
contentDetails.playlistItem	object Obiekt playlistItem zawiera informacje o nowym elemencie playlisty. Ta właściwość jest obecna tylko wtedy, gdy snippet.type ma wartość playlistItem.
contentDetails.playlistItem.resourceId	object Obiekt resourceId zawiera informacje, które identyfikują zasób dodany do playlisty.
contentDetails.playlistItem.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.playlistItem.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu dodanego do playlisty. Ta właściwość jest obecna tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.playlistItem.playlistId	string Wartość, której YouTube używa do jednoznacznego identyfikowania playlisty.
contentDetails.playlistItem.playlistItemId	string Wartość, której YouTube używa do jednoznacznego identyfikowania elementu na playliście.
contentDetails.recommendation	object Obiekt recommendation zawiera informacje o polecanym zasobie. Ta właściwość jest obecna tylko wtedy, gdy snippet.type ma wartość recommendation.
contentDetails.recommendation.resourceId	object Obiekt resourceId zawiera informacje, które identyfikują polecany zasób.
contentDetails.recommendation.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.recommendation.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu, jeśli polecany zasób jest filmem. Ta właściwość jest obecna tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.recommendation.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału, jeśli polecany zasób jest kanałem. Ta właściwość jest obecna tylko wtedy, gdy resourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.reason	string Powód, dla którego zasób jest polecany użytkownikowi. Prawidłowe wartości tej właściwości: videoWatched
contentDetails.recommendation.seedResourceId	object Obiekt seedResourceId zawiera informacje o zasobie, który spowodował wyświetlenie rekomendacji.
contentDetails.recommendation.seedResourceId.kind	string Typ zasobu interfejsu API.
contentDetails.recommendation.seedResourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu, jeśli rekomendacja została spowodowana przez konkretny film. Ta właściwość jest obecna tylko wtedy, gdy seedResourceId.kind ma wartość youtube#video.
contentDetails.recommendation.seedResourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału, jeśli rekomendacja została spowodowana przez konkretny kanał. Ta właściwość jest obecna tylko wtedy, gdy seedResourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania playlisty, jeśli rekomendacja została spowodowana przez konkretną playlistę. Ta właściwość jest obecna tylko wtedy, gdy seedResourceId.kind ma wartość youtube#playlist.
contentDetails.social	object Obiekt social zawiera szczegółowe informacje o poście w sieci społecznościowej. Ta właściwość jest obecna tylko wtedy, gdy snippet.type ma wartość social.
contentDetails.social.type	string Nazwa sieci społecznościowej. Prawidłowe wartości tej właściwości: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object Obiekt resourceId zawiera informacje, które identyfikują zasób powiązany z postem w sieci społecznościowej.
contentDetails.social.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.social.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu przedstawionego w poście w sieci społecznościowej, jeśli post odwołuje się do filmu. Ta właściwość będzie obecna tylko wtedy, gdy wartość właściwości social.resourceId.kind to youtube#video.
contentDetails.social.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału przedstawionego w poście w sieci społecznościowej, jeśli post odwołuje się do kanału. Ta właściwość będzie obecna tylko wtedy, gdy wartość właściwości social.resourceId.kind to youtube#channel.
contentDetails.social.resourceId.playlistId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania playlisty przedstawionej w poście w sieci społecznościowej, jeśli post odwołuje się do playlisty. Ta właściwość będzie obecna tylko wtedy, gdy wartość właściwości social.resourceId.kind to youtube#playlist.
contentDetails.social.author	string Autor posta w sieci społecznościowej.
contentDetails.social.referenceUrl	string Adres URL posta w sieci społecznościowej.
contentDetails.social.imageUrl	string Obraz autora posta.
contentDetails.channelItem	object Obiekt channelItem zawiera szczegółowe informacje o zasobie, który został dodany do kanału. Ta właściwość jest obecna tylko wtedy, gdy snippet.type ma wartość channelItem.
contentDetails.channelItem.resourceId	object Obiekt resourceId zawiera informacje, które identyfikują zasób dodany do kanału.