Method: people.updateContact

기존 담당자의 연락처 데이터를 업데이트합니다. 연락처 이외의 데이터는 수정되지 않습니다. 업데이트할 사용자의 연락처와 관련이 없는 데이터는 모두 무시됩니다. 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

string

서버에서 할당한 사람의 리소스 이름입니다. people/{person_id} 형식의 ASCII 문자열입니다.

쿼리 매개변수

매개변수
updatePersonFields

string (FieldMask format)

필수 항목입니다. 그 사람의 업데이트 필드를 제한하는 필드 마스크입니다. 여러 필드를 쉼표로 구분하여 지정할 수 있습니다. 업데이트된 모든 필드가 대체됩니다. 유효한 값은 다음과 같습니다.

  • addresses
  • 전기
  • 생일
  • 캘린더 URL
  • 고객 데이터
  • 이메일 주소
  • 이벤트
  • 외부 ID
  • 성별
  • imClient
  • 관심분야
  • locales
  • 위치
  • 멤버십
  • 기타 키워드
  • names
  • 닉네임
  • 직업
  • organizations
  • 전화번호
  • 관계
  • SIP주소
  • URL
  • 사용자 정의됨
personFields

string (FieldMask format)

선택사항. 각 사용자가 반환되는 필드를 제한하는 필드 마스크입니다. 여러 필드를 쉼표로 구분하여 지정할 수 있습니다. 설정하지 않으면 기본적으로 모든 필드가 사용됩니다. 유효한 값은 다음과 같습니다.

  • addresses
  • 연령대
  • 전기
  • 생일
  • 캘린더 URL
  • 고객 데이터
  • 표지사진
  • 이메일 주소
  • 이벤트
  • 외부 ID
  • 성별
  • imClient
  • 관심분야
  • locales
  • 위치
  • 멤버십
  • metadata
  • 기타 키워드
  • names
  • 닉네임
  • 직업
  • organizations
  • 전화번호
  • 포토
  • 관계
  • SIP주소
  • 기술
  • URL
  • 사용자 정의됨
sources[]

enum (ReadSourceType)

선택사항. 반환할 소스 유형의 마스크입니다. 설정하지 않을 경우 기본값은 READ_SOURCE_TYPE_CONTACTREAD_SOURCE_TYPE_PROFILE입니다.

요청 본문

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

응답 본문

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/contacts

자세한 내용은 승인 가이드를 참고하세요.