Quy trình làm việc của API

Hướng dẫn này mô tả các quy trình API thông thường để tạo, truy xuất và cập nhật Gói đấu giá trong Display & Video 360.

Lấy danh sách Gói đấu giá

Gọi LIST API. Hỗ trợ lọc theo external_deal_id.

Tạo gói đấu giá mới

1. external_deal_id phải là duy nhất. Gọi hàm LIST với external_deal_id để kiểm tra xem ID đã được sử dụng chưa.
2. Gọi Create API. Một tên duy nhất sẽ được chỉ định và có thể dùng để lấy gói đã tạo.
3. Gọi API Get để xem chi tiết về Gói đấu giá đã tạo.
4. Bạn có thể Tải biểu trưng lên cho gói đã tạo.

Cập nhật gói đấu giá

1. Nếu bạn không lưu Tên Gói Đấu Giá đã tạo, hãy gọi API LIST được lọc theo external_deal_id để lấy Gói Đấu Giá bạn muốn cập nhật.
2. Cập nhật các trường dựa trên kết quả của LIST API.
3. Gọi API Patch để cập nhật Gói đấu giá. Bạn phải nhập updateMask. Tham số này cho biết những trường mà bạn muốn áp dụng nội dung cập nhật. Bạn chỉ có thể đặt những trường được phép cập nhật trong updateMask.

Quy trình thử nghiệm beta

Điểm khác biệt duy nhất giữa phiên bản Beta và GA là trong giai đoạn Beta, các Gói Đấu Giá được tạo phải có trạng thái được đặt thành DISCOVERY_OBJECT_STATUS_PAUSED và trạng thái không thể được cập nhật. Các gói bị TẠM DỪNG sẽ không xuất hiện trong giao diện người dùng DV360. Điều này giúp các sàn giao dịch có thể kiểm thử hoạt động tích hợp API mà không cần hiển thị các gói kiểm thử.

Thông thường, bạn sẽ tạo tất cả các gói "thực" ở trạng thái TẠM DỪNG trong giai đoạn thử nghiệm beta, sau đó kích hoạt chúng trong giai đoạn phát hành rộng rãi.

Hạn mức

2000 gói cước đang hoạt động mỗi lần đổi trả.

2.000 gói bị tạm dừng cho mỗi sàn giao dịch.