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