Activities

Wycofaliśmy z YouTube funkcję biuletynu na kanale. Metoda activities.list nadal nie zwraca biuletynów kanałów, a metoda activities.insert nie jest już obsługiwana. Więcej informacji znajdziesz w Centrum pomocy YouTube.

Zasób activity zawiera informacje na temat działań wykonanych w YouTube przez określony kanał lub użytkownika. Działania zgłaszane w kanałach aktywności obejmują ocenę filmu, udostępnienie go, oznaczenie go jako ulubionego, przesłanie filmu itd. Każdy zasób activity określa typ działania, powiązany z nim kanał oraz zasoby powiązane z tym 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ń związanych z aktywnością na kanale, które spełniają kryteria żądania. Możesz na przykład pobrać zdarzenia powiązane z określonym kanałem lub z własnym kanałem użytkownika. Wypróbuj teraz

Metoda activities.insert nie jest już obsługiwana.

Reprezentacja zasobu

Poniższa struktura JSON pokazuje 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 definiuje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu API. Wartością będzie 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 wystąpienia aktywności. Wartość musi być podana w formacie ISO 8601.
snippet.channelId	string Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje kanał powiązany z aktywnością.
snippet.title	string Tytuł zasobu powiązany głównie z działaniem.
snippet.description	string Opis zasobu powiązanego głównie z działaniem.
snippet.thumbnails	object Mapa miniaturek powiązanych z zasobem, który jest głównie związany z aktywnością. Kluczem dla każdego obiektu na mapie jest nazwa miniatury obrazu, a wartością jest obiekt zawierający pozostałe informacje na temat miniatury.
snippet.thumbnails.(key)	object Prawidłowe pary klucz-wartość to: default – domyślny obraz miniatury. Domyślna miniatura filmu – lub zasób, który odnosi się do filmu, np. element playlisty lub wynik wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja miniatury o wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli. high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 pikseli i wysokość 800 pikseli. standard – wersja miniatury w wyższej rozdzielczości niż w przypadku obrazu w rozdzielczości high. Obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak pozycje playlist czy wyniki 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 odnoszących się do filmów, takich jak elementy playlist czy wyniki wyszukiwania. Ten obraz ma 1280 pikseli szerokości i 720 pikseli wysokości.
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óry opisuje zasób. Prawidłowe wartości tej właściwości to: channelItem comment – (obecnie nie zwrócono) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (wycofano)
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 oceni film i oznaczy ten sam film jako ulubiony, wpisy dotyczące tych zdarzeń będą miały taki sam identyfikator grupy w obszarze aktywności użytkownika. Unikaj powtarzania tych samych czynności w interfejsie, grupując zdarzenia za pomocą tej samej wartości groupId.
contentDetails	object Obiekt contentDetails zawiera informacje o treściach powiązanych z aktywnością. Jeśli np. wartość snippet.type to videoRated, to 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 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ą (taką) ocenę. Ta właściwość występuje tylko wtedy, gdy snippet.type ma wartość like.
contentDetails.like.resourceId	object Obiekt resourceId zawiera informacje identyfikujące oceniony zasób.
contentDetails.like.resourceId.kind	string Typ zasobu API.
contentDetails.like.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu, jeśli ocenionym zasobem jest film. Ta właściwość występuje tylko wtedy, gdy 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 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 API.
contentDetails.favorite.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania ulubionego filmu. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#video. Uwaga: metoda activities.list obecnie nie zwraca 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 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 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 resourceId.kind ma wartość youtube#video.
contentDetails.comment.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału powiązanego z komentarzem. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#channel.
contentDetails.subscription	object Obiekt subscription zawiera informacje o kanale, który użytkownik zasubskrybował. Ta właściwość występuje tylko wtedy, gdy snippet.type ma wartość subscription.
contentDetails.subscription.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób, który użytkownik zasubskrybował.
contentDetails.subscription.resourceId.kind	string Typ zasobu API.
contentDetails.subscription.resourceId.channelId	string Identyfikator, na podstawie którego YouTube jednoznacznie identyfikuje kanał, który zasubskrybował użytkownik. Ta właściwość występuje tylko wtedy, gdy 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 snippet.type ma wartość playlistItem.
contentDetails.playlistItem.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób dodany do playlisty.
contentDetails.playlistItem.resourceId.kind	string Typ zasobu API.
contentDetails.playlistItem.resourceId.videoId	string Identyfikator, na podstawie którego YouTube jednoznacznie identyfikuje film dodany do playlisty. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.playlistItem.playlistId	string Niepowtarzalna wartość, na podstawie której YouTube identyfikuje playlistę.
contentDetails.playlistItem.playlistItemId	string Wartość, na podstawie której YouTube jednoznacznie identyfikuje element na playliście.
contentDetails.recommendation	object Obiekt recommendation zawiera informacje o zalecanym zasobie. Ta właściwość występuje tylko wtedy, gdy snippet.type ma wartość recommendation.
contentDetails.recommendation.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zalecany zasób.
contentDetails.recommendation.resourceId.kind	string Typ zasobu API.
contentDetails.recommendation.resourceId.videoId	string Jeśli zalecanym zasobem jest film, to identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.recommendation.resourceId.channelId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału, jeśli rekomendowanym zasobem jest kanał. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.reason	string 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ł rekomendację.
contentDetails.recommendation.seedResourceId.kind	string Typ zasobu 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 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 wywołana przez konkretny kanał. Ta właściwość występuje tylko wtedy, gdy seedResourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string Identyfikator, którego YouTube używa do jednoznacznego zidentyfikowania playlisty, jeśli rekomendacja została wywołana przez konkretną playlistę. Ta właściwość występuje 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ść występuje tylko wtedy, gdy snippet.type ma wartość social.
contentDetails.social.type	string Nazwa sieci społecznościowej. Prawidłowe wartości dla tej właściwości to: 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 API.
contentDetails.social.resourceId.videoId	string Identyfikator, którego YouTube używa do jednoznacznego zidentyfikowania filmu przedstawionego w poście w sieci społecznościowej, jeśli odnosi się on do filmu. Ta właściwość występuje 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 jednoznacznej identyfikacji kanału przedstawionego we wpisie w sieci społecznościowej, jeśli odnosi się on do kanału. Ta właściwość występuje tylko wtedy, gdy wartość właściwości social.resourceId.kind to youtube#channel.
contentDetails.social.resourceId.playlistId	string Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje playlistę pojawiającą się w poście w sieci społecznościowej, jeśli odnosi się on do playlisty. Ta właściwość występuje 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 informacje na temat zasobu dodanego do kanału. Ta właściwość występuje tylko wtedy, gdy snippet.type ma wartość channelItem.
contentDetails.channelItem.resourceId	object Obiekt resourceId zawiera informacje identyfikujące zasób dodany do kanału.