Class UrlField

UrlField

Obsoleta. Utilizza invece il servizio avanzato API People

Un campo URL in un contatto.

Metodi

Metodo	Tipo restituito	Breve descrizione
getAddress()	String	Ottieni l'indirizzo per questo campo.
getLabel()	Object	Recupera l'etichetta per questo campo.
isPrimary()	Boolean	Riconosce se si tratta del valore del campo principale.
setAddress(address)	UrlField	Imposta l'indirizzo di questo campo.
setAsPrimary()	UrlField	Imposta questo campo come principale.
setLabel(field)	UrlField	Imposta l'etichetta di questo campo.
setLabel(label)	UrlField	Imposta l'etichetta di questo campo.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
deleteUrlField()	void	Elimina questo campo URL.

Documentazione dettagliata

getAddress()

Ottieni l'indirizzo per questo 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());

Ritorni

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 per questo campo. Può essere un campo, un campo ExtendedField 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Ritorni

Object: l'etichetta per 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()

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

Ritorni

Boolean: 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

Parametri

Nome	Tipo	Descrizione
address	String	il nuovo indirizzo

Ritorni

UrlField: questo campo è utile per il concatenamento

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

Ritorni

UrlField: questo valore FieldValue per il concatenamento

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

Parametri

Nome	Tipo	Descrizione
field	Field	la nuova etichetta standard

Ritorni

UrlField: questo valore FieldValue per il concatenamento

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

Parametri

Nome	Tipo	Descrizione
label	String	la nuova etichetta per questo campo

Ritorni

UrlField: questo campo è utile per il concatenamento

Autorizzazione

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

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

Metodi deprecati

deleteUrlField()

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

Elimina questo campo URL.

// Retrieves and deletes the Blog URL field for contact 'John
// Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var urlFields = contacts[0].getUrls(ContactsApp.Field.BLOG);
urlFields[0].deleteUrlField();

Autorizzazione

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

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