Contatos do Google
O Google Contacts é um catálogo de endereços online, integrado em seus produtos do Google e muito mais.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://contacts.google.com/ |
| Política de privacidade | https://policies.google.com/privacy |
Para usar essa integração, você precisará de uma conta do Google. Se você ainda não for um usuário, inscreva-se para uma nova conta. Ao tentar fazer uma conexão, você será solicitado a se autenticar em sua conta. Se você tiver várias contas, escolha a que deseja usar e entre. Depois de verificado, você precisará autorizar a Microsoft a acessar seus contatos. Clique em Permitir para continuar.
Agora você está pronto para começar a usar essa integração.
Problemas e limitações conhecidos
A ação "Obter meus contatos" atualmente não dá suporte à paginação. Ele retorna no máximo 1.024 contatos. Se você tiver mais contatos, somente o primeiro 1024 será retornado pela ação.
Importante
A partir de 15 de junho de 2021, algumas ações começarão a falhar devido ao Google ter preterido os pontos de extremidade que essas ações estão usando. Para saber mais sobre isso, confira a seguinte postagem do Google: https://developers.google.com/contacts/v3/announcement.
As seguintes ações são afetadas:
Criar um contato; Obter meus contatos; Obter meus contatos V2; e quando um contato é alterado.
Para evitar interrupções, use as seguintes ações:
Criar um contato V2; Obter meus contatos V4; e quando um contato altera a V3.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Criar um contato [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Criar um contato V3 .
|
| Criar um contato V2 |
Criar um contato no Google Contacts V2 |
| Criar um contato V3 (versão prévia) |
Criar um contato no Google Contacts V3 |
| Obter meus contatos [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get my contacts V4 .
|
| Obter meus contatos V2 [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get my contacts V4 .
|
| Obter meus contatos V3 [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Get my contacts V4 .
|
| Obter meus contatos V4 |
Obtenha meus contatos V4. |
Criar um contato [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Criar um contato V3 .
Criar um contato dentro dos Contatos do Google
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de Exibição
|
displayName | True | string |
Nome de exibição para o contato. |
|
Endereço de email de trabalho
|
workEmail | string | ||
|
Grupo
|
group | string |
Agrupe para adicionar o contato. |
|
|
Empresa
|
company | string | ||
|
Número de telefone de trabalho
|
workPhoneNumber | string | ||
|
Número de telefone celular
|
mobilePhoneNumber | string | ||
|
Endereço de Email Inicial
|
homeEmail | string |
Endereço de email inicial para o contato. |
|
|
Outro endereço de email
|
otherEmail | string | ||
|
Nickname
|
nickName | string | ||
|
Endereço Residencial
|
homeAddress | string | ||
|
Endereço de trabalho
|
workAddress | string | ||
|
Outro Endereço
|
otherAddress | string | ||
|
Cargo
|
jobTitle | string | ||
|
Número de telefone residencial
|
homePhoneNumber | string | ||
|
Outro número de telefone
|
otherPhoneNumber | string | ||
|
Anotações
|
notes | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
entrada
|
entry | Entry |
Criar um contato V2
Criar um contato no Google Contacts V2
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
givenName | True | string |
Nome fornecido para o contato. |
|
Sobrenome
|
familyName | string |
Nome da família para o contato. |
|
|
Endereço de email de trabalho
|
workEmail | string | ||
|
Grupo
|
group | string |
Agrupe para adicionar o contato. |
|
|
Empresa
|
company | string | ||
|
Número de telefone de trabalho
|
workPhoneNumber | string | ||
|
Número de telefone celular
|
mobilePhoneNumber | string | ||
|
Endereço de Email Inicial
|
homeEmail | string |
Endereço de email inicial para o contato. |
|
|
Outro endereço de email
|
otherEmail | string | ||
|
Nickname
|
nickName | string | ||
|
Endereço Residencial
|
homeAddress | string | ||
|
Endereço de trabalho
|
workAddress | string | ||
|
Outro Endereço
|
otherAddress | string | ||
|
Cargo
|
jobTitle | string | ||
|
Número de telefone residencial
|
homePhoneNumber | string | ||
|
Outro número de telefone
|
otherPhoneNumber | string |
Retornos
- Corpo
- PeopleApiConnection
Criar um contato V3 (versão prévia)
Criar um contato no Google Contacts V3
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
givenName | True | string |
Nome fornecido para o contato. |
|
Sobrenome
|
familyName | string |
Nome da família para o contato. |
|
|
Endereço de email de trabalho
|
workEmail | string | ||
|
Grupo
|
group | string |
Agrupe para adicionar o contato. |
|
|
Empresa
|
company | string | ||
|
Número de telefone de trabalho
|
workPhoneNumber | string | ||
|
Número de telefone celular
|
mobilePhoneNumber | string | ||
|
Endereço de Email Inicial
|
homeEmail | string |
Endereço de email inicial para o contato. |
|
|
Outro endereço de email
|
otherEmail | string | ||
|
Nickname
|
nickName | string | ||
|
Endereço Residencial
|
homeAddress | string | ||
|
Endereço de trabalho
|
workAddress | string | ||
|
Outro Endereço
|
otherAddress | string | ||
|
Cargo
|
jobTitle | string | ||
|
Número de telefone residencial
|
homePhoneNumber | string | ||
|
Outro número de telefone
|
otherPhoneNumber | string |
Retornos
- Corpo
- PeopleApiConnectionV2
Obter meus contatos [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get my contacts V4 .
Obtenha meus contatos.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contato
|
feed.entry | array of Entry |
Obter meus contatos V2 [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get my contacts V4 .
Obtenha meus contatos V2.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contato
|
value | array of Entry |
Obter meus contatos V3 [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Get my contacts V4 .
Obtenha meus contatos V3.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
Obter meus contatos V4
Obtenha meus contatos V4.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
Gatilhos
| Quando um contato altera a V3 |
Quando um contato é alterado no Google Contacts V3. |
| Quando um contato altera v2 [PRETERIDO] |
Esta ação foi preterida. Use quando um contato alterar a V3 .
|
| Quando um contato é alterado [PRETERIDO] |
Quando um contato é alterado nos Contatos do Google. |
Quando um contato altera a V3
Quando um contato é alterado no Google Contacts V3.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
Quando um contato altera v2 [PRETERIDO]
Esta ação foi preterida. Use quando um contato alterar a V3 .
Quando um contato é alterado no Google Contacts V2.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
Quando um contato é alterado [PRETERIDO]
Quando um contato é alterado nos Contatos do Google.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
entrada
|
feed.entry | array of Entry |
Definições
Entry
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id.$t | string |
A ID do contato. |
|
DateTime atualizado
|
updated.$t | date-time |
O datetime em que o contato foi atualizado pela última vez, em yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Title
|
title.$t | string |
O cargo do contato. |
|
Nome Completo
|
gd$name.gd$fullName.$t | string |
O nome completo do contato. |
|
Nome
|
gd$name.gd$givenName.$t | string |
O nome fornecido do contato. |
|
Apelido
|
gd$name.gd$familyName.$t | string |
O nome da família do contato. |
|
Nickname
|
gContact$nickname.$t | string |
O apelido do contato. |
|
gd$organization
|
gd$organization | array of object | |
|
Nome
|
gd$organization.gd$orgName.$t | string |
O nome da origanização. |
|
Title
|
gd$organization.gd$orgTitle.$t | string |
O título da organização. |
|
Email de trabalho
|
workEmail | string |
O endereço de email de trabalho do contato. |
|
Email Inicial
|
homeEmail | string |
O endereço residencial do contato. |
|
Outros Emails
|
otherEmail | string |
O outro endereço do contato. |
|
Número de telefone de trabalho
|
workPhoneNumber | string |
O número de telefone do trabalho do contato. |
|
Número de telefone residencial
|
homePhoneNumber | string |
O número de telefone residencial do contato. |
|
Outro número de telefone
|
otherPhoneNumber | string |
O outro número de telefone do contato. |
|
Número de telefone celular
|
mobilePhoneNumber | string |
O número de telefone celular do contato. |
|
Endereço de trabalho
|
workAddress | string |
O endereço de trabalho do contato. |
|
Endereço Residencial
|
homeAddress | string |
O endereço residencial do contato. |
|
Outro Endereço
|
otherAddress | string |
O outro endereço do contato. |
PeopleApiConnection
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
metadata.source.id | string |
A ID do contato. |
|
DateTime atualizado
|
metadata.source.updatedTime | date-time |
O datetime em que o contato foi atualizado pela última vez, em yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Nome Completo
|
name.displayName | string |
O nome completo do contato. |
|
Nome
|
name.givenName | string |
O nome fornecido do contato. |
|
Sobrenome
|
name.familyName | string |
O nome da família do contato. |
|
Nickname
|
nickname.value | string |
O apelido do contato. |
|
organizações
|
organizations | array of object | |
|
Nome
|
organizations.name | string |
O nome da origanização. |
|
Title
|
organizations.title | string |
O título da organização. |
|
Endereço de trabalho
|
addressesObject.work.formattedValue | string |
O endereço de trabalho do contato. |
|
Endereço Residencial
|
addressesObject.home.formattedValue | string |
O endereço residencial do contato. |
|
Outro Endereço
|
addressesObject.other.formattedValue | string |
O outro endereço do contato. |
|
Email de trabalho
|
emailAddressesObject.work.value | string |
O endereço de email de trabalho do contato. |
|
Email Inicial
|
emailAddressesObject.home.value | string |
O endereço de email residencial do contato. |
|
Outros Emails
|
emailAddressesObject.other.value | string |
O outro endereço de email do contato. |
|
Número de telefone de trabalho
|
phoneNumbersObject.work.value | string |
O número de telefone do trabalho do contato. |
|
Número de telefone residencial
|
phoneNumbersObject.home.value | string |
O número de telefone residencial do contato. |
|
Número de telefone celular
|
phoneNumbersObject.mobile.value | string |
O número de telefone celular do contato. |
|
Outro número de telefone
|
phoneNumbersObject.other.value | string |
O outro número de telefone do contato. |
PeopleApiConnectionV2
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
metadata.source.id | string |
A ID do contato. |
|
DateTime atualizado
|
metadata.source.updateTime | date-time |
O datetime em que o contato foi atualizado pela última vez, em yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Nome Completo
|
name.displayName | string |
O nome completo do contato. |
|
Nome
|
name.givenName | string |
O nome fornecido do contato. |
|
Sobrenome
|
name.familyName | string |
O nome da família do contato. |
|
Nickname
|
nickname.value | string |
O apelido do contato. |
|
organizações
|
organizations | array of object | |
|
Nome
|
organizations.name | string |
O nome da origanização. |
|
Title
|
organizations.title | string |
O título da organização. |
|
endereços
|
addresses | array of object | |
|
Endereço
|
addresses.formattedValue | string |
O endereço do contato. |
|
endereços de e-mail
|
emailAddresses | array of object | |
|
Email
|
emailAddresses.value | string |
O endereço de email do contato. |
|
Tipo
|
emailAddresses.formattedType | string |
O tipo de endereço de email do contato. |
|
phoneNumbers
|
phoneNumbers | array of object | |
|
Número de Telefone
|
phoneNumbers.value | string |
O número de telefone do contato. |
|
Tipo
|
phoneNumbers.formattedType | string |
O número de telefone do contato. |