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 empat tingkat akses token developer yang berbeda dan tercantum dalam tabel secara berurutan. Jika belum memiliki akses Google Ads API, Anda dapat memulai dengan mendaftar untuk mendapatkan token developer dengan tingkat Akses Akun Percobaan. Anda dapat meningkatkan tingkat akses dengan menyelesaikan beberapa langkah tambahan dalam aplikasi.
| Tingkat akses | Dapat mengakses... | Batas operasi harian1 | Cara mendaftar | Berapa lama biasanya peninjauan berlangsung? |
|---|---|---|---|---|
| Tingkat Akses Akun Percobaan | Akun percobaan | 15.000 operasi / hari | Petunjuk | |
| Tingkat Akses Penjelajah | Akun percobaan dan produksi | 2.880 operasi / hari untuk akun produksi 15.000 operasi / hari untuk akun percobaan |
Petunjuk | |
| Tingkat Akses Dasar | Akun percobaan dan produksi | 15.000 operasi / hari untuk akun percobaan dan produksi | Petunjuk | 5 hari kerja |
| Tingkat Akses Standar | Akun percobaan dan produksi | Operasi tidak terbatas / hari untuk akun percobaan dan produksi | Petunjuk | 10 hari kerja |
1 "Per hari" didasarkan pada periode waktu 24 jam yang bergeser dan digunakan untuk membuat permintaan API dengan token developer Anda. Aplikasi Anda akan menerima error jika melebihi batas permintaan untuk tingkat akses Anda dalam 24 jam terakhir.
Tingkat Akses Akun Percobaan
Setelah menyelesaikan pendaftaran awal untuk Google Ads API, Anda akan mendapatkan token developer dengan tingkat Akses Akun Percobaan. Artinya, token developer hanya dapat membuat permintaan Google Ads API terhadap akun percobaan.
Cara mendaftar untuk tingkat Akses Akun Percobaan
Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads untuk otomatis mendapatkan tingkat Akses Akun Percobaan.
Tingkat Akses Penjelajah
Setelah Anda menyelesaikan pendaftaran awal untuk Google Ads API, Google dapat otomatis mengupgrade token developer Anda dari tingkat Akses Akun Percobaan ke tingkat Akses Penjelajah dalam beberapa kasus. Tingkat Akses Penjelajah 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 Penjelajah memungkinkan token developer menjalankan hingga 2.880 operasi per hari terhadap akun produksi. Jumlah ini cukup bagi sebagian besar developer untuk mulai menggunakan API dan membuat otomatisasi dasar.
Tingkat Akses Penjelajah membatasi akses ke fitur berikut. Jika perlu menggunakan fitur ini, Anda harus mendaftar untuk tingkat Akses Dasar atau tingkat Akses Standar.
| Fungsi yang Dibatasi | Layanan dan Metode yang Dibatasi |
|---|---|
| Pembuatan akun | CustomerService.CreateCustomerClient |
| Pengelolaan pengguna | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Perencanaan |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Penagihan dan Pembayaran Akun |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Cara mendaftar untuk tingkat Akses Penjelajah
Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads. Dalam beberapa kasus, Google dapat otomatis mengupgrade token developer Anda ke tingkat Akses Penjelajah 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. Jumlah ini cukup bagi sebagian besar developer.
Cara mendaftar untuk tingkat Akses Dasar
Jika memiliki token developer dengan tingkat Akses Akun Percobaan atau Akses Penjelajah, Anda dapat mendaftar untuk tingkat Akses Dasar sebagai berikut:
Buka Pusat API di browser web Anda. Login ke akun pengelola Google Ads Anda jika diminta.
Pastikan Tingkat akses Anda adalah Akun Percobaan atau Penjelajah.
Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda tidak akan dapat menyelesaikan proses pendaftaran tanpa alamat email yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads aktif ke akun pengelola Google Ads dengan token API.
Klik panah drop-down di samping Tingkat akses, lalu klik link Daftar untuk Akses Dasar.
Menyelesaikan verifikasi merek project Google Cloud
Google Ads API menggunakan status verifikasi merek project Google Cloud yang terkait dengan token developer saat meninjau aplikasi untuk tingkat Akses Dasar. Anda dapat menyelesaikan proses verifikasi merek di project Google Cloud untuk mempercepat proses peninjauan aplikasi akses dasar Anda. Dalam beberapa kasus, Google juga dapat meminta Anda menyelesaikan verifikasi merek di project Google Cloud sebagai prasyarat untuk memproses aplikasi akses dasar Anda. Lihat panduan verifikasi merek untuk mempelajari lebih lanjut.
Tingkat Akses Standar
Tingkat Akses Standar memungkinkan token developer menjalankan operasi dalam jumlah 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 tingkat Akses Standar, lihat Kuota
API.
Tingkat Akses Standar hanya diberikan kepada developer yang memerlukan operasi Google Ads API tidak terbatas, seperti perusahaan besar atau alat yang melayani banyak pengguna.
Cara mendaftar untuk tingkat Akses Standar
Jika memiliki token developer dengan tingkat Akses Dasar, Anda dapat mendaftar untuk tingkat Akses Standar sebagai berikut:
Buka Pusat API di browser web Anda. Login ke akun pengelola Google Ads Anda jika diminta.
Pastikan Tingkat akses Anda adalah Dasar.
Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda tidak akan dapat menyelesaikan proses pendaftaran tanpa alamat email yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads aktif ke akun pengelola Google Ads dengan token API.
Klik panah drop-down di samping Tingkat akses, lalu klik link Daftar untuk 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 Diwajibkan.
Kuota API dan batas kapasitas sistem
Terlepas dari tingkat aksesnya, 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 kapasitas, 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 penggunaan Google Ads API yang dimaksudkan. Izin ini menentukan fitur API yang dapat digunakan oleh 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 membuat permintaan GoogleAdsService.Search
atau GoogleAdsService.SearchStream
atau panggilan hanya baca. Hal ini ditujukan untuk developer yang hanya menggunakan API untuk
meminta statistik.
|
| Meneliti kata kunci dan rekomendasi | Mengizinkan token developer mengakses RecommendationService,
KeywordPlanIdeaService,
dan KeywordPlanService.
Hal 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 tingkat Akses Standar, Anda dapat mengisi formulir pendaftaran untuk memperbarui penggunaan yang diizinkan. Isi formulir pendaftaran jika Anda ingin memperbarui penggunaan yang diizinkan atau memberikan akses ke alat Anda kepada klien.