- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Aggiorna i dati di contatto di una persona di contatto esistente. I dati non relativi al contatto non verranno modificati. Eventuali dati non relativi ai contatti della persona da aggiornare verranno ignorati. Tutti i campi specificati in updateMask
verranno sostituiti.
Il server restituisce un errore 400 se non è specificato person.metadata.sources
per il contatto da aggiornare o se non è presente un'origine contatto.
Il server restituisce un errore 400 con il motivo "failedPrecondition"
se "failedPrecondition"
è diverso dall'etag del contatto, il che indica che il contatto è cambiato da quando i suoi dati sono stati letti.person.metadata.sources.etag
I clienti devono ottenere l'ultima persona ed eseguire l'unione dei propri aggiornamenti con l'ultima persona. Se apporti aggiornamenti sequenziali alla stessa persona, devi utilizzare l'etag della risposta updateContact
per evitare errori.
Il server restituisce un errore 400 se vengono aggiornati i dati di memberships
e non sono specificati adesioni ai gruppi di contatto per la persona.
Il server restituisce un errore 400 se viene specificato più di un campo in un campo che è un singleton per le origini contatto:
- biografie
- compleanni
- generi
- nomi
Le richieste di mutazione per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.
Richiesta HTTP
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
person.resourceName |
Il nome della risorsa della persona, assegnato dal server. Una stringa ASCII nel formato |
Parametri di query
Parametri | |
---|---|
updatePersonFields |
Obbligatorio. Una maschera di campo per limitare i campi della persona che vengono aggiornati. È possibile specificare più campi separandoli con virgole. Tutti i campi aggiornati verranno sostituiti. I valori validi sono:
|
personFields |
Facoltativo. Una maschera di campo per limitare i campi di ogni persona restituiti. È possibile specificare più campi separandoli con virgole. Se non viene impostato, il valore predefinito è tutti i campi. I valori validi sono:
|
sources[] |
Facoltativo. Una maschera dei tipi di origine da restituire. Se non viene impostato, il valore predefinito è |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Person
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Person
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/contacts
Per ulteriori informazioni, consulta la Guida all'autorizzazione.