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 の承認エラーを解決する」を参照してください。

関連コンテンツ

• Microsoft Graph API で Postman を使用する