Method: licenseNotification.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
非推奨: ユーザーが開始したインストール イベントは、Google アナリティクスでトラッキングできます。
特定のアプリに関するライセンス通知のリストを取得します。
HTTP リクエスト
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
applicationId |
string
アプリケーション ID
|
クエリ パラメータ
パラメータ |
max-results |
integer (uint32 format)
|
start-token |
string
|
timestamp |
string
エポックからのタイムスタンプ(ミリ秒単位)
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
{
"kind": string,
"notifications": [
{
object (LicenseNotification )
}
],
"nextPageToken": string
} |
フィールド |
kind |
string
|
notifications[] |
object (LicenseNotification )
通知のリスト。次の項目を 1 つまたは複数入力します。
provisions : アプリケーションの新しいライセンスがプロビジョニングされました。
expiries : アプリケーションのライセンスの有効期限が切れています。
deletions : ドメインからアプリケーションが削除されました。
reassignments : 管理者が、指定されたドメインのアプリケーションのシートライセンスを割り当てまたは取り消しました。
|
nextPageToken |
string
現在の結果セットの最後の通知の後に通知の検索を続行するために使用されるトークン。
|
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/appsmarketplace.license
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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)."]]