Class AddressField

CampoIndirizzo

Ritiro. Utilizza invece il servizio avanzato dell'API People

Campo indirizzo in un contatto.

Metodi

MetodoTipo restituitoBreve descrizione
getAddress()StringOttieni l'indirizzo di questo campo.
getLabel()ObjectRecupera l'etichetta di questo campo.
isPrimary()BooleanIndica se si tratta del valore del campo principale.
setAddress(address)AddressFieldImposta l'indirizzo di questo campo.
setAsPrimary()AddressFieldImposta questo campo come principale.
setLabel(field)AddressFieldImposta l'etichetta di questo campo.
setLabel(label)AddressFieldImposta l'etichetta di questo campo.
MetodoTipo restituitoBreve descrizione
deleteAddressField()voidElimina questo campo indirizzo.

Documentazione dettagliata

getAddress()

Ottieni l'indirizzo di questo campo.

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

Invio

String: l'indirizzo come stringa

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getLabel()

Recupera l'etichetta di questo campo. Può essere un campo, un campo esteso o una stringa.

// 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());
}

Invio

Object: l'etichetta di questo campo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

isPrimary()

Indica se si tratta del valore del campo principale.

// 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());

Invio

Boolean: indica se è principale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

setAddress(address)

Imposta l'indirizzo di questo campo.

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

Parametri

NomeTipoDescrizione
addressStringil nuovo indirizzo

Invio

AddressField: questo campo, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

setAsPrimary()

Imposta questo campo come principale.

// 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();

Invio

AddressField: questo FieldValue per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

setLabel(field)

Imposta l'etichetta di questo 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);

Parametri

NomeTipoDescrizione
fieldFieldla nuova etichetta standard

Invio

AddressField: questo FieldValue per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

setLabel(label)

Imposta l'etichetta di questo 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');

Parametri

NomeTipoDescrizione
labelStringla nuova etichetta per questo campo

Invio

AddressField: questo campo, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

Metodi ritirati

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Elimina questo campo indirizzo.

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

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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