Method: people.batchCreateContacts

Crea un lote de contactos nuevos y devuelve las PersonResponses para el nuevo

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:batchCreateContacts

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": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Campos
contacts[]

object (ContactToCreate)

Obligatorio. El contacto que se creará. Permite hasta 200 contactos en una sola solicitud.

readMask

string (FieldMask format)

Obligatorio. Una máscara de campo que restringe los campos de cada persona que se muestran en la respuesta. 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:

  • addresses
  • ageRanges
  • biografías
  • cumpleaños
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventos
  • externalIds
  • Sexos
  • imClients
  • Intereses
  • locales
  • de ubicaciones
  • memberships
  • metadatos
  • miscKeywords
  • names
  • sobrenombres
  • profesiones
  • organizations
  • phoneNumbers
  • fotos
  • relaciones
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Opcional. Es una máscara de los tipos de fuentes que se devuelven en la lectura de mutate de la publicación. La configuración predeterminada es READ_SOURCE_TYPE_CONTACT y READ_SOURCE_TYPE_PROFILE si no se configura.

Cuerpo de la respuesta

Si no funciona, muestra BatchCreateContactsErrorDetails, que contiene una lista de errores para cada contacto no válido.

Es la respuesta a una solicitud para crear un lote de contactos.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Campos
createdPeople[]

object (PersonResponse)

Los contactos que se crearon, a menos que la solicitud readMask esté vacía.

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.

ContactToCreate

Un wrapper que contiene los datos de la persona para propagar una fuente recién creada.

Representación JSON
{
  "contactPerson": {
    object (Person)
  }
}
Campos
contactPerson

object (Person)

Obligatorio. Los datos de la persona para propagar una fuente recién creada.