- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
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 |
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 ( |
Champs | |
---|---|
photoBytes |
Obligatoire. Octets de photo brute Chaîne encodée en base64. |
personFields |
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 :
|
sources[] |
Facultatif. Masque les types de sources à renvoyer. La valeur par défaut est |
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 ( |
Champs | |
---|---|
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.