Google ドキュメントの認証

前提条件

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

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

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

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

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

手記： [Bring your own OAuth 2.0 app] を使用して認証する場合は、アプリの作成時に設定されたスコープが既定で利用されます。 既定のアプリのアクセス許可を使用する場合は、 common スコープを宣言できます。 つまり、そのアプリケーション用に設定されたアクセス許可のみを使用します。 接続の作成時に [スコープ ] フィールドを使用して追加のスコープを宣言することもできます。 その後、サインイン時に追加の同意を付与するよう求められます。

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

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

1. Automation Cloud^TM で [Integration Service] を選択します。

2. [コネクタ] のリストから [Google ドキュメント] を選択します。検索バーで検索してコネクタを探すこともできます。

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

4. これで、コネクションのページにリダイレクトされます。 使用する認証の種類を選択します。

   [Bring your own OAuth 2.0 app] を選択した場合は、クライアント ID とクライアント シークレット、およびさまざまなアクティビティを操作するために必要なスコープを指定する必要があります。 必要なスコープについては、アクティビティのドキュメントをご覧ください。

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

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

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