Kesalahan Umum

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

Error batas entitas

EntityChildrenLimitReachedError

Ringkasan
Jumlah maksimum anak yang diizinkan telah tercapai untuk entitas dan tidak ada lagi anak yang dapat ditambahkan ke entitas tersebut.
Tips penanganan yang direkomendasikan
Buat jenis entitas baru yang telah mencapai jumlah maksimum turunan yang diizinkan dan tambahkan entitas turunan yang ingin Anda buat ke entitas 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 melampaui batas yang diizinkan.
Tips penanganan yang direkomendasikan
  • Gunakan metode batch seperti updateLineItems dengan mengumpulkan perubahan secara lokal dan membuat satu permintaan untuk memenuhi semua perubahan sekaligus.
  • Tunggu sekitar 5 detik, lalu coba lagi permintaan tersebut. Perhatikan bahwa hal ini tidak menjamin permintaan akan berhasil. Jika gagal lagi, coba perpanjang 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 harian.

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 ditangani 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 menyetel kode jaringan dapat ditemukan di halaman Header permintaan dan respons SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Ringkasan
Permintaan tidak dapat dilakukan 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" pada log error sering kali menyarankan jaringan yang benar untuk pengguna.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Ringkasan
Pengguna tidak dikaitkan dengan jaringan apa 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 akses API.
Penyebab umum
Jaringan Anda tidak masuk daftar putih 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.
Penyebab umum
  • Anda mencoba mengakses objek yang ada di jaringan lain.
  • Anda mencoba mengakses objek yang ada di jaringan Anda, tetapi Anda tidak memiliki izin untuk membaca atau memperbarui.
  • Anda mencoba melakukan tugas yang memerlukan fitur tambahan yang 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 tidak digunakan lagi. Harap berlangganan ke blog kami untuk mengetahui pengumuman penghentian penggunaan.
  • Permintaan yang Anda buat memerlukan versi API yang lebih baru agar berhasil. Hal ini sering terjadi jika fitur telah diperkenalkan di UI dan agar API mengirim objek dengan benar, API memerlukan versi API yang lebih baru.
Tips penanganan yang direkomendasikan
  • Selalu ikuti perkembangan versi API; rencanakan upgrade secara rutin.
  • Berlangganan blog kami untuk mendapatkan notifikasi tentang penghentian penggunaan.

Kesalahan 404

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

Error Unmarshalling

Ringkasan
SOAP XML dalam permintaan Anda tidak sesuai dengan spesifikasi WSDL.
Penyebab umum
Permintaan berisi kolom atau entitas 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 pencatatan permintaan dan respons SOAP.