- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
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 |
Es el nombre del recurso de la persona que asignó el servidor. Es una cadena ASCII con el formato |
Parámetros de consulta
| Parámetros | |
|---|---|
updatePersonFields |
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:
|
personFields |
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:
|
sources[] |
Opcional. Es una máscara de los tipos de fuentes que se mostrarán. Si no se configura, el valor predeterminado es |
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.