Method: people.updateContactPhoto

mettre à jour la photo d'un contact ;

Les requêtes de mutation pour un même utilisateur doivent être envoyées de manière séquentielle afin d'éviter une augmentation de la latence et des échecs.

Requête HTTP

PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
resourceName

string

Obligatoire. Nom de la ressource de la personne

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Champs
photoBytes

string (bytes format)

Obligatoire. Octets de photo brute

Chaîne encodée en base64.

personFields

string (FieldMask format)

Facultatif. Masque de champ permettant de limiter les champs renvoyés pour la personne. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Si aucune valeur n'est définie, la valeur par défaut est vide. La méthode post-mutate get est donc ignorée. Les valeurs possibles sont les suivantes :

  • addresses
  • ageRanges
  • biographies
  • anniversaires
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • événements
  • externalIds
  • critères de sexe
  • imClients
  • centres d'intérêt
  • locales
  • emplacement
  • aux chaînes
  • métadonnées
  • miscKeywords
  • names
  • surnoms
  • professions
  • organizations
  • phoneNumbers
  • photos
  • relations
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Facultatif. Masque les types de sources à renvoyer. La valeur par défaut est READ_SOURCE_TYPE_CONTACT, et READ_SOURCE_TYPE_PROFILE si ce n'est pas le cas.

Corps de la réponse

Réponse pour la mise à jour de la photo d'un contact.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "person": {
    object (Person)
  }
}
Champs
person

object (Person)

La personne mise à jour, si personFields est défini dans UpdateContactPhotoRequest ; sinon cette valeur n'est pas définie.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le guide relatif aux autorisations.