Error yang Biasa Terjadi

Halaman ini menjelaskan error yang paling sering muncul dan ditampilkan oleh Google Ad Manager API. Error ditampilkan dalam format Error.REASON:

Error batas entitas

EntityChildrenLimitReachedError

Ringkasan
Jumlah maksimum turunan yang diizinkan telah tercapai untuk entitas dan tidak ada lagi turunan yang dapat ditambahkan ke entitas tersebut.
Tips penanganan yang direkomendasikan
Buat jenis baru entity yang telah mencapai jumlah maksimum turunan yang diizinkan, lalu tambahkan entity turunan yang ingin Anda buat ke entity baru tersebut. Misalnya, jika Anda menerima LINE_ITEM_LIMIT_FOR_ORDER_REACHED, Anda harus membuat pesanan baru dan menambahkan item baris yang ingin Anda buat ke pesanan baru tersebut.

Error kuota

QuotaError.EXCEEDED_QUOTA

Ringkasan
Jumlah permintaan yang dibuat per detik terlalu tinggi dan telah melebihi batas yang diizinkan.
Tips penanganan yang direkomendasikan
  • Gunakan metode batch seperti updateLineItems dengan mengumpulkan perubahan secara lokal dan membuat satu permintaan untuk memenuhi perubahan tersebut sekaligus.
  • Tunggu sekitar 5 detik, lalu coba lagi permintaan tersebut. Perhatikan bahwa hal ini tidak menjamin permintaan akan berhasil. Jika gagal lagi, coba tambah waktu tunggu. Hal ini direkomendasikan untuk aplikasi interaktif yang terintegrasi dengan Ad Manager yang digunakan secara real time.
  • Batasi permintaan hingga 2 per detik untuk jaringan Ad Manager, atau 8 per detik untuk jaringan Ad Manager 360. Sekali lagi, hal ini tidak menjamin bahwa setiap permintaan akan berhasil, tetapi dapat membantu mengurangi frekuensi Anda menerima error ini. Hal ini direkomendasikan untuk aplikasi yang terintegrasi dengan Ad Manager yang tidak memiliki interaksi real-time, seperti menjalankan laporan setiap malam.

Error autentikasi

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Ringkasan
Pengguna mencoba membuat jaringan pengujian menggunakan akun yang sudah dikaitkan dengan jaringan.
Penyebab umum
Pengguna tidak membuat Akun Google baru terlebih dahulu sebelum memanggil NetworkService.makeTestNetwork().
Tips penanganan yang direkomendasikan
Buat akun baru sebelum memanggil NetworkService.makeTestNetwork(). Lihat cara membuat jaringan pengujian untuk mengetahui informasi selengkapnya.

AuthenticationError.NETWORK_CODE_REQUIRED

Ringkasan
Pengguna tidak memberikan networkCode. Untuk membuat permintaan, kode jaringan diperlukan.
Penyebab umum
Kode jaringan diperlukan untuk semua permintaan, kecuali NetworkService.getAllNetworks() dan NetworkService.makeTestNetwork().
Tips penanganan yang direkomendasikan
Sertakan kode jaringan dari jaringan yang dituju di header permintaan. Hanya gunakan kode jaringan yang tersedia untuk login akun Anda. Anda dapat menemukan kode di situs Ad Manager untuk akun Anda, di halaman Admin > Setelan Jaringan di samping "Kode jaringan". Informasi selengkapnya tentang cara menetapkan kode jaringan dapat ditemukan di halaman Header permintaan dan respons SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Ringkasan
Permintaan tidak dapat dibuat karena kode jaringan yang diberikan dalam konfigurasi tidak ditemukan di server.
Penyebab umum
Anda telah menentukan kode jaringan yang salah dalam konfigurasi.
Tips penanganan yang direkomendasikan
Kolom "pemicu" log error sering kali akan menyarankan jaringan yang benar untuk pengguna.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Ringkasan
Pengguna tidak terkait dengan jaringan mana pun.
Penyebab umum
Anda belum mengaktifkan akun produksi untuk akses API.
Tips penanganan yang direkomendasikan
Aktifkan akses API ke lingkungan produksi Anda. Lihat Mengaktifkan Akses API untuk mengetahui informasinya.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Ringkasan
Pelanggan tidak diizinkan untuk mengakses API.
Penyebab umum
Jaringan Anda tidak diizinkan untuk produksi, tetapi Anda memberikan kode jaringan di Header SOAP.
Tips penanganan yang direkomendasikan
Aktifkan akses API.

Error izin

PermissionError.PERMISSION_DENIED

Ringkasan
Pengguna tidak memiliki izin yang diperlukan untuk permintaan tersebut.
Penyebab umum
  • Anda mencoba mengakses objek yang ada di jaringan lain.
  • Anda mencoba mengakses objek yang ada di jaringan, tetapi Anda tidak memiliki izin untuk membaca atau memperbarui.
  • Anda mencoba melakukan tugas yang memerlukan fitur tambahan untuk diaktifkan di akun Anda.
Tips penanganan yang direkomendasikan
  • Jika Anda membuat UI, tunjukkan kepada pengguna bahwa mereka tidak memiliki izin untuk melakukan tindakan ini dan untuk berbicara dengan Administrator mereka.
  • Jika Anda mencoba melakukan tugas, seperti yang melibatkan fitur khusus premium yang tidak diizinkan untuk dilakukan oleh jaringan Anda, hubungi Account Manager Anda untuk mengaktifkan fitur ini.
  • Ingat, jaringan pengujian secara default bukan jaringan Ad Manager 360, yang berarti jaringan tersebut tidak memiliki fitur premium yang ada di jaringan Ad Manager 360. Hubungi Account Manager Anda untuk mengaktifkan fitur di jaringan pengujian Anda.

Error versi

ApiVersionError.UPDATE_TO_NEWER_VERSION

Ringkasan
Aplikasi: memulai permintaan yang memerlukan versi yang lebih baru agar berhasil; atau memulai permintaan ke versi yang tidak digunakan lagi.
Penyebab umum
  • Versi panggilan API ini tidak digunakan lagi. Silakan berlangganan blog kami untuk mendapatkan pengumuman penghentian penggunaan.
  • Permintaan yang Anda buat memerlukan versi API yang lebih baru agar berhasil. Hal ini sering terjadi saat fitur telah diperkenalkan di UI dan agar API dapat mengirim objek dengan benar, diperlukan versi API yang lebih baru.
Tips penanganan yang direkomendasikan
  • Terus ikuti perkembangan versi API; rencanakan untuk mengupgrade secara rutin.
  • Berlanggananlah ke blog kami untuk mendapatkan notifikasi tentang penghentian penggunaan.

Kesalahan 404

Ringkasan
Permintaan Anda tidak sampai ke server.
Penyebab umum
Koneksi internet atau proxy Anda mungkin salah dikonfigurasi. Versi API yang Anda panggil mungkin juga akan dihentikan.
Tips penanganan yang direkomendasikan
Periksa konfigurasi internet atau proxy Anda dan pastikan Anda menggunakan versi API terbaru. Anda mungkin juga perlu mengupgrade library klien ke versi terbaru.
Tips pencegahan
Periksa Komunitas Bantuan Ad Manager dan blog kami untuk terus mendapatkan info terbaru tentang Ad Manager API.

Error Unmarshalling

Ringkasan
XML SOAP dalam permintaan Anda tidak sesuai dengan spesifikasi WSDL.
Penyebab umum
Permintaan berisi kolom atau entity yang tidak disertakan dalam spesifikasi WSDL, atau dalam namespace yang salah.
Ada ketidakcocokan jenis dalam permintaan (misalnya, kolom bilangan bulat memiliki nilai string).
Tips penanganan yang direkomendasikan
Pastikan permintaan Anda sesuai dengan spesifikasi WSDL.
Gunakan library klien untuk membuat SOAP yang valid, dan gunakan ini untuk perbandingan. Semua library klien mendukung logging permintaan dan respons SOAP.