Google Cloud Search API へのアクセスを構成する

まず、Google Cloud Search API へのアクセスを構成する必要があります。 直接または SDK を介して使用できます。このドキュメント では、Google Cloud Search API REST API を使用するために必要な手順について説明します。

1. API プロジェクトを作成する

API を有効にするには、まず Google Cloud プロジェクトを作成する必要があります。この Google Cloud リソースの作成、有効化、使用の基礎となります。 API の管理、課金の有効化、リソースの追加と有効化など、 共同編集者の削除、権限の管理などができます。

  1. Google Cloud コンソールを開きます。

  2. ページ上部の [Google Cloud コンソール]をクリックします現在のプロジェクトをリストしたダイアログが表示されます。

  3. [新しいプロジェクト] をクリックします。「新しいプロジェクト」画面が表示されます。

  4. [プロジェクト名] フィールドにプロジェクト名を入力します。

  5. (省略可)[編集] をクリックしてプロジェクト ID を編集します。プロジェクトが作成された後にプロジェクト ID を変更することはできないため、プロジェクトのライフタイムを考慮してニーズに合った ID を指定してください。

  6. プロジェクトの場所を参照するには、[参照] をクリックします。

  7. プロジェクトの場所をクリックし、[選択] をクリックします。

  8. [作成] をクリックします。コンソールが [ダッシュボード] ページに移動します。プロジェクトは数分で作成されます。

プロジェクトの作成と管理の詳細については、プロジェクトの作成と管理をご覧ください。

2. API を有効にする

Google Cloud Search API を有効にしてサービス アカウントを作成して、 認証情報を取得できます。

  1. 新しく作成したプロジェクトにいることを確認するには、 アイコンをクリックします。 Google Cloud コンソールのバナーをクリックし、新しく作成したプロジェクトを選択します。
  2. [API とサービスの有効化] をクリックします。"Welcome to API Library"ページ 表示されます。
  3. Google Cloud Search API に移動します。
  4. [有効にする] をクリックします。「概要」ページが表示されます。

API の有効化と無効化について詳しくは、このモジュールの Google Cloud コンソールで API を管理する

3. サービス アカウントの認証情報を作成する

  1. Google Cloud コンソールで次の操作を行います。 左側のナビゲーションで [認証情報] をクリックします。[認証情報] ページが表示されます。
  2. [認証情報の作成] プルダウン リストから、 サービス アカウント。「 「サービス アカウントの作成」ページが表示されます。
  3. [サービス アカウント名] フィールドに名前を入力します。
  4. (省略可)サービス アカウント ID を編集します。
  5. [作成] をクリックします。「サービス アカウント権限」は画面が表示されます。
  6. [続行] をクリックします。「ユーザーにこのサービス アカウントへのアクセスを許可」スクリーン 表示されます。
  7. [キーを作成] をクリックし、[完了] をクリックします。「秘密鍵が Google Cloud の パソコン"ダイアログが表示され、秘密鍵のコピーがファイルにダウンロードされます。 できます。
  8. [閉じる] をクリックします。

サービス アカウントの詳細については、サービス アカウント、ウェブ アプリケーション、インストール型アプリケーションをご覧ください。

4. メールアドレスを特定する

  1. Google Cloud コンソールで次の操作を行います。 ページの上部で、作成したプロジェクトを選択します。
  2. Google Cloud コンソール バナーの左側にあるナビゲーション メニューをクリックします。
  3. [IAM と管理] > [サービス アカウント] をクリックします。
  4. リストの [サービス アカウント ID] で、生成されたメールをメモする 構成したサービス アカウントを識別するアドレスです。このメールアドレスは、Cloud Search にデータソースを追加する際に使用されます。

5. サードパーティ サポートを初期化する

他の Cloud Search API を呼び出すには、その前にサードパーティ サポートするようになりました

Cloud Search に対するサードパーティのサポートを初期化するには:

  1. Cloud Search Platform プロジェクトには、サービス アカウントの認証情報が含まれています。 ただし、サードパーティのサポートを初期化するために、 認証情報を取得できます。ウェブ アプリケーションを作成する手順については、 詳しくは、このモジュールの 認証情報を作成します。 この手順を完了すると、クライアント ID とクライアント シークレット ファイルが作成されます。

  2. 使用 Google の OAuth 2 プレイグラウンド アクセス トークンを取得します。

    1. 設定をクリックし、[User your own auth credentials] をオンにします。
    2. ステップ 1 のクライアント ID とクライアント シークレットを入力します。
    3. [閉じる] をクリックします。
    4. [Scopes] フィールドに「https://www.googleapis.com/auth/cloud_search.settings」と入力します。 [承認] をクリックします。OAuth 2 Playground から認証コードが返されます。
    5. [Exchange authorization code for token] をクリックします。トークンが返されます。
  3. サードパーティによる Cloud Search のサポートを初期化するには、次の curl を使用します。 使用できます。[YOUR_ACCESS_TOKEN] は、モジュールで取得したトークンに置き換えてください。 ステップ 2:

    curl --request POST \
    'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
      --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --data '{}' \
      --compressed
    

    成功した場合、レスポンスの本文には operation。次に例を示します。

    {
    name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
    }
    

    問題が解決しない場合は、Cloud Search サポートにお問い合わせください。

  4. operations.get を使用して、 初期化されます。

    curl \
    'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
    [YOUR_API_KEY]' \
    --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
    --header 'Accept: application/json' \
    --compressed
    

    サードパーティの初期化が完了すると、 フィールド donetrue に設定。例:

    {
    name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
    done: true
    }
    

次のステップ

以下は、適宜実行してください。

  1. Google Cloud Search を Google 以外のデータ リポジトリ(Microsoft® SharePoint® など)とともに使用する場合は、データソースを作成する必要があります。データソースの追加手順については、検索対象のデータソースを追加するをご覧ください。

  2. データソースを設定すると、スキーマを作成および登録して、Google Cloud Search がリポジトリ内のデータをどのように表現するかを指定できます。