服务端 API/群组/群组管理/资源介绍
# 资源介绍
## 资源定义
Lark中的聊天群组。

## 字段说明
以下字段并非所有类型的群组都具备，部分群组可能缺失某些字段

名称 | 类型 | 描述
---|---|---
 chat_id | string | 群 ID，详情参见[群ID 说明](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)
 avatar | string | 群头像 URL
 name | string | 群名称
 description | string | 群描述
 i18n_names | i18n_names | 群国际化名称
 ∟ zh_cn | string | 中文名
 ∟ en_us | string | 英文名
 ∟ ja_jp | string | 日文名
&nbsp;owner_id | string | 群主 ID，ID值与 owner_id_type 对应。<br>不同 ID 的说明参见 [用户相关的 ID 概念](https://open.larksuite.com/document/home/user-identity-introduction/introduction)。<br>当群主是机器人时，该字段不返回
&nbsp;owner_id_type | string | 群主 ID 对应的ID类型，取值为：`open_id`、`user_id`、`union_id`其中之一。不同 ID 的说明参见 [用户相关的 ID 概念](https://open.larksuite.com/document/home/user-identity-introduction/introduction)。<br>当群主是机器人时，该字段不返回
&nbsp;add_member_permission | string | 拉 用户或机器人 入群权限<br>**可选值有**：<br>- `only_owner`：仅群主和管理员<br>- `all_members`：所有成员
&nbsp;share_card_permission | string | 群分享权限<br>**可选值有**：<br>- `allowed`：允许<br>- `not_allowed`：不允许
&nbsp;at_all_permission | string | at 所有人权限<br>**可选值有**：<br>- `only_owner`：仅群主和管理员<br>- `all_members`：所有成员
&nbsp;edit_permission | string | 群编辑权限<br>**可选值有**：<br>- `only_owner`：仅群主和管理员<br>- `all_members`：所有成员
&nbsp;chat_mode | string | 群模式<br>**可选值有**：<br>- `group`：群组<br>- `topic`：话题群<br>- `p2p`：单聊
&nbsp;group_message_type | string | 群消息形式<br>**可选值有**：<br>- `chat`：对话消息<br>- `thread`：话题消息
&nbsp;chat_type | string | 群类型<br>**可选值有**：<br>- `private`：私有群<br>- `public`：公开群
&nbsp;chat_tag | string | 群标签，如有多个，则按照下列顺序返回第一个<br>**可选值有**：<br>- `inner`：内部群<br>- `tenant`：公司群<br>- `department`：部门群<br>- `edu`：教育群<br>- `meeting`：会议群<br>- `customer_service`：客服群
&nbsp;external | boolean | 是否是外部群
&nbsp;tenant_key | string | 租户在Lark上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
&nbsp;join_message_visibility | string | 入群消息可见性<br>**可选值有**：<br>- `only_owner`：仅群主和管理员可见<br>- `all_members`：所有成员可见<br>- `not_anyone`：任何人均不可见
&nbsp;leave_message_visibility | string | 出群消息可见性<br>**可选值有**：<br>- `only_owner`：仅群主和管理员可见<br>- `all_members`：所有成员可见<br>- `not_anyone`：任何人均不可见
&nbsp;membership_approval | string | 加群审批<br>**可选值有**：<br>- `no_approval_required`：无需审批<br>- `approval_required`：需要审批
&nbsp;moderation_permission | string | 发言权限<br>**可选值有**：<br>- `only_owner`：仅群主和管理员<br>- `all_members`：所有成员<br>- `moderator_list`：指定群成员

### 数据示例
```json
{
        "chat_id": "oc_a0553eda9014c201e6969b478895c230",
        "avatar": "https://p3-lark-file.byteimg.com/img/lark-avatar-staging/default-avatar_44ae0ca3-e140-494b-956f-78091e348435~100x100.jpg",
        "name": "测试群名称",
        "description": "测试群描述",
        "i18n_names": {
            "zh_cn": "群聊",
            "en_us": "group chat",
            "ja_jp": "グループチャット"
        },
        "owner_id": "4d7a3c6g",
        "owner_id_type": "user_id",
        "add_member_permission": "all members",
        "share_card_permission": "allowed",
        "at_all_permission": "all members",
        "edit_permission": "all members",
        "group_message_type": "chat",
        "chat_mode": "group",
        "chat_type": "private",
        "chat_tag": "inner",
        "external": false,
        "tenant_key": "736588c9260f175e",
        "join_message_visibility": "all_members",
        "leave_message_visibility": "all_members",
        "membership_approval": "no_approval_required",
        "moderation_permission": "all_members",
}
```

## 群 ID 说明
参见文档 [群ID 说明](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)