このページでは、Service Management API と連携するように開発環境を設定する方法について説明します。Service Management API を使用する最も簡単な方法(Google Cloud Consoleウェブ UI を使用する以外の方法)で、ほとんどの運用上のユースケースで推奨される方法は、gcloud
コマンドライン インターフェースを使用することです。Service Management API に対してプログラミングする必要がある場合は、用意されているクライアント ライブラリの 1 つを使用することをおすすめします。API を試してみるには、以下の代替セットアップ手順に沿って curl
コマンドを使用します。これにより、完全なアプリケーション開発環境をセットアップしなくても API を試すことができます。
gcloud を使用したセットアップ
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Service Management API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Service Management API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
API を直接呼び出すためのセットアップ
このセクションでは、curl
コマンドを使用して Service Management API を試すためのローカル環境を設定するために必要な基本的な手順について説明します。これは、Service Management API に対してプログラミングする必要のあるデベロッパーを対象としています。
初期設定
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Enable the Service Management API:
gcloud services enable servicemanagement.googleapis.com
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/servicemanagement.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Enable the Service Management API:
gcloud services enable servicemanagement.googleapis.com
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/servicemanagement.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
curl によるテスト
Google REST API の呼び出しに便利なシェル エイリアスを定義します。
$ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
一般公開されているサービスの一覧表示を試行します。
$ gcurl https://servicemanagement.googleapis.com/v1/services
サービスのリストが表示されれば設定は成功です。
次のステップ
Cloud Endpoints を使用しておらず、マネージド サービスを作成する場合は、次の手順を行います。
- サービスの作成と削除の手順に沿ってマネージド サービスを作成します。これにより、トップレベルのマネージド サービス リソースが作成されます。
サービス構成のロールアウトの手順に沿ってサービス構成をロールアウトします。