Importante: migre seus scripts do serviço Contatos para o serviço avançado da API People antes que o Apps Script encerre o serviço do Contatos em março de 2023.
O Apps Script suspendeu o uso do serviço Contatos em 16 de dezembro de 2022. Em vez disso, use o serviço avançado da API People. A API People usa um protocolo JSON mais recente e fornece recursos avançados, como mesclar contatos com perfis.
Use este guia para saber quais métodos do serviço Contatos não têm equivalente no serviço avançado da API People, saber quais métodos podem ser usados e encontrar exemplos de código para migrar tarefas comuns. Para mais informações, consulte o Guia de migração da API Contacts.
Métodos sem equivalentes da API People
A seguir, listamos os métodos getContacts
no serviço Contatos que não têm maneiras equivalentes de pesquisar contatos no serviço avançado da API People. Com o serviço avançado da API People, é possível pesquisar pelos campos names
, nickNames
, emailAddresses
, phoneNumbers
e organizations
de um contato da origem CONTACT
.
Métodos sem equivalentes |
---|
|
A seguir, estão listados os métodos getContacts
do serviço Contatos que usam um
parâmetro label
extra. Você pode usar searchContacts
do serviço avançado da API People para receber contatos pelo campo equivalente,
mas não é possível limitar a pesquisa a um marcador específico.
Métodos com equivalentes parciais |
---|
|
Outros recursos disponíveis com a API People
Ao migrar para o serviço avançado da API People, você poderá acessar os seguintes recursos da API People que não estão disponíveis no serviço Contatos:
- Especificar a origem de dados: ao pesquisar informações sobre uma pessoa, você pode especificar onde pesquisar, como um contato ou um perfil do Google.
- Pesquisar pessoas por uma string de consulta: você pode ver uma lista de perfis e contatos que correspondem a uma string específica.
- Solicitações em lote: você pode agrupar suas chamadas da API People para reduzir o tempo de execução do script.
Exemplos de código para tarefas comuns
Esta seção lista tarefas comuns do serviço Contatos. Os exemplos de código mostram como construir as tarefas usando o serviço avançado da API People.
Recuperar um grupo de contatos por nome
O exemplo de código a seguir mostra como receber um grupo de contatos pelo nome, que é equivalente a getContactGroup(name)
no serviço Contatos.
Receber um contato por endereço de e-mail
O exemplo de código a seguir mostra como receber um contato pelo endereço de e-mail,
que é equivalente a getContact(emailAddress)
no serviço Contatos.
Reunir todos os contatos
O exemplo de código a seguir mostra como receber todos os contatos de um usuário, que é
o
equivalente a getContacts()
no serviço Contatos.
Conferir o nome completo de um contato
O exemplo de código a seguir mostra como ver o nome completo de um contato, que é o
equivalente a getFullName()
no serviço Contatos.
Recuperar todos os números de telefone de um contato
O exemplo de código a seguir mostra como receber todos os números de telefone de um
contato, que é equivalente a getPhones()
no serviço Contatos.
Conferir um número de telefone específico de um contato
O exemplo de código a seguir mostra como conseguir um número de telefone específico de um
contato, que é equivalente a getPhoneNumber()
no serviço Contatos.