يتيح لك قسم بيانات الاعتماد في واجهة APIs Explorer إجراء اختبارات باستخدام بيانات اعتماد ونطاقات مختلفة. تساعدك هذه الميزة في التأكّد من أنّك تستخدم الحد الأدنى من بيانات الاعتماد والنطاق المطلوبَين لاستدعاء نقطة نهاية لواجهة برمجة التطبيقات.
الاختبار باستخدام بيانات اعتماد مختلفة
يتم تلقائيًا وضع علامة في المربّع بجانب كلّ من نوعَي بيانات الاعتماد OAuth 2 ومفتاح واجهة برمجة التطبيقات. إذا كنت تريد إجراء الاختبار باستخدام بيانات اعتماد واحدة فقط، ضَع علامة في المربع بجانب نوع بيانات الاعتماد المطلوب استخدامه (وأزِل العلامة من المربع بجانب نوع بيانات الاعتماد الآخر). في ما يلي القواعد العامة لاختيار بيانات اعتماد لاختبارها:
إذا كنت تستخدم طريقة للوصول إلى البيانات العامة، مثل بيانات "خرائط Google"، يمكنك استخدام مفتاح واجهة برمجة التطبيقات كبيانات اعتماد. ضَع علامة في المربّع بجانب مفتاح واجهة برمجة التطبيقات وأزِل العلامة من المربّع بجانب Google OAuth 2.0.
إذا كنت تستخدم طريقة للوصول إلى بيانات خاصة، مثل بيانات Google Drive الخاصة بالمستخدم، عليك استخدام بيانات اعتماد OAuth 2. أزِل العلامة من مربّع الاختيار مفتاح واجهة برمجة التطبيقات وضع العلامة في مربّع الاختيار Google OAuth 2.0.
إذا تلقّيت النتيجة 200، يعني ذلك أنّ بيانات الاعتماد كافية للوصول إلى البيانات. إذا تلقّيت الرمز 401، عليك استخدام بيانات اعتماد OAuth 2 للوصول إلى البيانات.
الاختبار باستخدام نطاقات مختلفة
النطاق هو سلسلة، مثل
https://www.googleapis.com/auth/drive.metadata.readonly، تحدّد مستوى
الوصول إلى الموارد التي يتطلّبها تطبيقك، مثل مستوى الوصول إلى البيانات
الخاصة بالمستخدمين. من المفترض أن يستخدم تطبيقك نطاقات بأضيق مستوى وصول إلى بيانات المستخدم. قد تتطلّب الطرق المختلفة نطاقات مختلفة. على سبيل المثال، قد تتطلّب إحدى الطرق في واجهة برمجة التطبيقات نطاقًا للقراءة فقط، بينما قد تتطلّب طرق أخرى نطاقًا للقراءة والكتابة.
بشكل تلقائي، يتم تفعيل جميع نطاقات Google OAuth 2.0 لواجهة برمجة التطبيقات في "مستكشف واجهات برمجة التطبيقات". لإجراء الاختبار بنطاق معيّن:
- في قسم "بيانات اعتماد Google OAuth 2.0"، انقر على عرض النطاقات.
- تحقَّق من النطاق الذي سيتم استخدامه عند استدعاء الطريقة.
- انقر على تنفيذ لتنفيذ واجهة برمجة التطبيقات باستخدام النطاق المحدّد فقط. يعرض مستكشف واجهات برمجة التطبيقات شاشة تفويض تطلب منك منح إذن الوصول إلى النطاق.
- انقر على سماح. تظهر النتائج أسفل الزر "تنفيذ".
إذا عرضت أداة APIs Explorer النتيجة 200 ضمن "application/json"، يعني ذلك أنّ النطاق كافٍ لاستدعاء الطريقة. إذا عرضت أداة APIs Explorer النتيجة 403، يعني ذلك أنّك اخترت نطاقًا غير كافٍ لاستدعاء الطريقة. جرِّب نطاقًا أوسع.
للحصول على معلومات إضافية حول اختيار النطاق، يُرجى الرجوع إلى قسم المصادقة والتفويض في المستندات الخاصة بواجهة Google API التي تستخدمها.
إبطال إذن الوصول المُصرّح به لإجراء اختبار بنطاقات جديدة
بعد استخدام شاشة التفويض من Google للموافقة على التفويض، يظلّ بإمكان "مستكشف واجهات برمجة التطبيقات" إرسال طلبات مصادَق عليها ما دامت بيانات الاعتماد غير منتهية الصلاحية. لا يؤدي إلغاء تحديد النطاقات إلى إعادة ضبط بيانات الاعتماد والنطاقات التي تمت الموافقة عليها سابقًا. إذا أردت إجراء اختبار باستخدام إعدادات نطاق جديدة، عليك إبطال بيانات الاعتماد التي تمت الموافقة عليها سابقًا.
لإبطال بيانات الاعتماد المستخدَمة في "مستكشف واجهات برمجة التطبيقات"، اتّبِع الخطوات التالية:
- انتقِل إلى التطبيقات التي يمكنها الوصول إلى حسابك.
- ضمن التطبيقات التابعة لجهات خارجية التي يمكنها الوصول إلى الحساب، انقر على مستكشف واجهات برمجة التطبيقات الخاصة بـ Google.
- انقر على إزالة إذن الوصول.
- (اختياري) أعِد تحميل صفحة المستندات لإعادة ضبط "مستكشف واجهات برمجة التطبيقات".