문서를 업데이트하거나 삽입합니다.
HTTP 요청
PATCH https://firestore.googleapis.com/v1/{document.name=projects/*/databases/*/documents/*/**}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
document.name |
문서의 리소스 이름입니다(예: |
쿼리 매개변수
매개변수 | |
---|---|
updateMask |
업데이트할 필드입니다. 마스크의 필드 경로에는 예약된 이름이 포함될 수 없습니다. 문서가 서버에 있고 마스크에서 참조되지 않는 필드가 있는 경우 해당 필드는 변경되지 않습니다. 마스크에서 참조되지만 입력 문서에는 없는 필드는 서버의 문서에서 삭제됩니다. |
mask |
반환할 필드입니다. 설정하지 않으면 모든 필드를 반환합니다. 문서에 이 마스크에 없는 필드가 있으면 해당 필드는 응답에서 반환되지 않습니다. |
currentDocument |
문서의 전제조건(선택사항)입니다. 이 속성이 설정되어 있지만 대상 문서에서 충족되지 않으면 요청이 실패합니다. |
요청 본문
요청 본문에는 Document
의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 Document
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
자세한 내용은 인증 개요를 참조하세요.