Subscriptions

Resource subscription berisi informasi tentang langganan pengguna YouTube. Langganan memberi tahu pengguna saat video baru 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 mendukung metode berikut untuk resource subscriptions:

list
Menampilkan resource langganan yang cocok dengan kriteria permintaan API. Coba sekarang.
masukkan
Menambahkan subscription untuk channel pengguna yang diautentikasi. Coba sekarang.
hapus
Menghapus langganan. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan 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 menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah 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 judulnya dan saluran langganan pengguna.
snippet.publishedAt datetime
Tanggal dan waktu saat langganan dibuat. Nilai ditetapkan dalam format ISO 8601.
snippet.channelTitle string
Judul channel yang mencakup langganan.
snippet.title string
Judul langganan.
snippet.description string
Detail langganan.
snippet.resourceId object
Objek id berisi informasi tentang channel yang disubscribe pengguna.
snippet.resourceId.kind string
Jenis resource API.
snippet.resourceId.channelId string
Nilai yang digunakan YouTube untuk mengidentifikasi channel yang dibuat pengguna secara unik.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel subscriber secara unik. Objek resource_id mengidentifikasi saluran yang disubscribe pengguna.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan langganan. Untuk setiap objek di 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 resource yang merujuk pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel adalah lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi gambar thumbnail yang beresolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px.
  • high – Versi thumbnail dengan resolusi tinggi. Untuk video (atau resource 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 ditunjuk langganan.
contentDetails.newItemCount unsigned integer
Jumlah item baru dalam langganan sejak kontennya terakhir dibaca.
contentDetails.activityType string
Jenis aktivitas 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 resource yang merujuk pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel adalah lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi gambar thumbnail yang beresolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px.
  • high – Versi thumbnail dengan resolusi tinggi. Untuk video (atau resource 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.