تتيح واجهة برمجة التطبيقات الخاصة برموز التسجيل في "إدارة Chrome" للمشرفين إدارة رموز التسجيل المستخدَمة لتسجيل متصفّحات Chrome في Chrome Enterprise Core. يمكن استخدام مجموعة واجهات برمجة التطبيقات هذه لإنشاء رموز التسجيل واستردادها وعرضها وإبطالها لأجهزتهم.
نظرة عامة سريعة على طرق واجهة برمجة التطبيقات
عناوين URL مرتبطة بـ https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| الوصف | عنوان URL نسبي | طريقة Http |
|---|---|---|
| إنشاء رمز مميّز للتسجيل | /enrollmentTokens | نشر مشاركة |
| استرداد رمز مميّز للتسجيل | /enrollmentTokens/{token_permanent_id} | الاطّلاع على |
| إدراج رموز التسجيل | /enrollmentTokens | الاطّلاع على |
| إبطال رمز مميّز للتسجيل | /enrollmentTokens/{token_permanent_id}:revoke | نشر مشاركة |
يمكنك الاطّلاع على نماذج الرموز للاطّلاع على أمثلة على الطلبات والردود.
جارٍ فلترة النتائج
عند إدراج رموز التسجيل باستخدام طريقة
/enrollmentTokens،
يمكنك تضييق نطاق النتائج باستخدام مَعلمة طلب البحث filter. يجب أن يتم إلغاء جميع مَعلمات الفلتر بتنسيق URL عند إرسالها في طلبات HTTP. يمكن دمج شروط متعددة باستخدام عامل التشغيل AND.
- حقول السلسلة وحقول التعداد: تتوافق مع عاملَي المقارنة
=و:. - الفلترة حسب الوحدة التنظيمية: يمكنك فلترة الرموز المميزة التي تم إنشاؤها لوحدة تنظيمية محدّدة من خلال تحديد
org_unit_pathأوorg_unit_id.
الحقول القابلة للفلترة
| الحقل | الوصف |
|---|---|
device_type
|
نوع الجهاز الذي يتم استخدام رموز التسجيل المميَّزة معه (CHROME_BROWSER حاليًا) |
token_state
|
حالة الرمز المميّز للتسجيل (ACTIVE أو EXPIRED أو REVOKED) |
org_unit_path
|
مسار الوحدة التنظيمية لرمز التسجيل المميّز (مثلاً /Marketing) |
org_unit_id
|
المعرّف غير الواضح للوحدة التنظيمية الخاصة برمز التسجيل |
امتيازات المشرف
تلتزم واجهة برمجة التطبيقات Chrome Management Enrollment Tokens API بتفويض دور المشرف.
| الطريقة | امتيازات المشرف مطلوبة |
|---|---|
| CreateEnrollmentToken | "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة" |
| GetEnrollmentToken | "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة" أو "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة -> القراءة" |
| ListEnrollmentTokens | "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة" أو "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة -> القراءة" |
| RevokeEnrollmentToken | "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة" |
لإدارة أدوار المشرفين وامتيازاتهم، انتقِل إلى "وحدة تحكّم المشرف -> أدوار المشرف".
نطاقات واجهة برمجة التطبيقات
تتطلّب واجهة برمجة التطبيقات Chrome Management Enrollment Tokens API نطاقات OAuth التالية:
| الطريقة | نطاقات OAuth المطلوبة |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens or https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens or https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.