プラットフォーム管理 API

「プラットフォーム管理 API」のセクションでは、各プラットフォーム管理領域と、対応するエンドポイントの概要を説明します。

• 監査ログ
• グループ
• ロボット アカウント
• ユーザー アカウント
• 設定
• メッセージ テンプレート

API で使用する partitionGlobalId を取得する

API を使用してユーザーとグループを管理する場合、 partitionGlobalId の取得は重要な手順です。このパラメーターは、アカウントを管理する組織の ID を表します。このガイドに従って、 partitionGlobalIdを取得するさまざまな方法を学んでください。

Understanding partitionGlobalId

API 要求を実行する場合、要求の本文に partitionGlobalId パラメーターが含まれている必要があります。このパラメーターにより、管理する組織を一意に識別します。

このパラメーターを誤って取得または使用すると、「'{"errors":{"partitionGlobalId":["The value 'DatacomGroup' is not valid."]} '」のようなエラー メッセージが表示されます。これは、入力した partitionGlobalId 値が有効ではないことを示します。

方法 1 - URLからpartitionGlobalIdを取得する

partitionGlobalId は、ログイン時に表示される URL に埋め込まれています。

たとえば、URL が https://baseURL/tenant/portal_/cloudrpa?organizationId=xxxxxx&ecommerceRedirect=false&isAuth0=trueの場合、xxxxxx がpartitionGlobalIdです。ただし、URL の読み込みが速すぎるため、これを取得するのは難しい可能性があります。

方法 2 - 開発者ツールを使用して取得する partitionGlobalId

読み込みが速いために取得できない問題を回避するには、以下の手順を実行します。

1. ログインする前に、Web ブラウザーの開発者ツールを開きます。Windows と Linux では、キーボード ショートカット Ctrl + Shift + J を使用して開発者ツールを開くことができます。Mac では、キーボード ショートカット Command + Option + J を使用して開発者ツールを開くことができます。

2. [ネットワーク] タブに移動し、記録を有効化します。

   

3. Orchestrator にログインし、目的のテナントを選択します。

4. ページが完全に読み込まれたら、開発者ツールの [ネットワーク] タブに戻ります。

5. ページの読み込み中に実行された要求を調べます。Settings API 要求などの要求を探します。

6. この特定の要求の [要求 URL] で、partitionGlobalId とその後の ID を確認できます。この ID が自分の partitionGlobalId であり、API 呼び出しで使用される値です。