Lỗi và cảnh báo

Display & Video 360 API có thể phản hồi bằng một số lỗi và cảnh báo. Một giải pháp API lành mạnh phải xử lý những lỗi này.

Lỗi API

Các yêu cầu không thực hiện được hành động dự kiến đối với API sẽ trả về lỗi. Bạn nên nắm bắt và xử lý các phản hồi lỗi.

Phản hồi lỗi của API có mã phản hồi HTTP, thông báo lỗi và trạng thái mã RPC của Google. Tham số này có định dạng như sau:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Sau đây là danh sách các lỗi API thường gặp và những việc nên làm:

Mã lỗi
`400`	`INVALID_ARGUMENT` Đã xảy ra sự cố với yêu cầu của bạn. Xem lại trường thông báo trong phản hồi lỗi và cập nhật yêu cầu của bạn cho phù hợp.
`401`	`UNAUTHENTICATED` Không thể xác thực đúng yêu cầu của bạn. Xác minh rằng bạn đang thêm thông tin đăng nhập OAuth hợp lệ vào yêu cầu của mình. Để biết thêm thông tin, hãy tham khảo Hướng dẫn bắt đầu nhanh của chúng tôi.
`403`	`PERMISSION_DENIED` Bạn không có các quyền cần thiết để hoàn tất yêu cầu. Xác minh rằng tài khoản người dùng của bạn có các quyền thích hợp đối với đối tác hoặc nhà quảng cáo có liên quan.
`404`	`NOT_FOUND` Không tìm thấy tài nguyên mà bạn đang cố gắng truy xuất. Xác minh rằng mã nhận dạng bạn đang sử dụng là chính xác và dành cho loại tài nguyên đang được truy xuất.
`409`	`ABORTED` Tài nguyên mà bạn đang cố gắng sửa đổi đang được sửa đổi ở nơi khác. Đợi vài giây rồi thử lại yêu cầu.
`429`	`RESOURCE_EXHAUSTED` Bạn đã vượt quá hạn mức tần suất hoặc hạn mức yêu cầu hằng ngày. Sử dụng bảng điều khiển Cloud để kiểm tra mức sử dụng API. Cập nhật quy trình làm việc để thực hiện trong hạn mức hiện có. Để biết thêm thông tin, hãy xem hướng dẫn của chúng tôi về Tối ưu hoá mức sử dụng.
`500`	`INTERNAL` API gặp lỗi nội bộ. Đợi vài giây rồi thử lại yêu cầu. Nếu lỗi vẫn tiếp diễn, hãy liên hệ với nhóm hỗ trợ.
`504`	`DEADLINE_EXCEEDED` API mất quá nhiều thời gian để hoàn tất yêu cầu. Đợi vài giây rồi thử lại yêu cầu. Nếu lỗi vẫn tiếp diễn, hãy liên hệ với nhóm hỗ trợ.

Lỗi SDF

Display & Video 360 API sử dụng các tác vụ chạy trong thời gian dài để tạo Tệp dữ liệu có cấu trúc (SDF). Lỗi khi tạo SDF sẽ được trả về trong operation đã hoàn tất. Trường error sẽ chứa thông tin chi tiết. Hãy xem ví dụ bị cắt ngắn này:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Nếu thông báo lỗi không rõ ràng, bạn nên làm như sau:

Xác minh rằng người dùng của bạn có ít nhất vai trò người dùng Tiêu chuẩn cho đối tác hoặc nhà quảng cáo cấp trên.
Xác nhận rằng các mã nhận dạng được cung cấp trong bộ lọc là chính xác. Các mã nhận dạng này phải tương ứng với loại tài nguyên dự kiến và phải là tài nguyên con của mã nhận dạng gốc.
Đảm bảo rằng người dùng có ít hơn 20 tác vụ tải SDF xuống đồng thời.

Nếu bạn vẫn gặp lỗi, hãy liên hệ với nhóm hỗ trợ.

Cảnh báo không chặn

Cảnh báo không chặn cho biết một vấn đề có thể ảnh hưởng đến việc phân phát quảng cáo của một mục hàng. Bạn sẽ thấy các cảnh báo tương tự trong giao diện người dùng. Những cảnh báo này là cảnh báo thụ động và được liệt kê trong mục hàng.

Nguyên nhân gốc của cảnh báo có thể ảnh hưởng đến việc phân phát một mục hàng. Trong một số trường hợp, điều này có thể ngăn quảng cáo phân phát hoàn toàn.

Phòng ngừa

Một số cảnh báo không chặn là do cấu hình sai của một mục hàng:

Thời gian chạy: Một mục hàng sẽ không phân phát quảng cáo nếu thời gian chạy của mục hàng đó không hợp lệ hoặc nếu thời gian chạy của thứ tự chèn đã hết hạn. Đảm bảo rằng một mục hàng có thời biểu quảng cáo nằm trong thời biểu quảng cáo của đơn đặt hàng quảng cáo.
Mẫu quảng cáo được chỉ định: Mục hàng không thể phân phát nếu bạn không chỉ định một mẫu quảng cáo hợp lệ cho mục hàng đó.
Nhắm mục tiêu: Việc phân phát quảng cáo của một mục hàng có thể bị ảnh hưởng hoặc ngăn chặn hoàn toàn nếu tiêu chí nhắm mục tiêu của mục hàng đó không được chỉ định đúng cách.

Đảm bảo rằng một mục hàng hiện có không tạo ra bất kỳ cảnh báo nào trước khi sử dụng cấu hình của mục hàng đó trong một mục hàng mới.

Giám sát

Cảnh báo không chặn có thể xuất hiện khi một mục hàng đang chạy. Theo dõi các mục hàng đang hoạt động để biết cảnh báo mới và đảm bảo rằng các mục hàng đó đang phân phát đúng cách. Nhận hàng loạt mục hàng bằng yêu cầu list. Nếu một mục hàng trả về cảnh báo không mong muốn, hãy giải quyết vấn đề này càng sớm càng tốt để giảm tác động đến việc phân phát.

Bạn có thể thêm cảnh báo ngay cả khi chế độ cài đặt hoặc tiêu chí nhắm mục tiêu không thay đổi. Ví dụ về vấn đề này bao gồm:

Đơn đặt hàng quảng cáo bị tạm dừng hoặc hết hạn.
Một danh sách người dùng hoặc lựa chọn nhắm mục tiêu không được dùng nữa.