Раздел учетных данных проводника API позволяет проводить тестирование с различными учетными данными и областями. Эта функция полезна для обеспечения использования минимальных необходимых учетных данных и области действия для вызова конечной точки API.
Протестируйте с разными учетными данными
По умолчанию проверяются как типы учетных данных OAuth 2, так и ключ API. Если вы хотите протестировать только с одними учетными данными, отметьте используемый тип учетных данных (и снимите флажок с другого типа учетных данных). Ниже приведены общие правила выбора учетных данных для тестирования:
Если вы используете метод доступа к общедоступным данным, таким как данные Google Maps, вы можете использовать ключ API в качестве своих учетных данных. Проверьте ключ API и снимите флажок Google OAuth 2.0 .
Если вы используете метод для доступа к личным данным, таким как данные пользователя на Google Диске, вы должны использовать учетные данные 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 включены в обозревателе API. Чтобы протестировать с определенной областью:
- В разделе «Учетные данные Google OAuth 2.0» нажмите «Показать области» .
- Проверьте область действия, которую следует использовать при вызове метода.
- Нажмите « Выполнить» , чтобы выполнить API, используя только выбранную область. В обозревателе API отображается экран авторизации с просьбой предоставить доступ для использования области.
- Щелкните Разрешить . Результаты отображаются под кнопкой «Выполнить».
Если обозреватель API показывает результат 200 в разделе «application/json», значит области достаточно для вызова метода. Если обозреватель API показывает результат 403, вы выбрали недостаточную область для вызова метода. Попробуйте более широкий охват.
Дополнительные сведения о выборе области см. в разделе документации по аутентификации и авторизации для вашего конкретного API Google.
Отменить авторизованный доступ для тестирования с новыми областями
После того как вы использовали экран авторизации Google для подтверждения авторизации, API Explorer остается авторизованным для выполнения запросов с проверкой подлинности, пока срок действия учетных данных не истек. Снятие флажка с областями не приводит к сбросу ранее утвержденных учетных данных и областей. Если вы хотите провести тестирование с новой конфигурацией области, вы должны отозвать свои ранее утвержденные учетные данные.
Чтобы отозвать учетные данные, используемые проводником API:
- Перейдите к приложениям с доступом к вашей учетной записи .
- В разделе «Сторонние приложения с доступом к аккаунту » нажмите «Обозреватель API Google » .
- Щелкните Удалить доступ .
- (необязательно) Перезагрузите страницу документации, чтобы сбросить обозреватель API.