Postman を使用して Microsoft Graph コネクタ API を試す
Microsoft Graph Postman コレクションには、コネクタ API のサンプル要求が含まれています。 開発者は Postman を使用して、コードを記述せずに API を試すことができます。
前提条件
- Microsoft Graph Postman コレクションをフォークします。
- Postman 用に
ExternalConnection.ReadWrite.OwnedBy作成されたアプリ登録に とExternalItem.ReadWrite.OwnedByアクセス許可を追加します。 - Postman を使用して、アプリのみの認証で認証します。
コネクタ API 要求は、 Application ->Graph Connectors フォルダーにあります。
新しい接続を作成する
[接続のセットアップ] フォルダーで[接続の作成] サンプル要求を見つけます。 このサンプル要求を使用して、新しい接続を作成します。 接続セットアップ フォルダーには、接続を管理するための他のサンプル要求も含まれています。
接続スキーマを登録する
[接続のセットアップ] ->[スキーマの管理] フォルダーで、スキーマサンプル要求の登録を見つけます。 このサンプル要求を使用して、作成した接続のスキーマを登録します。 この要求は、次のような応答を返します。
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/external/connections/sampleConnectionId/operations/616bfeed-666f-4ce0-8cd9-058939010bfc
スキーマの登録は非同期操作です。 ヘッダーで Location 返される URL は、状態 completedが になるまで、この操作の状態をポーリングする必要があります。
[接続のセットアップ] フォルダーで操作状態の取得サンプル要求を見つけます。 要求 URL をヘッダーの値にLocation置き換え、要求チェック状態に送信します。 この要求は、次のような応答を返します。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "616bfeed-666f-4ce0-8cd9-058939010bfc",
"name": "Sample connection",
"status": "inprogress",
"error": null
}
プロパティが に設定されるまで要求を status 再送信します completed。 この要求を再送信するまで少なくとも 1 分待ちます。
[ スキーマの管理 ] フォルダーには、 接続を管理するための他のサンプル要求も含まれています。
外部グループ メンバーを追加する (省略可能)
外部サービスでMicrosoft Entra ID以外のアクセス制御リスト (ACL) を使用している場合は、それらのアクセス許可を同期します。 外部グループ (ユーザーとグループMicrosoft Entra IDと共に) を使用して、Microsoft Graph 接続に追加するアクセスexternalItems許可を設定します。 詳細については、「 externalGroup」を参照してください。
外部グループを作成し、メンバーを追加するためのサンプル要求は、 Identity Sync フォルダーにあります。
アイテムを取り込む
注:
接続スキーマが状態になるまで、接続に項目を completed 取り込まない。
コンテンツ同期フォルダーで Put item サンプル要求を見つけます。 このサンプル要求を使用して項目を取り込む。 コンテンツ同期フォルダーには、項目を管理するための他のサンプル要求も含まれています。
エラー処理
エラーの解決方法の詳細については、「Microsoft Graph の承認エラーを解決する」を参照してください。