Setiap token developer Google Ads API diberi tingkat akses dan "penggunaan yang diizinkan". Tingkat akses menentukan apakah Anda dapat memengaruhi akun produksi serta jumlah operasi dan permintaan yang dapat Anda jalankan setiap hari. Penggunaan yang diizinkan menentukan fitur Google Ads API tertentu yang boleh digunakan oleh token developer.
Tingkat akses
Ada tiga tingkat akses yang berbeda yang tercantum dalam tabel. Jika belum memiliki akses Google Ads API, Anda dapat mulai 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 |
|---|---|---|---|
| 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 tanpa batas / hari | Petunjuk |
1 "Per hari" didasarkan pada pergeseran jangka waktu 24 jam 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.
Akses akun pengujian
Setelah menyelesaikan pendaftaran awal untuk Google Ads API, Anda akan diberi token developer dengan tingkat akses akun pengujian. Artinya, token developer hanya dapat membuat permintaan Google Ads API terhadap akun pengujian.
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 pengujian dan akun produksi. Akun produksi adalah akun yang menayangkan iklan Google live yang sebenarnya—akun pengujian tidak menayangkan iklan.
Tingkat akses dasar memungkinkan token developer mengeksekusi hingga 15.000 operasi per hari. Ini sudah cukup untuk sebagian besar developer.
Mengajukan permohonan untuk Akses dasar
Jika saat ini Anda memiliki token developer tingkat akses akun pengujian 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 tidak dapat menyelesaikan proses pengajuan 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 yang tidak 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 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 kapasitas 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 standar. Penggunaan yang diizinkan dialokasikan berdasarkan tujuan penggunaan Google Ads API. Izin ini menentukan fitur API mana yang dapat digunakan dengan token, seperti diuraikan dalam tabel berikut:
| Penggunaan yang Diizinkan | Deskripsi |
|---|---|
| Pembuatan / pengelolaan iklan | Menyediakan 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 adalah untuk developer yang hanya menggunakan API untuk meminta statistik.
|
| Meneliti kata kunci dan rekomendasi | Izinkan token mengakses RecommendationService, KeywordPlanIdeaService, dan KeywordPlanService. Akun 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 mendapatkan tingkat akses dasar atau tingkat akses standar, Anda dapat mengisi permohonan untuk memperbarui penggunaan yang diizinkan. Isi formulir tersebut jika Anda ingin memperbarui penggunaan yang diizinkan atau memberi klien akses ke alat Anda.