Halaman ini diterjemahkan oleh Cloud Translation API.

Subscriptions

Referensi subscription berisi informasi tentang langganan pengguna YouTube. Subscription memberi tahu pengguna saat ada video baru yang ditambahkan ke channel, atau saat pengguna lain melakukan salah satu dari beberapa tindakan di YouTube, seperti mengupload video, memberi rating video, atau mengomentari video.

Metode

API ini mendukung metode berikut untuk resource subscriptions:

list: Menampilkan resource langganan yang cocok dengan kriteria permintaan API. Coba sekarang.
sisipkan: Menambahkan langganan untuk saluran pengguna yang terautentikasi. Coba sekarang.
hapus: Menghapus langganan. Coba sekarang.

Representasi resource

Struktur JSON berikut menampilkan format resource subscriptions:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

Properti

Tabel berikut mendefinisikan properti yang muncul di resource ini:

Properti
`kind`	`string` Mengidentifikasi jenis resource API. Nilainya akan berupa `youtube#subscription`.
`etag`	`etag` Etag resource ini.
`id`	`string` ID yang digunakan YouTube untuk mengidentifikasi langganan secara unik.
`snippet`	`object` Objek `snippet` berisi detail dasar tentang langganan, termasuk judul dan saluran langganan pengguna.
`snippet.publishedAt`	`datetime` Tanggal dan waktu langganan dibuat. Nilai ditentukan dalam format ISO 8601.
`snippet.channelTitle`	`string` Judul channel tempat langganan tersebut berada.
`snippet.title`	`string` Judul langganan.
`snippet.description`	`string` Detail langganan.
`snippet.resourceId`	`object` Objek `id` berisi informasi tentang saluran yang menjadi langganan pengguna.
`snippet.resourceId.kind`	`string` Jenis resource API.
`snippet.resourceId.channelId`	`string` Nilai yang digunakan YouTube untuk mengidentifikasi secara unik channel yang disubscribe pengguna.
`snippet.channelId`	`string` ID yang digunakan YouTube untuk mengidentifikasi channel subscriber secara unik. Objek `resource_id` mengidentifikasi saluran yang menjadi langganan pengguna.
`snippet.thumbnails`	`object` Peta gambar thumbnail yang terkait dengan langganan. 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 untuk resource ini. Thumbnail default untuk video – atau referensi yang merujuk ke video, seperti item playlist atau hasil penelusuran – adalah lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88px dan tinggi 88px. `medium` – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. `high` – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 480px dan tinggi 360px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
`snippet.thumbnails.(key).url`	`string` URL gambar.
`snippet.thumbnails.(key).width`	`unsigned integer` Lebar gambar.
`snippet.thumbnails.(key).height`	`unsigned integer` Tinggi gambar.
`contentDetails`	`object` Objek `contentDetails` berisi statistik dasar tentang langganan.
`contentDetails.totalItemCount`	`unsigned integer` Perkiraan jumlah item yang dituju oleh langganan.
`contentDetails.newItemCount`	`unsigned integer` Jumlah item baru dalam langganan sejak kontennya terakhir dibaca.
`contentDetails.activityType`	`string` Jenis aktivitas untuk langganan ini (hanya upload, semuanya). Nilai yang valid untuk properti ini adalah: `all` `uploads`
`subscriberSnippet`	`object` Objek `subscriberSnippet` berisi detail dasar tentang pelanggan.
`subscriberSnippet.title`	`string` Judul channel subscriber.
`subscriberSnippet.description`	`string` Deskripsi channel subscriber.
`subscriberSnippet.channelId`	`string` ID yang ditetapkan YouTube untuk mengidentifikasi channel subscriber secara unik.
`subscriberSnippet.thumbnails`	`object` Gambar thumbnail untuk channel subscriber.
`subscriberSnippet.thumbnails.(key)`	`object` Nilai kunci yang valid adalah: `default` – Gambar thumbnail default untuk resource ini. Thumbnail default untuk video – atau referensi yang merujuk ke video, seperti item playlist atau hasil penelusuran – adalah lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88px dan tinggi 88px. `medium` – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. `high` – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 480px dan tinggi 360px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
`subscriberSnippet.thumbnails.(key).url`	`string` URL gambar.
`subscriberSnippet.thumbnails.(key).width`	`unsigned integer` Lebar gambar.
`subscriberSnippet.thumbnails.(key).height`	`unsigned integer` Tinggi gambar.