FanFundingEvents

Catatan: Ini adalah pengumuman penghentian penggunaan.

Fitur Fan Funding tidak digunakan lagi, dan Fan Funding API akan dinonaktifkan pada 28 Februari 2017. Pengumuman penghentian ini bertepatan dengan rilis fitur Super Chat baru di YouTube.

Resource fanFundingEvent merepresentasikan acara Fan Funding di channel YouTube. Fan Funding menyediakan cara untuk mendukung kreator YouTube secara monetisasi. Acara Fan Funding terjadi saat pengguna melakukan pembayaran sukarela satu kali ke sebuah channel. Baca Pusat Bantuan YouTube untuk mempelajari lebih lanjut Fan Funding.

Metode

API mendukung metode berikut untuk resource fanFundingEvents:

list
Mencantumkan acara fan funding untuk sebuah channel. Permintaan API harus diotorisasi oleh pemilik saluran. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource fanFundingEvents:

{
  "kind": "youtube#fanFundingEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#fanFundingEvent.
etag etag
Etag resource ini.
id string
ID yang ditetapkan YouTube untuk mengidentifikasi peristiwa Fan Funding secara unik.
snippet object
Objek snippet berisi informasi tentang peristiwa Fan Funding.
snippet.channelId string
ID channel yang menerima pendanaan.
snippet.supporterDetails object
Detail tentang channel pendukung. Objek ini hanya ada jika pendukung mengadakan acara pendanaan untuk publik.
snippet.supporterDetails.channelId string
ID channel YouTube pendukung.
snippet.supporterDetails.channelUrl string
URL channel pendukung.
snippet.supporterDetails.displayName string
Nama tampilan channel pendukung.
snippet.supporterDetails.profileImageUrl string
URL avatar untuk channel pendukung.
snippet.commentText string
Konten teks komentar pendukung.
snippet.createdAt datetime
Tanggal dan waktu saat pendanaan terjadi. Nilai ditetapkan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros unsigned long
Jumlah uang yang dikontribusikan dalam acara pendanaan. Nilainya dalam mikro mata uang pendanaan. Misalnya, jika penyandang dana memberikan kontribusi satu dolar ($1), nilai properti snippet.amountMicros adalah 1000000.
snippet.currency string
Mata uang yang terkait dengan jumlah pendanaan. Nilainya adalah kode mata uang ISO 4217.
snippet.displayString string
String yang ditujukan untuk tampilan yang menunjukkan jumlah dan mata uang. Jika permintaan fanFundingEvents.list menentukan bahasa aplikasi dengan parameter hl, string tampilan akan dilokalkan untuk ditampilkan dalam bahasa tersebut. Misalnya, dalam bahasa Inggris, mata uang akan ditampilkan sebagai $1.50, tetapi dalam bahasa Prancis, mata uang tersebut akan ditampilkan sebagai 1,50$.