Activities

Resource activity berisi informasi tentang tindakan yang telah dilakukan oleh channel atau pengguna tertentu di YouTube. Tindakan yang dilaporkan di feed aktivitas mencakup memberi rating video, membagikan video, menandai video sebagai favorit, mengupload video, dan sebagainya. Setiap resource activity mengidentifikasi jenis tindakan, channel yang terkait dengan tindakan, dan resource yang terkait dengan tindakan, seperti video yang diberi rating atau diupload.

Metode

API ini mendukung metode berikut untuk resource activities:

list
Menampilkan daftar peristiwa aktivitas saluran yang cocok dengan kriteria permintaan. Misalnya, Anda dapat mengambil peristiwa yang terkait dengan channel tertentu atau dengan channel pengguna itu sendiri. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource 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": {
      }
    },
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#activity.
etag etag
ETag resource ini.
id string
ID yang digunakan YouTube untuk mengidentifikasi aktivitas secara unik.
snippet object
Objek snippet berisi detail dasar tentang aktivitas, termasuk jenis dan ID grup aktivitas.
snippet.publishedAt datetime
Tanggal dan waktu terjadinya aktivitas. Nilai ditentukan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang terkait dengan aktivitas.
snippet.title string
Judul resource yang terutama terkait dengan aktivitas.
snippet.description string
Deskripsi resource yang terutama terkait dengan aktivitas.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan resource yang terutama terkait dengan aktivitas. Untuk setiap objek dalam peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail.
snippet.thumbnails.(key) object
Nilai kunci yang valid adalah:
  • default – Gambar thumbnail default. Thumbnail default untuk video – atau resource yang merujuk ke video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel memiliki lebar 88 px dan tinggi 88 px.
  • medium – Versi gambar thumbnail dengan resolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini berukuran lebar 240 piksel dan tinggi 240 piksel.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 480 px dan tinggi 360 px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
  • standard – Versi gambar thumbnail dengan resolusi yang lebih tinggi daripada gambar resolusi high. Gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel.
  • maxres – Versi gambar thumbnail dengan resolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 1280 piksel dan tinggi 720 piksel.
snippet.thumbnails.(key).url string
URL gambar.
snippet.thumbnails.(key).width unsigned integer
Lebar gambar.
snippet.thumbnails.(key).height unsigned integer
Tinggi gambar.
snippet.channelTitle string
Judul channel untuk channel yang bertanggung jawab atas aktivitas ini
snippet.type string
Jenis aktivitas yang dijelaskan oleh resource.

Nilai yang valid untuk properti ini adalah:
  • channelItem
  • comment – (saat ini tidak dikembalikan)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
snippet.groupId string
ID grup yang terkait dengan aktivitas. ID grup mengidentifikasi peristiwa pengguna yang terkait dengan pengguna dan resource yang sama. Misalnya, jika pengguna memberi rating pada video dan menandai video yang sama sebagai favorit, entri untuk peristiwa tersebut akan memiliki ID grup yang sama di feed aktivitas pengguna. Di antarmuka pengguna, Anda dapat menghindari pengulangan dengan mengelompokkan peristiwa dengan nilai groupId yang sama.
contentDetails object
Objek contentDetails berisi informasi tentang konten yang terkait dengan aktivitas. Misalnya, jika nilai snippet.type adalah videoRated, maka konten objek contentDetails mengidentifikasi video yang diberi rating.
contentDetails.upload object
Objek upload berisi informasi tentang video yang diupload. Properti ini hanya ada jika snippet.type adalah upload.
contentDetails.upload.videoId string
ID yang digunakan YouTube untuk mengidentifikasi video yang diupload secara unik.
contentDetails.like object
Objek like berisi informasi tentang resource yang menerima rating positif (suka). Properti ini hanya ada jika snippet.type adalah like.
contentDetails.like.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang diberi rating.
contentDetails.like.resourceId.kind string
Jenis resource API.
contentDetails.like.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi video secara unik, jika resource yang diberi rating adalah video. Properti ini hanya ada jika resourceId.kind adalah youtube#video.
contentDetails.favorite object
Objek favorite berisi informasi tentang video yang ditandai sebagai video favorit. Properti ini hanya ada jika snippet.type adalah favorite.
contentDetails.favorite.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang ditandai sebagai favorit.
contentDetails.favorite.resourceId.kind string
Jenis resource API.
contentDetails.favorite.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi video favorit secara unik. Properti ini hanya ada jika resourceId.kind adalah youtube#video.

Catatan: Metode activities.list saat ini tidak menampilkan resource untuk komentar baru.
contentDetails.comment object
Objek comment berisi informasi tentang resource yang menerima komentar. Properti ini hanya ada jika snippet.type adalah comment.
contentDetails.comment.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang terkait dengan komentar.
contentDetails.comment.resourceId.kind string
Jenis resource API.
contentDetails.comment.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik video yang terkait dengan komentar. Properti ini hanya ada jika resourceId.kind adalah youtube#video.
contentDetails.comment.resourceId.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel yang terkait dengan komentar secara unik. Properti ini hanya ada jika resourceId.kind adalah youtube#channel.
contentDetails.subscription object
Objek subscription berisi informasi tentang channel yang diikuti pengguna. Properti ini hanya ada jika snippet.type adalah subscription.
contentDetails.subscription.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang menjadi langganan pengguna.
contentDetails.subscription.resourceId.kind string
Jenis resource API.
contentDetails.subscription.resourceId.channelId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang disubscribe pengguna. Properti ini hanya ada jika resourceId.kind adalah youtube#channel.
contentDetails.playlistItem object
Objek playlistItem berisi informasi tentang item playlist baru. Properti ini hanya ada jika snippet.type adalah playlistItem.
contentDetails.playlistItem.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang ditambahkan ke daftar putar.
contentDetails.playlistItem.resourceId.kind string
Jenis resource API.
contentDetails.playlistItem.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik video yang ditambahkan ke daftar putar. Properti ini hanya ada jika resourceId.kind adalah youtube#video.
contentDetails.playlistItem.playlistId string
Nilai yang digunakan YouTube untuk mengidentifikasi daftar putar secara unik.
contentDetails.playlistItem.playlistItemId string
Nilai yang digunakan YouTube untuk mengidentifikasi item secara unik dalam daftar putar.
contentDetails.recommendation object
Objek recommendation berisi informasi tentang resource yang direkomendasikan. Properti ini hanya ada jika snippet.type adalah recommendation.
contentDetails.recommendation.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang direkomendasikan.
contentDetails.recommendation.resourceId.kind string
Jenis resource API.
contentDetails.recommendation.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi video secara unik, jika resource yang direkomendasikan adalah video. Properti ini hanya ada jika resourceId.kind adalah youtube#video.
contentDetails.recommendation.resourceId.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel secara unik, jika resource yang direkomendasikan adalah channel. Properti ini hanya ada jika resourceId.kind adalah youtube#channel.
contentDetails.recommendation.reason string
Alasan resource direkomendasikan kepada pengguna.

Nilai yang valid untuk properti ini adalah:
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object
Objek seedResourceId berisi informasi tentang resource yang menyebabkan rekomendasi.
contentDetails.recommendation.seedResourceId.kind string
Jenis resource API.
contentDetails.recommendation.seedResourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi video secara unik, jika rekomendasi disebabkan oleh video tertentu. Properti ini hanya ada jika seedResourceId.kind adalah youtube#video.
contentDetails.recommendation.seedResourceId.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel secara unik, jika rekomendasi disebabkan oleh channel tertentu. Properti ini hanya ada jika seedResourceId.kind adalah youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId string
ID yang digunakan YouTube untuk mengidentifikasi playlist secara unik, jika rekomendasi disebabkan oleh playlist tertentu. Properti ini hanya ada jika seedResourceId.kind adalah youtube#playlist.
contentDetails.social object
Objek social berisi detail tentang postingan media sosial. Properti ini hanya ada jika snippet.type adalah social.
contentDetails.social.type string
Nama jaringan sosial.

Nilai yang valid untuk properti ini adalah:
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
Objek resourceId merangkum informasi yang mengidentifikasi resource yang terkait dengan postingan jejaring sosial.
contentDetails.social.resourceId.kind string
Jenis resource API.
contentDetails.social.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi video yang ditampilkan dalam postingan media sosial secara unik, jika postingan tersebut merujuk ke video. Properti ini hanya akan ada jika nilai properti social.resourceId.kind adalah youtube#video.
contentDetails.social.resourceId.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel yang ditampilkan dalam postingan media sosial secara unik, jika postingan tersebut merujuk ke channel. Properti ini hanya akan ada jika nilai properti social.resourceId.kind adalah youtube#channel.
contentDetails.social.resourceId.playlistId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik daftar putar yang ditampilkan dalam postingan media sosial, jika postingan tersebut merujuk ke daftar putar. Properti ini hanya akan ada jika nilai properti social.resourceId.kind adalah youtube#playlist.
contentDetails.social.author string
Penulis postingan media sosial.
contentDetails.social.referenceUrl string
URL postingan media sosial.
contentDetails.social.imageUrl string
Gambar penulis postingan.
contentDetails.channelItem object
Objek channelItem berisi detail tentang resource yang ditambahkan ke channel. Properti ini hanya ada jika snippet.type adalah channelItem.
contentDetails.channelItem.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang ditambahkan ke channel.