Tải nội dung nghe nhìn lên

Tính năng tải tệp nghe nhìn lên cho phép bạn lưu trữ dữ liệu mà bạn có thể sử dụng trong Display & Video 360. Loại dữ liệu mà người dùng có thể muốn tải lên bao gồm ảnh, video, tệp ZIP, v.v.

Lựa chọn tải lên

Display & Video 360 API cho phép bạn tải lên một số loại dữ liệu nhị phân hoặc nội dung nghe nhìn. Các đặc điểm của dữ liệu mà bạn có thể tải lên được trình bày chi tiết trong hướng dẫn dành cho nhà phát triển cho mọi tác vụ yêu cầu tải nội dung đa phương tiện lên:

  • Kích thước tối đa của tệp tải lên: là dung lượng dữ liệu tối đa mà bạn có thể lưu trữ qua phương thức này.
  • Các loại MIME nội dung đa phương tiện được chấp nhận: là các loại dữ liệu nhị phân bạn có thể lưu trữ bằng phương thức này.

Bạn có thể gửi yêu cầu tải lên theo bất kỳ cách nào sau đây. Chỉ định phương thức bạn đang sử dụng bằng tham số uploadType.

  • Tải lên đơn giản: uploadType=media. Chuyển nhanh các tệp có dung lượng khoảng 5 MB trở xuống.
  • Tải nhiều phần lên: uploadType=multipart. Một cách chuyển nhanh cho các tệp và siêu dữ liệu có liên quan. Chuyển tệp và siêu dữ liệu trong một yêu cầu duy nhất.

Khi tải nội dung nghe nhìn lên, bạn sẽ sử dụng URI /upload. Sử dụng URI này khi chuyển dữ liệu của nội dung đa phương tiện.

Ví dụ:

  POST /upload/media/resource-name

Tải lên đơn giản

Yêu cầu tải lên đơn giản là phương thức dễ dàng nhất để tải tệp lên. Đây là lựa chọn phù hợp khi:

  • Dung lượng tệp nhỏ vừa đủ để tải lại nếu cần.
  • Không bao gồm siêu dữ liệu. Đây là cách phù hợp nếu siêu dữ liệu không cần thiết hoặc được đưa vào một nơi khác trong yêu cầu.

Để sử dụng tính năng tải lên đơn giản, hãy tạo yêu cầu POST hoặc PUT đến URI /upload của phương thức và thêm tham số truy vấn uploadType=media. Ví dụ:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

Các tiêu đề HTTP cần sử dụng khi thực hiện một thao tác tải lên đơn giản bao gồm:

  • Content-Type. Đặt thành một trong các loại dữ liệu nội dung đa phương tiện được chấp nhận của phương thức.
  • Content-Length. Đặt thành số byte tương ứng mà bạn đang tải lên. Không bắt buộc nếu bạn sử dụng mã hoá chuyển dữ liệu chia nhỏ.

Tải nhiều phần lên

Nếu muốn gửi siêu dữ liệu cùng với dữ liệu cần tải lên, bạn có thể thực hiện một yêu cầu multipart/related. Đây là lựa chọn phù hợp nếu dữ liệu bạn gửi đủ nhỏ để tải lên lại (nếu cần).

Để sử dụng tính năng tải lên nhiều phần, hãy tạo yêu cầu POST hoặc PUT đến URI /upload của phương thức và thêm tham số truy vấn uploadType=multipart. Ví dụ:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

Tiêu đề HTTP cấp cao nhất cần thực hiện khi tạo một yêu cầu tải lên nhiều phần bao gồm:

  • Content-Type. Đặt thành multipart/related và chứa chuỗi ranh giới mà bạn sử dụng để xác định các phần của yêu cầu.
  • Content-Length. Đặt thành tổng số byte trong nội dung của yêu cầu. Phần nội dung nghe nhìn của yêu cầu phải nhỏ hơn kích thước tệp tối đa được chỉ định cho phương thức này.

Nội dung của yêu cầu được định dạng dưới dạng loại nội dung multipart/related [RFC2387] và chứa đúng hai phần. Mỗi phần được xác định bằng một chuỗi ranh giới, và theo sau chuỗi ranh giới cuối cùng là hai dấu gạch nối.

Mỗi phần của yêu cầu nhiều phần cần có một tiêu đề Content-Type bổ sung:

  1. Phần siêu dữ liệu: Phải đứng trước và Content-Type phải khớp với một trong các định dạng siêu dữ liệu được chấp nhận.
  2. Phần âm thanh: Phải đứng thứ hai và Content-Type phải khớp với một trong các loại MIME nội dung đa phương tiện được chấp nhận của phương thức.

Ví dụ

Bạn tải nội dung nghe nhìn lên bằng Display & Video 360 API để thực hiện nhiều việc. Phần này cung cấp các ví dụ dưới dạng yêu cầu curl.

Tải thành phần mẫu quảng cáo lên

Sau đây là cách tải một thành phần mẫu quảng cáo lên:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Hãy xem hướng dẫn Tải thành phần mẫu quảng cáo lên để biết thêm thông tin chi tiết và ví dụ về mã.

Tải tệp tập lệnh đặt giá thầu tuỳ chỉnh lên

Sau đây là cách tải tệp tập lệnh lên:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Hãy xem hướng dẫn về Tập lệnh tải lên để biết thêm thông tin chi tiết và ví dụ về mã.