Untuk mendiskusikan dan memberikan masukan tentang produk kami, bergabunglah ke channel Discord Google Ads resmi di server Komunitas Iklan dan Pengukuran Google.

Halaman ini diterjemahkan oleh Cloud Translation API.

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 serta 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 tiga tingkat akses berbeda yang tercantum dalam urutan di tabel. Jika Anda belum memiliki akses Google Ads API, Anda dapat memulai dengan mendaftar untuk mendapatkan akses akun pengujian. Anda dapat meningkatkan tingkat akses dengan menyelesaikan beberapa langkah tambahan di aplikasi.

Tingkat akses	Dapat mengakses...	Batas operasi harian¹	Terapkan
Akses Akun Pengujian	Akun pengujian	15.000 operasi / hari	Petunjuk
Akses Dasar	Akun pengujian dan produksi	15.000 operasi / hari	Petunjuk
Akses Standar	Akun pengujian dan produksi	Operasi tidak terbatas / hari	Petunjuk

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

Akses Akun Pengujian

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

Cara mengajukan permohonan Akses Akun Pengujian

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

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. Langkah ini cukup untuk sebagian besar developer.

Cara mengajukan permohonan Akses Dasar

Jika Anda memiliki token developer dengan tingkat Akses Akun Percobaan dan ingin mengajukan permohonan akses akun produksi, isi formulir permohonan Akses Dasar. Pastikan Anda telah menyelesaikan langkah-langkah berikut:

Pastikan Anda sudah memiliki token developer dengan tingkat Akses Akun Uji.
Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda harus login ke akun pengelola untuk melihat pusat API. Anda tidak akan dapat menyelesaikan proses permohonan tanpa alamat email yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads aktif ke akun pengelola dengan token API.

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.

Terlepas dari tingkat akses, semua operasi API tunduk pada batas frekuensi sistem. Untuk mempelajari lebih lanjut cara menangani error batas kapasitas, lihat Jenis error.

Cara mengajukan permohonan Akses Standar

Jika Anda memiliki token developer dengan tingkat Akses Dasar dan ingin mengajukan permohonan untuk operasi Google Ads API tanpa batas, isi formulir permohonan Akses Standar.

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

Penggunaan yang diizinkan

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

Penggunaan yang Diizinkan	Deskripsi
Pembuatan / pengelolaan iklan	Memberikan akses ke semua layanan API untuk membuat dan mengelola kampanye, grup iklan, iklan, dan kata kunci Google Ads.
Pelaporan	Hanya lakukan permintaan `GoogleAdsService.Search` atau `GoogleAdsService.SearchStream`, atau panggilan hanya baca. Hal ini ditujukan bagi developer yang hanya menggunakan API untuk meminta statistik.
Meneliti kata kunci dan rekomendasi	Izinkan token mengakses RecommendationService, KeywordPlanIdeaService, dan KeywordPlanService. Ini hanya digunakan oleh alat yang memerlukan saran untuk membantu memfasilitasi pembuatan dan pengelolaan kampanye Google Ads.

Cara mengubah penggunaan yang diizinkan

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