プラットフォーム管理 API

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

• 監査ログ

• グループ

• ロボット アカウント

• ユーザー アカウント

• 設定

• メッセージ テンプレート

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

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

partitionGlobalId を理解する

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

このパラメーターを誤って取得または使用すると、「'{"errors":{"partitionGlobalId":["The value 'DatacomGroup' is not valid."]} ' ('{"エラー":{"partitionGlobalId":["値 'DatacomGroup' は有効ではありません。"]} ')」のようなエラー メッセージが表示されます。これは、入力した 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. {baseURL_vanilla} にログインし、目的のテナントを選択します。

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

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

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