Class CustomField

CustomField

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

Ein benutzerdefiniertes Feld in einem Kontakt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getLabel()	Object	Ruft das Label für dieses Feld ab.
setLabel(label)	CustomField	Legt die Beschriftung dieses Felds fest.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deleteCustomField()	void	Löscht dieses Feld.
getValue()	Object	Ruft den Wert des Felds ab.
setLabel(field)	CustomField	Legt die Beschriftung dieses Felds fest.
setValue(value)	CustomField	Legt den Wert 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

---

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

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

Rückflug

CustomField: 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

deleteCustomField()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Löscht dieses Feld.

var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i = 0; i < fields.length; i++) {
  if (fields[i].getLabel() == 'foo') {
    fields[i].deleteCustomField();
  }
}

Autorisierung

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

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

---

getValue()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft den Wert des Felds ab.

// Logs the value of all the custom fields for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

Rückflug

Object – der im Feld gespeicherte Wert

Autorisierung

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

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

---

setLabel(field)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt die Beschriftung dieses Felds fest.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail application' as
// a label, with 'Gmail' as the value.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Parameter

Name	Typ	Beschreibung
field	ExtendedField	dem neuen Standardlabel

Rückflug

CustomField: 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

---

setValue(value)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt den Wert dieses Felds fest.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail application' as
// a label, with 'Gmail' as the value.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Parameter

Name	Typ	Beschreibung
value	Object	der neue Wert

Rückflug

CustomField: 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