これは、Integration Connectors with AppSheet のプレビュー リリースです。機能リリースを追跡、管理するをご覧ください。プレビュー版のサービスは、テスト環境のみで使用することを前提としています。本番環境用アプリでのご利用はおすすめしません。この機能について質問がある場合やサポートが必要な場合は、AppSheet サポートにお問い合わせください。
Integration Connectors with AppSheet（プレビュー版）を使用するには、AppSheet Enterprise Plus アカウントが必要です。
AppSheet で Integration Connectors を設定するには、Google Cloud 管理者と AppSheet チーム管理者が連携して次の手順を行う必要があります。
| ステップ | 説明 | 担当者 |
| 1 | Integration Connectors を設定して接続を作成する | Google Cloud 管理者 |
| 2 | AppSheet チームが Integration Connectors を使用するように設定する |
AppSheet チーム管理者と |
AppSheet で Integration Connectors を設定すると、接続をデータソースとして追加、使用できます。
Integration Connectors を設定して接続を作成する
以下のセクションの説明に沿って、Integration Connectors を設定して接続を作成します。
Google Cloud プロジェクトとサービス アカウントを作成する
Google Cloud 管理者が Google Cloud コンソールで Google Cloud プロジェクトとサービス アカウントを作成するには、次の操作を行います。
- Google Cloud プロジェクトを作成します。Google Cloud プロジェクトに、AppSheet で使用する接続を作成します。AppSheet で使用する接続がプロジェクトにすでに含まれている場合は、この手順をスキップできます。
- 接続を作成する権限を付与します。AppSheet チーム管理者がプロジェクトで接続を作成できるようにする場合は、アクセス制御権限を付与する必要があります。
- Integration Connectors で接続を作成するときに使用するサービス アカウントを作成します。サービス アカウントとは、人間以外のユーザーを表す特別な Google アカウントで、Google Cloud のデータにアクセスする際に認証を必要とします。
Google Cloud プロジェクトで Integration Connectors を設定する
Google Cloud 管理者は、Integration Connectors を設定する手順に沿って、Google Cloud プロジェクトの Integration Connectors を設定する必要があります。プロジェクトが Integration Connectors を使用するようにすでに設定されている場合は、この手順をスキップできます。
設定プロセスでは、プロジェクトで次の API を有効にします。
- Secret Manager API
- Connectors API
Integration Connectors の設定が完了すると、[Welcome to Integration Connectors Overview] ページが表示されます。
接続を作成する
Google Cloud 管理者は、次のいずれかのデータソース タイプに基づいて接続を作成できます。接続を作成するには roles/connectors.admin IAM ロールが必要です。AppSheet で使用するデータへの接続がすでに作成されている場合は、この手順をスキップできます。
有効にする各コネクタの設定手順については、以下のリンクをご覧ください。これには、Google Cloud プロジェクトとサービス アカウントを作成する手順で作成したサービス アカウントに特定のロールを付与する必要があります。
- Google BigQuery
BigQuery データに対する insert と update のオペレーションを許可するには、接続の作成に使用するサービス アカウントに
roles/bigquery.dataEditorとroles/bigquery.jobUserの IAM ロールを付与します。 - PostgreSQL
- Salesforce
- ServiceNow
When you configure the ServiceNow connection, we recommend that you specify the tables to include in the Filter Tables field. Otherwise, you might experience significant delays when loading your data.
注: 複数のリージョンに対応するには、各リージョンで接続を作成する必要があります。接続を作成するときに、us-west1、us-central1、us-east4、europe-west4 のいずれかのリージョンを選択してください。
AppSheet チームが Integration Connectors を使用するように設定する
接続をデータソースとして追加するには、AppSheet チーム管理者と Google Cloud 管理者が連携して、AppSheet チームが Integration Connectors を使用するように設定する必要があります。
AppSheet 管理者として、チームが Integration Connectors を使用するように設定するには、次の操作を行います。
- [My account] > [Sources] に移動し、[+ New Data Source] をクリックします。
- [Use Integration Connectors] タブを選択します。
- [Get started] をクリックします。
[Add data source using Integration Connectors] ダイアログが表示されます。次のセクションに記載されているウィザードに沿って操作します。
ステップ 1: サービス アカウントを作成する
接続をデータソースとして追加するには、AppSheet と Integration Connectors 間の接続の管理に使用するチームのサービス アカウントが必要です。このサービス アカウントは、Google Cloud 管理者が Google Cloud プロジェクトを設定したときに作成したものとは異なります。なお、このサービス アカウントは AppSheet 所有の Google Cloud プロジェクトに作成され、AppSheet でのみ使用できます。詳細については、AppSheet での Integration Connectors に使用される Google Cloud プロジェクトとサービス アカウントについての記事をご覧ください。
AppSheet 所有の Google Cloud プロジェクトにサービス アカウントを作成する手順は次のとおりです。
- チームのサービス アカウントをまだ作成していない場合は、[Create] をクリックします。
サービス アカウントをすでに作成している場合は、そのメールアドレスがフィールドに表示されます。 - コピーアイコン
をクリックして、サービス アカウントのメールアドレスをコピーします。
- [Next] をクリックします。
ステップ 2. アクセスロールを付与する
アクセスロールを付与する手順は次のとおりです。
- Google Cloud 管理者にサービス アカウントへアクセスロールを付与するよう依頼し、AppSheet から Integration Connectors への接続を許可します。ステップ 1: サービス アカウントを作成する手順でコピーしたサービス アカウントのメールアドレスを Cloud 管理者に提供します。
- Cloud 管理者は、AppSheet からコネクタへの接続を許可する手順に沿って操作する必要があります。
- 複数のプロジェクトで接続が使用されている場合は、アクセス権を付与するプロジェクトごとにステップ 2 を繰り返します。
- Cloud 管理者によってアクセスロールが付与されたら、[Next] をクリックします。
AppSheet からコネクタへの接続を許可する
次のいずれかの方法で、Google Cloud 管理者に AppSheet から Integration Connectors への接続を許可するよう依頼します。
関連情報: AppSheet に Integration Connectors との接続を許可しない
Google Cloud コンソールを使用して、AppSheet から Integration Connectors への接続を許可する IAM 権限を更新するには、次の操作を行います。
- Google Cloud コンソールで IAM 権限ページを開きます。
接続が作成されたプロジェクトを選択します。 - [+ アクセスを許可] をクリックします。
アクセス権を付与するためのフォームが表示されます。 - [新しいプリンシパル] フィールドに、AppSheet から提供されたサービス アカウントを入力します。
- [ロールを割り当てる] のロールのプルダウンで、[Connector Invoker] を選択します。
- [+ 別のロールを追加] をクリックします。
- 新しいロール プルダウンで、[Connectors Viewer] を選択します。
フォームの例を以下に示します。
Google Cloud Platform リソースの不要な公開を最小限に抑えるため、最小限の権限に従って、付与するロールはこの機能を使用するために必要な最小限のロールだけにとどめることをおすすめします。 - AppSheet で使用する特定のコネクタへのアクセスを制限する IAM Conditions を追加します。
デフォルトでは、上記のロールを付与すると、AppSheet はプロジェクト内のすべてのコネクタで関連するオペレーションを実行できます。AppSheet でコネクタのサブセットのみを使用する場合は、IAM Conditions を使用して、それらの特定のコネクタへのアクセスを制限することをおすすめします。詳しくは、きめ細かいアクセス制御のための IAM Conditions についての記事をご覧ください。 - [保存] をクリックします。
gcloud CLI を使用する
管理者は gCloud CLI を使用して、AppSheet からコネクタへの接続を許可する IAM 権限を更新できます。スクリプトをコピーするには、[Option 2: Use gCloud CLI] セクションを開き、[CLI access roles] 
ステップ 3: 接続を表示する
接続を表示する手順は次のとおりです。
- Google Cloud 管理者が接続を作成した Google Cloud プロジェクト ID を入力し、[Find] をクリックします。
使用可能な接続のリストが表示されます。 - リストから、データソースとして追加する接続を選択します。
- [Next] をクリックします。
ステップ 4: 接続を追加する
接続を追加する手順は次のとおりです。
- 必要に応じて、[Share connection for use within your team] を選択します。
この手順は省略可能です。後からデータソースをチームと共有することも可能です。 - [Save and complete] を選択します。
コネクタがデータソースとして追加されます。
次のステップ
- 接続を追加するには、接続をデータソースとして追加する方法をご覧ください。
- アプリで接続をデータソースとして使用するには、接続をデータソースとして使用する方法をご覧ください。