Microsoft Teams API を使用してチームを作成し、メンバーを管理する

  • [アーティクル]

Microsoft Graph の Microsoft Teams API を使用して、複数の方法でチームを作成することができます。 ここでは、最適な結果を得るためのおすすめの方法を説明します。

チームを作成する

すべてのチームは、Microsoft 365 グループにサポートｓれています。 Microsoft Graph を使用して新しいチームを作成する際に、すばやくチームを立ち上げる一番早い方法は、新しい Microsoft 365 グループ、すべての所有者、メンバーをセットアップし、それをチームに変換することです。

  1. ［グループを作成する］ 操作から ［Microsoft 365 グループ ］を作成します。 所有者とメンバーを指定できます。 手順 2 で説明したように、新しく作成したグループの正しい所有者であることを確認します。

    このグループのチームを作成するには、次のようにプロパティの値を設定する必要があります。

    • groupTypes = { "Unified" }
    • mailEnabled = true
    • securityEnabled = false
    POST /groups
{
    "displayName":"Flight 157",
    "mailNickname":"flight157",
    "description":"Everything about flight 157",
    "visibility":"Private",
    "groupTypes":["Unified"],
    "mailEnabled":true,
    "securityEnabled":false,
    "members@odata.bind":[
        "https://graph.microsoft.com/v1.0/users/bec05f3d-a818-4b58-8c2e-2b4e74b0246d",
        "https://graph.microsoft.com/v1.0/users/ae67a4f4-2308-4522-9021-9f402ff0fba8",
        "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783",
        "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133"
    ],
    "owners@odata.bind":[
        "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133",
        "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783"
    ]
}

    次の例は応答を示しています。

    注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。 実際の呼び出しではすべてのプロパティが返されます。

    HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
    "id":"b7f968af-ca51-42f6-a77e-82c7147bc8f2"
}

  2. グループに複数の所有者がいることを確認します。 所有者を追加するには、所有者を追加する操作を行います。 所有者はサービスアカウントではなく、実際のユーザーアカウントである必要があります。 所有者が2人がいると、一方の所有者が退職した場合や、チーム管理を実行できない場合に対応できます。

  3. 手順1で メンバーを全員登録しなかった場合は、［メンバーの追加］操作を使用して、すべてのメンバー および必要に応じてゲスト、をグループに追加します。 複数のメンバーを追加する場合は、各追加操作後に 1 秒遅延を追加します。

  4. 手順 1 を完了してから 15 分程でグループが正常に作成された後、グループからチームを作成する 操作を使用して、Microsoft Teams のチームを作成します。 エラーが発生した場合、グループの作成プロセスが完了していない可能性があります。数分間待ってみてください。

    POST https://graph.microsoft.com/v1.0/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
  "group@odata.bind": "https://graph.microsoft.com/v1.0/groups('groupId')"
}

    次の例は応答を示しています。

    注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。 実際の呼び出しではすべてのプロパティが返されます。

    HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /teams/{teamId}/operations/{operationId}
Content-Location: /teams/{teamId}
{
}

    作成したチームには、グループと同じ ID が割り当てられます。

  5. このプロセスが完了すると、すべての所有者とメンバーは、新しく作成されたチームをチームクライアントで確認できるようになります。

メンバーの追加または管理

チームが作成された後にメンバーを追加するには、［メンバーの追加］操作をします。 追加操作の間に 1 秒の遅延を追加することをお勧めします。 メンバーシップの変更に関しては、次の点にご注意ください。

  1. Microsoft 365 グループに対して行われたメンバーシップの変更は、通常 24 時間 (場合によってはそれ以上) を必要とするバックグラウンド同期メカニズムによって、Teams と同期します。

  2. このバックグラウンドプロセスは、チーム内の1人以上のユーザー（所有者もしくはメンバー）が Teams デスクトップクライアントでアクティブになっている場合にのみ実行されます。 チームアプリケーションを起動したり実行することはアクティビティになります。ユーザーは、特に変更されいているチームにアクセスをする必要はありません。

    注:

    Teams のモバイルクライアントは、メンバーシップの同期を実行しません。このバックグラウンドプロセスが円滑に動作するように、少なくとも 1 人のユーザーがデスクトップクライアントにログオンしている必要があります。

検証のためのチェックリスト

チームを作成したら、次のチェックリストを使用して、チームが正常に作成されたことを確認します。

チーム作成の検証

  1. チームをサポートする Microsoft 365 グループが、Microsoft Entra IDまたは Microsoft 365 管理センターを介して作成されていることを確認します。

  2. チームの管理ポータルで、チームの作成が成功したことを確認します。

  3. チーム管理ポータルで、チームの所有者とメンバーが正しく表示されていることを確認します。

  4. Teams デスクトップ、または Web クライアントにサインインした後、所有者がチームを表示できることを確認します。

  5. Teams デスクトップ、または Web クライアントにサインインした後、メンバーがチームを表示できることを確認します。

メンバーの追加を検証する

  1. 新しいメンバーがMicrosoft Entra IDまたはMicrosoft 365 管理センターを介してグループに表示されることを確認します。

  2. 新しく追加されたメンバーが、Teams デスクトップ、または Web クライアントにサインインした後、チームを表示できることを確認します。

関連コンテンツ