Create Channel(チャンネルの作成)

Microsoft Teamsチャンネルを作成します。

入力

フィールド定義タイプ必須
Team(チーム)
IDチームの一意のID。文字列TRUE
Channel(チャンネル)
Display Name(表示名)チャンネルの表示名。最大文字数は50です。文字列TRUE
Description(説明)チャンネルの説明。 文字列FALSE
Is Favorite By Default(デフォルトのお気に入り)Trueの場合、チームのすべてのメンバーでこのチャンネルが自動的にfavoriteとマークされます。 ブーリアンFALSE
Membership Type(メンバーシップタイプ) チャンネルのタイプ。取り得る値は次のとおりです。
  • Standard - チャンネルは親チームの全メンバーのリストを継承します。

  • Private - チャンネルは親チームの全メンバーのサブセットをメンバーとして取ることができます。チームあたりのプライベートチャンネル数は30に制限されます。

  • メンバーを追加できるのはプライベートチャンネルのみです。

  • メンバーを削除できるのはプライベートチャンネルからのみです。

ドロップダウンTRUE
User IDs(ユーザーID)

ユーザーの一意識別子。

  • ユーザーを追加できるのはプライベートチャンネルのみです。

  • ユーザーを削除できるのはプライベートチャンネルからのみです。

文字列のリストTRUE

メンバーシップタイプでは、プライベートチャンネルを作成するときにチーム全体がチャンネルのメンバーとして追加されます。しばらくすると、Workflows接続を作成したユーザーがチャンネルの所有者として割り当てられます。

出力

フィールド定義タイプ
IDチャンネルの一意のID。文字列
Display Name(表示名)チャンネルの表示名。文字列
Description(説明)チャンネルの説明。 文字列
Email(メール)チャンネルにメッセージを送信するためのメールアドレス。 文字列
Is Favorite By Default(デフォルトのお気に入り)チームのすべてのメンバーでこのチャンネルが自動的にfavoriteと記されるかどうかを指定します。 ブーリアン
Web URLMicrosoft Teamsクライアント内のチームにアクセスするハイパーリンク。Microsoft Teamsクライアントでチームを右クリックし、[Get link to team(チームへのリンクを取得)]を選択すると得られるURLです。文字列
Membership Type(メンバーシップタイプ)チャンネルのタイプを指定します。取り得る値はStandardPrivateです。文字列
Created Date Time(作成日時)チャンネルの作成日時。日時
Status Code(ステータスコード)操作の結果。HTTPステータスコードはコネクタによって返され、カードによって実行されたアクションが成功したか失敗したかを示します。以下に例を挙げます。
  • 201 Createdステータスコードは、新しいリソースが作成された場合の成功を示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、「 HTTPステータスコード」を参照してください。

数値

追加情報

  • ユーザーはプライベートチャンネルのみに追加してください。

  • プライベートチャンネルに追加されるすべてのユーザーは、事前にチームのメンバーになっている必要があります。

  • プライベートチャンネルから削除できるのは、事前にプライベートチャンネルに追加されたユーザーのみです。

  • カードに渡されるすべてのユーザーIDがプライベートチャンネルの所有者となります。

  • Workflows接続の作成に使用されたユーザーアカウントは、コネクタによってユーザーリストに自動的に追加されます。接続ユーザーのユーザーIDに渡す必要はありません。

関連項目

Microsoft Teamsコネクタ

Okta Workflowsの要素について

Microsoft Teams APIの概要