Kể từ ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.

Trang này được dịch bởi Cloud Translation API.

Lỗi và cảnh báo

Trang này thảo luận về các loại lỗi và cảnh báo mà bạn có thể gặp phải khi sử dụng API Display & Video 360.

Lỗi API

Những yêu cầu không thể hoàn tất đối với API sẽ trả về thông báo lỗi. Các yêu cầu trả về lỗi sẽ được tính vào hạn mức của người dùng và sẽ được xem xét khi xem xét các yêu cầu cấp thêm hạn mức. Bạn nên xử lý và xử lý các phản hồi lỗi để tránh lỗi trong tương lai.

Phản hồi lỗi có định dạng sau và bao gồm mã phản hồi HTTP, thông báo lỗi và trạng thái mã RPC của Google:

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

Dưới đây là danh sách các lỗi API thường gặp cùng với hành động được đề xuất nếu các lỗi đó được trả về:

Mã	RPC	Việc nên làm
`400`	`INVALID_ARGUMENT`	Yêu cầu của bạn có một số vấn đề. Xem lại trường thông báo trong phản hồi lỗi và sửa đổi yêu cầu của bạn cho phù hợp.
`401`	`UNAUTHENTICATED`	Không xác thực được yêu cầu của bạn. Xác minh rằng bạn đang thêm thông tin xác thực OAuth hợp lệ vào yêu cầu. Để biết thêm thông tin về vấn đề này, vui lòng tham khảo Hướng dẫn bắt đầu sử dụng 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 cho đối tác hoặc nhà quảng cáo 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 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á giới hạn tốc độ hoặc hạn mức yêu cầu hằng ngày. Kiểm tra mức sử dụng API bằng Google API Console và sửa đổi quy trình làm việc để hoạt động trong giới hạn hạn mức hiện có. Để biết thêm thông tin, vui lòng xem trang của chúng tôi về Tối ưu hoá hạn mức.
`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

API Display & Video 360 sử dụng phương thức không đồng bộ để tạo và tải tệp dữ liệu có cấu trúc (SDF) xuống. Vì lý do này, các lỗi được gửi trong quá trình tạo SDF sẽ được trả về trong tác vụ tải tệp SDF xuống đã hoàn tất. Một tác vụ tải tệp SDF xuống kết thúc trong error được đánh dấu là đã hoàn tất, nhưng có trường lỗi được điền sẵn thay vì tên tài nguyên phương tiện trong trường response, như trong 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 nhận được thông báo lỗi có thể xử lý khi cố gắng tạo SDF, bạn nên làm theo thông báo đó. Nếu thông báo lỗi không rõ ràng về hành động cần thực hiện, bạn nên làm như sau:

Xác minh rằng người dùng của bạn có các quyền thích hợp đối với tài nguyên của đối tác hoặc nhà quảng cáo mẹ.
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, tương ứng với loại tài nguyên dự kiến và nằm trong ngữ cảnh của mã nhận dạng gốc đã cho.
Đảm bảo rằng bạn không vượt quá giới hạn 20 tác vụ tải tệp SDF xuống đồng thời cho mỗi người dùng.

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

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

Cảnh báo không chặn được chỉ định cho mục hàng để cho biết một vấn đề có thể ảnh hưởng đến hoạt động phân phát của mục hàng. Các cảnh báo tương tự được thông báo trong giao diện người dùng thông qua biểu ngữ thông báo. Những cảnh báo này mang tính thụ động và được liệt kê trong trường warningMessages của mục hàng.

Mặc dù mang tính thụ động, nhưng các vấn đề gây ra cảnh báo này có thể ảnh hưởng đến việc phân phát một mục hàng đến mức ngăn chặn hoàn toàn việc phân phát.

Phòng ngừa

Bạn có thể tránh được nhiều vấn đề gây ra cảnh báo không chặn thông qua việc định cấu hình đúng cách các chế độ cài đặt mục hàng, bao gồm:

Lượt phát sóng: Nếu lượt phát sóng của mục hàng không hợp lệ hoặc nếu lượt phát sóng của đơn đặt hàng quảng cáo mẹ đã hết hạn, thì mục hàng sẽ tạo cảnh báo và sẽ không phân phát. Để tránh vấn đề sau, hãy đảm bảo rằng giai đoạn hiển thị của một mục hàng không kết thúc muộn hơn giai đoạn hiển thị của đơn đặt hàng chèn mẹ.
Mẫu quảng cáo được chỉ định: Nếu không có mẫu quảng cáo hợp lệ nào được chỉ định cho mục hàng, thì mục hàng đó sẽ tạo cảnh báo và sẽ không phân phát.
Tiêu chí nhắm mục tiêu: 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, thì mục hàng đó có thể tạo cảnh báo và hoạt động phân phát có thể bị ảnh hưởng hoặc bị ngăn chặn hoàn toàn.

Nếu bạn đang sao chép cấu hình từ một mục hàng hiện có, hãy đảm bảo rằng mục hàng hiện có không tạo ra bất kỳ cảnh báo không lường trước nào.

Giám sát

Các vấn đề gây ra cảnh báo không chặn có thể phát sinh trong khi mục hàng đang trong quá trình phân phối. Để đảm bảo rằng mục hàng của bạn đang phân phát chính xác, hãy theo dõi các mục hàng đang hoạt động để biết cảnh báo mới tạo. Bạn có thể truy xuất hàng loạt mục hàng bằng hàm advertisers.lineItems.list. Nếu một mục hàng đang tạo ra cảnh báo không mong muốn, bạn nên giải quyết vấn đề ngay lập tức để giảm tác động đến hoạt động phân phát.

Vấn đề có thể phát sinh ngay cả khi chế độ cài đặt hoặc tiêu chí nhắm mục tiêu của mục hàng không thay đổi. Ví dụ: tạm dừng hoặc hết hạn thứ tự chèn mẹ và ngừng sử dụng danh sách người dùng hoặc tiêu chí nhắm mục tiêu khác.