بخش اعتبار APIs Explorer به شما امکان می دهد با اعتبارنامه ها و دامنه های مختلف آزمایش کنید. این ویژگی در حصول اطمینان از استفاده از حداقل اعتبار و محدوده مورد نیاز برای فراخوانی نقطه پایانی API مفید است.
با مدارک مختلف تست کنید
به طور پیش فرض، هر دو نوع اعتبار OAuth 2 و API Key بررسی می شوند. اگر می‌خواهید فقط با یک اعتبار آزمایش کنید، نوع اعتبار مورد استفاده را بررسی کنید (و تیک نوع اعتبار دیگر را بردارید). قوانین کلی برای انتخاب اعتبار برای آزمایش به شرح زیر است:
اگر از روشی برای دسترسی به داده های عمومی استفاده می کنید، مانند داده های Google Maps، می توانید از یک کلید API به عنوان اعتبار خود استفاده کنید. کلید API را علامت بزنید و علامت Google OAuth 2.0 را بردارید.
اگر از روشی برای دسترسی به داده های خصوصی استفاده می کنید، مانند داده های Google Drive کاربر، باید از اعتبارنامه OAuth 2 استفاده کنید. علامت کلید API را بردارید و Google OAuth 2.0 را علامت بزنید.
اگر نتیجه 200 دریافت کردید، اعتبار برای دسترسی به داده ها کافی است. اگر نتیجه 401 را دریافت کردید، باید از اعتبار OAuth 2 برای دسترسی به داده ها استفاده کنید.
تست با دامنه های مختلف
محدوده یک رشته است، مانند https://www.googleapis.com/auth/drive.metadata.readonly ، که سطح دسترسی به منابع مورد نیاز برنامه شما را تعریف می کند، مانند سطح دسترسی به داده های متعلق به کاربران. . در حالت ایده‌آل، می‌خواهید برنامه شما از محدوده‌هایی با محدودترین سطح دسترسی به داده‌های کاربر استفاده کند. روش‌های مختلف ممکن است به حوزه‌های متفاوتی نیاز داشته باشند. به عنوان مثال، یک روش در یک API ممکن است حداقل به یک محدوده فقط خواندنی نیاز داشته باشد، در حالی که روش‌های دیگر ممکن است به محدوده خواندن و نوشتن نیاز داشته باشند.
به طور پیش‌فرض، همه حوزه‌های Google OAuth 2.0 برای یک API در APIs Explorer فعال هستند. برای آزمایش با یک محدوده خاص:
- در بخش اعتبارنامه‌های Google OAuth 2.0، روی show scopes کلیک کنید.
- محدوده مورد استفاده در هنگام فراخوانی روش را بررسی کنید.
- روی Execute کلیک کنید تا API فقط با استفاده از محدوده انتخاب شده اجرا شود. APIs Explorer یک صفحه مجوز را نشان می‌دهد که از شما می‌خواهد برای استفاده از محدوده دسترسی بدهید.
- روی Allow کلیک کنید. نتایج زیر دکمه Execute ظاهر می شوند.
اگر APIs Explorer نتیجه 200 را تحت یک "application/json" نشان دهد، آنگاه محدوده برای فراخوانی روش کافی است. اگر APIs Explorer نتیجه 403 را نشان دهد، شما محدوده کافی را برای فراخوانی روش انتخاب کرده اید. دامنه وسیع تری را امتحان کنید.
برای اطلاعات بیشتر در مورد انتخاب محدوده، به بخش احراز هویت و مجوز اسناد مربوط به Google API خاص خود مراجعه کنید.
لغو دسترسی مجاز برای آزمایش با دامنه‌های جدید
پس از اینکه از صفحه مجوز Google برای تأیید مجوز استفاده کردید، APIs Explorer تا زمانی که اعتبارنامه ها منقضی نشده باشند، مجاز به درخواست های تأیید شده باقی می ماند. برداشتن علامت scopes، اعتبارنامه‌ها و محدوده‌های تایید شده قبلی را بازنشانی نمی‌کند. اگر می‌خواهید با پیکربندی دامنه جدید آزمایش کنید، باید اعتبارنامه‌های تأیید شده قبلی خود را لغو کنید.
برای لغو اعتبار استفاده شده توسط APIs Explorer:
- به Apps با دسترسی به حساب خود بروید .
- در بخش برنامه‌های شخص ثالث با دسترسی به حساب ، روی Google APIs Explorer کلیک کنید.
- روی حذف دسترسی کلیک کنید.
- (اختیاری) صفحه مستندات را برای بازنشانی APIs Explorer بارگیری مجدد کنید.