Method: people.updateContact

Mettez à jour les données de contact d'un contact existant. Les données sans contact ne seront pas modifiées. 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 le contact à mettre à jour ou s'il n'existe aucune source de contact.

Le serveur renvoie une erreur 400 avec la raison "failedPrecondition" si person.metadata.sources.etag est différent de l'ETag du contact, ce qui indique que le contact a été modifié depuis que ses données ont été lues. Les clients doivent trouver la dernière personne et fusionner ses mises à jour avec la dernière personne.

Le serveur renvoie une erreur 400 si memberships sont mis à jour et qu'aucune appartenance à un groupe de contacts n'est spécifiée pour la personne.

Le serveur renvoie une erreur 400 si plusieurs champs sont spécifiés dans un champ qui est un singleton des sources de contact:

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

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/{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 sous la forme 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 qui sont 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
  • externalIds
  • critères de sexe
  • imClients
  • centres d'intérêt
  • locales
  • emplacement
  • aux chaînes
  • miscKeywords
  • names
  • surnoms
  • professions
  • organizations
  • phoneNumbers
  • relations
  • sipAddresses
  • urls
  • userDefined
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. Si aucun champ n'est défini, tous les champs sont renseignés par défaut. Les valeurs possibles 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
  • emplacement
  • aux chaînes
  • métadonnées
  • miscKeywords
  • names
  • surnoms
  • professions
  • organizations
  • phoneNumbers
  • photos
  • relations
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Facultatif. Masque les types de sources à renvoyer. La valeur par défaut est READ_SOURCE_TYPE_CONTACT, et READ_SOURCE_TYPE_PROFILE si ce n'est pas le cas.

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.

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.