Lỗi phổ biến

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ề ở định dạng Error.REASON:

Lỗi về giới hạn số lượng thực thể

EntityChildrenLimitReachedError

Tóm tắt
Đối tượng có thể đã đạt đến số lượng phần tử con tối đa được phép nên bạn không thể thêm phần tử con nào vào thực thể đó nữa.
Mẹo xử lý nên dùng
Tạo một loại thực thể con mới đã đạt đến số lượng phần tử 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 một thực thể mới. Ví dụ: nếu bạn 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 bạn đang cố gắng tạo vào đơn đặt hàng mới đó.

Lỗi về 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 hàng loạt như updateLineItems bằng cách thu thập các thay đổi cục bộ và thực hiện 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ử yêu cầu lại. Xin lưu ý rằng điều này không đảm bảo rằng yêu cầu sẽ thành công. Nếu tính năng này vẫn không thành công, hãy thử tăng thời gian chờ. Bạn nên sử dụng tính năng 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 yêu cầu ở mức 2/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. Một lần nữa, điều này không đảm bảo rằng mọi yêu cầ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 áp dụng tính năng này cho các ứng dụng tích hợp với Ad Manager không có 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 cách sử dụng một tài khoản đã liên kết với một mạng.
Nguyên nhân thường gặp
Trước khi gọi NetworkService.makeTestNetwork(), người dùng không tạo Tài khoản Google mới.
Mẹo xử lý nên dùng
Hãy 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 kiểm thử để biết thêm thông tin.

AuthenticationError.NETWORK_CODE_REQUIRED

Tóm tắt
Người dùng chưa cung cấp networkCode. Để gửi yêu cầu, bạn phải 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
Đưa 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 để đă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 đặt mã mạng trên trang tiêu đề phản hồi và yêu cầu 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 "kích hoạt" của nhật ký lỗi thường sẽ đề xuất đúng mạng 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 bất kỳ mạng nào.
Nguyên nhân thường gặp
Bạn chưa cho phép tài khoản phát hành công khai có quyền truy cập API.
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 chính thức. Xem 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 API.
Nguyên nhân thường gặp
Mạng của bạn chưa có trong danh sách cho phép để phát hành công khai, nhưng bạn đã cung cấp 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 quyền

PermissionError.PERMISSION_DENIED

Tóm tắt
Người dùng không có quyền cần thiết đối với yêu cầu này.
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 không có quyền đọc hoặc cập nhật.
  • Bạn đã cố thực hiện một tác vụ yêu cầu bật thêm tính năng trên tài khoản của mình.
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à hãy trao đổi với Quản trị viên của họ.
  • 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 cấp cao cấp nhưng mạng của bạn không có quyền thực hiện, hãy liên hệ 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.
  • Hãy nhớ rằng theo mặc định, mạng thử nghiệm không phải là mạng Ad Manager 360, có nghĩa là mạng đó không có các tính năng nâng cao 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: bắt đầu một yêu cầu cần có một phiên bản mới hơn để thành công; hoặc tạo một yêu cầu cho 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 không được dùng nữa. Vui lòng đăng ký blog của chúng tôi để biết thông báo về việc ngừng sử dụng.
  • Yêu cầu mà bạn đưa ra cần phải có phiên bản API mới hơn để thành công. Đây thường là trường hợp mà một tính năng được giới thiệu trong giao diện người dùng và để API gửi đối tượng chính xác, API này cần có phiên bản API 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ý 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 tới đượ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ể bị đị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
Đăng ký diễn đàn API Ad Manager và xem blog của chúng tôi để nắm bắt những tin tức mới nhất về API Ad Manager.

Lỗi không sắp xếp

Tóm tắt
Tệp XML SOAP trong yêu cầu của bạn không tuân thủ thông số kỹ thuật 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 nằm trong không gian tên không chính xác.
Có kiểu dữ liệu không khớp 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
Hãy đả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à dùng thư viện này để so sánh. Tất cả thư viện ứng dụng đều hỗ trợ tính năng ghi nhật ký các yêu cầu và phản hồi SOAP.