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 yang berbeda yang tercantum secara berurutan dalam tabel. Jika 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 harian1 | Terapkan |
|---|---|---|---|
| Menguji akses akun | 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 / hari tanpa batas | Petunjuk |
1 "Per hari" didasarkan pada jangka waktu 24 jam yang bergeser 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.
Menguji akses akun
Setelah menyelesaikan pendaftaran awal untuk Google Ads API, Anda akan diberi token developer dengan tingkat akses akun percobaan. Artinya, token developer hanya dapat membuat permintaan Google Ads API terhadap akun percobaan.
Mengajukan permohonan akses akun pengujian
Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads untuk otomatis diberi tingkat akses akun pengujian.
Akses dasar
Akses dasar memungkinkan token developer membuat permintaan Google Ads API terhadap akun percobaan dan akun produksi. Akun produksi adalah akun apa pun yang menayangkan iklan Google sungguhan dan aktif—akun pengujian tidak menayangkan iklan.
Tingkat akses dasar memungkinkan token developer menjalankan hingga 15.000 operasi per hari. Hal ini cukup untuk sebagian besar developer.
Mengajukan permohonan Akses dasar
Jika Anda memiliki token developer 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 pengujian.
- 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 yang aktif ke akun pengelola dengan token API.
Akses standar
Akses standar memungkinkan token developer menjalankan operasi dalam jumlah ilimitado 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 untuk 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 kecepatan sistem. Untuk mempelajari lebih lanjut cara menangani error pembatasan kapasitas, lihat Jenis error.
Mengajukan permohonan Akses standar
Jika saat ini Anda memiliki 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 akses dasar dan token akses standar. Penggunaan yang diizinkan dialokasikan berdasarkan penggunaan Google Ads API yang dimaksudkan. Izin ini menentukan fitur API mana yang dapat digunakan token, 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 buat permintaan GoogleAdsService.Search
atau GoogleAdsService.SearchStream, atau panggilan hanya baca. Ini ditujukan untuk 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. |
Mengubah penggunaan yang diizinkan
Jika telah disetujui untuk tingkat akses dasar atau tingkat akses standar, Anda dapat mengisi permohonan untuk memperbarui penggunaan yang diizinkan. Isi formulir jika Anda ingin memperbarui penggunaan yang diizinkan atau memberikan akses ke alat kepada klien.