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

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 entitas baru yang telah mencapai jumlah turunan maksimum yang diizinkan, lalu tambahkan entitas turunan yang ingin Anda buat ke entitas baru. Misalnya, jika Anda menerima LINE_ITEM_LIMIT_FOR_ORDER_REACHED, Anda harus membuat pesanan baru dan menambahkan item baris yang Anda coba buat ke pesanan baru tersebut.

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 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 tingkatkan waktu tunggu. Hal ini direkomendasikan untuk aplikasi interaktif yang terintegrasi dengan Ad Manager yang digunakan secara real time.
Batasi permintaan ke 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 berapa kali 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.

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.

Ringkasan: Pengguna tidak memberikan networkCode. Untuk membuat permintaan, diperlukan kode jaringan.
Penyebab umum: Kode jaringan diperlukan untuk semua permintaan kecuali NetworkService.getAllNetworks() dan NetworkService.makeTestNetwork().
Tips penanganan yang direkomendasikan: Sertakan kode jaringan yang sedang ditangani dalam 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 menyetel kode jaringan dapat ditemukan di halaman header respons dan permintaan XML SOAP.

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

Ringkasan: Pengguna tidak terkait 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.

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.

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, tetapi Anda tidak memiliki izin untuk membaca atau mengupdate.
Anda telah 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 Administratornya.
Jika Anda mencoba melakukan tugas, seperti yang melibatkan fitur khusus premium yang izin aksesnya tidak dimiliki jaringan Anda, hubungi Account Manager Anda untuk mengaktifkan fitur ini.
Ingat, secara default jaringan pengujian 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.

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 sudah tidak digunakan lagi. Anda dapat berlangganan blog kami untuk mendapatkan pengumuman penghentian penggunaan.
Permintaan yang Anda buat memerlukan versi API yang lebih baru agar berhasil. Hal ini sering kali terjadi saat fitur diperkenalkan di UI dan agar API dapat mengirim objek dengan benar, API memerlukan versi API yang lebih baru.

Tips penanganan yang direkomendasikan

Dapatkan info terbaru tentang versi API; rencanakan upgrade secara berkala.
Berlangganan blog kami untuk mendapatkan notifikasi tentang penghentian penggunaan.

Ringkasan: Permintaan Anda tidak sampai ke server.
Penyebab umum: Koneksi internet atau proxy Anda mungkin salah dikonfigurasi. Versi API yang Anda panggil juga dapat dihentikan.
Tips penanganan yang direkomendasikan: Periksa konfigurasi internet atau proxy Anda, dan pastikan Anda menggunakan API versi terbaru. Anda mungkin juga perlu mengupgrade library klien ke versi terbaru.
Tips pencegahan: Berlanggananlah ke forum Ad Manager API dan lihat blog kami untuk terus mendapatkan berita terbaru mengenai Ad Manager API.

Ringkasan: XML SOAP 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 sebagai perbandingan. Semua library klien mendukung logging permintaan dan respons SOAP.