Se usó la API de Cloud Translation para traducir esta página.

Class PhoneField

Obsoleto. En su lugar, usa el servicio avanzado de la API de People.

Es un campo de número de teléfono en un contacto.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getLabel()`	`Object`	Obtiene la etiqueta de este campo.
`isPrimary()`	`Boolean`	Obtiene si este es el valor del campo principal.
`setAsPrimary()`	`PhoneField`	Establece este campo como primario.
`setLabel(field)`	`PhoneField`	Establece la etiqueta de este campo.
`setLabel(label)`	`PhoneField`	Establece la etiqueta de este campo.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
`deletePhoneField()`	`void`	Borra este campo de número de teléfono.
`getPhoneNumber()`	`String`	Obtén el número de teléfono de este campo.
`setPhoneNumber(number)`	`PhoneField`	Establece el número de teléfono para este campo.

Documentación detallada

`getLabel()`

Obtiene la etiqueta de este campo. Puede ser un campo, un ExtendedField 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let 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 ámbitos:

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

Volver

Boolean: Indica si es el elemento principal.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setAsPrimary()`

Establece este campo como primario.

// 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();

Volver

PhoneField: Este FieldValue para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

Parámetros

Nombre	Tipo	Descripción
`field`	`Field`	la nueva etiqueta estándar

Volver

PhoneField: Este FieldValue para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Parámetros

Nombre	Tipo	Descripción
`label`	`String`	la nueva etiqueta para este campo

Volver

PhoneField: Este campo es útil para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

Métodos obsoletos

`deletePhoneField()`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Borra este campo de número de teléfono.

// Retrieves and deletes the work phone number field for contact 'John
// Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
phoneFields[0].deletePhoneField();

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getPhoneNumber()`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtén el número de teléfono de este campo.

// Logs the work phone number for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
Logger.log(phoneFields[0].getPhoneNumber());

Volver

String: Es el número como una cadena.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setPhoneNumber(number)`

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de teléfono para este campo.

// Sets the work phone number for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
phoneFields[0].setPhoneNumber('212-555-1234');

Parámetros

Nombre	Tipo	Descripción
`number`	`String`	el número nuevo

Volver

PhoneField: Este campo es útil para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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