Method: licenseNotification.list
تم إيقافه نهائيًا: يمكن تتبُّع أحداث التثبيت التي بدأها المستخدِم من خلال إحصاءات Google.
الحصول على قائمة بإشعارات الترخيص المتعلّقة بتطبيق معيّن
طلب HTTP
GET https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}
يستخدِم عنوان URL بنية تحويل ترميز 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-02-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieves licensing notifications (provisions, expirations, deletions, reassignments) for a given Google Workspace Marketplace application."],["Requires the `https://www.googleapis.com/auth/appsmarketplace.license` OAuth scope for authorization."],["Uses a GET request to the `https://appsmarket.googleapis.com/appsmarket/v2/licenseNotification/{applicationId}` endpoint with optional query parameters for pagination and filtering by timestamp."],["Returns a JSON response containing a list of `LicenseNotification` objects and a token for retrieving further results if available."]]],["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"]]
