في معظم صفحات المستندات، يظهر مستكشف واجهات برمجة التطبيقات بشكل مختصر على الجانب الأيسر من الشاشة. إذا لم يظهر "مستكشف واجهات برمجة التطبيقات"، انقر على تجربة لعرض النسخة المختصرة من "مستكشف واجهات برمجة التطبيقات".
إذا لم يظهر الزر تجربة على الجانب الأيسر من صفحة مستندات مرجعية، يعني ذلك أنّ الطريقة غير متوافقة مع واجهة برمجة التطبيقات Explorer. على سبيل المثال، لا يتوافق مستكشف واجهات برمجة التطبيقات مع واجهات برمجة التطبيقات التي تتطلّب حسابات خدمة، لذا لا يظهر في صفحات المستندات الخاصة بهذه الواجهات.
عرض الإصدار الموسّع من "مستكشف واجهات برمجة التطبيقات"
يحتوي الإصدار الموسّع من "مستكشف واجهات برمجة التطبيقات" على عيّنات من الرموز البرمجية بلغة cURL وHTTP وربما غيرها. لعرض النسخة الموسّعة من "مستكشف واجهات برمجة التطبيقات"، انقر على رمز "ملء الشاشة" .
تنفيذ طريقة
يتيح لك "مستكشف واجهات برمجة التطبيقات" إدخال المَعلمات المطلوبة والمَعلمات الاختيارية ونص الطلب الخاص بطُرق واجهة برمجة التطبيقات، إذا كان ذلك منطبقًا. بالنسبة إلى العديد من طرق REST، مثل طرق القائمة، ما عليك سوى ملء حقل واحد أو حقلين قبل أن تتمكّن من تنفيذ الطريقة. على سبيل المثال، لا تتطلّب طريقة
books.volumes.list
في Books API سوى مَعلمة طلب بحث (q) لإدراج الكتب. لتجربة طريقة
books.volumes.list، اتّبِع الخطوات التالية:
- انتقِل إلى
books.volumes.list. - إذا لم يظهر "مستكشف واجهات برمجة التطبيقات"، انقر على جرِّبها.
- في الحقل
q، اكتب ألعاب الجوع (بدون أي علامات اقتباس أو رموز خاصة). - انتقِل إلى أسفل الصفحة وانقر على تنفيذ.
- (اختياري) تطلب منك شاشة تسجيل الدخول إلى Google اختيار حساب Google.
- (اختياري) سيظهر لك مربّع حوار يطلب منك الحصول على إذن من Google للسماح له بـ "إدارة كتبك". انقر على سماح. تظهر النتائج أسفل الزر "تنفيذ".
إذا عرضت أداة APIs Explorer النتيجة 200، يعني ذلك أنّ الطريقة نجحت.
تحديد المشاكل في "مستكشف واجهات برمجة التطبيقات" وحلّها
تلقّيت الخطأ 401 أو 403
إذا ظهر لك الخطأ 401 أو 403 عند تنفيذ إحدى الطرق باستخدام "مستكشف واجهات برمجة التطبيقات"، من المحتمل أن يكون ذلك بسبب مشكلة في أحد ما يلي:
- استخدام نوع التفويض الخاطئ (مفتاح واجهة برمجة التطبيقات بدلاً من OAuth 2.0) جرِّب تغيير نوع التفويض.
- أنت تستخدم بروتوكول OAuth 2.0، ولكن بنطاق ضيق جدًا. جرِّب استخدام نطاق أوسع.
لا يظهر مربّع حوار التفويض
يستخدم "مستكشف واجهات برمجة التطبيقات" نافذة منبثقة لمنح إذن الوصول إلى بياناتك الخاصة. إذا كان متصفّحك يحظر النوافذ المنبثقة، لن تظهر هذه النافذة المنبثقة ولن تتمكّن من منح الإذن بالوصول.
إذا نقرت على السماح في مربّع حوار التفويض ولم يحدث أي شيء، حاوِل تغيير إعدادات النوافذ المنبثقة في المتصفّح لتفعيلها.