Google Cloud Platformを構成する
Googleデータアクション統合を使用するには、Google APIを統合にリンクするようにGoogle Cloud Platformアカウントを構成します。
- サービスアカウントを作成します。
このサービスアカウントは、データアクションで呼び出すAPIを含むGoogle Cloud Platformプロジェクトにある必要があります。詳細については、 サービスアカウントの作成と管理 Google Cloudのドキュメントで。
複数のAPIを使用する場合は、サービスアカウントに使用するすべてのAPIが含まれていることを確認してください。使用するAPIが複数のサービスアカウントにまたがる場合は、サービスアカウントごとに個別の統合を追加します。詳細については、 データアクション統合を追加する。
- サービスアカウントの秘密鍵ファイルを作成します。
このファイルには、統合資格情報に追加するアイテムが含まれています。詳細については、 サービスアカウントキーの作成と管理 Google Cloudのドキュメントで。
Google Cloud Functionsの特別な構成
Google Cloud Functionsを使用するには、Google Cloud Platformで関数、役割、権限も構成する必要があります。
次の表は、例で使用されている項目の名前と、それらの相互関係を示しています。
Googleアイテム | 例の名前 | 説明 | メモ |
---|---|---|---|
事業 | BusinessCallingAPI | このプロジェクトには、サービスアカウントと機能が含まれています。 | |
サービス アカウント | jwt-testing |
このサービスアカウントは、BusinessCallingAPIプロジェクトに属しています。 |
|
関数 | function-test-action | この関数は、プロジェクトBusinessCallingAPIに存在します。この関数には、サービスアカウントjwt-testingが割り当てられています。 | Googleデータアクション統合を実行する各関数にサービスアカウントを割り当てます。 |
カスタムの役割 | カスタムCloudFunction関数呼び出し | このカスタム役割を持つ権限 cloudfunctions.functions.call サービスアカウントjwt-testingの関数function-test-actionに割り当てられます。 | カスタム割り当て役割は、Googleデータアクションの統合を実行することを機能ごとにサービスアカウントにします。 |
権限 | cloudfunctions.functions.call | これは、 権限カスタムに追加された役割カスタムCloudFunction関数呼び出し。 |
- 既存のGoogle Cloud Functionsを作成または確認します。
- 関数が応答としてJSONを返すことを確認します。
- プロジェクト名、関数の場所、関数名を収集します。
この情報を使用して、 リクエストURLテンプレート 関数を呼び出すデータデータ アクションの場合。詳細については、 統合のカスタムアクションに構成を追加する.
実際の例については、 データデータ アクションしたGoogle Cloud Functionの例.
次の画像は、関数のリストを示しています。関数function-テスト・アクションが割り当てられている役割カスタムCloudFunction関数呼び出しを。役割サービスアカウントのJWT-テストに存在します。
- カスタムの役割作成し、 cloudfunctions.functions.call 権限の役割 。
役割 、今持っている権限機能にアクセスするために。詳細については、 IAMカスタムロールについて Google Cloudのドキュメントで。
次の図のカスタム役割に割り当てられたカスタムCloudFunction関数呼び出し権限 cloudfunctions.functions.call.
-
各機能にサービスアカウントを割り当てます。
データアクション統合を実行する関数ごとに繰り返します。詳細については、 関数ID Google Cloudのドキュメントで。
次の図は、関数function-test-actionの詳細を示しています。サービスアカウントjwt-testingが関数に割り当てられます。
重要: トリガーURLは、 権限にパブリックアクセスを割り当てた場合にのみ機能します。Genesysは、パブリックアクセスが安全でないため、データアクションにパブリックアクセスを割り当てることを推奨していません。
これで、Genesys Cloud組織にGoogleデータアクション統合を追加する準備ができました。
次、 統合を追加する。
統合の詳細については、 Googleデータアクションの統合について.