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)
  },

  // Union field data can be only one of the following:
  "structData": {
    object
  },
  "jsonData": string
  // End of list of possible types for union field data.
}
필드
name

string

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

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

string

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

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

string

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

object (Content)

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

string

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

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

object (Struct format)

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

object (AclInfo)

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

string (Timestamp format)

출력 전용입니다. 문서의 색인이 마지막으로 생성된 시간입니다. 이 필드가 설정되면 문서가 검색 결과에 반환될 수 있습니다.

이 필드는 OUTPUT_ONLY입니다. 이 필드가 채워지지 않으면 문서가 색인 생성된 적이 없다는 의미입니다.

생성된 출력은 항상 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 필드가 채워집니다.
통합 필드 data. 데이터 표현 struct_data 또는 json_data 중 하나를 제공해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 발생합니다. data은 다음 중 하나여야 합니다.
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를 완전히 삭제합니다.