アクティビティ

Integration Service を使用せずに Google Workspace アクティビティを使用する方法

概要

Integration Service を使用していなくても、新しい Google Workspace アクティビティを [GSuite アプリケーションスコープ] 経由で使用できるようになりました。

Integration Service 専用に設計された Google Workspace アクティビティには [コネクション] フィールドがあり、Integration Service コネクタを使用して作成したコネクションを選択できます。 [GSuite アプリケーションスコープ] 内で使用した場合、アクティビティはスコープからコネクション情報を継承するだけです。

認証とプロジェクトの種類のマトリックス

Google Workspace
	クラウド		オンプレミス
	GSuite アプリケーションスコープ	Integration Service	GSuite アプリケーションスコープ	Integration Service
クロスプラットフォーム
API キー
OAuth - BYOA
OAuth - UiPath アプリ
サービスアカウント
Windows
API キー
OAuth - BYOA
OAuth - UiPath アプリ
サービスアカウント

接続方法

[GSuite アプリケーションスコープ] アクティビティでコネクションを設定する方法は 2 つあります。

接続方法		説明	メリット	デメリット
アセット注: 推奨。		Orchestrator アセットを使用して、スコープ設定とともにコネクションを保存します。アセットは、JSON 形式です。このアクティビティは、使用されるたびにアセットから構成を取得します。アセットの構成に基づいて、スコープの動作は異なります。認証の種類を識別し、不要なフィールドを非表示にします。アセットの JSON が正しく設定されていない場合、検証エラーが表示されます。	これらのアクティビティは設計時の検索機能を利用して、ファイル、フォルダー、リスト、範囲などを検出できます。資格情報はユーザーから別のユーザーにプレーンテキストで渡されないため、コネクションは簡単に転送できます。管理者が設定できます。資格情報が Studio のワークフローに届かないため、より安全です。	上級ユーザーがアセットを構成する必要があります。市民開発者が簡単に設定できるものではありません。
プロパティパネル		既存の [プロパティ] パネルを使用して、コネクション資格情報を設定します。構成は、プレーンテキストまたは変数を使用して追加できます。	使いやすさに優れています。過去のバージョンとの相互運用性を保持します。
	プレーンテキストによる設定注: 推奨しません。	[プロパティ] パネルをプレーンテキスト値で設定します。	これらのアクティビティは設計時の検索機能を利用して、ファイル、フォルダー、リスト、範囲などを検出できます。	資格情報をプレーンテキスト形式でユーザー間で渡す必要があるため、安全性は低くなります。
	変数を使用した設定	変数を使用して [プロパティ] パネルを設定します。	資格情報が Studio のワークフローに届かないため、より安全です。	アクティビティは、設計時にリソースを検出できません。

GSuite アプリケーションスコープ - アセットの形式

{
    "ApiKey": "",
    "OAuth2ConnectionData": {
        "OAuth2AppData": {
            "ClientId": "",
            "ClientSecret": ""
        }
    },
    "SacConnectionData": {
        "EmailAddress": "",
        "KeyPath": "",
        "ServiceAccountEmail": "",
        "Password": "notasecret",
        "BucketId": "",
        "HasDomainWideAccess": true | false
    },
    "AuthenticationMethod": "oauth2" | "sac" | "apikey" | "is"
}{
    "ApiKey": "",
    "OAuth2ConnectionData": {
        "OAuth2AppData": {
            "ClientId": "",
            "ClientSecret": ""
        }
    },
    "SacConnectionData": {
        "EmailAddress": "",
        "KeyPath": "",
        "ServiceAccountEmail": "",
        "Password": "notasecret",
        "BucketId": "",
        "HasDomainWideAccess": true | false
    },
    "AuthenticationMethod": "oauth2" | "sac" | "apikey" | "is"
}