Mettre à jour un lot de contacts et renvoyer un mappage de noms de ressources vers PersonResponses pour les contacts mis à jour
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
POST https://people.googleapis.com/v1/people:batchUpdateContacts
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "contacts": { string: { object ( |
Champs | |
---|---|
contacts |
Obligatoire. Mappage des noms de ressources aux données de la personne à mettre à jour. Jusqu'à 200 contacts peuvent être inclus dans une même requête. Objet contenant une liste de paires |
updateMask |
Obligatoire. Masque de champ permettant de limiter les champs de la personne qui sont mis à jour. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Tous les champs spécifiés seront remplacés ou effacés s'ils sont laissés vides pour chaque personne. Les valeurs possibles sont les suivantes :
|
readMask |
Obligatoire. Masque de champ permettant de limiter les champs renvoyés pour chaque personne. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Si le masque de lecture est vide, la méthode post-mutate-get est ignorée et aucune donnée n'est renvoyée dans la réponse. 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
En cas d'échec, renvoie BatchUpdateContactsErrorDetails
, une liste d'erreurs correspondant à chaque contact.
Réponse à une requête de mise à jour d'un lot de contacts.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"updateResult": {
string: {
object ( |
Champs | |
---|---|
updateResult |
Un mappage des noms de ressources aux contacts mis à jour, sauf si la requête Objet contenant une liste de paires |
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.