يتيح لك قسم بيانات اعتماد مستكشف واجهات برمجة التطبيقات في اختبار البيانات باستخدام بيانات اعتماد ونطاقات مختلفة. وتفيد هذه الميزة في ضمان استخدامك لأدنى بيانات اعتماد ونطاق مطلوب لاستدعاء نقطة نهاية واجهة برمجة التطبيقات.
الاختبار باستخدام بيانات اعتماد مختلفة
يتم تلقائيًا التحقُّق من كلٍ من أنواع بيانات اعتماد 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، انقر على عرض النطاقات.
- راجِع النطاق المراد استخدامه عند استدعاء الطريقة.
- انقر على تنفيذ لتنفيذ واجهة برمجة التطبيقات باستخدام النطاق المحدد فقط. يعرض مستكشف واجهات برمجة التطبيقات شاشة تفويض تطلب منك منح حق الوصول لاستخدام النطاق.
- انقر على سماح. تظهر النتائج أسفل الزر "تنفيذ".
إذا كان مستكشف واجهات برمجة التطبيقات يعرض نتيجة 200 ضمن &"application/json"، فسيصبح النطاق كافيًا لاستدعاء الطريقة. إذا كان مستكشف واجهات برمجة التطبيقات يعرض نتيجة 403، يعني ذلك أنك اخترت نطاقًا غير كافٍ لاستدعاء الطريقة. جرِّب نطاقًا أوسع.
وللتعرّف على المزيد من المعلومات عن اختيار النطاق، يُرجى الرجوع إلى قسم المصادقة والمصادقة في واجهة برمجة تطبيقات Google المحدّدة.
إبطال الوصول المُصرّح به للاختبار باستخدام نطاقات جديدة
بعد استخدام شاشة تفويض Google للموافقة على التفويض، يظل مستكشف واجهات برمجة التطبيقات مصرحًا له بإجراء طلبات تمت المصادقة عليها طالما أن بيانات الاعتماد غير منتهية الصلاحية. ولا يؤدي إلغاء اختيار النطاقات إلى إعادة ضبط بيانات الاعتماد والنطاقات التي تمت الموافقة عليها سابقًا. وإذا كنت ترغب في الاختبار باستخدام ضبط نطاق جديد، يجب إبطال بيانات الاعتماد التي تمت الموافقة عليها في السابق.
لإبطال بيانات الاعتماد التي يستخدمها "مستكشف واجهات برمجة التطبيقات":
- انتقل إلى التطبيقات التي يمكنها الوصول إلى حسابك.
- ضمن تطبيقات الجهات الخارجية التي يمكنها الوصول إلى الحساب، انقر على مستكشف واجهات برمجة تطبيقات Google.
- انقر على إزالة إذن الوصول.
- (اختياري) أعد تحميل صفحة المستندات لإعادة ضبط مستكشف واجهات برمجة التطبيقات.