Catatan Rilis

Halaman ini menyediakan catatan rilis untuk AdSense Management API.

Versi 2

Versi ini memperkenalkan perubahan berikut untuk menghapus fungsi yang tidak digunakan lagi dan untuk menyesuaikan AdSense Management API dengan standar Google API saat ini. Sesuai dengan skema pembuatan versi Google API, versi ini akan diupdate dari waktu ke waktu untuk menyertakan fungsi tambahan (kompatibel dengan versi sebelumnya), bukan fungsi baru yang dirilis dalam versi minor terpisah.

2024-04-03

PolicyIssues

  • Menambahkan koleksi baru untuk melaporkan pelanggaran kebijakan dan peringatan yang ada untuk akun.

2023-06-19

Pembayaran

  • payments.list kini menampilkan detail pembayaran untuk penayang premium.

2023-06-13

Laporan

  • Menambahkan metrik FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS, dan FUNNEL_RPM, yang memberikan informasi tentang performa unit non-iklan (misalnya, unit penelusuran terkait).

2023-03-30

Laporan

  • Menambahkan dimensi PAGE_URL, yang memungkinkan metrik untuk dikelompokkan berdasarkan URL halaman (dengan beberapa peringatan, lihat Pengelompokan URL Halaman).

2022-09-21

AdUnits

  • Menambahkan metode create dan patch. Perhatikan bahwa metode ini hanya dapat digunakan oleh project yang diaktifkan untuk produk AdSense untuk Platform.

CustomChannels

  • Menambahkan metode pembuatan, patch, dan update. Perhatikan bahwa metode ini hanya dapat digunakan oleh project yang diaktifkan untuk produk AdSense untuk Platform.
  • Menambahkan kolom aktif ke resource.

Akun

  • Menambahkan metode getAdBlockingRecoveryTag.

2022-08-25

Laporan

  • Menambahkan dimensi HOSTED_AD_CLIENT_ID, yang memungkinkan penayang host dan platform mengelompokkan metrik berdasarkan akun penayang (penayang host) dan menurut sub-akun (penayang platform).

2022-05-03

AdClient

  • Menambahkan metode get.

Laporan

  • Menambahkan metode getSaved.

UrlChannels

  • Menambahkan metode get.

2022-03-31

Akun

AdClient

2022-02-24

Pembayaran

  • Format nama resource telah diperluas guna mendukung resource terpisah untuk penghasilan YouTube. Perubahan ini dilakukan sebelum peluncuran bertahap pengalaman AdSense yang ditingkatkan untuk kreator YouTube, di mana penghasilan YouTube akan dipisahkan ke akun pembayarannya sendiri. Informasi pembayaran YouTube juga akan ditampilkan dari metode daftar pembayaran, setelah Anda memiliki akun pembayaran khusus untuk penghasilan YouTube. Penghasilan YouTube akan memiliki format nama resource berikut:
    • accounts/{account}/payments/youtube-unpaid untuk penghasilan YouTube yang belum dibayar (saat ini).
    • accounts/{account}/payments/youtube-yyyy-MM-dd untuk penghasilan YouTube berbayar.

    Catatan: Nama resource untuk penghasilan AdSense tidak berubah:
    • accounts/{account}/payments/belum dibayar untuk penghasilan AdSense yang belum dibayar (saat ini).
    • accounts/{account}/payments/yyyy-MM-dd untuk penghasilan AdSense berbayar.

2021-06-30

Laporan

  • Menambahkan dimensi AD_FORMAT_NAME dan AD_FORMAT_CODE, yang menunjukkan cara iklan ditampilkan kepada pengguna di situs Anda (dalam halaman, vinyet, dll.). Perhatikan bahwa v1.4 memiliki dimensi (tidak digunakan lagi) dengan nama yang sama, tetapi anggotanya berbeda; kedua dimensi yang ditambahkan pada v2 berbeda dengan dimensi yang ada pada v1.4.

19-04-2021 (Rilis awal)

Umum

  • Semua metode yang tidak digunakan lagi di v1.4 telah dihapus. Ini mencakup metode resource yang tidak memerlukan accountId. Pada v2, accountId ditentukan dalam kolom parent.
  • Sesuai standar Google API, resource kini diidentifikasi oleh kolom name. Misalnya, nama AdClient akan terlihat seperti accounts/{accountId}/adclients/{adClientId}. Selain itu, pada v1.4, ID resource digunakan sebagai dimensi pelaporan, tetapi di v2, nilai tersebut kini tersedia melalui kolom reporting_dimension_id pada beberapa resource.
  • Kolom kind telah dihapus dari semua resource.

Akun

  • Kolom name telah diubah menjadi display_name.
  • Kolom timezone telah diubah dari string menjadi google.type.TimeZone.
  • Kolom creation_time (jenis int64) telah diubah menjadi create_time (jenis google.protobuf.Timestamp).
  • Menambahkan kolom pending_tasks yang merupakan daftar tugas yang belum selesai dan harus diselesaikan sebagai bagian dari proses pendaftaran untuk akun baru. Misalnya, tugas dapat terkait dengan profil penagihan atau verifikasi telepon Anda.
  • Kolom sub_accounts telah dihapus. Fungsi serupa dapat dicapai di v2 dengan metode kustom listChildAccounts. Hierarki akun turunan yang lengkap dapat dibuat di v2 dengan memanggil listChildAccounts secara rekursif.

AdClient

  • Menghapus kolom arc_opt_in karena sudah dihapus dari UI AdSense.
  • Kolom supports_reporting diganti dengan kolom reporting_dimension_id, yang mewakili ID unik klien iklan seperti yang digunakan dalam dimensi pelaporan AD_CLIENT_ID. Jika reporting_dimension_id kosong, berarti AdClient tidak mendukung pelaporan.

AdUnit

  • Nama kolom status telah diganti menjadi state. Selain itu, status ACTIVE tidak lagi menunjukkan apakah sudah ada aktivitas di unit iklan ini dalam tujuh hari terakhir. Di v2, artinya unit iklan telah diaktifkan oleh pengguna dan dapat menayangkan iklan.
  • Kolom code telah dihapus. Nilai ini masih dapat ditemukan di akhir kolom name (setelah garis miring terakhir).
  • Kolom contentAdsSettings.backupOption telah dihapus.
  • Kolom type telah dibatasi untuk nilai TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT, dan LINK.
  • Kolom lain yang telah dihapus di UI AdSense juga akan dihapus: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Notifikasi

  • Metode delete telah dihapus.
  • Kolom is_dismissible telah dihapus.
  • Nama kolom locale telah diganti menjadi language_code.

CustomChannel

  • Kolom code telah dihapus. Nilai ini masih dapat ditemukan di akhir kolom name (setelah garis miring terakhir).
  • Kolom targeting_info telah dihapus karena sudah dihapus dari UI AdSense.

Pembayaran

  • Kolom payment_date telah diganti namanya menjadi date dan diubah dari string jenis menjadi jenis google.type.Date.
  • Kolom payment_amount dan kolom payment_amount_currency_code telah digabungkan menjadi satu kolom payment (mis., "¥1.235 JPY", "$1.234,57", "£87,65").

Laporan

  • Dengan v2, data pelaporan AdSense Management API kini selaras dengan UI AdSense. Artinya, properti AdMob dan YouTube tidak lagi didukung. Selain itu, API ini hanya akan mendukung data laporan hingga 3 tahun ke belakang.
  • Resource Metadata.dimensions dan resource Metadata.metrics telah dihapus.
  • Metode baru telah ditambahkan untuk membuat laporan versi CSV, yang menggantikan parameter kueri di v1.4. Catatan: untuk kompresi, Anda masih dapat menggunakan header HTTP "Accept-Encoding: gzip".
  • Beberapa kolom telah diubah pada pembuatan laporan ad-hoc.
    • Nama kolom account_id telah diganti menjadi account.
    • Nama kolom dimension telah diganti menjadi dimensions.
    • Nama kolom metric telah diganti menjadi metrics.
    • Nama kolom filter telah diganti menjadi filters.
    • Nama kolom sort telah diganti menjadi order_by.
    • Nama kolom locale telah diganti menjadi language_code.
    • Nama kolom currency telah diganti menjadi currency_code.
    • Anda kini dapat menentukan beberapa rentang umum dengan date_range (misalnya, TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS, dan LAST_30_DAYS), atau Anda dapat menentukan start_date dan end_date dengan menetapkan date_range ke CUSTOM.
    • Kolom start_date dan end_date telah diubah dari string jenis menjadi jenis google.type.Date. Catatan: sebagai hasilnya, kata kunci tanggal relatif (mis., "today-6d") tidak lagi didukung.
    • Kolom boolean use_timezone_reporting telah diganti dengan reporting_time_zone, yang dapat memiliki salah satu dari dua nilai: ACCOUNT_TIME_ZONE atau GOOGLE_TIME_ZONE (yang berarti PST/PDT). Default pada v2 adalah ACCOUNT_TIME_ZONE, yang berbeda dengan default pada v1.4.
    • Kolom start_index telah dihapus.
    • Nama kolom max_results telah diganti menjadi limit.
  • Beberapa kolom telah diubah pada pembuatan laporan tersimpan.
    • Menambahkan kolom tanggal (date_range, start_date, end_date, reporting_time_zone).
    • Menambahkan kolom currency_code.
    • Nama kolom locale telah diganti menjadi language_code.
    • Kolom start_index telah dihapus.
    • Kolom max_results telah dihapus.

SavedAdStyle

  • SavedAdStyle telah dihapus karena telah dihapus dari UI AdSense.

Situs

  • Sites telah ditambahkan untuk mengambil data tentang situs yang telah Anda tambahkan ke akun AdSense Anda.
  • Kolom state menunjukkan apakah situs memiliki status berikut: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
  • Kolom auto_ads_enabled adalah boolean yang menunjukkan apakah iklan otomatis telah diaktifkan di situs tertentu.

Versi 1.4

Versi ini memperkenalkan fungsi berikut:

  • Kini Anda dapat mencantumkan pembayaran akun AdSense dalam mata uang yang sesuai.
  • Sekarang Anda dapat menutup pemberitahuan dengan memanggil metode delete yang akan menyembunyikan pemberitahuan di antarmuka web API dan AdSense.
  • Respons laporan kini menyertakan tanggal mulai dan akhir. Hal ini penting jika Anda menggunakan tanggal relatif saat membuat laporan (seperti today, yesterday, firstDayOfMonth-1m), respons sekarang mencakup rentang tanggal yang Anda minta.

Masalah Umum

Kolom currency dalam laporan tidak didukung dalam rilis ini.

Versi 1.3

Versi ini memperkenalkan fungsi berikut:

  • Kemampuan untuk mengambil pemberitahuan.
  • Kemampuan untuk mengambil metadata dimensi dan metrik.
  • Kemampuan untuk menjalankan laporan dalam zona waktu lokal akun.

Masalah Umum

Kolom currency dalam laporan tidak didukung dalam rilis ini.

Versi 1.2

Versi ini memperkenalkan fungsi berikut:

  • Kemampuan untuk mengambil gaya iklan.
  • Kemampuan untuk mengambil dan menjalankan laporan tersimpan yang ditentukan di frontend.

Masalah Umum

Kolom currency dalam laporan tidak didukung dalam rilis ini.

Versi 1.1

Versi ini memperkenalkan fungsi berikut:

  • Kemampuan untuk mencantumkan akun yang dapat diakses pengguna
  • Kemampuan untuk melakukan panggilan GET pada akun tertentu
  • Kemampuan untuk melakukan panggilan GET di unit iklan dan saluran khusus
  • Kemampuan untuk menentukan hubungan antara unit iklan dan saluran khusus
  • Saluran khusus berisi lebih banyak data tentang informasi penargetan

Selain itu, Anda sekarang dapat mengakses data baik dalam akun default Anda atau dengan akun tertentu.

Masalah Umum

Kolom currency dalam laporan tidak didukung dalam rilis ini.

Versi 1

Versi ini adalah rilis pertama API. Fitur ini mencakup dukungan untuk mengambil klien iklan, unit iklan, saluran khusus, saluran URL, serta menjalankan laporan.

Masalah Umum

Kolom currency dalam laporan tidak didukung dalam rilis ini.