Halaman ini diterjemahkan oleh Cloud Translation API.

Activities

YouTube telah menghentikan fitur buletin channel. Metode activities.list melakukan tidak tetap mengembalikan buletin saluran, dan Metode activities.insert bukan tidak lagi didukung. Untuk 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 tersebut, 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 saluran tertentu atau dengan saluran pengguna itu sendiri. Coba sekarang.

Metode activities.insert tidak lagi didukung.

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 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 resource yang terutama dikaitkan 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 referensi yang mengacu pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk sebuah channel memiliki lebar 88 piksel dan tinggi 88 piksel. `medium` – Versi resolusi gambar thumbnail yang lebih tinggi. Untuk video (atau referensi yang merujuk pada video), gambar ini memiliki lebar 320 piksel dan tinggi 180 piksel. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. `high` – Gambar thumbnail versi resolusi tinggi. Untuk video (atau referensi yang merujuk pada video), gambar ini memiliki lebar 480 piksel dan tinggi 360 piksel. Untuk channel, gambar ini memiliki lebar 800px dan tinggi 800px. `standard` – Versi gambar thumbnail beresolusi lebih tinggi dibandingkan gambar beresolusi `high`. Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk pada video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px. `maxres` – Versi resolusi tertinggi untuk gambar thumbnail. Ukuran gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk pada 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 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 kelompok 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`, 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 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 video yang terkait dengan komentar secara unik. 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 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 sumber daya 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 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 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: `facebook` `googlePlus` `twitter` `unspecified`
`contentDetails.social.resourceId`	`object` Objek `resourceId` mengenkapsulasi informasi yang mengidentifikasi aset 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 secara unik video yang ditampilkan di postingan jejaring sosial, jika postingan tersebut merujuk pada 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 jejaring sosial, jika postingan tersebut merujuk ke sebuah 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 di postingan jejaring 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 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 sumber daya yang ditambahkan ke saluran.