Class PhoneField

Campo de telefone

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

Um campo de número de telefone em um contato.

Métodos

Método	Tipo de retorno	Breve descrição
getLabel()	Object	Recebe o rótulo desse campo.
isPrimary()	Boolean	Verifica se esse é o valor do campo principal.
setAsPrimary()	PhoneField	Define esse campo como primário.
setLabel(field)	PhoneField	Define o rótulo desse campo.
setLabel(label)	PhoneField	Define o rótulo desse campo.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
deletePhoneField()	void	Exclui esse campo de número de telefone.
getPhoneNumber()	String	Receba o número de telefone para este campo.
setPhoneNumber(number)	PhoneField	Define o número de telefone para este campo.

Documentação detalhada

getLabel()

Recebe o rótulo desse campo. Pode ser um campo, um ExtendedField ou uma string.

// Logs the label for all the address fields associated with contact
// 'John Doe'. This method can be similarly called for any field that has
// a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Retornar

Object: o rótulo do campo

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

---

isPrimary()

Verifica se esse é o valor do campo principal.

// Logs whether or not the first address field associated with contact
// 'John Doe' is labeled as primary. This method can be similarly called
// for any field.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Retornar

Boolean: se é a principal

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

---

setAsPrimary()

Define esse campo como primário.

// Sets the first address field associated with contact 'John Doe'
// as primary. This method can be similarly called for any field.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setAsPrimary();

Retornar

PhoneField: FieldValue para encadeamento

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

---

setLabel(field)

Define o rótulo desse campo.

// Sets the label to 'Work' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

Parâmetros

Nome	Tipo	Descrição
field	Field	o novo rótulo padrão

Retornar

PhoneField: FieldValue para encadeamento

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

---

setLabel(label)

Define o rótulo desse campo.

// Sets the label to 'Apartment' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Parâmetros

Nome	Tipo	Descrição
label	String	o novo rótulo para esse campo

Retornar

PhoneField: este campo é útil para encadeamento.

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

Métodos obsoletos

deletePhoneField()

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

Exclui esse campo de número de telefone.

// Retrieves and deletes the work phone number field for contact 'John
// Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
phoneFields[0].deletePhoneField();

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

---

getPhoneNumber()

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

Receba o número de telefone para este campo.

// Logs the work phone number for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
Logger.log(phoneFields[0].getPhoneNumber());

Retornar

String: o número como uma string

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

---

setPhoneNumber(number)

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

Define o número de telefone para este campo.

// Sets the work phone number for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
phoneFields[0].setPhoneNumber('212-555-1234');

Parâmetros

Nome	Tipo	Descrição
number	String	o novo número

Retornar

PhoneField: este campo é útil para encadeamento.

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