Class PhoneField

PhoneField

Obsoleta. Utilizza invece la versione avanzata dell'API People servizio

Un campo del numero di telefono in un contatto.

Metodi

Metodo	Tipo restituito	Breve descrizione
getLabel()	Object	Recupera l'etichetta per questo campo.
isPrimary()	Boolean	Riconosce se si tratta del valore del campo principale.
setAsPrimary()	PhoneField	Imposta questo campo su principale.
setLabel(field)	PhoneField	Imposta l'etichetta di questo campo.
setLabel(label)	PhoneField	Imposta l'etichetta di questo campo.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
deletePhoneField()	void	Elimina questo campo del numero di telefono.
getPhoneNumber()	String	Ottieni il numero di telefono per questo campo.
setPhoneNumber(number)	PhoneField	Imposta il numero di telefono per questo campo.

Documentazione dettagliata

getLabel()

Recupera l'etichetta per 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Invio

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

Invio

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

---

setAsPrimary()

Imposta questo campo su 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();

Invio

PhoneField: questo 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

Invio

PhoneField: questo 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

Invio

PhoneField: questo campo, utile per concatenare

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

deletePhoneField()

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

Elimina questo campo del numero di telefono.

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

Autorizzazione

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

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

---

getPhoneNumber()

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

Ottieni il numero di telefono per questo campo.

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

Invio

String: il numero 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

---

setPhoneNumber(number)

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

Imposta il numero di telefono per questo campo.

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

Parametri

Nome	Tipo	Descrizione
number	String	il nuovo numero

Invio

PhoneField: questo campo, utile per concatenare

Autorizzazione

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

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