Method: contactGroups.create

Créez un groupe de contacts appartenant à l'utilisateur authentifié.

Les noms des groupes de contacts créés doivent être uniques pour les groupes de contacts des utilisateurs. Si vous essayez de créer un groupe avec un nom en double, vous obtiendrez une erreur HTTP 409.

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Champs
contactGroup

object (ContactGroup)

Obligatoire. Groupe de contacts à créer.
readGroupFields

string (FieldMask format)

Facultatif. Masque de champ permettant de limiter les champs du groupe qui sont renvoyés. La valeur par défaut est metadata, groupType et name s'il n'est pas défini ou s'il est vide. Les champs valides sont les suivants:

  • clientData
  • groupType
  • métadonnées
  • nom

Corps de la réponse

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

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.