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ể được đưa vào cùng dòng 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ục để 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 truyền trực tuyến, sử dụng cùng một tên tài nguyên trong UploadItemRef ở bước 1.
  3. Gọi indexing.datasources.items.index để lập chỉ mục mục này. Điền vào 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 ý: Để thực thi API này, bạn cần có một tài khoản dịch vụ.

Yêu cầu HTTP

  • URI tải lên, đối với 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, đối với các yêu cầu chỉ dành cho 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

Tham 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 phương tiện.

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

string

Tên của tài nguyên nội dung nghe nhìn.

Phạm vi cấp phép

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.