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 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

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

AdClient

Serupa dengan perubahan Akun di atas, 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 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.