Lỗi thường gặp

Trang này mô tả các lỗi thường gặp nhất mà API Google Ad Manager trả về. Lỗi được trả về theo định dạng Error.REASON:

Lỗi giới hạn thực thể

EntityChildrenLimitReachedError

Tóm tắt
Thực thể đã đạt đến số lượng thực thể con tối đa được phép và không thể thêm thực thể con nào khác vào thực thể đó.
Mẹo xử lý nên dùng
Tạo một loại thực thể mới đã đạt đến số lượng thực thể con tối đa được phép và thêm thực thể con mà bạn đang cố gắng tạo vào thực thể mới. Ví dụ: nếu nhận được LINE_ITEM_LIMIT_FOR_ORDER_REACHED, thì bạn cần tạo một đơn đặt hàng mới và thêm mục hàng mà bạn đang cố gắng tạo vào đơn đặt hàng mới đó.

Lỗi hạn mức

QuotaError.EXCEEDED_QUOTA

Tóm tắt
Số lượng yêu cầu được thực hiện mỗi giây quá cao và đã vượt quá giới hạn cho phép.
Mẹo xử lý nên dùng
  • Sử dụng các phương thức theo lô như updateLineItems bằng cách thu thập các thay đổi trên máy và gửi một yêu cầu duy nhất để thực hiện tất cả các thay đổi đó cùng một lúc.
  • Đợi khoảng 5 giây rồi thử gửi lại yêu cầu. Xin lưu ý rằng việc này không đảm bảo yêu cầu sẽ thành công. Nếu vẫn không thành công, hãy thử tăng thời gian chờ. Bạn nên sử dụng phương thức này cho các ứng dụng tương tác tích hợp với Ad Manager được dùng theo thời gian thực.
  • Giới hạn số yêu cầu là 2 yêu cầu mỗi giây đối với mạng Ad Manager hoặc 8 yêu cầu mỗi giây đối với mạng Ad Manager 360. Xin nhắc lại, điều này không đảm bảo rằng mọi yêu cầu đều sẽ thành công, nhưng có thể giúp giảm số lần bạn gặp lỗi này. Bạn nên sử dụng phương thức này cho các ứng dụng tích hợp với Ad Manager không có hoạt động tương tác theo thời gian thực, chẳng hạn như chạy báo cáo hằng đêm.

Lỗi xác thực

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Tóm tắt
Người dùng đã cố gắng tạo một mạng thử nghiệm bằng tài khoản đã được liên kết với một mạng.
Nguyên nhân thường gặp
Người dùng không tạo Tài khoản Google mới trước khi gọi NetworkService.makeTestNetwork().
Mẹo xử lý nên dùng
Tạo một tài khoản hoàn toàn mới trước khi gọi NetworkService.makeTestNetwork(). Hãy xem cách tạo mạng thử nghiệm để biết thêm thông tin.

AuthenticationError.NETWORK_CODE_REQUIRED

Tóm tắt
Người dùng không cung cấp networkCode. Để gửi yêu cầu, bạn cần có mã mạng.
Nguyên nhân thường gặp
Mã mạng là bắt buộc đối với tất cả các yêu cầu, ngoại trừ NetworkService.getAllNetworks() và NetworkService.makeTestNetwork().
Mẹo xử lý nên dùng
Thêm mã mạng của mạng đang được xử lý vào tiêu đề của yêu cầu. Chỉ sử dụng mã mạng có sẵn cho thông tin đăng nhập tài khoản của bạn. Bạn có thể tìm thấy mã trên trang web Ad Manager cho tài khoản của mình, trên trang Quản trị > Cài đặt mạng bên cạnh "Mã mạng". Bạn có thể tìm thêm thông tin về cách đặt mã mạng trên trang Tiêu đề yêu cầu và tiêu đề phản hồi SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Tóm tắt
Không thể thực hiện yêu cầu vì không tìm thấy mã mạng được cung cấp trong cấu hình trên máy chủ.
Nguyên nhân thường gặp
Bạn đã chỉ định mã mạng không chính xác trong cấu hình của mình.
Mẹo xử lý nên dùng
Trường "trigger" (trình kích hoạt) của nhật ký lỗi thường sẽ đề xuất mạng chính xác cho người dùng.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Tóm tắt
Người dùng không được liên kết với bất kỳ mạng nào.
Nguyên nhân thường gặp
Bạn chưa bật quyền truy cập API cho tài khoản chính thức.
Mẹo xử lý nên dùng
Bật quyền truy cập API vào môi trường thực tế. Hãy xem phần Bật quyền truy cập API để biết thông tin.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Tóm tắt
Khách hàng không có tên trong danh sách cho phép truy cập vào API.
Nguyên nhân thường gặp
Mạng của bạn không nằm trong danh sách cho phép phát hành công khai, nhưng bạn đã cung cấp một mã mạng trong Tiêu đề SOAP.
Mẹo xử lý nên dùng
Bật quyền truy cập API.

Lỗi về quyền

PermissionError.PERMISSION_DENIED

Tóm tắt
Người dùng không có quyền cần thiết để thực hiện yêu cầu.
Nguyên nhân thường gặp
  • Bạn đã cố truy cập vào một đối tượng tồn tại trong một mạng khác.
  • Bạn đã cố truy cập vào một đối tượng tồn tại trong mạng của mình, nhưng bạn không có quyền đọc hoặc cập nhật.
  • Bạn đã cố thực hiện một nhiệm vụ yêu cầu bật một tính năng bổ sung trên tài khoản của bạn.
Mẹo xử lý nên dùng
  • Nếu bạn đang tạo giao diện người dùng, hãy cho người dùng biết rằng họ không có quyền thực hiện hành động này và cần liên hệ với Quản trị viên.
  • Nếu bạn đã thử thực hiện một tác vụ, chẳng hạn như tác vụ liên quan đến tính năng chỉ dành cho phiên bản cao cấp mà mạng của bạn không có quyền thực hiện, hãy trao đổi với người quản lý tài khoản của bạn về việc bật tính năng này.
  • Xin lưu ý rằng theo mặc định, mạng thử nghiệm không phải là mạng Ad Manager 360, nghĩa là mạng thử nghiệm không có các tính năng nâng cao có trong mạng Ad Manager 360. Hãy trao đổi với người quản lý tài khoản của bạn để bật các tính năng trên mạng thử nghiệm.

Lỗi phiên bản

ApiVersionError.UPDATE_TO_NEWER_VERSION

Tóm tắt
Ứng dụng đã: khởi tạo một yêu cầu cần có phiên bản mới hơn để thành công; hoặc khởi tạo một yêu cầu đến một phiên bản không dùng nữa.
Nguyên nhân thường gặp
  • Phiên bản của lệnh gọi API này không còn được dùng nữa. Vui lòng đăng ký theo dõi blog của chúng tôi để nhận thông báo về việc ngừng sử dụng.
  • Yêu cầu của bạn cần có phiên bản API mới hơn để thành công. Điều này thường xảy ra khi một tính năng được ra mắt trong giao diện người dùng và để API gửi đối tượng một cách chính xác, API cần có phiên bản mới hơn.
Mẹo xử lý nên dùng
  • Luôn cập nhật các phiên bản API; lên kế hoạch nâng cấp thường xuyên.
  • Hãy đăng ký theo dõi blog của chúng tôi để nhận thông báo về việc ngừng cung cấp.

Lỗi 404

Tóm tắt
Yêu cầu của bạn không đến được máy chủ.
Nguyên nhân thường gặp
Có thể kết nối Internet hoặc proxy của bạn đã được định cấu hình sai. Phiên bản API mà bạn đang gọi cũng có thể đã ngừng hoạt động.
Mẹo xử lý nên dùng
Kiểm tra cấu hình Internet hoặc proxy và đảm bảo bạn đang sử dụng phiên bản API mới nhất. Bạn cũng nên nâng cấp thư viện ứng dụng lên phiên bản mới nhất.
Mẹo phòng tránh dịch
Hãy xem Cộng đồng trợ giúp Ad Manager và blog của chúng tôi để nắm bắt tin tức mới nhất về API Ad Manager.

Lỗi huỷ sắp xếp

Tóm tắt
SOAP XML trong yêu cầu của bạn không tuân thủ quy cách WSDL.
Nguyên nhân thường gặp
Yêu cầu chứa các trường hoặc thực thể không có trong thông số kỹ thuật WSDL hoặc không gian tên không chính xác.
Có sự không khớp về loại trong yêu cầu (ví dụ: trường số nguyên có giá trị chuỗi).
Mẹo xử lý nên dùng
Đảm bảo rằng yêu cầu của bạn tuân thủ quy cách WSDL.
Sử dụng thư viện ứng dụng để tạo SOAP hợp lệ và sử dụng SOAP này để so sánh. Tất cả thư viện ứng dụng đều hỗ trợ ghi nhật ký các yêu cầu và phản hồi SOAP.