Google フォームの認証

OAuth 2.0 認可コード、独自の OAuth 2.0 アプリ、またはサービス アカウントを使用して、UiPath を Google フォームに接続します。

前提条件

選択した認証の種類に応じて、次のいずれかの資格情報が必要です。

• OAuth 2.0 認可コード: Google アカウントに関連付けられている Google のメール アドレスとパスワード。
• 独自の OAuth 2.0 アプリ (BYOA) を使用する: アプリケーションのクライアント ID、クライアント シークレット、およびスコープ。
• サービス アカウント: サービス アカウント キー、アカウントのメール アドレス

注:

さまざまな認証の種類について詳しくは、「 Google Workspace 365 アクティビティへの接続方法 」 ガイドをご覧ください。

認証が完了すると、コネクションを使用して Google フォームが提供するさまざまな機能にアクセスできます。

お使いのアカウントが Google によって有効化されていない場合は、以下の手順を実行してください。

• 管理者に問い合わせ、コネクションの作成の承認を依頼します。
• コネクションの作成を許可するオプションをオンにすることで、権限を有効化します。

Google フォームの詳細については、 Google フォームの開発者向けドキュメントをご覧ください。

スコープ

コネクタは、次のアクセス許可/スコープを要求します。

• UiPath パブリック アプリの既定のスコープ: openid、 https://www.googleapis.com/auth/drive.readonly、 https://www.googleapis.com/auth/forms.responses.readonly
• サービス アカウントの既定のスコープ:
• openid, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/forms.responses.readonly
• 独自の OAuth 2.0 アプリ (BYOA) を使用する:
  • コネクション作成の最小スコープ: openid
  • Google フォームのトリガーに必要なスコープの最小リストは以下のとおりです。
    • openid
    • https://www.googleapis.com/auth/drive.readonly
    • https://www.googleapis.com/auth/forms.responses.readonly

注:

[独自の OAuth 2.0 アプリ (BYOA) を使用する] を使用して認証する場合は、既定でアプリの作成時に設定したスコープのメリットが得られます。既定のアプリの権限を使用する場合は、 common 範囲を宣言できます。つまり、そのアプリケーションに設定されている権限のみを使用します。また、コネクションの作成時に [スコープ ] フィールドを使用して、追加のスコープを宣言することもできます。その後、サインイン時に追加の同意を求めるメッセージが表示されます。接続すると、ユーザーの代わりに UiPath 製品が Google フォームのデータを操作できるようになります。これには、Google フォームにおけるユーザーの権限に応じて、データの読み取り、書き込み、変更、削除の操作が含まれます。Google アカウントへのアクセス権はいつでも削除できます。

Google フォームのコネクションを追加する

1. 製品ランチャーから [Orchestrator] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

3. [ コネクションを追加] を選択します。

4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

5. 使用する認証の種類を選択し、必要な資格情報を追加して [ 接続] を選択します。

   [独自の OAuth 2.0 アプリ (BYOA) を使用する] を選択した場合は、クライアント ID とクライアント シークレット、およびさまざまなアクティビティとの対話に必要なスコープを指定する必要があります。 必要なスコープについては、アクティビティのドキュメントをご覧ください。

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly. For more information, see Use credential assets for connections.

6. 必要な資格情報を入力し、[接続] を選択します。

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly. For more information, see Use credential assets for connections.

OAuth アプリケーションの更新トークン

Google では、個々の OAuth 2.0 クライアント ID に対して更新トークンの制限を設けています。制限に達した場合、新しい更新トークンを作成すると、警告なしに最も古い更新トークンが自動的に無効になります。この制限は、サービス アカウントには適用されません (「 サーバー間アプリケーションに OAuth 2.0 を使用する用」をご覧ください)。詳細については、Google の公式 ドキュメントをご覧ください。

トークンは以下の理由で無効になります。

• アプリのアクセス権を取り消した。
• 更新トークンが 6 か月間使用されなかった。
• パスワードを変更する必要があり、更新トークンに Gmail スコープが含まれている。
• アカウントが、付与された (ライブ) 更新トークンの最大数を超えた。
  • 制限を超えた後に新しいトークンを要求すると、以前に付与されたトークンに基づき、古いコネクションは期限切れになります。 新しいコネクションまたは最新の編集/再認証されたコネクション (最新のトークンを使用) のみが機能します。
• 管理者が、アプリケーションのスコープで要求されたサービスのいずれかを [制限付き] に設定しました (エラーは admin_policy_enforced です)。
• Google Cloud Platform API の場合は、管理者が設定したセッション時間を超えている可能性があります。

注:

現在、OAuth 2.0 クライアント ID ごとに Google アカウントあたり更新トークンは 100 個までという制限が設定されています。この数は変更される場合があります。最新の情報については、常に Google のドキュメントをご確認ください。

全クライアントにわたって、ユーザー アカウントまたはサービス アカウントが持つことができる更新トークンの合計数の制限にはより大きい値が適用されます。通常のユーザーの場合はこの制限を超えることはありませんが、実装のテストに使用される開発者アカウントでは超える可能性があります。

この制限を超えないように、UiPath ではユーザーが独自の OAuth アプリケーションを作成し、認証の種類として独自のアプリを使用して接続できるようにしています。OAuth アプリケーションを作成する際は、Google のベスト プラクティスに従ってください。OAuth アプリケーションの作成方法の詳細については、Google の公式 ドキュメントをご覧ください。

注:

OAuth アプリケーションを Google に登録する際は、 コールバック URL をコネクション作成ページに表示される値 (Automation Cloud の https://cloud.uipath.com/provisioning_/callback など) に設定してください。

注:

トークンを無効にするとコネクションが失敗し、コネクションを修正しないとオートメーションを実行できません。