Method: people.updateContact

Aggiornare i dati di contatto di un contatto esistente. I dati che non sono relativi ai contatti non verranno modificati. Tutti i dati che non riguardano la persona da aggiornare verranno ignorati. Tutti i campi specificati in updateMask verranno sostituiti.

Il server restituisce un errore 400 se person.metadata.sources non è specificato per il contatto da aggiornare o se non esiste un'origine del contatto.

Il server restituisce un errore 400 con motivo "failedPrecondition" se person.metadata.sources.etag è diverso dall'etag del contatto, il che indica che il contatto è cambiato dalla lettura dei suoi dati. I clienti dovrebbero ottenere l'utente più recente e unire i loro aggiornamenti alla persona più recente.

Il server restituisce un errore 400 se memberships è in fase di aggiornamento e non sono state specificate iscrizioni a gruppi di contatti per la persona in questione.

Il server restituisce un errore 400 se viene specificato più di un campo in un campo che è un singleton per le origini dei contatti:

  • biografie
  • compleanni
  • generi
  • names

Le richieste modificate 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 per la persona, assegnato dal server. Una stringa ASCII nel formato people/{person_id}.

Parametri di ricerca

Parametri
updatePersonFields

string (FieldMask format)

obbligatorio. Una maschera di campo per limitare i campi aggiornati per la persona. È possibile specificare più campi separandoli con virgole. Tutti i campi aggiornati verranno sostituiti. I valori validi sono:

  • addresses
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • miscKeywords
  • names
  • nickname
  • occupazioni
  • organizations
  • phoneNumbers
  • relazioni
  • sipAddresses
  • urls
  • userDefined
personFields

string (FieldMask format)

Campo facoltativo. Una maschera di campo per limitare i campi restituiti per ogni persona. È possibile specificare più campi separandoli con virgole. Se non viene configurato, il valore predefinito è tutti i campi. I valori validi sono:

  • addresses
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • names
  • nickname
  • occupazioni
  • organizations
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Campo facoltativo. Una maschera dei tipi di origine da restituire. Se non viene configurato, 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.