Method: projects.databases.documents.createDocument

새 문서를 만듭니다.

HTTP 요청

POST https://firestore.googleapis.com/v1/{parent=projects/*/databases/*/documents/**}/{collectionId}

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 상위 리소스입니다. 예를 들어 projects/{projectId}/databases/{databaseId}/documents 또는 projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}입니다.

collectionId

string

필수 항목입니다. 나열할 parent 기준 컬렉션 ID입니다. 예를 들면 chatrooms입니다.

쿼리 매개변수

매개변수
documentId

string

이 문서에 사용하기 위해 클라이언트가 할당한 문서 ID입니다.

선택사항입니다. 지정하지 않으면 서비스에서 ID를 할당합니다.

mask

object (DocumentMask)

반환할 필드입니다. 설정하지 않으면 모든 필드를 반환합니다.

문서에 이 마스크에 없는 필드가 있으면 해당 필드는 응답에서 반환되지 않습니다.

요청 본문

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

응답 본문

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

승인 범위

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

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

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