Method: advertisers.sdfuploadtasks.upload

Tạo một Tác vụ tải tệp SDF lên. Trả về một Operation.

Tác vụ tải tệp SDF lên là một thao tác không đồng bộ, chạy trong thời gian dài. Loại metadata của toán tử này là SdfUploadTaskMetadata. Nếu yêu cầu thành công, loại response của thao tác sẽ là SdfUploadTask. Phản hồi sẽ không bao gồm các tệp kết quả, sau đó bạn có thể truy xuất các tệp này bằng media.download.

Bạn có thể truy xuất trạng thái hoạt động bằng sdfuploadtask.operations.get.

Bạn có thể tìm thấy mọi lỗi trong error.message. Xin lưu ý rằng error.details dự kiến sẽ trống.

Yêu cầu HTTP

  • URI tải lên, dành cho các yêu cầu tải nội dung nghe nhìn lên:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI siêu dữ liệu, dành cho các yêu cầu chỉ siêu dữ liệu:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
advertiserId

string (int64 format)

Bắt buộc. Mã nhận dạng của nhà quảng cáo mà bạn muốn tải tệp SDF lên.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Trường
filename

string

Bắt buộc. Tên tệp của thành phần, bao gồm cả đuôi tệp. Tên tệp phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.
sdfVersion

enum (SdfVersion)

Bắt buộc. Phiên bản SDF của tệp đã tải lên. Nếu được đặt thành SDF_VERSION_UNSPECIFIED, giá trị này sẽ mặc định là phiên bản do nhà quảng cáo được xác định chỉ định. Nhà quảng cáo kế thừa phiên bản SDF từ đối tác, trừ phi được định cấu hình khác.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/display-video

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.