تتيح واجهة برمجة التطبيقات Customer Subscriptions API للمشرفين استرداد معلومات مجمّعة عن الاشتراكات والتراخيص لعميل معيّن.
تسترد هذه الخدمة تفاصيل الاشتراك على مستوى العميل في مختلف أنواع تراخيص ChromeOS:
- ترقية Chrome Enterprise (سنوية): معلومات عن اشتراكات "ترقية Chrome Enterprise" المتكررة سنويًا، بما في ذلك إجمالي عدد التراخيص التي تم شراؤها وتعيينها وغير المعيّنة، وتاريخ انتهاء الاشتراك
- ترقية Kiosk & Signage (سنوي): معلومات عن اشتراكات "ترقية Kiosk & Signage" المتكررة سنويًا، بما في ذلك عدد التراخيص وتاريخ انتهاء الاشتراك
- ترقية Chrome Enterprise / Education (دائمة): معلومات عن التراخيص الدائمة، بما في ذلك إجمالي عدد التراخيص التي تم شراؤها وتعيينها وغير المعيّنة والتراخيص التي تم إيقافها نهائيًا (التراخيص التي تم تسجيلها على جهاز تم إيقافه نهائيًا منذ ذلك الحين ولا يمكن نقلها) والتراخيص المتوفّرة بشروط (الترقيات الدائمة المستقلة التي تم إلغاء تسجيلها لأسباب متعلّقة بإذن إعادة السلع أو الضمان أو الإصلاح والتي يمكن إعادة استخدامها على جهاز من الطراز نفسه).
نظرة عامة سريعة على طرق واجهة برمجة التطبيقات
عناوين URL مرتبطة بـ
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| الوصف | عنوان URL نسبي | طريقة HTTP |
|---|---|---|
| الحصول على معلومات اشتراك العميل وترخيصه | /subscriptionInfo | الاطّلاع على |
يمكنك الاطّلاع على عيّنات التعليمات البرمجية للاطّلاع على أمثلة على الطلبات والردود.
امتيازات المشرف
تلتزم واجهة برمجة التطبيقات Customer Subscriptions API بتفويض دور المشرف.
| الطريقة | يجب الحصول على امتيازات المشرف |
|---|---|
| GetSubscriptionInfo | "الخدمات -> إدارة Chrome -> إدارة أجهزة ChromeOS > إدارة أجهزة ChromeOS (للقراءة فقط)" أو "الخدمات -> ChromeOS -> الأجهزة -> إدارة الأجهزة -> قراءة" |
لإدارة أدوار المشرفين وامتيازاتهم، يُرجى الانتقال إلى "وحدة تحكّم المشرف" > "أدوار المشرف".
نطاقات واجهة برمجة التطبيقات
تتطلّب واجهة برمجة التطبيقات Chrome Management Customer Subscriptions API نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.