Halaman ini diterjemahkan oleh Cloud Translation API.

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 menyelaraskan AdSense Management API dengan standar Google API saat ini. Sesuai dengan skema pemberian versi Google API, versi ini akan diupdate dari waktu ke waktu untuk menyertakan fungsi tambahan (yang kompatibel dengan versi sebelumnya) daripada fungsi baru yang dirilis dalam versi minor terpisah.

2025-10-02

Laporan

Menambahkan dimensi TRAFFIC_SOURCE, yang memungkinkan metrik dikelompokkan menurut sumber traffic (mis. "Google", "Bing", "Facebook", "Lainnya"). Untuk mengetahui informasi selengkapnya, lihat Pengelompokan sumber traffic.

2025-05-06

PolicyIssues

Kolom policyTopics[].must_fix yang tidak digunakan lagi (lihat update sebelumnya) kini akan selalu ditetapkan ke false.

2025-02-24

PolicyIssues

Menambahkan kolom policyTopics[].type untuk mengidentifikasi apakah topik kebijakan mewakili masalah kebijakan, masalah peraturan, atau preferensi pengiklan. Hal ini menggantikan policyTopics[].must_fix, yang kini ditandai sebagai kolom yang tidak digunakan lagi.

2024-04-03

PolicyIssues

Menambahkan koleksi baru untuk melaporkan pelanggaran dan peringatan kebijakan saat ini yang ada untuk suatu akun.

2023-06-19

Pembayaran

payments.list kini menampilkan detail tentang 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 dikelompokkan menurut URL halaman (dengan beberapa peringatan, lihat Pengelompokan URL halaman).

2022-09-21

AdUnits

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

CustomChannels

Menambahkan metode pembuatan, penambalan, dan pembaruan. 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 penerbit host dan platform mengelompokkan metrik menurut akun penayang (penerbit host) dan menurut sub-akun (penerbit platform).

2022-05-03

AdClient

Menambahkan metode get.

Laporan

Menambahkan metode getSaved.

UrlChannels

Menambahkan metode get.

2022-03-31

Akun

Akun yang tidak aktif kini ditampilkan oleh API, dengan kolom state yang menunjukkan status akun.

AdClient

Mirip dengan Perubahan akun, klien iklan yang tidak aktif kini ditampilkan oleh API, dengan kolom state yang menunjukkan status klien iklan.

2022-02-24

Pembayaran

Format nama resource telah diperluas untuk mendukung resource terpisah untuk penghasilan YouTube. Perubahan ini dilakukan sebelum peluncuran bertahap pengalaman AdSense yang lebih baik untuk kreator YouTube, yang 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 tetap tidak berubah:
- accounts/{account}/payments/unpaid untuk penghasilan AdSense (saat ini) yang belum dibayar.
- accounts/{account}/payments/yyyy-MM-dd untuk penghasilan AdSense yang dibayar.

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 anggota yang berbeda; dua dimensi yang ditambahkan di v2 berbeda dengan dimensi yang ada di v1.4.

19-04-2021 (Rilis awal)

Umum

Semua metode yang tidak digunakan lagi di v1.4 telah dihapus. Hal ini mencakup metode resource yang tidak memerlukan accountId. Di v2, accountId ditentukan di kolom parent.
Sesuai dengan standar Google API, resource kini diidentifikasi oleh kolom name. Misalnya, nama AdClient akan terlihat seperti accounts/{accountId}/adclients/{adClientId}. Selain itu, di v1.4, ID resource digunakan sebagai dimensi pelaporan, tetapi di v2, nilai tersebut kini tersedia melalui kolom reporting_dimension_id di 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. Seluruh hierarki akun turunan dapat dibuat di v2 dengan memanggil listChildAccounts secara rekursif.

AdClient

Menghapus kolom arc_opt_in karena telah 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.

UnitIklan

Kolom status telah diganti namanya menjadi state. Selain itu, status ACTIVE tidak lagi menunjukkan apakah 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 ke nilai TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT, dan LINK.
Kolom lain yang telah dihapus di UI AdSense juga dihapus: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Notifikasi

Metode delete telah dihapus.
Kolom is_dismissible telah dihapus.
Kolom locale telah diganti namanya 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 jenis string menjadi jenis google.type.Date.
Kolom payment_amount dan kolom payment_amount_currency_code telah digabungkan menjadi satu kolom payment (misalnya, "¥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 hanya akan mendukung data laporan yang sudah ada sejak 3 tahun lalu.
Resource Metadata.dimensions dan resource Metadata.metrics telah dihapus.
Metode baru telah ditambahkan untuk membuat laporan versi CSV, menggantikan parameter kueri di v1.4. Catatan: untuk kompresi, Anda tetap dapat menggunakan header HTTP "Accept-Encoding: gzip".
Beberapa kolom telah diubah pada pembuatan laporan ad hoc.
- Kolom account_id telah diganti namanya menjadi account.
- Kolom dimension telah diganti namanya menjadi dimensions.
- Kolom metric telah diganti namanya menjadi metrics.
- Kolom filter telah diganti namanya menjadi filters.
- Kolom sort telah diganti namanya menjadi order_by.
- Kolom locale telah diganti namanya menjadi language_code.
- Kolom currency telah diganti namanya 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 menyetel date_range ke CUSTOM.
- Kolom start_date dan end_date telah diubah dari jenis string menjadi jenis google.type.Date. Catatan: sebagai hasilnya, kata kunci tanggal relatif (misalnya, "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 di v2 adalah ACCOUNT_TIME_ZONE, yang berbeda dengan default di v1.4.
- Kolom start_index telah dihapus.
- Kolom max_results telah diganti namanya 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.
- Kolom locale telah diganti namanya menjadi language_code.
- Kolom start_index telah dihapus.
- Kolom max_results telah dihapus.

SavedAdStyle

SavedAdStyle telah dihapus karena sudah 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 berada dalam salah satu 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.