チームを作成するCreate team

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

新しいチームを作成します。Create a new team.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Group.ReadWrite.AllGroup.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication Group.ReadWrite.AllGroup.ReadWrite.All

HTTP 要求HTTP request

POST /teams

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

要求本文Request body

要求本文で、team オブジェクトの JSON 表記を指定します。In the request body, supply a JSON representation of a team object.

応答Response

成功すると、この API は teamsAsyncOperation へのリンクを含む 202 Accepted 応答を返します。If successful, this API returns a 202 Accepted response containing a link to the teamsAsyncOperation.

Examples

例 1: 委任されたアクセス許可Example 1: Delegated permissions

最低限の要求の例を次に示します。The following is an example of a minimal request. 他のプロパティを省略することにより、クライアントは template で表される事前に定義されたテンプレートから暗黙的に既定値を使用します。By omitting other properties, the client is implicitly taking defaults from the pre-defined template represented by template.

要求Request

POST https://graph.microsoft.com/beta/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('standard')",
  "displayName": "My Sample Team",
  "description": "My Sample Team’s Description"
}
応答Response
HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /teams/{teamId}/operations/{operationId}
Content-Location: /teams/{teamId}
{
}

例 2:アプリケーションのアクセス許可Example 2: Application permissions

アプリケーションのアクセス許可を使用した最小限の要求の例を次に示します。The following is an example of a minimal request using application permissions. 他のプロパティを省略することにより、クライアントは template で表される事前に定義されたテンプレートから暗黙的に既定値を使用します。By omitting other properties, the client is implicitly taking defaults from the predefined template represented by template. アプリケーションのアクセス許可で要求を発行する際には、ユーザーowners コレクションで指定されている必要があります。When issuing a request with application permissions, a user must be specified in the owners collection.

要求Request

POST https://graph.microsoft.com/beta/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('standard')",
  "displayName": "My Sample Team",
  "description": "My Sample Team’s Description",
  "owners@odata.bind": [
    "https://graph.microsoft.com/beta/users('userId')"
  ]
}

応答Response

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

例 3: 委任されたアクセス許可を使用して、複数のチャネル、インストールされたアプリ、および固定されたタブを持つチームを作成するExample 3: Create a team with multiple channels, installed apps, and pinned tabs using delegated permissions

完全なペイロードの要求を次に示します。The following is a request with a full payload. クライアントは基本テンプレートの値を上書きして、specialization の検証規則で許容される範囲に配列値のアイテムを追加できます。The client can override values in the base template and add to array-valued items to the extent allowed by validation rules for the specialization.

要求Request

POST https://graph.microsoft.com/beta/teams
Content-Type: application/json
{
    "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('standard')",
    "visibility": "Private",
    "displayName": "Sample Engineering Team",
    "description": "This is a sample engineering team, used to showcase the range of properties supported by this API",
    "channels": [
        {
            "displayName": "Announcements 📢",
            "isFavoriteByDefault": true,
            "description": "This is a sample announcements channel that is favorited by default. Use this channel to make important team, product, and service announcements."
        },
        {
            "displayName": "Training 🏋️",
            "isFavoriteByDefault": true,
            "description": "This is a sample training channel, that is favorited by default, and contains an example of pinned website and YouTube tabs.",
            "tabs": [
                {
                    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.web')",
                    "name": "A Pinned Website",
                    "configuration": {
                        "contentUrl": "/microsoftteams/microsoft-teams"
                    }
                },
                {
                    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.youtube')",
                    "name": "A Pinned YouTube Video",
                    "configuration": {
                        "contentUrl": "https://tabs.teams.microsoft.com/Youtube/Home/YoutubeTab?videoId=X8krAMdGvCQ",
                        "websiteUrl": "https://www.youtube.com/watch?v=X8krAMdGvCQ"
                    }
                }
            ]
        },
        {
            "displayName": "Planning 📅 ",
            "description": "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu.",
            "isFavoriteByDefault": false
        },
        {
            "displayName": "Issues and Feedback 🐞",
            "description": "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu."
        }
    ],
    "memberSettings": {
        "allowCreateUpdateChannels": true,
        "allowDeleteChannels": true,
        "allowAddRemoveApps": true,
        "allowCreateUpdateRemoveTabs": true,
        "allowCreateUpdateRemoveConnectors": true
    },
    "guestSettings": {
        "allowCreateUpdateChannels": false,
        "allowDeleteChannels": false
    },
    "funSettings": {
        "allowGiphy": true,
        "giphyContentRating": "Moderate",
        "allowStickersAndMemes": true,
        "allowCustomMemes": true
    },
    "messagingSettings": {
        "allowUserEditMessages": true,
        "allowUserDeleteMessages": true,
        "allowOwnerDeleteMessages": true,
        "allowTeamMentions": true,
        "allowChannelMentions": true
    },
    "discoverySettings": {
        "showInTeamsSearchAndSuggestions": true
    },
    "installedApps": [
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.vsts')"
        },
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('1542629c-01b3-4a6d-8f76-1938b779e48d')"
        }
    ]
}

応答Response

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

例 4: グループからチームを作成するExample 4: Create a team from group

次の例では、groupId がわかっている場合にグループから新しいチームを作成する方法を示します。The following example shows how you can create a new team from a group, given a groupId.

この呼び出しに関する注意点:A few thing to note about this call:

  • チームを作成するには、作成するグループに少なくとも 1 人の所有者がいる必要があります。In order to create a team, the group you're creating it from must have a least one owner.
  • 作成されるチームは、グループの表示名、visibility、specialization、および所有者を常に継承します。The team that's created will always inherit from the group's display name, visibility, specialization, and owners. そのため、**group@odata.bind** プロパティを使用してこの呼び出しを行う場合、チームの displayNamevisibilityspecialization、または **owners@odata.bind** プロパティを含めるとエラーが発生します。Therefore, when making this call with the **group@odata.bind** property, the inclusion of team displayName, visibility, specialization, or **owners@odata.bind** properties will return an error.
  • グループが作成されて 15 分以上経っていない場合は、レプリケーションの遅延のためにチーム作成の呼び出しが失敗し、404 エラー コードが表示される可能性があります。If the group was created less than 15 minutes ago, it's possible for the Create team call to fail with a 404 error code due to replication delays. 呼び出しと呼び出しの間に 10 秒の遅延を設けて、チーム作成の呼び出しを 3 回再試行することをお勧めします。We recommend that you retry the Create team call three times, with a 10 second delay between calls.

要求Request

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

応答Response

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

例 5: 複数のチャネル、インストールされたアプリ、および固定されたタブを持つチームをグループから作成するExample 5: Create a team from a group with multiple channels, installed apps, and pinned tabs

以下に、拡張プロパティを持つ既存のグループを変換する要求を示します。これにより、複数のチャネル、インストールされたアプリ、固定されたタブを持つチームが作成されます。The following is a request that converts an existing group with extended properties which will create the team with multiple channels, installed apps, and pinned tabs.

サポートされているベース テンプレートとサポートされているプロパティの詳細については、「Teams テンプレートの使用を開始する」を参照してください。To learn more about supported base template types and supported properties, see Get started with Teams templates.

要求Request

POST https://graph.microsoft.com/beta/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('standard')",
  "group@odata.bind": "https://graph.microsoft.com/v1.0/groups('groupId')",
  "channels": [
        {
            "displayName": "Class Announcements 📢",
            "isFavoriteByDefault": true
        },
        {
            "displayName": "Homework 🏋️",
            "isFavoriteByDefault": true,
        }
    ],
    "memberSettings": {
        "allowCreateUpdateChannels": false,
        "allowDeleteChannels": false,
        "allowAddRemoveApps": false,
        "allowCreateUpdateRemoveTabs": false,
        "allowCreateUpdateRemoveConnectors": false
    },
    "installedApps": [
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.vsts')"
        },
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('1542629c-01b3-4a6d-8f76-1938b779e48d')"
        }
    ]
}

応答Response

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

例 6: 非標準のベース テンプレート タイプを使用してチームを作成するExample 6: Create a team with a non-standard base template type

ベース テンプレート タイプとは、Microsoft が特定の業界向けに作成した特別なテンプレートです。Base template types are special templates that Microsoft created for specific industries. 多くの場合、これらのベース テンプレートにはストアでは入手できない独自のアプリおよび Microsoft Teams のテンプレートでまだ個別にサポートされていないチームのプロパティが含まれます。These base templates often contain proprietary apps that aren't available in the store and team properties that are not yet supported individually in Microsoft Teams templates.

非標準のベース テンプレートからチームを作成するには、要求本文で template@odata.bind プロパティを standard から使用する特定のベース テンプレートへのポイントに変更します。To create a team from a non-standard base template, you’ll want to change the template@odata.bind property in the request body from standard to point to the specific base template you’d like to create.

サポートされているベース テンプレートの詳細については、「Teams テンプレートの使用を開始する」を参照してください。To learn more about supported base template types, see Get started with Teams templates.

要求Request

POST https://graph.microsoft.com/beta/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('educationClass')",
  "displayName": "My Class Team",
  "description": "My Class Team’s Description"
}

応答Response

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

例 7: 拡張プロパティを含んだ非標準のベース テンプレート タイプを使用してチームを作成するExample 7: Create a team with a non-standard base template type with extended properties

ベース テンプレート タイプは追加のプロパティを使用して拡張することができ、既存のベース テンプレートを元にチームの追加の設定、チャンネル、アプリ、またはタブを設定してベース テンプレートを作成できます。Base template types can be extended with additional properties, enabling you to build on an existing base template with additional team settings, channels, apps, or tabs.

サポートされているベース テンプレートとサポートされているプロパティの詳細については、「Teams テンプレートの使用を開始する」を参照してください。To learn more about supported base template types and supported properties, see Get started with Teams templates.

要求Request

POST https://graph.microsoft.com/beta/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('educationClass')",
  "displayName": "My Class Team",
  "description": "My Class Team’s Description",
  "channels": [
        {
            "displayName": "Class Announcements 📢",
            "isFavoriteByDefault": true
        },
        {
            "displayName": "Homework 🏋️",
            "isFavoriteByDefault": true,
        }
    ],
    "memberSettings": {
        "allowCreateUpdateChannels": false,
        "allowDeleteChannels": false,
        "allowAddRemoveApps": false,
        "allowCreateUpdateRemoveTabs": false,
        "allowCreateUpdateRemoveConnectors": false
    },
    "installedApps": [
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.vsts')"
        },
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('1542629c-01b3-4a6d-8f76-1938b779e48d')"
        }
    ]
}

応答Response

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

関連項目See also