Method: people.updateContact

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

string

Il nome della risorsa della persona, assegnato dal server. Una stringa ASCII nel formato people/{person_id}.

Parametri di query

Parametri
updatePersonFields

string (FieldMask format)

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:

  • indirizzi
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • miscKeywords
  • nomi
  • nickname
  • professioni
  • organizzazioni
  • phoneNumbers
  • relazioni
  • sipAddresses
  • Url
  • userDefined
personFields

string (FieldMask format)

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:

  • indirizzi
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • nomi
  • nickname
  • professioni
  • organizzazioni
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • Url
  • userDefined
sources[]

enum (ReadSourceType)

Facoltativo. Una maschera dei tipi di origine da restituire. Se non viene impostato, il valore predefinito è READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

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.