Method: projects.databases.documents.commit

트랜잭션을 커밋하고 필요에 따라 문서를 업데이트합니다.

HTTP 요청

POST https://firestore.googleapis.com/v1/{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

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