Method: media.upload

Tải nội dung nghe nhìn lên để lập chỉ mục.

Điểm cuối tải lên hỗ trợ các giao thức tải lên trực tiếp và có thể tiếp tục, đồng thời dành cho các mục lớn không thể nội tuyến trong các yêu cầu lập chỉ mục. Cách lập chỉ mục nội dung lớn:

  1. Gọi indexing.datasources.items.upload bằng tên mặt hàng để bắt đầu phiên tải lên và truy xuất UploadItemRef.
  2. Gọi media.upload để tải nội dung lên dưới dạng yêu cầu phát trực tuyến, sử dụng cùng một tên tài nguyên từ UploadItemRef ở bước 1.
  3. Gọi indexing.datasources.items.index để lập chỉ mục mục. Điền ItemContent bằng UploadItemRef từ bước 1.

Để biết thêm thông tin, hãy xem bài viết Tạo trình kết nối nội dung bằng API REST.

Lưu ý: API này yêu cầu một tài khoản dịch vụ để thực thi.

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://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI siêu dữ liệu, dành cho các yêu cầu chỉ siêu dữ liệu:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

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

Tham số đường dẫn

Thông số
resourceName

string

Tên của nội dung nghe nhìn đang được tải xuống. Vui lòng xem ReadRequest.resource_name.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Media.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Tài nguyên nội dung nghe nhìn.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Tên của tài nguyên phương tiện.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.