- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- ContactToCreate
- Faça um teste
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 ( |
Campos | |
---|---|
contacts[] |
Obrigatório. O contato a ser criado. Permite até 200 contatos em uma única solicitação. |
readMask |
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:
|
sources[] |
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á |
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 ( |
Campos | |
---|---|
createdPeople[] |
Os contatos que foram criados, a menos que a solicitação |
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 ( |
Campos | |
---|---|
contactPerson |
Obrigatório. Os dados pessoais para preencher uma fonte recém-criada. |