Google ドキュメントの認証

前提条件

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

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

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

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

注:

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

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

スコープ

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

• UiPath パブリック アプリの既定のスコープ: openid、https://www.googleapis.com/auth/userinfo.email、https://www.googleapis.com/auth/userinfo.profile、https://mail.google.com/、https://www.googleapis.com/auth/calendar、https://www.googleapis.com/auth/gmail.settings.basic
• サービス アカウントの既定のスコープ: openid、https://www.googleapis.com/auth/userinfo.email、https://www.googleapis.com/auth/userinfo.profile、https://mail.google.com/、https://www.googleapis.com/auth/calendar、https://www.googleapis.com/auth/gmail.settings.basic
• 独自の OAuth 2.0 アプリ (BYOA) を使用する:
  • コネクションを作成するための最小スコープ: openid、 https://www.googleapis.com/auth/drive.readonly。
  • Google ドキュメントのトリガーに必要なスコープの最小限のリスト:
    • openid、https://www.googleapis.com/auth/drive.readonly

注:

[独自の OAuth 2.0 アプリ (BYOA) を使用する] を使用して認証する場合は、既定でアプリの作成時に設定したスコープのメリットが得られます。既定のアプリの権限を使用する場合は、 common 範囲を宣言できます。つまり、そのアプリケーションに設定されている権限のみを使用します。また、コネクションの作成時に [スコープ ] フィールドを使用して、追加のスコープを宣言することもできます。その後、サインイン時に追加の同意を求めるメッセージが表示されます。

接続すると、ユーザーの代わりに UiPath 製品が Google ドキュメントのデータを操作できるようになります。これには、Google ドキュメントにおけるユーザーの権限に応じて、データの読み取り、書き込み、変更、削除の操作が含まれます。Google アカウントへのアクセス権はいつでも削除できます。

Google ドキュメントのコネクションを追加する

1. Select Orchestrator from the product launcher.

2. Select a folder, and then navigate to the Connections tab.

3. Select Add connection.

4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.

5. 使用する認証の種類を選択します。

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

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

7. コネクションが追加されました。

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 の公式 ドキュメントをご覧ください。

注:

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