Esta página foi traduzida pela API Cloud Translation.

Class Contact

Obsoleto. Em vez disso, use o serviço avançado da API People.

Um contato contém o nome, o endereço e vários detalhes de contato.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`addAddress(label, address)`	`AddressField`	Adiciona um endereço ao contato com um rótulo padrão ou personalizado.
`addCompany(company, title)`	`CompanyField`	Adiciona uma empresa ao contato.
`addCustomField(label, content)`	`CustomField`	Adiciona um campo personalizado ao contato com um rótulo estendido ou personalizado.
`addDate(label, month, day, year)`	`DateField`	Adiciona uma data ao contato com um rótulo padrão ou personalizado.
`addEmail(label, address)`	`EmailField`	Adicionar um endereço de e-mail com um marcador padrão (casa, trabalho etc.) ou personalizado {@code // The code below retrieves a contact named "John Doe" and adds the email // address "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
`addIM(label, address)`	`IMField`	Adiciona um endereço de mensagem instantânea ao contato com um rótulo padrão ou personalizado.
`addPhone(label, number)`	`PhoneField`	Adiciona um número de telefone ao contato com um rótulo padrão ou personalizado.
`addToGroup(group)`	`Contact`	Adiciona esse contato ao grupo de contatos especificado.
`addUrl(label, url)`	`UrlField`	Adiciona um URL ao contato com um rótulo padrão ou personalizado.
`deleteContact()`	`void`	Exclui este contato.
`getAddresses()`	`AddressField[]`	Retorna todos os endereços desse contato.
`getAddresses(label)`	`AddressField[]`	Retorna todos os endereços do contato que correspondem a um campo específico.
`getCompanies()`	`CompanyField[]`	Extrai todas as empresas desse contato.
`getContactGroups()`	`ContactGroup[]`	Busca todos os grupos de contatos que contêm esse contato.
`getCustomFields()`	`CustomField[]`	Retorna todos os campos personalizados para esse contato.
`getCustomFields(label)`	`CustomField[]`	Retorna todos os campos personalizados desse contato que correspondem a um campo específico.
`getDates()`	`DateField[]`	Extrai todas as datas desse contato.
`getDates(label)`	`DateField[]`	Recebe todas as datas desse contato que correspondem a um campo específico.
`getEmailAddresses()`	`String[]`	Retorna uma lista dos endereços de e-mail disponíveis para esse contato.
`getEmails()`	`EmailField[]`	Recebe os endereços de e-mail desse contato.
`getEmails(label)`	`EmailField[]`	Retorna os endereços de e-mail do contato que correspondem a um campo específico.
`getFamilyName()`	`String`	Recebe o sobrenome do contato como uma string.
`getFullName()`	`String`	Retorna o nome completo (nome e sobrenome) do contato como uma string.
`getGivenName()`	`String`	Extrai o nome (nome de batismo) do contato como uma string.
`getHomeAddress()`	`String`	Recebe o endereço residencial desse contato ou uma string vazia se não houver nenhum.
`getHomeFax()`	`String`	Recebe o número de fax residencial desse contato ou uma string vazia se não houver nenhum.
`getHomePhone()`	`String`	Recebe o número de telefone residencial deste contato ou uma string vazia se não houver nenhum.
`getIMs()`	`IMField[]`	Recebe todos os endereços de mensagem instantânea para esse contato.
`getIMs(label)`	`IMField[]`	Busca todos os endereços de mensagem instantânea do contato que correspondem a um campo específico.
`getId()`	`String`	Retorna o ID exclusivo desse contato.
`getInitials()`	`String`	Recebe as iniciais do contato.
`getLastUpdated()`	`Date`	Recebe a data da última atualização do contato.
`getMaidenName()`	`String`	Recebe o nome de solteira do contato como uma string.
`getMiddleName()`	`String`	Recebe o nome do meio do contato como uma string.
`getMobilePhone()`	`String`	Recebe o número de telefone móvel desse contato ou uma string vazia se não houver nenhum.
`getNickname()`	`String`	Recebe o apelido do contato como uma string.
`getNotes()`	`String`	Recebe as anotações associadas a esse contato ou uma string vazia se não houver anotações.
`getPager()`	`String`	Recebe o número de telefone do pager desse contato ou uma string vazia se não houver nenhum.
`getPhones()`	`PhoneField[]`	Retorna todos os números de telefone desse contato.
`getPhones(label)`	`PhoneField[]`	Busca todos os números de telefone desse contato que correspondem a um campo específico.
`getPrefix()`	`String`	Extrai o prefixo do nome do contato.
`getPrimaryEmail()`	`String`	Extrai o endereço de e-mail principal do contato como uma string.
`getShortName()`	`String`	Recebe o nome abreviado do contato como uma string.
`getSuffix()`	`String`	Recebe o sufixo do nome do contato.
`getUrls()`	`UrlField[]`	Consegue todos os URLs desse contato.
`getUrls(label)`	`UrlField[]`	Obtém todos os URLs do contato que correspondem a um campo específico.
`getUserDefinedField(key)`	`String`	Recebe o valor definido pelo usuário associado à chave especificada.
`getUserDefinedFields()`	`Object`	Consegue todos os campos definidos pelo usuário para esse contato e os retorna como as propriedades de um objeto JavaScript.
`getWorkAddress()`	`String`	Recebe o endereço de trabalho desse contato ou uma string vazia se não houver nenhum.
`getWorkFax()`	`String`	Recebe o número de fax do trabalho desse contato ou uma string vazia se não houver nenhum.
`getWorkPhone()`	`String`	Recebe o número de telefone de trabalho desse contato ou uma string vazia se não houver nenhum.
`removeFromGroup(group)`	`Contact`	Remove o contato do grupo especificado.
`setFamilyName(familyName)`	`Contact`	Define o sobrenome (sobrenome) do contato.
`setFullName(fullName)`	`Contact`	Define o nome completo (nome e sobrenome) do contato.
`setGivenName(givenName)`	`Contact`	Define o nome (nome de batismo) do contato.
`setHomeAddress(addr)`	`void`	Define o endereço residencial deste contato.
`setHomeFax(phone)`	`void`	Define o número de fax residencial do contato.
`setHomePhone(phone)`	`void`	Define o número de telefone residencial do contato.
`setInitials(initials)`	`Contact`	Define as iniciais do contato.
`setMaidenName(maidenName)`	`Contact`	Define o nome de solteira do contato.
`setMiddleName(middleName)`	`Contact`	Define o nome do meio do contato.
`setMobilePhone(phone)`	`void`	Define o número de celular desse contato.
`setNickname(nickname)`	`Contact`	Define o apelido do contato.
`setNotes(notes)`	`Contact`	Define as anotações associadas a esse contato.
`setPager(phone)`	`void`	Define o número do pager do contato.
`setPrefix(prefix)`	`Contact`	Define o prefixo como o nome do contato.
`setPrimaryEmail(primaryEmail)`	`void`	Define o endereço de e-mail principal desse contato.
`setShortName(shortName)`	`Contact`	Define o nome abreviado do contato.
`setSuffix(suffix)`	`Contact`	Define o sufixo como o nome do contato.
`setUserDefinedField(key, value)`	`void`	Define um único campo definido pelo usuário para esse contato, que será armazenado com uma determinada chave.
`setUserDefinedFields(o)`	`void`	Define os campos definidos pelo usuário para esse contato com as propriedades do objeto fornecido.
`setWorkAddress(addr)`	`void`	Define o endereço de trabalho do contato.
`setWorkFax(phone)`	`void`	Define o número de fax comercial do contato.
`setWorkPhone(phone)`	`void`	Define o número de telefone comercial do contato.

Métodos obsoletos

`addAddress(label, address)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona um endereço ao contato com um rótulo padrão ou personalizado.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const address = contacts[0].addAddress(
    ContactsApp.Field.WORK_ADDRESS,
    '123 Main St, Some City, NY 10011',
);

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo do novo endereço, de ContactsApp.Field ou de uma string personalizada
`address`	`String`	o novo endereço

Retornar

AddressField: o campo recém-criado

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

Consulte também

getAddresses()

`addCompany(company, title)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona uma empresa ao contato.

// The code below retrieves a contact named "John Doe" and adds the company
// "Google" and the job title "Product Manager".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

Parâmetros

Nome	Tipo	Descrição
`company`	`String`	o nome da empresa a ser adicionada ao contato
`title`	`String`	o cargo associado a esse contato para essa empresa

Retornar

CompanyField: o campo recém-criado

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

Consulte também

getCompanies()

`addCustomField(label, content)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona um campo personalizado ao contato com um rótulo estendido ou personalizado.

O rótulo pode ser de ContactsApp.ExtendedField ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field
// named 'HOBBY'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo do novo endereço, de ContactsApp.ExtendedField ou de uma string personalizada
`content`	`Object`	o valor a ser armazenado no campo personalizado

Retornar

CustomField: o campo recém-criado

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

Consulte também

getCustomFields()

`addDate(label, month, day, year)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona uma data ao contato com um rótulo padrão ou personalizado.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].addDate(
    ContactsApp.Field.BIRTHDAY,
    ContactsApp.Month.APRIL,
    19,
    1950,
);

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo da nova data, de ContactsApp.Field ou de uma string personalizada
`month`	`Month`	o mês, de ContactApps.Month
`day`	`Integer`	o dia
`year`	`Integer`	o ano

Retornar

DateField: a data de criação

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

Consulte também

getDates()

`addEmail(label, address)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adicionar um endereço de e-mail com um marcador padrão (casa, trabalho etc.) ou personalizado

// The code below retrieves a contact named "John Doe" and adds the email
// address "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    'j.doe@example.com',
);

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo do novo e-mail, de ContactsApp.Field ou de uma string personalizada
`address`	`String`	o novo endereço de e-mail

Retornar

EmailField: o campo adicionado

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

`addIM(label, address)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona um endereço de mensagem instantânea ao contato com um rótulo padrão ou personalizado.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and adds the IM address
// "ChatWithJohn" with the ContactsApp.Field.AIM label.
const contacts = ContactsApp.getContactsByName('John Doe');
const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo do novo endereço de mensagem instantânea, de ContactsApp.Field ou de uma string personalizada
`address`	`String`	o novo endereço de chat

Retornar

IMField: o campo recém-criado

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

Consulte também

getIMs()

`addPhone(label, number)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona um número de telefone ao contato com um rótulo padrão ou personalizado.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phone = contacts[0].addPhone(
    ContactsApp.Field.WORK_PHONE,
    '212-555-1234',
);

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo do novo número de telefone, de ContactsApp.Field ou de uma string personalizada
`number`	`String`	o novo número de telefone

Retornar

PhoneField: o campo recém-criado

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

Consulte também

getPhones()

`addToGroup(group)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona esse contato ao grupo de contatos especificado.

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

Parâmetros

Nome	Tipo	Descrição
`group`	`ContactGroup`	o grupo de contatos em que você quer adicionar o contato

Retornar

Contact: este contato

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

Consulte também

removeFromGroup(group)

`addUrl(label, url)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Adiciona um URL ao contato com um rótulo padrão ou personalizado.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addUrl(
    ContactsApp.Field.WORK_WEBSITE,
    'http://www.example.com',
);

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo do novo endereço, de ContactsApp.Field ou de uma string personalizada
`url`	`String`	o novo URL

Retornar

UrlField: o campo recém-criado

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

Consulte também

getUrls()

`deleteContact()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Exclui este contato.

const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].deleteContact();
}

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

`getAddresses()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna todos os endereços desse contato.

// The code below logs the addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

Retornar

AddressField[]: uma lista de endereços

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

Consulte também

addAddress(label, address)

`getAddresses(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna todos os endereços do contato que correspondem a um campo específico.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.Field ou de uma string personalizada

Retornar

AddressField[]: uma lista de endereços

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

Consulte também

addAddress(label, address)

`getCompanies()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai todas as empresas desse contato.

// The code below logs the company names of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  const companies = contacts[i].getCompanies();
  for (const j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

Retornar

CompanyField[]: uma lista de empresas

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

Consulte também

addCompany(company, title)

`getContactGroups()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Busca todos os grupos de contatos que contêm esse contato.

// The code below gets a contact named "John Doe" and retrieves all the contact
// groups that the contact belongs to
const contacts = ContactsApp.getContactsByName('John Doe');
const groups = contacts[0].getContactGroups();

Retornar

ContactGroup[]: os grupos que contêm esse contato

Consulte também

addToGroup(group)

`getCustomFields()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna todos os campos personalizados para esse contato.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

Retornar

CustomField[]: uma lista de campos personalizados

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

Consulte também

addCustomField(label, content)

`getCustomFields(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna todos os campos personalizados desse contato que correspondem a um campo específico.

O rótulo pode ser um rótulo padrão de ContactsApp.ExtendedField ou uma string de rótulo personalizado.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact that are in the
// ContactsApp.ExtendedField.HOBBY label.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.ExtendedField ou de uma string personalizada

Retornar

CustomField[]: uma lista de campos personalizados

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

Consulte também

addCustomField(label, content)

`getDates()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai todas as datas desse contato.

// The code below retrieves a contact named "John Doe" and logs the label of the
// date associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

Retornar

DateField[]: uma lista de datas

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

Consulte também

addDate(label, month, day, year)

`getDates(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe todas as datas desse contato que correspondem a um campo específico.

O rótulo pode ser um rótulo padrão de ContactsApp.Field ou uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and logs the day of the
// month associated with that contact that are in the ContactsApp.Field.BIRTHDAY
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.Field ou de uma string personalizada

Retornar

DateField[]: uma lista de datas

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

Consulte também

addDate(label, month, day, year)

`getEmailAddresses()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna uma lista dos endereços de e-mail disponíveis para esse contato.

Retornar

String[]: uma lista de endereços de e-mail disponíveis para esse contato

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

`getEmails()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna os endereços de e-mail desse contato.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Retornar

EmailField[]: a lista de endereços de e-mail do contato

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

Consulte também

addEmail(label, address)

`getEmails(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna os endereços de e-mail do contato que correspondem a um campo específico.

O rótulo pode ser um rótulo padrão de ContactsApp.Field ou uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact that are in the
// ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.Field ou de uma string personalizada

Retornar

EmailField[]: a lista de endereços de e-mail do contato

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

Consulte também

addEmail(label, address)

`getFamilyName()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o sobrenome do contato como uma string.

// The code below logs the family name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

Retornar

String: o sobrenome do contato

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

Consulte também

setFamilyName(familyName)

`getFullName()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna o nome completo (nome e sobrenome) do contato como uma string.

// The code below logs the full name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFullName());
}

Retornar

String: o nome completo do contato

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

Consulte também

setFullName(fullName)

`getGivenName()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai o nome (nome de batismo) do contato como uma string.

// The code below logs the given name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

Retornar

String: o nome do contato

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

Consulte também

setGivenName(givenName)

`getHomeAddress()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o endereço residencial desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o endereço residencial desse contato ou uma string vazia se não houver nenhum.

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

`getHomeFax()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o número de fax residencial desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o número de fax residencial do contato ou uma string vazia, se não houver um

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

`getHomePhone()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o número de telefone residencial deste contato ou uma string vazia se não houver nenhum.

Retornar

String: o número de telefone residencial do contato ou uma string vazia se não houver nenhum.

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

`getIMs()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe todos os endereços de mensagem instantânea para esse contato.

// The code below logs the IM addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getIMs());
}

Retornar

IMField[]: uma lista de endereços de mensagens instantâneas

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

Consulte também

addIM(label, address)

`getIMs(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Busca todos os endereços de mensagem instantânea do contato que correspondem a um campo específico.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.Field ou de uma string personalizada

Retornar

IMField[]: uma lista de endereços de mensagens instantâneas

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

Consulte também

addIM(label, address)

`getId()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna o ID exclusivo desse contato.

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const id = contact.getId();

Retornar

String: o ID do contato

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

`getInitials()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe as iniciais do contato.

// The code below logs the initials of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

Retornar

String: as iniciais do contato

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

Consulte também

setInitials(initials)

`getLastUpdated()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe a data da última atualização do contato.

// The code below logs the last updated date of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

Retornar

Date: a data da última atualização do contato

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

`getMaidenName()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o nome de solteira do contato como uma string.

// The code below logs the maiden name of all the contacts whose names contain
// "Jane"
const contacts = ContactsApp.getContactsByName('Jane');
for (const i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

Retornar

String: o nome de solteira do contato

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

Consulte também

setMaidenName(maidenName)

`getMiddleName()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o nome do meio do contato como uma string.

// The code below logs the middle name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

Retornar

String: o nome do meio do contato

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

Consulte também

setMiddleName(middleName)

`getMobilePhone()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o número de telefone móvel desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o número de celular desse contato ou uma string vazia se não houver nenhum

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

`getNickname()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o apelido do contato como uma string.

// The code below logs the nickname of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

Retornar

String: o apelido do contato

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

Consulte também

setNickname(nickname)

`getNotes()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe as anotações associadas a esse contato ou uma string vazia se não houver anotações.

// The code below logs the notes of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNotes());
}

Retornar

String: as anotações associadas a esse contato

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

Consulte também

setNotes(notes)

`getPager()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o número de telefone do pager desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o número de telefone do pager desse contato ou uma string vazia se não houver nenhum.

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

`getPhones()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Consegue todos os números de telefone desse contato.

// The code below logs the phone numbers of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

Retornar

PhoneField[]: uma lista de números de telefone

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

Consulte também

addPhone(label, number)

`getPhones(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Busca todos os números de telefone desse contato que correspondem a um campo específico.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and logs the phone
// numbers associated with that contact that are in the
// ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.Field ou de uma string personalizada

Retornar

PhoneField[]: uma lista de números de telefone

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

Consulte também

addPhone(label, number)

`getPrefix()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai o prefixo do nome do contato.

// The code below logs the prefix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

Retornar

String: o prefixo do nome do contato.

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

Consulte também

setPrefix(prefix)

`getPrimaryEmail()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna o endereço de e-mail principal do contato como uma string.

// The code below logs the primary email address of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

Retornar

String: o endereço de e-mail principal do contato

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

`getShortName()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o nome abreviado do contato como uma string.

// The code below logs the short name of all the contacts whose names contain
// "Johnathan"
const contacts = ContactsApp.getContactsByName('Johnathan');
for (const i in contacts) {
  Logger.log(contacts[i].getShortName());
}

Retornar

String: o nome abreviado do contato

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

Consulte também

setShortName(shortName)

`getSuffix()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o sufixo do nome do contato.

// The code below logs the suffix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

Retornar

String: o sufixo do nome do contato.

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

Consulte também

setSuffix(suffix)

`getUrls()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Consegue todos os URLs desse contato.

// The code below logs the URLs of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

Retornar

UrlField[]: uma lista de URLs

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

Consulte também

addUrl(label, url)

`getUrls(label)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Obtém todos os URLs do contato que correspondem a um campo específico.

O rótulo pode ser de ContactsApp.Field ou de uma string de rótulo personalizada.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

Parâmetros

Nome	Tipo	Descrição
`label`	`Object`	o rótulo a ser correspondido, de ContactsApp.Field ou de uma string personalizada

Retornar

UrlField[]: uma lista de URLs

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

Consulte também

addUrl(label, url)

`getUserDefinedField(key)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o valor definido pelo usuário associado à chave especificada.

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	A chave pode ser qualquer tipo básico (String, int etc.).

Retornar

String: o conteúdo definido pelo usuário que foi armazenado com essa chave

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

`getUserDefinedFields()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Consegue todos os campos definidos pelo usuário para esse contato e os retorna como as propriedades de um objeto JavaScript.

Retornar

Object: os campos definidos pelo usuário para esse contato, como propriedades de um objeto JavaScript

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

`getWorkAddress()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o endereço de trabalho desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o endereço de trabalho desse contato ou uma string vazia se não houver um.

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

`getWorkFax()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o número de fax do trabalho desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o número de fax do trabalho desse contato ou uma string vazia se não houver nenhum.

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

`getWorkPhone()`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Recebe o número de telefone de trabalho desse contato ou uma string vazia se não houver nenhum.

Retornar

String: o número de telefone comercial do contato ou uma string vazia se não houver nenhum.

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

`removeFromGroup(group)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Remove o contato do grupo especificado.

// The code below gets all the contacts named "John Doe" and then removes each
// of them from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

Parâmetros

Nome	Tipo	Descrição
`group`	`ContactGroup`	o grupo de contatos em que o contato está

Retornar

Contact: este contato

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

Consulte também

addToGroup(group)

`setFamilyName(familyName)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o sobrenome (sobrenome) do contato.

// The code below changes the family name of all the contacts whose names are
// "John Doe" to "Doe-Smith"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

Parâmetros

Nome	Tipo	Descrição
`familyName`	`String`	o novo sobrenome do contato

Retornar

Contact: este contato

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

Consulte também

getFamilyName()

`setFullName(fullName)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o nome completo (nome e sobrenome) do contato.

// The code below changes the full name of all the contacts whose names are
// "John Doe" to "Johnny Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

Parâmetros

Nome	Tipo	Descrição
`fullName`	`String`	o novo nome completo do contato

Retornar

Contact: este contato

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

Consulte também

getFullName()

`setGivenName(givenName)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o nome (nome de batismo) do contato.

// The code below changes the given name of all the contacts whose names are
// "John Doe" to "Johnny"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

Parâmetros

Nome	Tipo	Descrição
`givenName`	`String`	o novo nome do contato

Retornar

Contact: este contato

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

Consulte também

getGivenName()

`setHomeAddress(addr)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o endereço residencial deste contato.

Parâmetros

Nome	Tipo	Descrição
`addr`	`String`	o endereço residencial a ser definido

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

`setHomeFax(phone)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o número de fax residencial do contato.

Parâmetros

Nome	Tipo	Descrição
`phone`	`String`	o número de fax residencial a ser definido

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

`setHomePhone(phone)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o número de telefone residencial do contato.

Parâmetros

Nome	Tipo	Descrição
`phone`	`String`	o número de telefone residencial a ser definido

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

`setInitials(initials)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define as iniciais do contato.

// The code below sets the initials of all the contacts whose names are
// "Johnathan Doe" to "JD"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

Parâmetros

Nome	Tipo	Descrição
`initials`	`String`	as novas iniciais do contato

Retornar

Contact: este contato

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

Consulte também

getInitials()

`setMaidenName(maidenName)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o nome de solteira do contato.

// The code below changes the maiden name of all the contacts whose names are
// "Jane Doe" to "Smith"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

Parâmetros

Nome	Tipo	Descrição
`maidenName`	`String`	o novo nome de solteira do contato

Retornar

Contact: este contato

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

Consulte também

getMaidenName()

`setMiddleName(middleName)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o nome do meio do contato.

// The code below changes the middle name of all the contacts whose names are
// "John Doe" to "Danger"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

Parâmetros

Nome	Tipo	Descrição
`middleName`	`String`	o novo nome do meio do contato

Retornar

Contact: este contato

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

Consulte também

getMiddleName()

`setMobilePhone(phone)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o número de celular desse contato.

Parâmetros

Nome	Tipo	Descrição
`phone`	`String`	o número de celular a ser definido

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

`setNickname(nickname)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o apelido do contato.

// The code below changes the nickname of all the contacts whose names are "John
// Doe" to "JohnnyD"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

Parâmetros

Nome	Tipo	Descrição
`nickname`	`String`	o novo apelido do contato

Retornar

Contact: este contato

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

Consulte também

getNickname()

`setNotes(notes)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define as anotações associadas a esse contato.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

Parâmetros

Nome	Tipo	Descrição
`notes`	`String`	as anotações que serão armazenadas para esse contato

Retornar

Contact: este contato

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

Consulte também

getNotes()

`setPager(phone)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o número do pager desse contato.

Parâmetros

Nome	Tipo	Descrição
`phone`	`String`	o número do pager a ser definido

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

`setPrefix(prefix)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o prefixo como o nome do contato.

// The code below sets the prefix of all the contacts whose names are "Johnathan
// Doe" to "Mr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

Parâmetros

Nome	Tipo	Descrição
`prefix`	`String`	o novo prefixo do nome do contato

Retornar

Contact: este contato

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

Consulte também

getPrefix()

`setPrimaryEmail(primaryEmail)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o endereço de e-mail principal desse contato.

Parâmetros

Nome	Tipo	Descrição
`primaryEmail`	`String`	o endereço de e-mail principal a ser definido

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

`setShortName(shortName)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o nome abreviado do contato.

// The code below changes the short name of all the contacts whose names are
// "Johnathan Doe" to "John"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

Parâmetros

Nome	Tipo	Descrição
`shortName`	`String`	o novo nome abreviado do contato

Retornar

Contact: este contato

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

Consulte também

getShortName()

`setSuffix(suffix)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o sufixo como o nome do contato.

// The code below sets the suffix of all the contacts whose names are "Johnathan
// Doe" to "Jr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setSuffix('Jr');
}

Parâmetros

Nome	Tipo	Descrição
`suffix`	`String`	o novo sufixo do nome do contato

Retornar

Contact: este contato

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

Consulte também

getSuffix()

`setUserDefinedField(key, value)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define um único campo definido pelo usuário para esse contato, que será armazenado com uma determinada chave.

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	A chave pode ser qualquer tipo básico (String, int etc.).
`value`	`String`	O valor pode ser qualquer tipo básico (String, int etc.).

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

`setUserDefinedFields(o)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define os campos definidos pelo usuário para esse contato com as propriedades do objeto fornecido.

Parâmetros

Nome	Tipo	Descrição
`o`	`Object`	Um objeto com uma ou mais propriedades no formato {chave: valor}

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

`setWorkAddress(addr)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o endereço de trabalho do contato.

Parâmetros

Nome	Tipo	Descrição
`addr`	`String`	o endereço de trabalho a ser definido

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

`setWorkFax(phone)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o número de fax comercial do contato.

Parâmetros

Nome	Tipo	Descrição
`phone`	`String`	o número de fax comercial a ser definido

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

`setWorkPhone(phone)`

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o número de telefone comercial do contato.

Parâmetros

Nome	Tipo	Descrição
`phone`	`String`	o número de telefone comercial a ser definido

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