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:
|
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:
|
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:
|
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:
|
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. |