Method: people.updateContact

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

string

Nom de ressource de la personne, attribué par le serveur. Chaîne ASCII au format people/{person_id}.

Paramètres de requête

Paramètres
updatePersonFields

string (FieldMask format)

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 :

  • addresses
  • biographies
  • anniversaires
  • calendarUrls
  • clientData
  • emailAddresses
  • événements
  • externalIds
  • critères de sexe
  • imClients
  • centres d'intérêt
  • locales
  • zones géographiques
  • aux chaînes
  • miscKeywords
  • noms
  • pseudos
  • professions
  • organizations
  • phoneNumbers
  • relations
  • sipAddresses
  • URL
  • userDefined
personFields

string (FieldMask format)

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 :

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

enum (ReadSourceType)

Facultatif. Masque des types de sources à renvoyer. Si cette valeur n'est pas définie, la valeur par défaut est READ_SOURCE_TYPE_CONTACT et READ_SOURCE_TYPE_PROFILE.

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.