Google Workspace Marketplace API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتيح لك دمج تطبيقاتك على Google Workspace Marketplace مع خدمات الترخيص والفوترة من Google.
الخدمة: appsmarket.googleapis.com
للاتّصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي تقدّمها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.
المستند المرتبط بميزة "اقتراحات"
مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدّة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:
https://appsmarket.googleapis.com
| الطُرق |
get |
GET /appsmarket/v2/customerLicense/{applicationId}/{customerId}
للحصول على حالة ترخيص عميل لتحديد ما إذا كان لديه إذن الوصول إلى تطبيق معيّن. |
| الطُرق |
list
(deprecated) |
GET /appsmarket/v2/licenseNotification/{applicationId}
تم إيقافه نهائيًا: يمكن تتبُّع أحداث التثبيت التي بدأها المستخدِم من خلال إحصاءات Google. |
| الطُرق |
get |
GET /appsmarket/v2/userLicense/{applicationId}/{userId}
للحصول على حالة ترخيص المستخدم لإذنه باستخدام تطبيق معيّن. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eEnables Google Workspace Marketplace apps to integrate with Google's licensing and billing services.\u003c/p\u003e\n"],["\u003cp\u003eOffers REST resources to manage customer and user licenses, including checking license status.\u003c/p\u003e\n"],["\u003cp\u003eProvides a discovery document for building client libraries and tools interacting with the API.\u003c/p\u003e\n"],["\u003cp\u003eUses \u003ccode\u003ehttps://appsmarket.googleapis.com\u003c/code\u003e as the service endpoint for API requests.\u003c/p\u003e\n"],["\u003cp\u003eIncludes a deprecated method for tracking user-initiated installs, recommending Google Analytics instead.\u003c/p\u003e\n"]]],["The `appsmarket.googleapis.com` service enables Google Workspace Marketplace apps to integrate with licensing and billing. Use client libraries or direct API requests with the provided discovery document and service endpoint (`https://appsmarket.googleapis.com`). Key actions include: retrieving a customer's license status via `GET /appsmarket/v2/customerLicense/{applicationId}/{customerId}`, and retrieving a user's license status using `GET /appsmarket/v2/userLicense/{applicationId}/{userId}`. There is a deprecated action to list notifications via `GET /appsmarket/v2/licenseNotification/{applicationId}`.\n"],null,["# Google Workspace Marketplace API\n\nLets your Google Workspace Marketplace applications integrate with Google's licensing and billing services.\n\nService: appsmarket.googleapis.com\n----------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://appsmarket.googleapis.com/$discovery/rest?version=v2\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://appsmarket.googleapis.com`\n\nREST Resource: [v2.customerLicense](/workspace/marketplace/reference/rest/v2/customerLicense)\n---------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/workspace/marketplace/reference/rest/v2/customerLicense/get) | `GET /appsmarket/v2/customerLicense/{applicationId}/{customerId}` Gets the status of a license for a customer to determine if they have access for a given app. |\n\nREST Resource: [v2.licenseNotification](/workspace/marketplace/reference/rest/v2/licenseNotification)\n-----------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [list](/workspace/marketplace/reference/rest/v2/licenseNotification/list)` ` **(deprecated)** | `GET /appsmarket/v2/licenseNotification/{applicationId}` Deprecated: User-initiated install events can be tracked through [Google Analytics](https://developers.google.com/workspace/marketplace/use-analytics#app-metrics). |\n\nREST Resource: [v2.userLicense](/workspace/marketplace/reference/rest/v2/userLicense)\n-------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/workspace/marketplace/reference/rest/v2/userLicense/get) | `GET /appsmarket/v2/userLicense/{applicationId}/{userId}` Gets the user's licensing status for their permission to use a given app. |"]]
