Google Contacts

제공 도구 8

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• google_contacts__delete파괴적승인 필요

  연락처 삭제 — 저장된 연락처 하나를 지운다. ⚠️ 이 커넥터로는 되돌릴 수 없다. resource_name 은 google_contacts__search 결과의 resource_name — people/… 만 지울 수 있고 메일에서 자동 수집된 otherContacts/… 는 지울 수 없다. 결과: deleted · resource_name.

• google_contacts__destructive_operation파괴적승인 필요

  Google People API v1 destructive 메서드를 실행한다. operation과 공식 camelCase의 request.path/query/body를 입력한다. ⚠️ 연락처·사진·그룹을 삭제하거나 지정 필드를 대체한다. 삭제는 이 커넥터로 되돌릴 수 없고 대체 전 값은 별도로 보관해야 한다. 변경 전 metadata.sources의 CONTACT etag를 조회한다. 다음 페이지도 같은 조회 조건과 nextPageToken을 사용한다. 디렉터리는 Workspace와 directory.readonly 동의가 필요하다. 결과: 공식 필드·페이지/동기화 토큰·항목별 실패.

• google_contacts__update파괴적승인 필요

  연락처의 지정 필드를 수정한다. ⚠️ 넘긴 항목의 기존 값을 대체하며 되돌리려면 변경 전 값을 다시 써야 한다. resource_name은 google_contacts__search 결과의 값이다. 결과: 변경한 연락처와 갱신된 메타데이터.

• google_contacts__create쓰기

  연락처 추가

• google_contacts__write_operation쓰기

  Google People API v1 write 메서드를 실행한다. operation과 공식 camelCase의 request.path/query/body를 입력한다. 변경 전 metadata.sources의 CONTACT etag를 조회한다. 다음 페이지도 같은 조회 조건과 nextPageToken을 사용한다. 사진은 PNG/JPEG base64 4 MiB 이내다. 디렉터리는 Workspace와 directory.readonly 동의가 필요하다. 결과: 공식 필드·페이지/동기화 토큰·항목별 실패.

• google_contacts__get읽기

  연락처 1건 상세 조회 (이름·이메일·전화·소속)

• google_contacts__read_operation읽기

  Google People API v1 read 메서드를 실행한다. operation과 공식 camelCase의 request.path/query/body를 입력한다. 변경 전 metadata.sources의 CONTACT etag를 조회한다. 다음 페이지도 같은 조회 조건과 nextPageToken을 사용한다. 디렉터리는 Workspace와 directory.readonly 동의가 필요하다. 결과: 공식 필드·페이지/동기화 토큰·항목별 실패.

• google_contacts__search읽기

  연락처 검색 — 이름·이메일로 찾는다. 저장된 연락처와 주고받은 메일에서 수집된 주소를 함께 뒤진다. 메일·일정에 넣을 주소를 알아낼 때 먼저 쓴다. 결과: 사람마다 resource_name · name · email · phone (최대 25건).