Activities

YouTube telah menghentikan penggunaan fitur buletin channel. Metode activities.list tidak lagi menampilkan buletin saluran, dan metode activities.insert tidak lagi didukung. Untuk detail selengkapnya, lihat Pusat Bantuan YouTube.

Referensi activity berisi informasi tentang tindakan yang telah dilakukan channel atau pengguna tertentu di YouTube. Tindakan yang dilaporkan dalam feed aktivitas meliputi memberi rating video, berbagi 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 channel yang cocok dengan kriteria permintaan. Misalnya, Anda dapat mengambil peristiwa yang terkait dengan saluran tertentu atau dengan saluran milik pengguna. Coba sekarang.

Metode activities.insert tidak lagi didukung.

Representasi resource

Struktur JSON berikut menampilkan 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 akan berupa youtube#activity.
etag etag
Etag referensi 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 aktivitas terjadi. Nilai ini 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 referensi yang terutama terkait dengan aktivitas.
snippet.description string
Deskripsi referensi yang terutama terkait dengan aktivitas.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan resource yang terutama terkait dengan aktivitas tersebut. 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, misalnya item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini memiliki lebar 240 piksel dan tinggi 240 piksel.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya 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 beresolusi lebih tinggi daripada gambar resolusi high. Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px.
  • maxres – Versi gambar thumbnail beresolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan sumber daya lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 1280px dan tinggi 720px.
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 ditampilkan)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
  • bulletin (tidak digunakan lagi)
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 video dan menandai video yang sama sebagai favorit, entri untuk peristiwa tersebut akan memiliki ID grup yang sama dalam 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, konten objek contentDetails akan 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 dengan 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 terkait 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 di-subscribe 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 di-subscribe 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 playlist.
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 playlist. Properti ini hanya ada jika resourceId.kind adalah youtube#video.
contentDetails.playlistItem.playlistId string
Nilai yang digunakan YouTube untuk mengidentifikasi playlist secara unik.
contentDetails.playlistItem.playlistItemId string
Nilai yang digunakan YouTube untuk mengidentifikasi item dalam playlist secara unik.
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 mengapa 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 jaringan 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 jaringan sosial.
contentDetails.social.resourceId.kind string
Jenis resource API.
contentDetails.social.resourceId.videoId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik video yang ditampilkan dalam postingan jaringan sosial, 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 secara unik channel yang ditampilkan di postingan jaringan sosial, 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 playlist yang ditampilkan dalam postingan jaringan sosial secara unik, jika postingan tersebut merujuk pada playlist. Properti ini hanya akan ada jika nilai properti social.resourceId.kind adalah youtube#playlist.
contentDetails.social.author string
Penulis postingan jaringan sosial.
contentDetails.social.referenceUrl string
URL postingan jaringan sosial.
contentDetails.social.imageUrl string
Gambar penulis postingan.
contentDetails.channelItem object
Objek channelItem berisi detail tentang resource yang ditambahkan ke saluran. Properti ini hanya ada jika snippet.type adalah channelItem.
contentDetails.channelItem.resourceId object
Objek resourceId berisi informasi yang mengidentifikasi resource yang ditambahkan ke saluran.