Activities

Wycofaliśmy z YouTube funkcję biuletynu kanału. Metoda activities.list nadal nie wyświetlają biuletyny kanału, Metoda activities.insert nie ma wartości jest dłużej obsługiwana. Aby uzyskać więcej informacji, zobacz Centrum pomocy YouTube.

Zasób activity zawiera informacje o działaniach podjętych w YouTube przez konkretny kanał lub użytkownika. Działania raportowane w kanałach aktywności obejmują ocenianie filmów, udostępnianie, oznaczanie filmów jako ulubionych, przesyłanie filmów itd. Każdy zasób activity określa typ działania, kanał powiązany z działaniem oraz zasoby powiązane z działaniem, np. oceniony lub przesłany film.

Metody

Interfejs API obsługuje następujące 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 określonym kanałem lub z kanałem użytkownika. Wypróbuj teraz

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

Reprezentowanie zasobu

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

Tabela poniżej zawiera właściwości widoczne w tym zasobie:

Właściwości
kind string,
Określa typ zasobu interfejsu API. Wartość wyniesie youtube#activity.
etag etag,
Etag tego zasobu.
id string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje aktywność.
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, za pomocą którego YouTube jednoznacznie identyfikuje kanał powiązany z aktywnością.
snippet.title string,
Tytuł zasobu powiązanego głównie z danym działaniem.
snippet.description string,
Opis zasobu powiązanego głównie z działaniem.
snippet.thumbnails object,
Mapa miniatur zdjęć powiązanych z zasobem, który jest powiązany przede wszystkim z danym działaniem. Kluczem dla każdego obiektu na mapie jest nazwa miniatury obrazu, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key) object,
Prawidłowe wartości klucza to:
  • default – domyślny obraz miniatury. Domyślna miniatura filmu – lub zasób odnoszący się do filmu, taki jak 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 obrazu miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu powiązanego z filmem) obraz ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału ten obraz ma 240 pikseli szerokości i 240 pikseli wysokości.
  • high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu powiązanego z filmem) obraz ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału ten obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
  • standard – wersja obrazu miniatury o 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 związanych z filmami, takich jak elementy playlisty 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 związanych z filmami, takich jak elementy playlisty 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 działania opisywany przez 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 powiązane z tym samym użytkownikiem i zasobem. Jeśli na przykład użytkownik oceni film i oznaczy go jako ulubiony, wpisy dotyczące tych zdarzeń będą miały taki sam identyfikator grupy w jego kanale aktywności. Możesz uniknąć powtórzeń w interfejsie, grupując zdarzenia z tą samą wartością groupId.
contentDetails object,
Obiekt contentDetails zawiera informacje o treści powiązanej z działaniem. Jeśli na przykład snippet.type ma wartość videoRated, to treść obiektu contentDetails identyfikuje oceniany 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, za pomocą którego YouTube jednoznacznie identyfikuje przesłany film.
contentDetails.like object,
Obiekt like zawiera informacje o zasobie, który otrzymał pozytywną (lubię) ocenę. Ta właściwość występuje tylko wtedy, gdy snippet.type ma wartość like.
contentDetails.like.resourceId object,
Obiekt resourceId zawiera informacje, które identyfikują oceniany zasób.
contentDetails.like.resourceId.kind string,
Typ zasobu interfejsu API.
contentDetails.like.resourceId.videoId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje film, jeśli ocenianym 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 interfejsu API.
contentDetails.favorite.resourceId.videoId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje ulubiony film. 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 interfejsu API.
contentDetails.comment.resourceId.videoId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje film powiązany z komentarzem. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.comment.resourceId.channelId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje kanał powiązany 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 zasubskrybował użytkownik.
contentDetails.subscription.resourceId.kind string,
Typ zasobu interfejsu API.
contentDetails.subscription.resourceId.channelId string,
Identyfikator, za pomocą 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, który został dodany do playlisty.
contentDetails.playlistItem.resourceId.kind string,
Typ zasobu interfejsu API.
contentDetails.playlistItem.resourceId.videoId string,
Identyfikator, za pomocą 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,
Wartość, za pomocą której YouTube jednoznacznie identyfikuje playlistę.
contentDetails.playlistItem.playlistItemId string,
Wartość, za pomocą której YouTube jednoznacznie identyfikuje pozycję 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 interfejsu API.
contentDetails.recommendation.resourceId.videoId string,
Identyfikator używany w YouTube do jednoznacznej identyfikacji filmu, jeśli zalecanym zasobem jest film. Ta właściwość występuje tylko wtedy, gdy resourceId.kind ma wartość youtube#video.
contentDetails.recommendation.resourceId.channelId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje kanał, 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ł rekomendację.
contentDetails.recommendation.seedResourceId.kind string,
Typ zasobu interfejsu API.
contentDetails.recommendation.seedResourceId.videoId string,
Identyfikator używany przez YouTube do jednoznacznego zidentyfikowania filmu, jeśli rekomendacja została spowodowana przez konkretny film. Ta właściwość występuje tylko wtedy, gdy seedResourceId.kind ma wartość youtube#video.
contentDetails.recommendation.seedResourceId.channelId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje kanał, 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 używany przez YouTube do jednoznacznego identyfikowania 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 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 właściwości 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 używany w YouTube do jednoznacznego zidentyfikowania filmu umieszczonego w poście w sieci społecznościowej, jeśli post odnosi się do filmu. Ta właściwość występuje tylko wtedy, gdy wartość właściwości social.resourceId.kind wynosi youtube#video.
contentDetails.social.resourceId.channelId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje kanał pojawiający się w poście w sieci społecznościowej, jeśli dany post odnosi się do kanału. Ta właściwość występuje tylko wtedy, gdy wartość właściwości social.resourceId.kind wynosi youtube#channel.
contentDetails.social.resourceId.playlistId string,
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje playlistę przedstawioną w poście w sieci społecznościowej, jeśli post dotyczy playlisty. Ta właściwość występuje tylko wtedy, gdy wartość właściwości social.resourceId.kind wynosi 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 o zasobie, 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.