チャネルを作成するCreate Channel

重要

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.

要求の本文で指定されているように、Microsoft Team に新しいチャネルを作成します。Create a new channel in a Microsoft Team, as specified in the request body.

: アプリケーションのアクセス許可とこの API には既知の問題があります。Note: There is a known issue with application permissions and this API. 詳細については、「既知の問題の一覧」を参照してください。For details, see the known issues list.

アクセス許可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

: この API は、管理者のアクセス許可をサポートします。Note: This API supports admin permissions. グローバル管理者と Microsoft Teams サービス管理者は、メンバーではないチームにアクセスできます。Global admins and Microsoft Teams service admins can access teams that they are not a member of.

HTTP 要求HTTP request

POST /teams/{id}/channels

要求ヘッダーRequest headers

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

要求本文Request body

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

応答Response

成功した場合、このメソッドは 201 Created 応答コードと チャンネル オブジェクトを応答本文で返します。If successful, this method returns 201 Created response code and channel object in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

POST https://graph.microsoft.com/beta/teams/{id}/channels
Content-type: application/json

{
  "displayName": "Architecture Discussion",
  "description": "This channel is where we debate all future architecture plans"
}

応答Response

以下は、応答の例です。Here is an example of the response.

注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。Note: The response object shown here may be truncated for brevity. 実際の呼び出しではすべてのプロパティが返されます。All of the properties will be returned from an actual call.

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

{
  "id": "id-value",
  "displayName": "Architecture Discussion",
  "description": "This channel is where we debate all future architecture plans"
}