Method: people.batchCreateContacts

Cria um lote de novos contatos e retorna PersonResponses para a

As solicitações de modificação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.

Solicitação HTTP

POST https://people.googleapis.com/v1/people:batchCreateContacts

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Campos
contacts[]

object (ContactToCreate)

Obrigatório. O contato a ser criado. Permite até 200 contatos em uma única solicitação.

readMask

string (FieldMask format)

Obrigatório. Uma máscara de campo para restringir quais campos em cada pessoa são retornados na resposta. Vários campos podem ser especificados separados por vírgulas. Se a máscara de leitura for deixada em branco, a tag post-mutate-get será ignorada e nenhum dado será retornado na resposta. Os valores válidos são:

  • addresses
  • ageRanges
  • biografias
  • aniversários
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventos
  • externalIds
  • sexos
  • imClients
  • interesses
  • locales
  • locais
  • dos canais
  • metadados
  • miscKeywords
  • nomes
  • apelidos
  • ocupações
  • organizations
  • phoneNumbers
  • fotos
  • relações
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Opcional. Uma máscara dos tipos de fonte a serem retornados na leitura da postagem mutate. Se não for definido, o padrão será READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

Corpo da resposta

Se não for bem-sucedido, retorna BatchCreateContactsErrorDetails que contém uma lista de erros para cada contato inválido.

A resposta a uma solicitação para criar um lote de contatos.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Campos
createdPeople[]

object (PersonResponse)

Os contatos que foram criados, a menos que a solicitação readMask esteja vazia.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/contacts

Para mais informações, consulte o Guia de autorização.

ContactToCreate

Um wrapper que contém os dados pessoais para preencher uma origem recém-criada.

Representação JSON
{
  "contactPerson": {
    object (Person)
  }
}
Campos
contactPerson

object (Person)

Obrigatório. Os dados pessoais para preencher uma fonte recém-criada.