Method: licenseNotification.list

  • 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.

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.