Method: licenseNotification.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הוצא משימוש: אפשר לעקוב אחרי אירועי התקנה שהמשתמשים יזמו דרך Google Analytics.
הפונקציה מקבלת רשימה של התראות רישוי לגבי אפליקציה נתונה.
בקשת HTTP
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
applicationId |
string
מזהה האפליקציה
|
פרמטרים של שאילתה
| פרמטרים |
max-results |
integer (uint32 format)
|
start-token |
string
|
timestamp |
string
חותמת זמן באלפיות שנייה מאז תחילת התקופה של זמן מערכת
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"kind": string,
"notifications": [
{
object (LicenseNotification)
}
],
"nextPageToken": string
} |
| שדות |
kind |
string
|
notifications[] |
object (LicenseNotification)
רשימת ההתראות. אחת או יותר מהאפשרויות הבאות:
provisions: הוקצה רישיון חדש לאפליקציה.expiries: פג תוקף הרישיון של האפליקציה.deletions: אפליקציה נמחקה מדומיין.reassignments: אדמין הקצה או ביטל רישיון למשתמש לאפליקציה בדומיין שצוין.
|
nextPageToken |
string
האסימון שמשמש להמשך השאילתה על התראות אחרי ההתראה האחרונה בקבוצת התוצאות הנוכחית.
|
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/appsmarketplace.license
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 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)."]]
