Method: media.upload

색인을 생성하기 위해 미디어를 업로드합니다.

업로드 엔드포인트는 직접 및 재개 가능한 업로드 프로토콜을 지원하며 색인 요청 중에 인라인화할 수 없는 대규모 항목을 위한 것입니다. 대용량 콘텐츠의 색인을 생성하려면 다음 단계를 따르세요.

  1. 항목 이름을 사용하여 indexing.datasources.items.upload를 호출하여 업로드 세션을 시작하고 UploadItemRef를 가져옵니다.
  2. media.upload를 호출하여 1단계의 UploadItemRef와 동일한 리소스 이름을 사용하여 콘텐츠를 스트리밍 요청으로 업로드합니다.
  3. indexing.datasources.items.index를 호출하여 항목의 색인을 생성합니다. 1단계의 UploadItemRef로 ItemContent를 채웁니다.

자세한 내용은 REST API를 사용하여 콘텐츠 커넥터 만들기를 참고하세요.

참고: 이 API를 실행하려면 서비스 계정이 필요합니다.

HTTP 요청

  • 업로드 URI, 미디어 업로드 요청:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • 메타데이터 URI, 메타데이터 전용 요청:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
resourceName

string

다운로드 중인 미디어의 이름입니다. ReadRequest.resource_name를 참조하세요.

요청 본문

요청 본문에 Media의 인스턴스가 포함됩니다.

응답 본문

미디어 리소스

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "resourceName": string
}
필드
resourceName

string

미디어 리소스의 이름입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.