Class PhoneField

Telefon

Veraltet. Verwenden Sie stattdessen den erweiterten Dienst der People API.

Ein Telefonnummernfeld in einem Kontakt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getLabel()	Object	Ruft das Label für dieses Feld ab.
isPrimary()	Boolean	Gibt an, ob dies der Wert des Hauptfelds ist.
setAsPrimary()	PhoneField	Legt dieses Feld als primär fest.
setLabel(field)	PhoneField	Legt das Label dieses Felds fest.
setLabel(label)	PhoneField	Legt das Label dieses Felds fest.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deletePhoneField()	void	Löscht dieses Feld für die Telefonnummer.
getPhoneNumber()	String	Telefonnummer für dieses Feld abrufen
setPhoneNumber(number)	PhoneField	Legt die Telefonnummer für dieses Feld fest.

Detaillierte Dokumentation

getLabel()

Ruft das Label für dieses Feld ab. Dies kann ein Feld, ein erweitertes Feld oder ein String sein.

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

Rückflug

Object – das Label für dieses Feld

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

isPrimary()

Gibt an, ob dies der Wert des Hauptfelds ist.

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

Rückflug

Boolean – ob es sich um die primäre Adresse handelt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setAsPrimary()

Legt dieses Feld als primär fest.

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

Rückflug

PhoneField – diese FieldValue für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setLabel(field)

Legt das Label dieses Felds fest.

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

Parameter

Name	Typ	Beschreibung
field	Field	das neue Standardlabel

Rückflug

PhoneField – diese FieldValue für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setLabel(label)

Legt das Label dieses Felds fest.

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

Parameter

Name	Typ	Beschreibung
label	String	das neue Label für dieses Feld

Rückflug

PhoneField – dieses Feld ist für die Verkettung nützlich

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Eingestellte Methoden

deletePhoneField()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Löscht dieses Feld für die Telefonnummer.

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getPhoneNumber()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Telefonnummer für dieses Feld abrufen

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

Rückflug

String – die Zahl als String

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setPhoneNumber(number)

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Legt die Telefonnummer für dieses Feld fest.

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

Parameter

Name	Typ	Beschreibung
number	String	die neue Nummer

Rückflug

PhoneField – dieses Feld ist für die Verkettung nützlich

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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