Method: projects.databases.importDocuments

Google Cloud Firestore로 문서를 가져옵니다. 이름이 동일한 기존 문서를 덮어씁니다. 가져오기는 백그라운드에서 이루어지며 생성된 작업 리소스를 통해 진행 상황을 모니터링하고 관리할 수 있습니다. Database.importDocuments 작업이 취소되면 이미 데이터의 하위 집합을 Cloud Firestore로 가져왔을 수 있습니다.

HTTP 요청

POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:importDocuments

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 가져올 데이터베이스입니다. projects/{projectId}/databases/{databaseId} 형식이어야 합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
필드
collectionIds[]

string

가져올 컬렉션 ID입니다. 미지정은 가져오기에 포함된 모든 컬렉션을 의미합니다.

inputUriPrefix

string

내보낸 파일의 위치입니다. 성공적으로 완료된 내보내기의 ExportDocumentsResponse에 대한 outputUriPrefix와 일치해야 합니다. google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix를 참고하세요.

namespaceIds[]

string

빈 목록은 모든 네임스페이스를 나타냅니다. 네임스페이스를 사용하지 않는 데이터베이스에 선호되는 용도입니다.

빈 문자열 요소는 기본 네임스페이스를 나타냅니다. 데이터베이스의 기본이 아닌 네임스페이스에 데이터가 있지만 이를 포함하지 않으려는 경우에 사용해야 합니다. 이 목록의 각 네임스페이스는 고유해야 합니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.