Got 5 minutes? Help us improve Google Workspace Marketplace documentation by taking
a quick online survey.
Method: licenseNotification.list
Deprecated: User-initiated install events can be tracked through Google Analytics.
Gets a list of licensing notifications with regards to a given app.
HTTP request
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
applicationId |
string
Application Id
|
Query parameters
| Parameters |
max-results |
integer (uint32 format)
|
start-token |
string
|
timestamp |
string
Timestamp in milliseconds since epoch
|
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| JSON representation |
{
"kind": string,
"notifications": [
{
object (LicenseNotification)
}
],
"nextPageToken": string
} |
| Fields |
kind |
string
|
notifications[] |
object (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.
|
nextPageToken |
string
The token used to continue querying for notifications after the final notification in the current result set.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/appsmarketplace.license
For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-27 UTC.
[null,null,["Last updated 2025-02-27 UTC."],[[["Retrieves licensing notifications (provisions, expirations, deletions, reassignments) for a given Google Workspace Marketplace application."],["Requires the `https://www.googleapis.com/auth/appsmarketplace.license` OAuth scope for authorization."],["Uses a GET request to the `https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}` endpoint with optional query parameters for pagination and filtering by timestamp."],["Returns a JSON response containing a list of `LicenseNotification` objects and a token for retrieving further results if available."]]],["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"]]
