Class IMField

IMField

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

Ein Instant-Messaging-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	Gibt an, ob dies der primäre Feldwert ist.
setAddress(address)	IMField	Legt die Adresse dieses Felds fest.
setAsPrimary()	IMField	Legt dieses Feld als primär fest.
setLabel(field)	IMField	Legt das Label dieses Felds fest.
setLabel(label)	IMField	Legt das Label dieses Felds fest.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deleteIMField()	void	Löscht dieses Instant-Messaging-Feld.

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

Rückflug

String – die Adresse als String

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getLabel()

Ruft das Label für dieses Feld ab. Dies kann ein Feld, ein 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.
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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

isPrimary()

Gibt an, 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Rückflug

Boolean – Gibt an, ob es sich um die primäre ID handelt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

setAddress(address)

Legt die Adresse dieses Felds fest.

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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

IMField – dieses Feld ist für die Verkettung nützlich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

• 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

IMField – dieser FieldValue für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

• 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

IMField – dieser FieldValue für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

• 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

IMField – dieses Feld ist für die Verkettung nützlich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Eingestellte Methoden

deleteIMField()

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

Löscht dieses Instant-Messaging-Feld.

// Retrieves and deletes the AIM instant messaging field for contact 'John
// Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const imFields = contacts[0].getIMs(ContactsApp.Field.AIM);
imFields[0].deleteIMField();

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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