기존 담당자의 연락처 데이터를 업데이트합니다. 연락처 이외의 데이터는 수정되지 않습니다. 업데이트할 사용자의 연락처와 관련이 없는 데이터는 모두 무시됩니다. updateMask
에 지정된 모든 필드가 대체됩니다.
연락처를 업데이트할 person.metadata.sources
를 지정하지 않았거나 연락처 소스가 없으면 서버에서 400 오류를 반환합니다.
데이터를 읽은 이후 연락처가 변경되었음을 나타내는 person.metadata.sources.etag
가 연락처의 etag와 다르면 서버에서 "failedPrecondition"
이유와 함께 400 오류를 반환합니다. 고객이 최신 고객을 받고 업데이트를 최신 사용자로 병합해야 합니다.
memberships
를 업데이트하는 중이며 서버에 지정된 연락처 그룹 멤버십이 없으면 서버에서 400 오류를 반환합니다.
연락처 소스의 싱글톤 필드에 필드가 둘 이상 지정된 경우 서버에서 400 오류를 반환합니다.
- 전기
- 생일
- 성별
- names
지연 시간 및 실패를 방지하려면 동일한 사용자에 대한 요청을 순차적으로 전송해야 합니다.
HTTP 요청
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
person.resourceName |
서버에서 할당한 사람의 리소스 이름입니다. |
쿼리 매개변수
매개변수 | |
---|---|
updatePersonFields |
필수 항목입니다. 그 사람의 업데이트 필드를 제한하는 필드 마스크입니다. 여러 필드를 쉼표로 구분하여 지정할 수 있습니다. 업데이트된 모든 필드가 대체됩니다. 유효한 값은 다음과 같습니다.
|
personFields |
선택사항. 각 사용자가 반환되는 필드를 제한하는 필드 마스크입니다. 여러 필드를 쉼표로 구분하여 지정할 수 있습니다. 설정하지 않으면 기본적으로 모든 필드가 사용됩니다. 유효한 값은 다음과 같습니다.
|
sources[] |
선택사항. 반환할 소스 유형의 마스크입니다. 설정하지 않을 경우 기본값은 |
요청 본문
요청 본문에는 Person
의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 Person
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/contacts
자세한 내용은 승인 가이드를 참고하세요.