Partilhar via

Google Contacts

  • Reference

Google Contacts is an online address book, integrated across your Google products and more.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://contacts.google.com/
Privacy policy https://policies.google.com/privacy

To use this integration, you will need a Google account. If you are not a user yet, sign up for a new account. When trying to make a connection, you will be prompted to authenticate against your account. If you have multiple accounts, pick the one you would like to use and Sign in. Once verified, you will need to authorize Microsoft to access your contacts. Click on Allow to continue.

Image 1

You're now ready to start using this integration.

Known issues and limitations

Action "Get my contacts" currently does not support pagination. It returns 1024 contacts maximum. If you have more contacts, only first 1024 will be returned back by the action.

Important

Starting from June 15, 2021 some actions will start to fail due to Google deprecating the endpoints these actions are using. To know about it more, please see the following post from Google: https://developers.google.com/contacts/v3/announcement.

The following actions are affected:

Create a contact; Get my contacts; Get my contacts V2; and When a contact changes.

To avoid interruptions use the following actions:

Create a contact V2; Get my contacts V4; and When a contact changes V3.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Create a contact [DEPRECATED]

This action has been deprecated. Please use Create a contact V3 instead.

Create a contact within Google Contacts
Create a contact V2

Create a contact within Google Contacts V2
Create a contact V3 (Preview)

Create a contact within Google Contacts V3
Get my contacts [DEPRECATED]

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts.
Get my contacts V2 [DEPRECATED]

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts V2.
Get my contacts V3 [DEPRECATED]

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts V3.
Get my contacts V4

Get my contacts V4.

Create a contact [DEPRECATED]

Operation ID:
CreateContact

This action has been deprecated. Please use Create a contact V3 instead.

Create a contact within Google Contacts

Parameters

Name Key Required Type Description
Display Name
 displayName True string

Display name for the contact.
Work Email Address
 workEmail string
Group
 group string

Group to add the contact to.
Company
 company string
Work Phone Number
 workPhoneNumber string
Mobile Phone Number
 mobilePhoneNumber string
Home Email Address
 homeEmail string

Home Email address for the contact.
Other Email Address
 otherEmail string
Nickname
 nickName string
Home Address
 homeAddress string
Work Address
 workAddress string
Other Address
 otherAddress string
Job Title
 jobTitle string
Home Phone Number
 homePhoneNumber string
Other Phone Number
 otherPhoneNumber string
Notes
 notes string

Returns

Name Path Type Description
entry
 entry Entry

Create a contact V2

Operation ID:
PeopleApiCreateContactV2

Create a contact within Google Contacts V2

Parameters

Name Key Required Type Description
Given Name
 givenName True string

Given name for the contact.
Family Name
 familyName string

Family name for the contact.
Work Email Address
 workEmail string
Group
 group string

Group to add the contact to.
Company
 company string
Work Phone Number
 workPhoneNumber string
Mobile Phone Number
 mobilePhoneNumber string
Home Email Address
 homeEmail string

Home Email address for the contact.
Other Email Address
 otherEmail string
Nickname
 nickName string
Home Address
 homeAddress string
Work Address
 workAddress string
Other Address
 otherAddress string
Job Title
 jobTitle string
Home Phone Number
 homePhoneNumber string
Other Phone Number
 otherPhoneNumber string

Returns

Body
PeopleApiConnection

Create a contact V3 (Preview)

Operation ID:
PeopleApiCreateContactV3

Create a contact within Google Contacts V3

Parameters

Name Key Required Type Description
Given Name
 givenName True string

Given name for the contact.
Family Name
 familyName string

Family name for the contact.
Work Email Address
 workEmail string
Group
 group string

Group to add the contact to.
Company
 company string
Work Phone Number
 workPhoneNumber string
Mobile Phone Number
 mobilePhoneNumber string
Home Email Address
 homeEmail string

Home Email address for the contact.
Other Email Address
 otherEmail string
Nickname
 nickName string
Home Address
 homeAddress string
Work Address
 workAddress string
Other Address
 otherAddress string
Job Title
 jobTitle string
Home Phone Number
 homePhoneNumber string
Other Phone Number
 otherPhoneNumber string

Returns

Body
PeopleApiConnectionV2

Get my contacts [DEPRECATED]

Operation ID:
ListContacts

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts.

Returns

Name Path Type Description
Contact
 feed.entry array of Entry

Get my contacts V2 [DEPRECATED]

Operation ID:
ListContactsV2

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts V2.

Returns

Name Path Type Description
Contact
 value array of Entry

Get my contacts V3 [DEPRECATED]

Operation ID:
PeopleApiListContactsV3

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts V3.

Returns

Name Path Type Description
connections
 connections array of PeopleApiConnection

Get my contacts V4

Operation ID:
PeopleApiListContactsV4

Get my contacts V4.

Returns

Name Path Type Description
connections
 connections array of PeopleApiConnectionV2

Triggers

When a contact changes [DEPRECATED]

When a contact changes in Google Contacts.
When a contact changes V2 [DEPRECATED]

This action has been deprecated. Please use When a contact changes V3 instead.

When a contact changes in Google Contacts V2.
When a contact changes V3

When a contact changes in Google Contacts V3.

When a contact changes [DEPRECATED]

Operation ID:
OnContactUpdated

When a contact changes in Google Contacts.

Returns

Name Path Type Description
entry
 feed.entry array of Entry

When a contact changes V2 [DEPRECATED]

Operation ID:
PeopleApiOnContactUpdatedV2

This action has been deprecated. Please use When a contact changes V3 instead.

When a contact changes in Google Contacts V2.

Returns

Name Path Type Description
connections
 connections array of PeopleApiConnection

When a contact changes V3

Operation ID:
PeopleApiOnContactUpdatedV3

When a contact changes in Google Contacts V3.

Returns

Name Path Type Description
connections
 connections array of PeopleApiConnectionV2

Definitions

Entry

Name Path Type Description
Id
 id.$t string

The id of the contact.
Updated DateTime
 updated.$t date-time

The datetime the contact was last updated, in yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z).
Title
 title.$t string

The job title of the contact.
Full Name
 gd$name.gd$fullName.$t string

The full name of the contact.
Given Name
 gd$name.gd$givenName.$t string

The given name of the contact.
Last Name
 gd$name.gd$familyName.$t string

The family name of the contact.
Nickname
 gContact$nickname.$t string

The nickname of the contact.
gd$organization
 gd$organization array of object
Name
 gd$organization.gd$orgName.$t string

The origanization name.
Title
 gd$organization.gd$orgTitle.$t string

The organization title.
Work Email
 workEmail string

The work email address of the contact.
Home Email
 homeEmail string

The home address of the contact.
Other Email
 otherEmail string

The other address of the contact.
Work Phone Number
 workPhoneNumber string

The work phone number of the contact.
Home Phone Number
 homePhoneNumber string

The home phone number of the contact.
Other Phone Number
 otherPhoneNumber string

The other phone number of the contact.
Mobile Phone Number
 mobilePhoneNumber string

The mobile phone number of the contact.
Work Address
 workAddress string

The work address of the contact.
Home Address
 homeAddress string

The home address of the contact.
Other Address
 otherAddress string

The other address of the contact.

PeopleApiConnection

Name Path Type Description
Id
 metadata.source.id string

The id of the contact.
Updated DateTime
 metadata.source.updatedTime date-time

The datetime the contact was last updated, in yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z).
Full Name
 name.displayName string

The full name of the contact.
Given Name
 name.givenName string

The given name of the contact.
Family Name
 name.familyName string

The family name of the contact.
Nickname
 nickname.value string

The nickname of the contact.
organizations
 organizations array of object
Name
 organizations.name string

The origanization name.
Title
 organizations.title string

The organization title.
Work Address
 addressesObject.work.formattedValue string

The work address of the contact.
Home Address
 addressesObject.home.formattedValue string

The home address of the contact.
Other Address
 addressesObject.other.formattedValue string

The other address of the contact.
Work Email
 emailAddressesObject.work.value string

The work email address of the contact.
Home Email
 emailAddressesObject.home.value string

The home email address of the contact.
Other Email
 emailAddressesObject.other.value string

The other email address of the contact.
Work Phone Number
 phoneNumbersObject.work.value string

The work phone number of the contact.
Home Phone Number
 phoneNumbersObject.home.value string

The home phone number of the contact.
Mobile Phone Number
 phoneNumbersObject.mobile.value string

The mobile phone number of the contact.
Other Phone Number
 phoneNumbersObject.other.value string

The other phone number of the contact.

PeopleApiConnectionV2

Name Path Type Description
Id
 metadata.source.id string

The id of the contact.
Updated DateTime
 metadata.source.updateTime date-time

The datetime the contact was last updated, in yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z).
Full Name
 name.displayName string

The full name of the contact.
Given Name
 name.givenName string

The given name of the contact.
Family Name
 name.familyName string

The family name of the contact.
Nickname
 nickname.value string

The nickname of the contact.
organizations
 organizations array of object
Name
 organizations.name string

The origanization name.
Title
 organizations.title string

The organization title.
addresses
 addresses array of object
Address
 addresses.formattedValue string

The address of the contact.
emailAddresses
 emailAddresses array of object
Email
 emailAddresses.value string

The email address of the contact.
Type
 emailAddresses.formattedType string

The type of email address of the contact.
phoneNumbers
 phoneNumbers array of object
Phone Number
 phoneNumbers.value string

The phone number of the contact.
Type
 phoneNumbers.formattedType string

The phone number of the contact.