Obsoleto. En su lugar, utiliza la opción avanzada de la API de People servicio
Campo de dirección en un contacto.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getAddress() | String | Obtén la dirección para este campo. |
getLabel() | Object | Obtiene la etiqueta para este campo. |
isPrimary() | Boolean | Obtiene si este es el valor del campo principal. |
setAddress(address) |
| Establece la dirección de este campo. |
setAsPrimary() |
| Configura este campo como principal. |
setLabel(field) |
| Establece la etiqueta de este campo. |
setLabel(label) |
| Establece la etiqueta de este campo. |
Documentación detallada
getAddress()
Obtén la dirección para este campo.
// 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());
Volver
String
: Es la dirección como una string.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds
getLabel()
Obtiene la etiqueta para este campo. Puede ser un campo, un campo extendido o una cadena.
// 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()); }
Volver
Object
: Es la etiqueta de este campo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds
isPrimary()
Obtiene si este es el valor del campo principal.
// 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());
Volver
Boolean
: Indica si es la principal.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds
setAddress(address)
Establece la dirección de este campo.
// 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');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
address | String | la nueva dirección |
Volver
: Este campo es útil para encadenarAddressField
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds
setAsPrimary()
Configura este campo como principal.
// 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();
Volver
: Es este FieldValue para el encadenamientoAddressField
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds
setLabel(field)
Establece la etiqueta de este campo.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
field |
| la nueva etiqueta estándar |
Volver
: Es este FieldValue para el encadenamientoAddressField
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds
setLabel(label)
Establece la etiqueta de este campo.
// 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');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
label | String | la etiqueta nueva para este campo |
Volver
: Este campo es útil para encadenarAddressField
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.google.com/m8/feeds