Veraltet. Verwenden Sie stattdessen die erweiterte People API-API Dienst
Ein URL-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) |
| Legt die Adresse für dieses Feld fest. |
setAsPrimary() |
| Setzt dieses Feld auf „Primär“. |
setLabel(field) |
| Legt die Beschriftung dieses Felds fest. |
setLabel(label) |
| Legt 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
Name | Typ | Beschreibung |
---|---|---|
address | String | die neue Adresse |
Rückflug
: Dieses Feld ist für Verkettungen nützlich.UrlField
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
– Dieser FieldValue für die VerkettungUrlField
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 |
| dem neuen Standardlabel |
Rückflug
– Dieser FieldValue für die VerkettungUrlField
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
: Dieses Feld ist für Verkettungen nützlich.UrlField
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds