Method: people.updateContact

Actualice los datos de contacto de una persona de contacto existente. No se modificarán los datos que no sean de contactos. Se ignorará cualquier dato ajeno a los contactos de la persona a quien desees 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 el contacto se actualice 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 de la ETag del contacto, lo que indica que el contacto cambió desde que se leyeron los datos. Los clientes deben recibir a la persona más reciente y combinar sus actualizaciones con la última persona.

El servidor muestra un error 400 si se está actualizando memberships y no hay miembros del grupo de contactos especificados 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 contacto:

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

Las solicitudes de mutación del mismo usuario se deben enviar de forma secuencial para evitar una mayor 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

El nombre del recurso para la persona, asignado por el servidor. Una string ASCII con el formato people/{person_id}.

Parámetros de consulta

Parámetros
updatePersonFields

string (FieldMask format)

Obligatorio. Una máscara de campo que restringe los campos que se actualizan en la persona. Se pueden especificar varios campos separándolos con comas. Se reemplazarán todos los campos actualizados. A continuación, se indican los valores válidos:

  • addresses
  • biografías
  • cumpleaños
  • URL de calendario
  • datosdelcliente
  • Direcciones de correo electrónico
  • eventos
  • ID externos
  • Sexos
  • clientes potenciales
  • Intereses
  • locales
  • ubicaciones
  • memberships
  • palabras clave varias
  • names
  • sobrenombres
  • profesiones
  • organizations
  • númerosdeteléfono
  • relaciones
  • direccionessip
  • url
  • definido por el usuario
personFields

string (FieldMask format)

Opcional. Una máscara de campo que restringe los campos que se muestran en cada persona. Se pueden especificar varios campos separándolos con comas. Si no se establece, la configuración predeterminada es todos los campos. A continuación, se indican los valores válidos:

  • addresses
  • Rangos de edad
  • biografías
  • cumpleaños
  • URL de calendario
  • datosdelcliente
  • fotos de portada
  • Direcciones de correo electrónico
  • eventos
  • ID externos
  • Sexos
  • clientes potenciales
  • Intereses
  • locales
  • ubicaciones
  • memberships
  • metadata
  • palabras clave varias
  • names
  • sobrenombres
  • profesiones
  • organizations
  • númerosdeteléfono
  • fotos
  • relaciones
  • direccionessip
  • skills
  • url
  • definido por el usuario
sources[]

enum (ReadSourceType)

Opcional. Una máscara de los tipos de fuentes que se mostrarán La configuración predeterminada es READ_SOURCE_TYPE_CONTACT y READ_SOURCE_TYPE_PROFILE si no se configura.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye 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.