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.