activities.list
masih tidak menampilkan buletin saluran, dan metode activities.insert
tidak lagi didukung. Untuk mengetahui detail selengkapnya, lihat Pusat Bantuan YouTube.
Referensi activity
berisi informasi tentang tindakan yang dilakukan channel atau pengguna tertentu di YouTube. Tindakan yang dilaporkan dalam feed aktivitas meliputi 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 channel yang cocok dengan kriteria permintaan. Misalnya, Anda dapat mengambil peristiwa yang terkait dengan saluran tertentu atau dengan saluran pengguna sendiri. 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 mendefinisikan properti yang muncul di resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilainya akan berupa 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 aktivitas terjadi. Nilai ditentukan dalam format ISO 8601. |
snippet.channelId |
string ID yang digunakan YouTube untuk mengidentifikasi channel yang terkait dengan aktivitas secara unik. |
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 aset 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:
|
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:
|
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 peringkat suatu video dan menandai video yang sama sebagai favorit, entri untuk peristiwa tersebut akan memiliki ID grup yang sama di umpan 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 secara unik video yang diupload. |
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 saluran 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 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 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 referensi 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 referensi 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:
|
contentDetails.recommendation.seedResourceId |
object Objek seedResourceId berisi informasi tentang resource yang menyebabkan rekomendasi tersebut. |
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 jejaring sosial. Properti ini hanya ada jika snippet.type adalah social . |
contentDetails.social.type |
string Nama jejaring sosial. Nilai yang valid untuk properti ini adalah:
|
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 secara unik di postingan jejaring 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 channel yang ditampilkan secara unik di postingan jejaring sosial, jika postingan 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 secara unik untuk mengidentifikasi playlist yang ditampilkan di postingan jejaring sosial, jika postingan tersebut merujuk ke playlist. Properti ini hanya akan ada jika nilai properti social.resourceId.kind adalah youtube#playlist . |
contentDetails.social.author |
string Penulis postingan jejaring sosial. |
contentDetails.social.referenceUrl |
string URL postingan jejaring 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. |