Google スプレッドシートの認証

前提条件

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

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

注:

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

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

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

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

OAuth 2.0 の認可コード

スコープ

• 必須のスコープ: openid、https://www.googleapis.com/auth/drive
• 既定のスコープ: openid、 https://www.googleapis.com/auth/userinfo.email、 https://www.googleapis.com/auth/userinfo.profile、 https://www.googleapis.com/auth/drive。

より詳細な権限を追加するには、 Google アクティビティのドキュメントをご覧ください。

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

Google スプレッドシートのコネクションを追加する

お使いの Google スプレッドシートへのコネクションを作成するには、次の手順を実行します。

1. 製品ランチャーから [Orchestrator] を選択します。
2. フォルダーを選択して [ コネクション ] タブに移動します。
3. [ コネクションを追加] を選択します。
4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
5. [認証の種類] ドロップダウン メニューで [OAuth 2.0 認可コード] を選択します。
6. [接続] を選択します。

独自の OAuth 2.0 アプリ (BYOA) を使用する

認証の種類として [独自の OAuth 2.0 アプリ (BYOA) を使用する ] を使用すると、カスタム OAuth アプリケーションを使用して UiPath を Google スプレッドシートに接続できます。このカスタム アプリは、既定の UiPath パブリック アプリではなく、Google Cloud Console で作成して管理できます。これにより、同意、範囲、セキュリティ ポリシーをより詳細に制御できるほか、共有 OAuth クライアント ID に関連する更新トークンの制限を回避できます。

注:

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

スコープ

• 必須のスコープ: openid、https://www.googleapis.com/auth/drive
• 既定のスコープ: openid、 https://www.googleapis.com/auth/drive、 https://www.googleapis.com/auth/userinfo.email、 https://www.googleapis.com/auth/userinfo.profile。

注:

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

より詳細な権限を追加するには、 Google アクティビティのドキュメントをご覧ください。

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

Google スプレッドシートのコネクションを追加する

お使いの Google スプレッドシートへのコネクションを作成するには、次の手順を実行します。

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

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

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

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

5. [認証の種類] ドロップダウン メニューで、[独自の OAuth 2.0 アプリ (BYOA) を使用する] を選択します。

6. 次のように設定します。

   • クライアント ID - Google Cloud Console 認証情報の [OAuth 2.0 クライアント ID] セクションのクライアント ID です。
   • クライアント シークレット - Google Cloud コンソールの認証情報のクライアント シークレットです。

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

7. [接続] を選択します。

Google サービス アカウント

スコープ

• 必須のスコープ: openid、https://www.googleapis.com/auth/drive
• 既定のスコープ: openid、 https://www.googleapis.com/auth/drive、 https://www.googleapis.com/auth/userinfo.email、 https://www.googleapis.com/auth/userinfo.profile。

より詳細な権限を追加するには、 Google アクティビティのドキュメントをご覧ください。

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

Google スプレッドシートのコネクションを追加する

お使いの Google スプレッドシートへのコネクションを作成するには、次の手順を実行します。

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

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

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

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

5. [認証の種類] ドロップダウン メニューで [Google サービス アカウント] を選択します。

6. 次のように設定します。

   • サービス アカウント キー - Google Cloud Console からダウンロードした、サービス アカウント用の完全な JSON キー ファイルを貼り付けます。詳しくは、Google の公式ドキュメントの「 Create a service account key 」をご覧ください。
   注:

   サービス アカウントとキーの作成方法の詳細については、Google ドキュメントの「 サービス アカウントの作成 」をご覧ください。

   • アカウントのメール アドレス - Google アカウントのメール アドレスです。

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

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

注:

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