- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Mettre à jour les coordonnées d'un contact existant Les données sans contact ne seront pas modifiées. Toutes les données autres que les coordonnées de la personne à mettre à jour seront ignorées. Tous les champs spécifiés dans updateMask
seront remplacés.
Le serveur renvoie une erreur 400 si person.metadata.sources
n'est pas spécifié pour le contact à mettre à jour ou s'il n'y a pas de source de contact.
Le serveur renvoie une erreur 400 avec le motif "failedPrecondition"
si person.metadata.sources.etag
est différent de l'etag du contact, ce qui indique que le contact a changé depuis que ses données ont été lues. Les clients doivent obtenir la dernière personne et fusionner leurs mises à jour avec elle. Si vous effectuez des mises à jour séquentielles pour la même personne, vous devez utiliser l'etag de la réponse updateContact
pour éviter les échecs.
Le serveur renvoie une erreur 400 si des memberships
sont mis à jour et qu'aucun groupe de contacts n'est spécifié pour la personne.
Le serveur renvoie une erreur 400 si plusieurs champs sont spécifiés pour un champ qui est un singleton pour les sources de contacts:
- biographies
- anniversaires
- critères de sexe
- noms
Les requêtes de modification pour un même utilisateur doivent être envoyées de manière séquentielle pour éviter d'augmenter la latence et de rencontrer des erreurs.
Requête HTTP
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
person.resourceName |
Nom de ressource de la personne, attribué par le serveur. Chaîne ASCII au format |
Paramètres de requête
Paramètres | |
---|---|
updatePersonFields |
Obligatoire. Masque de champ permettant de restreindre les champs de la personne mis à jour. Vous pouvez spécifier plusieurs champs en les séparant par des virgules. Tous les champs mis à jour seront remplacés. Les valeurs valides sont les suivantes :
|
personFields |
Facultatif. Masque de champ permettant de restreindre les champs de chaque personne renvoyés. Vous pouvez spécifier plusieurs champs en les séparant par des virgules. Si ce paramètre n'est pas défini, la valeur par défaut est "tous les champs". Les valeurs valides sont les suivantes :
|
sources[] |
Facultatif. Masque des types de sources à renvoyer. Si cette valeur n'est pas définie, la valeur par défaut est |
Corps de la requête
Le corps de la requête contient une instance de Person
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Person
.
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 d'autorisation.