Method: people.updateContact

Mettre à jour les coordonnées d'un contact existant Aucune donnée ne provenant de contacts ne sera modifiée. Toutes les données sans contact 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 que le contact soit mis à 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 la lecture de ses données. Les clients doivent obtenir la dernière personne et fusionner leurs mises à jour avec la dernière personne.

Le serveur renvoie une erreur 400 si memberships est en cours de mise à jour et qu'aucune appartenance à un groupe de contacts n'a été spécifiée pour cette personne.

Le serveur renvoie une erreur 400 si plusieurs champs sont spécifiés sur un champ qui est un singleton pour les sources de contacts:

  • biographies
  • anniversaires
  • critères de sexe
  • names

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

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 pour 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 limiter les champs de la personne mis à jour. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Tous les champs mis à jour seront remplacés. Les valeurs possibles sont les suivantes :

  • addresses
  • biographies
  • anniversaires
  • calendarUrls
  • clientData
  • emailAddresses
  • événements
  • ID externes
  • critères de sexe
  • ImClients
  • centres d'intérêt
  • locales
  • zones géographiques
  • aux chaînes
  • Divers mots clés
  • names
  • pseudonymes
  • professions
  • organizations
  • phoneNumbers
  • relations
  • SipAddresses
  • URL
  • défini par l'utilisateur
personFields

string (FieldMask format)

Facultatif. 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. S'il n'est pas défini, la valeur par défaut est définie sur tous les champs. Les valeurs possibles sont les suivantes :

  • addresses
  • tranches d'âge
  • biographies
  • anniversaires
  • calendarUrls
  • clientData
  • photosdecouverture
  • emailAddresses
  • événements
  • ID externes
  • critères de sexe
  • ImClients
  • centres d'intérêt
  • locales
  • zones géographiques
  • aux chaînes
  • metadata
  • Divers mots clés
  • names
  • pseudonymes
  • professions
  • organizations
  • phoneNumbers
  • photos
  • relations
  • SipAddresses
  • skills
  • URL
  • défini par l'utilisateur
sources[]

enum (ReadSourceType)

Facultatif. Masque des types de sources à renvoyer. Si ce n'est pas le cas, les valeurs par défaut sont READ_SOURCE_TYPE_CONTACT et READ_SOURCE_TYPE_PROFILE.

Corps de la requête

Le corps de la requête contient une instance Person.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Person.

Niveaux d'accès 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.