Activities

activity zawiera informacje o działaniach, które dany kanał lub użytkownik wykonał w YouTube. Działania zgłaszane w strumieniach aktywności obejmują ocenianie filmu, udostępnianie filmu, oznaczanie filmu jako ulubionego, przesyłanie filmu itp. Każdy zasób activity określa typ działania, kanał powiązany z działaniem i zasoby powiązane z działaniem, np. film, który został oceniony lub przesłany.

Metody

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

list

Zwraca listę zdarzeń aktywności na kanale, które pasują do kryteriów żą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

Poniższa 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
    },
    "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": {
      }
    },
  }
}

Właściwości

Poniższa tabela zawiera definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#activity.
etag	etag Tag 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 działania. 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 obrazów miniaturowych powiązanych z zasobem, który jest głównym zasobem powiązanym z aktywnością. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key)	object Prawidłowe wartości klucza to: default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja miniatury 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 obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli. high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału ten obraz ma szerokość i wysokość 800 pikseli. standard – wersja miniatury w jeszcze wyższej rozdzielczości niż obraz w rozdzielczości high. Jest ona dostępna w przypadku niektórych filmów i innych zasobów, które się do nich odnoszą, np. elementów playlisty czy wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli. maxres – wersja miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które się do nich odnoszą, np. elementów playlisty czy 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 Nazwa kanału odpowiedzialnego za tę aktywność
snippet.type	string Typ działania, które opisuje zasób. Prawidłowe wartości tego pola to: channelItem comment – (niezwrócony) favorite like playlistItem promotedItem recommendation social subscription upload
snippet.groupId	string Identyfikator grupy powiązany z aktywnością. Identyfikator grupy identyfikuje zdarzenia użytkownika powiązane z tym samym użytkownikiem i zasobem. Jeśli np. użytkownik oceni film i oznaczy go jako ulubiony, wpisy dotyczące tych zdarzeń będą miały ten sam identyfikator grupy w kanale 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ściach powiązanych z aktywnością. Jeśli na przykład wartość snippet.type to videoRated, treść obiektu contentDetails identyfikuje oceniony film.
contentDetails.upload	object Obiekt upload zawiera informacje o przesłanym filmie. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość upload.
contentDetails.upload.videoId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji przesłanego filmu.
contentDetails.like	object Obiekt like zawiera informacje o zasobie, który otrzymał pozytywną ocenę (polubienie). Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość like.
contentDetails.like.resourceId	object Obiekt resourceId zawiera informacje identyfikujące oceniany zasób.
contentDetails.like.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.like.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu, jeśli ocenianym zasobem jest film. Ta właściwość występuje tylko wtedy, gdy element resourceId.kind ma wartość youtube#video.
contentDetails.favorite	object Obiekt favorite zawiera informacje o filmie, który został oznaczony jako ulubiony. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość favorite.
contentDetails.favorite.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób, który został oznaczony jako ulubiony.
contentDetails.favorite.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.favorite.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji ulubionego filmu. Ta właściwość występuje tylko wtedy, gdy wartość resourceId.kind to youtube#video. Uwaga: metoda activities.list nie zwraca obecnie zasobów dla nowych komentarzy.
contentDetails.comment	object Obiekt comment zawiera informacje o zasobie, do którego dodano komentarz. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość comment.
contentDetails.comment.resourceId	object Obiekt resourceId zawiera informacje identyfikujące 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ść występuje tylko wtedy, gdy element resourceId.kind ma wartość youtube#video.
contentDetails.comment.resourceId.channelId	string Identyfikator używany przez YouTube do jednoznacznego identyfikowania kanału powiązanego z komentarzem. Ta właściwość występuje tylko wtedy, gdy element resourceId.kind ma wartość youtube#channel.
contentDetails.subscription	object Obiekt subscription zawiera informacje o kanale, który subskrybuje użytkownik. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość subscription.
contentDetails.subscription.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób, który subskrybuje użytkownik.
contentDetails.subscription.resourceId.kind	string Typ zasobu interfejsu API.
contentDetails.subscription.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału, który subskrybuje użytkownik. Ta właściwość występuje tylko wtedy, gdy element resourceId.kind ma wartość youtube#channel.
contentDetails.playlistItem	object Obiekt playlistItem zawiera informacje o nowym elemencie playlisty. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość playlistItem.
contentDetails.playlistItem.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób, który został 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 rozpoznawania filmu dodanego do playlisty. Ta właściwość występuje tylko wtedy, gdy element 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 zalecanym zasobie. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość recommendation.
contentDetails.recommendation.resourceId	object Obiekt resourceId zawiera informacje identyfikujące rekomendowany 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 rekomendowany zasób jest filmem. Ta właściwość występuje tylko wtedy, gdy element resourceId.kind ma wartość youtube#video.
contentDetails.recommendation.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału, jeśli rekomendowany zasób jest kanałem. Ta właściwość występuje tylko wtedy, gdy element resourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.reason	string Przyczyna, dla której zasób jest rekomendowany użytkownikowi. Prawidłowe wartości tej właściwości to: videoFavorited videoLiked videoWatched
contentDetails.recommendation.seedResourceId	object Obiekt seedResourceId zawiera informacje o zasobie, który spowodował wygenerowanie rekomendacji.
contentDetails.recommendation.seedResourceId.kind	string Typ zasobu interfejsu API.
contentDetails.recommendation.seedResourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu, jeśli rekomendacja została wywołana przez konkretny film. Ta właściwość występuje tylko wtedy, gdy element seedResourceId.kind ma wartość youtube#video.
contentDetails.recommendation.seedResourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału, jeśli rekomendacja została wygenerowana przez konkretny kanał. Ta właściwość występuje tylko wtedy, gdy element seedResourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji playlisty, jeśli rekomendacja została wygenerowana na podstawie konkretnej playlisty. Ta właściwość występuje tylko wtedy, gdy element 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ść występuje tylko wtedy, gdy element snippet.type ma wartość social.
contentDetails.social.type	string Nazwa sieci społecznościowej. Prawidłowe wartości tego atrybutu to: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object Obiekt resourceId zawiera informacje identyfikujące 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 w poście w sieci społecznościowej, jeśli post odnosi 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 odnosi 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 w poście w sieci społecznościowej, jeśli post odnosi 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 Zdjęcie autora posta.
contentDetails.channelItem	object Obiekt channelItem zawiera szczegółowe informacje o zasobie, który został dodany do kanału. Ta właściwość występuje tylko wtedy, gdy element snippet.type ma wartość channelItem.
contentDetails.channelItem.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób, który został dodany do kanału.