Class UrlField

UrlField

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

Ein URL-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)UrlFieldLegt die Adresse für dieses Feld fest.
setAsPrimary()UrlFieldSetzt dieses Feld auf „Primär“.
setLabel(field)UrlFieldLegt die Beschriftung dieses Felds fest.
setLabel(label)UrlFieldLegt 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

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

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

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

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