Method: projects.databases.documents.commit

선택적으로 문서를 업데이트하는 동안 트랜잭션을 커밋합니다.

HTTP 요청

POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:commit

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

경로 매개변수

매개변수
database

string

필수의. 데이터베이스 이름입니다. 형식: projects/{projectId}/databases/{databaseId} .

요청 본문

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

JSON 표현
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
필드
writes[]

object ( Write )

적용하기 위해 씁니다.

항상 원자적으로 순서대로 실행됩니다.

transaction

string ( bytes format)

설정된 경우 이 트랜잭션의 모든 쓰기를 적용하고 커밋합니다.

base64로 인코딩된 문자열입니다.

응답 본문

Firestore.Commit 에 대한 응답입니다.

성공하면 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
필드
writeResults[]

object ( WriteResult )

쓰기를 적용한 결과입니다.

이 i번째 쓰기 결과는 요청의 i번째 쓰기에 해당합니다.

commitTime

string ( Timestamp format)

커밋이 발생한 시간입니다. readTime 이 같거나 그보다 큰 모든 읽기는 커밋의 효과를 볼 수 있도록 보장됩니다.

RFC3339 UTC "Zulu" 형식의 타임스탬프이며 해상도는 나노초이며 최대 9자리 소수 자릿수입니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z" .

승인 범위

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

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

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