Google パッケージの接続アクション

[接続] アクションを使用して Google サーバーとの接続を確立し、同じパッケージからの他のアクションを使用してタスクを自動化します。このアクションのすべてのフィールドは、Credential Vault からの資格情報子、変数、またはユーザー入力値を受け入れます。

前提条件

Google Cloud Platform で OAuth 設定を構成し、Automation Anywhere を Google G Suite アプリケーションに接続するために必要な資格情報を取得します。
  1. まだ作成していない場合は、プロジェクトを作成します。
  2. Google ドライブ API、Google カレンダー API、Google シート API.など、自動化する Google G Suite アプリケーションの API を有効にします。
  3. OAuth 2.0 をセットアップ してクライアント ID とシークレットを生成する手順を実行します。
    注:
    • [Web アプリケーション] オプションを選択し、名前を入力します。
    • 認証モードに基づいて、以下のように関連するリダイレクト URI を入力します。
      • 認証コード (デフォルトの認証モード): この承認済みのリダイレクト URI http://localhost:8888/Callback を追加します。
      • Control Room マネージ: [Control Room] > [マネージ] > [OAuth 接続] > [接続設定] ページからコールバック URL を追加します。「OAuth 接続を作成する」を参照してください。

手順

  1. アクション パレットで、使用するパッケージから [接続] アクションをダブルクリックまたはドラッグします。
  2. [ユーザー名] フィールドで、有効なユーザー名を入力するか、Google ユーザー名を含む資格情報または資格情報変数を選択できます。値を入力するには、[安全でない文字列] をクリックします。
  3. Google カレンダー または Google シート パッケージの [接続] アクションを設定する場合は、セッション名を入力します。
  4. [OAuth2 認証モード] ドロップダウンをクリックし、次のいずれかの認証モードを選択します。

    Attended 認証モードでは、[認証コード] を選択します。これはレガシー フローであり、安全ではありません。Unattended 認証モードでは、[Control Room マネージ] OAuth2 認証を選択します。これはオートメーションの、より安全かつ標準的なモデルです。

    • 認証コード
      • [クライアント ID] フィールドで、クライアント ID を含む資格情報または資格情報変数を選択します。値を入力するには、[安全でない文字列] をクリックします。
      • [リダイレクト URI] フィールドに「http://localhost:8888/Callback」と入力します。
        注: Google シート パッケージ では、[リダイレクト URI] 属性はサポートされていません。Google Cloud Platform に固定のリダイレクト URL (http://localhost:8888/Callback) を直接入力します。
      • [クライアントのシークレット] フィールドで、アクセス トークンを含む資格情報または資格情報変数を選択します。値を入力するには、[安全でない文字列] をクリックします。
    • Control Room マネージ

      Google パッケージで Control Room マネージ OAuth2 を使用するには、Control Room で OAuth 接続を構成する必要があります。「OAuth 接続を作成する」を参照してください。

      以下のフィールドで情報を更新します。

      • 接続: [選択] ボタンをクリックして接続タイプを選択します。
      • [プロバイダー タイプ] フィールドで [カスタム] を選択します。

      • Google Workspace アプリ用に Control Room で設定した接続名を選択します。

      • [トークン タイプ] フィールドを使用して、次のいずれかのオプションを選択します。

        Google Workspace アプリケーションのアクセス トークンおよび更新トークンについては、「エンタープライズ アプリケーションを構成する」を参照してください。

        • [共有しました]: オートメーションを実行するすべてのユーザーで OAuth2 アクセス トークンを共有する場合は、このオプションを選択します。この場合、Control Room 管理者または任意のユーザー ([OAUTH 接続] で [接続をマネージ] および [接続を表示] オプションが有効になっている) が Control Room で OAuth 接続を設定する必要があることに注意してください。オートメーションを実行しているすべてのユーザーが使用できる共有アクセス トークンを生成するために、ログイン資格情報を 1 回保存します。
        • ユーザー固有: OAuth2 アクセス トークンがオートメーションを実行するユーザーごとに固有である場合は、このオプションを選択します。この場合、Control Room 管理者または任意のユーザー ([OAUTH 接続] で [接続をマネージ] および [接続を表示] オプションが有効になっている) が Control Room で OAuth 接続を設定する必要があることに注意してください。ログイン資格情報は保存しないようにしてください。オートメーションを実行する各ユーザーがログイン資格情報を指定し、その特定のユーザーのみが使用可能なアクセス トークンを生成できるようにするためです。
        • [確認] をクリックします。

          Control Room マネージ OAuth2 オプションの使用

      注: [ユーザー固有] オプションを使用する場合は、Google アカウントにログインして認証し、ユーザー固有のトークンを生成する必要があります。このオプションを使用するには、次の手順を実行します。
      1. Control Room で、プロファイルの [マイ設定] > [OAuth 接続] に移動します。
      2. [ログインして認証] をクリックします。
      3. Google アカウントにログインし、[続行] を選択します。
      4. アクセスできるサービスを確認し、[続行] をクリックします。

        正常に接続されると、ステータスが [アクティブ] と表示されます。

        OAuth 認証の成功ステータス

  5. Google シート では、[取得]、[設定] または [削除] などの アクション を実行するときに、[アクションの完了を待機 (分)] フィールドに待機時間 (分単位) を指定できます。デフォルトでは、待機時間は 10 分です。
    指定した時間内に Google シートが開かない場合は、タスクは次の一連のアクションを実行します。
    注: [接続] アクション を使用して Google サーバーに接続する場合、[アクションの完了を待機 (分)] オプションは Google シート パッケージ でのみサポートされます。
  6. [保存] をクリックします。
  7. 特定の Google パッケージのアクションを追加した後、その同じ Google パッケージの [接続解除] アクションを使用して、接続を終了してください。

次のステップ

Bot を初めて実行すると、Google ログイン ウィンドウが表示されます。Google アカウントを選択し、リクエストされたアクセス権限を承認する必要があります。

トークン ファイルは、Bot のデプロイ時に初めてアクセス権を付与した後に生成されます。[ユーザー名]、[クライアント ID] および [クライアント シークレット] フィールドに入力した値に基づいて作成され、アクセス権を提供するために初回のみ資格情報を要求します。次回は、同じトークン ファイルを使用して Google シート に接続します。

トークン ファイルは、C:\Users\<username>\AppData\Local\AutomationAnywhere\G-SuitAuth にあります。この場合、C:\Users\<username> は、各システムのユーザー ホーム ディレクトリです。

最初にアクセス権を付与するときに正しい資格情報を入力し、Google シート に正常に接続できた場合は、次にパスワードだけが変更された場合でも、トークン ファイルは期待どおりに動作するため、トークン ファイルを削除する必要はありません。

同じ Google パッケージの他のアクションを使用して、タスクを自動化します。他の Google パッケージからのアクションを使用するには、そのパッケージの [接続] アクションを使用して接続を確立します。