Service Management API を使ってみる

このページでは、Service Management API と連携するように開発環境を設定する方法について説明します。Service Management API を使用する最も簡単な方法（Google Cloud Consoleウェブ UI を使用する以外の方法）で、ほとんどの運用上のユースケースで推奨される方法は、gcloud コマンドライン インターフェースを使用することです。Service Management API に対してプログラミングする必要がある場合は、用意されているクライアント ライブラリの 1 つを使用することをおすすめします。API を試してみるには、以下の代替セットアップ手順に沿って curl コマンドを使用します。これにより、完全なアプリケーション開発環境をセットアップしなくても API を試すことができます。

注： Cloud Endpoints を使用してサービスを作成する場合は、関連する Endpoints クイックスタートの指示に沿って Cloud Endpoints 向けに Service Management API をセットアップして使用する方法をご確認ください。

gcloud を使用したセットアップ

1. 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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Enable the Service Management API.

   Enable the API

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. Enable the Service Management API.

   Enable the API

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

API を直接呼び出すためのセットアップ

このセクションでは、curl コマンドを使用して Service Management API を試すためのローカル環境を設定するために必要な基本的な手順について説明します。これは、Service Management API に対してプログラミングする必要のあるデベロッパーを対象としています。

初期設定

1. 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.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

5. Enable the Service Management API:

   gcloud services enable servicemanagement.googleapis.com

6. 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:[e-mail].

   • Replace ROLE with each individual role.
7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

10. Enable the Service Management API:

    gcloud services enable servicemanagement.googleapis.com

11. 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:[e-mail].

    • Replace ROLE with each individual role.

curl によるテスト

1. Google REST API の呼び出しに便利なシェル エイリアスを定義します。

   $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. 一般公開されているサービスの一覧表示を試行します。

   $ gcurl https://servicemanagement.googleapis.com/v1/services
   

   サービスのリストが表示されれば設定は成功です。

次のステップ

Cloud Endpoints を使用しておらず、マネージド サービスを作成する場合は、次の手順を行います。

1. サービスの作成と削除の手順に沿ってマネージド サービスを作成します。これにより、トップレベルのマネージド サービス リソースが作成されます。

2. サービス構成の管理の手順に沿って、サービスによって使用される機能を記述したサービス構成を送信します。

   注: サービス構成は送信しただけでは有効になりません。次のステップに沿って構成をロールアウトする必要があります。

3. サービス構成のロールアウトの手順に沿ってサービス構成をロールアウトします。