Method: licenseNotification.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Obsolète: les événements d'installation déclenchés par l'utilisateur peuvent être suivis via Google Analytics.
Récupère la liste des notifications de licence concernant une application donnée.
Requête HTTP
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
applicationId |
string
ID de l'application
|
Paramètres de requête
| Paramètres |
max-results |
integer (uint32 format)
|
start-token |
string
|
timestamp |
string
Code temporel en millisecondes depuis l'epoch
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
| Représentation JSON |
{
"kind": string,
"notifications": [
{
object (LicenseNotification)
}
],
"nextPageToken": string
} |
| Champs |
kind |
string
|
notifications[] |
object (LicenseNotification)
Liste des notifications. Un ou plusieurs des éléments suivants :
provisions: une nouvelle licence de l'application a été provisionnée.expiries: une licence de l'application a expiré.deletions: une application a été supprimée d'un domaine.reassignments: un administrateur a attribué ou révoqué une licence d'accès pour l'application sur le domaine fourni.
|
nextPageToken |
string
Jeton utilisé pour continuer à envoyer des requêtes de notifications après la dernière notification de l'ensemble de résultats actuel.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/appsmarketplace.license
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eRetrieves licensing notifications (provisions, expirations, deletions, reassignments) for a given Google Workspace Marketplace application.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/appsmarketplace.license\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eUses a GET request to the \u003ccode\u003ehttps://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}\u003c/code\u003e endpoint with optional query parameters for pagination and filtering by timestamp.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response containing a list of \u003ccode\u003eLicenseNotification\u003c/code\u003e objects and a token for retrieving further results if available.\u003c/p\u003e\n"]]],["This document details retrieving licensing notifications for a given application via a `GET` request to `appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}`. It uses parameters like `max-results`, `start-token`, and `timestamp`. The response includes a `kind`, an array of `notifications` detailing provisions, expiries, deletions, or reassignments, and a `nextPageToken` for pagination. User-initiated install tracking should use Google Analytics, and the request requires the `https://www.googleapis.com/auth/appsmarketplace.license` OAuth scope.\n"],null,["# Method: licenseNotification.list\n\n| This item is deprecated!\nDeprecated: User-initiated install events can be tracked through [Google Analytics](https://developers.google.com/workspace/marketplace/use-analytics#app-metrics).\n\nGets a list of licensing notifications with regards to a given app.\n\n### HTTP request\n\n`GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------|-------------------------|\n| `applicationId` | `string` Application Id |\n\n### Query parameters\n\n| Parameters ||\n|---------------|---------------------------------------------------------------------------------------|\n| `max-results` | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` |\n| `start-token` | `string` |\n| `timestamp` | `string` Timestamp in milliseconds since epoch |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"notifications\": [ { object (/workspace/marketplace/reference/rest/v2/licenseNotification#LicenseNotification) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` |\n| `notifications[]` | `object (`[LicenseNotification](/workspace/marketplace/reference/rest/v2/licenseNotification#LicenseNotification)`)` The list of notifications. One or more of: - `provisions`: A new license of the application has been provisioned. - `expiries`: A license of the application has expired. - `deletions`: An application has been deleted from a domain. - `reassignments`: An administrator has assigned or revoked a seat license for the application on the provided domain. |\n| `nextPageToken` | `string` The token used to continue querying for notifications after the final notification in the current result set. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/appsmarketplace.license`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
