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 diperbarui dari waktu ke waktu untuk menyertakan fungsi tambahan (kompatibel dengan versi sebelumnya) dan bukan fungsi baru yang dirilis dalam versi minor terpisah.

2025-02-24

PolicyIssues

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

2024-04-03

PolicyIssues

Menambahkan koleksi baru untuk melaporkan pelanggaran kebijakan dan peringatan saat ini yang ada untuk 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 pengecualian, 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, 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 menurut akun penayang mereka (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 untuk mendukung resource terpisah untuk penghasilan YouTube. Perubahan ini dilakukan sebelum peluncuran bertahap pengalaman AdSense yang ditingkatkan untuk kreator YouTube, yang akan memisahkan penghasilan YouTube 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 (saat ini) yang belum dibayar.
- accounts/{account}/payments/youtube-yyyy-MM-dd untuk penghasilan YouTube berbayar.
Catatan: Nama resource untuk penghasilan AdSense 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 anggotanya 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 yang perlu 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 lengkap 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, 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, ini berarti 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 depan 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 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 depan terakhir).
Kolom targeting_info telah dihapus karena telah 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 (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 berlaku 3 tahun terakhir.
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.
- 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 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 (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.
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.