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à tiếp nối, đồng thời dành cho các mục lớn không thể đặt cùng dòng trong các yêu cầu lập chỉ mục. Để 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 từ UploadItemRef từ bước 1.
  3. Gọi indexing.datasources.items.index để lập chỉ mục mục. Điền sẵ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 bạn phải có tài khoản dịch vụ để thực thi.

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ỉ 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

Các 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 về nội dung đa phương tiện.

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

string

Tên của tài nguyên nội dung đa 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.