Project Google Cloud Anda 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 project.
Tingkat akses
Ada empat tingkat akses API yang berbeda yang tercantum dalam urutan di tabel. Jika belum memiliki akses Google Ads API, Anda dapat memulai dengan mengaktifkan API untuk mendapatkan tingkat Akses Akun Uji untuk project Google Cloud Anda. Anda dapat meningkatkan tingkat akses dengan menyelesaikan beberapa langkah tambahan di aplikasi.
| Tingkat akses | Dapat mengakses... | Batas operasi harian 1 | Cara mendaftar | Berapa lama biasanya proses peninjauan? |
|---|---|---|---|---|
| Tingkat Akses Akun Uji | Akun pengujian | 15.000 operasi / hari | Ajukan Permohonan Akses Akun Pengujian | |
| Tingkat Akses Penjelajah | Akun pengujian dan produksi | 2.880 operasi / hari untuk akun produksi 15.000 operasi / hari untuk akun pengujian |
Mengajukan Permohonan Akses Explorer | |
| Tingkat Akses Dasar | Akun pengujian dan produksi | 15.000 operasi / hari untuk akun pengujian dan produksi | Mendaftar untuk Akses Dasar | |
| Tingkat Akses Standar | Akun pengujian dan produksi | Operasi tidak terbatas / hari untuk akun pengujian dan produksi | Mendaftar untuk Akses Standar | 10 hari kerja |
1 "Per hari" didasarkan pada periode waktu 24 jam yang berubah-ubah saat permintaan API dilakukan dengan project Google Cloud Anda. Aplikasi Anda akan menerima error jika melebihi batas permintaan untuk tingkat akses Anda dalam 24 jam terakhir.
Tingkat akses Akun Pengujian
Setelah Anda mengaktifkan Google Ads API, project Google Cloud Anda akan diberi tingkat Akses Akun Uji. Artinya, project hanya dapat membuat permintaan Google Ads API terhadap akun percobaan.
Menerapkan tingkat akses Akun Pengujian
Aktifkan Google Ads API di project Google Cloud Anda agar otomatis diberi tingkat Akses Akun Uji untuk project Anda.
Tingkat akses penjelajah
Setelah Anda menyelesaikan pendaftaran awal untuk Google Ads API, Google dapat mengizinkan Anda mendaftar untuk tingkat akses Explorer.
Tingkat akses Explorer memungkinkan project Google Cloud Anda 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 project Google Cloud Anda 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 tingkat Akses Dasar atau tingkat Akses Standar.
| Fungsi Terbatas | Layanan dan Metode yang Dibatasi |
|---|---|
| Pembuatan akun | CustomerService.CreateCustomerClient |
| Pengelolaan pengguna | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Perencanaan | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Penagihan dan Pembayaran Akun | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Mendaftar untuk mendapatkan tingkat akses Explorer
- Buka halaman Ringkasan Google Ads API di project Google Cloud Anda.
- Pastikan halaman menampilkan tingkat akses Anda saat ini sebagai Test.
- Klik untuk meluaskan bagian Upgrade tingkat akses.
- Pastikan Tingkat akses berikutnya ditampilkan sebagai Penjelajah.
- Klik tombol Ajukan permohonan akses untuk mengajukan permohonan tingkat akses Explorer.
Google dapat mengupgrade level akses API project Anda secara otomatis ke level Akses Explorer setelah Anda mengirimkan permohonan.
Tingkat akses dasar
Tingkat Akses Dasar memungkinkan project Google Cloud Anda 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 project Google Cloud Anda menjalankan hingga 15.000 operasi per hari. Langkah ini cukup untuk sebagian besar developer.
Mengajukan permohonan tingkat akses Dasar
- Buka halaman Ringkasan Google Ads API di project Google Cloud Anda.
- Pastikan halaman menampilkan tingkat akses Anda saat ini sebagai Penjelajah.
- Klik untuk meluaskan bagian Upgrade tingkat akses.
- Pastikan Tingkat akses berikutnya ditampilkan sebagai Dasar.
- Konfirmasi bahwa tidak ada peringatan yang menunjukkan bahwa Anda belum menyelesaikan verifikasi merek untuk project Anda. Jika ada, ikuti petunjuknya untuk menyelesaikan verifikasi merek sebelum melanjutkan.
- Klik tombol Ajukan permohonan akses untuk mengajukan permohonan tingkat Akses Dasar.
Google dapat otomatis mengupgrade tingkat akses API project Anda ke tingkat Akses Dasar setelah Anda mengirimkan permohonan.
Tingkat akses standar
Tingkat Akses Standar memungkinkan project Google Cloud Anda menjalankan operasi dalam jumlah yang tidak terbatas per hari untuk semua layanan. Layanan dan fitur individual mungkin masih memiliki batas laju dan batasan yang khusus untuk fitur tersebut, yang akan terus berlaku meskipun project Anda memiliki tingkat Akses Standar.
Tingkat Akses Standar hanya diberikan kepada developer yang memerlukan operasi Google Ads API tanpa batas, seperti perusahaan besar atau alat yang melayani banyak pengguna.
Mendaftar untuk tingkat akses Standar
- Buka halaman Ringkasan Google Ads API di project Google Cloud Anda.
- Verifikasi bahwa halaman menampilkan tingkat akses Anda saat ini sebagai Dasar.
- Klik untuk meluaskan bagian Upgrade tingkat akses.
- Pastikan Tingkat akses berikutnya ditampilkan sebagai Standar.
- Klik tombol Mulai permohonan untuk memulai permohonan tingkat akses Standar.
Permohonan Akses Standar melibatkan audit manual mendetail terhadap aplikasi Anda. Bersiaplah untuk menjawab pertanyaan tentang fungsi alat Anda dan audiens targetnya. 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.
Selama proses peninjauan, tim Kepatuhan Google akan berkomunikasi dengan Anda menggunakan alamat email Anda. Pastikan Anda segera merespons pertanyaan dari tim Kepatuhan untuk memproses aplikasi Akses Standar Anda. Setelah peninjauan selesai, Google akan mengirimkan email kepada Anda yang berisi hasil akhir proses peninjauan.
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 laju, lihat jenis error.
Setiap layanan dapat menerapkan batasan dan pembatasan kuota tambahan karena alasan seperti batasan desain produk, batasan 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 project Google Cloud dengan tingkat Akses Standar. Penggunaan yang diizinkan dialokasikan berdasarkan penggunaan Google Ads API yang dimaksudkan. Izin ini menentukan fitur API yang dapat digunakan alat Anda, 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. Opsi ini ditujukan bagi developer yang hanya menggunakan API untuk meminta statistik. |
| Meneliti kata kunci dan rekomendasi | Izinkan project Google Cloud mengakses RecommendationService, KeywordPlanIdeaService, dan KeywordPlanService. Data ini hanya digunakan oleh alat yang memerlukan saran untuk membantu memfasilitasi pembuatan dan pengelolaan kampanye Google Ads. |
Mengubah penggunaan yang diizinkan
Jika project Google Cloud Anda telah disetujui untuk 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.