إعداد Google Cloud وOAuth

يتم توفير إذن الوصول إلى Google Health API من خلال Google Cloud. لتفعيل واجهة برمجة التطبيقات وتفويض حساب Google، عليك إنشاء مشروع على Google Cloud.

سواء كنت مطوّرًا حاليًا يستخدم Fitbit API أو كنت جديدًا على Google Health API، عليك إكمال هذه الخطوة لإجراء طلبات إلى واجهة برمجة التطبيقات.

إنشاء مشروع وعميل OAuth

استخدِم الزر تفعيل واجهة برمجة التطبيقات والحصول على معرّف عميل OAuth 2.0 لتفعيل Google Health API والحصول على معرّف عميل OAuth 2.0:

1. إذا كان لديك مشروع حالي على Google Cloud تريد استخدامه مع Google Health API، تأكَّد أولاً من تسجيل الدخول إلى حساب المشرف الخاص بهذا المشروع. بعد ذلك، اختَر المشروع الحالي من قائمة المشاريع المتاحة بعد النقر على الزر. بخلاف ذلك، أنشئ مشروعًا جديدًا.
2. اختَر خادم الويب عندما يُطلب منك تحديد "مكان الاتصال".
3. أدخِل https://www.google.com كقيمة معرّفات الموارد المنتظمة لإعادة التوجيه المصرّح بها. يجب توفير معرّف موارد منتظم (URI) لإعادة التوجيه للحصول على رمز تفويض باستخدام بروتوكول OAuth 2.0.
4. بعد اكتمال عملية الإعداد، انسخ قيم معرّف العميل وسر العميل في OAuth 2.0، ونزِّل ملف JSON الخاص ببيانات الاعتماد على جهازك المحلي.

تفعيل واجهة برمجة التطبيقات والحصول على معرّف عميل OAuth 2.0

إذا أردت إعداد مشروعك على Google Cloud يدويًا أو التحقّق من الإعداد واسترداد بيانات الاعتماد مرة أخرى، اتّبِع الخطوات التالية:

1. فعِّل Google Health API في صفحة تفعيل واجهة برمجة التطبيقات.
2. احصل على معرّف عميل OAuth 2.0 في صفحة بيانات الاعتماد.

لمزيد من المعلومات حول إعداد OAuth 2.0 باستخدام وحدة تحكّم Google، يُرجى الاطّلاع على مقالة استخدام بروتوكول OAuth 2.0 للوصول إلى Google APIs.

إضافة مستخدمين اختباريين

تكون برامج OAuth التي تم إنشاؤها حديثًا في حالة غير مؤكَّدة مع حد أقصى يبلغ 100 مستخدم لأغراض الاختبار والإنتاج. لتفعيل التفويض خلال هذه الفترة، عليك إضافة عنوان البريد الإلكتروني لكل مستخدم يدويًا إلى قائمة "المستخدمون التجريبيون" في إعدادات مشروعك.

عدِّل قائمة المستخدمين التجريبيين في صفحة شريحة الجمهور باتّباع الخطوات التالية:

1. في هذه الصفحة، من المفترض أن تظهر "حالة النشر" مضبوطة على اختبار، و "نوع المستخدم" مضبوط على خارجي.
2. ضمن القسم "المستخدمون التجريبيون"، انقر على + إضافة مستخدمين. أدخِل عنوان البريد الإلكتروني لأي مستخدمين اختباريين يجب السماح لهم بمنح تطبيقك إذن الوصول إلى بياناتهم الصحية.
3. انقر على حفظ.

يتطلّب توفير الدعم لأكثر من 100 مستخدم من خلال Google Health API إكمال مراجعة أمان تابعة لجهة خارجية. يمكنك العثور على معلومات إضافية في مركز المساعدة بشأن التحقّق من تطبيقات OAuth.

إضافة نطاقات

يجب تحديد النطاقات التي يُسمح لبرنامجك بالوصول إليها في صفحة الوصول إلى البيانات:

1. في هذه الصفحة، انقر على إضافة نطاقات أو إزالتها.
2. في عمود API، ابحث عن "Google Health API". اختَر النطاقات التي يحتاجها تطبيقك.
3. بعد اختيار جميع النطاقات التي تحتاج إليها، انقر على تعديل للرجوع إلى صفحة "الوصول إلى البيانات".
4. انقر على حفظ.

لقد انتهيت من إعداد معرّف العميل، ويجب أن تتمكّن الآن من إجراء طلبات إلى Google Health API.

مكتبات برامج OAuth2

يمكنك الاطّلاع على قائمة بمكتبات عميل OAuth2 المتاحة والمستخدَمة للتكامل مع الأُطر الشائعة في مقالة استخدام بروتوكول OAuth 2.0 للدخول إلى Google APIs.

رموز إعادة التحميل

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

لتبديل رمز مميز لإعادة التحميل برمز دخول مميز، أرسِل طلب HTTPS POST إلى نقطة نهاية رمز Google OAuth 2.0 المميز. يعرض المقتطف التالي مثالاً على طلب واستجابة:

طلب

curl -L -X POST 'https://oauth2.googleapis.com/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'client_id=client-id&client_secret=client-secret&refresh_token=refresh-token&grant_type=refresh_token'

الردّ

{
  "access_token": "access-token",
  "expires_in": 3599,
  "scope": "scope-list",
  "token_type": "Bearer",
  "refresh_token": "refresh-token",
  "refresh_token_expires_in": 112154
}

سلوك الرمز المميز أثناء الاختبار

يُرجى العلم بكيفية عمل رموز التحديث استنادًا إلى حالة نشر مشروعك على Google Cloud:

• وضع الاختبار: إذا تم ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth على حالة نشر "اختبار"، ستكون الرموز المميزة لإعادة التحميل الصادرة مستندة إلى الوقت وتنتهي صلاحيتها بعد 7 أيام. خلال هذه الفترة، ستتلقّى رمزًا مميزًا واحدًا لإعادة التحميل يظل صالحًا وقابلاً للاستخدام للحصول على رموز مميزة جديدة للوصول إلى أن يبلغ تاريخ انتهاء صلاحيته.
• وضع النشر: بعد نقل تطبيقك إلى الحالة "في مرحلة الإنتاج"، لا تنتهي صلاحية رموز التحديث عادةً إلا إذا تم إبطالها أو إذا لم يتم استخدامها لفترة طويلة (ستة أشهر عادةً).

لضمان توفير تجربة سلسة للمستخدمين، احرص على نشر تطبيقك قبل نقله إلى بيئة إنتاج لتجنُّب انتهاء صلاحية الرموز المميزة بعد 7 أيام.