Actualiza un lote de contactos y muestra un mapa de nombres de recursos a PersonResponses para los contactos actualizados.
Las solicitudes de modificación para el mismo usuario deben enviarse de forma secuencial para evitar aumentos de latencia y fallas.
Solicitud HTTP
POST https://people.googleapis.com/v1/people:batchUpdateContacts
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "contacts": { string: { object ( |
Campos | |
---|---|
contacts |
Obligatorio. Un mapa de nombres de recursos para los datos de personas que se actualizarán. Permite hasta 200 contactos en una sola solicitud. Es un objeto que contiene una lista de pares |
updateMask |
Obligatorio. Una máscara de campo que restringe los campos de la persona que se actualizan. Se pueden especificar varios campos separándolos con comas. Todos los campos especificados se reemplazarán o se borrarán si se deja vacío para cada persona. Estos son los valores válidos:
|
readMask |
Obligatorio. Una máscara de campo que restringe los campos que se muestran de cada persona. Se pueden especificar varios campos separándolos con comas. Si la máscara de lectura se deja vacía, se omite post-mutate-get y no se mostrarán datos en la respuesta. Estos son los valores válidos:
|
sources[] |
Opcional. Una máscara de los tipos de fuentes que se mostrarán. La configuración predeterminada es |
Cuerpo de la respuesta
Si no se ejecuta correctamente, muestra BatchUpdateContactsErrorDetails
, una lista de errores que corresponden a cada contacto.
Es la respuesta a una solicitud para actualizar un lote de contactos.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"updateResult": {
string: {
object ( |
Campos | |
---|---|
updateResult |
Un mapa de los nombres de los recursos de los contactos que se actualizaron, a menos que la solicitud Es un objeto que contiene una lista de pares |
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.