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. Le "C" initial doit être supprimé de l'customerId (par exemple, 046psxkn). Déduit de l'identité de l'appelant s'il n'est pas fourni. Trouvez votre numéro client.

pageSize

integer

Facultatif. La taille de page demandée. Le serveur peut renvoyer moins d'articles que nécessaire. 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 poursuivre une itération, transmettez la valeur du champ nextPageToken de ListAlertsResponse précédente.

filter

string

Facultatif. Chaîne de requête permettant de filtrer les résultats d'alerte. Pour en savoir plus, consultez les sections Filtres de requête et Champs de filtre de requête compatibles.

orderBy

string

Facultatif. Ordre de tri des résultats de la liste. Si aucun résultat n'est spécifié, les résultats peuvent être renvoyés dans un ordre arbitraire. Vous pouvez trier les résultats par ordre décroissant en fonction de l'horodatage de création à l'aide de orderBy="createTime desc". Actuellement, les options de tri acceptées sont createTime asc, createTime desc et updateTime desc.

Corps de la requête

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

Corps de la réponse

Message de réponse à une requête d'alerte de fiche.

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 de la page suivante. Si ce champ n'est pas vide, cela signifie que d'autres alertes correspondent peut-être à la demande de fiche. Cette valeur peut être utilisée dans un ListAlertsRequest ultérieur pour recevoir des alertes à 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 sur les autorisations.