Method: people.batchCreateContacts

Crie um lote de novos contatos e retorne PersonResponses para o novo

As solicitações de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar maior 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 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 separando-os com vírgulas. Se a máscara de leitura for deixada em branco, o post-mut-get será ignorado e nenhum dado será retornado na resposta. Os valores válidos são:

  • addresses
  • Faixas etárias
  • biografias
  • aniversários
  • URLs da agenda
  • DadosdoCliente
  • fotos de capa
  • emailAddresses
  • eventos
  • externalIds
  • sexos
  • IClients
  • interesses
  • locales
  • locais
  • dos canais
  • metadados
  • miscPalavras-chave
  • names
  • apelidos
  • profissões
  • organizations
  • phoneNumbers
  • fotos
  • relações
  • Endereços IP
  • skills
  • urls
  • definido pelo usuário
sources[]

enum (ReadSourceType)

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

Corpo da resposta

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

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.

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.

CriarContato

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

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

object (Person)

Obrigatório. Os dados da pessoa para preencher uma origem recém-criada.