REST Resource: contactGroups

Ressource: ContactGroup

Un groupe de contacts.

Représentation JSON
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (ContactGroupMetadata)
  },
  "groupType": enum (GroupType),
  "name": string,
  "formattedName": string,
  "memberResourceNames": [
    string
  ],
  "memberCount": integer,
  "clientData": [
    {
      object (GroupClientData)
    }
  ]
}
Champs
resourceName

string

Nom de ressource du groupe de contacts, attribué par le serveur. Chaîne ASCII, sous la forme contactGroups/{contactGroupId}.

etag

string

Le tag d'entité HTTP de la ressource. Utilisé pour la validation du cache Web.

metadata

object (ContactGroupMetadata)

Uniquement en sortie. Métadonnées sur le groupe de contacts.

groupType

enum (GroupType)

Uniquement en sortie. Type de groupe de contacts.

name

string

Nom du groupe de contacts défini par le propriétaire du groupe ou nom fourni par le système pour les groupes système.

Pour contactGroups.create ou contactGroups.update, le nom doit être propre 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.

formattedName

string

Uniquement en sortie. Nom traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language pour les noms des groupes système. Les noms de groupe définis par le propriétaire sont identiques au nom.

memberResourceNames[]

string

Uniquement en sortie. Liste des noms de ressources des contacts membres du groupe de contacts. Ce champ n'est renseigné que pour les requêtes GET et n'affiche que le nombre de membres maxMembers dans la requête get.

memberCount

integer

Uniquement en sortie. Nombre total de contacts dans le groupe, quel que soit le nombre maximal de membres spécifié dans la demande.

clientData[]

object (GroupClientData)

Données client du groupe.

ContactGroupMetadata

Métadonnées d'un groupe de contacts.

Représentation JSON
{
  "updateTime": string,
  "deleted": boolean
}
Champs
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour du groupe.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

deleted

boolean

Uniquement en sortie. "True" si la ressource de groupe de contacts a été supprimée. Renseigné uniquement pour les requêtes contactGroups.list incluant un jeton de synchronisation.

GroupType

Un type de groupe de contacts.

Enums
GROUP_TYPE_UNSPECIFIED URL indéterminée.
USER_CONTACT_GROUP Groupe de contacts personnalisé
SYSTEM_CONTACT_GROUP Groupe de contacts défini par le système.

GroupClientData

Données de client arbitraires renseignées par les clients. Les clés et les valeurs en double sont autorisées.

Représentation JSON
{
  "key": string,
  "value": string
}
Champs
key

string

Clé des données client spécifiée par le client.

value

string

Valeur des données client spécifiée par le client.

Méthodes

batchGet

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

create

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

delete

Supprimez un groupe de contacts existant appartenant à l'utilisateur authentifié en spécifiant un nom de ressource de groupe de contacts.

get

Obtenez un groupe de contacts spécifique appartenant à l'utilisateur authentifié en spécifiant un nom de ressource de groupe de contacts.

list

Listez tous les groupes de contacts appartenant à l'utilisateur authentifié.

update

Mettez à jour le nom d'un groupe de contacts existant appartenant à l'utilisateur authentifié.