Method: contactGroups.create

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

Les noms de groupe de contacts créés doivent être propres aux 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 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/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 renvoyés. Les valeurs par défaut sont metadata, groupType et name si elles ne sont pas définies ou si le champ est vide. Les champs valides sont les suivants:

  • clientData
  • groupType
  • métadonnées
  • name

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.