Obsoleto. Em vez disso, use o serviço avançado da API People.
Essa classe permite que os usuários acessem os próprios Contatos do Google e criem, removam e atualizem os contatos listados nela.
Propriedades descontinuadas
Propriedade | Tipo | Descrição |
---|---|---|
ExtendedField |
| |
Field |
| |
Gender |
| |
Month | Month | |
Priority |
| |
Sensitivity |
|
Métodos obsoletos
Método | Tipo de retorno | Breve descrição |
---|---|---|
|
| Cria um novo contato. |
|
| Cria um grupo de contatos com o nome fornecido |
| void | Exclui o contato. |
| void | Exclui o grupo de contatos |
|
| Encontra um contato com o endereço de e-mail fornecido. |
|
| Encontra um grupo de contatos com o nome fornecido. |
|
| Extrai todos os contatos que pertencem a este usuário. |
|
| Recebe um contato pelo endereço de e-mail. |
|
| Extrai o contato com esse ID. |
|
| Extrai um grupo de contatos com o nome fornecido ou retorna nulo se nenhum grupo de contatos for encontrado. |
|
| Recebe um grupo de contatos com o ID fornecido ou retorna nulo se nenhum grupo de contatos for encontrado. |
|
| Extrai a lista completa dos grupos de contatos do usuário. |
|
| Mostra todos os contatos do usuário. |
|
| Fazer com que os contatos correspondam a um endereço. |
|
| Acessar contatos que correspondam a um endereço, limitados a um campo específico. |
|
| Obtenha contatos que correspondam a um endereço, limitado ao marcador de endereço personalizado especificado. |
|
| Obtenha contatos que correspondam ao campo da empresa. |
|
| Obtenha contatos que correspondam a um determinado valor em um campo personalizado. |
|
| Obtenha contatos que correspondam a um determinado mês e dia para um campo padrão específico. |
|
| Obtenha contatos que correspondam a um determinado mês, dia e ano para um campo padrão específico. |
|
| Obtenha contatos que correspondam a um determinado mês, dia e ano para um campo personalizado específico. |
|
| Obtenha contatos que correspondam a um determinado mês e dia para um campo personalizado específico. |
|
| Encontrar contatos que correspondam a um endereço de e-mail. |
|
| Acessar contatos que correspondam a um endereço de e-mail, limitados a um campo específico. |
|
| Receba contatos que correspondam a um endereço de e-mail, limitado ao marcador de endereço de e-mail personalizado especificado. |
|
| Acessa os contatos em um determinado ContactGroup. |
|
| Obtenha contatos que correspondam a um endereço de mensagem instantânea. |
|
| Obtenha contatos que correspondam a um endereço de mensagem instantânea, limitado a um campo específico. |
|
| Receber contatos correspondentes a um endereço de mensagem instantânea, limitado ao rótulo de mensagem instantânea personalizado especificado. |
|
| encontre contatos que correspondam ao campo do cargo. |
|
| Encontrar contatos que correspondam a um nome. |
|
| Acessar contatos que correspondam a um nome, limitado a um campo específico. |
|
| Faça com que os contatos correspondam ao campo de notas. |
|
| Fazer com que os contatos correspondam a um número de telefone. |
|
| Acessar contatos correspondentes a um número de telefone, limitados a um campo específico. |
|
| Obtenha contatos de um número de telefone limitado ao marcador de número de telefone personalizado especificado. |
|
| Obtenha contatos que correspondam a um URL. |
|
| Acessar contatos que correspondam a um URL, limitado a um campo específico. |
|
| Obtenha contatos que correspondam a um URL, limitado ao marcador do URL personalizado especificado. |
Métodos obsoletos
createContact(givenName, familyName, email)
createContact(givenName, familyName, email)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Cria um novo contato.
// The code below creates a new contact with the name "John Doe" and the email address // "john.doe@example.com". var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
givenName | String | o nome do contato |
familyName | String | o sobrenome do contato |
email | String | o endereço de e-mail do contato |
Retorno
: o objeto de contato recém-criado.Contact
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
createContactGroup(name)
createContactGroup(name)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Cria um grupo de contatos com o nome fornecido
// The code below creates a new contact group named "Work Friends" var group = ContactsApp.createContactGroup("Work Friends");
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | o nome do novo grupo de contatos |
Retorno
: o grupo de contato recém-criado.ContactGroup
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
deleteContact(contact)
deleteContact(contact)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Exclui o contato.
// The code below retrieves a contact with the email address "john.doe@example.com" // and then deletes that contact. var contact = ContactsApp.getContact('john.doe@example.com'); ContactsApp.deleteContact(contact);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
contact |
| o contato a ser excluído |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
deleteContactGroup(group)
deleteContactGroup(group)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Exclui o grupo de contatos
// The code below creates deletes the contact group named "Work Friends" var group = ContactsApp.getContactGroup("Work Friends"); ContactsApp.deleteContactGroup(group);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
group |
| o grupo de contatos a ser excluído |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
findByEmailAddress(email)
findByEmailAddress(email)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Encontra um contato com o endereço de e-mail fornecido.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
email | String | o endereço de e-mail do contato a ser encontrado |
Retorno
: o contato que contém esse endereço de e-mailContact
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
findContactGroup(name)
findContactGroup(name)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Encontra um grupo de contatos com o nome fornecido.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | o nome do grupo de contatos para encontrar |
Retorno
: o grupo de contatos correspondente ao nome fornecidoContactGroup
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
getAllContacts()
getAllContacts()
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Extrai todos os contatos que pertencem a este usuário.
Retorno
: todos os contatos deste usuário.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
getContact(emailAddress)
getContact(emailAddress)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Recebe um contato pelo endereço de e-mail.
Se vários contatos compartilharem o mesmo endereço de e-mail, o método favorecerá aqueles que marcaram o endereço de e-mail como principal. Se nenhum dos contatos tiver o endereço de e-mail marcado como principal, ou vários contatos tiverem o endereço de e-mail marcado como principal, o método retornará o primeiro resultado na ordem dos contatos classificados.
// The code below retrieves a contact with the email address "john.doe@example.com". var contact = ContactsApp.getContact('john.doe@example.com');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddress | String | o endereço de e-mail do contato |
Retorno
: o contato que contém esse endereço de e-mailContact
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactById(id)
getContactById(id)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Extrai o contato com esse ID.
// The code below retrieves the contact with the id // "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5" var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c'; var contact = ContactApp.getContactById(id);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
id | String | o ID do contato a ser recuperado |
Retorno
: o contato correspondente ou nuloContact
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactGroup(name)
getContactGroup(name)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Extrai um grupo de contatos com o nome fornecido ou retorna nulo se nenhum grupo de contatos for encontrado.
// The code below returns the contact group with the name "Work Friends" var group = ContactsApp.getContactGroup('Work Friends');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | o nome do grupo de contatos a ser correspondido |
Retorno
: o grupo de contatos correspondente ou nulo se nenhum grupo de contatos correspondente for encontrado.ContactGroup
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactGroupById(id)
getContactGroupById(id)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Recebe um grupo de contatos com o ID fornecido ou retorna nulo se nenhum grupo de contatos for encontrado.
// The code below returns the contact group with the id // "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb" var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"; var group = ContactsApp.getContactGroupById(id);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
id | String | o ID do grupo de contato a ser correspondido |
Retorno
: o grupo de contatos correspondente ou nulo se nenhum grupo de contatos correspondente for encontrado.ContactGroup
Veja também
getContactGroups()
getContactGroups()
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Extrai a lista completa dos grupos de contatos do usuário.
Um usuário pode ter uma lista de Contatos e possivelmente uma lista de grupos de contatos também. Cada grupo de contatos pode conter contatos. Esse método retorna uma lista de todos os grupos de contatos.
// The retrieves all the contract groups for the user and then logs the group name of each // contact group. var groups = ContactsApp.getContactGroups(); for (var i = 0; i < groups.length; i++) { Logger.log(groups[i].getName()); }
Retorno
: uma matriz dos grupos de contatos do usuárioContactGroup[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContacts()
getContacts()
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Mostra todos os contatos do usuário.
// The code below will retrieve all the user's contacts var contacts = ContactsApp.getContacts();
Retorno
: uma matriz de todos os contatos do usuário.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByAddress(query)
getContactsByAddress(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Fazer com que os contatos correspondam a um endereço.
// The code below returns an array of contacts where the contact's address contains // "San Francisco'. var contacts = ContactsApp.getContactsByAddress('San Francisco');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços dos contatos |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByAddress(query, label)
getContactsByAddress(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Acessar contatos que correspondam a um endereço, limitados a um campo específico.
// The code below returns an array of contacts where the contact's address contains // "San Francisco" in the Home address field. var contacts = ContactsApp.getContactsByAddress('San Francisco', ContactsApp.Field.HOME_ADDRESS);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços dos contatos |
label |
| no campo a ser pesquisado |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByAddress(query, label)
getContactsByAddress(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um endereço, limitado ao marcador de endereço personalizado especificado.
// The code below returns an array of contacts where the contact's address contains // "San Francisco" in a custom address label (created by the user) called // "vacation". var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços do contato com o rótulo de endereço personalizado especificado |
label | String | o rótulo de endereço personalizado para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByCompany(query)
getContactsByCompany(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam ao campo da empresa.
// The code below returns an array of contacts where the contact's company field // contains "Google". var contacts = ContactsApp.getContactsByCompany('Google');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada no campo da empresa do contato |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByCustomField(query, label)
getContactsByCustomField(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um determinado valor em um campo personalizado.
O campo personalizado pode ser especificado por uma string ou como um dos valores de ContactsApp.ExtendedField.
// The code below returns an array of contacts where the contact's custom field // named "Favorite Sport" contains "tennis". var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | Object | a string a ser pesquisada no campo personalizado do contato |
label |
| o campo personalizado para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByDate(month, day, label)
getContactsByDate(month, day, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um determinado mês e dia para um campo padrão específico.
// The code below returns an array of contacts where the contact's "Birthday" field // contains April for the month and 19 for the day. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, ContactsApp.Field.BIRTHDAY);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
month | Month | o mês correspondente, como um dos valores de ContactsApp.Month |
day | Integer | o dia correspondente |
label |
| o campo para pesquisar em "ContactsApp.Field" |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByDate(month, day, year, label)
getContactsByDate(month, day, year, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um determinado mês, dia e ano para um campo padrão específico.
// The code below returns an array of contacts where the contact's "Birthday" field // contains April for the month, 19 for the day, and 1950 for the year. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950, ContactsApp.Field.BIRTHDAY);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
month | Month | o mês correspondente, como um dos valores de ContactsApp.Month |
day | Integer | o dia correspondente |
year | Integer | o ano a corresponder, pode ser nulo |
label |
| o campo para pesquisar em "ContactsApp.Field" |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByDate(month, day, year, label)
getContactsByDate(month, day, year, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um determinado mês, dia e ano para um campo personalizado específico.
// The code below returns an array of contacts where the contact's custom "Start Date" field // contains April for the month, 19 for the day, and 2011 for the year. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
month | Month | o mês correspondente, como um dos valores de ContactsApp.Month |
day | Integer | o dia correspondente |
year | Integer | o ano a corresponder, pode ser nulo |
label | String | o campo personalizado para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByDate(month, day, label)
getContactsByDate(month, day, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um determinado mês e dia para um campo personalizado específico.
// The code below returns an array of contacts where the contact's custom "Start Date" field // contains April for the month and 19 for the day. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
month | Month | o mês correspondente, como um dos valores de ContactsApp.Month |
day | Integer | o dia correspondente |
label | String | o campo personalizado para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByEmailAddress(query)
getContactsByEmailAddress(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Encontrar contatos que correspondam a um endereço de e-mail.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com'. var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços de e-mail de contato |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByEmailAddress(query, label)
getContactsByEmailAddress(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Acessar contatos que correspondam a um endereço de e-mail, limitados a um campo específico.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com" in the Home email field. var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', ContactsApp.Field.HOME_EMAIL);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços de e-mail de contato |
label |
| no campo a ser pesquisado |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByEmailAddress(query, label)
getContactsByEmailAddress(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Receba contatos que correspondam a um endereço de e-mail, limitado ao marcador de endereço de e-mail personalizado especificado.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com" in a custom email address label (created by the user) called // "alternate". var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', 'alternate');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços de e-mail de contato com o rótulo de endereço de e-mail personalizado especificado |
label | String | o marcador de endereço de e-mail personalizado para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByGroup(group)
getContactsByGroup(group)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Acessa os contatos em um determinado ContactGroup.
// The code below returns an array of contacts in the ContactGroup with the name // "Work Friends". var group = ContactsApp.getContactGroup('Work Friends'); var contacts = ContactsApp.getContactsByGroup(group);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
group |
| o grupo de contatos |
Retorno
: uma matriz de contatos no grupo especificadoContact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByIM(query)
getContactsByIM(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um endereço de mensagem instantânea.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in any instant messaging field. var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços de mensagens instantâneas do contato |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByIM(query, label)
getContactsByIM(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um endereço de mensagem instantânea, limitado a um campo específico.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in the AIM instant messaging field. var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', ContactsApp.Field.AIM);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços de mensagens instantâneas do contato |
label |
| no campo a ser pesquisado |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByIM(query, label)
getContactsByIM(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Receber contatos correspondentes a um endereço de mensagem instantânea, limitado ao rótulo de mensagem instantânea personalizado especificado.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in a custom instant messaging label (created by the user) called // "eBuddy". var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos endereços de mensagens instantâneas do contato com o rótulo de mensagem instantânea personalizado especificado |
label | String | o marcador personalizado de mensagem instantânea para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByJobTitle(query)
getContactsByJobTitle(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
encontre contatos que correspondam ao campo do cargo.
// The code below returns an array of contacts where the contact's job title field // contains "Product Manager". var contacts = ContactsApp.getContactsByJobTitle('Product Manager');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada no campo de cargo do contato |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByName(query)
getContactsByName(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Encontrar contatos que correspondam a um nome.
// The code below returns an array of contacts where the contact name contains "John" var contacts = ContactsApp.getContactsByName('John');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada em nomes de contatos |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByName(query, label)
getContactsByName(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Acessar contatos que correspondam a um nome, limitado a um campo específico.
// The code below returns an array of contacts where the contact name contains "John" // in the Given Name field. var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada em nomes de contatos |
label |
| no campo a ser pesquisado |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByNotes(query)
getContactsByNotes(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Faça com que os contatos correspondam ao campo de notas.
// The code below returns an array of contacts where the contact's notes field // contains "sent birthday card". var contacts = ContactsApp.getContactsByNotes('sent birthday card');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada no campo de anotações do contato |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByPhone(query)
getContactsByPhone(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Fazer com que os contatos correspondam a um número de telefone.
Esse método expandirá os números de telefone com letras. Portanto, se você pesquisar "212-555-CODE" e tiver "212-555-2633" nos seus contatos ou vice-versa, o método encontrará o contato apropriado.
// The code below returns an array of contacts where the contact's phone number contains // "212-555-1234' in any phone number field. var contacts = ContactsApp.getContactsByPhone('212-555-1234');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos números de telefone do contato |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByPhone(query, label)
getContactsByPhone(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Acessar contatos correspondentes a um número de telefone, limitados a um campo específico.
Esse método expandirá os números de telefone com letras. Portanto, se você pesquisar "212-555-CODE" e tiver "212-555-2633" nos seus contatos ou vice-versa, o método encontrará o contato apropriado.
// The code below returns an array of contacts where the contact's phone number contains // "212-555-1234" in the Home phone number field. var contacts = ContactsApp.getContactsByPhone('212-555-1234', ContactsApp.Field.HOME_PHONE);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos números de telefone do contato |
label |
| no campo a ser pesquisado |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByPhone(query, label)
getContactsByPhone(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos de um número de telefone limitado ao marcador de número de telefone personalizado especificado.
Esse método expandirá os números de telefone com letras. Portanto, se você pesquisar "212-555-CODE" e tiver "212-555-2633" nos seus contatos ou vice-versa, o método encontrará o contato apropriado.
// The code below returns an array of contacts where the contact's phone number contains // "212-555-1234" in a custom phone number label (created by the user) called // "alternate". var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos números de telefone do contato com o rótulo do número de telefone personalizado especificado |
label | String | o marcador personalizado do número de telefone para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByUrl(query)
getContactsByUrl(query)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um URL.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com' in any URL field. var contacts = ContactsApp.getContactsByUrl('www.example.com');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos URLs dos contatos |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByUrl(query, label)
getContactsByUrl(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Acessar contatos que correspondam a um URL, limitado a um campo específico.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com" in the Work URL field. var contacts = ContactsApp.getContactsByUrl('www.example.com', ContactsApp.Field.WORK_WEBSITE);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos URLs dos contatos |
label |
| no campo a ser pesquisado |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds
Veja também
getContactsByUrl(query, label)
getContactsByUrl(query, label)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Obtenha contatos que correspondam a um URL, limitado ao marcador do URL personalizado especificado.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com" in a custom URL label (created by the user) called // "alternate work". var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
query | String | a string a ser pesquisada nos URLs dos contatos com o rótulo de URL personalizado especificado |
label | String | o rótulo do URL personalizado para pesquisar |
Retorno
: uma matriz de contatos correspondentes.Contact[]
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.google.com/m8/feeds