このページは Cloud Translation API によって翻訳されました。

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

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

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

API を有効にするには、事前に Google Cloud プロジェクトを作成する必要があります。このプロジェクトは、API の管理、請求の有効化、共同編集者の追加と削除、権限の管理など、すべての Google Cloud サービスの作成、有効化、使用の基礎となります。

Google Cloud コンソールを開きます。
ページの上部にある [Google Cloud コンソール] の右側にあるをクリックします。現在のプロジェクトをリストしたダイアログが表示されます。
[新しいプロジェクト] をクリックします。[新しいプロジェクト] 画面が表示されます。
[プロジェクト名] フィールドにプロジェクト名を入力します。
（省略可）[編集] をクリックしてプロジェクト ID を編集します。プロジェクトが作成された後にプロジェクト ID を変更することはできないため、プロジェクトのライフタイムを考慮してニーズに合った ID を指定してください。
プロジェクトのロケーションを参照するには、[参照] をクリックします。
プロジェクトのロケーションをクリックし、[選択] をクリックします。
[作成] をクリックします。コンソールが [ダッシュボード] ページに移動します。プロジェクトは数分で作成されます。

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

2. API を有効にする

Google Cloud Search API を有効にし、サービスアカウントを作成して認証情報を取得する必要があります。

新たに作成したプロジェクトを対象とするために、Google Cloud コンソールバナーの右側にあるアイコンをクリックし、新たに作成したプロジェクトを選択します。
[API とサービスを有効化] をクリックします。[API ライブラリへようこそ] ページが表示されます。
Google Cloud Search API に移動します。
[有効にする] をクリックします。[概要] ページが表示されます。

API の有効化と無効化の詳細については、Google Cloud コンソールで API を管理するをご覧ください。

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

Google Cloud コンソールで、左側のナビゲーションにある [認証情報] をクリックします。[認証情報] ページが表示されます。
[認証情報を作成] プルダウンリストから [サービスアカウント] を選択します。[サービスアカウントの作成] ページが表示されます。
[サービスアカウント名] フィールドに名前を入力します。
（省略可）サービスアカウント ID を編集します。
[作成] をクリックします。[サービスアカウントの権限] 画面が表示されます。
[続行] をクリックします。[ユーザーにこのサービスアカウントへのアクセスを許可] 画面が表示されます。
[キーを作成]、[完了] の順にクリックします。[秘密鍵がパソコンに保存されました] ダイアログが表示され、秘密鍵のコピーがパソコンにダウンロードされます。
[閉じる] をクリックします。

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

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

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

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

他の Cloud Search API を呼び出す前に、Google Cloud Search のサードパーティサポートを初期化する必要があります。

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

Cloud Search Platform プロジェクトにサービスアカウントの認証情報が含まれている。ただし、サードパーティサポートを初期化するには、ウェブアプリケーションの認証情報を作成する必要があります。ウェブアプリケーションの認証情報を作成する手順については、認証情報を作成するをご覧ください。この手順を完了すると、クライアント ID とクライアントシークレットファイルが作成されます。
Google の OAuth 2 Playground を使用してアクセストークンを取得します。
1. 設定をクリックし、[ユーザー独自の認証情報を使用] をオンにします。
2. 手順 1 のクライアント ID とクライアントシークレットを入力します。
3. [閉じる] をクリックします。
4. scopes フィールドに「https://www.googleapis.com/auth/cloud_search.settings」と入力し、[承認] をクリックします。OAuth 2 Playground から認証コードが返されます。
5. [Exchange authorization code for tokens] をクリックします。トークンが返されます。
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 サポートにお問い合わせください。

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

サードパーティの初期化が完了すると、true に設定されたフィールド done が含まれます。次に例を示します。

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

次のステップ

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

Google Cloud Search を Google 以外のデータリポジトリ（Microsoft® SharePoint® など）とともに使用する場合は、データソースを作成する必要があります。データソースの追加手順については、検索対象のデータソースを追加するをご覧ください。
データソースを設定すると、スキーマを作成および登録して、Google Cloud Search がリポジトリ内のデータをどのように表現するかを指定できます。