Method: alerts.list

Liste les alertes.

Requête HTTP

GET https://alertcenter.googleapis.com/v1beta1/alerts

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
customerId

string

Facultatif. Identifiant unique du compte Google Workspace du client auquel les alertes sont associées. L'élément customerId doit comporter le premier "C" (par exemple, 046psxkn). Déduit à partir de l'identité de l'appelant si aucune valeur n'est fournie. Trouvez votre numéro client.
pageSize

integer

Facultatif. La taille de page demandée. Le serveur peut renvoyer moins d'articles que demandé. Si aucune valeur n'est spécifiée, le serveur choisit une valeur par défaut appropriée.
pageToken

string

Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer. Si ce champ est vide, une nouvelle itération est lancée. Pour continuer une itération, transmettez la valeur du champ nextPageToken de la précédente ListAlertsResponse.
filter

string

Facultatif. Chaîne de requête permettant de filtrer les résultats des alertes. Pour en savoir plus, consultez Filtres de requête et Champs de filtre de requête acceptés.
orderBy

string

Facultatif. Ordre de tri des résultats de la liste. S'ils ne sont pas spécifiés, les résultats peuvent être renvoyés dans un ordre arbitraire. Vous pouvez trier les résultats par ordre décroissant en fonction du code temporel de création à l'aide de orderBy="createTime desc". Actuellement, les options de tri createTime asc, createTime desc et updateTime desc sont acceptées

Corps de la requête

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

Corps de la réponse

Message de réponse à une demande d'alerte liste.

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

Représentation JSON 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Champs
alerts[]

object (Alert)

Liste des alertes.
nextPageToken

string

Jeton pour la page suivante. Si ce champ n'est pas vide, indique que d'autres alertes peuvent correspondre à la demande d'annonce. cette valeur peut être utilisée dans un ListAlertsRequest ultérieur pour obtenir des alertes se poursuivant à partir du dernier résultat de l'appel de liste en cours.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/apps.alerts

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