Method: licenseNotification.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منسوخ شده: رویدادهای نصب آغاز شده توسط کاربر را می توان از طریق Google Analytics ردیابی کرد.
فهرستی از اعلان‌های مجوز را در رابطه با یک برنامه خاص دریافت می‌کند.
درخواست HTTP
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
