Method: people.updateContact

Atualizar os dados de contato de um contato atual. Os dados que não forem de contato não serão modificados. Todos os dados não relacionados ao contato na pessoa que será atualizada serão ignorados. Todos os campos especificados na updateMask serão substituídos.

O servidor retornará um erro 400 se person.metadata.sources não for especificado para o contato a ser atualizado ou se não houver uma origem do contato.

O servidor retornará um erro 400 com o motivo "failedPrecondition" se person.metadata.sources.etag for diferente da etag do contato, o que indica que ele foi alterado após a leitura dos dados. Os clientes precisam encontrar a pessoa mais recente e mesclar as atualizações com ela.

O servidor retornará um erro 400 se memberships estiver sendo atualizado e não houver associações ao grupo de contatos especificadas na pessoa.

O servidor retornará um erro 400 se mais de um campo for especificado em um campo que é um singleton para origens de contatos:

  • biografias
  • aniversários
  • sexos
  • names

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

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

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

Parâmetros de caminho

Parâmetros
person.resourceName

string

O nome do recurso da pessoa, atribuído pelo servidor. Uma string ASCII na forma de people/{person_id}.

Parâmetros de consulta

Parâmetros
updatePersonFields

string (FieldMask format)

Obrigatório. Uma máscara de campo para restringir os campos na pessoa que são atualizados. Vários campos podem ser especificados separando-os com vírgulas. Todos os campos atualizados serão substituídos. Os valores válidos são:

  • addresses
  • biografias
  • aniversários
  • URLs da agenda
  • DadosdoCliente
  • emailAddresses
  • eventos
  • externalIds
  • sexos
  • IClients
  • interesses
  • locales
  • locais
  • dos canais
  • miscPalavras-chave
  • names
  • apelidos
  • profissões
  • organizations
  • phoneNumbers
  • relações
  • Endereços IP
  • urls
  • definido pelo usuário
personFields

string (FieldMask format)

Opcional. Uma máscara de campo para restringir quais campos em cada pessoa são retornados. Vários campos podem ser especificados separando-os com vírgulas. Se não for definido, o padrão será todos os campos. 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. Se não for definido, o padrão será READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

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.