На большинстве страниц документации сокращённый обозреватель API отображается в правой части экрана. Если обозреватель API не отображается, нажмите «Попробовать!» , чтобы открыть сокращённую версию обозревателя API.
Если кнопка «Попробуйте!» не отображается в правой части страницы справочной документации, метод не поддерживается обозревателем API. Например, обозреватель API несовместим с API, требующими учётных записей служб, поэтому он не отображается на страницах документации для этих API.
Отобразить расширенную версию обозревателя API
Расширенная версия обозревателя API содержит примеры кода cURL, HTTP и, возможно, другие. Чтобы открыть расширенную версию обозревателя API, нажмите «Полный экран .
Выполнить метод
Обозреватель API позволяет вводить обязательные и необязательные параметры, а также, если применимо, тело запроса для методов API. Для многих методов REST, таких как методы списков, достаточно заполнить всего одно или два поля, прежде чем метод будет выполнен. Например, метод books.volumes.list API Books требует только параметра запроса ( q ) для вывода списка книг. Чтобы попробовать метод books.volumes.list :
- Перейдите к
books.volumes.list. - Если API Explorer не отображается, нажмите « Попробовать!»
- В поле
qвведите «Голодные игры» (без кавычек и специальных символов). - Прокрутите вниз и нажмите Выполнить .
- (необязательно) На экране входа в Google вам будет предложено выбрать учетную запись Google.
- (необязательно) В диалоговом окне авторизации Google вам будет предложено разрешить «Управление вашими книгами». Нажмите «Разрешить ». Результаты появятся под кнопкой «Выполнить».
Если API Explorer показывает результат 200, то метод был выполнен успешно.
Устранение неполадок в API Explorer
Вы получили ошибку 401 или 403
Если при выполнении метода с использованием API Explorer вы получаете ошибку 401 или 403, это, скорее всего, связано с одной из следующих проблем:
- Вы используете неправильный тип авторизации (ключ API вместо OAuth 2.0). Попробуйте сменить тип авторизации.
- Вы используете OAuth 2.0, но область действия слишком узкая. Попробуйте расширить область действия.
Диалоговое окно авторизации не появляется
API Explorer использует всплывающее окно для предоставления доступа к вашим личным данным. Если ваш браузер блокирует всплывающие окна, оно не появится, и вы не сможете предоставить доступ.
Если вы нажали «Разрешить» в диалоговом окне авторизации и ничего не произошло, попробуйте изменить настройки всплывающих окон браузера, чтобы разрешить их отображение.