Method: people.updateContactPhoto

Aggiornare la foto di un contatto.

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/{resourceName=people/*}:updateContactPhoto

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resourceName

string

obbligatorio. Nome risorsa persona

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Campi
photoBytes

string (bytes format)

obbligatorio. Byte foto non elaborati

Una stringa con codifica Base64.

personFields

string (FieldMask format)

Campo facoltativo. Una maschera di campo per limitare i campi restituiti per la persona. È possibile specificare più campi separandoli con virgole. Il valore predefinito è vuoto se non è impostato, in modo da saltare il getto di post mutate. 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 risposta

La risposta per l'aggiornamento della foto di un contatto.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "person": {
    object (Person)
  }
}
Campi
person

object (Person)

La persona aggiornata, se campi persona è impostata in UpdateContactFotoRequest. In caso contrario, l'impostazione verrà annullata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/contacts

Per ulteriori informazioni, consulta la guida all'autorizzazione.