Class EmailField

EmailField

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

Ein E-Mail-Feld in einem Kontakt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getAddress()	String	Rufen Sie die Adresse für dieses Feld ab.
getLabel()	Object	Ruft das Label für dieses Feld ab.
isPrimary()	Boolean	Ruft ab, ob dies der primäre Feldwert ist.
setAddress(address)	EmailField	Legt die Adresse für dieses Feld fest.
setAsPrimary()	EmailField	Setzt dieses Feld auf „primär“.
setLabel(field)	EmailField	Legt die Beschriftung dieses Felds fest.
setLabel(label)	EmailField	Legt die Beschriftung dieses Felds fest.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deleteEmailField()	void	Löscht diese E-Mail-Adresse aus dem Kontakt.
getDisplayName()	String	Gibt den Anzeigenamen für diese E-Mail-Adresse zurück.
setDisplayName(name)	EmailField	Legt den Anzeigenamen für diese E-Mail-Adresse fest.

Detaillierte Dokumentation

getAddress()

Rufen Sie die Adresse für dieses Feld ab.

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

Rückflug

String – Die Adresse als String

Autorisierung

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

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

---

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

---

setAddress(address)

Legt die Adresse für dieses Feld fest.

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

Parameter

Name	Typ	Beschreibung
address	String	die neue Adresse

Rückflug

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

---

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

EmailField – 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

Name	Typ	Beschreibung
field	Field	dem neuen Standardlabel

Rückflug

EmailField – 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

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

Rückflug

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

deleteEmailField()

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

Löscht diese E-Mail-Adresse aus dem Kontakt.

// Retrieves and deletes the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].deleteEmailField();

Autorisierung

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

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

---

getDisplayName()

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

Gibt den Anzeigenamen für diese E-Mail-Adresse zurück.

// Logs the display name for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
Logger.log(workEmail[0].getDisplayName());

Rückflug

String – der Anzeigename für diese E-Mail

Autorisierung

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

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

---

setDisplayName(name)

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

Legt den Anzeigenamen für diese E-Mail-Adresse fest.

// Sets the display name to 'Doe, John' for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].setDisplayName('Doe, John');

Parameter

Name	Typ	Beschreibung
name	String	den neuen Anzeigenamen für diese E-Mail-Adresse

Rückflug

EmailField: Dieses E-Mail-Feld ist nützlich für Verkettungen.

Autorisierung

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

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