REST Resource: projects.locations.dataStores.branches.documents

리소스: Document

Document는 추천하거나 검색할 항목의 모든 원시 메타데이터 정보를 캡처합니다.

JSON 표현 
{
  "name": string,
  "id": string,
  "schemaId": string,
  "content": {
    object (Content)
  },
  "parentDocumentId": string,
  "derivedStructData": {
    object
  },
  "aclInfo": {
    object (AclInfo)
  },
  "indexTime": string,
  "indexStatus": {
    object (IndexStatus)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structData": {
    object
  },
  "jsonData": string
  // End of mutually exclusive fields.
}
필드
name

string

변경할 수 없습니다. 문서의 전체 리소스 이름입니다. 형식은 projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}입니다.

이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이 제한은 1024자(영문 기준)입니다.
id

string

변경할 수 없습니다. 문서의 식별자입니다.

ID는 RFC-1034 표준을 준수해야 하며 길이 제한은 128자(영문 기준)입니다.
schemaId

string

같은 데이터 스토어에 있는 스키마의 식별자입니다.
content

object (Content)

이 문서에 연결된 비정형 데이터입니다. 이 문서가 CONTENT_REQUIRED 데이터 스토어에 있는 경우에만 콘텐츠를 설정할 수 있으며 설정해야 합니다.
parentDocumentId

string

상위 문서 ID입니다. 현재 최대 2단계 문서 계층 구조를 지원합니다.

ID는 RFC-1034 표준을 준수해야 하며 길이 제한은 63자(영문 기준)입니다.
derivedStructData

object (Struct format)

출력 전용입니다. 이 필드는 OUTPUT_ONLY입니다. 원본 입력 문서에 없는 파생 데이터가 포함되어 있습니다.
aclInfo

object (AclInfo)

문서의 액세스 제어 정보입니다.
indexTime

string (Timestamp format)

출력 전용입니다. 문서가 마지막으로 색인 생성된 시간입니다.

이 필드가 채워져 있으면 문서가 색인 생성되었음을 의미합니다. 문서는 일반적으로 색인 생성 후 몇 초 이내에 검색 가능해지지만, 경우에 따라 최대 몇 시간이 걸릴 수도 있습니다.

이 필드가 채워져 있지 않으면 문서가 색인 생성된 적이 없음을 의미합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
indexStatus

object (IndexStatus)

출력 전용입니다. 문서의 색인 상태입니다.

  • 문서가 색인 생성되면 indexTime 필드가 채워집니다.
  • 그렇지 않고 오류로 인해 문서가 색인 생성되지 않으면 errorSamples 필드가 채워집니다.
  • 그렇지 않고 문서의 색인이 진행 중이면 pendingMessage 필드가 채워집니다.
데이터 표현입니다. struct_data 또는 json_data 중 하나를 제공해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 발생합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
structData

object (Struct format)

문서의 정형 JSON 데이터입니다. 등록된 Schema를 준수해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 발생합니다.
jsonData

string

문서의 JSON 문자열 표현입니다. 등록된 Schema를 준수해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 발생합니다.
상호 배타적인 필드의 끝입니다.

메서드

create

 Document를 만듭니다.

delete

 Document를 삭제합니다.

get

 Document를 가져옵니다.

import

 여러 Document를 일괄 가져옵니다.

list

 Document 목록을 가져옵니다.

patch

 Document를 업데이트합니다.

purge

 브랜치에서 선택한 모든 Document를 영구적으로 삭제합니다.