グループ管理

IMは、一般的なユースケースに応じて、デフォルトでフレンドワークグループ(Work)、知らない人とのソーシャルグループ(Public)、臨時ミーティンググループ(Meeting)、ライブブロードキャストグループ(AVChatRoom)、およびコミュニティ(Community)などのグループタイプが設定されています。詳細については、(https://intl.cloud.tencent.com/document/product/1047/33529)をご参照ください。
グループについては、次の操作を実行できます：
グループ操作
説明
備考
グループ作成
新しいグループを作成し、グループタイプ、グループ名、参加するユーザーのリストを指定できます。作成が成功した後にグループIDが返されます。グループIDはグループの固有フラグにより識別され、グループIDによってメッセージの送受信など、その他のグループ操作を実行できます。
各Appの1日あたりの純消費グループの制限は10,000です。
グループ転送
グループマスターのIDを他人に変更します。
App管理者はREST APIを介してグループを転送できますが、それ以外、グループを転送できるのはグループマスターのみです。
グループ解散
Appで作成したグループを解散します。グループが解散されるとき、グループの元のメンバー全員が、グループ解散というシステムメッセージが受信します。
App管理者はREST APIインターフェースを呼び出して、任意のグループを解散できます。App側でのグループ解散の権限は、メンバーのロールによって制限されます。グループマスターのみが、
知らない人とのソーシャルグループ(Public)、臨時ミーティンググループ(Meeting)、ライブブロードキャストグループ(AVChatRoom)、コミュニティ(Community)のグループを解散できます。
グループの誰もフレンドワークグループを解散できません。
ご注意：
グループを作成するとき、IMには、@TGS#で始まるデフォルトのグループIDが割り当てられます。ただし、ユーザー指定のグループIDもサポートします。詳細については、カスタムグループIDをご参照ください。
グループを作成した後、グループマスターが配置されている端末は、マルチ端末のグループ同期を維持するために、グループ作成のシステムメッセージを受信します（1つの端末がグループを作成した後、すべての端末はグループが作成されたことをすぐに認識できます）。
グループ情報管理
グループ情報は、グループ名、紹介、お知らせ、グループマスターなどを含む単一グループディメンションの属性、およびグループディメンションのカスタムフィールドを指します。
グループ情報管理
説明
備考
グループ情報取得
グループの基本情報をプルします。カスタム情報をプルしたい場合は、プルフィールド設定のインターフェースから設定できます
グループメンバーによるグループ情報取得：メンバーはこのグループ情報を取得します。
非グループメンバーによるグループ情報取得：非グループメンバーはグループ情報を取得する場合、公開情報のみを取得できます。
グループ内の自分情報の取得：すべてのグループ内の自分情報を取得できます。また、単一のグループ内の自分情報を取得できます。
グループ内の特定の個人情報の取得：ライブブロードキャストグループ（AVChatRoom）は、グループメンバーのデータ情報を保存せず、グループメンバーの個人データの取得をサポートしません。
グループ情報変更
グループ名、グループ紹介、グループのお知らせ、グループのプロファイルフォト、グループ名刺、グループ追加オプション、グループディメンションのカスタムフィールド、ユーザーのグループID、グループメンバーディメンションのカスタムフィールド、およびグループメッセージ受信オプションを変更できます
現在、Appはコンソールでグループ名、紹介、お知らせ、プロファイルフォトURLの変更コールバックを自己構成できます。他のグループ情報（グループディメンションのカスタムフィールドを含む）の変更コールバックを有効にする必要がある場合、チケットを提出して申請してください。
グループメンバー/グループ管理
グループメンバーの管理には、次の2つが含まれています：
メッセージ受信オプションなど、ユーザーのみが取得/設定できるグループ内の自分情報を取得/変更します。
グループメンバーのID、グループへの参加時刻、最後のメッセージの時刻、グループ名刺、およびグループメンバーディメンションのカスタム情報を含む、他のグループメンバーの情報を取得/変更します。
グループメンバー管理
説明
備考
グループメンバー情報取得
自分または他のグループメンバーの情報を取得します。
グループメンバーのID、グループへの参加時刻、最後のメッセージの時刻、グループ名刺、およびグループメンバーディメンションのカスタム情報を取得できます。
グループメンバー情報変更
グループマスター、管理者、またはメンバーは、対応するグループメンバー情報を変更できます。
グループマスターまたは管理者は、グループ内のIDの変更（管理者の設定/キャンセル）、発言禁止、グループ名刺の変更、グループメンバーディメンションのカスタムフィールドを含む、他のグループメンバーの情報を変更できます。
グループメンバーは、メッセージ受信オプション、グループ名刺、グループメンバーディメンションのカスタムフィールドを含む、グループ内の自分情報を積極的に変更します。
グループへの招待
グループへの招待は、他のユーザーを特定のグループに引き込むことです。
フレンドワークグループ(Work)では、グループメンバーは誰でも他の人をグループに招待し、招待者の同意なしに直接グループに参加できます。
知らない人とのソーシャルグループ(Public)と臨時ミーティンググループ(Meeting)ではデフォルトで、App管理者のみが他のユーザーをグループに招待できます。
ライブブロードキャストグループ(AVChatRoom)では、誰でも他の人をグループに招待することは許可されていません。
コミュニティ(Community)では、グループメンバーは誰でも他の人をグループに招待し、招待者の同意なしに直接グループに参加できます。
グループへの参加申請
グループへの参加申請は、ユーザーがIM SDKを介してグループに積極的に参加する操作です。
フレンドワークグループ(Work)は、グループへの参加を申請できません。エラーが直接返されます。
コミュニティ(Community)の申請は、承認なしに直接グループに参加できます。
他の組み込まれたグループタイプの場合、グループへの参加申請の処理結果は、グループ情報のApplyJoinOptionフィールドによって決定されます。
グループメンバー削除
グループメンバー削除は、グループマスターまたはグループ管理者がグループからグループメンバーを削除するために実行する操作です。
管理者またはグループマスターがユーザーをグループから削除すると、削除されたユーザーはグループから削除されたことを示すシステムメッセージを受け取り、グループ内の他のメンバーもこのユーザーがグループから削除されたことを示すイベントメッセージを受け取ります。
グループからの積極的な退出
グループからの積極的な退出は、グループメンバーが積極的にグループから退出する操作です。
グループメンバーが積極的にグループから退出すると、積極的にグループから退出するユーザーは、グループから積極的に退出することを示すシステムメッセージを受け取り、グループ内の他のメンバーはこのユーザーがグループから退出したことを示すイベントメッセージを受け取ります。
ユーザーの参加するグループの取得
現在のユーザーが参加するすべてのグループリストをプルし、返される情報には一部の基本情報のみが含まれます。
グループ情報を取得するグループメンバーの機能に応じて、詳細なグループ情報を取得できます。
グループ保留情報リスト
グループ保留情報は、通常、承認が必要なすべてのグループ関連の操作を指します。
グループ保留リストをプルし、グループ保留既読を報告し、グループ保留情報を処理（承認または拒否）できます。1人のユーザーの保留リストには、最大50個を保存できます。
﻿

グループ情報管理
グループメンバー/グループ管理

グループ操作	説明	備考
グループ作成	新しいグループを作成し、グループタイプ、グループ名、参加するユーザーのリストを指定できます。作成が成功した後にグループIDが返されます。グループIDはグループの固有フラグにより識別され、グループIDによってメッセージの送受信など、その他のグループ操作を実行できます。	各Appの1日あたりの純消費グループの制限は10,000です。
グループ転送	グループマスターのIDを他人に変更します。	App管理者はREST APIを介してグループを転送できますが、それ以外、グループを転送できるのはグループマスターのみです。
グループ解散	Appで作成したグループを解散します。グループが解散されるとき、グループの元のメンバー全員が、グループ解散というシステムメッセージが受信します。	App管理者はREST APIインターフェースを呼び出して、任意のグループを解散できます。App側でのグループ解散の権限は、メンバーのロールによって制限されます。グループマスターのみが、知らない人とのソーシャルグループ(Public)、臨時ミーティンググループ(Meeting)、ライブブロードキャストグループ(AVChatRoom)、コミュニティ(Community)のグループを解散できます。グループの誰もフレンドワークグループを解散できません。

グループメンバー管理	説明	備考
グループメンバー情報取得	自分または他のグループメンバーの情報を取得します。	グループメンバーのID、グループへの参加時刻、最後のメッセージの時刻、グループ名刺、およびグループメンバーディメンションのカスタム情報を取得できます。
グループメンバー情報変更	グループマスター、管理者、またはメンバーは、対応するグループメンバー情報を変更できます。	グループマスターまたは管理者は、グループ内のIDの変更（管理者の設定/キャンセル）、発言禁止、グループ名刺の変更、グループメンバーディメンションのカスタムフィールドを含む、他のグループメンバーの情報を変更できます。グループメンバーは、メッセージ受信オプション、グループ名刺、グループメンバーディメンションのカスタムフィールドを含む、グループ内の自分情報を積極的に変更します。
グループへの招待	グループへの招待は、他のユーザーを特定のグループに引き込むことです。	フレンドワークグループ(Work)では、グループメンバーは誰でも他の人をグループに招待し、招待者の同意なしに直接グループに参加できます。知らない人とのソーシャルグループ(Public)と臨時ミーティンググループ(Meeting)ではデフォルトで、App管理者のみが他のユーザーをグループに招待できます。ライブブロードキャストグループ(AVChatRoom)では、誰でも他の人をグループに招待することは許可されていません。コミュニティ(Community)では、グループメンバーは誰でも他の人をグループに招待し、招待者の同意なしに直接グループに参加できます。
グループへの参加申請	グループへの参加申請は、ユーザーがIM SDKを介してグループに積極的に参加する操作です。	フレンドワークグループ(Work)は、グループへの参加を申請できません。エラーが直接返されます。コミュニティ(Community)の申請は、承認なしに直接グループに参加できます。他の組み込まれたグループタイプの場合、グループへの参加申請の処理結果は、グループ情報のApplyJoinOptionフィールドによって決定されます。
グループメンバー削除	グループメンバー削除は、グループマスターまたはグループ管理者がグループからグループメンバーを削除するために実行する操作です。	管理者またはグループマスターがユーザーをグループから削除すると、削除されたユーザーはグループから削除されたことを示すシステムメッセージを受け取り、グループ内の他のメンバーもこのユーザーがグループから削除されたことを示すイベントメッセージを受け取ります。
グループからの積極的な退出	グループからの積極的な退出は、グループメンバーが積極的にグループから退出する操作です。	グループメンバーが積極的にグループから退出すると、積極的にグループから退出するユーザーは、グループから積極的に退出することを示すシステムメッセージを受け取り、グループ内の他のメンバーはこのユーザーがグループから退出したことを示すイベントメッセージを受け取ります。
ユーザーの参加するグループの取得	現在のユーザーが参加するすべてのグループリストをプルし、返される情報には一部の基本情報のみが含まれます。	グループ情報を取得するグループメンバーの機能に応じて、詳細なグループ情報を取得できます。
グループ保留情報リスト	グループ保留情報は、通常、承認が必要なすべてのグループ関連の操作を指します。	グループ保留リストをプルし、グループ保留既読を報告し、グループ保留情報を処理（承認または拒否）できます。1人のユーザーの保留リストには、最大50個を保存できます。