Method: people.createContact

Criar um novo contato e retornar o recurso de pessoa desse contato.

A solicitação retornará um erro 400 se mais de um campo for especificado em um campo que é um singleton para origens de contato:

  • biografias
  • aniversários
  • sexos
  • names

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

Solicitação HTTP

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

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

Parâmetros de consulta

Parâmetros
personFields

string (FieldMask format)

Obrigatório. Uma máscara de campo para restringir quais campos de cada pessoa são retornados. É possível especificar vários campos separados por vírgulas. Se não for definido, o padrão será todos os campos. Os valores válidos são:

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

enum (ReadSourceType)

Opcional. Uma máscara dos tipos de origem a serem retornados. O padrão será READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE, se nenhum valor for definido.

Corpo da solicitação

O corpo da solicitação contém uma instância de Person.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Person.

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.