با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Google APIs Explorer ابزاری است که در اکثر صفحات مستندسازی روش REST API موجود است که به شما امکان میدهد روشهای Google API را بدون نوشتن کد امتحان کنید. APIs Explorer روی دادههای واقعی عمل میکند، بنابراین هنگام استفاده از روشهایی که دادهها را ایجاد، اصلاح یا حذف میکنند، احتیاط کنید.
از دایرکتوری استفاده کنید
برای فهرستی از APIهای Google که میتوانید کاوش کنید، فهرست راهنمای Google APIs Explorer را مرور کنید. این لیست حاوی پیوندهایی به اسناد مرجع API برای APIهای پشتیبانی شده است. برای بررسی API مراحل زیر را دنبال کنید:
در کادر جستجو در بالا، نام API مورد نظر برای کاوش را وارد کنید.
روی نام API کلیک کنید. با این کار اسناد مرجع API باز می شود.
در سمت چپ، روی روشی که میخواهید در پیمایش استفاده کنید کلیک کنید.
در سمت راست، پانل با عنوان "این روش را امتحان کنید" را پیدا کنید. برای جزئیات بیشتر در مورد نحوه استفاده از پانل جانبی APIs Explorer و نحوه گسترش آن در پانل APIs Explorer تمام صفحه، به زیر مراجعه کنید.
از پانل کناری استفاده کنید
شکل 1 : پانل کناری APIs Explorer برای Google Books API.
به طور پیشفرض، APIs Explorer در سمت راست صفحه در اسناد مرجع API برای روشهای پشتیبانیشده ظاهر میشود.
میتوانید بخشهای زیر را در پانل کناری APIs Explorer سفارشی کنید و با آنها تعامل داشته باشید:
در صورت نیاز به روش، پارامترها را درخواست کنید.
در صورت نیاز به روش، بدن را درخواست کنید.
اعتبارنامه ، برای آزمایش روش با انواع مختلف اعتبار و دامنه.
دکمه Execute ، برای اجرای روش با استفاده از پارامترها و تنظیماتی که شما مشخص کرده اید.
نتیجه ، تنها پس از اجرای روش نمایش داده می شود.
از پنل تمام صفحه استفاده کنید
شکل 2 : پانل تمام صفحه APIs Explorer برای Google Books API.
در پانل کناری APIs Explorer کوچک شده، میتوانید روی تمام صفحه fullscreen صفحه کلیک کنید تا APIs Explorer گسترش یابد. پانل تمام صفحه یک صفحه اضافی حاوی نمونه کد، پاسخ application/json و پاسخ های HTTP خام را نمایش می دهد.
احراز هویت
APIs Explorer از اعتبارنامه های خود برای ارسال درخواست استفاده می کند. نمیتوانید از اعتبارنامههای سفارشی با APIs Explorer استفاده کنید.
فرمت های داده
APIs Explorer فقط از JSON برای پاسخها و بارهای درخواستی پشتیبانی میکند. حتی اگر API شما از فرمت های داده دیگر پشتیبانی می کند، این فرمت ها در APIs Explorer کار نمی کنند.
تاریخ آخرین بهروزرسانی 2022-11-01 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2022-11-01 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle APIs Explorer allows you to experiment with Google API methods directly without coding, using real data.\u003c/p\u003e\n"],["\u003cp\u003eYou can find the desired API through the Google APIs Explorer Directory and navigate to its documentation to access the Explorer.\u003c/p\u003e\n"],["\u003cp\u003eThe Explorer provides an interface to input parameters, request bodies, and credentials for executing the API method and viewing results.\u003c/p\u003e\n"],["\u003cp\u003eWhile the Explorer uses its own credentials, it offers both side-panel and full-screen views with functionalities like code samples and response formats in JSON.\u003c/p\u003e\n"],["\u003cp\u003eRemember to exercise caution when using methods that modify data, as the Explorer operates on live data.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nThe Google APIs Explorer is a tool available on most REST API method\ndocumentation pages that lets you try Google API methods without writing code.\nThe APIs Explorer acts on real data, so use caution when trying methods that\ncreate, modify, or delete data.\n\nUse the directory\n-----------------\n\nFor a list of Google APIs you can explore, browse the\n[Google APIs Explorer Directory](/apis-explorer). This list contains links to\nthe API reference documentation for supported APIs. Follow the steps below to\nexplore the API:\n\n1. Open the [Google APIs Explorer Directory](/apis-explorer).\n2. In the search box at the top, enter the name of the API you want to explore.\n3. Click the name of the API. This opens the API reference documentation.\n4. At the left, click the method you want to use in the navigation.\n5. At the right, find the panel labeled \"Try this method.\" See below for details\n about how to use the APIs Explorer side panel and how to expand it into the\n full-screen APIs Explorer panel.\n\n | **Note:** If you don't see the APIs Explorer side panel, the method might not be compatible with APIs Explorer.\n\nUse the side panel\n------------------\n\n**Figure 1**: APIs Explorer side panel for the Google Books API.\n\nBy default, the APIs Explorer appears on the right-hand side of the screen in\nAPI reference documentation for supported methods.\n\nYou can customize and interact with the following sections in the APIs Explorer\nside panel:\n\n- **Request parameters**, if required by the method.\n- **Request body**, if required by the method.\n- **Credentials**, to test the method with various credential types and scopes.\n- **Execute** button, to run the method using the parameters and settings you've specified.\n- **Result**, displayed only after executing the method.\n\nUse the full-screen panel\n-------------------------\n\n**Figure 2**: APIs Explorer full-screen panel for the Google Books API.\n\nIn the collapsed APIs Explorer side panel, you can click Full screen\nfullscreen to expand the APIs Explorer. The\nfull-screen panel displays an extra pane containing code samples,\n`application/json` responses, and Raw HTTP responses.\n\nAuthentication\n--------------\n\nThe APIs Explorer uses its own credentials to make a request. You can't use\ncustom credentials with the APIs Explorer.\n\nData formats\n------------\n\nThe APIs Explorer only supports JSON for responses and request payloads. Even if\nyour API supports other data formats, these formats don't work in the\nAPIs Explorer.\n\nNext steps\n----------\n\n- Learn how to [display the APIs Explorer and execute a method](/explorer-help/execute-method).\n- Learn how to [test a method using different credentials and scopes](/explorer-help/authorization-and-authentication).\n- Learn how to [execute APIs Explorer sample code locally](/explorer-help/code-samples)."]]