Google 연락처
Google 연락처는 Google 제품 등에 통합된 온라인 주소록입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://contacts.google.com/ |
| 개인 정보 보호 정책 | https://policies.google.com/privacy |
이 통합을 사용하려면 Google 계정이 필요합니다. 아직 사용자가 아닌 경우 새 계정에 등록 합니다. 연결을 시도할 때 계정에 대해 인증하라는 메시지가 표시됩니다. 계정이 여러 개 있는 경우 사용하려는 계정을 선택하고 로그인합니다. 확인되면 연락처에 액세스하도록 Microsoft에 권한을 부여해야 합니다. 계속하려면 [허용 ]을 클릭합니다.
이제 이 통합을 사용할 준비가 되었습니다.
알려진 문제 및 제한 사항
작업 "내 연락처 가져오기"는 현재 페이지 매김을 지원하지 않습니다. 최대 1024개의 연락처를 반환합니다. 연락처가 더 있는 경우 처음 1024개만 작업에 의해 다시 반환됩니다.
중요합니다
2021년 6월 15일부터 Google이 이러한 작업을 사용하는 엔드포인트를 더 이상 사용하지 않으므로 일부 작업이 실패하기 시작합니다. 그것에 대해 더 알고, 구글에서 다음 게시물을 참조 하세요. https://developers.google.com/contacts/v3/announcement.
영향을 받는 작업은 다음과 같습니다.
연락처 만들기; 내 연락처 가져오기;내 연락처 V2 가져오기; 연락처가 변경되는 경우
중단을 방지하려면 다음 작업을 사용합니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 내 연락처 V2 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 내 연락처 V4 가져오기를 사용하세요.
|
| 내 연락처 V3 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 내 연락처 V4 가져오기를 사용하세요.
|
| 내 연락처 V4 가져오기 |
내 연락처 V4를 가져옵니다. |
| 내 연락처 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 내 연락처 V4 가져오기를 사용하세요.
|
| 연락처 V2 만들기 |
Google Contacts V2 내에서 연락처 만들기 |
| 연락처 V3 만들기(미리 보기) |
Google Contacts V3 내에서 연락처 만들기 |
| 연락처 만들기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 연락처 V3 만들기를 사용하세요.
|
내 연락처 V2 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 내 연락처 V4 가져오기를 사용하세요.
내 연락처 V2를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
연락처
|
value | array of Entry |
내 연락처 V3 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 내 연락처 V4 가져오기를 사용하세요.
내 연락처 V3을 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
내 연락처 V4 가져오기
내 연락처 V4를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
내 연락처 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 내 연락처 V4 가져오기를 사용하세요.
내 연락처를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
연락처
|
feed.entry | array of Entry |
연락처 V2 만들기
Google Contacts V2 내에서 연락처 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름 (주어진 이름)
|
givenName | True | string |
연락처의 지정된 이름입니다. |
|
성
|
familyName | string |
연락처의 가족 이름입니다. |
|
|
회사 전자 메일 주소
|
workEmail | string | ||
|
그룹
|
group | string |
연락처를 추가할 그룹화합니다. |
|
|
회사
|
company | string | ||
|
회사 전화 번호
|
workPhoneNumber | string | ||
|
휴대폰 번호
|
mobilePhoneNumber | string | ||
|
홈 전자 메일 주소
|
homeEmail | string |
연락처의 홈 전자 메일 주소입니다. |
|
|
기타 전자 메일 주소
|
otherEmail | string | ||
|
애칭
|
nickName | string | ||
|
집 주소
|
homeAddress | string | ||
|
회사 주소
|
workAddress | string | ||
|
기타 주소
|
otherAddress | string | ||
|
직위
|
jobTitle | string | ||
|
집 전화 번호
|
homePhoneNumber | string | ||
|
기타 전화 번호
|
otherPhoneNumber | string |
반환
연락처 V3 만들기(미리 보기)
Google Contacts V3 내에서 연락처 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름 (주어진 이름)
|
givenName | True | string |
연락처의 지정된 이름입니다. |
|
성
|
familyName | string |
연락처의 가족 이름입니다. |
|
|
회사 전자 메일 주소
|
workEmail | string | ||
|
그룹
|
group | string |
연락처를 추가할 그룹화합니다. |
|
|
회사
|
company | string | ||
|
회사 전화 번호
|
workPhoneNumber | string | ||
|
휴대폰 번호
|
mobilePhoneNumber | string | ||
|
홈 전자 메일 주소
|
homeEmail | string |
연락처의 홈 전자 메일 주소입니다. |
|
|
기타 전자 메일 주소
|
otherEmail | string | ||
|
애칭
|
nickName | string | ||
|
집 주소
|
homeAddress | string | ||
|
회사 주소
|
workAddress | string | ||
|
기타 주소
|
otherAddress | string | ||
|
직위
|
jobTitle | string | ||
|
집 전화 번호
|
homePhoneNumber | string | ||
|
기타 전화 번호
|
otherPhoneNumber | string |
반환
연락처 만들기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 연락처 V3 만들기를 사용하세요.
Google 연락처 내에서 연락처 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
표시 이름
|
displayName | True | string |
연락처의 표시 이름입니다. |
|
회사 전자 메일 주소
|
workEmail | string | ||
|
그룹
|
group | string |
연락처를 추가할 그룹화합니다. |
|
|
회사
|
company | string | ||
|
회사 전화 번호
|
workPhoneNumber | string | ||
|
휴대폰 번호
|
mobilePhoneNumber | string | ||
|
홈 전자 메일 주소
|
homeEmail | string |
연락처의 홈 전자 메일 주소입니다. |
|
|
기타 전자 메일 주소
|
otherEmail | string | ||
|
애칭
|
nickName | string | ||
|
집 주소
|
homeAddress | string | ||
|
회사 주소
|
workAddress | string | ||
|
기타 주소
|
otherAddress | string | ||
|
직위
|
jobTitle | string | ||
|
집 전화 번호
|
homePhoneNumber | string | ||
|
기타 전화 번호
|
otherPhoneNumber | string | ||
|
비고
|
notes | string |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
entry
|
entry | Entry |
트리거
| 연락처가 V2를 변경하는 경우 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 연락처가 V3을 변경하는 경우를 사용하세요.
|
| 연락처가 V3를 변경하는 경우 |
Google Contacts V3에서 연락처가 변경되는 경우 |
| 연락처가 변경되는 경우 [사용되지 않음] |
Google 연락처에서 연락처가 변경되는 경우 |
연락처가 V2를 변경하는 경우 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 연락처가 V3을 변경하는 경우를 사용하세요.
Google Contacts V2에서 연락처가 변경되는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
연락처가 V3를 변경하는 경우
Google Contacts V3에서 연락처가 변경되는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
연락처가 변경되는 경우 [사용되지 않음]
Google 연락처에서 연락처가 변경되는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
entry
|
feed.entry | array of Entry |
정의
입력
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id.$t | string |
연락처의 ID입니다. |
|
업데이트된 DateTime
|
updated.$t | date-time |
연락처가 마지막으로 업데이트된 날짜/시간(yyyy-MM-ddTHH:mm:ss.fffZ(2016-07-20T08:00:59.000Z)입니다. |
|
제목
|
title.$t | string |
연락처의 직호입니다. |
|
전체 이름
|
gd$name.gd$fullName.$t | string |
연락처의 전체 이름입니다. |
|
이름 (주어진 이름)
|
gd$name.gd$givenName.$t | string |
연락처의 지정된 이름입니다. |
|
성 이름
|
gd$name.gd$familyName.$t | string |
연락처의 가족 이름입니다. |
|
애칭
|
gContact$nickname.$t | string |
연락처의 애칭입니다. |
|
gd$organization
|
gd$organization | array of object | |
|
이름
|
gd$organization.gd$orgName.$t | string |
오리건화 이름입니다. |
|
제목
|
gd$organization.gd$orgTitle.$t | string |
조직 제목입니다. |
|
회사 전자 메일
|
workEmail | string |
연락처의 회사 전자 메일 주소입니다. |
|
홈 전자 메일
|
homeEmail | string |
연락처의 집 주소입니다. |
|
기타 전자 메일
|
otherEmail | string |
연락처의 다른 주소입니다. |
|
회사 전화 번호
|
workPhoneNumber | string |
연락처의 회사 전화 번호입니다. |
|
집 전화 번호
|
homePhoneNumber | string |
연락처의 집 전화 번호입니다. |
|
기타 전화 번호
|
otherPhoneNumber | string |
연락처의 다른 전화 번호입니다. |
|
휴대폰 번호
|
mobilePhoneNumber | string |
연락처의 휴대폰 번호입니다. |
|
회사 주소
|
workAddress | string |
연락처의 회사 주소입니다. |
|
집 주소
|
homeAddress | string |
연락처의 집 주소입니다. |
|
기타 주소
|
otherAddress | string |
연락처의 다른 주소입니다. |
PeopleApiConnection
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
metadata.source.id | string |
연락처의 ID입니다. |
|
업데이트된 DateTime
|
metadata.source.updatedTime | date-time |
연락처가 마지막으로 업데이트된 날짜/시간(yyyy-MM-ddTHH:mm:ss.fffZ(2016-07-20T08:00:59.000Z)입니다. |
|
전체 이름
|
name.displayName | string |
연락처의 전체 이름입니다. |
|
이름 (주어진 이름)
|
name.givenName | string |
연락처의 지정된 이름입니다. |
|
성
|
name.familyName | string |
연락처의 가족 이름입니다. |
|
애칭
|
nickname.value | string |
연락처의 애칭입니다. |
|
organizations
|
organizations | array of object | |
|
이름
|
organizations.name | string |
오리건화 이름입니다. |
|
제목
|
organizations.title | string |
조직 제목입니다. |
|
회사 주소
|
addressesObject.work.formattedValue | string |
연락처의 회사 주소입니다. |
|
집 주소
|
addressesObject.home.formattedValue | string |
연락처의 집 주소입니다. |
|
기타 주소
|
addressesObject.other.formattedValue | string |
연락처의 다른 주소입니다. |
|
회사 전자 메일
|
emailAddressesObject.work.value | string |
연락처의 회사 전자 메일 주소입니다. |
|
홈 전자 메일
|
emailAddressesObject.home.value | string |
연락처의 홈 전자 메일 주소입니다. |
|
기타 전자 메일
|
emailAddressesObject.other.value | string |
연락처의 다른 전자 메일 주소입니다. |
|
회사 전화 번호
|
phoneNumbersObject.work.value | string |
연락처의 회사 전화 번호입니다. |
|
집 전화 번호
|
phoneNumbersObject.home.value | string |
연락처의 집 전화 번호입니다. |
|
휴대폰 번호
|
phoneNumbersObject.mobile.value | string |
연락처의 휴대폰 번호입니다. |
|
기타 전화 번호
|
phoneNumbersObject.other.value | string |
연락처의 다른 전화 번호입니다. |
PeopleApiConnectionV2
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
metadata.source.id | string |
연락처의 ID입니다. |
|
업데이트된 DateTime
|
metadata.source.updateTime | date-time |
연락처가 마지막으로 업데이트된 날짜/시간(yyyy-MM-ddTHH:mm:ss.fffZ(2016-07-20T08:00:59.000Z)입니다. |
|
전체 이름
|
name.displayName | string |
연락처의 전체 이름입니다. |
|
이름 (주어진 이름)
|
name.givenName | string |
연락처의 지정된 이름입니다. |
|
성
|
name.familyName | string |
연락처의 가족 이름입니다. |
|
애칭
|
nickname.value | string |
연락처의 애칭입니다. |
|
organizations
|
organizations | array of object | |
|
이름
|
organizations.name | string |
오리건화 이름입니다. |
|
제목
|
organizations.title | string |
조직 제목입니다. |
|
addresses
|
addresses | array of object | |
|
Address
|
addresses.formattedValue | string |
연락처의 주소입니다. |
|
이메일주소
|
emailAddresses | array of object | |
|
전자 메일
|
emailAddresses.value | string |
연락처의 전자 메일 주소입니다. |
|
유형
|
emailAddresses.formattedType | string |
연락처의 전자 메일 주소 유형입니다. |
|
전화번호
|
phoneNumbers | array of object | |
|
전화 번호
|
phoneNumbers.value | string |
연락처의 전화 번호입니다. |
|
유형
|
phoneNumbers.formattedType | string |
연락처의 전화 번호입니다. |