Method: licenseNotification.list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Descontinuado: os eventos de instalação iniciados pelo usuário podem ser rastreados pelo Google Analytics.
Recebe uma lista de notificações de licenciamento relacionadas a um determinado app.
Solicitação HTTP
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
applicationId |
string
ID do aplicativo
|
Parâmetros de consulta
| Parâmetros |
max-results |
integer (uint32 format)
|
start-token |
string
|
timestamp |
string
Carimbo de data/hora em milissegundos desde a época
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:
| Representação JSON |
{
"kind": string,
"notifications": [
{
object (LicenseNotification)
}
],
"nextPageToken": string
} |
| Campos |
kind |
string
|
notifications[] |
object (LicenseNotification)
A lista de notificações. Um ou mais de:
provisions: uma nova licença do aplicativo foi provisionada.expiries: uma licença do aplicativo expirou.deletions: um app foi excluído de um domínio.reassignments: um administrador atribuiu ou revogou uma licença de assento para o aplicativo no domínio fornecido.
|
nextPageToken |
string
O token usado para continuar a consultar notificações após a última notificação no conjunto de resultados atual.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/appsmarketplace.license
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
