Method: people.createContact

Créez un nouveau contact et renvoyez la ressource de personne pour ce contact.

La requête 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

POST https://people.googleapis.com/v1/people:createContact

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
personFields

string (FieldMask format)

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 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.