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 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.

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 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.

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, 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.

AuthenticationError.NETWORK_NOT_FOUND

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.

AuthenticationError.NO_NETWORKS_TO_ACCESS

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.

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.
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.

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 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.

Kesalahan 404

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.

Kesalahan Unmarshalling

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.