Chrome Policy API هي حزمة من الخدمات تتيح لمشرفي Chrome عرض سياسات Chrome المخصّصة للوحدات التنظيمية في مؤسساتهم وإدارتها آليًا. باستخدام واجهة برمجة التطبيقات هذه، يمكن لمشرفي Chrome الحصول على إحصاءات حول كيفية استخدام أجهزة ChromeOS ومتصفّحات Chrome في مؤسساتهم.
المزايا الرئيسية
التوافق مع وحدة تحكم المشرف في Google: تظهر التغييرات التي تجريها باستخدام واجهة برمجة التطبيقات في واجهة المستخدم لوحدة تحكم المشرف في Google، والعكس صحيح.
تسجيل التدقيق: يتم تسجيل التغييرات التي يتم إجراؤها باستخدام واجهة برمجة التطبيقات هذه في سجلات تدقيق المشرف العادية.
المنهج المستند إلى البيانات: يتم تمثيل سياسات Chrome كبيانات ولا تتم الإشارة إليها مباشرةً من خلال واجهة واجهة برمجة التطبيقات. ويتيح لك ذلك تشغيل برامج واجهة برمجة التطبيقات آليًا لاستهلاك سياسات Chrome المستقبلية بدون تطوير إضافي. بمرور الوقت، سيزيد عدد السياسات المتوافقة مع واجهة برمجة التطبيقات.
تكملة واجهة برمجة تطبيقات SDK للمشرف: تُكمل واجهة برمجة التطبيقات هذه واجهة برمجة تطبيقات SDK للمشرف، حيث يمكن لمشرفي Chrome تنفيذ المهام التالية:
- إدارة أجهزة Chrome باستخدام Directory API ضمن "SDK للمشرف"
- إدارة متصفِّحات Chrome باستخدام "واجهة برمجة التطبيقات لإدارة متصفّح Chrome" ضمن "SDK للمشرف"
- إدارة طابعات CUPS في Chrome باستخدام واجهة برمجة تطبيقات إدارة الطابعات في Chrome لحزمة SDK للمشرف.
حالات الاستخدام الشائعة
يعرض الجدول أدناه أهم المهام التي يمكنك إكمالها باستخدام واجهة برمجة التطبيقات هذه. لمراجعة أمثلة على الطلبات والردود، يمكنك الانتقال إلى نماذج التعليمات البرمجية.
ترتبط عناوين URL بـ https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER.
| وصف المهمة | عنوان URL نسبي | إجراء HTTP | مَعلمات الطلب |
|---|---|---|---|
| إدراج مخططات السياسة | ./policySchemas |
GET |
اختياري: filter وpageSize وpageToken |
| الحصول على مخطط سياسة | ./policySchemas/$SCHEMA_NAME |
GET |
|
| الحصول على السياسات أو إدراجها لوحدة تنظيمية أو مجموعة | ./policies:resolve |
POST |
مطلوب: policySchemaFilter، policyTargetKey
اختياري: |
| تعديل السياسات في وحدة تنظيمية | ./policies/orgunits:batchModify |
POST |
مطلوب: requests: {policyTargetKey, policyValue, updateMask} |
| اكتساب السياسات في وحدة تنظيمية | ./policies/orgunits:batchInherit |
POST |
مطلوب: requests: {policyTargetKey, policySchema} |
| تعديل السياسات في مجموعة | ./policies/groups:batchModify |
POST |
مطلوب: requests: {policyTargetKey, policyValue, updateMask} |
| حذف السياسات في مجموعة | ./policies/groups:batchDelete |
POST |
مطلوب: requests: {policyTargetKey, policySchema} |
| إدراج ترتيبات الأولويات في مجموعة | ./policies/groups:listGroupPriorityOrdering |
POST |
مطلوب: requests: {policyTargetKey, policyNamespace} |
| تعديل الترتيبات ذات الأولوية في مجموعة | ./policies/groups:updateGroupPriorityOrdering |
POST |
مطلوب: requests: {policyTargetKey, policyNamespace, groupIds} |
| تحميل الملفات لسياسة | ./policies/files:uploadPolicyFile |
POST |
مطلوب: requests: {policyField} |
حدود الاستخدام
ويقتصر استخدام واجهة برمجة التطبيقات هذه على الاستخدام الداخلي في مؤسسة عميل Chrome. لمزيد من التفاصيل، راجِع بنود خدمة Chrome Policy API. لإنشاء عميل تجاري لواجهة برمجة التطبيقات بالشراكة مع Google، أرسِل طلب شريك.