Activities

Funkcja biuletynu kanału została wycofana w YouTube. 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 o działaniu podjętym przez dany kanał lub użytkownika w YouTube. Działania zgłaszane w kanałach aktywności obejmują ocenę filmu, udostępnienie go, oznaczenie filmu jako ulubionego, przesłanie filmu itd. Każdy zasób activity określa typ działania, kanał powiązany z działaniem oraz zasoby powiązane z tym działaniem, np. film, który został oceniony lub przesłany.

Metody

Interfejs API obsługuje te metody 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 pobierać zdarzenia powiązane z określonym kanałem lub z 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 przedstawia właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartością będzie youtube#activity.
etag	etag ETag tego zasobu.
id	string Identyfikator używany w YouTube 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ść należy podać 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, który był powiązany głównie z działaniem.
snippet.description	string Opis zasobu związanego głównie z ćwiczeniami.
snippet.thumbnails	object Mapa miniaturek obrazów powiązanych z zasobem, który jest przede wszystkim powiązany z daną aktywnością. W przypadku każdego obiektu na mapie kluczem jest nazwa obrazu miniatury, a wartością jest obiekt zawierający inne informacje na temat miniatury.
snippet.thumbnails.(key)	object Prawidłowe pary klucz-wartość to: default – domyślny obraz miniatury. Domyślna miniatura filmu lub zasobu nawiązującego do filmu, np. elementu playlisty czy wyniku 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 obrazu miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości. high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości. standard – wersja obrazu miniatury w jeszcze wyższej rozdzielczości niż obraz w rozdzielczości high. Ten obraz 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 640 pikseli szerokości i 480 pikseli wysokości. maxres – wersja obrazu miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów dotyczących 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 opisywany w zasobie. 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. Możesz uniknąć powtórzenia w interfejsie, 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 snippet.type ma wartość upload.
contentDetails.upload.videoId	string Identyfikator używany w YouTube do jednoznacznego identyfikowania przesłanego filmu.
contentDetails.like	object Obiekt like zawiera informacje o zasobie, który otrzymał ocenę pozytywną (taką). 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 zidentyfikowania filmu, jeśli oceniony zasób to 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 używany w YouTube do jednoznacznego identyfikowania ulubionego filmu. Ta właściwość jest dostępna tylko wtedy, gdy resourceId.kind ma wartość youtube#video. Uwaga: metoda activities.list nie zwraca obecnie zasobów dla nowych komentarzy.
contentDetails.comment	object Obiekt comment zawiera informacje o zasobie, który otrzymał 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 używany w YouTube do jednoznacznej identyfikacji 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 używany w YouTube do jednoznacznego identyfikowania 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 zasubskrybowanym przez użytkownika. 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 używany w YouTube do jednoznacznego identyfikowania kanału, który użytkownik zasubskrybował. 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, który został dodany do playlisty.
contentDetails.playlistItem.resourceId.kind	string Typ zasobu API.
contentDetails.playlistItem.resourceId.videoId	string Identyfikator używany w YouTube do jednoznacznego identyfikowania filmu dodanego do playlisty. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.playlistItem.playlistId	string Niepowtarzalna wartość, której używa YouTube do identyfikowania playlisty.
contentDetails.playlistItem.playlistItemId	string Wartość, której YouTube używa do jednoznacznego zidentyfikowania elementu 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 używany w YouTube 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 zalecanym zasobem jest kanał. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#channel.
contentDetails.recommendation.reason	string Powód, dla którego 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ł zalecenie.
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 spowodowana 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 spowodowana 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 tej usługi 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 używany w YouTube do jednoznacznego identyfikowania filmu wskazanego 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, za pomocą którego YouTube jednoznacznie identyfikuje kanał pokazany w poście 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ę dostępną 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 szczegółowe informacje na temat zasobu, który został dodany 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, który został dodany do kanału.