Class PhoneField

PhoneField

Veraltet. Verwenden Sie stattdessen die erweiterte People API-API Dienst

Ein Telefonnummernfeld in einem Kontakt.

Methoden

MethodeRückgabetypKurzbeschreibung
getLabel()ObjectRuft das Label für dieses Feld ab.
isPrimary()BooleanRuft ab, ob dies der primäre Feldwert ist.
setAsPrimary()PhoneFieldSetzt dieses Feld auf „Primär“.
setLabel(field)PhoneFieldLegt die Beschriftung dieses Felds fest.
setLabel(label)PhoneFieldLegt die Beschriftung dieses Felds fest.

Detaillierte Dokumentation

getLabel()

Ruft das Label für dieses Feld ab. Dies kann ein Feld, ExtendedField 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Rückflug

Object – das Label für dieses Feld

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isPrimary()

Ruft ab, ob dies der primäre Feldwert 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Rückflug

Boolean – ob es primär ist

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setAsPrimary()

Setzt dieses Feld auf „Primär“.

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

Rückflug

PhoneField – Dieser FieldValue für die Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setLabel(field)

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

Parameter

NameTypBeschreibung
fieldFielddem neuen Standardlabel

Rückflug

PhoneField – Dieser FieldValue für die Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setLabel(label)

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

Parameter

NameTypBeschreibung
labelStringdas neue Label für dieses Feld

Rückflug

PhoneField: Dieses Feld ist für Verkettungen nützlich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Verworfene Methoden