- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
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 |
O nome do recurso da pessoa, atribuído pelo servidor. Uma string ASCII na forma de |
Parâmetros de consulta
Parâmetros | |
---|---|
updatePersonFields |
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:
|
personFields |
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:
|
sources[] |
Opcional. Uma máscara dos tipos de origem a serem retornados. Se não for definido, o padrão será |
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.