Contactos do Google
Os Contactos do Google são um livro de endereços online, integrado nos seus produtos Google e muito mais.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | 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 é um usuário, inscreva-se para uma nova conta. Ao tentar estabelecer uma ligação, ser-lhe-á pedido que se autentique na sua conta. Se tiver várias contas, escolha a que pretende utilizar e inicie sessão. Uma vez 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 conhecidos e limitações
A ação "Obter meus contatos" atualmente não suporta paginação. Ele retorna 1024 contatos no máximo. Se você tiver mais contatos, somente o primeiro 1024 será devolvido pela ação.
Importante
A partir de 15 de junho de 2021, algumas ações começarão a falhar devido ao Google depreciar os endpoints que essas ações estão usando. Para saber mais, veja o seguinte post do Google: https://developers.google.com/contacts/v3/announcement.
As seguintes ações são afetadas:
Criar um contacto; Obter os meus contactos; Obter meus contatos V2; e Quando um contato muda.
Para evitar interrupções, use as seguintes ações:
Criar um contato V2; Obter meus contatos V4; e Quando um contato muda V3.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Criar um contacto V2 |
Criar um contato nos Contatos do Google V2 |
| Criar um contacto V3 (Pré-visualização) |
Criar um contacto nos Contactos do Google V3 |
| Criar um contato [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Criar um contato V3 .
|
| Obter meus contatos [DEPRECATED] |
Esta ação foi preterida. Por favor, use Obter meus contatos V4 em vez disso.
|
| Obter meus contatos V2 [DEPRECATED] |
Esta ação foi preterida. Por favor, use Obter meus contatos V4 em vez disso.
|
| Obter meus contatos V3 [DEPRECATED] |
Esta ação foi preterida. Por favor, use Obter meus contatos V4 em vez disso.
|
| Obter meus contatos V4 |
Obter meus contatos V4. |
Criar um contacto V2
Criar um contato nos Contatos do Google V2
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome Próprio
|
givenName | True | string |
Nome próprio do contacto. |
|
Nome de família
|
familyName | string |
Nome de família para o contato. |
|
|
Endereço de e-mail profissional
|
workEmail | string | ||
|
Grupo
|
group | string |
Grupo ao qual adicionar o contato. |
|
|
Empresa
|
company | string | ||
|
Número de telefone do trabalho
|
workPhoneNumber | string | ||
|
Número de telemóvel
|
mobilePhoneNumber | string | ||
|
Endereço de e-mail residencial
|
homeEmail | string |
Início Endereço de e-mail para o contato. |
|
|
Outro endereço de e-mail
|
otherEmail | string | ||
|
Apelido
|
nickName | string | ||
|
Endereço residencial
|
homeAddress | string | ||
|
Endereço de trabalho
|
workAddress | string | ||
|
Outra Morada
|
otherAddress | string | ||
|
Cargo
|
jobTitle | string | ||
|
Número de telefone residencial
|
homePhoneNumber | string | ||
|
Outro número de telefone
|
otherPhoneNumber | string |
Devoluções
- Body
- PeopleApiConnection
Criar um contacto V3 (Pré-visualização)
Criar um contacto nos Contactos do Google V3
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome Próprio
|
givenName | True | string |
Nome próprio do contacto. |
|
Nome de família
|
familyName | string |
Nome de família para o contato. |
|
|
Endereço de e-mail profissional
|
workEmail | string | ||
|
Grupo
|
group | string |
Grupo ao qual adicionar o contato. |
|
|
Empresa
|
company | string | ||
|
Número de telefone do trabalho
|
workPhoneNumber | string | ||
|
Número de telemóvel
|
mobilePhoneNumber | string | ||
|
Endereço de e-mail residencial
|
homeEmail | string |
Início Endereço de e-mail para o contato. |
|
|
Outro endereço de e-mail
|
otherEmail | string | ||
|
Apelido
|
nickName | string | ||
|
Endereço residencial
|
homeAddress | string | ||
|
Endereço de trabalho
|
workAddress | string | ||
|
Outra Morada
|
otherAddress | string | ||
|
Cargo
|
jobTitle | string | ||
|
Número de telefone residencial
|
homePhoneNumber | string | ||
|
Outro número de telefone
|
otherPhoneNumber | string |
Devoluções
Criar um contato [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Criar um contato V3 .
Criar um contato nos Contatos do Google
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome de exibição
|
displayName | True | string |
Nome para exibição do contato. |
|
Endereço de e-mail profissional
|
workEmail | string | ||
|
Grupo
|
group | string |
Grupo ao qual adicionar o contato. |
|
|
Empresa
|
company | string | ||
|
Número de telefone do trabalho
|
workPhoneNumber | string | ||
|
Número de telemóvel
|
mobilePhoneNumber | string | ||
|
Endereço de e-mail residencial
|
homeEmail | string |
Início Endereço de e-mail para o contato. |
|
|
Outro endereço de e-mail
|
otherEmail | string | ||
|
Apelido
|
nickName | string | ||
|
Endereço residencial
|
homeAddress | string | ||
|
Endereço de trabalho
|
workAddress | string | ||
|
Outra Morada
|
otherAddress | string | ||
|
Cargo
|
jobTitle | string | ||
|
Número de telefone residencial
|
homePhoneNumber | string | ||
|
Outro número de telefone
|
otherPhoneNumber | string | ||
|
Observações
|
notes | string |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
introdução
|
entry | Entry |
Obter meus contatos [DEPRECATED]
Esta ação foi preterida. Por favor, use Obter meus contatos V4 em vez disso.
Obter meus contatos.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Contato
|
feed.entry | array of Entry |
Obter meus contatos V2 [DEPRECATED]
Esta ação foi preterida. Por favor, use Obter meus contatos V4 em vez disso.
Obter meus contatos V2.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Contato
|
value | array of Entry |
Obter meus contatos V3 [DEPRECATED]
Esta ação foi preterida. Por favor, use Obter meus contatos V4 em vez disso.
Obter meus contatos V3.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
Obter meus contatos V4
Obter meus contatos V4.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
Acionadores
| Quando um contato muda [DEPRECATED] |
Quando um contato é alterado nos Contatos do Google. |
| Quando um contato muda V2 [DEPRECATED] |
Esta ação foi preterida. Por favor, use Quando um contato muda V3 em vez disso.
|
| Quando um contato muda V3 |
Quando um contato é alterado nos Contatos do Google V3. |
Quando um contato muda [DEPRECATED]
Quando um contato é alterado nos Contatos do Google.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
introdução
|
feed.entry | array of Entry |
Quando um contato muda V2 [DEPRECATED]
Esta ação foi preterida. Por favor, use Quando um contato muda V3 em vez disso.
Quando um contato é alterado nos Contatos do Google V2.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
Quando um contato muda V3
Quando um contato é alterado nos Contatos do Google V3.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnectionV2 |
Definições
Entry
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id.$t | string |
O id do contato. |
|
DateTime atualizado
|
updated.$t | date-time |
A data em que o contato foi atualizado pela última vez, em aaaa-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 Próprio
|
gd$name.gd$givenName.$t | string |
O nome próprio do contacto. |
|
Apelido
|
gd$name.gd$familyName.$t | string |
O nome de família do contacto. |
|
Apelido
|
gContact$nickname.$t | string |
O apelido do contato. |
|
GD$Organização
|
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. |
|
E-mail de trabalho
|
workEmail | string |
O endereço de e-mail profissional do contato. |
|
E-mail residencial
|
homeEmail | string |
O endereço residencial do contato. |
|
Outro Email
|
otherEmail | string |
O outro endereço do contato. |
|
Número de telefone do trabalho
|
workPhoneNumber | string |
O número de telefone de 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 telemóvel
|
mobilePhoneNumber | string |
O número de telemóvel do contacto. |
|
Endereço de trabalho
|
workAddress | string |
O endereço profissional do contato. |
|
Endereço residencial
|
homeAddress | string |
O endereço residencial do contato. |
|
Outra Morada
|
otherAddress | string |
O outro endereço do contato. |
PessoasApiConnection
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
metadata.source.id | string |
O id do contato. |
|
DateTime atualizado
|
metadata.source.updatedTime | date-time |
A data em que o contato foi atualizado pela última vez, em aaaa-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Nome Completo
|
name.displayName | string |
O nome completo do contato. |
|
Nome Próprio
|
name.givenName | string |
O nome próprio do contacto. |
|
Nome de família
|
name.familyName | string |
O nome de família do contacto. |
|
Apelido
|
nickname.value | string |
O apelido do contato. |
|
organizations
|
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 profissional do contato. |
|
Endereço residencial
|
addressesObject.home.formattedValue | string |
O endereço residencial do contato. |
|
Outra Morada
|
addressesObject.other.formattedValue | string |
O outro endereço do contato. |
|
E-mail de trabalho
|
emailAddressesObject.work.value | string |
O endereço de e-mail profissional do contato. |
|
E-mail residencial
|
emailAddressesObject.home.value | string |
O endereço de e-mail residencial do contato. |
|
Outro Email
|
emailAddressesObject.other.value | string |
O outro endereço de e-mail do contato. |
|
Número de telefone do trabalho
|
phoneNumbersObject.work.value | string |
O número de telefone de trabalho do contato. |
|
Número de telefone residencial
|
phoneNumbersObject.home.value | string |
O número de telefone residencial do contato. |
|
Número de telemóvel
|
phoneNumbersObject.mobile.value | string |
O número de telemóvel do contacto. |
|
Outro número de telefone
|
phoneNumbersObject.other.value | string |
O outro número de telefone do contato. |
PessoasApiConnectionV2
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
metadata.source.id | string |
O id do contato. |
|
DateTime atualizado
|
metadata.source.updateTime | date-time |
A data em que o contato foi atualizado pela última vez, em aaaa-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z). |
|
Nome Completo
|
name.displayName | string |
O nome completo do contato. |
|
Nome Próprio
|
name.givenName | string |
O nome próprio do contacto. |
|
Nome de família
|
name.familyName | string |
O nome de família do contacto. |
|
Apelido
|
nickname.value | string |
O apelido do contato. |
|
organizations
|
organizations | array of object | |
|
Nome
|
organizations.name | string |
O nome da origanização. |
|
Title
|
organizations.title | string |
O título da organização. |
|
addresses
|
addresses | array of object | |
|
Address
|
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 e-mail do contato. |
|
Tipo
|
emailAddresses.formattedType | string |
O tipo de endereço de e-mail do contato. |
|
Números de telefone
|
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. |