Method: contactGroups.batchGet

Obtenez une liste des groupes de contacts appartenant à l'utilisateur authentifié en spécifiant une liste de noms de ressources de groupe de contacts.

Requête HTTP

GET https://people.googleapis.com/v1/contactGroups:batchGet

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
resourceNames[]

string

Obligatoire. Noms de ressources des groupes de contacts à récupérer.

Le nombre de noms de ressources est limité à 200.
maxMembers

integer

Facultatif. Spécifie le nombre maximal de membres à renvoyer pour chaque groupe. Si ce champ n'est pas défini, la valeur par défaut est 0. Aucun membre ne sera renvoyé.
groupFields

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, memberCount et name s'il n'est pas défini ou s'il est vide. Les champs valides sont les suivants:

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

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse à une requête de récupération par lot de groupes de contacts.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "responses": [
    {
      object (ContactGroupResponse)
    }
  ]
}
Champs
responses[]

object (ContactGroupResponse)

Liste des réponses pour chaque ressource de groupe de contacts demandée.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly

Pour en savoir plus, consultez le Guide relatif aux autorisations.

ContactGroupResponse

La réponse pour un groupe de contacts spécifique.

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

string

Nom de ressource demandé à l'origine.
status

object (Status)

État de la réponse.
contactGroup

object (ContactGroup)

Le groupe de contacts.