Method: people.createContact

Créez un contact et renvoyez la ressource de cette personne.

La requête renvoie une erreur 400 si plusieurs champs sont spécifiés sur un champ qui est un singleton pour les sources de contact:

  • 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 :

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