Class AddressField

AddressField

Obsoleto. Em vez disso, use a API People avançada serviço

Campo de endereço em um contato.

Métodos

Método	Tipo de retorno	Breve descrição
getAddress()	String	Consiga o endereço deste campo.
getLabel()	Object	Recebe o rótulo deste campo.
isPrimary()	Boolean	Extrai se este é o valor do campo principal.
setAddress(address)	AddressField	Define o endereço deste campo.
setAsPrimary()	AddressField	Define este campo como principal.
setLabel(field)	AddressField	Define o rótulo deste campo.
setLabel(label)	AddressField	Define o rótulo deste campo.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
deleteAddressField()	void	Exclui este campo de endereço.

Documentação detalhada

getAddress()

Consiga o endereço deste campo.

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

Retornar

String: o endereço como uma string.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

---

getLabel()

Recebe o rótulo deste 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Retornar

Object: o rótulo deste campo.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

---

isPrimary()

Extrai se este é 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Retornar

Boolean: se é a principal

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

---

setAddress(address)

Define o endereço deste campo.

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

Parâmetros

Nome	Tipo	Descrição
address	String	o novo endereço

Retornar

AddressField: campo que é útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

---

setAsPrimary()

Define este campo como principal.

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

Retornar

AddressField: este FieldValue para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

---

setLabel(field)

Define o rótulo deste 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

Parâmetros

Nome	Tipo	Descrição
field	Field	o novo marcador padrão

Retornar

AddressField: este FieldValue para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

---

setLabel(label)

Define o rótulo deste 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Parâmetros

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

Retornar

AddressField: campo que é útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds

Métodos obsoletos

deleteAddressField()

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

Exclui este campo de endereço.

// The code below deletes the home addresses for a contact named "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddresses = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
for (var i in homeAddresses) {
  homeAddresses[i].deleteAddressField();
}

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

• https://www.google.com/m8/feeds