- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- ContactToCreate
- Pruébala
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 ( |
Campos | |
---|---|
contacts[] |
Obligatorio. El contacto que se creará. Permite hasta 200 contactos en una sola solicitud. |
readMask |
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:
|
sources[] |
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 |
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 ( |
Campos | |
---|---|
createdPeople[] |
Los contactos que se crearon, a menos que la solicitud |
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 ( |
Campos | |
---|---|
contactPerson |
Obligatorio. Los datos de la persona para propagar una fuente recién creada. |