Tingkat Akses dan Penggunaan yang Diizinkan

Setiap token developer Google Ads API diberi tingkat akses dan "penggunaan yang diizinkan". Tingkat akses menentukan apakah Anda dapat memengaruhi akun produksi dan jumlah operasi dan permintaan yang dapat Anda jalankan setiap hari. Penggunaan yang diizinkan menentukan fitur Google Ads API tertentu yang diizinkan untuk digunakan oleh token developer.

Tingkat akses

Ada empat tingkat akses token developer yang berbeda yang tercantum dalam urutan di tabel. Jika belum memiliki akses Google Ads API, Anda dapat memulai dengan mendaftar untuk mendapatkan token developer dengan tingkat Akses Akun Uji. Anda dapat meningkatkan tingkat akses dengan menyelesaikan beberapa langkah tambahan di aplikasi.

¹ "Per hari" didasarkan pada periode waktu 24 jam yang berubah-ubah saat permintaan API dibuat dengan token developer Anda. Aplikasi Anda akan menerima error jika melebihi batas permintaan untuk tingkat akses Anda dalam 24 jam terakhir.

Tingkat Akses Akun Uji

Setelah menyelesaikan pendaftaran awal untuk Google Ads API, Anda akan diberi token developer dengan tingkat Akses Akun Uji Coba. Artinya, token developer hanya dapat membuat permintaan Google Ads API terhadap akun percobaan.

Cara mengajukan permohonan tingkat Akses Akun Uji

Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads agar otomatis diberi tingkat Akses Akun Pengujian.

Tingkat Akses Penjelajah

Setelah Anda menyelesaikan pendaftaran awal untuk Google Ads API, Google dapat mengupgrade token developer Anda secara otomatis dari tingkat Akses Akun Uji Coba ke tingkat Akses Explorer dalam beberapa kasus. Tingkat akses Explorer memungkinkan token developer membuat permintaan Google Ads API terhadap akun percobaan dan akun produksi. Akun produksi adalah akun yang menayangkan iklan Google yang sebenarnya dan aktif—akun percobaan tidak menayangkan iklan.

Tingkat Akses Explorer memungkinkan token developer menjalankan hingga 2.880 operasi per hari terhadap akun produksi. Hal ini sudah cukup bagi sebagian besar developer untuk mulai menggunakan API dan membangun otomatisasi dasar.

Tingkat Akses Explorer membatasi akses ke fitur berikut. Jika Anda perlu menggunakan fitur ini, Anda harus mengajukan permohonan untuk Tingkat Akses Dasar atau Tingkat Akses Standar.

Cara mengajukan permohonan tingkat akses Explorer

Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads. Dalam beberapa kasus, Google dapat otomatis mengupgrade token developer Anda ke tingkat Akses Explorer setelah Anda menyelesaikan pendaftaran.

Tingkat Akses Dasar

Tingkat Akses Dasar memungkinkan token developer membuat permintaan Google Ads API terhadap akun percobaan dan akun produksi. Akun produksi adalah akun yang menayangkan iklan Google yang sebenarnya dan aktif—akun percobaan tidak menayangkan iklan.

Tingkat Akses Dasar memungkinkan token developer menjalankan hingga 15.000 operasi per hari. Hal ini sudah cukup untuk sebagian besar developer.

Cara mengajukan permohonan tingkat Akses Dasar

Jika memiliki token developer dengan tingkat Akses Akun Pengujian atau Akses Explorer, Anda dapat mengajukan permohonan tingkat Akses Dasar sebagai berikut:

1. Buka https://ads.google.com/aw/apicenter di browser web Anda. Login ke akun pengelola Google Ads Anda jika diminta.

   Akses Pusat API

2. Verifikasi bahwa Tingkat akses Anda adalah Akun Pengujian atau Penjelajah.

3. Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda tidak akan dapat menyelesaikan proses permohonan tanpa alamat email yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads yang aktif ke akun pengelola Google Ads dengan token API.

4. Klik panah drop-down di samping Tingkat akses, lalu klik link Ajukan permohonan Akses Dasar.

Tingkat Akses Standar

Tingkat Akses Standar memungkinkan token developer menjalankan operasi dalam jumlah tak terbatas per hari untuk sebagian besar layanan. Hal ini mencakup, tetapi tidak terbatas pada GoogleAdsService Search dan SearchStream. Untuk mengetahui detail selengkapnya tentang batas dan pengecualian pada tingkat Akses Standar, lihat kuota API.

Tingkat Akses Standar hanya diberikan kepada developer yang memerlukan operasi Google Ads API tanpa batas, seperti perusahaan besar atau alat yang melayani banyak pengguna.

Cara mengajukan permohonan tingkat Akses Standar

Jika memiliki token developer dengan tingkat Akses Dasar, Anda dapat mengajukan permohonan tingkat Akses Standar sebagai berikut:

1. Buka https://ads.google.com/aw/apicenter di browser web Anda. Login ke akun pengelola Google Ads Anda jika diminta.

   Akses Pusat API

2. Pastikan Tingkat akses Anda adalah Dasar.

3. Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda tidak akan dapat menyelesaikan proses permohonan tanpa alamat email yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads yang aktif ke akun pengelola Google Ads dengan token API.

4. Klik panah drop-down di samping Tingkat akses, lalu klik link Ajukan Permohonan Akses Standar.

Jika alat Anda digunakan oleh pengguna eksternal, bersiaplah untuk memberikan akses login demo ke alat Anda. Perhatikan bahwa alat Anda harus mematuhi Fungsi Minimum yang Diperlukan.

Kuota API dan batas kapasitas sistem

Terlepas dari tingkat akses, semua operasi API tunduk pada batas kapasitas sistem, yang membatasi jumlah operasi yang dapat Anda lakukan dalam jangka waktu tertentu, yaitu jumlah operasi per jam. Untuk mempelajari lebih lanjut cara menangani error batas kecepatan, lihat jenis error.

Setiap layanan dapat menerapkan batasan dan pembatasan kuota tambahan karena alasan seperti batasan desain produk, pembatasan kebijakan produk, pertimbangan performa dan latensi API. Lihat dokumentasi tentang kuota API untuk mempelajari lebih lanjut batasan ini.

Penggunaan yang diizinkan

Penggunaan yang diizinkan hanya berlaku untuk token developer dengan tingkat Akses Dasar dan Akses Standar. Penggunaan yang diizinkan dialokasikan berdasarkan tujuan penggunaan Google Ads API. Izin ini menentukan fitur API mana yang dapat digunakan untuk token developer, seperti yang dijelaskan dalam tabel berikut:

Cara mengubah penggunaan yang diizinkan

Jika token developer Anda telah disetujui untuk tingkat Akses Dasar atau tingkat Akses Standar, Anda dapat mengisi permohonan untuk memperbarui penggunaan yang diizinkan. Isi formulir permohonan jika Anda ingin memperbarui penggunaan yang diizinkan atau memberikan akses klien ke alat Anda.