Class IMField

IMField

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

Ein Instant-Messaging-Feld in einem Kontakt.

Methoden

MethodeRückgabetypKurzbeschreibung
getAddress()StringRufen Sie die Adresse für dieses Feld ab.
getLabel()ObjectRuft das Label für dieses Feld ab.
isPrimary()BooleanRuft ab, ob dies der primäre Feldwert ist.
setAddress(address)IMFieldLegt die Adresse für dieses Feld fest.
setAsPrimary()IMFieldSetzt dieses Feld auf „primär“.
setLabel(field)IMFieldLegt die Beschriftung dieses Felds fest.
setLabel(label)IMFieldLegt die Beschriftung dieses Felds 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

NameTypBeschreibung
addressStringdie neue Adresse

Rückflug

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

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

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

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