إنشاء بيانات اعتماد للوصول

تُستخدَم بيانات الاعتماد للحصول على رمز مميّز للوصول من خوادم التفويض في Google ليتمكّن تطبيقك من طلب Google Workspace APIs. يوضّح هذا الدليل كيفية اختيار بيانات الاعتماد التي يحتاجها تطبيقك وإعدادها.

للاطّلاع على تعريفات المصطلحات الواردة في هذه الصفحة، يُرجى الرجوع إلى نظرة عامة على المصادقة والتفويض.

اختيار بيانات اعتماد الوصول المناسبة لك

تعتمد بيانات الاعتماد المطلوبة على نوع البيانات والنظام الأساسي ومنهجية الوصول في تطبيقك. تتوفّر ثلاثة أنواع من بيانات الاعتماد:

حالة الاستخدام	طريقة المصادقة	لمحة عن طريقة المصادقة هذه
الوصول بشكل مجهول إلى البيانات المتاحة للجميع في تطبيقك	مفاتيح واجهة برمجة التطبيقات	يجب التأكّد من أنّ واجهة برمجة التطبيقات التي تريد استخدامها تتيح استخدام مفاتيح واجهة برمجة التطبيقات قبل استخدام طريقة المصادقة هذه.
الوصول إلى بيانات المستخدم، مثل عنوان بريده الإلكتروني أو عمره	معرّف عميل OAuth	يتطلّب هذا الإجراء أن يطلب تطبيقك موافقة المستخدم ويتلقّاها منه.
الوصول إلى البيانات التي تخصّ تطبيقك أو الوصول إلى الموارد نيابةً عن مستخدمي Google Workspace أو Cloud Identity من خلال التفويض على مستوى النطاق.	حساب خدمة واحد ()	عندما تتم مصادقة تطبيق على أنّه حساب خدمة، يمكنه الوصول إلى جميع الموارد التي يملك حساب الخدمة إذن الوصول إليها.

بيانات اعتماد مفتاح واجهة برمجة التطبيقات

مفتاح واجهة برمجة التطبيقات هو سلسلة طويلة تحتوي على أحرف كبيرة وصغيرة وأرقام وشرطات سفلية وواصلات، مثل AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe. تُستخدَم طريقة المصادقة هذه للوصول بشكل مجهول إلى البيانات المتاحة للجميع، مثل ملفات Google Workspace التي تتم مشاركتها باستخدام إعداد المشاركة "أي مستخدم على الإنترنت لديه هذا الرابط". لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة استخدام مفاتيح واجهة برمجة التطبيقات.

لإنشاء مفتاح واجهة برمجة تطبيقات:

1. في Google Cloud Console، انتقِل إلى "القائمة" menu > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.

   الانتقال إلى "بيانات الاعتماد"

2. انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
3. يظهر مفتاح واجهة برمجة التطبيقات الجديد.
   • انقر على "نسخ" content_copy لنسخ مفتاح واجهة برمجة التطبيقات لاستخدامه في رمز تطبيقك. يمكنك أيضًا العثور على مفتاح واجهة برمجة التطبيقات في قسم "مفاتيح واجهة برمجة التطبيقات" ضمن بيانات اعتماد مشروعك.
   • لمنع الاستخدام غير المصرّح به، ننصحك بتقييد الأماكن وواجهات برمجة التطبيقات التي يمكن استخدام مفتاح واجهة برمجة التطبيقات فيها. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إضافة قيود على واجهة برمجة التطبيقات.

بيانات اعتماد معرّف عميل OAuth

لمصادقة المستخدمين النهائيين والوصول إلى بيانات المستخدم في تطبيقك، عليك إنشاء معرّف عميل واحد أو أكثر لبروتوكول OAuth 2.0. يُستخدَم معرّف العميل لتعريف تطبيق واحد لخوادم OAuth في Google. إذا كان تطبيقك يعمل على منصات متعددة، عليك إنشاء معرّف عميل منفصل لكل منصة.

اختَر نوع تطبيقك للحصول على تعليمات محدّدة حول كيفية إنشاء معرّف عميل OAuth:

تطبيق الويب

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العملاء.

   الانتقال إلى "العملاء"

2. انقر على إنشاء عميل.
3. انقر على نوع التطبيق > تطبيق الويب.
4. في حقل الاسم ، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google API Console.
5. أضِف معرّفات الموارد المنتظمة (URI) المصرّح بها المرتبطة بتطبيقك:
   • تطبيقات من جهة العميل (JavaScript): ضمن مصادر JavaScript المصرّح بها، انقر على إضافة معرّف الموارد المنتظم (URI). بعد ذلك، أدخِل معرّف الموارد المنتظم (URI) لاستخدامه في طلبات المتصفّح. يحدّد هذا المعرّف النطاقات التي يمكن لتطبيقك إرسال طلبات واجهة برمجة التطبيقات منها إلى خادم OAuth 2.0.
   • تطبيقات من جهة الخادم (Java وPython والمزيد): ضمن معرّفات الموارد المنتظمة (URI) المصرّح بها لإعادة التوجيه، انقر على إضافة معرّف الموارد المنتظم (URI). بعد ذلك، أدخِل معرّف الموارد المنتظم (URI) لنقطة نهاية يمكن لخادم OAuth 2.0 إرسال الردود إليه.
6. انقر على إنشاء.

   تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرّفات عملاء OAuth 2.0.

   يُرجى العِلم أنّه لا يتم استخدام أسرار العميل لتطبيقات الويب.

Android

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العملاء.

   الانتقال إلى "العملاء"

2. انقر على إنشاء عميل.
3. انقر على نوع التطبيق > Android.
4. في حقل "الاسم"، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google API Console.
5. في حقل "اسم الحزمة"، أدخِل اسم الحزمة من ملف AndroidManifest.xml.
6. في حقل "الملف المرجعي لشهادة SHA-1"، أدخِل الملف المرجعي لشهادة SHA-1 الذي أنشأته.
7. انقر على إنشاء.

   تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن "معرّفات عملاء OAuth 2.0".

iOS

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العملاء.

   الانتقال إلى "العملاء"

2. انقر على إنشاء عميل.
3. انقر على نوع التطبيق > iOS.
4. في حقل "الاسم"، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google API Console.
5. في حقل "معرّف الحزمة"، أدخِل معرّف الحزمة كما هو مدرَج في ملف Info.plist الخاص بالتطبيق.
6. اختياري: إذا كان تطبيقك يظهر في Apple App Store، أدخِل رقم تعريف متجر التطبيقات.
7. اختياري: في حقل "رقم تعريف الفريق"، أدخِل السلسلة الفريدة المكوّنة من 10 أحرف التي تنشئها Apple وتخصّصها لفريقك.
8. انقر على إنشاء.

   تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن "معرّفات عملاء OAuth 2.0".

إضافة Chrome

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العملاء.

   الانتقال إلى "العملاء"

2. انقر على إنشاء عميل.
3. انقر على نوع التطبيق > إضافة Chrome.
4. في حقل "الاسم"، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google API Console.
5. في حقل "رقم تعريف العنصر"، أدخِل سلسلة المعرّف الفريد المكوّنة من 32 حرفًا لتطبيقك. يمكنك العثور على قيمة المعرّف هذه في عنوان URL لتطبيقك في "سوق Chrome الإلكتروني" وفي لوحة بيانات المطوِّر في سوق Chrome الإلكتروني.
6. انقر على إنشاء.

   تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن "معرّفات عملاء OAuth 2.0".

تطبيق لأجهزة الكمبيوتر المكتبي

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العملاء.

   الانتقال إلى "العملاء"

2. انقر على إنشاء عميل.
3. انقر على نوع التطبيق > تطبيق لأجهزة الكمبيوتر المكتبي.
4. في حقل الاسم ، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google API Console.
5. انقر على إنشاء.

   تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن "معرّفات عملاء OAuth 2.0".

أجهزة التلفزيون والأجهزة التي تتطلّب إدخال بيانات محدودة

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العملاء.

   الانتقال إلى "العملاء"

2. انقر على إنشاء عميل.
3. انقر على نوع التطبيق > أجهزة التلفزيون والأجهزة التي تتطلّب إدخال بيانات محدودة.
4. في حقل "الاسم"، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google API Console.
5. انقر على إنشاء.

   تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن "معرّفات عملاء OAuth 2.0".

بيانات اعتماد حساب الخدمة

حساب الخدمة هو نوع خاص من الحسابات التي يستخدمها تطبيق، وليس شخصًا. يمكنك استخدام حساب خدمة للوصول إلى البيانات أو تنفيذ الإجراءات من خلال حساب الروبوت، أو للوصول إلى البيانات نيابةً عن مستخدمي Google Workspace أو Cloud Identity. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التعرّف على حسابات الخدمة.

إنشاء حساب خدمة

وحدة تحكّم Google API

1. في Google API Console، انتقِل إلى "القائمة" menu > إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.

   الانتقال إلى "حسابات الخدمة"

2. انقر على إنشاء حساب خدمة.
3. أدخِل تفاصيل حساب الخدمة، ثم انقر على إنشاء ومتابعة.
4. اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنح إذن الوصول إلى موارد مشروعك على Google Cloud. لمزيد من التفاصيل، يُرجى الرجوع إلى منح إذن الوصول إلى الموارد وتغييره وإبطاله.
5. انقر على متابعة.
6. اختياري: أدخِل المستخدمين أو المجموعات الذين يمكنهم إدارة حساب الخدمة هذا وتنفيذ الإجراءات من خلاله. لمزيد من التفاصيل، يُرجى الرجوع إلى مقالة إدارة انتحال هوية حساب الخدمة.
7. انقر على تم. سجِّل عنوان البريد الإلكتروني لحساب الخدمة.

gcloud CLI

1. أنشِئ حساب الخدمة:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنح إذن الوصول إلى موارد مشروعك على Google Cloud. لمزيد من التفاصيل، يُرجى الرجوع إلى منح إذن الوصول إلى الموارد وتغييره وإبطاله.

إسناد دور لحساب خدمة

يجب أن يُسنِد حساب مشرف متميّز دورًا محددًا مسبقًا أو مخصّصًا إلى حساب خدمة.

1. في وحدة تحكّم المشرف في Google، انتقِل إلى "القائمة" menu> الحساب > أدوار المشرف.

   الانتقال إلى "أدوار المشرف"

2. أشِر إلى الدور الذي تريد إسناده، ثم انقر على إسناد دور مشرف.

3. انقر على تخصيص حسابات الخدمة.

4. أدخِل عنوان البريد الإلكتروني لحساب الخدمة.

5. انقر على إضافة > إسناد الدور.

إنشاء بيانات اعتماد لحساب خدمة

عليك الحصول على بيانات اعتماد في شكل زوج مفتاح عام/خاص. يستخدم الرمز البرمجي بيانات الاعتماد هذه لتفويض إجراءات حساب الخدمة داخل تطبيقك.

للحصول على بيانات اعتماد لحساب الخدمة:

1. في Google Cloud Console، انتقِل إلى "القائمة" menu > إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.

   الانتقال إلى "حسابات الخدمة"

2. اختَر حساب الخدمة.
3. انقر على المفاتيح > إضافة مفتاح > إنشاء مفتاح جديد.
4. اختَر JSON ، ثم انقر على إنشاء.

   يتم إنشاء زوج مفتاح عام/خاص جديد وتنزيله على جهازك كملف جديد. احفظ ملف JSON الذي تم تنزيله باسم credentials.json في دليل العمل. هذا الملف هو النسخة الوحيدة من هذا المفتاح. للحصول على معلومات حول كيفية تخزين مفتاحك بشكل آمن، يُرجى الاطّلاع على مقالة إدارة مفاتيح حساب الخدمة.

5. انقر على إغلاق (Close).

اختياري: إعداد التفويض على مستوى النطاق لحساب خدمة

لاستدعاء واجهات برمجة التطبيقات نيابةً عن المستخدمين في مؤسسة Google Workspace، يجب منح حساب الخدمة إذن التفويض على مستوى النطاق في "وحدة تحكّم المشرف في Google Workspace" من خلال حساب مشرف متميّز. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض إذن على مستوى النطاق لحساب خدمة.

لإعداد إذن التفويض على مستوى النطاق لحساب خدمة:

1. في Google Cloud Console، انتقِل إلى "القائمة" menu > إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.

   الانتقال إلى "حسابات الخدمة"

2. اختَر حساب الخدمة.
3. انقر على إظهار الإعدادات المتقدمة.
4. ضمن "التفويض على مستوى النطاق"، ابحث عن "معرّف العميل" لحساب الخدمة. انقر على "نسخ" content_copy لنسخ قيمة معرّف العميل إلى الحافظة.

5. إذا كان لديك إذن وصول مشرف متميّز إلى حساب Google Workspace ذي الصلة، انقر على عرض "وحدة تحكّم المشرف في Google Workspace"، ثم سجِّل الدخول باستخدام حساب مستخدم مشرف متميّز وتابِع تنفيذ هذه الخطوات.

   إذا لم يكن لديك إذن وصول مشرف متميّز إلى حساب Google Workspace ذي الصلة، تواصَل مع مشرف متميّز لهذا الحساب وأرسِل إليه معرّف العميل لحساب الخدمة وقائمة نطاقات OAuth ليتمكّن من إكمال الخطوات التالية في "وحدة تحكّم المشرف".

1. في وحدة تحكّم المشرف في Google، انتقِل إلى "القائمة" menu > الأمان > التحكّم في البيانات والوصول > عناصر تحكّم واجهة برمجة التطبيقات.

   الانتقال إلى "عناصر تحكّم واجهة برمجة التطبيقات"

2. انقر على إدارة التفويض على مستوى النطاق.
3. انقر على إضافة نطاق جديد.
4. في حقل "معرّف العميل"، الصِق معرّف العميل الذي نسخته سابقًا.
5. في حقل "نطاقات OAuth"، أدخِل قائمة بالنطاقات التي يتطلبها تطبيقك، مفصولة بفواصل. هذه هي مجموعة النطاقات نفسها التي حدّدتها عند إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
6. انقر على تفويض.

الخطوة التالية

أنت الآن جاهز للتطوير على Google Workspace. راجِع قائمة منتجات المطوّرين في Google Workspace و كيفية العثور على المساعدة.