Pengujian

Pengujian adalah langkah penting dalam membangun integrasi Google Ads API yang berhasil, baik Anda baru memulai, memelihara aplikasi, atau menambahkan fitur baru ke integrasi yang ada. Panduan ini menyajikan beberapa praktik terbaik untuk menguji integrasi Google Ads API Anda.

Akun pengujian dan akun produksi

Catatan tentang Retensi Akun Pengujian:

Akun pengujian Google Ads API dan data terkaitnya akan dihapus secara otomatis. Akun pengujian yang tetap tidak aktif (tidak ada aktivitas atau login API) selama satu tahun berturut-turut akan dihapus secara permanen.

Untuk mencegah penghapusan yang tidak disengaja, pastikan Anda berinteraksi dengan akun pengujian Anda secara berkala jika ingin mempertahankannya.

Akun pengujian tersedia untuk tujuan pengembangan. Dengan akun pengujian, Anda dapat memvalidasi bahwa kode dan konfigurasi aplikasi Anda berfungsi sebagaimana mestinya.

Namun, tidak semua fitur dapat diuji di akun pengujian.

Jika batasan akun pengujian mencegah Anda menguji beberapa fitur dalam integrasi, Anda dapat menggunakan akun produksi untuk pengembangan. Project Google Cloud Anda harus memiliki setidaknya tingkat akses Explorer (Explorer, Basic, atau Standard) untuk memanggil akun produksi. Perhatikan bahwa akses Penjelajah masih membatasi layanan tertentu, termasuk penagihan (BillingSetupService dan AccountBudgetProposalService), perencanaan, pembuatan akun, dan undangan pengguna (lihat Batasan fitur Explorer), yang memerlukan akses Dasar atau Standar. Mencoba memanggil akun produksi dari project dengan tingkat akses Pengujian akan menampilkan AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION mulai di v25, atau AuthorizationError.ACTION_NOT_PERMITTED di v24 dan versi sebelumnya.

Akun produksi untuk pengembangan berbeda dengan akun pengujian dalam hal berikut:

• Menayangkan iklan yang dapat dilihat oleh pengguna
• Memerlukan URL yang valid
• Harus mematuhi kebijakan periklanan

Karena akun produksi menayangkan iklan, akun tersebut menghasilkan metrik yang memungkinkan Anda menguji laporan performa, serta membuka semua fitur Google Ads API lainnya. Namun, penggunaannya untuk pengembangan memerlukan kehati-hatian ekstra. Sebaiknya lakukan tindakan berikut:

• Hanya berikan akses kepada pengguna yang memerlukannya untuk tujuan pengembangan.
• Tetapkan anggaran harian akun yang tetap dan rendah.
• Gunakan akun produksi untuk pengembangan hanya jika akun percobaan tidak dapat digunakan.

Oleh karena itu, untuk melakukan pengujian penuh integrasi, Anda mungkin memerlukan kredensial pengujian dan kredensial produksi.

Kredensial pengujian

Untuk meminimalkan risiko memodifikasi akun produksi secara tidak sengaja saat mencoba memodifikasi akun pengembangan, sebaiknya pertahankan serangkaian kredensial pengujian yang terpisah dari kredensial aplikasi produksi Anda.

Untuk membuat serangkaian kredensial pengujian, ikuti langkah-langkah berikut:

1. Buat akun email (misalnya, [e-mail]) atau akun layanan yang hanya akan digunakan untuk tujuan pengujian.
2. Tambahkan akun pengguna atau layanan ini sebagai pengguna yang valid di akun Google Ads yang Anda gunakan untuk menjalankan pengujian. Pastikan Anda memberikan tingkat aksesyang sesuai kepada pengguna atau akun layanan ini. Jangan beri akun layanan atau pengguna ini akses ke akun produksi mana pun.
3. Jika Anda menggunakan alur autentikasi pengguna OAuth 2.0, bukan alur akun layanan, buat token refresh untuk akun pengguna pengujian Anda.
4. Gunakan kredensial baru ini saat menguji aplikasi Anda. ID klien dan secret klien dapat digunakan kembali untuk tujuan pengujian, karena tidak berpengaruh dalam menentukan akun Google Ads mana yang dapat diakses. Simpan semua kredensial dan token refresh dengan aman, dan jangan pernah melakukan commit ke kontrol sumber.

Minta validasi

Jika Anda hanya perlu menguji apakah permintaan valid—misalnya, untuk memverifikasi bahwa permintaan disusun dengan benar dan tidak melanggar kebijakan—Anda dapat menggunakan kolom validate_only, yang tersedia untuk permintaan GoogleAdsService.Search (perhatikan bahwa GoogleAdsService.SearchStream tidak mendukung validate_only) dan sebagian besar permintaan perubahan. Lihat dokumentasi referensi untuk memverifikasi apakah kolom ini tersedia untuk metode tertentu.

Catatan: Mulai v25, pembuatan kampanye Performa Maksimal untuk kampanye Pintar tidak mendukung mode validate_only dan menampilkan SmartCampaignError.VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED jika validate_only disetel ke true.

REST API

Untuk pengujian ad hoc, misalnya untuk memvalidasi bahwa permintaan menghasilkan output yang diharapkan, penggunaan REST API sering kali menjadi opsi termudah. Lihat contoh REST untuk mempelajari cara menggunakan curl dalam membuat permintaan ke REST API. Selain itu, coba lakukan pengujian di REST Explorer.