Diese Seite wurde von der Cloud Translation API übersetzt.

Class PhoneField

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