Service Management API を使ってみる

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

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

  1. Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. Cloud Console のプロジェクト セレクタページで、Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタのページに移動

  3. Service Management API を有効にします。

    API を有効にする

  4. Cloud SDK をインストールして初期化します。

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

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

初期設定

  1. Cloud Console の [サービス アカウント]ページに移動します。
    サービス アカウント ページに移動
  2. [選択]をクリックして、サービスへのアクセスに使用する Google Cloud プロジェクトを選択します。
  3. サービス アカウントを作成します。サービス アカウントの作成方法については、サービス アカウントの作成と管理を参照してください。 このセクションの手順を実行するには、サービスアカウントにroles/servicemanagement.adminのロールを付与する必要があります。サービス アカウントにロールを付与する方法については、サービス アカウントへのロールの付与をご覧ください。
  4. Cloud Console のAPI 認証情報ページに移動します。
    API 認証情報ページに移動
  5. 新しいサービス アカウント用にサービス アカウント キーを作成し、その JSON 認証情報ファイルをローカルマシンにダウンロードします。このガイドの例では、ファイルパスが ~/credentials.json であると想定しています。サービス アカウント キーの作成方法については、サービス アカウント キーの作成と管理をご覧ください。
  6. ローカルマシンに oauth2l をインストールし、Google OAuth システムを操作できるようにします。

curl によるテスト

  1. まず、初期設定を確認します。

    $ oauth2l header --json ~/credentials.json cloud-platform
    
  2. OAuth フローを終えると、次のような出力が表示されます。

    Authorization: Bearer y29.xxxxxxx
    
  3. Google REST API の呼び出しに便利なシェル エイリアスを定義します。

    $ alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform)" -H "Content-Type: application/json"'
    
  4. 一般アクセス可能なサービスを一覧表示してみます。

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

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

次のステップ

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

  1. サービスの作成と削除の手順に沿ってマネージド サービスを作成します。これにより、トップレベルのマネージド サービス リソースが作成されます。
  2. サービス構成の管理の手順に沿って、サービスによって使用される機能を記述したサービス構成を送信します。

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