با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
در اکثر صفحات اسناد، APIs Explorer فشرده در سمت راست صفحه قابل مشاهده است. اگر APIs Explorer قابل مشاهده نیست، روی Try it کلیک کنید! برای نمایش نسخه فشرده APIs Explorer.
اگر آن را امتحان کنید! در سمت راست صفحه مستندات مرجع ظاهر نمی شود، این روش توسط APIs Explorer پشتیبانی نمی شود. برای مثال، APIs Explorer با APIهایی که به حساب‌های سرویس نیاز دارند، سازگار نیست، بنابراین در صفحات اسناد آن APIها ظاهر نمی‌شود.
نمایش نسخه توسعه یافته APIs Explorer
نسخه توسعه‌یافته APIs Explorer شامل cURL، HTTP و احتمالاً نمونه‌های کد دیگر است. برای نمایش نسخه توسعه یافته APIs Explorer، روی تمام صفحه fullscreen کلیک کنید.
یک روش را اجرا کنید
APIs Explorer به شما امکان می دهد پارامترهای مورد نیاز، پارامترهای اختیاری، و در صورت وجود، یک بدنه درخواست برای روش های API را وارد کنید. برای بسیاری از روش‌های REST، مانند روش‌های فهرست، فقط باید یک یا دو فیلد را پر کنید تا بتوانید متد را اجرا کنید. برای مثال، روش books.volumes.list Books API فقط به یک پارامتر query ( q ) برای فهرست کردن کتاب‌ها نیاز دارد. برای امتحان روش books.volumes.list :
اگر APIs Explorer نمایش داده نشد، روی Try it کلیک کنید!
در قسمت q ، Hunger Games (بدون هیچ نقل قول یا کاراکتر خاصی) را تایپ کنید.
به پایین بروید و روی Execute کلیک کنید.
(اختیاری) یک صفحه ورود به سیستم Google از شما می خواهد که یک حساب Google انتخاب کنید.
(اختیاری) یک گفتگوی مجوز Google از شما می‌پرسد که آیا «مدیریت کتاب‌هایتان» اشکالی ندارد. روی Allow کلیک کنید. نتایج زیر دکمه Execute ظاهر می شوند.
اگر APIs Explorer نتیجه 200 را نشان دهد، روش موفق بوده است.
عیب یابی مشکلات APIs Explorer
شما یک خطای 401 یا 403 دریافت کردید
اگر هنگام اجرای یک روش با استفاده از APIs Explorer خطای 401 یا 403 دریافت می کنید، احتمالاً به دلیل مشکل یکی از موارد زیر است:
شما از نوع مجوز اشتباه استفاده می کنید (کلید API به جای OAuth 2.0). نوع مجوز را تغییر دهید.
شما از OAuth 2.0 استفاده می کنید، اما با دامنه بسیار باریک. سعی کنید از دامنه وسیع تری استفاده کنید.
گفتگوی مجوز ظاهر نمی شود
APIs Explorer از یک پنجره بازشو برای دسترسی به داده های خصوصی شما استفاده می کند. اگر مرورگر شما پنجره‌های بازشو را مسدود کند، این پنجره ظاهر نمی‌شود و نمی‌توانید اجازه دسترسی بدهید.
اگر در کادر گفتگوی مجوز روی Allow کلیک کردید و هیچ اتفاقی نیفتاد، تنظیمات بازشو مرورگر خود را برای فعال کردن پنجره‌های بازشو تغییر دهید.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe APIs Explorer allows you to test API methods directly in the documentation by providing parameters and executing requests.\u003c/p\u003e\n"],["\u003cp\u003eTo use the APIs Explorer with methods requiring authorization, you need to generate and use your own credentials.\u003c/p\u003e\n"],["\u003cp\u003eThe expanded APIs Explorer provides code samples in various formats like cURL and HTTP for easier integration.\u003c/p\u003e\n"],["\u003cp\u003eIf you encounter a 401 or 403 error, verify the authorization type and scope, as they are the most common causes.\u003c/p\u003e\n"],["\u003cp\u003eThe APIs Explorer uses popups for authorization, so ensure your browser settings allow them to function correctly.\u003c/p\u003e\n"]]],[],null,["# Display the APIs Explorer and execute a method\n\nOn most documentation pages, a condensed APIs Explorer is visible on the\nright-hand side of the screen. If the APIs Explorer isn't visible, click\n**Try it!** to display the condensed version of the APIs Explorer.\n\nIf **Try it!** doesn't appear on the right-hand side of a reference\ndocumentation page, the method isn't supported by the APIs Explorer. For\nexample, the APIs Explorer isn't compatible with APIs that require service\naccounts, so it doesn't appear on documentation pages for those APIs.\n\nDisplay the expanded version of the APIs Explorer\n-------------------------------------------------\n\nThe expanded version of the APIs Explorer contains cURL, HTTP, and possibly\nother code samples. To display the expanded version of the APIs Explorer,\nclick Full screen fullscreen.\n| **Note:** To run the code samples, you must generate and use your own authorization credentials. For an explanation of how to create a project and generate credentials, refer to your specific Google API's documentation.\n\nExecute a method\n----------------\n\nThe APIs Explorer lets you enter required parameters, optional parameters,\nand, if applicable, a request body for API methods. For many REST methods,\nsuch as list methods, you only need to fill one or two fields before you can\nexecute the method. For example, the Books API's\n[`books.volumes.list`](/books/docs/v1/reference/volumes/list)\nmethod only requires a query parameter (`q`) to list books. To try the\n[`books.volumes.list`](/books/docs/v1/reference/volumes/list)\nmethod:\n\n1. Navigate to [`books.volumes.list`](/books/docs/v1/reference/volumes/list).\n2. If the APIs Explorer isn't displayed, click **Try it!**\n3. In the **`q`** field, type *Hunger Games* (without any quotes or special characters).\n4. Scroll down and click **Execute**.\n5. (optional) A Google sign-in screen asks you to select a Google account.\n6. (optional) A Google authorization dialog asks you if it's okay to \"Manage your books.\" Click *Allow*. The results appear below the Execute button.\n\nIf the APIs Explorer shows a result of 200, then the method was successful.\n| **Note:** After you allow the authorization screen to make an authorized request, the APIs Explorer is authorized to make other requests until the credentials expire. Therefore, you don't see the authorization screen for every subsequent method call. For further information on credentials, see [Test with different credential types and scopes](/explorer-help/authorization-and-authentication).\n\nTroubleshoot APIs Explorer issues\n---------------------------------\n\n### You received a 401 or 403 error\n\nIf you're getting a 401 or 403 error when executing a method using the APIs\nExplorer, it is likely due to a problem with one of the following:\n\n- You're using the wrong authorization type (API key instead of OAuth 2.0). Try switching the authorization type.\n- You're using OAuth 2.0, but with too narrow a scope. Try using a broader scope.\n\n### Authorization dialog doesn't appear\n\nThe APIs Explorer uses a popup to grant access to your private data. If your\nbrowser blocks popups, this popup won't appear and you won't be able to grant\naccess.\n\nIf you click **Allow** in the authorization dialog and nothing happens, try\nchanging your browser's popup settings to enable popups."]]
