Air Quality API は、認証に OAuth 2.0 の使用をサポートしています。 Google は、ウェブサーバー向けの OAuth 2.0 の一般的なシナリオをサポートしています。
このドキュメントでは、HTTP トークンの Air Quality API 呼び出しに OAuth トークンを 開発環境にデプロイできます。Google Cloud コンソールで OAuth を使用する手順については、 production 環境については、以下をご覧ください。 Google での認証。
始める前に
Air Quality API の使用を開始するには、 請求先アカウントと Air Quality API が有効になっているプロジェクト複数のメディアマシンで プロジェクト オーナーと課金管理者(常にこれらのロールを持つ担当者を確保) チームで利用できることです詳しくは、Google Cloud Console でセットアップするをご覧ください。
OAuth について
デプロイに基づいてさまざまな方法で OAuth でアクセス トークンを作成、管理 できます。
たとえば、Google OAuth 2.0 システムは、 Google サービス間で通信を行えます。このシナリオではサービス アカウントが必要です。 個々のエンドユーザーではなくアプリケーションに属すアカウントです。お客様の アプリケーションがサービス アカウントに代わって Google API を呼び出すため、ユーザーが直接関与することはありません。 認証方法の詳細については、以下をご覧ください。 Google での認証。
また、Android または iOS のモバイルアプリの一部として Air Quality API を使用することもできます。 Air Quality API での OAuth の使用に関する一般的な情報(管理に関する情報など) 異なるデプロイ環境用のアクセス トークンについては、 OAuth 2.0 を使用した Google API へのアクセス
OAuth スコープについて
Air Quality API で OAuth を使用するには、OAuth トークンにスコープを割り当てる必要があります。
https://www.googleapis.com/auth/cloud-platform
例: ローカル開発環境で REST API 呼び出しを試す
OAuth トークンを使用して Air Quality API を試したいが、環境がない場合 トークンを生成するために、このセクションの手順に沿って呼び出しを行います。
この例では、Google Cloud で提供されている OAuth トークンを アプリケーションのデフォルト認証情報(ADC) クリックします。ADC を使用してクライアント ライブラリから Google API を呼び出す方法については、以下をご覧ください。 クライアント ライブラリを使用して認証する。
前提条件
ADC を使用して REST リクエストを行う前に、Google Cloud CLI を使用してください。 認証情報を ADC に提供します。
- まだプロジェクトを作成していない場合は、プロジェクトを作成し、 Google Cloud コンソールでセットアップする。
- gcloud CLI をインストールして初期化します。
ローカルマシンで次の
gcloud
コマンドを実行して、 認証情報ファイル:gcloud auth application-default login
- ログイン画面が表示されます。ログインすると、認証情報が ADC で使用されるローカル認証情報ファイル。
詳細については、次をご覧ください: ローカル開発環境 セクション( アプリケーションのデフォルト認証情報に認証情報を提供する ご覧ください
REST リクエストを行う
この例では、2 つのリクエスト ヘッダーを渡します。
次のコマンドを使用して、
Authorization
ヘッダーで OAuth トークンを渡します コマンドを使用してトークンを生成します。gcloud auth application-default print-access-token
返されるトークンのスコープは
https://www.googleapis.com/auth/cloud-platform.
- 課金が有効になっている Google Cloud プロジェクトの ID または名前を
X-Goog-User-Project
ヘッダー。詳しくは、 Cloud コンソールでセットアップします。
次の例では、OAuth トークンを使用して Air Quality API を呼び出します。
curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" -d '{ "location": { "latitude": 32.62782385865436, "longitude": 35.02197334774893 } }' \ "https://airquality.googleapis.com/v1/currentConditions:lookup"
トラブルシューティング
この API でサポートされていないエンドユーザー認証情報に関するエラー メッセージがリクエストから返された場合は、 ユーザー認証情報が機能しないをご覧ください。