Lỗi phổ biến

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

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

EntityChildrenLimitReachedError

Tóm tắt
Số lượng trẻ em tối đa được phép đã đạt đến giới hạn cho thực thể này và bạn không thể thêm trẻ em nào khác vào thực thể đó.
Các mẹo xử lý nên dùng
Tạo một loại thực thể mới đã đạt đến số lượng tối đa cho phép của phần tử con 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 sẽ 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.
Các mẹo xử lý nên dùng
  • Sử dụng các phương thức hàng loạt như updateLineItems bằng cách thu thập các thay đổi cục bộ và đưa ra 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ử 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 thao tác này không thành công, hãy thử tăng thời gian chờ. Bạn nên 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 sử dụng theo thời gian thực.
  • Giới hạn số yêu cầu ở mức 2 yêu cầu/giây đối với mạng Ad Manager hoặc 8 yêu cầu/giây đối với mạng Ad Manager 360. Xin nhắc lại rằng điều này không đảm bảo mọi yêu cầu đều thành công, nhưng có thể giúp giảm số lần bạn gặp phải lỗi này. Bạn nên dùng cách này cho những ứng dụng tích hợp với Ad Manager mà 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 chưa tạo Tài khoản Google mới trước khi gọi NetworkService.makeTestNetwork().
Các 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. Để đưa ra yêu cầu, bạn cần có mã mạng.
Nguyên nhân thường gặp
Mã mạng là thông tin bắt buộc đối với tất cả các yêu cầu, ngoại trừ NetworkService.getAllNetworks() và NetworkService.makeTestNetwork().
Các mẹo xử lý nên dùng
Thêm mã mạng của mạng được đề cập vào tiêu đề 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ã này 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 thiết lập mã mạng trên trang Tiêu đề yêu cầu và phản hồi XML SOAP.

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ác mẹo xử lý nên dùng
Trường "trigger" (điều kiện kích hoạt) của nhật ký lỗi thường đề xuất mạng phù hợp cho người dùng.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Tóm tắt
Người dùng không liên kết với 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 sản xuất của mình.
Các mẹo xử lý nên dùng
Bật quyền truy cập API vào môi trường phát hành công khai. 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 được phép truy cập vào API.
Nguyên nhân thường gặp
Mạng của bạn không có 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.
Các 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 cho yêu cầu.
Nguyên nhân thường gặp
  • Bạn đã cố gắng truy cập vào một đối tượng tồn tại trong một mạng khác.
  • Bạn đã cố gắng truy cập vào một đối tượng có 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ố gắng thực hiện một thao tác yêu cầu phải bật thêm một tính năng trên tài khoản của mình.
Các 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ư một tác vụ liên quan đến tính năng chỉ dành cho tài khoả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, các mạng thử nghiệm không phải là mạng Ad Manager 360, nghĩa là các mạng này không có các tính năng cao cấp có trong mạng Ad Manager 360. Liên hệ 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 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 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 đã ngừng hoạt động. Vui lòng đăng ký theo dõi blog của chúng tôi để nhận thông báo về việc không dùng nữa.
  • Yêu cầu bạn đưa ra cần có phiên bản API mới hơn để thành công. Đây thường là trường hợp 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 một phiên bản mới hơn.
Các 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.
  • Đă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.

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
Kết nối Internet hoặc proxy của bạn có thể được định cấu hình không chính xác. Phiên bản API mà bạn đang gọi cũng có thể đã ngừng hoạt động.
Các 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 gần đây. 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 truy cập Cộng đồng trợ giúp của 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 giải tuần tự hoá

Tóm tắt
XML SOAP 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 quy cách WSDL hoặc trong không gian tên không chính xác.
Yêu cầu có loại không khớp (ví dụ: một trường số nguyên có giá trị chuỗi).
Các 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.