Importante: Migra tus secuencias de comandos del servicio de Contactos al servicio avanzado de la API de People antes de que Apps Script cierre el servicio de Contactos en marzo de 2023.
Apps Script dio de baja el servicio de Contactos el 16 de diciembre de 2022. En su lugar, usa el servicio avanzado de la API de People. La API de People usa un protocolo JSON más nuevo y proporciona funciones avanzadas, como la combinación de contactos con perfiles.
Usa esta guía para saber qué métodos del servicio de Contactos no tienen equivalente en el servicio avanzado de la API de personas, saber qué puedes usar en su lugar y buscar muestras de código para migrar tareas comunes. Para obtener más información, consulta la Guía de migración de la API de Contactos.
Métodos sin equivalentes de la API de People
A continuación, se enumeran los métodos getContacts
del servicio de Contactos que no tienen formas equivalentes de buscar contactos en el servicio avanzado de la API de People. Con el servicio avanzado de la API de People, puedes buscar por los campos names
, nickNames
, emailAddresses
, phoneNumbers
y organizations
de un contacto que provienen de la fuente CONTACT
.
Métodos sin equivalentes |
---|
|
A continuación, se enumeran los métodos getContacts
del servicio de Contactos que usan un parámetro label
adicional. Puedes usar searchContacts
del servicio avanzado de la API de People para obtener contactos por campo equivalente, pero no puedes limitar la búsqueda a una etiqueta específica.
Métodos con equivalentes parciales |
---|
|
Funciones adicionales disponibles con la API de People
Cuando migras al servicio avanzado de la API de People, puedes acceder a las siguientes funciones de la API de People que no están disponibles en el servicio de Contactos:
- Especifica la fuente de datos: Cuando buscas información sobre una persona, puedes especificar dónde buscar, como un contacto o un perfil de Google.
- Buscar personas por una cadena de búsqueda: Puedes obtener una lista de perfiles y contactos que coincidan con una cadena específica.
- Solicitudes por lotes: Puedes agrupar las llamadas a la API de People para reducir el tiempo de ejecución de la secuencia de comandos.
Muestras de código para tareas comunes
En esta sección, se enumeran las tareas comunes del servicio de Contactos. Las muestras de código muestran cómo construir las tareas con el servicio avanzado de la API de People.
Obtener un grupo de contactos por nombre
En la siguiente muestra de código, se indica cómo obtener un grupo de contactos por su nombre, que equivale a getContactGroup(name)
en el servicio de Contactos.
Cómo obtener un contacto por dirección de correo electrónico
En la siguiente muestra de código, se indica cómo obtener un contacto por su dirección de correo electrónico, que equivale a getContact(emailAddress)
en el servicio de Contactos.
Obtener todos los contactos
En la siguiente muestra de código, se indica cómo obtener todos los contactos de un usuario, que es el equivalente a getContacts()
en el servicio de Contactos.
Obtén el nombre completo de un contacto
En la siguiente muestra de código, se indica cómo obtener el nombre completo de un contacto, que es el equivalente a getFullName()
en el servicio de Contactos.
Cómo obtener todos los números de teléfono de un contacto
En la siguiente muestra de código, se indica cómo obtener todos los números de teléfono de un contacto, que equivalen a getPhones()
en el servicio de Contactos.
Cómo obtener un número de teléfono específico para un contacto
En la siguiente muestra de código, se indica cómo obtener un número de teléfono específico para un contacto, que equivale a getPhoneNumber()
en el servicio de Contactos.