تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قبل البدء في تطوير التطبيقات، يجب مراجعة
بنود خدمة Chrome Policy API
وإنشاء مشروع على Google Cloud وتفعيل Chrome Policy API وإعداد
بيانات اعتماد الوصول.
يجب أن يتوفّر مشروع على Google Cloud لاستخدام Chrome Policy API. يشكّل هذا المشروع الأساس لإنشاء جميع خدمات Google Cloud وتفعيلها واستخدامها،
بما في ذلك إدارة واجهات برمجة التطبيقات وتفعيل الفوترة وإضافة المتعاونين وإزالتهم وإدارة الأذونات.
إذا لم يكن لديك مشروع على Google Cloud تريد استخدامه، اتّبِع
الخطوات التالية لإنشاء مشروع على Google Cloud:
في أعلى يمين الصفحة، انقر على رمز القائمة menu>واجهات برمجة التطبيقات والخدمات>شاشة موافقة OAuth.
اختر نوع المستخدِم لتطبيقك، ثم انقر على إنشاء.
أكمل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
انقر على إضافة نطاقات أو إزالتها. تظهر لوحة تحتوي على قائمة بالنطاقات لكل
واجهة برمجة تطبيقات تم تفعيلها في مشروع Google Cloud. أضِف أحد نطاقات التفويض التالية:
في أعلى يمين الصفحة، انقر على رمز القائمة menu>واجهات برمجة التطبيقات والخدمات>بيانات الاعتماد.
انقر على إنشاء بيانات اعتماد>معرِّف عميل OAuth.
اتّبِع الخطوات لإنشاء بيانات اعتماد OAuth 2.0.
ولا يحتاج مشرف Chrome في المؤسسة إلى أي إعداد خاص في "وحدة تحكُّم المشرف" لمصادقة OAuth 2.0. يجب أن يحصل مستخدمو تطبيقك على
أذونات دور المشرف المطلوبة
المرتبطة بحساباتهم، وعليهم الموافقة على شاشة
الموافقة على OAuth الخاصة بالتطبيق.
حساب الخدمة هو نوع خاص من الحسابات يستخدمه التطبيق، وليس
من الأشخاص. يمكنك استخدام حساب الخدمة للوصول إلى البيانات أو تنفيذ إجراءات
من خلال حساب الروبوت نفسه أو للوصول إلى البيانات نيابةً عن المستخدمين.
لمزيد من التفاصيل، راجِع مقالة فهم حسابات الخدمة.
اختياري: أدخِل المستخدمين أو المجموعات التي يمكنها إدارة الإجراءات وتنفيذها باستخدام حساب الخدمة هذا. للتعرّف على مزيد من التفاصيل، يُرجى الاطّلاع على المقالة إدارة انتحال هوية حساب الخدمة.
انقر على تم. بعد بضع دقائق، سيظهر حساب الخدمة الجديد في قائمة "حسابات الخدمة". (قد تحتاج إلى إعادة تحميل الصفحة.)
في قائمة "حسابات الخدمة"، انقر على حساب الخدمة الذي أنشأته.
انقر على المفاتيح>إضافة مفاتيح>إنشاء مفتاح جديد.
اختَر JSON، ثم انقر على إنشاء.
يتم إنشاء زوج المفاتيح العام/الخاص الجديد وتنزيله على جهازك كملف جديد. هذا الملف هو النسخة الوحيدة من هذا المفتاح. للحصول على معلومات عن كيفية تخزين مفتاحك بأمان، يُرجى الاطّلاع على إدارة مفاتيح حساب الخدمة.
تفويض حساب الخدمة في "وحدة تحكُّم المشرف"
إذا اخترت مصادقة الطلبات كحساب خدمة، على مشرف Chrome في المؤسسة تنفيذ خطوات إضافية في وحدة تحكّم المشرف لإكمال العملية.
يمكن لمشرف Chrome إما إسناد دور لحساب الخدمة مباشرةً
باستخدام أذونات دور المشرف المطلوبة
أو يمكن لمشرف Chrome إعداد تفويض على مستوى النطاق حتى يتمكّن حساب الخدمة
من انتحال هوية المستخدمين الذين يملكون الأذونات المناسبة والتصرف نيابةً عنهم.
لإعداد تفويض على مستوى النطاق لحساب الخدمة، على مشرف Chrome
اتّباع الخطوات التالية في "وحدة تحكّم المشرف":
في الحقل "نطاقات OAuth"، أدخِل قائمة مفصولة بفواصل للنطاقات التي يطلبها تطبيق حساب الخدمة. هذه هي مجموعة النطاقات نفسها التي يتم تحديدها عند ضبط شاشة موافقة OAuth.
في أعلى يمين الصفحة، انقر على رمز القائمة menu>واجهات برمجة التطبيقات والخدمات>بيانات الاعتماد.
انقر على إنشاء بيانات اعتماد>معرِّف عميل OAuth.
انقر على نوع التطبيق>تطبيق الويب.
في حقل "الاسم"، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في Cloud Console.
خلال وقت الاختبار، أضِف https://developers.google.com/oauthplayground إلى "معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه". يمكنك إزالة معرّف الموارد المنتظم (URI) لإعادة التوجيه هذا من تطبيقك عند الانتهاء من الاختبار، إذا لزم الأمر.
انقر على إنشاء وانسخ "معرِّف العميل" و "سر العميل" إلى الحافظة.
في أعلى يسار الصفحة، انقر على إعدادات OAuth 2.0 settings.
اختَر استخدام بيانات اعتماد OAuth الخاصة بك. بعد ذلك، الصِق "معرّف العميل" و "سر العميل" اللذين نسختهما في الخطوة 8، وانقر على إغلاق.
على يمين الصفحة، اتّبِع خطوات "مساحة المرح لبروتوكول OAuth 2.0":
بالنسبة إلى "الخطوة 1: اختيار واجهات برمجة التطبيقات واعتمادها"، أضِف https://www.googleapis.com/auth/chrome.management.policy وأي نطاقات أخرى مطلوبة لواجهة برمجة التطبيقات، ثم انقر على تفويض واجهات برمجة التطبيقات.
بالنسبة إلى "الخطوة 2: استبدال رمز تفويض الرموز المميّزة"، يمكنك اختياريًا تحديد إعادة التحميل التلقائي للرمز المميّز قبل انتهاء صلاحيته.
بالنسبة إلى "الخطوة 3: ضبط الطلب لواجهة برمجة التطبيقات"، أدخِل عنوان URI لطلب واجهة برمجة تطبيقات سياسة Chrome، مع تعديل "طريقة HTTP" والإعدادات الأخرى حسب الحاجة. مثال على طلب عنوان URL: https://chromepolicy.googleapis.com/v1/customers/my_customer/policySchemas?filter=chrome.printers
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eBefore starting development, review the Chrome Policy API Terms of Service, create a Google Cloud project, enable the Chrome Policy API, and set up access credentials.\u003c/p\u003e\n"],["\u003cp\u003eYou need to create a Google Cloud project to utilize the Chrome Policy API, which enables API management, billing, collaboration, and permission control.\u003c/p\u003e\n"],["\u003cp\u003eThe Chrome Policy API allows for end-user or service account authentication, with specific steps provided for setting up each method.\u003c/p\u003e\n"],["\u003cp\u003eTo authorize your application, you may need to configure OAuth consent screen and potentially domain-wide delegation in the Admin console.\u003c/p\u003e\n"],["\u003cp\u003eUse the OAuth Playground for testing your application's functionality and ensure your application is marked as trusted by the organization's administrator in the Admin console.\u003c/p\u003e\n"]]],[],null,["# Set up & authorize requests\n\nBefore you begin developing, you need to review the\n[Chrome Policy API Terms of Service](http://console.cloud.google.com/tos?id=chrome-policy),\ncreate a Google Cloud project, enable the Chrome Policy API, and set up\naccess credentials.\n\nThe Chrome Policy API respects [admin role permissions](/chrome/policy/guides/policy-schemas#namespaces)\nand is governed by defined [authorization scopes](#step_3_create_credentials).\n\nStep 1: Create a Google Cloud project\n-------------------------------------\n\nA Google Cloud project is required to use the Chrome Policy API. This project\nforms the basis for creating, enabling, and using all Google Cloud services,\nincluding managing APIs, enabling billing, adding and removing collaborators,\nand managing permissions.\n\nIf you don't already have a Google Cloud project you want to use, follow the\nsteps below to create a Google Cloud project:\n\n1. Open the [Google Cloud Console](https://console.cloud.google.com/).\n2. At the top-left, click Menu menu \\\u003e **IAM \\& Admin** \\\u003e **Create a Project**.\n3. In the **Project Name** field, enter a descriptive name for your project.\n4. In the **Location** field, click **Browse** to display the organizations available for assignment. Choose the organization for which you want to manage Chrome policies, then click **Select**.\n5. Click **Create**. The console navigates to the Dashboard page and your project is created within a few minutes.\n\nStep 2: Enable the Chrome Policy API\n------------------------------------\n\nTo enable the Chrome Policy API in your Google Cloud project:\n| **Caution:** Before you enable this API, make sure you've reviewed and agreed to the [Chrome Policy API Terms of Service](http://console.cloud.google.com/tos?id=chrome-policy).\n\n1. Open the [Google Cloud Console](https://console.cloud.google.com/).\n2. At the top, choose your Google Cloud project.\n3. At the top-left, click Menu menu \\\u003e **APIs \\& Services** \\\u003e **Library**.\n4. In the search field, enter \"Chrome\" and press **Enter**.\n5. In the list of search results, click **Chrome Policy API**.\n6. Click **Enable**.\n7. To enable more APIs, repeat steps 2--5.\n\nStep 3: Create credentials\n--------------------------\n\nRequests to the Chrome Policy API can be authenticated as an end user or a robot\nservice account.\n\n### Configure the OAuth consent screen\n\n1. Open the [Google Cloud Console](https://console.cloud.google.com/).\n2. At the top, choose your Google Cloud project.\n3. At the top-left, click Menu menu \\\u003e **APIs \\& Services** \\\u003e **OAuth consent screen**.\n4. Select the user type for your app, then click **Create**.\n5. Complete the app registration form, then click **Save and Continue**.\n6. Click **Add or remove scopes**. A panel appears with a list of scopes for\n each API you've enabled in your Google Cloud project. Add one of the\n following authorization scopes:\n\n - `https://www.googleapis.com/auth/chrome.management.policy`\n - `https://www.googleapis.com/auth/chrome.management.policy.readonly`\n\n The `readonly` scope doesn't allow any mutation operations.\n | **Note:** These scopes are categorized as *Sensitive scopes*. An app verification process is only required for apps used outside of an organization.\n\n### Set up end user or service account authentication\n\nClick an option below for detailed instructions:\n\n#### Option 1: Authenticate as an end user with OAuth 2.0\n\n1. Open the [Google Cloud Console](https://console.cloud.google.com/).\n2. At the top, choose your Google Cloud project.\n3. At the top-left, click Menu menu \\\u003e **APIs \\& Services** \\\u003e **Credentials**.\n4. Click **Create Credentials** \\\u003e **OAuth client ID**.\n5. Follow the steps to create the OAuth 2.0 credentials.\n\n\nNo special setup is required in the Admin console by the organization's Chrome\nadmin for OAuth 2.0 authentication. Users of your app will need to have the\n[required admin role permissions](/chrome/policy/guides/policy-schemas#namespaces)\nassociated with their account and need to agree to the app's OAuth consent\nscreen.\n\n\n**Tip:** You can [test your app in the OAuth Playground](#test-your-app).\n\n#### Option 2: Authenticate as a service account\n\n\nA service account is a special kind of account used by an application, rather\nthan a person. You can use a service account to access data or perform actions\nby the robot account itself, or to access data on behalf of users.\nFor more details, refer to\n[Understanding service accounts](https://cloud.google.com/iam/docs/understanding-service-accounts).\n\n#### Create a service account \\& credentials\n\n1. Open the [Google Cloud Console](https://console.cloud.google.com/).\n2. At the top, choose your Google Cloud project.\n3. At the top-left, click Menu menu \\\u003e **APIs \\& Services** \\\u003e **Credentials**.\n4. Click **Create Credentials** \\\u003e **Service account**.\n5. Enter service account name, then click **Create and continue**.\n6. Optional: Assign roles to your service account to grant access to your Google Cloud project's resources. For more details, refer to [Granting, changing, and revoking access to resources](https://cloud.google.com/iam/docs/granting-changing-revoking-access).\n7. Click **Continue**.\n8. Optional: Enter users or groups that can manage and perform actions with this service account. For more details, refer to [Managing service account impersonation](https://cloud.google.com/iam/docs/impersonating-service-accounts).\n9. Click **Done**. After a few minutes, your new service account appears in the \"Service Accounts\" list. (You might need to refresh the page.)\n10. In the \"Service Accounts\" list, click the service account you created.\n11. Click **Keys** \\\u003e **Add keys** \\\u003e **Create new key**.\n12. Select **JSON** , then click **Create** .\n\n Your new public/private key pair is generated and downloaded to your machine as a new file. This file is the only copy of this key. For information about how to store your key securely, see [Managing service account keys](https://cloud.google.com/iam/docs/understanding-service-accounts#managing_service_account_keys).\n\n#### Authorize the service account in the Admin console\n\n\nIf you choose to authenticate requests as a service account, the\norganization's Chrome administrator needs to perform additional steps in the\nAdmin console to complete the process.\n\n\nThe Chrome admin can either [assign a role to the service account directly](https://support.google.com/a/answer/33325)\nwith the [required admin role permissions](/chrome/policy/guides/policy-schemas#namespaces),\nor the Chrome admin can set up domain-wide delegation so the service account\ncan impersonate users with proper permissions and act on their behalf.\n\n\nTo set up domain-wide delegation for your service account, the Chrome admin\nneeds to follow these steps in the Admin console:\n\n1. Open the [Admin console](https://admin.google.com/).\n2. At the top-left, click Menu menu \\\u003e **Security** \\\u003e **Access and data control** \\\u003e **API controls**.\n3. Click **Manage Domain Wide Delegation**.\n4. Click **Add new**.\n5. In the \"Client ID\" field, paste the client ID associated with your service account. [Learn how to find your service account's client ID.](https://developers.google.com/workspace/guides/create-credentials#optional_set_up_domain-wide_delegation_for_a_service_account)\n6. In the \"OAuth Scopes\" field, enter a comma-delimited list of the scopes required by the service account application. This is the same set of scopes defined when configuring the OAuth consent screen.\n7. Click **Authorize**.\n\nStep 4: Test your app in the OAuth Playground\n---------------------------------------------\n\n1. Open the [Google Cloud Console](https://console.cloud.google.com/).\n2. At the top, choose your Google Cloud project.\n3. At the top-left, click Menu menu \\\u003e **APIs \\& Services** \\\u003e **Credentials**.\n4. Click **Create Credentials** \\\u003e **OAuth client ID**.\n5. Click **Application type** \\\u003e **Web application**.\n6. In the \"Name\" field, type a name for the credential. This name is only shown in the Cloud Console.\n7. For the time of testing, add `https://developers.google.com/oauthplayground` to \"Authorized redirect URIs.\" You can remove this redirect URI from your app when done testing, if needed.\n8. Click **Create** and copy the \"client ID\" and \"client secret\" to your clipboard.\n9. In a new tab, open the [OAuth 2.0 Playground](https://developers.google.com/oauthplayground/).\n10. At the top-right, click OAuth 2.0 configuration settings.\n11. Select **Use your own OAuth credentials** . Then, paste the \"client ID\" and \"client secret\" you copied in step 8 and click **Close**.\n12. At the left, follow the OAuth 2.0 Playground steps:\n - For \"Step 1: Select \\& authorize APIs,\" add `https://www.googleapis.com/auth/chrome.management.policy` and any other needed API scopes, then click **Authorize APIs**.\n - For \"Step 2: Exchange authorization code for tokens,\" you can optionally select **Auto-refresh the token before it expires**.\n - For \"Step 3: Configure request to API,\" enter your Chrome Policy API request URI, modifying the \"HTTP Method\" and other settings, as needed. Example URL request: `https://chromepolicy.googleapis.com/v1/customers/my_customer/policySchemas?filter=chrome.printers`\n\nStep 5: Verify your app is trusted\n----------------------------------\n\nAn organization's admin can mark apps as trusted or blocked in the\nAdmin console. For more details, see [Control which third-party \\& internal apps access Google Workspace data](https://support.google.com/a/answer/7281227#zippy=%2Cmanage-access-to-apps-trusted-limited-or-blocked)."]]
