Method: licenseNotification.list

customerLicense.get 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
maxResults

integer (uint32 format)

startToken

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 OAuth 2.0 Overview.

LicenseNotification

JSON representation
{
  "id": string,
  "applicationId": string,
  "timestamp": string,
  "customerId": string,
  "kind": string,
  "provisions": [
    {
      object (Provisions)
    }
  ],
  "expiries": [
    {
      object (Expiries)
    }
  ],
  "reassignments": [
    {
      object (Reassignments)
    }
  ],
  "deletes": [
    {
      object (Deletes)
    }
  ]
}
Fields
id

string

The ID of the license notification.

applicationId

string

The ID of the application according to this notification.

timestamp

string (int64 format)

The time the event occurred, measuring in milliseconds since the UNIX epoch.

customerId

string

The domain name of the customer corresponding to this notification.

kind

string

The type of API resource. This is always appsmarket#licenseNotification.

provisions[]

object (Provisions)

The list of provisioning notifications.

expiries[]

object (Expiries)

The list of expiry notifications.

reassignments[]

object (Reassignments)

The list of reassignment notifications.

deletes[]

object (Deletes)

The list of deletion notifications.

Provisions

JSON representation
{
  "kind": string,
  "editionId": string,
  "seatCount": string
}
Fields
kind

string

editionId

string

(Deprecated)

seatCount

string (int64 format)

The number of seats that were provisioned.

Expiries

JSON representation
{
  "kind": string,
  "editionId": string
}
Fields
kind

string

editionId

string

(Deprecated)

Reassignments

JSON representation
{
  "kind": string,
  "userId": string,
  "type": string,
  "editionId": string
}
Fields
kind

string

userId

string

The email address of the reassigned user.

type

string

editionId

string

(Deprecated)

Deletes

JSON representation
{
  "kind": string,
  "editionId": string
}
Fields
kind

string

editionId

string

(Deprecated)