Method: people.updateContact

Actualiza los datos de contacto de una persona de contacto existente. No se modificarán los datos que no sean de contacto. Se ignorarán los datos que no sean de contacto de la persona que se actualizará. Se reemplazarán todos los campos especificados en updateMask.

El servidor muestra un error 400 si no se especifica person.metadata.sources para que se actualice el contacto o si no hay una fuente de contacto.

El servidor muestra un error 400 con el motivo "failedPrecondition" si person.metadata.sources.etag es diferente a la etiqueta de metadatos del contacto, lo que indica que el contacto cambió desde que se leyeron sus datos. Los clientes deben obtener la persona más reciente y combinar sus actualizaciones en ella. Si realizas actualizaciones secuenciales para la misma persona, se debe usar la etiqueta de metadatos de la respuesta de updateContact para evitar fallas.

El servidor muestra un error 400 si se actualizan los memberships y no se especifican membresías de grupos de contacto en la persona.

El servidor muestra un error 400 si se especifica más de un campo en un campo que es un singleton para las fuentes de contactos:

  • biografías
  • cumpleaños
  • Sexos
  • names

Las solicitudes de mutación para el mismo usuario deben enviarse de forma secuencial para evitar un aumento de la latencia y fallas.

Solicitud HTTP

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
person.resourceName

string

Es el nombre del recurso de la persona que asignó el servidor. Es una cadena ASCII con el formato people/{person_id}.

Parámetros de consulta

Parámetros
updatePersonFields

string (FieldMask format)

Obligatorio. Es una máscara de campo para restringir qué campos de la persona se actualizan. Para especificar varios campos, sepáralos con comas. Se reemplazarán todos los campos actualizados. Estos son los valores válidos:

  • direcciones
  • biografías
  • cumpleaños
  • calendarUrls
  • clientData
  • emailAddresses
  • de Innovators Live
  • externalIds
  • Sexos
  • imClients
  • intereses
  • locales
  • ubicaciones
  • memberships
  • miscKeywords
  • names
  • sobrenombres
  • ocupaciones
  • organizaciones
  • phoneNumbers
  • relaciones
  • sipAddresses
  • url
  • userDefined
personFields

string (FieldMask format)

Opcional. Es una máscara de campo para restringir qué campos de cada persona se muestran. Para especificar varios campos, sepáralos con comas. Si no se establece, se aplica a todos los campos de forma predeterminada. Estos son los valores válidos:

  • direcciones
  • ageRanges
  • biografías
  • cumpleaños
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • de Innovators Live
  • externalIds
  • Sexos
  • imClients
  • intereses
  • locales
  • ubicaciones
  • memberships
  • metadatos
  • miscKeywords
  • names
  • sobrenombres
  • ocupaciones
  • organizaciones
  • phoneNumbers
  • fotos
  • relaciones
  • sipAddresses
  • skills
  • url
  • userDefined
sources[]

enum (ReadSourceType)

Opcional. Es una máscara de los tipos de fuentes que se mostrarán. Si no se configura, el valor predeterminado es READ_SOURCE_TYPE_CONTACT y READ_SOURCE_TYPE_PROFILE.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Person.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Person.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/contacts

Para obtener más información, consulta la Guía de autorización.