必須のリクエスト パラメータ

Maps Datasets API にリクエストを送信するには、次のものを含める必要があります。

  • リクエストの X-Goog-User-Project ヘッダーにある Google Cloud プロジェクトの数または ID。この値によって、課金と使用量の割り当て計算に使用されるプロジェクトが決まります。

  • リクエストの Authorization ヘッダーにある OAuth トークン。Maps Datasets API で OAuth を使用する方法については、OAuth を使用するをご覧ください。

  • リクエスト URL 内の Google Cloud プロジェクト番号または ID。この値には、データセットを含むプロジェクトを指定します。通常、このプロジェクトは X-Goog-User-Project ヘッダーで指定されたプロジェクトと同じですが、同じである必要はありません。

  • リクエスト URL 内のデータセット ID。特定のデータセットに対してアクションを実行するたびに、リクエスト URL の一部としてデータセットの ID を渡します。

たとえば、データセットを削除するには:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

プロジェクト番号を取得する

Google Cloud プロジェクトの PROJECT_NUMBER_OR_ID を取得するには:

  1. Cloud コンソールで、プロジェクトの [概要ページ] に移動します。

  2. プロンプトが表示されたら、プロジェクトを選択します。

  3. プロジェクト番号とプロジェクト ID は、概要画面の [プロジェクト情報] 領域に表示されます。

OAuth トークンを取得する

認証を行うには、API リクエストの Authorization ヘッダーに OAuth トークンを含める必要があります。詳細については、OAuth を使用するをご覧ください。

たとえば、次の gcloud コマンドを使用してトークンを生成します。

gcloud auth application-default print-access-token

上記の例に示すように、cURL コマンドの Authorization ヘッダーに gcloud コマンドを直接含めて、リクエストごとに新しいトークンを生成できます。

または、トークンを含む環境変数を設定し、その環境変数をリクエストの一部として渡すこともできます。

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID