Pengujian

Pengujian adalah langkah penting dalam membangun integrasi Google Ads API yang berhasil, baik Anda baru memulai, mengelola aplikasi, atau menambahkan fitur baru ke integrasi yang sudah 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 otomatis dihapus. Setiap akun pengujian yang tetap tidak aktif (tidak memiliki aktivitas API atau login) selama periode berkelanjutan satu tahun akan dihapus secara permanen.

Untuk mencegah penghapusan yang tidak disengaja, pastikan Anda berinteraksi dengan akun pengujian 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 Penjelajah (Penjelajah, Dasar, atau Standar) untuk memanggil akun produksi. Perhatikan bahwa akses Penjelajah masih membatasi layanan tertentu—termasuk penagihan (BillingSetupService dan AccountBudgetProposalService), perencanaan, pembuatan akun, dan undangan pengguna (lihat Pembatasan fitur Penjelajah)—yang memerlukan akses Dasar atau Standar. Upaya untuk memanggil akun produksi dari project dengan tingkat akses Pengujian akan menampilkan AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION mulai v25, atau AuthorizationError.ACTION_NOT_PERMITTED di v24 dan yang lebih lama.

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, menggunakannya untuk pengembangan memerlukan kehati-hatian ekstra. Sebaiknya lakukan tindakan berikut:

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

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

Kredensial pengujian

Untuk meminimalkan risiko perubahan yang tidak disengaja pada akun produksi saat mencoba mengubah akun developer, sebaiknya pertahankan kumpulan kredensial pengujian yang terpisah dari kredensial aplikasi produksi Anda.

Untuk membuat kumpulan 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 akses yang sesuai kepada pengguna atau akun layanan ini. Jangan beri pengguna atau akun layanan ini akses ke akun produksi apa 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. Client ID dan rahasia 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 meng-commit-nya 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 mutasi. 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 ditetapkan ke true.

REST API

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