Guía de migración de la API de Contactos

La API de Contacts se dio de baja el 19 de enero de 2022. Usa esta guía para obtener información sobre los cambios en los campos, los extremos y los permisos de autorización a medida que migras a la API de People.

Descripción general

La API de People tiene la misma funcionalidad que la API de Contactos heredada para todas las funciones, con las siguientes excepciones en Otros contactos:

  • Los administradores tienen permisos de solo lectura para "Otros contactos" a través del permiso nuevo. Dado que no se admite el envío de señales de mutación o escritura a "Otros contactos", los usuarios tendrán que agregar el otro contacto como "Mi contacto" si desean actualizar sus campos de datos.

  • Solo se puede leer la información de contacto básica para "Otros contactos" a través de la API. Por ejemplo, nombre completo, dirección de correo electrónico y número de teléfono.

Además, el alcance anterior de los Contactos (https://www.google.com/m8/feeds), que proporcionaba acceso tanto a los contactos personales como a la información del directorio, se reemplazará por los siguientes:

  • Para acceder a los contactos personales: https://www.googleapis.com/auth/contacts
  • Para acceder a la información del directorio: https://www.googleapis.com/auth/directory.readonly

Contactos

Asignación de campos

Campo de contacto Campo de persona
atom:content biografías
atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' fotos
atom:title names
gContact:Informacióndefacturación miscKeywords (type=OUTLOOK_BILLING_INFORMATION)
gContact:Cumpleaños cumpleaños
gContact:calendarLink calendarUrls
gContact:directoryServer miscKeywords (type=OUTLOOK_DIRECTORY_SERVER)
gContact:evento eventos
gContact:Propiedad extendida clientData
gContact:ID externo externalIds
gContact:archivos fileAses
gContact:género géneros
gContact:groupMembershipInfo memberships.contactGroupMembership
gContact:hobby intereses
gContact:iniciales Sobrenombres (type=INITIALS) OBSOLETOS
gContact:jot type='home' miscPalabras clave (type=HOME)
gContact:jot type='palabras clave' miscKeywords (type=OUTLOOK_KEYWORD)
gContact:jot type='otro' miscPalabras clave (type=OTHER)
gContact:jot type='user' miscKeywords (type=OUTLOOK_USER)
gContact:jot type='work' miscPalabras clave (type=WORK)
gContact:language idiomas
gContact:Nombre de soltera Sobrenombres OBSOLETOS (type=MAIDEN_NAME)
gContact:mileage miscKeywords (type=OUTLOOK_MILEAGE)
gContact:apodo apodos (type=DEFAULT)
gContact:ocupación profesiones
gContact:prioridad miscKeywords (type=OUTLOOK_PRIORITY)
gContact:relación relaciones
gContact:sensibilidad miscKeywords (type=OUTLOOK_SENSITIVITY)
gContact:Nombrecorto Sobrenombres OBSOLETOS (type=SHORT_NAME)
gContact:asunto miscKeywords (type=OUTLOOK_SUBJECT)
gContact:userDefinedField userDefined
gContact:sitio web urls
gContact:yomiName names.phonetic_full_name
gd:eliminado metadata.deleted
gd:email emailAddresses
gd:im imClients
gd:organización organizations
gd:phoneNumber phoneNumbers
gd:postalAddress addresses.formattedValue
gd:dónde residencias
gd:structuredPostalAddress direcciones

Extremos de contactos personales

Leer

Requiere el permiso https://www.googleapis.com/auth/contacts o https://www.googleapis.com/auth/contacts.readonly.

Modificación

Requiere el permiso https://www.googleapis.com/auth/contacts. Muta todos los campos de los contactos, excepto las fotos.

Modificación de foto

Requiere el permiso https://www.googleapis.com/auth/contacts.

Otros extremos de contactos

Leer

Otros contactos son de solo lectura y solo se muestran los campos names, emailAddresses y phoneNumbers.

Requiere el permiso https://www.googleapis.com/auth/contacts.other.readonly.

Texto

Requiere los permisos https://www.googleapis.com/auth/contacts.other.readonly y https://www.googleapis.com/auth/contacts.

Extremos de la lista de direcciones global

Requiere el permiso https://www.googleapis.com/auth/directory.readonly.

Grupos de contactos

Asignación de campos

Campo Grupo de contactos de la API de Contactos Campo del grupo de contactos de la API de People
atom:actualizado metadata.updateTime
atom:title name
atom:content name
gd:eliminado metadata.deleted
systemGroup groupType=SYSTEM_CONTACT_GROUP

Extremos

Leer

Requiere el permiso https://www.googleapis.com/auth/contacts o https://www.googleapis.com/auth/contacts.readonly.

Modificación

Requiere el permiso https://www.googleapis.com/auth/contacts.

Permisos de autorización

El alcance heredado https://www.google.com/m8/feeds es un alias para el alcance https://www.googleapis.com/auth/contacts. Esto significa que los otorgamientos de OAuth existentes con el permiso heredado funcionarán para cualquier extremo de la API de People que requiera el permiso https://www.googleapis.com/auth/contacts. La lectura y escritura de los contactos y los grupos de contactos funcionará con el alcance heredado.

La API de People requiere nuevos permisos para acceder a "Otros contactos" o datos del directorio. Consulta los detalles anteriores para conocer los permisos necesarios.

Para obtener más información, consulta Autoriza solicitudes.

Bibliotecas cliente