From 350cc95f2ff66074b43367750032411924668af2 Mon Sep 17 00:00:00 2001 From: wenlingang Date: Fri, 17 Mar 2023 10:53:00 +0800 Subject: [PATCH] Fixed text autocorrect & Message Builder AtUser repeated return nil --- README.md | 104 +- README.zh.md | 90 +- card/card.go | 2 +- card/card_test.go | 20 +- changelog.md | 12 +- client.go | 24 +- core/httpclient.go | 6 +- core/httpserverext/httpserverext.go | 2 +- core/httpserverext/httpserverext_test.go | 2 +- event/dispatcher/calendar_event_dispatch.go | 12 +- event/dispatcher/contact_event_dispatch.go | 14 +- event/dispatcher/dispatcher.go | 8 +- event/dispatcher/dispatcher_test.go | 12 +- event/dispatcher/ext_event_dispatch.go | 48 +- event/dispatcher/helpdesk_event_dispatch.go | 2 +- event/dispatcher/im_event_dispatch.go | 24 +- .../dispatcher/meeting_room_event_dispatch.go | 6 +- event/dispatcher/vc_event_dispatch.go | 12 +- event/model.go | 12 +- sample/api/docx.go | 8 +- sample/api/im.go | 20 +- sample/apiall/approvalv4/preview_instance.go | 2 +- sample/apiall/attendancev1/search_group.go | 2 +- sample/apiall/baikev1/create_draft.go | 2 +- sample/apiall/baikev1/create_entity.go | 2 +- sample/apiall/baikev1/update_draft.go | 2 +- sample/apiall/baikev1/update_entity.go | 2 +- sample/apiall/bitablev1/create_appRole.go | 2 +- .../apiall/bitablev1/create_appTableView.go | 2 +- sample/apiall/bitablev1/update_appRole.go | 2 +- sample/apiall/blockv2/create_entity.go | 2 +- sample/apiall/blockv2/update_entity.go | 2 +- sample/apiall/contactv3/create_group.go | 2 +- .../drivev1/batchGetTmpDownloadUrl_media.go | 2 +- sample/apiall/drivev1/download_media.go | 2 +- sample/apiall/hirev1/create_note.go | 2 +- sample/apiall/hirev1/patch_ehrImportTask.go | 2 +- .../basicRecognize_image.go | 2 +- sample/apiall/taskv1/list_taskCollaborator.go | 2 +- sample/apiall/taskv1/list_taskFollower.go | 2 +- sample/apiall/taskv1/list_taskReminder.go | 2 +- sample/apiall/vcv1/create_roomLevel.go | 2 +- sample/apiall/vcv1/patch_roomLevel.go | 2 +- sample/callrawapi/api.go | 8 +- sample/card/card.go | 4 +- sample/mocksendcardaction/main.go | 8 +- sample/mocksendevent/main.go | 4 +- service/acs/v1/api.go | 32 +- service/acs/v1/event.go | 4 +- service/acs/v1/model.go | 64 +- service/admin/v1/api.go | 64 +- service/admin/v1/model.go | 800 ++++----- service/application/v6/api.go | 44 +- service/application/v6/event.go | 14 +- service/application/v6/ext_model.go | 22 +- service/application/v6/model.go | 320 ++-- service/approval/v4/api.go | 120 +- service/approval/v4/event.go | 2 +- service/approval/v4/ext_model.go | 48 +- service/approval/v4/model.go | 1146 ++++++------- service/attendance/v1/api.go | 130 +- service/attendance/v1/model.go | 248 +-- service/auth/v3/api.go | 20 +- service/auth/v3/model.go | 20 +- service/authen/v1/api.go | 12 +- service/authen/v1/model.go | 88 +- service/baike/v1/api.go | 52 +- service/baike/v1/model.go | 100 +- service/bitable/v1/api.go | 164 +- service/bitable/v1/model.go | 358 ++-- service/block/v2/api.go | 20 +- service/block/v2/model.go | 88 +- service/calendar/v4/api.go | 170 +- service/calendar/v4/event.go | 8 +- service/calendar/v4/model.go | 860 +++++----- service/contact/v3/api.go | 296 ++-- service/contact/v3/event.go | 26 +- service/contact/v3/ext_model.go | 24 +- service/contact/v3/model.go | 1258 +++++++------- service/corehr/v1/api.go | 4 +- service/corehr/v1/model.go | 804 ++++----- service/docx/v1/api.go | 60 +- service/docx/v1/model.go | 136 +- service/drive/v1/api.go | 248 +-- service/drive/v1/api_ext.go | 2 +- service/drive/v1/event.go | 16 +- service/drive/v1/model.go | 800 ++++----- service/ehr/v1/api.go | 10 +- service/ehr/v1/model.go | 32 +- service/event/v1/api.go | 4 +- service/event/v1/model.go | 6 +- service/face_detection/v1/api.go | 4 +- service/gray_test_open_sg/v1/api.go | 12 +- service/gray_test_open_sg/v1/model.go | 2 +- service/helpdesk/v1/api.go | 202 +-- service/helpdesk/v1/event.go | 8 +- service/helpdesk/v1/model.go | 674 ++++---- service/hire/v1/api.go | 118 +- service/hire/v1/event.go | 2 +- service/hire/v1/model.go | 962 +++++------ service/human_authentication/v1/api.go | 6 +- service/human_authentication/v1/model.go | 12 +- service/im/v1/api.go | 368 ++-- service/im/v1/event.go | 24 +- service/im/v1/ext_model.go | 85 +- service/im/v1/model.go | 1478 ++++++++--------- service/mail/v1/api.go | 168 +- service/mail/v1/model.go | 294 ++-- service/meeting_room/v1/event.go | 8 +- service/meeting_room/v1/ext_model.go | 10 +- service/meeting_room/v1/model.go | 24 +- service/okr/v1/api.go | 96 +- service/okr/v1/model.go | 662 ++++---- service/optical_char_recognition/v1/api.go | 4 +- service/optical_char_recognition/v1/model.go | 4 +- service/passport/v1/api.go | 4 +- service/passport/v1/model.go | 18 +- service/search/v2/api.go | 48 +- service/search/v2/model.go | 178 +- service/sheets/v3/api.go | 122 +- service/sheets/v3/model.go | 156 +- service/speech_to_text/v1/api.go | 10 +- service/speech_to_text/v1/model.go | 12 +- service/task/v1/api.go | 112 +- service/task/v1/event.go | 6 +- service/task/v1/model.go | 352 ++-- service/tenant/v2/api.go | 10 +- service/tenant/v2/model.go | 6 +- service/translation/v1/api.go | 8 +- service/translation/v1/model.go | 10 +- service/vc/v1/api.go | 230 +-- service/vc/v1/event.go | 36 +- service/vc/v1/model.go | 1444 ++++++++-------- service/wiki/v2/api.go | 86 +- service/wiki/v2/model.go | 224 +-- 135 files changed, 8775 insertions(+), 8776 deletions(-) diff --git a/README.md b/README.md index a3b529de..dc74ba15 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# 飞书开放接口SDK +# 飞书开放接口 SDK -旨在让开发者便捷的调用飞书开放API、处理订阅的消息事件、处理服务端推送的卡片行为。 +旨在让开发者便捷的调用飞书开放 API、处理订阅的消息事件、处理服务端推送的卡片行为。 ## 目录 @@ -9,31 +9,31 @@ - [安装](#安装) - [API Client](#api-client) - - [创建API Client](#创建api-client) - - [配置API Client](#配置api-client) + - [创建 API Client](#创建api-client) + - [配置 API Client](#配置api-client) -- [API调用](#api调用) +- [API 调用](#api调用) - [基本用法](#基本用法) - [设置请求选项](#设置请求选项) - - [原生API调用方式](#原生api调用方式) + - [原生 API 调用方式](#原生api调用方式) - [处理消息事件回调](#处理消息事件回调) - [基本用法](#基本用法-1) - [消息处理器内给对应租户发消息](#消息处理器内给对应租户发消息) - - [集成gin框架](#集成gin框架) + - [集成 gin 框架](#集成gin框架) - [安装集成包](#安装集成包) - [集成示例](#集成示例) - - [集成hertz框架](#集成hertz框架) + - [集成 hertz 框架](#集成hertz框架) - [处理卡片行为回调](#处理卡片行为回调) - [基本用法](#基本用法-2) - [返回卡片消息](#返回卡片消息) - [返回自定义消息](#返回自定义消息) - [卡片行为处理器内给对应租户发消息](#卡片行为处理器内给对应租户发消息) - - [集成gin框架](#集成gin框架) + - [集成 gin 框架](#集成gin框架) - [安装集成包](#安装集成包) - [集成示例](#集成示例) - - [ 集成hertz框架](#集成hertz框架-1) + - [ 集成 hertz 框架](#集成hertz框架-1) - [加入答疑群](#加入答疑群) @@ -49,7 +49,7 @@ go get -u github.com/larksuite/oapi-sdk-go/v3@v3.0.19 开发者在调用 API 前，需要先创建一个 API Client，然后才可以基于 API Client 发起 API 调用。 -### 创建API Client +### 创建 API Client - 对于自建应用，可使用下面代码来创建一个 API Client @@ -60,10 +60,10 @@ var client = lark.NewClient("appID", "appSecret") // 默认配置为自建应用 - 对于商店应用，需在创建 API Client 时，使用 lark.WithMarketplaceApp 方法指定 AppType 为商店应用。商店应用开发指南可 [点击这里查看](https://bytedance.feishu.cn/docx/DljadpCH3oMlnLxo1kpcS1vmnbg) ```go -var client = lark.NewClient("appID", "appSecret",lark.WithMarketplaceApp()) // 设置App为商店应用 +var client = lark.NewClient("appID", "appSecret",lark.WithMarketplaceApp()) // 设置 App 为商店应用 ``` -### 配置API Client +### 配置 API Client 创建 API Client 时，可对 API Client 进行一定的配置，比如我们可以在创建 API Client 时设置日志级别、设置 http 请求超时时间等等： @@ -112,7 +112,7 @@ var client = lark.NewClient("appID", "appSecret", lark.WithLogLevel(logLevel larkcore.LogLevel) -设置 API Client 的日志输出级别(默认为 Info 级别)，枚举值如下： +设置 API Client 的日志输出级别 (默认为 Info 级别)，枚举值如下： - LogLevelDebug - LogLevelInfo @@ -130,9 +130,9 @@ var client = lark.NewClient("appID", "appSecret", lark.WithLogger(logger larkcore.Logger) -设置API Client的日志器，默认日志输出到标准输出。 +设置 API Client 的日志器，默认日志输出到标准输出。 -开发者可通过实现下面的 Logger 接口，来设置自定义的日志器: +开发者可通过实现下面的 Logger 接口，来设置自定义的日志器： ```go type Logger interface { @@ -170,13 +170,13 @@ type Logger interface { lark.WithOpenBaseUrl(baseUrl string) -设置飞书域名，默认为FeishuBaseUrl，可用域名列表为： +设置飞书域名，默认为 FeishuBaseUrl，可用域名列表为： ```go // 飞书域名 var FeishuBaseUrl = "https://open.feishu.cn" -// Lark域名 +// Lark 域名 var LarkBaseUrl = "https://open.larksuite.com" ``` @@ -191,9 +191,9 @@ var LarkBaseUrl = "https://open.larksuite.com" lark.WithTokenCache(cache larkcore.Cache) -设置 token 缓存器，用来缓存 token 和 appTicket, 默认实现为内存。 +设置 token 缓存器，用来缓存 token 和 appTicket，默认实现为内存。 -如开发者想要定制 token 缓存器，需实现下面 Cache 接口: +如开发者想要定制 token 缓存器，需实现下面 Cache 接口： ```go type Cache interface { @@ -243,7 +243,7 @@ type Cache interface { lark.WithReqTimeout(time time.Duration) -设置 SDK 内置的 Http Client 的请求超时时间，默认为0代表永不超时。 +设置 SDK 内置的 Http Client 的请求超时时间，默认为 0 代表永不超时。 @@ -272,8 +272,8 @@ type HttpClient interface { -## API调用 -创建完毕 API Client，我们可以使用 ``Client.业务域.资源.方法名称`` 来定位具体的 API 方法，然后对具体的 API 发起调用。 +## API 调用 +创建完毕 API Client，我们可以使用 ``Client.业务域。资源.方法名称`` 来定位具体的 API 方法，然后对具体的 API 发起调用。 商店应用开发指南可 [点击这里查看](https://bytedance.feishu.cn/docx/DljadpCH3oMlnLxo1kpcS1vmnbg) ![](doc/find_method.jpg) @@ -309,7 +309,7 @@ func main() { //处理错误 if err != nil { - // 处理err + // 处理 err return } @@ -328,7 +328,7 @@ func main() { ### 设置请求选项 -开发者在每次发起 API 调用时，可以设置请求级别的一些参数，比如传递 UserAccessToken ,自定义 Headers 等： +开发者在每次发起 API 调用时，可以设置请求级别的一些参数，比如传递 UserAccessToken ，自定义 Headers 等： ```go import ( @@ -342,10 +342,10 @@ import ( ) func main() { - // 创建client + // 创建 client client := lark.NewClient("appID", "appSecret") - // 自定义请求headers + // 自定义请求 headers header := make(http.Header) header.Add("k1", "v1") header.Add("k2", "v2") @@ -358,12 +358,12 @@ func main() { Build(), ). Build(), - larkcore.WithHeaders(header), // 设置自定义headers + larkcore.WithHeaders(header), // 设置自定义 headers ) //处理错误 if err != nil { - // 处理err + // 处理 err return } @@ -417,7 +417,7 @@ func main() { larkcore.WithUserAccessToken(userAccessToken string) -设置用户token，当开发者需要以用户身份发起调用时，需要设置该选项的值。 +设置用户 token，当开发者需要以用户身份发起调用时，需要设置该选项的值。 @@ -430,7 +430,7 @@ func main() { larkcore.WithTenantAccessToken(tenantAccessToken string) -设置租户 token，当开发者自己维护租户 token 时（即创建Client时EnableTokenCache设置为了false），需通过该选项传递 租户 token。 +设置租户 token，当开发者自己维护租户 token 时（即创建 Client 时 EnableTokenCache 设置为了 false），需通过该选项传递 租户 token。 @@ -443,7 +443,7 @@ func main() { larkcore.WithTenantKey(tenantKey string) -设置租户 key, 当开发者开发商店应用时，必须设置该选项。 +设置租户 key，当开发者开发商店应用时，必须设置该选项。 @@ -464,7 +464,7 @@ func main() { -### 原生API调用方式 +### 原生 API 调用方式 有些老版本的开放接口，不能生成结构化的 API， 导致 SDK 内无法提供结构化的使用方式，这时可使用原生模式进行调用： @@ -509,7 +509,7 @@ func main() { // 处理请求结果 fmt.Println(resp.StatusCode) // http status code fmt.Println(resp.Header) // http header - fmt.Println(string(resp.RawBody)) // http body,二进制数据 + fmt.Println(string(resp.RawBody)) // http body，二进制数据 } ``` @@ -567,10 +567,10 @@ func main() { ![Console](doc/console.jpeg) -需要注意的是注册处理器时，比如使用 OnP2MessageReceiveV1 注册接受消息事件回调时，其中的P2为消息协议版本，当前飞书开放平台存在 [两种消息协议](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#8f960a4b) ，分别为1.0和2.0。 +需要注意的是注册处理器时，比如使用 OnP2MessageReceiveV1 注册接受消息事件回调时，其中的 P2 为消息协议版本，当前飞书开放平台存在 [两种消息协议](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#8f960a4b) ，分别为 1.0 和 2.0。 如下图开发者在注册消息处理器时，需从 [事件列表](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-list) 中查看自己需要的是哪种协议的事件。 -如果是1.0的消息协议，则注册处理器时，需要找以OnP1xxxx开头的。如果是2.0的消息协议，则注册处理器时，需要找以OnP2xxxx开头的。 +如果是 1.0 的消息协议，则注册处理器时，需要找以 OnP1xxxx 开头的。如果是 2.0 的消息协议，则注册处理器时，需要找以 OnP2xxxx 开头的。 @@ -580,7 +580,7 @@ func main() { 更多事件订阅示例：[./sample/event/event.go](./sample/event/event.go) ## 消息处理器内给对应租户发消息 -针对 ISV 开发者，如果想在消息处理器内给对应租户的用户发送消息，则需先从消息事件内获取租户 key,然后使用下面方式调用消息 API 进行消息发送： +针对 ISV 开发者，如果想在消息处理器内给对应租户的用户发送消息，则需先从消息事件内获取租户 key，然后使用下面方式调用消息 API 进行消息发送： ```go @@ -645,8 +645,8 @@ func main() { 更多事件订阅示例：[./sample/event/event.go](./sample/event/event.go) -### 集成Gin框架 -如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK进行集成。 +### 集成 Gin 框架 +如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK 进行集成。 要想把 SDK 集成已有 Gin 框架，开发者需要引入集成包 [oapi-sdk-gin](https://github.com/larksuite/oapi-sdk-gin) @@ -696,8 +696,8 @@ func main() { ``` -### 集成hertz框架 -[集成hertz框架](https://github.com/hertz-contrib/lark-hertz) +### 集成 hertz 框架 +[集成 hertz 框架](https://github.com/hertz-contrib/lark-hertz) ## 处理卡片行为回调 @@ -705,7 +705,7 @@ func main() { 关于卡片行为相关的知识，可点击[这里查看](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN) ### 基本用法 -开发者配置消息卡片回调地址后，可以使用下面代码，对飞书开放平台推送的卡片行为进行处理，如下代码基于go-sdk原生http server启动一个httpServer： +开发者配置消息卡片回调地址后，可以使用下面代码，对飞书开放平台推送的卡片行为进行处理，如下代码基于 go-sdk 原生 http server 启动一个 httpServer： ```go import ( @@ -721,7 +721,7 @@ import ( func main() { // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { - // 处理 cardAction, 这里简单打印卡片内容 + // 处理 cardAction，这里简单打印卡片内容 fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) // 无返回值示例 @@ -761,7 +761,7 @@ import ( ) func main() { - // 创建card处理器 + // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) @@ -780,7 +780,7 @@ func main() { // 注册处理器 http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug))) - // 启动http服务 + // 启动 http 服务 err := http.ListenAndServe(":9999", nil) if err != nil { panic(err) @@ -822,7 +822,7 @@ func main() { i18n["ja_jp"] = "こんにちは" body["i18n"] = i18n - // 创建自定义消息：http状态码，body内容 + // 创建自定义消息：http 状态码，body 内容 resp := &larkcard.CustomResp{ StatusCode: 400, Body: body, @@ -848,7 +848,7 @@ func main() { ### 卡片行为处理器内给对应租户发消息 -针对 ISV 开发者，如果想在卡片行为处理器内给对应租户的用户发送消息，则需先从卡片行为内获取租户 key ,然后使用下面方式调用消息 API 进行消息发送： +针对 ISV 开发者，如果想在卡片行为处理器内给对应租户的用户发送消息，则需先从卡片行为内获取租户 key ，然后使用下面方式调用消息 API 进行消息发送： ```go @@ -866,7 +866,7 @@ func main() { // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { - // 处理 cardAction, 这里简单打印卡片内容 + // 处理 cardAction，这里简单打印卡片内容 fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) @@ -903,9 +903,9 @@ func main() { 更多卡片行为处理示例：[./sample/card/card.go](./sample/card/card.go) -### 集成gin框架 +### 集成 gin 框架 -如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK进行集成。 +如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK 进行集成。 要想把 SDK 集成已有 Gin 框架，开发者需要引入集成包 [oapi-sdk-gin](https://github.com/larksuite/oapi-sdk-gin) @@ -944,8 +944,8 @@ func main() { } ``` -### 集成hertz框架 -[集成hertz框架](https://github.com/hertz-contrib/lark-hertz) +### 集成 hertz 框架 +[集成 hertz 框架](https://github.com/hertz-contrib/lark-hertz) ## 加入答疑群 [单击加入答疑群](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=5b4ua18d-80e0-41b6-a7ea-1229b0feb78f) diff --git a/README.zh.md b/README.zh.md index 3ce0ea6c..5fddd43c 100644 --- a/README.zh.md +++ b/README.zh.md @@ -1,6 +1,6 @@ -# 飞书开放接口SDK +# 飞书开放接口 SDK -旨在让开发者便捷的调用飞书开放API、处理订阅的消息事件、处理服务端推送的卡片行为。 +旨在让开发者便捷的调用飞书开放 API、处理订阅的消息事件、处理服务端推送的卡片行为。 ## 目录 @@ -9,18 +9,18 @@ - [安装](#安装) - [API Client](#api-client) - - [创建API Client](#创建api-client) - - [配置API Client](#配置api-client) + - [创建 API Client](#创建api-client) + - [配置 API Client](#配置api-client) -- [API调用](#api调用) +- [API 调用](#api调用) - [基本用法](#基本用法) - [设置请求选项](#设置请求选项) - - [原生API调用方式](#原生api调用方式) + - [原生 API 调用方式](#原生api调用方式) - [处理消息事件回调](#处理消息事件回调) - [基本用法](#基本用法-1) - [消息处理器内给对应租户发消息](#消息处理器内给对应租户发消息) - - [集成gin框架](#集成gin框架) + - [集成 gin 框架](#集成gin框架) - [安装集成包](#安装集成包) - [集成示例](#集成示例) @@ -29,7 +29,7 @@ - [返回卡片消息](#返回卡片消息) - [返回自定义消息](#返回自定义消息) - [卡片行为处理器内给对应租户发消息](#卡片行为处理器内给对应租户发消息) - - [集成gin框架](#集成gin框架) + - [集成 gin 框架](#集成gin框架) - [安装集成包](#安装集成包) - [集成示例](#集成示例) @@ -45,7 +45,7 @@ go get -u github.com/larksuite/oapi-sdk-go/v3@v3.0.9 开发者在调用 API 前，需要先创建一个 API Client，然后才可以基于 API Client 发起 API 调用。 -### 创建API Client +### 创建 API Client - 对于自建应用，可使用下面代码来创建一个 API Client @@ -56,10 +56,10 @@ var client = lark.NewClient("appID", "appSecret") // 默认配置为自建应用 - 对于商店应用，需在创建 API Client 时，使用 lark.WithMarketplaceApp 方法指定 AppType 为商店应用 ```go -var client = lark.NewClient("appID", "appSecret",lark.WithMarketplaceApp()) // 设置App为商店应用 +var client = lark.NewClient("appID", "appSecret",lark.WithMarketplaceApp()) // 设置 App 为商店应用 ``` -### 配置API Client +### 配置 API Client 创建 API Client 时，可对 API Client 进行一定的配置，比如我们可以在创建 API Client 时设置日志级别、设置 http 请求超时时间等等： @@ -108,7 +108,7 @@ var client = lark.NewClient("appID", "appSecret", lark.WithLogLevel(logLevel larkcore.LogLevel) -设置 API Client 的日志输出级别(默认为 Info 级别)，枚举值如下： +设置 API Client 的日志输出级别 (默认为 Info 级别)，枚举值如下： - LogLevelDebug - LogLevelInfo @@ -126,9 +126,9 @@ var client = lark.NewClient("appID", "appSecret", lark.WithLogger(logger larkcore.Logger) -设置API Client的日志器，默认日志输出到标准输出。 +设置 API Client 的日志器，默认日志输出到标准输出。 -开发者可通过实现下面的 Logger 接口，来设置自定义的日志器: +开发者可通过实现下面的 Logger 接口，来设置自定义的日志器： ```go type Logger interface { @@ -166,13 +166,13 @@ type Logger interface { lark.WithOpenBaseUrl(baseUrl string) -设置飞书域名，默认为FeishuBaseUrl，可用域名列表为： +设置飞书域名，默认为 FeishuBaseUrl，可用域名列表为： ```go // 飞书域名 var FeishuBaseUrl = "https://open.feishu.cn" -// Lark域名 +// Lark 域名 var LarkBaseUrl = "https://open.larksuite.com" ``` @@ -187,9 +187,9 @@ var LarkBaseUrl = "https://open.larksuite.com" lark.WithTokenCache(cache larkcore.Cache) -设置 token 缓存器，用来缓存 token 和 appTicket, 默认实现为内存。 +设置 token 缓存器，用来缓存 token 和 appTicket，默认实现为内存。 -如开发者想要定制 token 缓存器，需实现下面 Cache 接口: +如开发者想要定制 token 缓存器，需实现下面 Cache 接口： ```go type Cache interface { @@ -239,7 +239,7 @@ type Cache interface { lark.WithReqTimeout(time time.Duration) -设置 SDK 内置的 Http Client 的请求超时时间，默认为0代表永不超时。 +设置 SDK 内置的 Http Client 的请求超时时间，默认为 0 代表永不超时。 @@ -268,8 +268,8 @@ type HttpClient interface { -## API调用 -创建完毕 API Client，我们可以使用 ``Client.业务域.资源.方法名称`` 来定位具体的 API 方法，然后对具体的 API 发起调用。 +## API 调用 +创建完毕 API Client，我们可以使用 ``Client.业务域。资源.方法名称`` 来定位具体的 API 方法，然后对具体的 API 发起调用。 ![](doc/find_method.jpg) @@ -306,7 +306,7 @@ func main() { //处理错误 if err != nil { - // 处理err + // 处理 err return } @@ -325,7 +325,7 @@ func main() { ### 设置请求选项 -开发者在每次发起 API 调用时，可以设置请求级别的一些参数，比如传递 UserAccessToken ,自定义 Headers 等： +开发者在每次发起 API 调用时，可以设置请求级别的一些参数，比如传递 UserAccessToken ，自定义 Headers 等： ```go import ( @@ -340,10 +340,10 @@ import ( ) func main() { - // 创建client + // 创建 client client := lark.NewClient("appID", "appSecret") - // 自定义请求headers + // 自定义请求 headers header := make(http.Header) header.Add("k1", "v1") header.Add("k2", "v2") @@ -356,12 +356,12 @@ func main() { Build(), ). Build(), - larkcore.WithHeaders(header), // 设置自定义headers + larkcore.WithHeaders(header), // 设置自定义 headers ) //处理错误 if err != nil { - // 处理err + // 处理 err return } @@ -415,7 +415,7 @@ func main() { larkcore.WithUserAccessToken(userAccessToken string) -设置用户token，当开发者需要以用户身份发起调用时，需要设置该选项的值。 +设置用户 token，当开发者需要以用户身份发起调用时，需要设置该选项的值。 @@ -428,7 +428,7 @@ func main() { larkcore.WithTenantAccessToken(tenantAccessToken string) -设置租户 token，当开发者自己维护租户 token 时（即创建Client时EnableTokenCache设置为了false），需通过该选项传递 租户 token。 +设置租户 token，当开发者自己维护租户 token 时（即创建 Client 时 EnableTokenCache 设置为了 false），需通过该选项传递 租户 token。 @@ -441,7 +441,7 @@ func main() { larkcore.WithTenantKey(tenantKey string) -设置租户 key, 当开发者开发商店应用时，必须设置该选项。 +设置租户 key，当开发者开发商店应用时，必须设置该选项。 @@ -462,7 +462,7 @@ func main() { -### 原生API调用方式 +### 原生 API 调用方式 有些老版本的开放接口，不能生成结构化的 API， 导致 SDK 内无法提供结构化的使用方式，这时可使用原生模式进行调用： @@ -565,10 +565,10 @@ func main() { ![Console](doc/console.jpeg) -需要注意的是注册处理器时，比如使用 OnP2MessageReceiveV1 注册接受消息事件回调时，其中的P2为消息协议版本，当前飞书开放平台存在 [两种消息协议](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#8f960a4b) ，分别为1.0和2.0。 +需要注意的是注册处理器时，比如使用 OnP2MessageReceiveV1 注册接受消息事件回调时，其中的 P2 为消息协议版本，当前飞书开放平台存在 [两种消息协议](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#8f960a4b) ，分别为 1.0 和 2.0。 如下图开发者在注册消息处理器时，需从 [事件列表](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-list) 中查看自己需要的是哪种协议的事件。 -如果是1.0的消息协议，则注册处理器时，需要找以OnP1xxxx开头的。如果是2.0的消息协议，则注册处理器时，需要找以OnP2xxxx开头的。 +如果是 1.0 的消息协议，则注册处理器时，需要找以 OnP1xxxx 开头的。如果是 2.0 的消息协议，则注册处理器时，需要找以 OnP2xxxx 开头的。 @@ -578,7 +578,7 @@ func main() { 更多事件订阅示例：[./sample/event/event.go](./sample/event/event.go) ## 消息处理器内给对应租户发消息 -针对 ISV 开发者，如果想在消息处理器内给对应租户的用户发送消息，则需先从消息事件内获取租户 key,然后使用下面方式调用消息 API 进行消息发送： +针对 ISV 开发者，如果想在消息处理器内给对应租户的用户发送消息，则需先从消息事件内获取租户 key，然后使用下面方式调用消息 API 进行消息发送： ```go import ( @@ -635,8 +635,8 @@ func main() { 更多事件订阅示例：[./sample/event/event.go](./sample/event/event.go) -### 集成Gin框架 -如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK进行集成。 +### 集成 Gin 框架 +如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK 进行集成。 要想把 SDK 集成已有 Gin 框架，开发者需要引入集成包 [oapi-sdk-gin](https://github.com/larksuite/oapi-sdk-gin) @@ -691,7 +691,7 @@ func main() { 关于卡片行为相关的知识，可点击[这里查看](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN) ### 基本用法 -开发者配置消息卡片回调地址后，可以使用下面代码，对飞书开放平台推送的卡片行为进行处理，如下代码基于go-sdk原生http server启动一个httpServer： +开发者配置消息卡片回调地址后，可以使用下面代码，对飞书开放平台推送的卡片行为进行处理，如下代码基于 go-sdk 原生 http server 启动一个 httpServer： ```go import ( @@ -707,7 +707,7 @@ import ( func main() { // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { - // 处理 cardAction, 这里简单打印卡片内容 + // 处理 cardAction，这里简单打印卡片内容 fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) // 无返回值示例 @@ -747,7 +747,7 @@ import ( ) func main() { - // 创建card处理器 + // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) @@ -766,7 +766,7 @@ func main() { // 注册处理器 http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug))) - // 启动http服务 + // 启动 http 服务 err := http.ListenAndServe(":9999", nil) if err != nil { panic(err) @@ -808,7 +808,7 @@ func main() { i18n["ja_jp"] = "こんにちは" body["i18n"] = i18n - // 创建自定义消息：http状态码，body内容 + // 创建自定义消息：http 状态码，body 内容 resp := &larkcard.CustomResp{ StatusCode: 400, Body: body, @@ -834,7 +834,7 @@ func main() { ### 卡片行为处理器内给对应租户发消息 -针对 ISV 开发者，如果想在卡片行为处理器内给对应租户的用户发送消息，则需先从卡片行为内获取租户 key ,然后使用下面方式调用消息 API 进行消息发送： +针对 ISV 开发者，如果想在卡片行为处理器内给对应租户的用户发送消息，则需先从卡片行为内获取租户 key ，然后使用下面方式调用消息 API 进行消息发送： ```go @@ -852,7 +852,7 @@ func main() { // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { - // 处理 cardAction, 这里简单打印卡片内容 + // 处理 cardAction，这里简单打印卡片内容 fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) @@ -889,9 +889,9 @@ func main() { 更多卡片行为处理示例：[./sample/card/card.go](./sample/card/card.go) -### 集成gin框架 +### 集成 gin 框架 -如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK进行集成。 +如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK 进行集成。 要想把 SDK 集成已有 Gin 框架，开发者需要引入集成包 [oapi-sdk-gin](https://github.com/larksuite/oapi-sdk-gin) diff --git a/card/card.go b/card/card.go index 90b5851b..1baa3f62 100644 --- a/card/card.go +++ b/card/card.go @@ -220,7 +220,7 @@ func (h *CardActionHandler) VerifySign(ctx context.Context, req *larkevent.Event requestNonce = requestNonces[0] } - // 执行sha1签名计算 + // 执行 sha1 签名计算 targetSign := Signature(requestTimestamp, requestNonce, h.verificationToken, string(req.Body)) diff --git a/card/card_test.go b/card/card_test.go index fc282701..51561f1a 100644 --- a/card/card_test.go +++ b/card/card_test.go @@ -25,7 +25,7 @@ import ( ) func TestVerifyUrlOk(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("12", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { return nil, nil }) @@ -45,7 +45,7 @@ func TestVerifyUrlOk(t *testing.T) { } func TestVerifyUrlFailed(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("121", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { return nil, nil }) @@ -106,7 +106,7 @@ func mockEventReq(token string) *larkevent.EventReq { } func TestVerifySignOk(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("121", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { return nil, nil }) @@ -124,7 +124,7 @@ func TestVerifySignOk(t *testing.T) { } func TestVerifySignFailed(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("121", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { return nil, nil }) @@ -142,7 +142,7 @@ func TestVerifySignFailed(t *testing.T) { } func TestDoHandleResultNilOk(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("12", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { return nil, nil }) @@ -160,7 +160,7 @@ func TestDoHandleResultNilOk(t *testing.T) { } func TestDoHandleResultError(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("121", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { return nil, errors.New("im an error ") }) @@ -175,7 +175,7 @@ func TestDoHandleResultError(t *testing.T) { } func TestDoHandleResultCustomRespOk(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("12", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { body := make(map[string]interface{}) body["content"] = "hello" @@ -207,7 +207,7 @@ func TestDoHandleResultCustomRespOk(t *testing.T) { } func mockCardAction() *CardAction { - // 构建card，并返回 + // 构建 card，并返回 value := map[string]interface{}{} value["value"] = "1111sdfsfd" value["tag"] = "b11111utton" @@ -232,9 +232,9 @@ func mockCardAction() *CardAction { return cardAction } func TestDoHandleResultCardOk(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := NewCardActionHandler("12", "", func(ctx context.Context, cardAction *CardAction) (interface{}, error) { - // 构建card，并返回 + // 构建 card，并返回 value := map[string]interface{}{} value["value"] = "1111sdfsfd" value["tag"] = "b11111utton" diff --git a/changelog.md b/changelog.md index 50beb30a..1929b462 100644 --- a/changelog.md +++ b/changelog.md @@ -15,7 +15,7 @@ Added ## v3.0.5 Added -- 更新业务功能，比如docx评论相关api +- 更新业务功能，比如 docx 评论相关 api ## v3.0.4 Added @@ -23,7 +23,7 @@ Added ## v3.0.3 Added -- 初始化client时，提供withHeaders选项，让开发者设置一些在所有请求都是用的header，比如环境标 +- 初始化 client 时，提供 withHeaders 选项，让开发者设置一些在所有请求都是用的 header，比如环境标 ## v3.0.2 Fixed @@ -31,15 +31,15 @@ Fixed ## v3.0.1 Added -- API方法，消息事件，各种结构体添加文字描述注释 +- API 方法，消息事件，各种结构体添加文字描述注释 ## v3.0.0-beta-7-2022-08-12 Added -- 消息卡片添加MessageCardEmbedImage结构体 +- 消息卡片添加 MessageCardEmbedImage 结构体 ## v3.0.0-beta-6-2022-08-05 Added -- 添加 API 调用时，让开发者传递 appTicket,SDK内部根据appticket自动获取token的功能 +- 添加 API 调用时，让开发者传递 appTicket,SDK 内部根据 appticket 自动获取 token 的功能 - 添加获取登录用户身份、刷新 access_token，获取用户信息（身份验证）的接口 ## v3.0.0-beta-5-2022-08-01 Added @@ -51,7 +51,7 @@ Added ## v3.0.0-beta-3-2022-07-10 Fixed -- 对path参数进行encode +- 对 path 参数进行 encode ## v3.0.0-beta-2-2022-06-30 Added diff --git a/client.go b/client.go index 7a93f1c2..1da47854 100644 --- a/client.go +++ b/client.go @@ -62,20 +62,20 @@ import ( type Client struct { config *larkcore.Config Acs *larkacs.AcsService // 智能门禁 - Admin *larkadmin.AdminService // 管理后台-企业勋章 + Admin *larkadmin.AdminService // 管理后台 - 企业勋章 Application *larkapplication.ApplicationService // 应用信息 Approval *larkapproval.ApprovalService // 审批 Attendance *larkattendance.AttendanceService // 打卡 Auth *larkauth.AuthService // Authen *larkauthen.AuthenService // Baike *larkbaike.BaikeService // 企业百科 - Bitable *larkbitable.BitableService // 云文档-多维表格 + Bitable *larkbitable.BitableService // 云文档 - 多维表格 Block *larkblock.BlockService // 小组件 Calendar *larkcalendar.CalendarService // 日历 Contact *larkcontact.ContactService // 通讯录 Corehr *larkcorehr.CorehrService // CoreHR - Docx *larkdocx.DocxService // 云文档-文档 - Drive *larkdrive.DriveService // 云文档-文件管理 + Docx *larkdocx.DocxService // 云文档 - 文档 + Drive *larkdrive.DriveService // 云文档 - 文件管理 Ehr *larkehr.EhrService // 智能人事 Event *larkevent.EventService // 事件订阅 GrayTestOpenSg *larkgray_test_open_sg.GrayTestOpenSgService // @@ -85,16 +85,16 @@ type Client struct { Im *larkim.ImService // 消息与群组 Mail *larkmail.MailService // 邮箱 Okr *larkokr.OkrService // OKR - OpticalCharRecognition *larkoptical_char_recognition.OpticalCharRecognitionService // AI能力 + OpticalCharRecognition *larkoptical_char_recognition.OpticalCharRecognitionService // AI 能力 Passport *larkpassport.PassportService // 帐号 Search *larksearch.SearchService // 搜索 - Sheets *larksheets.SheetsService // 云文档-电子表格 - SpeechToText *larkspeech_to_text.SpeechToTextService // AI能力 + Sheets *larksheets.SheetsService // 云文档 - 电子表格 + SpeechToText *larkspeech_to_text.SpeechToTextService // AI 能力 Task *larktask.TaskService // 任务 Tenant *larktenant.TenantService // 企业信息 - Translation *larktranslation.TranslationService // AI能力 + Translation *larktranslation.TranslationService // AI 能力 Vc *larkvc.VcService // 视频会议 - Wiki *larkwiki.WikiService // 云文档-知识库 + Wiki *larkwiki.WikiService // 云文档 - 知识库 Ext *larkext.ExtService } @@ -205,14 +205,14 @@ func NewClient(appId, appSecret string, options ...ClientOptionFunc) *Client { // 创建序列化器 larkcore.NewSerialization(config) - // 创建httpclient + // 创建 httpclient larkcore.NewHttpClient(config) - // 创建sdk-client，并初始化服务 + // 创建 sdk-client，并初始化服务 client := &Client{config: config} initService(client, config) - // 触发重推 appTicket,如果是 ISV 的话 + // 触发重推 appTicket，如果是 ISV 的话 resendAppTicketIfNeed(client) return client } diff --git a/core/httpclient.go b/core/httpclient.go index 5110fdb3..8bcc17a4 100644 --- a/core/httpclient.go +++ b/core/httpclient.go @@ -16,9 +16,9 @@ import ( "net/http" ) -// HttpClient :sdk-core面向HttpClient接口编程，实现core与httpclient解耦 -//1.可以适配所有基于go-sdk内置httpclient构建的三方httpclient -//2.可以方便的对httpclient进行mock, 方便编写单元测试 +// HttpClient :sdk-core 面向 HttpClient 接口编程，实现 core 与 httpclient 解耦 +//1.可以适配所有基于 go-sdk 内置 httpclient 构建的三方 httpclient +//2.可以方便的对 httpclient 进行 mock，方便编写单元测试 type HttpClient interface { Do(*http.Request) (*http.Response, error) } diff --git a/core/httpserverext/httpserverext.go b/core/httpserverext/httpserverext.go index 158e136c..cca20f06 100644 --- a/core/httpserverext/httpserverext.go +++ b/core/httpserverext/httpserverext.go @@ -24,7 +24,7 @@ import ( ) func doProcess(writer http.ResponseWriter, req *http.Request, reqHandler larkevent.IReqHandler) { - // 转换http请求对象为标准请求对象 + // 转换 http 请求对象为标准请求对象 ctx := context.Background() eventReq, err := translate(ctx, req) if err != nil { diff --git a/core/httpserverext/httpserverext_test.go b/core/httpserverext/httpserverext_test.go index b58810fb..33731c2e 100644 --- a/core/httpserverext/httpserverext_test.go +++ b/core/httpserverext/httpserverext_test.go @@ -27,7 +27,7 @@ import ( ) func TestStartHttpServer(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("12", "12", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { fmt.Println(larkcore.Prettify(cardAction)) return nil, nil diff --git a/event/dispatcher/calendar_event_dispatch.go b/event/dispatcher/calendar_event_dispatch.go index 244f31a7..7d824ad7 100644 --- a/event/dispatcher/calendar_event_dispatch.go +++ b/event/dispatcher/calendar_event_dispatch.go @@ -22,7 +22,7 @@ import ( // // - 当订阅用户的日历列表有日历变动时触发此事件。 // -// - 应用首先需要调用上述接口建立订阅关系。应用收到该事件后，使用事件的 user_list 字段中的用户对应的 user_access_token 调用[获取日历列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/list)接口拉取增量的变更数据 +// - 应用首先需要调用上述接口建立订阅关系。应用收到该事件后，使用事件的 user_list 字段中的用户对应的 user_access_token 调用 [获取日历列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/list) 接口拉取增量的变更数据 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/events/changed func (dispatcher *EventDispatcher) OnP2CalendarChangedV4(handler func(ctx context.Context, event *larkcalendar.P2CalendarChangedV4) error) *EventDispatcher { @@ -34,9 +34,9 @@ func (dispatcher *EventDispatcher) OnP2CalendarChangedV4(handler func(ctx contex return dispatcher } -// ACL新建 +// ACL 新建 // -// - 当被订阅的日历上有ACL被创建时触发此事件。 +// - 当被订阅的日历上有 ACL 被创建时触发此事件。 // // - 特殊说明：应用首先需要调用上述接口建立订阅关系。 // @@ -50,9 +50,9 @@ func (dispatcher *EventDispatcher) OnP2CalendarAclCreatedV4(handler func(ctx con return dispatcher } -// ACL移除 +// ACL 移除 // -// - 当被订阅的日历上有ACL被删除时触发此事件。 +// - 当被订阅的日历上有 ACL 被删除时触发此事件。 // // - 特殊说明：应用首先需要调用上述接口建立订阅关系。 // @@ -70,7 +70,7 @@ func (dispatcher *EventDispatcher) OnP2CalendarAclDeletedV4(handler func(ctx con // // - 当被订阅的用户日历下有日程变更时触发此事件。 // -// - 应用首先需要调用[订阅日程变更事件接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/subscription)建立订阅关系。应用收到该事件后，使用事件的 user_list 字段中的用户对应的 user_access_token 调用[获取日程列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/list)接口拉取事件中 calendar_id 字段对应的日历下的日程数据 +// - 应用首先需要调用 [订阅日程变更事件接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/subscription) 建立订阅关系。应用收到该事件后，使用事件的 user_list 字段中的用户对应的 user_access_token 调用 [获取日程列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/list) 接口拉取事件中 calendar_id 字段对应的日历下的日程数据 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/events/changed func (dispatcher *EventDispatcher) OnP2CalendarEventChangedV4(handler func(ctx context.Context, event *larkcalendar.P2CalendarEventChangedV4) error) *EventDispatcher { diff --git a/event/dispatcher/contact_event_dispatch.go b/event/dispatcher/contact_event_dispatch.go index 4741fa74..517905fe 100644 --- a/event/dispatcher/contact_event_dispatch.go +++ b/event/dispatcher/contact_event_dispatch.go @@ -38,7 +38,7 @@ func (dispatcher *EventDispatcher) OnP2CustomAttrEventUpdatedV3(handler func(ctx // // - 创建通讯录部门时发送该事件给订阅应用。 // -// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 +// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/events/created func (dispatcher *EventDispatcher) OnP2DepartmentCreatedV3(handler func(ctx context.Context, event *larkcontact.P2DepartmentCreatedV3) error) *EventDispatcher { @@ -54,7 +54,7 @@ func (dispatcher *EventDispatcher) OnP2DepartmentCreatedV3(handler func(ctx cont // // - 订阅这一事件可以获得被删除部门的信息。 // -// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 +// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/events/deleted func (dispatcher *EventDispatcher) OnP2DepartmentDeletedV3(handler func(ctx context.Context, event *larkcontact.P2DepartmentDeletedV3) error) *EventDispatcher { @@ -70,7 +70,7 @@ func (dispatcher *EventDispatcher) OnP2DepartmentDeletedV3(handler func(ctx cont // // - 通过该事件订阅部门更新。`old_object`只展示被更新字段的原始值。应用身份访问通讯录的权限为历史版本，不推荐申请。 // -// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 +// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/events/updated func (dispatcher *EventDispatcher) OnP2DepartmentUpdatedV3(handler func(ctx context.Context, event *larkcontact.P2DepartmentUpdatedV3) error) *EventDispatcher { @@ -170,7 +170,7 @@ func (dispatcher *EventDispatcher) OnP2ScopeUpdatedV3(handler func(ctx context.C // // - 通过该事件订阅员工入职。 // -// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 +// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/events/created func (dispatcher *EventDispatcher) OnP2UserCreatedV3(handler func(ctx context.Context, event *larkcontact.P2UserCreatedV3) error) *EventDispatcher { @@ -186,7 +186,7 @@ func (dispatcher *EventDispatcher) OnP2UserCreatedV3(handler func(ctx context.Co // // - 通过该事件订阅员工离职。应用身份访问通讯录的权限为历史版本，不推荐申请。 // -// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 +// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/events/deleted func (dispatcher *EventDispatcher) OnP2UserDeletedV3(handler func(ctx context.Context, event *larkcontact.P2UserDeletedV3) error) *EventDispatcher { @@ -200,9 +200,9 @@ func (dispatcher *EventDispatcher) OnP2UserDeletedV3(handler func(ctx context.Co // 员工变更 // -// - 通过该事件订阅员工变更。old_object中只展示更新的字段的原始值。 +// - 通过该事件订阅员工变更。old_object 中只展示更新的字段的原始值。 // -// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 +// - 只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)，或查看事件体参数列表的字段描述。 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/events/updated func (dispatcher *EventDispatcher) OnP2UserUpdatedV3(handler func(ctx context.Context, event *larkcontact.P2UserUpdatedV3) error) *EventDispatcher { diff --git a/event/dispatcher/dispatcher.go b/event/dispatcher/dispatcher.go index 89ef5bea..b094fe0a 100644 --- a/event/dispatcher/dispatcher.go +++ b/event/dispatcher/dispatcher.go @@ -24,9 +24,9 @@ import ( ) type EventDispatcher struct { - // 事件map,key为事件类型，value为事件处理器 + // 事件 map,key 为事件类型，value 为事件处理器 eventType2EventHandler map[string]larkevent.EventHandler - // 事件回调签名token，消息解密key + // 事件回调签名 token，消息解密 key verificationToken string eventEncryptKey string *larkcore.Config @@ -50,7 +50,7 @@ func NewEventDispatcher(verificationToken, eventEncryptKey string) *EventDispatc eventEncryptKey: eventEncryptKey, Config: &larkcore.Config{Logger: larkcore.NewEventLogger()}, } - // 注册app_ticket事件 + // 注册 app_ticket 事件 reqDispatcher.eventType2EventHandler["app_ticket"] = &appTicketEventHandler{} return reqDispatcher } @@ -161,7 +161,7 @@ func (d *EventDispatcher) VerifySign(ctx context.Context, req *larkevent.EventRe if len(requestNonces) > 0 { requestNonce = requestNonces[0] } - // 执行sha256签名计算 + // 执行 sha256 签名计算 targetSign := larkevent.Signature(requestTimestamp, requestNonce, d.eventEncryptKey, string(req.Body)) diff --git a/event/dispatcher/dispatcher_test.go b/event/dispatcher/dispatcher_test.go index 705ef681..9bcd2c6e 100644 --- a/event/dispatcher/dispatcher_test.go +++ b/event/dispatcher/dispatcher_test.go @@ -64,7 +64,7 @@ func TestVerifyUrlOk(t *testing.T) { } func TestVerifyUrlFailed(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 handler := NewEventDispatcher("v", "1212121212").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error { fmt.Println(larkcore.Prettify(event)) return nil @@ -90,7 +90,7 @@ func mockEventReq(token string) *larkevent.EventReq { var nonce = "nonce" sourceSign := larkevent.Signature(timestamp, nonce, token, string(body)) - // 添加header + // 添加 header req.Header.Set(larkevent.EventRequestTimestamp, timestamp) req.Header.Set(larkevent.EventRequestNonce, nonce) req.Header.Set(larkevent.EventSignature, sourceSign) @@ -104,7 +104,7 @@ func mockEventReq(token string) *larkevent.EventReq { } func TestParseReq(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 handler := NewEventDispatcher("", "").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error { fmt.Println(larkcore.Prettify(event)) return nil @@ -117,7 +117,7 @@ func TestParseReq(t *testing.T) { larkcore.NewLogger(config) handler.Config = config - // mock请求 + // mock 请求 req := mockEventReq("121") resp, err := handler.ParseReq(context.Background(), req) if err != nil { @@ -129,7 +129,7 @@ func TestParseReq(t *testing.T) { } func TestDecryptEvent(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 handler := NewEventDispatcher("v", "1212121212").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error { fmt.Println(larkcore.Prettify(event)) return nil @@ -152,7 +152,7 @@ func TestDecryptEvent(t *testing.T) { } func TestVerifySignOk(t *testing.T) { - // 创建card处理器 + // 创建 card 处理器 handler := NewEventDispatcher("v", "1212121212").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error { fmt.Println(larkcore.Prettify(event)) return nil diff --git a/event/dispatcher/ext_event_dispatch.go b/event/dispatcher/ext_event_dispatch.go index 42e1cafe..e656d8bc 100644 --- a/event/dispatcher/ext_event_dispatch.go +++ b/event/dispatcher/ext_event_dispatch.go @@ -24,7 +24,7 @@ import ( larkmeeting_room "github.com/larksuite/oapi-sdk-go/v3/service/meeting_room/v1" ) -// v1消息协议：用户购买应用商店付费应用成功后发送给应用ISV的通知事件。 +// v1 消息协议：用户购买应用商店付费应用成功后发送给应用 ISV 的通知事件。 // // 事件描述文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/event/public-app-purchase func (dispatcher *EventDispatcher) OnP1OrderPaidV6(handler func(ctx context.Context, event *larkapplication.P1OrderPaidV6) error) *EventDispatcher { @@ -36,7 +36,7 @@ func (dispatcher *EventDispatcher) OnP1OrderPaidV6(handler func(ctx context.Cont return dispatcher } -// v1消息协议：企业解散后会推送此事件。商店应用开发者可在收到此事件后进行相应的账户注销、数据清理等处理。自建应用无此事件。 +// v1 消息协议：企业解散后会推送此事件。商店应用开发者可在收到此事件后进行相应的账户注销、数据清理等处理。自建应用无此事件。 // // 事件描述文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/event/app-uninstalled func (dispatcher *EventDispatcher) OnP1AppUninstalledV6(handler func(ctx context.Context, event *larkapplication.P1AppUninstalledV6) error) *EventDispatcher { @@ -48,7 +48,7 @@ func (dispatcher *EventDispatcher) OnP1AppUninstalledV6(handler func(ctx context return dispatcher } -// v1消息协议：当企业管理员在管理员后台启用、停用应用，或应用被平台停用时，开放平台推送 app_status_change 事件到请求网址。 +// v1 消息协议：当企业管理员在管理员后台启用、停用应用，或应用被平台停用时，开放平台推送 app_status_change 事件到请求网址。 // // 事件描述文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/event/app-enabled-or-disabled func (dispatcher *EventDispatcher) OnP1AppStatusChangedV6(handler func(ctx context.Context, event *larkapplication.P1AppStatusChangedV6) error) *EventDispatcher { @@ -60,7 +60,7 @@ func (dispatcher *EventDispatcher) OnP1AppStatusChangedV6(handler func(ctx conte return dispatcher } -// v1消息协议：用户阅读机器人发送的消息后触发此事件。 +// v1 消息协议：用户阅读机器人发送的消息后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/ugzMugzMugzM/event/message-read func (dispatcher *EventDispatcher) OnP1MessageReadV1(handler func(ctx context.Context, event *larkim.P1MessageReadV1) error) *EventDispatcher { @@ -72,7 +72,7 @@ func (dispatcher *EventDispatcher) OnP1MessageReadV1(handler func(ctx context.Co return dispatcher } -// v1消息协议：当用户发送消息给机器人或在群聊中@机器人时触发此事件。 +// v1 消息协议：当用户发送消息给机器人或在群聊中 @机器人时触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/ugzMugzMugzM/event/receive-message func (dispatcher *EventDispatcher) OnP1MessageReceiveV1(handler func(ctx context.Context, event *larkim.P1MessageReceiveV1) error) *EventDispatcher { @@ -84,7 +84,7 @@ func (dispatcher *EventDispatcher) OnP1MessageReceiveV1(handler func(ctx context return dispatcher } -// v1消息协议：当员工的激活、暂停账号/恢复账号、操作离职时会触发此事件。此事件不依赖于任何权限。 +// v1 消息协议：当员工的激活、暂停账号/恢复账号、操作离职时会触发此事件。此事件不依赖于任何权限。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM//event/user-status-changed func (dispatcher *EventDispatcher) OnP1UserStatusChangedV3(handler func(ctx context.Context, event *larkcontact.P1UserStatusChangedV3) error) *EventDispatcher { @@ -96,7 +96,7 @@ func (dispatcher *EventDispatcher) OnP1UserStatusChangedV3(handler func(ctx cont return dispatcher } -// v1消息协议：当员工加入企业（user_add）、离职（user_leave）、个人信息发生变化（user_update）时，推送此事件。 +// v1 消息协议：当员工加入企业（user_add）、离职（user_leave）、个人信息发生变化（user_update）时，推送此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM//event/employee-change func (dispatcher *EventDispatcher) OnP1UserChangedV3(handler func(ctx context.Context, event *larkcontact.P1UserChangedV3) error) *EventDispatcher { @@ -120,7 +120,7 @@ func (dispatcher *EventDispatcher) OnP1UserChangedV3(handler func(ctx context.Co return dispatcher } -// v1消息协议：当新建部门（dept_add）、删除部门（dept_delete）、修改部门（dept_update）时，推送此事件。 +// v1 消息协议：当新建部门（dept_add）、删除部门（dept_delete）、修改部门（dept_update）时，推送此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM//event/department-update func (dispatcher *EventDispatcher) OnP1DepartmentChangedV3(handler func(ctx context.Context, event *larkcontact.P1DepartmentChangedV3) error) *EventDispatcher { @@ -144,7 +144,7 @@ func (dispatcher *EventDispatcher) OnP1DepartmentChangedV3(handler func(ctx cont return dispatcher } -// v1消息协议：当应用申请了 以应用身份访问通讯录 权限后，管理员可以配置应用的通讯录授权范围,当此范围变化时，就会触发授权范围变化事件。 +// v1 消息协议：当应用申请了 以应用身份访问通讯录 权限后，管理员可以配置应用的通讯录授权范围，当此范围变化时，就会触发授权范围变化事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM//event/scope-change func (dispatcher *EventDispatcher) OnP1ContactScopeChangedV3(handler func(ctx context.Context, event *larkcontact.P1ContactScopeChangedV3) error) *EventDispatcher { @@ -156,7 +156,7 @@ func (dispatcher *EventDispatcher) OnP1ContactScopeChangedV3(handler func(ctx co return dispatcher } -// v1消息协议：机器人被邀请加入群聊时触发此事件。 +// v1 消息协议：机器人被邀请加入群聊时触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/ugzMugzMugzM/event/bot-added-to-group func (dispatcher *EventDispatcher) OnP1AddBotV1(handler func(ctx context.Context, event *larkim.P1AddBotV1) error) *EventDispatcher { @@ -168,7 +168,7 @@ func (dispatcher *EventDispatcher) OnP1AddBotV1(handler func(ctx context.Context return dispatcher } -// v1消息协议：机器人被从群聊中移除时触发此事件。 +// v1 消息协议：机器人被从群聊中移除时触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/ugzMugzMugzM/event/bot-removed-from-group func (dispatcher *EventDispatcher) OnP1RemoveAddBotV1(handler func(ctx context.Context, event *larkim.P1RemoveBotV1) error) *EventDispatcher { @@ -180,7 +180,7 @@ func (dispatcher *EventDispatcher) OnP1RemoveAddBotV1(handler func(ctx context.C return dispatcher } -// v1消息协议：用户进群、出群后触发此事件 +// v1 消息协议：用户进群、出群后触发此事件 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uQDOwUjL0gDM14CN4ATN/event/user-joins-or-leave-group func (dispatcher *EventDispatcher) OnP1UserInOutChatV1(handler func(ctx context.Context, event *larkim.P1UserInOutChatV1) error) *EventDispatcher { @@ -204,7 +204,7 @@ func (dispatcher *EventDispatcher) OnP1UserInOutChatV1(handler func(ctx context. return dispatcher } -// v1消息协议：群聊被解散后触发此事件。 +// v1 消息协议：群聊被解散后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uQDOwUjL0gDM14CN4ATN/event/group-closed func (dispatcher *EventDispatcher) OnP1ChatDisbandV1(handler func(ctx context.Context, event *larkim.P1ChatDisbandV1) error) *EventDispatcher { @@ -216,7 +216,7 @@ func (dispatcher *EventDispatcher) OnP1ChatDisbandV1(handler func(ctx context.Co return dispatcher } -// v1消息协议：群配置修改后触发此事件。 +// v1 消息协议：群配置修改后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uQDOwUjL0gDM14CN4ATN/event/group-configuration-changes func (dispatcher *EventDispatcher) OnP1GroupSettingUpdatedV1(handler func(ctx context.Context, event *larkim.P1GroupSettingUpdatedV1) error) *EventDispatcher { @@ -228,7 +228,7 @@ func (dispatcher *EventDispatcher) OnP1GroupSettingUpdatedV1(handler func(ctx co return dispatcher } -// v1消息协议：当租户第一次安装并启用此应用时触发此事件，启用应用包含以下场景： +// v1 消息协议：当租户第一次安装并启用此应用时触发此事件，启用应用包含以下场景： // 当租户管理员后台首次开通应用 // 租户内的普通成员首次安装此应用 // @@ -242,7 +242,7 @@ func (dispatcher *EventDispatcher) OnP1AppOpenV6(handler func(ctx context.Contex return dispatcher } -// v1消息协议：首次会话是用户了解应用的重要机会，你可以发送操作说明、配置地址来指导用户开始使用你的应用。 +// v1 消息协议：首次会话是用户了解应用的重要机会，你可以发送操作说明、配置地址来指导用户开始使用你的应用。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/bot-events func (dispatcher *EventDispatcher) OnP1P2PChatCreatedV1(handler func(ctx context.Context, event *larkim.P1P2PChatCreatedV1) error) *EventDispatcher { @@ -254,7 +254,7 @@ func (dispatcher *EventDispatcher) OnP1P2PChatCreatedV1(handler func(ctx context return dispatcher } -// v1消息协议：当添加了第三方会议室的日程发生变动时（创建/更新/删除）触发此事件。 +// v1 消息协议：当添加了第三方会议室的日程发生变动时（创建/更新/删除）触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/meeting_room-v1/event/third-room-event-changes func (dispatcher *EventDispatcher) OnP1ThirdPartyMeetingRoomChangedV1(handler func(ctx context.Context, event *larkmeeting_room.P1ThirdPartyMeetingRoomChangedV1) error) *EventDispatcher { @@ -278,7 +278,7 @@ func (dispatcher *EventDispatcher) OnP1ThirdPartyMeetingRoomChangedV1(handler fu return dispatcher } -// v1消息协议：审批」应用的表单里如果包含 请假控件组，则在此表单审批通过后触发此事件。 +// v1 消息协议：审批」应用的表单里如果包含 请假控件组，则在此表单审批通过后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uIDO24iM4YjLygjN/event/leave func (dispatcher *EventDispatcher) OnP1LeaveApprovalV4(handler func(ctx context.Context, event *larkapproval.P1LeaveApprovalV4) error) *EventDispatcher { @@ -290,7 +290,7 @@ func (dispatcher *EventDispatcher) OnP1LeaveApprovalV4(handler func(ctx context. return dispatcher } -// v1消息协议：「审批」应用的表单里如果包含 加班控件组，则在此表单审批通过后触发此事件。 +// v1 消息协议：「审批」应用的表单里如果包含 加班控件组，则在此表单审批通过后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uIDO24iM4YjLygjN/event/overtime func (dispatcher *EventDispatcher) OnP1WorkApprovalV4(handler func(ctx context.Context, event *larkapproval.P1WorkApprovalV4) error) *EventDispatcher { @@ -302,7 +302,7 @@ func (dispatcher *EventDispatcher) OnP1WorkApprovalV4(handler func(ctx context.C return dispatcher } -// v1消息协议：换班申请审批通过后触发此事件。 你可以在「打卡」应用里提交换班申请。 +// v1 消息协议：换班申请审批通过后触发此事件。 你可以在「打卡」应用里提交换班申请。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uIDO24iM4YjLygjN/event/shift-change func (dispatcher *EventDispatcher) OnP1ShiftApprovalV4(handler func(ctx context.Context, event *larkapproval.P1ShiftApprovalV4) error) *EventDispatcher { @@ -314,7 +314,7 @@ func (dispatcher *EventDispatcher) OnP1ShiftApprovalV4(handler func(ctx context. return dispatcher } -// v1消息协议：补卡申请审批通过后触发此事件。 你可以在「打卡」应用里提交补卡申请。 +// v1 消息协议：补卡申请审批通过后触发此事件。 你可以在「打卡」应用里提交补卡申请。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uIDO24iM4YjLygjN/event/attendance-record-correction func (dispatcher *EventDispatcher) OnP1RemedyApprovalV4(handler func(ctx context.Context, event *larkapproval.P1RemedyApprovalV4) error) *EventDispatcher { @@ -326,7 +326,7 @@ func (dispatcher *EventDispatcher) OnP1RemedyApprovalV4(handler func(ctx context return dispatcher } -// v1消息协议：「审批」应用的表单里如果包含 出差控件组，则在此表单审批通过后触发此事件。 +// v1 消息协议：「审批」应用的表单里如果包含 出差控件组，则在此表单审批通过后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uIDO24iM4YjLygjN/event/business-trip func (dispatcher *EventDispatcher) OnP1TripApprovalV4(handler func(ctx context.Context, event *larkapproval.P1TripApprovalV4) error) *EventDispatcher { @@ -338,7 +338,7 @@ func (dispatcher *EventDispatcher) OnP1TripApprovalV4(handler func(ctx context.C return dispatcher } -// v1消息协议：「审批」应用的表单里如果包含 外出控件组，则在此表单审批通过后触发此事件。 +// v1 消息协议：「审批」应用的表单里如果包含 外出控件组，则在此表单审批通过后触发此事件。 // // 事件描述文档：https://open.feishu.cn/document/ukTMukTMukTM/uIDO24iM4YjLygjN/event/out-of-office func (dispatcher *EventDispatcher) OnP1OutApprovalV4(handler func(ctx context.Context, event *larkapproval.P1OutApprovalV4) error) *EventDispatcher { @@ -360,7 +360,7 @@ func (dispatcher *EventDispatcher) OnCustomizedEvent(eventType string, handler f return dispatcher } -// 当 ISV 需要自己管理 app_ticket 和 token 时，需要注册该处理器,以获取app_ticket。这时 SDK 内将不能帮开发者自动获取和缓存token。 +// 当 ISV 需要自己管理 app_ticket 和 token 时，需要注册该处理器，以获取 app_ticket。这时 SDK 内将不能帮开发者自动获取和缓存 token。 // // 事件描述文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/event/app_ticket-events func (dispatcher *EventDispatcher) OnAppTicketEvent(handler func(ctx context.Context, event *AppTicketEvent) error) *EventDispatcher { diff --git a/event/dispatcher/helpdesk_event_dispatch.go b/event/dispatcher/helpdesk_event_dispatch.go index 205558b1..da7606d0 100644 --- a/event/dispatcher/helpdesk_event_dispatch.go +++ b/event/dispatcher/helpdesk_event_dispatch.go @@ -20,7 +20,7 @@ import ( // 审核事件 // -// - Push审核状态通知事件 +// - Push 审核状态通知事件 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/events/approve func (dispatcher *EventDispatcher) OnP2NotificationApproveV1(handler func(ctx context.Context, event *larkhelpdesk.P2NotificationApproveV1) error) *EventDispatcher { diff --git a/event/dispatcher/im_event_dispatch.go b/event/dispatcher/im_event_dispatch.go index 5f4f4926..8f9b04d7 100644 --- a/event/dispatcher/im_event_dispatch.go +++ b/event/dispatcher/im_event_dispatch.go @@ -22,7 +22,7 @@ import ( // // - 群组被解散后触发此事件。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==解散群== 事件;- 事件会向群内订阅了该事件的机器人进行推送 +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==解散群== 事件;- 事件会向群内订阅了该事件的机器人进行推送 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/events/disbanded func (dispatcher *EventDispatcher) OnP2ChatDisbandedV1(handler func(ctx context.Context, event *larkim.P2ChatDisbandedV1) error) *EventDispatcher { @@ -36,9 +36,9 @@ func (dispatcher *EventDispatcher) OnP2ChatDisbandedV1(handler func(ctx context. // 群配置修改 // -// - 群组配置被修改后触发此事件，包含：;- 群主转移;- 群基本信息修改(群头像/群名称/群描述/群国际化名称);- 群权限修改(加人入群权限/群编辑权限/at所有人权限/群分享权限)。 +// - 群组配置被修改后触发此事件，包含：;- 群主转移;- 群基本信息修改 (群头像/群名称/群描述/群国际化名称);- 群权限修改 (加人入群权限/群编辑权限/at 所有人权限/群分享权限)。 // -// - 注意事项：; - 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==群配置修改== 事件;- 事件会向群内订阅了该事件的机器人进行推送 +// - 注意事项：; - 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==群配置修改== 事件;- 事件会向群内订阅了该事件的机器人进行推送 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/events/updated func (dispatcher *EventDispatcher) OnP2ChatUpdatedV1(handler func(ctx context.Context, event *larkim.P2ChatUpdatedV1) error) *EventDispatcher { @@ -54,7 +54,7 @@ func (dispatcher *EventDispatcher) OnP2ChatUpdatedV1(handler func(ctx context.Co // // - 机器人被用户添加至群聊时触发此事件。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==机器人进群== 事件;- 事件会向进群的机器人进行推送;- 机器人邀请机器人不会触发事件 +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==机器人进群== 事件;- 事件会向进群的机器人进行推送;- 机器人邀请机器人不会触发事件 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-member-bot/events/added func (dispatcher *EventDispatcher) OnP2ChatMemberBotAddedV1(handler func(ctx context.Context, event *larkim.P2ChatMemberBotAddedV1) error) *EventDispatcher { @@ -70,7 +70,7 @@ func (dispatcher *EventDispatcher) OnP2ChatMemberBotAddedV1(handler func(ctx con // // - 机器人被移出群聊后触发此事件。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==机器人被移出群== 事件;- 事件会向被移出群的机器人进行推送 +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==机器人被移出群== 事件;- 事件会向被移出群的机器人进行推送 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-member-bot/events/deleted func (dispatcher *EventDispatcher) OnP2ChatMemberBotDeletedV1(handler func(ctx context.Context, event *larkim.P2ChatMemberBotDeletedV1) error) *EventDispatcher { @@ -86,7 +86,7 @@ func (dispatcher *EventDispatcher) OnP2ChatMemberBotDeletedV1(handler func(ctx c // // - 新用户进群（包含话题群）触发此事件。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==用户进群== 事件;- 事件会向群内订阅了该事件的机器人进行推送 +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==用户进群== 事件;- 事件会向群内订阅了该事件的机器人进行推送 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-member-user/events/added func (dispatcher *EventDispatcher) OnP2ChatMemberUserAddedV1(handler func(ctx context.Context, event *larkim.P2ChatMemberUserAddedV1) error) *EventDispatcher { @@ -102,7 +102,7 @@ func (dispatcher *EventDispatcher) OnP2ChatMemberUserAddedV1(handler func(ctx co // // - 用户主动退群或被移出群聊时推送事件。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)并且机器人所在群发生上述变化;- 机器人需要订阅 ==消息与群组== 分类下的 ==用户主动退群或被移出群聊== 事件;- 事件会向群内订阅了该事件的机器人进行推送 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) 并且机器人所在群发生上述变化;- 机器人需要订阅 ==消息与群组== 分类下的 ==用户主动退群或被移出群聊== 事件;- 事件会向群内订阅了该事件的机器人进行推送 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-member-user/events/deleted func (dispatcher *EventDispatcher) OnP2ChatMemberUserDeletedV1(handler func(ctx context.Context, event *larkim.P2ChatMemberUserDeletedV1) error) *EventDispatcher { @@ -118,7 +118,7 @@ func (dispatcher *EventDispatcher) OnP2ChatMemberUserDeletedV1(handler func(ctx // // - 撤销拉用户进群后触发此事件。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==撤销拉用户进群== 事件;- 事件会向群内订阅了该事件的机器人进行推送 +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 需要订阅 ==消息与群组== 分类下的 ==撤销拉用户进群== 事件;- 事件会向群内订阅了该事件的机器人进行推送 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-member-user/events/withdrawn func (dispatcher *EventDispatcher) OnP2ChatMemberUserWithdrawnV1(handler func(ctx context.Context, event *larkim.P2ChatMemberUserWithdrawnV1) error) *EventDispatcher { @@ -134,7 +134,7 @@ func (dispatcher *EventDispatcher) OnP2ChatMemberUserWithdrawnV1(handler func(ct // // - 用户阅读机器人发送的单聊消息后触发此事件。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 需要订阅 ==消息与群组== 分类下的 ==消息已读== 事件 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 需要订阅 ==消息与群组== 分类下的 ==消息已读== 事件 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/message_read func (dispatcher *EventDispatcher) OnP2MessageReadV1(handler func(ctx context.Context, event *larkim.P2MessageReadV1) error) *EventDispatcher { @@ -164,7 +164,7 @@ func (dispatcher *EventDispatcher) OnP2MessageRecalledV1(handler func(ctx contex // // - 机器人接收到用户发送的消息后触发此事件。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)，并订阅 ==消息与群组== 分类下的 ==接收消息v2.0== 事件才可接收推送;- 同时，将根据应用具备的权限，判断可推送的信息：; - 当具备==获取用户发给机器人的单聊消息==权限或者==读取用户发给机器人的单聊消息（历史权限）==，可接收与机器人单聊会话中用户发送的所有消息; - 当具备==获取群组中所有消息== 权限时，可接收与机器人所在群聊会话中用户发送的所有消息; - 当具备==获取用户在群组中@机器人的消息== 权限或者==获取用户在群聊中@机器人的消息（历史权限）==，可接收机器人所在群聊中用户 @ 机器人的消息 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)，并订阅 ==消息与群组== 分类下的 ==接收消息 v2.0== 事件才可接收推送;- 同时，将根据应用具备的权限，判断可推送的信息：; - 当具备==获取用户发给机器人的单聊消息==权限或者==读取用户发给机器人的单聊消息（历史权限）==，可接收与机器人单聊会话中用户发送的所有消息; - 当具备==获取群组中所有消息== 权限时，可接收与机器人所在群聊会话中用户发送的所有消息; - 当具备==获取用户在群组中 @机器人的消息== 权限或者==获取用户在群聊中 @机器人的消息（历史权限）==，可接收机器人所在群聊中用户 @ 机器人的消息 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/receive func (dispatcher *EventDispatcher) OnP2MessageReceiveV1(handler func(ctx context.Context, event *larkim.P2MessageReceiveV1) error) *EventDispatcher { @@ -180,7 +180,7 @@ func (dispatcher *EventDispatcher) OnP2MessageReceiveV1(handler func(ctx context // // - 消息被添加某一个表情回复后触发此事件 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 具备==获取单聊、群组消息== 或 ==获取与发送单聊、群组消息==权限，并订阅 ==消息与群组== 分类下的 ==消息被reaction== 事件才可接收推送;- 机器人只能收到所在群聊内的消息被添加表情回复事件 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 具备==获取单聊、群组消息== 或 ==获取与发送单聊、群组消息==权限，并订阅 ==消息与群组== 分类下的 ==消息被 reaction== 事件才可接收推送;- 机器人只能收到所在群聊内的消息被添加表情回复事件 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/events/created func (dispatcher *EventDispatcher) OnP2MessageReactionCreatedV1(handler func(ctx context.Context, event *larkim.P2MessageReactionCreatedV1) error) *EventDispatcher { @@ -196,7 +196,7 @@ func (dispatcher *EventDispatcher) OnP2MessageReactionCreatedV1(handler func(ctx // // - 消息被删除某一个表情回复后触发此事件 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 具备==获取单聊、群组消息== 或 ==获取与发送单聊、群组消息==权限，并订阅 ==消息与群组== 分类下的 ==消息被取消reaction== 事件才可接收推送;- 机器人只能收到所在群聊内的消息被删除表情回复事件 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 具备==获取单聊、群组消息== 或 ==获取与发送单聊、群组消息==权限，并订阅 ==消息与群组== 分类下的 ==消息被取消 reaction== 事件才可接收推送;- 机器人只能收到所在群聊内的消息被删除表情回复事件 // // - 事件描述文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/events/deleted func (dispatcher *EventDispatcher) OnP2MessageReactionDeletedV1(handler func(ctx context.Context, event *larkim.P2MessageReactionDeletedV1) error) *EventDispatcher { diff --git a/event/dispatcher/meeting_room_event_dispatch.go b/event/dispatcher/meeting_room_event_dispatch.go index 44e45048..2674eb11 100644 --- a/event/dispatcher/meeting_room_event_dispatch.go +++ b/event/dispatcher/meeting_room_event_dispatch.go @@ -22,7 +22,7 @@ import ( // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2MeetingRoomCreatedV1(handler func(ctx context.Context, event *larkmeeting_room.P2MeetingRoomCreatedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["meeting_room.meeting_room.created_v1"] if existed { @@ -36,7 +36,7 @@ func (dispatcher *EventDispatcher) OnP2MeetingRoomCreatedV1(handler func(ctx con // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2MeetingRoomDeletedV1(handler func(ctx context.Context, event *larkmeeting_room.P2MeetingRoomDeletedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["meeting_room.meeting_room.deleted_v1"] if existed { @@ -66,7 +66,7 @@ func (dispatcher *EventDispatcher) OnP2MeetingRoomStatusChangedV1(handler func(c // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2MeetingRoomUpdatedV1(handler func(ctx context.Context, event *larkmeeting_room.P2MeetingRoomUpdatedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["meeting_room.meeting_room.updated_v1"] if existed { diff --git a/event/dispatcher/vc_event_dispatch.go b/event/dispatcher/vc_event_dispatch.go index 97073f46..6bc6ea67 100644 --- a/event/dispatcher/vc_event_dispatch.go +++ b/event/dispatcher/vc_event_dispatch.go @@ -22,7 +22,7 @@ import ( // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2MeetingAllMeetingEndedV1(handler func(ctx context.Context, event *larkvc.P2MeetingAllMeetingEndedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["vc.meeting.all_meeting_ended_v1"] if existed { @@ -36,7 +36,7 @@ func (dispatcher *EventDispatcher) OnP2MeetingAllMeetingEndedV1(handler func(ctx // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2MeetingAllMeetingStartedV1(handler func(ctx context.Context, event *larkvc.P2MeetingAllMeetingStartedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["vc.meeting.all_meeting_started_v1"] if existed { @@ -178,7 +178,7 @@ func (dispatcher *EventDispatcher) OnP2MeetingShareStartedV1(handler func(ctx co // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2ReserveConfigUpdatedV1(handler func(ctx context.Context, event *larkvc.P2ReserveConfigUpdatedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["vc.reserve_config.updated_v1"] if existed { @@ -234,7 +234,7 @@ func (dispatcher *EventDispatcher) OnP2RoomUpdatedV1(handler func(ctx context.Co // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2RoomLevelCreatedV1(handler func(ctx context.Context, event *larkvc.P2RoomLevelCreatedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["vc.room_level.created_v1"] if existed { @@ -248,7 +248,7 @@ func (dispatcher *EventDispatcher) OnP2RoomLevelCreatedV1(handler func(ctx conte // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2RoomLevelDeletedV1(handler func(ctx context.Context, event *larkvc.P2RoomLevelDeletedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["vc.room_level.deleted_v1"] if existed { @@ -262,7 +262,7 @@ func (dispatcher *EventDispatcher) OnP2RoomLevelDeletedV1(handler func(ctx conte // // - // -// - 事件描述文档链接: +// - 事件描述文档链接： func (dispatcher *EventDispatcher) OnP2RoomLevelUpdatedV1(handler func(ctx context.Context, event *larkvc.P2RoomLevelUpdatedV1) error) *EventDispatcher { _, existed := dispatcher.eventType2EventHandler["vc.room_level.updated_v1"] if existed { diff --git a/event/model.go b/event/model.go index 499067ec..ef628ea8 100644 --- a/event/model.go +++ b/event/model.go @@ -32,7 +32,7 @@ type EventV1Header struct { OpenAppID string `json:"open_chat_id"` // Open App Id OpenID string `json:"open_id"` // Open Id TenantKey string `json:"tenant_key"` // 租户 Key - Type string `json:"type"` // event_callback-事件推送，url_verification-url地址验证 + Type string `json:"type"` // event_callback-事件推送，url_verification-url 地址验证 } type EventV2Base struct { @@ -73,16 +73,16 @@ func (req *EventReq) RequestId() string { } type EventResp struct { - Header http.Header // http请求 header - Body []byte // http请求 body - StatusCode int // http请求状态码 + Header http.Header // http 请求 header + Body []byte // http 请求 body + StatusCode int // http 请求状态码 } type EventBase struct { Ts string `json:"ts"` // 事件发送的时间，一般近似于事件发生的时间。 UUID string `json:"uuid"` // 事件的唯一标识 - Token string `json:"token"` // 即Verification Token - Type string `json:"type"` // event_callback-事件推送，url_verification-url地址验证 + Token string `json:"token"` // 即 Verification Token + Type string `json:"type"` // event_callback-事件推送，url_verification-url 地址验证 } type EventEncryptMsg struct { diff --git a/sample/api/docx.go b/sample/api/docx.go index b337f058..4d5dc79d 100644 --- a/sample/api/docx.go +++ b/sample/api/docx.go @@ -26,7 +26,7 @@ import ( ) func createDocument(client *lark.Client) { - // 自定义请求headers + // 自定义请求 headers header := make(http.Header) header.Add("k1", "v1") header.Add("k2", "v2") @@ -39,13 +39,13 @@ func createDocument(client *lark.Client) { Build(), ). Build(), - larkcore.WithUserAccessToken("userToken"), // 设置用户Token - larkcore.WithHeaders(header), // 设置自定义headers + larkcore.WithUserAccessToken("userToken"), // 设置用户 Token + larkcore.WithHeaders(header), // 设置自定义 headers ) //处理错误 if err != nil { - // 处理err + // 处理 err return } diff --git a/sample/api/im.go b/sample/api/im.go index b69c14c6..2023e5a2 100644 --- a/sample/api/im.go +++ b/sample/api/im.go @@ -378,22 +378,22 @@ func sendInteractiveMonitorMsg(client *lark.Client) { Options([]*larkcard.MessageCardEmbedSelectOption{larkcard.NewMessageCardEmbedSelectOption(). Value("1"). Text(larkcard.NewMessageCardPlainText(). - Content("屏蔽10分钟"). + Content("屏蔽 10 分钟"). Build()), larkcard.NewMessageCardEmbedSelectOption(). Value("2"). Text(larkcard.NewMessageCardPlainText(). - Content("屏蔽30分钟"). + Content("屏蔽 30 分钟"). Build()), larkcard.NewMessageCardEmbedSelectOption(). Value("3"). Text(larkcard.NewMessageCardPlainText(). - Content("屏蔽1小时"). + Content("屏蔽 1 小时"). Build()), larkcard.NewMessageCardEmbedSelectOption(). Value("4"). Text(larkcard.NewMessageCardPlainText(). - Content("屏蔽24小时"). + Content("屏蔽 24 小时"). Build()), }). Placeholder(larkcard.NewMessageCardPlainText(). @@ -678,13 +678,13 @@ func sendStickerMsg(client *lark.Client) { } func sendPostMsg(client *lark.Client) { - // 2.1 创建text与href元素 + // 2.1 创建 text 与 href 元素 zhCnPostText := &larkim.MessagePostText{Text: "中文内容", UnEscape: false} zhCnPostA := &larkim.MessagePostA{Text: "test content", Href: "http://www.baidu.com", UnEscape: false} enUsPostText := &larkim.MessagePostText{Text: "英文内容", UnEscape: false} enUsPostA := &larkim.MessagePostA{Text: "test content", Href: "http://www.baidu.com", UnEscape: false} - // 2.2 构建消息content + // 2.2 构建消息 content zhCnMessagePostContent := &larkim.MessagePostContent{Title: "title1", Content: [][]larkim.MessagePostElement{{zhCnPostText, zhCnPostA}}} enUsMessagePostContent := &larkim.MessagePostContent{Title: "title2", Content: [][]larkim.MessagePostElement{{enUsPostText, enUsPostA}}} messagePostText := &larkim.MessagePost{ZhCN: zhCnMessagePostContent, EnUS: enUsMessagePostContent} @@ -738,7 +738,7 @@ func sendPostMsgUseBuilder(client *lark.Client) { zhCnPostA := &larkim.MessagePostA{Text: "超链接", Href: "http://www.baidu.com", UnEscape: false} enUsPostA := &larkim.MessagePostA{Text: "link", Href: "http://www.baidu.com", UnEscape: false} - // At人 + // At 人 zhCnPostAt := &larkim.MessagePostAt{UserId: "ou_c245b0a7dff2725cfa2fb104f8b48b9d", UserName: "加多"} enCnPostAt := &larkim.MessagePostAt{UserId: "ou_c245b0a7dff2725cfa2fb104f8b48b9d", UserName: "jiaduo"} @@ -849,7 +849,7 @@ func sendRawReq(cli *lark.Client) { AtUser("ou_c245b0a7dff2725cfa2fb104f8b48b9d", "陆续"). Build() - // 放到client里面 + // 放到 client 里面 resp, err := cli.Post(context.Background(), "/open-apis/im/v1/messages?receive_id_type=open_id", map[string]interface{}{ "receive_id": "ou_c245b0a7dff2725cfa2fb104f8b48b9d", "msg_type": "text", @@ -909,12 +909,12 @@ type CustomCache struct { } func (c *CustomCache) Set(ctx context.Context, key string, value string, expireTime time.Duration) error { - // 缓存token + // 缓存 token return nil } func (c *CustomCache) Get(ctx context.Context, key string) (string, error) { - // 获取token + // 获取 token token := "" return token, nil } diff --git a/sample/apiall/approvalv4/preview_instance.go b/sample/apiall/approvalv4/preview_instance.go index 077d130b..4edeae81 100644 --- a/sample/apiall/approvalv4/preview_instance.go +++ b/sample/apiall/approvalv4/preview_instance.go @@ -29,7 +29,7 @@ func main() { req := larkapproval.NewPreviewInstanceReqBuilder(). UserIdType("open_id"). Body(larkapproval.NewPreviewInstanceReqBodyBuilder(). - UserId("发起审批用户id，按照user_id_type类型填写"). + UserId("发起审批用户 id，按照 user_id_type 类型填写"). ApprovalCode("C2CAAA90-70D9-3214-906B-B6FFF947F00D"). DepartmentId("6982332863116876308"). Form(""). diff --git a/sample/apiall/attendancev1/search_group.go b/sample/apiall/attendancev1/search_group.go index 12f24e3f..180c993f 100644 --- a/sample/apiall/attendancev1/search_group.go +++ b/sample/apiall/attendancev1/search_group.go @@ -28,7 +28,7 @@ func main() { // 创建请求对象 req := larkattendance.NewSearchGroupReqBuilder(). Body(larkattendance.NewSearchGroupReqBodyBuilder(). - GroupName("考勤组1"). + GroupName("考勤组 1"). Build()). Build() // 发起请求 diff --git a/sample/apiall/baikev1/create_draft.go b/sample/apiall/baikev1/create_draft.go index d638b49d..220bf8a1 100644 --- a/sample/apiall/baikev1/create_draft.go +++ b/sample/apiall/baikev1/create_draft.go @@ -32,7 +32,7 @@ func main() { Id("enterprise_40217521"). MainKeys([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). Aliases([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). - Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过UGC的方式，促进企业知识的保鲜和流通"). + Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过 UGC 的方式，促进企业知识的保鲜和流通"). RelatedMeta(larkbaike.NewRelatedMetaBuilder().Build()). OuterInfo(larkbaike.NewOuterInfoBuilder().Build()). RichText(""). diff --git a/sample/apiall/baikev1/create_entity.go b/sample/apiall/baikev1/create_entity.go index 1bfa2162..e35fa04a 100644 --- a/sample/apiall/baikev1/create_entity.go +++ b/sample/apiall/baikev1/create_entity.go @@ -31,7 +31,7 @@ func main() { Entity(larkbaike.NewEntityBuilder(). MainKeys([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). Aliases([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). - Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过UGC的方式，促进企业知识的保鲜和流通"). + Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过 UGC 的方式，促进企业知识的保鲜和流通"). RelatedMeta(larkbaike.NewRelatedMetaBuilder().Build()). OuterInfo(larkbaike.NewOuterInfoBuilder().Build()). RichText(""). diff --git a/sample/apiall/baikev1/update_draft.go b/sample/apiall/baikev1/update_draft.go index b50f0a11..1595bd00 100644 --- a/sample/apiall/baikev1/update_draft.go +++ b/sample/apiall/baikev1/update_draft.go @@ -33,7 +33,7 @@ func main() { Id("enterprise_40217521"). MainKeys([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). Aliases([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). - Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过UGC的方式，促进企业知识的保鲜和流通"). + Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过 UGC 的方式，促进企业知识的保鲜和流通"). RelatedMeta(larkbaike.NewRelatedMetaBuilder().Build()). RichText(""). Build()). diff --git a/sample/apiall/baikev1/update_entity.go b/sample/apiall/baikev1/update_entity.go index f26ab388..66e7f54e 100644 --- a/sample/apiall/baikev1/update_entity.go +++ b/sample/apiall/baikev1/update_entity.go @@ -32,7 +32,7 @@ func main() { Entity(larkbaike.NewEntityBuilder(). MainKeys([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). Aliases([]*larkbaike.Term{larkbaike.NewTermBuilder().Build()}). - Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过UGC的方式，促进企业知识的保鲜和流通"). + Description("企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过 UGC 的方式，促进企业知识的保鲜和流通"). RelatedMeta(larkbaike.NewRelatedMetaBuilder().Build()). OuterInfo(larkbaike.NewOuterInfoBuilder().Build()). RichText(""). diff --git a/sample/apiall/bitablev1/create_appRole.go b/sample/apiall/bitablev1/create_appRole.go index ddfdc59d..883988e8 100644 --- a/sample/apiall/bitablev1/create_appRole.go +++ b/sample/apiall/bitablev1/create_appRole.go @@ -29,7 +29,7 @@ func main() { req := larkbitable.NewCreateAppRoleReqBuilder(). AppToken("appbcbWCzen6D8dezhoCH2RpMAh"). AppRole(larkbitable.NewAppRoleBuilder(). - RoleName("自定义权限1"). + RoleName("自定义权限 1"). TableRoles([]*larkbitable.AppRoleTableRole{larkbitable.NewAppRoleTableRoleBuilder().Build()}). BlockRoles([]*larkbitable.AppRoleBlockRole{larkbitable.NewAppRoleBlockRoleBuilder().Build()}). Build()). diff --git a/sample/apiall/bitablev1/create_appTableView.go b/sample/apiall/bitablev1/create_appTableView.go index 8f013d74..5f66dcfe 100644 --- a/sample/apiall/bitablev1/create_appTableView.go +++ b/sample/apiall/bitablev1/create_appTableView.go @@ -30,7 +30,7 @@ func main() { AppToken("appbcbWCzen6D8dezhoCH2RpMAh"). TableId("tblsRc9GRRXKqhvW"). ReqView(larkbitable.NewReqViewBuilder(). - ViewName("表格视图1"). + ViewName("表格视图 1"). ViewType("grid"). Build()). Build() diff --git a/sample/apiall/bitablev1/update_appRole.go b/sample/apiall/bitablev1/update_appRole.go index 5b8d77f4..c666af02 100644 --- a/sample/apiall/bitablev1/update_appRole.go +++ b/sample/apiall/bitablev1/update_appRole.go @@ -30,7 +30,7 @@ func main() { AppToken("appbcbWCzen6D8dezhoCH2RpMAh"). RoleId("roljRpwIUt"). AppRole(larkbitable.NewAppRoleBuilder(). - RoleName("自定义权限1"). + RoleName("自定义权限 1"). TableRoles([]*larkbitable.AppRoleTableRole{larkbitable.NewAppRoleTableRoleBuilder().Build()}). BlockRoles([]*larkbitable.AppRoleBlockRole{larkbitable.NewAppRoleBlockRoleBuilder().Build()}). Build()). diff --git a/sample/apiall/blockv2/create_entity.go b/sample/apiall/blockv2/create_entity.go index a6dc8f22..97502d43 100644 --- a/sample/apiall/blockv2/create_entity.go +++ b/sample/apiall/blockv2/create_entity.go @@ -28,7 +28,7 @@ func main() { // 创建请求对象 req := larkblock.NewCreateEntityReqBuilder(). Body(larkblock.NewCreateEntityReqBodyBuilder(). - Title("已阅block"). + Title("已阅 block"). BlockTypeId("blk_614c1c952f800014b27f87d6"). SourceData(""). SourceMeta(""). diff --git a/sample/apiall/blockv2/update_entity.go b/sample/apiall/blockv2/update_entity.go index 884c429f..37b974fc 100644 --- a/sample/apiall/blockv2/update_entity.go +++ b/sample/apiall/blockv2/update_entity.go @@ -29,7 +29,7 @@ func main() { req := larkblock.NewUpdateEntityReqBuilder(). BlockId("7794641623571830467"). Entity(larkblock.NewEntityBuilder(). - Title("已阅block"). + Title("已阅 block"). BlockTypeId("blk_6204893fee000013739f5359"). SourceData(""). SourceMeta(""). diff --git a/sample/apiall/contactv3/create_group.go b/sample/apiall/contactv3/create_group.go index a2b50393..4c8041c7 100644 --- a/sample/apiall/contactv3/create_group.go +++ b/sample/apiall/contactv3/create_group.go @@ -30,7 +30,7 @@ func main() { Body(larkcontact.NewCreateGroupReqBodyBuilder(). GroupId("g122817"). Name("IT 外包组"). - Description("IT服务人员的集合"). + Description("IT 服务人员的集合"). Type(1). Build()). Build() diff --git a/sample/apiall/drivev1/batchGetTmpDownloadUrl_media.go b/sample/apiall/drivev1/batchGetTmpDownloadUrl_media.go index cfc76ec9..6a5f5c95 100644 --- a/sample/apiall/drivev1/batchGetTmpDownloadUrl_media.go +++ b/sample/apiall/drivev1/batchGetTmpDownloadUrl_media.go @@ -28,7 +28,7 @@ func main() { // 创建请求对象 req := larkdrive.NewBatchGetTmpDownloadUrlMediaReqBuilder(). FileTokens([]string{}). - Extra("[请参考-上传点类型及对应Extra说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction)"). + Extra("[请参考 - 上传点类型及对应 Extra 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction)"). Build() // 发起请求 resp, err := client.Drive.Media.BatchGetTmpDownloadUrl(context.Background(), req) diff --git a/sample/apiall/drivev1/download_media.go b/sample/apiall/drivev1/download_media.go index cb5e136f..04ebcaec 100644 --- a/sample/apiall/drivev1/download_media.go +++ b/sample/apiall/drivev1/download_media.go @@ -28,7 +28,7 @@ func main() { // 创建请求对象 req := larkdrive.NewDownloadMediaReqBuilder(). FileToken("boxcnrHpsg1QDqXAAAyachabcef"). - Extra("[请参考-上传点类型及对应Extra说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction)"). + Extra("[请参考 - 上传点类型及对应 Extra 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction)"). Build() // 发起请求 resp, err := client.Drive.Media.Download(context.Background(), req) diff --git a/sample/apiall/hirev1/create_note.go b/sample/apiall/hirev1/create_note.go index ce4b4f26..1dae1e98 100644 --- a/sample/apiall/hirev1/create_note.go +++ b/sample/apiall/hirev1/create_note.go @@ -32,7 +32,7 @@ func main() { TalentId("6916472453069883661"). ApplicationId("6891565253964859661"). CreatorId("ou_f476cb099ac9227c9bae09ce46112579"). - Content("测试5"). + Content("测试 5"). Privacy(1). Build()). Build() diff --git a/sample/apiall/hirev1/patch_ehrImportTask.go b/sample/apiall/hirev1/patch_ehrImportTask.go index 9889bc79..05aba12e 100644 --- a/sample/apiall/hirev1/patch_ehrImportTask.go +++ b/sample/apiall/hirev1/patch_ehrImportTask.go @@ -29,7 +29,7 @@ func main() { req := larkhire.NewPatchEhrImportTaskReqBuilder(). EhrImportTaskId("623455234"). EhrImportTask(larkhire.NewEhrImportTaskBuilder(). - FailReason("当前HC不可用"). + FailReason("当前 HC 不可用"). RedirectUrl("https://example.com"). State(1). Build()). diff --git a/sample/apiall/optical_char_recognitionv1/basicRecognize_image.go b/sample/apiall/optical_char_recognitionv1/basicRecognize_image.go index 5e9dbb2e..1acc5bc9 100644 --- a/sample/apiall/optical_char_recognitionv1/basicRecognize_image.go +++ b/sample/apiall/optical_char_recognitionv1/basicRecognize_image.go @@ -28,7 +28,7 @@ func main() { // 创建请求对象 req := larkoptical_char_recognition.NewBasicRecognizeImageReqBuilder(). Body(larkoptical_char_recognition.NewBasicRecognizeImageReqBodyBuilder(). - Image("base64后的图片二进制数据"). + Image("base64 后的图片二进制数据"). Build()). Build() // 发起请求 diff --git a/sample/apiall/taskv1/list_taskCollaborator.go b/sample/apiall/taskv1/list_taskCollaborator.go index e8a0723a..df2d3ca3 100644 --- a/sample/apiall/taskv1/list_taskCollaborator.go +++ b/sample/apiall/taskv1/list_taskCollaborator.go @@ -29,7 +29,7 @@ func main() { req := larktask.NewListTaskCollaboratorReqBuilder(). TaskId("0d38e26e-190a-49e9-93a2-35067763ed1f"). PageSize(50). - PageToken("「上次返回的page_token」"). + PageToken("「上次返回的 page_token」"). UserIdType("user_id"). Build() // 发起请求 diff --git a/sample/apiall/taskv1/list_taskFollower.go b/sample/apiall/taskv1/list_taskFollower.go index a459cd00..260ac315 100644 --- a/sample/apiall/taskv1/list_taskFollower.go +++ b/sample/apiall/taskv1/list_taskFollower.go @@ -29,7 +29,7 @@ func main() { req := larktask.NewListTaskFollowerReqBuilder(). TaskId("0d38e26e-190a-49e9-93a2-35067763ed1f"). PageSize(10). - PageToken("「上次返回的page_token」"). + PageToken("「上次返回的 page_token」"). UserIdType("user_id"). Build() // 发起请求 diff --git a/sample/apiall/taskv1/list_taskReminder.go b/sample/apiall/taskv1/list_taskReminder.go index f66b4037..ad741840 100644 --- a/sample/apiall/taskv1/list_taskReminder.go +++ b/sample/apiall/taskv1/list_taskReminder.go @@ -29,7 +29,7 @@ func main() { req := larktask.NewListTaskReminderReqBuilder(). TaskId("0d38e26e-190a-49e9-93a2-35067763ed1f"). PageSize(50). - PageToken("「填写上次返回的page_token」"). + PageToken("「填写上次返回的 page_token」"). Build() // 发起请求 resp, err := client.Task.TaskReminder.List(context.Background(), req) diff --git a/sample/apiall/vcv1/create_roomLevel.go b/sample/apiall/vcv1/create_roomLevel.go index 2bb8ae35..b84f691c 100644 --- a/sample/apiall/vcv1/create_roomLevel.go +++ b/sample/apiall/vcv1/create_roomLevel.go @@ -28,7 +28,7 @@ func main() { // 创建请求对象 req := larkvc.NewCreateRoomLevelReqBuilder(). RoomLevel(larkvc.NewRoomLevelBuilder(). - Name("测试层级2"). + Name("测试层级 2"). ParentId("omb_8d020b12fe49e82847c2af3c193d5754"). CustomGroupId("zidingyi"). Build()). diff --git a/sample/apiall/vcv1/patch_roomLevel.go b/sample/apiall/vcv1/patch_roomLevel.go index 9c27b558..b351b3d8 100644 --- a/sample/apiall/vcv1/patch_roomLevel.go +++ b/sample/apiall/vcv1/patch_roomLevel.go @@ -29,7 +29,7 @@ func main() { req := larkvc.NewPatchRoomLevelReqBuilder(). RoomLevelId("omb_4ad1a2c7a2fbc5fc9570f38456931293"). RoomLevel(larkvc.NewRoomLevelBuilder(). - Name("测试层级2"). + Name("测试层级 2"). ParentId("omb_8d020b12fe49e82847c2af3c193d5754"). CustomGroupId("zidingyi"). Build()). diff --git a/sample/callrawapi/api.go b/sample/callrawapi/api.go index d6ff7a8a..e6e54d12 100644 --- a/sample/callrawapi/api.go +++ b/sample/callrawapi/api.go @@ -54,7 +54,7 @@ func rawApiUserCallNew() { // 处理请求结果 fmt.Println(resp.StatusCode) // http status code fmt.Println(resp.Header) // http header - fmt.Println(string(resp.RawBody)) // http body,二进制数据 + fmt.Println(string(resp.RawBody)) // http body，二进制数据 } // 原生 API 调用推荐用法 @@ -86,7 +86,7 @@ func rawApiTenantCallNew() { // 处理请求结果 fmt.Println(resp.StatusCode) // http status code fmt.Println(resp.Header) // http header - fmt.Println(string(resp.RawBody)) // http body,二进制数据 + fmt.Println(string(resp.RawBody)) // http body，二进制数据 } // 老的原生调用方法，仅做兼容使用 @@ -225,7 +225,7 @@ func CreateDoc() { // 处理请求结果 fmt.Println(resp.StatusCode) // http status code fmt.Println(resp.Header) // http header - fmt.Println(string(resp.RawBody)) // http body,二进制数据 + fmt.Println(string(resp.RawBody)) // http body，二进制数据 } // 原生 API 调用推荐用法 @@ -256,7 +256,7 @@ func GetRootFolderMeta() { // 处理请求结果 fmt.Println(resp.StatusCode) // http status code fmt.Println(resp.Header) // http header - fmt.Println(string(resp.RawBody)) // http body,二进制数据 + fmt.Println(string(resp.RawBody)) // http body，二进制数据 } func main() { diff --git a/sample/card/card.go b/sample/card/card.go index a31d3c6b..78fcad06 100644 --- a/sample/card/card.go +++ b/sample/card/card.go @@ -96,7 +96,7 @@ func getCustomResp() interface{} { return &resp } func main() { - // 创建card处理器 + // 创建 card 处理器 cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) { fmt.Println(larkcore.Prettify(cardAction)) fmt.Println(cardAction.RequestId()) @@ -115,7 +115,7 @@ func main() { http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug))) - // 启动http服务 + // 启动 http 服务 err := http.ListenAndServe(":7777", nil) if err != nil { panic(err) diff --git a/sample/mocksendcardaction/main.go b/sample/mocksendcardaction/main.go index a148eb18..35658ad9 100644 --- a/sample/mocksendcardaction/main.go +++ b/sample/mocksendcardaction/main.go @@ -60,14 +60,14 @@ func mockCardAction() []byte { } func main() { - body1 := "{\"open_id\":\"ou_cdaf8ff9dcf6723db8f09f10b4b53c0f\",\"open_message_id\":\"om_697921c87902fa9999cf9b8520ea5eb2\",\"open_chat_id\":\"oc_79dd04bf25e01d267faadb93b11caac7\",\"tenant_key\":\"104740a13d02575e\",\"token\":\"c-bb72b8787895b65b7fd5ec2ce18aff2bf8cad2af\",\"action\":{\"value\":{\"cardData\":\"{\\\"actionApproveId\\\":5483,\\\"approvalType\\\":0,\\\"approveDetailUrl\\\":\\\"https://wxpublic-test2.t3go.cn/t3-h5-company/#/approveBridge?redirectUrl=https%3A%2F%2Fwxpublic-test2.t3go.cn%2Fcompany-approve-h5%2F%23%2FapproveDetailNew%3FapproveId%3D5483\\\",\\\"approverId\\\":\\\"af075306825d49358ba4662e7c6d9488\\\",\\\"approverIds\\\":[\\\"af075306825d49358ba4662e7c6d9488\\\"],\\\"employeeId\\\":\\\"3a00f21601e748da8a6fa97e393557c3\\\",\\\"employeeName\\\":\\\"王树轩\\\",\\\"orgId\\\":\\\"75e1419b996d4e6da70056e8e1a42ee8\\\",\\\"reason\\\":\\\"Jhh\\\",\\\"routeDetail\\\":\\\"A(花园城巨石马群店)--B座\\\",\\\"sceneShowName\\\":\\\"审批\\\",\\\"thirdAppType\\\":1,\\\"thirdEmployeeId\\\":\\\"ou_6a73fb461db56e87fdb7c922f353dddb\\\",\\\"useDate\\\":\\\"2022/11/15 00:00-2022/11/16 00:00\\\"}\",\"handleType\":\"1\"},\"tag\":\"button\"}}" + body1 := "{\"open_id\":\"ou_cdaf8ff9dcf6723db8f09f10b4b53c0f\",\"open_message_id\":\"om_697921c87902fa9999cf9b8520ea5eb2\",\"open_chat_id\":\"oc_79dd04bf25e01d267faadb93b11caac7\",\"tenant_key\":\"104740a13d02575e\",\"token\":\"c-bb72b8787895b65b7fd5ec2ce18aff2bf8cad2af\",\"action\":{\"value\":{\"cardData\":\"{\\\"actionApproveId\\\":5483,\\\"approvalType\\\":0,\\\"approveDetailUrl\\\":\\\"https://wxpublic-test2.t3go.cn/t3-h5-company/#/approveBridge?redirectUrl=https%3A%2F%2Fwxpublic-test2.t3go.cn%2Fcompany-approve-h5%2F%23%2FapproveDetailNew%3FapproveId%3D5483\\\",\\\"approverId\\\":\\\"af075306825d49358ba4662e7c6d9488\\\",\\\"approverIds\\\":[\\\"af075306825d49358ba4662e7c6d9488\\\"],\\\"employeeId\\\":\\\"3a00f21601e748da8a6fa97e393557c3\\\",\\\"employeeName\\\":\\\"王树轩\\\",\\\"orgId\\\":\\\"75e1419b996d4e6da70056e8e1a42ee8\\\",\\\"reason\\\":\\\"Jhh\\\",\\\"routeDetail\\\":\\\"A(花园城巨石马群店)--B 座\\\",\\\"sceneShowName\\\":\\\"审批\\\",\\\"thirdAppType\\\":1,\\\"thirdEmployeeId\\\":\\\"ou_6a73fb461db56e87fdb7c922f353dddb\\\",\\\"useDate\\\":\\\"2022/11/15 00:00-2022/11/16 00:00\\\"}\",\"handleType\":\"1\"},\"tag\":\"button\"}}" sourceSign := larkcard.Signature("Monday, 14-Nov-22 15:53:37 CST", "39ef4f6f-5400-41e4-b18d-0d13ab6d3646", "UtVPQSv5lbtzjvaulJjvPg8RAOmXTbGF", body1) fmt.Println(sourceSign) var b strings.Builder b.WriteString("Monday, 14-Nov-22 15:53:37 CST") b.WriteString("39ef4f6f-5400-41e4-b18d-0d13ab6d3646") b.WriteString("UtVPQSv5lbtzjvaulJjvPg8RAOmXTbGF") - b.WriteString(body1) //body指整个请求体，不要在反序列化后再计算 + b.WriteString(body1) //body 指整个请求体，不要在反序列化后再计算 bt := []byte(b.String()) h := sha1.New() h.Write(bt) @@ -79,7 +79,7 @@ func main() { //mock body body := mockCardAction() - // 创建http req + // 创建 http req req, err := http.NewRequest(http.MethodPost, "http://127.0.0.1:7777/webhook/card", bytes.NewBuffer(body)) if err != nil { fmt.Println(err) @@ -94,7 +94,7 @@ func main() { //var b = "{\"open_id\":\"ou_d840b2e2be16b3e0091bc0c79220e1fa\",\"user_id\":\"16fd348g\",\"open_message_id\":\"om_dce5707d696ee4952ebedaf1ee762ed2\",\"tenant_key\":\"736588c9260f175d\",\"token\":\"v\",\"action\":{\"value\":{\"key\":\"value\"},\"tag\":\"button\"}}" sourceSign = larkcard.Signature(timestamp, nonce, token, string(body)) //fmt.Println(sourceSign) - // 添加header + // 添加 header req.Header.Set(larkevent.EventRequestTimestamp, timestamp) req.Header.Set(larkevent.EventRequestNonce, nonce) req.Header.Set(larkevent.EventSignature, sourceSign) diff --git a/sample/mocksendevent/main.go b/sample/mocksendevent/main.go index 7f48d3fe..9928014e 100644 --- a/sample/mocksendevent/main.go +++ b/sample/mocksendevent/main.go @@ -835,7 +835,7 @@ func main() { //body := mockAppTicketEvent() body := mockEncryptedBody(encryptedKey) - // 创建http req + // 创建 http req req, err := http.NewRequest(http.MethodPost, "http://127.0.0.1:7777/webhook/event", bytes.NewBuffer(body)) if err != nil { fmt.Println(err) @@ -848,7 +848,7 @@ func main() { var token = encryptedKey sourceSign := larkevent.Signature(timestamp, nonce, token, string(body)) - // 添加header + // 添加 header req.Header.Set(larkevent.EventRequestTimestamp, timestamp) req.Header.Set(larkevent.EventRequestNonce, nonce) req.Header.Set(larkevent.EventSignature, sourceSign) diff --git a/service/acs/v1/api.go b/service/acs/v1/api.go index 8cd0626b..f1ce372a 100644 --- a/service/acs/v1/api.go +++ b/service/acs/v1/api.go @@ -60,9 +60,9 @@ type userFace struct { // // - 用户在门禁考勤机上成功开门或打卡后，智能门禁应用都会生成一条门禁记录。;;该接口返回满足查询参数的识别记录。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/list_accessRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/list_accessRecord.go func (a *accessRecord) List(ctx context.Context, req *ListAccessRecordReq, options ...larkcore.RequestOptionFunc) (*ListAccessRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -94,9 +94,9 @@ func (a *accessRecord) ListByIterator(ctx context.Context, req *ListAccessRecord // // - 用户在门禁考勤机上成功开门或打卡后，智能门禁应用都会生成一条门禁记录，对于使用人脸识别方式进行开门的识别记录，还会有抓拍图。;;可以用该接口下载开门时的人脸识别照片。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record-access_photo/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record-access_photo/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/get_accessRecordAccessPhoto.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/get_accessRecordAccessPhoto.go func (a *accessRecordAccessPhoto) Get(ctx context.Context, req *GetAccessRecordAccessPhotoReq, options ...larkcore.RequestOptionFunc) (*GetAccessRecordAccessPhotoResp, error) { // 发起请求 apiReq := req.apiReq @@ -126,9 +126,9 @@ func (a *accessRecordAccessPhoto) Get(ctx context.Context, req *GetAccessRecordA // // - 使用该接口获取租户内所有门禁设备。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/device/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/device/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/list_device.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/list_device.go func (d *device) List(ctx context.Context, options ...larkcore.RequestOptionFunc) (*ListDeviceResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -157,9 +157,9 @@ func (d *device) List(ctx context.Context, options ...larkcore.RequestOptionFunc // // - 只能获取已加入智能门禁权限组的用户 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/get_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/get_user.go func (u *user) Get(ctx context.Context, req *GetUserReq, options ...larkcore.RequestOptionFunc) (*GetUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -185,9 +185,9 @@ func (u *user) Get(ctx context.Context, req *GetUserReq, options ...larkcore.Req // // - 只能获取已加入智能门禁权限组的用户。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/list_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/list_user.go func (u *user) List(ctx context.Context, req *ListUserReq, options ...larkcore.RequestOptionFunc) (*ListUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -219,9 +219,9 @@ func (u *user) ListByIterator(ctx context.Context, req *ListUserReq, options ... // // - 飞书智能门禁在人脸识别成功后会有韦根信号输出，输出用户的卡号。;对于使用韦根协议的门禁系统，企业可使用该接口录入用户卡号。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/patch_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/patch_user.go func (u *user) Patch(ctx context.Context, req *PatchUserReq, options ...larkcore.RequestOptionFunc) (*PatchUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -245,9 +245,9 @@ func (u *user) Patch(ctx context.Context, req *PatchUserReq, options ...larkcore // // - 对于已经录入人脸图片的用户，可以使用该接口下载用户人脸图片。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/get_userFace.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/get_userFace.go func (u *userFace) Get(ctx context.Context, req *GetUserFaceReq, options ...larkcore.RequestOptionFunc) (*GetUserFaceResp, error) { // 发起请求 apiReq := req.apiReq @@ -277,9 +277,9 @@ func (u *userFace) Get(ctx context.Context, req *GetUserFaceReq, options ...lark // // - 用户需要录入人脸图片才可以使用门禁考勤机。使用该 API 上传门禁用户的人脸图片。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/update_userFace.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/acsv1/update_userFace.go func (u *userFace) Update(ctx context.Context, req *UpdateUserFaceReq, options ...larkcore.RequestOptionFunc) (*UpdateUserFaceResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 diff --git a/service/acs/v1/event.go b/service/acs/v1/event.go index f48adacd..c94dc543 100644 --- a/service/acs/v1/event.go +++ b/service/acs/v1/event.go @@ -32,7 +32,7 @@ func (h *P2AccessRecordCreatedV1Handler) Event() interface{} { return &P2AccessRecordCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2AccessRecordCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2AccessRecordCreatedV1)) } @@ -52,7 +52,7 @@ func (h *P2UserUpdatedV1Handler) Event() interface{} { return &P2UserUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2UserUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2UserUpdatedV1)) } diff --git a/service/acs/v1/model.go b/service/acs/v1/model.go index 5fa47ac8..836e89a4 100644 --- a/service/acs/v1/model.go +++ b/service/acs/v1/model.go @@ -29,39 +29,39 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypePatchUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetUserFaceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetUserFaceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetUserFaceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetUserFaceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetUserFaceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetUserFaceOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateUserFaceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateUserFaceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateUserFaceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateUserFaceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateUserFaceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateUserFaceOpenId = "open_id" // 以 open_id 来识别用户 ) type AccessRecord struct { @@ -322,14 +322,14 @@ func (builder *FeatureBuilder) Build() *Feature { type File struct { Files io.Reader `json:"files,omitempty"` // 人脸图片内容 - FileType *string `json:"file_type,omitempty"` // 文件类型,可选的类型有jpg,png + FileType *string `json:"file_type,omitempty"` // 文件类型，可选的类型有 jpg,png FileName *string `json:"file_name,omitempty"` // 带后缀的文件名 } type FileBuilder struct { files io.Reader // 人脸图片内容 filesFlag bool - fileType string // 文件类型,可选的类型有jpg,png + fileType string // 文件类型，可选的类型有 jpg,png fileTypeFlag bool fileName string // 带后缀的文件名 fileNameFlag bool @@ -342,14 +342,14 @@ func NewFileBuilder() *FileBuilder { // 人脸图片内容 // -// 示例值：jpg图片 +// 示例值：jpg 图片 func (builder *FileBuilder) Files(files io.Reader) *FileBuilder { builder.files = files builder.filesFlag = true return builder } -// 文件类型,可选的类型有jpg,png +// 文件类型，可选的类型有 jpg,png // // 示例值：jpg func (builder *FileBuilder) FileType(fileType string) *FileBuilder { @@ -538,7 +538,7 @@ func (builder *ListAccessRecordReqBuilder) From(from int) *ListAccessRecordReqBu return builder } -// 记录结束时间，单位秒，;时间跨度不能超过30天 +// 记录结束时间，单位秒，;时间跨度不能超过 30 天 // // 示例值：1624520521 func (builder *ListAccessRecordReqBuilder) To(to int) *ListAccessRecordReqBuilder { @@ -554,7 +554,7 @@ func (builder *ListAccessRecordReqBuilder) DeviceId(deviceId string) *ListAccess return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListAccessRecordReqBuilder) UserIdType(userIdType string) *ListAccessRecordReqBuilder { @@ -683,7 +683,7 @@ func (builder *GetUserReqBuilder) UserId(userId string) *GetUserReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetUserReqBuilder) UserIdType(userIdType string) *GetUserReqBuilder { @@ -753,7 +753,7 @@ func (builder *ListUserReqBuilder) PageToken(pageToken string) *ListUserReqBuild return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListUserReqBuilder) UserIdType(userIdType string) *ListUserReqBuilder { @@ -813,7 +813,7 @@ func (builder *PatchUserReqBuilder) UserId(userId string) *PatchUserReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchUserReqBuilder) UserIdType(userIdType string) *PatchUserReqBuilder { @@ -879,7 +879,7 @@ func (builder *GetUserFaceReqBuilder) IsCropped(isCropped bool) *GetUserFaceReqB return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetUserFaceReqBuilder) UserIdType(userIdType string) *GetUserFaceReqBuilder { @@ -945,7 +945,7 @@ func (builder *UpdateUserFaceReqBuilder) UserId(userId string) *UpdateUserFaceRe return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateUserFaceReqBuilder) UserIdType(userIdType string) *UpdateUserFaceReqBuilder { @@ -988,7 +988,7 @@ type P2AccessRecordCreatedV1Data struct { DeviceId *string `json:"device_id,omitempty"` // 设备 ID IsClockIn *bool `json:"is_clock_in,omitempty"` // 是否打卡 IsDoorOpen *bool `json:"is_door_open,omitempty"` // 是否开门 - AccessTime *string `json:"access_time,omitempty"` // 识别时间 （单位：秒） + AccessTime *string `json:"access_time,omitempty"` // 识别时间（单位：秒） } type P2AccessRecordCreatedV1 struct { @@ -1035,7 +1035,7 @@ func (iterator *ListAccessRecordIterator) Next() (bool, *AccessRecord, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -1089,7 +1089,7 @@ func (iterator *ListUserIterator) Next() (bool, *User, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/admin/v1/api.go b/service/admin/v1/api.go index eaac9993..d2492afe 100644 --- a/service/admin/v1/api.go +++ b/service/admin/v1/api.go @@ -62,13 +62,13 @@ type password struct { // 获取部门维度的用户活跃和功能使用数据 // -// - 该接口用于获取部门维度的用户活跃和功能使用数据，即IM（即时通讯）、日历、云文档、音视频会议功能的使用数据。 +// - 该接口用于获取部门维度的用户活跃和功能使用数据，即 IM（即时通讯）、日历、云文档、音视频会议功能的使用数据。 // // - - 只有企业自建应用才有权限调用此接口;;- 当天的数据会在第二天的早上九点半产出（UTC+8） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/admin_dept_stat/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/admin_dept_stat/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_adminDeptStat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_adminDeptStat.go func (a *adminDeptStat) List(ctx context.Context, req *ListAdminDeptStatReq, options ...larkcore.RequestOptionFunc) (*ListAdminDeptStatResp, error) { // 发起请求 apiReq := req.apiReq @@ -90,13 +90,13 @@ func (a *adminDeptStat) List(ctx context.Context, req *ListAdminDeptStatReq, opt // 获取用户维度的用户活跃和功能使用数据 // -// - 用于获取用户维度的用户活跃和功能使用数据，即IM（即时通讯）、日历、云文档、音视频会议功能的使用数据。 +// - 用于获取用户维度的用户活跃和功能使用数据，即 IM（即时通讯）、日历、云文档、音视频会议功能的使用数据。 // // - - 只有企业自建应用才有权限调用此接口;;- 当天的数据会在第二天的早上九点半产出（UTC+8） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/admin_user_stat/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/admin_user_stat/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_adminUserStat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_adminUserStat.go func (a *adminUserStat) List(ctx context.Context, req *ListAdminUserStatReq, options ...larkcore.RequestOptionFunc) (*ListAdminUserStatResp, error) { // 发起请求 apiReq := req.apiReq @@ -118,11 +118,11 @@ func (a *adminUserStat) List(ctx context.Context, req *ListAdminUserStatReq, opt // 创建勋章 // -// - 使用该接口可以创建一枚完整的勋章信息，一个租户下最多可创建1000枚勋章。 +// - 使用该接口可以创建一枚完整的勋章信息，一个租户下最多可创建 1000 枚勋章。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/create_badge.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/create_badge.go func (b *badge) Create(ctx context.Context, req *CreateBadgeReq, options ...larkcore.RequestOptionFunc) (*CreateBadgeResp, error) { // 发起请求 apiReq := req.apiReq @@ -146,9 +146,9 @@ func (b *badge) Create(ctx context.Context, req *CreateBadgeReq, options ...lark // // - 可以通过该接口查询勋章的详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/get_badge.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/get_badge.go func (b *badge) Get(ctx context.Context, req *GetBadgeReq, options ...larkcore.RequestOptionFunc) (*GetBadgeResp, error) { // 发起请求 apiReq := req.apiReq @@ -172,9 +172,9 @@ func (b *badge) Get(ctx context.Context, req *GetBadgeReq, options ...larkcore.R // // - 可以通过该接口列出租户下所有的勋章，勋章的排列顺序是按照创建时间倒序排列。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_badge.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_badge.go func (b *badge) List(ctx context.Context, req *ListBadgeReq, options ...larkcore.RequestOptionFunc) (*ListBadgeResp, error) { // 发起请求 apiReq := req.apiReq @@ -206,9 +206,9 @@ func (b *badge) ListByIterator(ctx context.Context, req *ListBadgeReq, options . // // - 通过该接口可以修改勋章的信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/update_badge.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/update_badge.go func (b *badge) Update(ctx context.Context, req *UpdateBadgeReq, options ...larkcore.RequestOptionFunc) (*UpdateBadgeResp, error) { // 发起请求 apiReq := req.apiReq @@ -230,11 +230,11 @@ func (b *badge) Update(ctx context.Context, req *UpdateBadgeReq, options ...lark // 创建勋章的授予名单 // -// - 通过该接口可以为特定勋章创建一份授予名单，一枚勋章下最多可创建1000份授予名单。 +// - 通过该接口可以为特定勋章创建一份授予名单，一枚勋章下最多可创建 1000 份授予名单。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/create_badgeGrant.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/create_badgeGrant.go func (b *badgeGrant) Create(ctx context.Context, req *CreateBadgeGrantReq, options ...larkcore.RequestOptionFunc) (*CreateBadgeGrantResp, error) { // 发起请求 apiReq := req.apiReq @@ -258,9 +258,9 @@ func (b *badgeGrant) Create(ctx context.Context, req *CreateBadgeGrantReq, optio // // - 通过该接口可以删除特定授予名单的信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/delete_badgeGrant.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/delete_badgeGrant.go func (b *badgeGrant) Delete(ctx context.Context, req *DeleteBadgeGrantReq, options ...larkcore.RequestOptionFunc) (*DeleteBadgeGrantResp, error) { // 发起请求 apiReq := req.apiReq @@ -284,9 +284,9 @@ func (b *badgeGrant) Delete(ctx context.Context, req *DeleteBadgeGrantReq, optio // // - 通过该接口可以获取特定授予名单的信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/get_badgeGrant.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/get_badgeGrant.go func (b *badgeGrant) Get(ctx context.Context, req *GetBadgeGrantReq, options ...larkcore.RequestOptionFunc) (*GetBadgeGrantResp, error) { // 发起请求 apiReq := req.apiReq @@ -310,9 +310,9 @@ func (b *badgeGrant) Get(ctx context.Context, req *GetBadgeGrantReq, options ... // // - 通过该接口可以获取特定勋章下的授予名单列表，授予名单的排列顺序按照创建时间倒序排列。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_badgeGrant.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/list_badgeGrant.go func (b *badgeGrant) List(ctx context.Context, req *ListBadgeGrantReq, options ...larkcore.RequestOptionFunc) (*ListBadgeGrantResp, error) { // 发起请求 apiReq := req.apiReq @@ -344,9 +344,9 @@ func (b *badgeGrant) ListByIterator(ctx context.Context, req *ListBadgeGrantReq, // // - 通过该接口可以修改特定授予名单的相关信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge-grant/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/update_badgeGrant.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/update_badgeGrant.go func (b *badgeGrant) Update(ctx context.Context, req *UpdateBadgeGrantReq, options ...larkcore.RequestOptionFunc) (*UpdateBadgeGrantResp, error) { // 发起请求 apiReq := req.apiReq @@ -368,11 +368,11 @@ func (b *badgeGrant) Update(ctx context.Context, req *UpdateBadgeGrantReq, optio // 上传勋章图片 // -// - 通过该接口可以上传勋章详情图、挂饰图的文件，获取对应的文件key +// - 通过该接口可以上传勋章详情图、挂饰图的文件，获取对应的文件 key // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge_image/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/badge_image/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/create_badgeImage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/create_badgeImage.go func (b *badgeImage) Create(ctx context.Context, req *CreateBadgeImageReq, options ...larkcore.RequestOptionFunc) (*CreateBadgeImageResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -395,11 +395,11 @@ func (b *badgeImage) Create(ctx context.Context, req *CreateBadgeImageReq, optio // 重置密码 // -// - 重置用户的企业邮箱密码，仅当用户的邮箱和企业邮箱(别名)一致时生效，可用于处理飞书企业邮箱登录死锁的问题。;;邮箱死锁：当用户的登录凭证与飞书企业邮箱一致时，目前飞书登录流程要求用户输入验证码，由于飞书邮箱无单独的帐号体系，则未登录时无法收取邮箱验证码，即陷入死锁 +// - 重置用户的企业邮箱密码，仅当用户的邮箱和企业邮箱 (别名) 一致时生效，可用于处理飞书企业邮箱登录死锁的问题。;;邮箱死锁：当用户的登录凭证与飞书企业邮箱一致时，目前飞书登录流程要求用户输入验证码，由于飞书邮箱无单独的帐号体系，则未登录时无法收取邮箱验证码，即陷入死锁 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/password/reset +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/admin-v1/password/reset // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/reset_password.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/adminv1/reset_password.go func (p *password) Reset(ctx context.Context, req *ResetPasswordReq, options ...larkcore.RequestOptionFunc) (*ResetPasswordResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/admin/v1/model.go b/service/admin/v1/model.go index 8da6f0ec..fe7def46 100644 --- a/service/admin/v1/model.go +++ b/service/admin/v1/model.go @@ -27,19 +27,19 @@ import ( ) const ( - DepartmentIdTypeDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeListAdminUserStatDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListAdminUserStatOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListAdminUserStatDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListAdminUserStatOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -49,36 +49,36 @@ const ( ) const ( - UserIdTypeCreateBadgeGrantOpenId = "open_id" // 用户的open_id - UserIdTypeCreateBadgeGrantUnionId = "union_id" // 用户的union_id - UserIdTypeCreateBadgeGrantUserId = "user_id" // 用户的user_id + UserIdTypeCreateBadgeGrantOpenId = "open_id" // 用户的 open_id + UserIdTypeCreateBadgeGrantUnionId = "union_id" // 用户的 union_id + UserIdTypeCreateBadgeGrantUserId = "user_id" // 用户的 user_id ) const ( - DepartmentIdTypeCreateBadgeGrantDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeCreateBadgeGrantOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeCreateBadgeGrantDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeCreateBadgeGrantOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeGetBadgeGrantOpenId = "open_id" // 用户的open_id - UserIdTypeGetBadgeGrantUnionId = "union_id" // 用户的union_id - UserIdTypeGetBadgeGrantUserId = "user_id" // 用户的user_id + UserIdTypeGetBadgeGrantOpenId = "open_id" // 用户的 open_id + UserIdTypeGetBadgeGrantUnionId = "union_id" // 用户的 union_id + UserIdTypeGetBadgeGrantUserId = "user_id" // 用户的 user_id ) const ( - DepartmentIdTypeGetBadgeGrantDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeGetBadgeGrantOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeGetBadgeGrantDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeGetBadgeGrantOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeListBadgeGrantOpenId = "open_id" // 用户的open_id - UserIdTypeListBadgeGrantUnionId = "union_id" // 用户的union_id - UserIdTypeListBadgeGrantUserId = "user_id" // 用户的user_id + UserIdTypeListBadgeGrantOpenId = "open_id" // 用户的 open_id + UserIdTypeListBadgeGrantUnionId = "union_id" // 用户的 union_id + UserIdTypeListBadgeGrantUserId = "user_id" // 用户的 user_id ) const ( - DepartmentIdTypeListBadgeGrantDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListBadgeGrantOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListBadgeGrantDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListBadgeGrantOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -88,14 +88,14 @@ const ( ) const ( - UserIdTypeUpdateBadgeGrantOpenId = "open_id" // 用户的open_id - UserIdTypeUpdateBadgeGrantUnionId = "union_id" // 用户的union_id - UserIdTypeUpdateBadgeGrantUserId = "user_id" // 用户的user_id + UserIdTypeUpdateBadgeGrantOpenId = "open_id" // 用户的 open_id + UserIdTypeUpdateBadgeGrantUnionId = "union_id" // 用户的 union_id + UserIdTypeUpdateBadgeGrantUserId = "user_id" // 用户的 user_id ) const ( - DepartmentIdTypeUpdateBadgeGrantDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeUpdateBadgeGrantOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeUpdateBadgeGrantDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeUpdateBadgeGrantOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -112,7 +112,7 @@ const ( type AdminDeptStat struct { Date *string `json:"date,omitempty"` // 日期 - DepartmentId *string `json:"department_id,omitempty"` // 部门的department_id 或者open_department_id + DepartmentId *string `json:"department_id,omitempty"` // 部门的 department_id 或者 open_department_id DepartmentName *string `json:"department_name,omitempty"` // 部门名字 DepartmentPath *string `json:"department_path,omitempty"` // 部门路径 TotalUserNum *int `json:"total_user_num,omitempty"` // 部门总人数 @@ -148,7 +148,7 @@ type AdminDeptStat struct { type AdminDeptStatBuilder struct { date string // 日期 dateFlag bool - departmentId string // 部门的department_id 或者open_department_id + departmentId string // 部门的 department_id 或者 open_department_id departmentIdFlag bool departmentName string // 部门名字 departmentNameFlag bool @@ -226,7 +226,7 @@ func (builder *AdminDeptStatBuilder) Date(date string) *AdminDeptStatBuilder { return builder } -// 部门的department_id 或者open_department_id +// 部门的 department_id 或者 open_department_id // // 示例值：od-382e2793cfc9471f892e8a672987654c func (builder *AdminDeptStatBuilder) DepartmentId(departmentId string) *AdminDeptStatBuilder { @@ -640,7 +640,7 @@ func (builder *AdminDeptStatBuilder) Build() *AdminDeptStat { type AdminUserStat struct { Date *string `json:"date,omitempty"` // 日期 - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID UserName *string `json:"user_name,omitempty"` // 用户名 DepartmentName *string `json:"department_name,omitempty"` // 部门名 DepartmentPath *string `json:"department_path,omitempty"` // 部门路径 @@ -651,7 +651,7 @@ type AdminUserStat struct { LastActiveTime *string `json:"last_active_time,omitempty"` // 最近活跃时间 ImActiveFlag *int `json:"im_active_flag,omitempty"` // 用户消息活跃状态，发生过如下事件，则认为该用户消息活跃：;发送消息、回复消息、reaction、转发消息、阅读消息、查看会话、发送表情消息等 SendMessengerNum *int `json:"send_messenger_num,omitempty"` // 发送消息数 - DocsActiveFlag *int `json:"docs_active_flag,omitempty"` // 用户云文档活跃状态，"发生过如下事件，则认为该用户云文档活跃： ;事件1：文档/文件打开;事件2：进入docs相关页面：如文档详情页，space的各个页面" + DocsActiveFlag *int `json:"docs_active_flag,omitempty"` // 用户云文档活跃状态，"发生过如下事件，则认为该用户云文档活跃： ;事件 1：文档/文件打开;事件 2：进入 docs 相关页面：如文档详情页，space 的各个页面" CreateDocsNum *int `json:"create_docs_num,omitempty"` // 创建文件数 CalActiveFlag *int `json:"cal_active_flag,omitempty"` // 用户日历活跃状态，发生过如下事件，则认为用户日历活跃，包含进入日历、创建日程、收到日程邀请等 CreateCalNum *int `json:"create_cal_num,omitempty"` // 创建日程数 @@ -667,7 +667,7 @@ type AdminUserStat struct { type AdminUserStatBuilder struct { date string // 日期 dateFlag bool - userId string // 用户ID + userId string // 用户 ID userIdFlag bool userName string // 用户名 userNameFlag bool @@ -689,7 +689,7 @@ type AdminUserStatBuilder struct { imActiveFlagFlag bool sendMessengerNum int // 发送消息数 sendMessengerNumFlag bool - docsActiveFlag int // 用户云文档活跃状态，"发生过如下事件，则认为该用户云文档活跃： ;事件1：文档/文件打开;事件2：进入docs相关页面：如文档详情页，space的各个页面" + docsActiveFlag int // 用户云文档活跃状态，"发生过如下事件，则认为该用户云文档活跃： ;事件 1：文档/文件打开;事件 2：进入 docs 相关页面：如文档详情页，space 的各个页面" docsActiveFlagFlag bool createDocsNum int // 创建文件数 createDocsNumFlag bool @@ -727,7 +727,7 @@ func (builder *AdminUserStatBuilder) Date(date string) *AdminUserStatBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *AdminUserStatBuilder) UserId(userId string) *AdminUserStatBuilder { @@ -826,7 +826,7 @@ func (builder *AdminUserStatBuilder) SendMessengerNum(sendMessengerNum int) *Adm return builder } -// 用户云文档活跃状态，"发生过如下事件，则认为该用户云文档活跃： ;事件1：文档/文件打开;事件2：进入docs相关页面：如文档详情页，space的各个页面" +// 用户云文档活跃状态，"发生过如下事件，则认为该用户云文档活跃： ;事件 1：文档/文件打开;事件 2：进入 docs 相关页面：如文档详情页，space 的各个页面" // // 示例值：1 func (builder *AdminUserStatBuilder) DocsActiveFlag(docsActiveFlag int) *AdminUserStatBuilder { @@ -1118,23 +1118,23 @@ func (builder *ApiAuditCommonDrawersBuilder) Build() *ApiAuditCommonDrawers { } type ApiAuditDrawerInfo struct { - InfoKey *string `json:"info_key,omitempty"` // key信息 - InfoVal *string `json:"info_val,omitempty"` // val值 - KeyI18nKey *string `json:"key_i18n_key,omitempty"` // key对应的i18nkey - ValType *string `json:"val_type,omitempty"` // val类型 - ValI18nKey *string `json:"val_i18n_key,omitempty"` // val对应的i18nkey + InfoKey *string `json:"info_key,omitempty"` // key 信息 + InfoVal *string `json:"info_val,omitempty"` // val 值 + KeyI18nKey *string `json:"key_i18n_key,omitempty"` // key 对应的 i18nkey + ValType *string `json:"val_type,omitempty"` // val 类型 + ValI18nKey *string `json:"val_i18n_key,omitempty"` // val 对应的 i18nkey } type ApiAuditDrawerInfoBuilder struct { - infoKey string // key信息 + infoKey string // key 信息 infoKeyFlag bool - infoVal string // val值 + infoVal string // val 值 infoValFlag bool - keyI18nKey string // key对应的i18nkey + keyI18nKey string // key 对应的 i18nkey keyI18nKeyFlag bool - valType string // val类型 + valType string // val 类型 valTypeFlag bool - valI18nKey string // val对应的i18nkey + valI18nKey string // val 对应的 i18nkey valI18nKeyFlag bool } @@ -1143,7 +1143,7 @@ func NewApiAuditDrawerInfoBuilder() *ApiAuditDrawerInfoBuilder { return builder } -// key信息 +// key 信息 // // 示例值： func (builder *ApiAuditDrawerInfoBuilder) InfoKey(infoKey string) *ApiAuditDrawerInfoBuilder { @@ -1152,7 +1152,7 @@ func (builder *ApiAuditDrawerInfoBuilder) InfoKey(infoKey string) *ApiAuditDrawe return builder } -// val值 +// val 值 // // 示例值： func (builder *ApiAuditDrawerInfoBuilder) InfoVal(infoVal string) *ApiAuditDrawerInfoBuilder { @@ -1161,7 +1161,7 @@ func (builder *ApiAuditDrawerInfoBuilder) InfoVal(infoVal string) *ApiAuditDrawe return builder } -// key对应的i18nkey +// key 对应的 i18nkey // // 示例值： func (builder *ApiAuditDrawerInfoBuilder) KeyI18nKey(keyI18nKey string) *ApiAuditDrawerInfoBuilder { @@ -1170,7 +1170,7 @@ func (builder *ApiAuditDrawerInfoBuilder) KeyI18nKey(keyI18nKey string) *ApiAudi return builder } -// val类型 +// val 类型 // // 示例值： func (builder *ApiAuditDrawerInfoBuilder) ValType(valType string) *ApiAuditDrawerInfoBuilder { @@ -1179,7 +1179,7 @@ func (builder *ApiAuditDrawerInfoBuilder) ValType(valType string) *ApiAuditDrawe return builder } -// val对应的i18nkey +// val 对应的 i18nkey // // 示例值： func (builder *ApiAuditDrawerInfoBuilder) ValI18nKey(valI18nKey string) *ApiAuditDrawerInfoBuilder { @@ -1215,35 +1215,35 @@ func (builder *ApiAuditDrawerInfoBuilder) Build() *ApiAuditDrawerInfo { type AuditAndroidContext struct { Udid *string `json:"udid,omitempty"` // UDID - Did *string `json:"did,omitempty"` // 设备ID - AppVer *string `json:"app_ver,omitempty"` // app的版本 - Ver *string `json:"ver,omitempty"` // SecSDK版本 + Did *string `json:"did,omitempty"` // 设备 ID + AppVer *string `json:"app_ver,omitempty"` // app 的版本 + Ver *string `json:"ver,omitempty"` // SecSDK 版本 Region *string `json:"region,omitempty"` // 设备语言 IdI *string `json:"id_i,omitempty"` // 安卓版本号 IdR *string `json:"id_r,omitempty"` // 安卓版本 HwBrand *string `json:"hw_brand,omitempty"` // Brand HwManuf *string `json:"hw_manuf,omitempty"` // 制造商 Wifip *string `json:"wifip,omitempty"` // wifi ip - RouteIip *string `json:"route_iip,omitempty"` // 路由IP - RouteGip *string `json:"route_gip,omitempty"` // 路由网关IP - EnvSu *string `json:"env_su,omitempty"` // 表示当前是否root + RouteIip *string `json:"route_iip,omitempty"` // 路由 IP + RouteGip *string `json:"route_gip,omitempty"` // 路由网关 IP + EnvSu *string `json:"env_su,omitempty"` // 表示当前是否 root EnvTz *string `json:"env_tz,omitempty"` // 手机系统时区 EnvMl *string `json:"env_ml,omitempty"` // 手机系统语言 - Location *string `json:"location,omitempty"` // GPS经纬度 - ActiveIp *string `json:"active_ip,omitempty"` // 当前设备活跃ip - ActiveIpDetail *string `json:"active_ip_detail,omitempty"` // 当前设备活跃ip对应网卡类型 + Location *string `json:"location,omitempty"` // GPS 经纬度 + ActiveIp *string `json:"active_ip,omitempty"` // 当前设备活跃 ip + ActiveIpDetail *string `json:"active_ip_detail,omitempty"` // 当前设备活跃 ip 对应网卡类型 CellBaseStation *string `json:"cell_base_station,omitempty"` // 基站信息 - IP *string `json:"IP,omitempty"` // 公网ip + IP *string `json:"IP,omitempty"` // 公网 ip } type AuditAndroidContextBuilder struct { udid string // UDID udidFlag bool - did string // 设备ID + did string // 设备 ID didFlag bool - appVer string // app的版本 + appVer string // app 的版本 appVerFlag bool - ver string // SecSDK版本 + ver string // SecSDK 版本 verFlag bool region string // 设备语言 regionFlag bool @@ -1257,25 +1257,25 @@ type AuditAndroidContextBuilder struct { hwManufFlag bool wifip string // wifi ip wifipFlag bool - routeIip string // 路由IP + routeIip string // 路由 IP routeIipFlag bool - routeGip string // 路由网关IP + routeGip string // 路由网关 IP routeGipFlag bool - envSu string // 表示当前是否root + envSu string // 表示当前是否 root envSuFlag bool envTz string // 手机系统时区 envTzFlag bool envMl string // 手机系统语言 envMlFlag bool - location string // GPS经纬度 + location string // GPS 经纬度 locationFlag bool - activeIp string // 当前设备活跃ip + activeIp string // 当前设备活跃 ip activeIpFlag bool - activeIpDetail string // 当前设备活跃ip对应网卡类型 + activeIpDetail string // 当前设备活跃 ip 对应网卡类型 activeIpDetailFlag bool cellBaseStation string // 基站信息 cellBaseStationFlag bool - iP string // 公网ip + iP string // 公网 ip iPFlag bool } @@ -1293,7 +1293,7 @@ func (builder *AuditAndroidContextBuilder) Udid(udid string) *AuditAndroidContex return builder } -// 设备ID +// 设备 ID // // 示例值： func (builder *AuditAndroidContextBuilder) Did(did string) *AuditAndroidContextBuilder { @@ -1302,7 +1302,7 @@ func (builder *AuditAndroidContextBuilder) Did(did string) *AuditAndroidContextB return builder } -// app的版本 +// app 的版本 // // 示例值： func (builder *AuditAndroidContextBuilder) AppVer(appVer string) *AuditAndroidContextBuilder { @@ -1311,7 +1311,7 @@ func (builder *AuditAndroidContextBuilder) AppVer(appVer string) *AuditAndroidCo return builder } -// SecSDK版本 +// SecSDK 版本 // // 示例值： func (builder *AuditAndroidContextBuilder) Ver(ver string) *AuditAndroidContextBuilder { @@ -1374,7 +1374,7 @@ func (builder *AuditAndroidContextBuilder) Wifip(wifip string) *AuditAndroidCont return builder } -// 路由IP +// 路由 IP // // 示例值： func (builder *AuditAndroidContextBuilder) RouteIip(routeIip string) *AuditAndroidContextBuilder { @@ -1383,7 +1383,7 @@ func (builder *AuditAndroidContextBuilder) RouteIip(routeIip string) *AuditAndro return builder } -// 路由网关IP +// 路由网关 IP // // 示例值： func (builder *AuditAndroidContextBuilder) RouteGip(routeGip string) *AuditAndroidContextBuilder { @@ -1392,7 +1392,7 @@ func (builder *AuditAndroidContextBuilder) RouteGip(routeGip string) *AuditAndro return builder } -// 表示当前是否root +// 表示当前是否 root // // 示例值： func (builder *AuditAndroidContextBuilder) EnvSu(envSu string) *AuditAndroidContextBuilder { @@ -1419,7 +1419,7 @@ func (builder *AuditAndroidContextBuilder) EnvMl(envMl string) *AuditAndroidCont return builder } -// GPS经纬度 +// GPS 经纬度 // // 示例值： func (builder *AuditAndroidContextBuilder) Location(location string) *AuditAndroidContextBuilder { @@ -1428,7 +1428,7 @@ func (builder *AuditAndroidContextBuilder) Location(location string) *AuditAndro return builder } -// 当前设备活跃ip +// 当前设备活跃 ip // // 示例值： func (builder *AuditAndroidContextBuilder) ActiveIp(activeIp string) *AuditAndroidContextBuilder { @@ -1437,7 +1437,7 @@ func (builder *AuditAndroidContextBuilder) ActiveIp(activeIp string) *AuditAndro return builder } -// 当前设备活跃ip对应网卡类型 +// 当前设备活跃 ip 对应网卡类型 // // 示例值： func (builder *AuditAndroidContextBuilder) ActiveIpDetail(activeIpDetail string) *AuditAndroidContextBuilder { @@ -1455,7 +1455,7 @@ func (builder *AuditAndroidContextBuilder) CellBaseStation(cellBaseStation strin return builder } -// 公网ip +// 公网 ip // // 示例值： func (builder *AuditAndroidContextBuilder) IP(iP string) *AuditAndroidContextBuilder { @@ -1551,22 +1551,22 @@ func (builder *AuditAndroidContextBuilder) Build() *AuditAndroidContext { type AuditContext struct { TerminalType *int `json:"terminal_type,omitempty"` // 终端类型 - IosContext *AuditIosContext `json:"ios_context,omitempty"` // ios的环境信息 - PcContext *AuditPcContext `json:"pc_context,omitempty"` // pc的环境信息 - WebContext *AuditWebContext `json:"web_context,omitempty"` // web的环境信息 - AndroidContext *AuditAndroidContext `json:"android_context,omitempty"` // android的环境信息 + IosContext *AuditIosContext `json:"ios_context,omitempty"` // ios 的环境信息 + PcContext *AuditPcContext `json:"pc_context,omitempty"` // pc 的环境信息 + WebContext *AuditWebContext `json:"web_context,omitempty"` // web 的环境信息 + AndroidContext *AuditAndroidContext `json:"android_context,omitempty"` // android 的环境信息 } type AuditContextBuilder struct { terminalType int // 终端类型 terminalTypeFlag bool - iosContext *AuditIosContext // ios的环境信息 + iosContext *AuditIosContext // ios 的环境信息 iosContextFlag bool - pcContext *AuditPcContext // pc的环境信息 + pcContext *AuditPcContext // pc 的环境信息 pcContextFlag bool - webContext *AuditWebContext // web的环境信息 + webContext *AuditWebContext // web 的环境信息 webContextFlag bool - androidContext *AuditAndroidContext // android的环境信息 + androidContext *AuditAndroidContext // android 的环境信息 androidContextFlag bool } @@ -1584,7 +1584,7 @@ func (builder *AuditContextBuilder) TerminalType(terminalType int) *AuditContext return builder } -// ios的环境信息 +// ios 的环境信息 // // 示例值： func (builder *AuditContextBuilder) IosContext(iosContext *AuditIosContext) *AuditContextBuilder { @@ -1593,7 +1593,7 @@ func (builder *AuditContextBuilder) IosContext(iosContext *AuditIosContext) *Aud return builder } -// pc的环境信息 +// pc 的环境信息 // // 示例值： func (builder *AuditContextBuilder) PcContext(pcContext *AuditPcContext) *AuditContextBuilder { @@ -1602,7 +1602,7 @@ func (builder *AuditContextBuilder) PcContext(pcContext *AuditPcContext) *AuditC return builder } -// web的环境信息 +// web 的环境信息 // // 示例值： func (builder *AuditContextBuilder) WebContext(webContext *AuditWebContext) *AuditContextBuilder { @@ -1611,7 +1611,7 @@ func (builder *AuditContextBuilder) WebContext(webContext *AuditWebContext) *Aud return builder } -// android的环境信息 +// android 的环境信息 // // 示例值： func (builder *AuditContextBuilder) AndroidContext(androidContext *AuditAndroidContext) *AuditContextBuilder { @@ -1642,20 +1642,20 @@ func (builder *AuditContextBuilder) Build() *AuditContext { } type AuditDetail struct { - Mc *string `json:"mc,omitempty"` // mac地址 + Mc *string `json:"mc,omitempty"` // mac 地址 DeviceModel *string `json:"device_model,omitempty"` // 设备模型 Os *string `json:"os,omitempty"` // 操作系统 - City *string `json:"city,omitempty"` // ip属地 + City *string `json:"city,omitempty"` // ip 属地 } type AuditDetailBuilder struct { - mc string // mac地址 + mc string // mac 地址 mcFlag bool deviceModel string // 设备模型 deviceModelFlag bool os string // 操作系统 osFlag bool - city string // ip属地 + city string // ip 属地 cityFlag bool } @@ -1664,7 +1664,7 @@ func NewAuditDetailBuilder() *AuditDetailBuilder { return builder } -// mac地址 +// mac 地址 // // 示例值：08:00:20:0A:8C:6D func (builder *AuditDetailBuilder) Mc(mc string) *AuditDetailBuilder { @@ -1691,7 +1691,7 @@ func (builder *AuditDetailBuilder) Os(os string) *AuditDetailBuilder { return builder } -// ip属地 +// ip 属地 // // 示例值：北京 func (builder *AuditDetailBuilder) City(city string) *AuditDetailBuilder { @@ -1723,7 +1723,7 @@ func (builder *AuditDetailBuilder) Build() *AuditDetail { type AuditEventExtend struct { CommentType *string `json:"comment_type,omitempty"` // 评论类型 - AppDetail *string `json:"app_detail,omitempty"` // app信息 + AppDetail *string `json:"app_detail,omitempty"` // app 信息 TwoStepValidation *bool `json:"two_step_validation,omitempty"` // 是否两步验证 LoginMethod *string `json:"login_method,omitempty"` // 登录方式 NewPeopleNumInVideo *int `json:"new_people_num_in_video,omitempty"` // 创建新的{x}人会议/通话 @@ -1737,7 +1737,7 @@ type AuditEventExtend struct { type AuditEventExtendBuilder struct { commentType string // 评论类型 commentTypeFlag bool - appDetail string // app信息 + appDetail string // app 信息 appDetailFlag bool twoStepValidation bool // 是否两步验证 twoStepValidationFlag bool @@ -1771,7 +1771,7 @@ func (builder *AuditEventExtendBuilder) CommentType(commentType string) *AuditEv return builder } -// app信息 +// app 信息 // // 示例值： func (builder *AuditEventExtendBuilder) AppDetail(appDetail string) *AuditEventExtendBuilder { @@ -1898,39 +1898,39 @@ func (builder *AuditEventExtendBuilder) Build() *AuditEventExtend { } type AuditInfo struct { - EventId *string `json:"event_id,omitempty"` // 事件id - UniqueId *string `json:"unique_id,omitempty"` // 唯一id + EventId *string `json:"event_id,omitempty"` // 事件 id + UniqueId *string `json:"unique_id,omitempty"` // 唯一 id EventName *string `json:"event_name,omitempty"` // 事件名称 - DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的ID列表 + DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的 ID 列表 EventModule *int `json:"event_module,omitempty"` // 模块 OperatorType *int `json:"operator_type,omitempty"` // 操作人类型 - OperatorValue *string `json:"operator_value,omitempty"` // 操作人id + OperatorValue *string `json:"operator_value,omitempty"` // 操作人 id Objects []*AuditObjectEntity `json:"objects,omitempty"` // 操作对象列表 Recipients []*AuditRecipientEntity `json:"recipients,omitempty"` // 接收者对象列表 EventTime *int `json:"event_time,omitempty"` // 事件时间 - Ip *string `json:"ip,omitempty"` // ip信息 - OperatorApp *string `json:"operator_app,omitempty"` // 第三方isvID + Ip *string `json:"ip,omitempty"` // ip 信息 + OperatorApp *string `json:"operator_app,omitempty"` // 第三方 isvID AuditContext *AuditContext `json:"audit_context,omitempty"` // 环境信息 Extend *AuditEventExtend `json:"extend,omitempty"` // 事件级别的扩展 - OperatorAppName *string `json:"operator_app_name,omitempty"` // 第三方isv名称 + OperatorAppName *string `json:"operator_app_name,omitempty"` // 第三方 isv 名称 CommonDrawers *ApiAuditCommonDrawers `json:"common_drawers,omitempty"` // 扩展字段信息 AuditDetail *AuditDetail `json:"audit_detail,omitempty"` // 日志扩展信息 } type AuditInfoBuilder struct { - eventId string // 事件id + eventId string // 事件 id eventIdFlag bool - uniqueId string // 唯一id + uniqueId string // 唯一 id uniqueIdFlag bool eventName string // 事件名称 eventNameFlag bool - departmentIds []string // 用户所属部门的ID列表 + departmentIds []string // 用户所属部门的 ID 列表 departmentIdsFlag bool eventModule int // 模块 eventModuleFlag bool operatorType int // 操作人类型 operatorTypeFlag bool - operatorValue string // 操作人id + operatorValue string // 操作人 id operatorValueFlag bool objects []*AuditObjectEntity // 操作对象列表 objectsFlag bool @@ -1938,15 +1938,15 @@ type AuditInfoBuilder struct { recipientsFlag bool eventTime int // 事件时间 eventTimeFlag bool - ip string // ip信息 + ip string // ip 信息 ipFlag bool - operatorApp string // 第三方isvID + operatorApp string // 第三方 isvID operatorAppFlag bool auditContext *AuditContext // 环境信息 auditContextFlag bool extend *AuditEventExtend // 事件级别的扩展 extendFlag bool - operatorAppName string // 第三方isv名称 + operatorAppName string // 第三方 isv 名称 operatorAppNameFlag bool commonDrawers *ApiAuditCommonDrawers // 扩展字段信息 commonDrawersFlag bool @@ -1959,7 +1959,7 @@ func NewAuditInfoBuilder() *AuditInfoBuilder { return builder } -// 事件id +// 事件 id // // 示例值：7126195947859656705 func (builder *AuditInfoBuilder) EventId(eventId string) *AuditInfoBuilder { @@ -1968,7 +1968,7 @@ func (builder *AuditInfoBuilder) EventId(eventId string) *AuditInfoBuilder { return builder } -// 唯一id +// 唯一 id // // 示例值：7126195947859656705 func (builder *AuditInfoBuilder) UniqueId(uniqueId string) *AuditInfoBuilder { @@ -1986,7 +1986,7 @@ func (builder *AuditInfoBuilder) EventName(eventName string) *AuditInfoBuilder { return builder } -// 用户所属部门的ID列表 +// 用户所属部门的 ID 列表 // // 示例值： func (builder *AuditInfoBuilder) DepartmentIds(departmentIds []string) *AuditInfoBuilder { @@ -2013,7 +2013,7 @@ func (builder *AuditInfoBuilder) OperatorType(operatorType int) *AuditInfoBuilde return builder } -// 操作人id +// 操作人 id // // 示例值：11111111111111 func (builder *AuditInfoBuilder) OperatorValue(operatorValue string) *AuditInfoBuilder { @@ -2049,7 +2049,7 @@ func (builder *AuditInfoBuilder) EventTime(eventTime int) *AuditInfoBuilder { return builder } -// ip信息 +// ip 信息 // // 示例值：192.168.168.1 func (builder *AuditInfoBuilder) Ip(ip string) *AuditInfoBuilder { @@ -2058,7 +2058,7 @@ func (builder *AuditInfoBuilder) Ip(ip string) *AuditInfoBuilder { return builder } -// 第三方isvID +// 第三方 isvID // // 示例值：xxx func (builder *AuditInfoBuilder) OperatorApp(operatorApp string) *AuditInfoBuilder { @@ -2085,7 +2085,7 @@ func (builder *AuditInfoBuilder) Extend(extend *AuditEventExtend) *AuditInfoBuil return builder } -// 第三方isv名称 +// 第三方 isv 名称 // // 示例值：xxx func (builder *AuditInfoBuilder) OperatorAppName(operatorAppName string) *AuditInfoBuilder { @@ -2180,30 +2180,30 @@ func (builder *AuditInfoBuilder) Build() *AuditInfo { type AuditIosContext struct { Udid *string `json:"udid,omitempty"` // UDID - Did *string `json:"did,omitempty"` // 设备ID - AppVer *string `json:"app_ver,omitempty"` // app的版本 - Ver *string `json:"ver,omitempty"` // SecSDK版本 + Did *string `json:"did,omitempty"` // 设备 ID + AppVer *string `json:"app_ver,omitempty"` // app 的版本 + Ver *string `json:"ver,omitempty"` // SecSDK 版本 Os *string `json:"os,omitempty"` // 系统类型及版本 STZone *string `json:"STZone,omitempty"` // 系统时区 ML *string `json:"ML,omitempty"` // 当前语言 Sjd *string `json:"sjd,omitempty"` // 是否越狱 - Proxyip *string `json:"proxyip,omitempty"` // 代理ip + Proxyip *string `json:"proxyip,omitempty"` // 代理 ip Wifip *string `json:"wifip,omitempty"` // wifi ip - Location *string `json:"location,omitempty"` // GPS经纬度 - ActiveIp *string `json:"active_ip,omitempty"` // 当前设备活跃ip - ActiveIpDetail *string `json:"active_ip_detail,omitempty"` // 当前设备活跃ip对应网卡类型 + Location *string `json:"location,omitempty"` // GPS 经纬度 + ActiveIp *string `json:"active_ip,omitempty"` // 当前设备活跃 ip + ActiveIpDetail *string `json:"active_ip_detail,omitempty"` // 当前设备活跃 ip 对应网卡类型 CellBaseStation *string `json:"cell_base_station,omitempty"` // 基站信息 - IP *string `json:"IP,omitempty"` // 公网ip + IP *string `json:"IP,omitempty"` // 公网 ip } type AuditIosContextBuilder struct { udid string // UDID udidFlag bool - did string // 设备ID + did string // 设备 ID didFlag bool - appVer string // app的版本 + appVer string // app 的版本 appVerFlag bool - ver string // SecSDK版本 + ver string // SecSDK 版本 verFlag bool os string // 系统类型及版本 osFlag bool @@ -2213,19 +2213,19 @@ type AuditIosContextBuilder struct { mLFlag bool sjd string // 是否越狱 sjdFlag bool - proxyip string // 代理ip + proxyip string // 代理 ip proxyipFlag bool wifip string // wifi ip wifipFlag bool - location string // GPS经纬度 + location string // GPS 经纬度 locationFlag bool - activeIp string // 当前设备活跃ip + activeIp string // 当前设备活跃 ip activeIpFlag bool - activeIpDetail string // 当前设备活跃ip对应网卡类型 + activeIpDetail string // 当前设备活跃 ip 对应网卡类型 activeIpDetailFlag bool cellBaseStation string // 基站信息 cellBaseStationFlag bool - iP string // 公网ip + iP string // 公网 ip iPFlag bool } @@ -2243,7 +2243,7 @@ func (builder *AuditIosContextBuilder) Udid(udid string) *AuditIosContextBuilder return builder } -// 设备ID +// 设备 ID // // 示例值： func (builder *AuditIosContextBuilder) Did(did string) *AuditIosContextBuilder { @@ -2252,7 +2252,7 @@ func (builder *AuditIosContextBuilder) Did(did string) *AuditIosContextBuilder { return builder } -// app的版本 +// app 的版本 // // 示例值： func (builder *AuditIosContextBuilder) AppVer(appVer string) *AuditIosContextBuilder { @@ -2261,7 +2261,7 @@ func (builder *AuditIosContextBuilder) AppVer(appVer string) *AuditIosContextBui return builder } -// SecSDK版本 +// SecSDK 版本 // // 示例值： func (builder *AuditIosContextBuilder) Ver(ver string) *AuditIosContextBuilder { @@ -2306,7 +2306,7 @@ func (builder *AuditIosContextBuilder) Sjd(sjd string) *AuditIosContextBuilder { return builder } -// 代理ip +// 代理 ip // // 示例值： func (builder *AuditIosContextBuilder) Proxyip(proxyip string) *AuditIosContextBuilder { @@ -2324,7 +2324,7 @@ func (builder *AuditIosContextBuilder) Wifip(wifip string) *AuditIosContextBuild return builder } -// GPS经纬度 +// GPS 经纬度 // // 示例值： func (builder *AuditIosContextBuilder) Location(location string) *AuditIosContextBuilder { @@ -2333,7 +2333,7 @@ func (builder *AuditIosContextBuilder) Location(location string) *AuditIosContex return builder } -// 当前设备活跃ip +// 当前设备活跃 ip // // 示例值： func (builder *AuditIosContextBuilder) ActiveIp(activeIp string) *AuditIosContextBuilder { @@ -2342,7 +2342,7 @@ func (builder *AuditIosContextBuilder) ActiveIp(activeIp string) *AuditIosContex return builder } -// 当前设备活跃ip对应网卡类型 +// 当前设备活跃 ip 对应网卡类型 // // 示例值： func (builder *AuditIosContextBuilder) ActiveIpDetail(activeIpDetail string) *AuditIosContextBuilder { @@ -2360,7 +2360,7 @@ func (builder *AuditIosContextBuilder) CellBaseStation(cellBaseStation string) * return builder } -// 公网ip +// 公网 ip // // 示例值： func (builder *AuditIosContextBuilder) IP(iP string) *AuditIosContextBuilder { @@ -2438,15 +2438,15 @@ type AuditObjectDetail struct { CloneSource *string `json:"clone_source,omitempty"` // 克隆来源 TextDetail *string `json:"text_detail,omitempty"` // 其他文本 FileName *string `json:"file_name,omitempty"` // 文件名称 - ThirdPartyAppID *string `json:"third_party_appID,omitempty"` // 第三方APPID + ThirdPartyAppID *string `json:"third_party_appID,omitempty"` // 第三方 APPID ContainFileNum *int `json:"contain_file_num,omitempty"` // 文件或文件夹数量 PermissionSettingType *string `json:"permission_setting_type,omitempty"` // 链接分享设置 PermissionExternalAccessType *bool `json:"permission_external_access_Type,omitempty"` // 是否开启外部访问设置 PermissionShareType *string `json:"permission_share_type,omitempty"` // 分享设置 - FileServiceSource *string `json:"file_service_source,omitempty"` // file上传业务来源 - OkrDownloadContent *string `json:"okr_download_content,omitempty"` // 下载OKR时的内容范围 - ContainerType *string `json:"container_type,omitempty"` // 容器类型，标识是否wiki - ContainerId *string `json:"container_id,omitempty"` // 容器id，wiki标识字段 + FileServiceSource *string `json:"file_service_source,omitempty"` // file 上传业务来源 + OkrDownloadContent *string `json:"okr_download_content,omitempty"` // 下载 OKR 时的内容范围 + ContainerType *string `json:"container_type,omitempty"` // 容器类型，标识是否 wiki + ContainerId *string `json:"container_id,omitempty"` // 容器 id，wiki 标识字段 CurrentPage *string `json:"current_page,omitempty"` // 截屏、录制的开始页面 } @@ -2457,7 +2457,7 @@ type AuditObjectDetailBuilder struct { textDetailFlag bool fileName string // 文件名称 fileNameFlag bool - thirdPartyAppID string // 第三方APPID + thirdPartyAppID string // 第三方 APPID thirdPartyAppIDFlag bool containFileNum int // 文件或文件夹数量 containFileNumFlag bool @@ -2467,13 +2467,13 @@ type AuditObjectDetailBuilder struct { permissionExternalAccessTypeFlag bool permissionShareType string // 分享设置 permissionShareTypeFlag bool - fileServiceSource string // file上传业务来源 + fileServiceSource string // file 上传业务来源 fileServiceSourceFlag bool - okrDownloadContent string // 下载OKR时的内容范围 + okrDownloadContent string // 下载 OKR 时的内容范围 okrDownloadContentFlag bool - containerType string // 容器类型，标识是否wiki + containerType string // 容器类型，标识是否 wiki containerTypeFlag bool - containerId string // 容器id，wiki标识字段 + containerId string // 容器 id，wiki 标识字段 containerIdFlag bool currentPage string // 截屏、录制的开始页面 currentPageFlag bool @@ -2511,7 +2511,7 @@ func (builder *AuditObjectDetailBuilder) FileName(fileName string) *AuditObjectD return builder } -// 第三方APPID +// 第三方 APPID // // 示例值： func (builder *AuditObjectDetailBuilder) ThirdPartyAppID(thirdPartyAppID string) *AuditObjectDetailBuilder { @@ -2556,7 +2556,7 @@ func (builder *AuditObjectDetailBuilder) PermissionShareType(permissionShareType return builder } -// file上传业务来源 +// file 上传业务来源 // // 示例值： func (builder *AuditObjectDetailBuilder) FileServiceSource(fileServiceSource string) *AuditObjectDetailBuilder { @@ -2565,7 +2565,7 @@ func (builder *AuditObjectDetailBuilder) FileServiceSource(fileServiceSource str return builder } -// 下载OKR时的内容范围 +// 下载 OKR 时的内容范围 // // 示例值： func (builder *AuditObjectDetailBuilder) OkrDownloadContent(okrDownloadContent string) *AuditObjectDetailBuilder { @@ -2574,7 +2574,7 @@ func (builder *AuditObjectDetailBuilder) OkrDownloadContent(okrDownloadContent s return builder } -// 容器类型，标识是否wiki +// 容器类型，标识是否 wiki // // 示例值： func (builder *AuditObjectDetailBuilder) ContainerType(containerType string) *AuditObjectDetailBuilder { @@ -2583,7 +2583,7 @@ func (builder *AuditObjectDetailBuilder) ContainerType(containerType string) *Au return builder } -// 容器id，wiki标识字段 +// 容器 id，wiki 标识字段 // // 示例值： func (builder *AuditObjectDetailBuilder) ContainerId(containerId string) *AuditObjectDetailBuilder { @@ -2660,7 +2660,7 @@ func (builder *AuditObjectDetailBuilder) Build() *AuditObjectDetail { type AuditObjectEntity struct { ObjectType *string `json:"object_type,omitempty"` // 操作对象类型 - ObjectValue *string `json:"object_value,omitempty"` // 操作对象值，可能存在department_id、user_id等，需要进行lark_id的转换 + ObjectValue *string `json:"object_value,omitempty"` // 操作对象值，可能存在 department_id、user_id 等，需要进行 lark_id 的转换 ObjectName *string `json:"object_name,omitempty"` // 操作对象名称，如会话名、文档名等 ObjectOwner *string `json:"object_owner,omitempty"` // 操作对象的所有者 ObjectDetail *AuditObjectDetail `json:"object_detail,omitempty"` // object 详情 @@ -2669,7 +2669,7 @@ type AuditObjectEntity struct { type AuditObjectEntityBuilder struct { objectType string // 操作对象类型 objectTypeFlag bool - objectValue string // 操作对象值，可能存在department_id、user_id等，需要进行lark_id的转换 + objectValue string // 操作对象值，可能存在 department_id、user_id 等，需要进行 lark_id 的转换 objectValueFlag bool objectName string // 操作对象名称，如会话名、文档名等 objectNameFlag bool @@ -2693,7 +2693,7 @@ func (builder *AuditObjectEntityBuilder) ObjectType(objectType string) *AuditObj return builder } -// 操作对象值，可能存在department_id、user_id等，需要进行lark_id的转换 +// 操作对象值，可能存在 department_id、user_id 等，需要进行 lark_id 的转换 // // 示例值： func (builder *AuditObjectEntityBuilder) ObjectValue(objectValue string) *AuditObjectEntityBuilder { @@ -2755,23 +2755,23 @@ func (builder *AuditObjectEntityBuilder) Build() *AuditObjectEntity { type AuditPcContext struct { Udid *string `json:"udid,omitempty"` // UDID - Did *string `json:"did,omitempty"` // 设备ID - AppVer *string `json:"app_ver,omitempty"` // app的版本 - Ver *string `json:"ver,omitempty"` // SecSDK版本 + Did *string `json:"did,omitempty"` // 设备 ID + AppVer *string `json:"app_ver,omitempty"` // app 的版本 + Ver *string `json:"ver,omitempty"` // SecSDK 版本 Os *string `json:"os,omitempty"` // 客户端类型 Wifip *string `json:"wifip,omitempty"` // wifi ip Region *string `json:"region,omitempty"` // 设备区域 - IP *string `json:"IP,omitempty"` // 公网ip + IP *string `json:"IP,omitempty"` // 公网 ip } type AuditPcContextBuilder struct { udid string // UDID udidFlag bool - did string // 设备ID + did string // 设备 ID didFlag bool - appVer string // app的版本 + appVer string // app 的版本 appVerFlag bool - ver string // SecSDK版本 + ver string // SecSDK 版本 verFlag bool os string // 客户端类型 osFlag bool @@ -2779,7 +2779,7 @@ type AuditPcContextBuilder struct { wifipFlag bool region string // 设备区域 regionFlag bool - iP string // 公网ip + iP string // 公网 ip iPFlag bool } @@ -2797,7 +2797,7 @@ func (builder *AuditPcContextBuilder) Udid(udid string) *AuditPcContextBuilder { return builder } -// 设备ID +// 设备 ID // // 示例值： func (builder *AuditPcContextBuilder) Did(did string) *AuditPcContextBuilder { @@ -2806,7 +2806,7 @@ func (builder *AuditPcContextBuilder) Did(did string) *AuditPcContextBuilder { return builder } -// app的版本 +// app 的版本 // // 示例值： func (builder *AuditPcContextBuilder) AppVer(appVer string) *AuditPcContextBuilder { @@ -2815,7 +2815,7 @@ func (builder *AuditPcContextBuilder) AppVer(appVer string) *AuditPcContextBuild return builder } -// SecSDK版本 +// SecSDK 版本 // // 示例值： func (builder *AuditPcContextBuilder) Ver(ver string) *AuditPcContextBuilder { @@ -2851,7 +2851,7 @@ func (builder *AuditPcContextBuilder) Region(region string) *AuditPcContextBuild return builder } -// 公网ip +// 公网 ip // // 示例值： func (builder *AuditPcContextBuilder) IP(iP string) *AuditPcContextBuilder { @@ -2931,14 +2931,14 @@ func (builder *AuditRecipientDetailBuilder) Build() *AuditRecipientDetail { type AuditRecipientEntity struct { RecipientType *string `json:"recipient_type,omitempty"` // 接收者对象类型 - RecipientValue *string `json:"recipient_value,omitempty"` // 接收者对象值，可能存在department_id、user_id等，需要进行lark_id的转换 + RecipientValue *string `json:"recipient_value,omitempty"` // 接收者对象值，可能存在 department_id、user_id 等，需要进行 lark_id 的转换 RecipientDetail *AuditRecipientDetail `json:"recipient_detail,omitempty"` // recipient 详情 } type AuditRecipientEntityBuilder struct { recipientType string // 接收者对象类型 recipientTypeFlag bool - recipientValue string // 接收者对象值，可能存在department_id、user_id等，需要进行lark_id的转换 + recipientValue string // 接收者对象值，可能存在 department_id、user_id 等，需要进行 lark_id 的转换 recipientValueFlag bool recipientDetail *AuditRecipientDetail // recipient 详情 recipientDetailFlag bool @@ -2958,7 +2958,7 @@ func (builder *AuditRecipientEntityBuilder) RecipientType(recipientType string) return builder } -// 接收者对象值，可能存在department_id、user_id等，需要进行lark_id的转换 +// 接收者对象值，可能存在 department_id、user_id 等，需要进行 lark_id 的转换 // // 示例值： func (builder *AuditRecipientEntityBuilder) RecipientValue(recipientValue string) *AuditRecipientEntityBuilder { @@ -2993,14 +2993,14 @@ func (builder *AuditRecipientEntityBuilder) Build() *AuditRecipientEntity { } type AuditWebContext struct { - UserAgent *string `json:"user_agent,omitempty"` // UA信息 - IP *string `json:"IP,omitempty"` // 本机IP + UserAgent *string `json:"user_agent,omitempty"` // UA 信息 + IP *string `json:"IP,omitempty"` // 本机 IP } type AuditWebContextBuilder struct { - userAgent string // UA信息 + userAgent string // UA 信息 userAgentFlag bool - iP string // 本机IP + iP string // 本机 IP iPFlag bool } @@ -3009,7 +3009,7 @@ func NewAuditWebContextBuilder() *AuditWebContextBuilder { return builder } -// UA信息 +// UA 信息 // // 示例值： func (builder *AuditWebContextBuilder) UserAgent(userAgent string) *AuditWebContextBuilder { @@ -3018,7 +3018,7 @@ func (builder *AuditWebContextBuilder) UserAgent(userAgent string) *AuditWebCont return builder } -// 本机IP +// 本机 IP // // 示例值： func (builder *AuditWebContextBuilder) IP(iP string) *AuditWebContextBuilder { @@ -3042,28 +3042,28 @@ func (builder *AuditWebContextBuilder) Build() *AuditWebContext { type Badge struct { Id *string `json:"id,omitempty"` // 租户内勋章的唯一标识，该值由系统随机生成。 - Name *string `json:"name,omitempty"` // 租户内唯一的勋章名称，最多30个字符。 - Explanation *string `json:"explanation,omitempty"` // 勋章的描述文案，最多100个字符。 - DetailImage *string `json:"detail_image,omitempty"` // 企业勋章的详情图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 - ShowImage *string `json:"show_image,omitempty"` // 企业勋章的头像挂饰图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 - I18nName *I18n `json:"i18n_name,omitempty"` // 勋章的多语言名称，同name字段限制，最多30个字符。 - I18nExplanation *I18n `json:"i18n_explanation,omitempty"` // 勋章的多语言描述文案，同explanation字段限制，最多100个字符。 + Name *string `json:"name,omitempty"` // 租户内唯一的勋章名称，最多 30 个字符。 + Explanation *string `json:"explanation,omitempty"` // 勋章的描述文案，最多 100 个字符。 + DetailImage *string `json:"detail_image,omitempty"` // 企业勋章的详情图 Key。1.权限校验：非本租户上传的图片 key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片 key 时，需使用 1h 内上传的图片 key。 + ShowImage *string `json:"show_image,omitempty"` // 企业勋章的头像挂饰图 Key。1.权限校验：非本租户上传的图片 key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片 key 时，需使用 1h 内上传的图片 key。 + I18nName *I18n `json:"i18n_name,omitempty"` // 勋章的多语言名称，同 name 字段限制，最多 30 个字符。 + I18nExplanation *I18n `json:"i18n_explanation,omitempty"` // 勋章的多语言描述文案，同 explanation 字段限制，最多 100 个字符。 } type BadgeBuilder struct { id string // 租户内勋章的唯一标识，该值由系统随机生成。 idFlag bool - name string // 租户内唯一的勋章名称，最多30个字符。 + name string // 租户内唯一的勋章名称，最多 30 个字符。 nameFlag bool - explanation string // 勋章的描述文案，最多100个字符。 + explanation string // 勋章的描述文案，最多 100 个字符。 explanationFlag bool - detailImage string // 企业勋章的详情图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 + detailImage string // 企业勋章的详情图 Key。1.权限校验：非本租户上传的图片 key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片 key 时，需使用 1h 内上传的图片 key。 detailImageFlag bool - showImage string // 企业勋章的头像挂饰图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 + showImage string // 企业勋章的头像挂饰图 Key。1.权限校验：非本租户上传的图片 key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片 key 时，需使用 1h 内上传的图片 key。 showImageFlag bool - i18nName *I18n // 勋章的多语言名称，同name字段限制，最多30个字符。 + i18nName *I18n // 勋章的多语言名称，同 name 字段限制，最多 30 个字符。 i18nNameFlag bool - i18nExplanation *I18n // 勋章的多语言描述文案，同explanation字段限制，最多100个字符。 + i18nExplanation *I18n // 勋章的多语言描述文案，同 explanation 字段限制，最多 100 个字符。 i18nExplanationFlag bool } @@ -3081,7 +3081,7 @@ func (builder *BadgeBuilder) Id(id string) *BadgeBuilder { return builder } -// 租户内唯一的勋章名称，最多30个字符。 +// 租户内唯一的勋章名称，最多 30 个字符。 // // 示例值：激励勋章 func (builder *BadgeBuilder) Name(name string) *BadgeBuilder { @@ -3090,7 +3090,7 @@ func (builder *BadgeBuilder) Name(name string) *BadgeBuilder { return builder } -// 勋章的描述文案，最多100个字符。 +// 勋章的描述文案，最多 100 个字符。 // // 示例值：这枚勋章为了激励员工颁发。 func (builder *BadgeBuilder) Explanation(explanation string) *BadgeBuilder { @@ -3099,7 +3099,7 @@ func (builder *BadgeBuilder) Explanation(explanation string) *BadgeBuilder { return builder } -// 企业勋章的详情图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 +// 企业勋章的详情图 Key。1.权限校验：非本租户上传的图片 key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片 key 时，需使用 1h 内上传的图片 key。 // // 示例值：75a1949f-d9df-4b46-bc88-dacc51e88f3j func (builder *BadgeBuilder) DetailImage(detailImage string) *BadgeBuilder { @@ -3108,7 +3108,7 @@ func (builder *BadgeBuilder) DetailImage(detailImage string) *BadgeBuilder { return builder } -// 企业勋章的头像挂饰图Key。1.权限校验：非本租户上传的图片key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片key时，需使用1h内上传的图片key。 +// 企业勋章的头像挂饰图 Key。1.权限校验：非本租户上传的图片 key，不能直接使用；2.时效校验：创建勋章，或者修改勋章图片 key 时，需使用 1h 内上传的图片 key。 // // 示例值：03daa74a-159f-49e9-963e-b6c4d76103fj func (builder *BadgeBuilder) ShowImage(showImage string) *BadgeBuilder { @@ -3117,7 +3117,7 @@ func (builder *BadgeBuilder) ShowImage(showImage string) *BadgeBuilder { return builder } -// 勋章的多语言名称，同name字段限制，最多30个字符。 +// 勋章的多语言名称，同 name 字段限制，最多 30 个字符。 // // 示例值：{ "zh_cn": "激励勋章", "en_us": "Incentive Medal", "ja_jp": "奨励メダル" } func (builder *BadgeBuilder) I18nName(i18nName *I18n) *BadgeBuilder { @@ -3126,7 +3126,7 @@ func (builder *BadgeBuilder) I18nName(i18nName *I18n) *BadgeBuilder { return builder } -// 勋章的多语言描述文案，同explanation字段限制，最多100个字符。 +// 勋章的多语言描述文案，同 explanation 字段限制，最多 100 个字符。 // // 示例值：{ "zh_cn": "这枚勋章为了激励员工颁发。", "en_us": "This medal is awarded to motivate employees.", "ja_jp": "このメダルは、従業員のモチベーションを高めるために授与されます。" } func (builder *BadgeBuilder) I18nExplanation(i18nExplanation *I18n) *BadgeBuilder { @@ -3173,7 +3173,7 @@ type File struct { Size *string `json:"size,omitempty"` // 文档大小 LastOpTime *string `json:"last_op_time,omitempty"` // 更新时间 Status *string `json:"status,omitempty"` // 文档状态 - Token *string `json:"token,omitempty"` // 文档token + Token *string `json:"token,omitempty"` // 文档 token } type FileBuilder struct { @@ -3189,7 +3189,7 @@ type FileBuilder struct { lastOpTimeFlag bool status string // 文档状态 statusFlag bool - token string // 文档token + token string // 文档 token tokenFlag bool } @@ -3252,7 +3252,7 @@ func (builder *FileBuilder) Status(status string) *FileBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doxbcOIyUhrRBWSKpBGfzefQgHe func (builder *FileBuilder) Token(token string) *FileBuilder { @@ -3294,11 +3294,11 @@ func (builder *FileBuilder) Build() *File { } type FileList struct { - Files []*File `json:"files,omitempty"` // 文档token + Files []*File `json:"files,omitempty"` // 文档 token } type FileListBuilder struct { - files []*File // 文档token + files []*File // 文档 token filesFlag bool } @@ -3307,7 +3307,7 @@ func NewFileListBuilder() *FileListBuilder { return builder } -// 文档token +// 文档 token // // 示例值： func (builder *FileListBuilder) Files(files []*File) *FileListBuilder { @@ -3326,37 +3326,37 @@ func (builder *FileListBuilder) Build() *FileList { type Grant struct { Id *string `json:"id,omitempty"` // 租户内授予名单的唯一标识，该值由系统随机生成。 - BadgeId *string `json:"badge_id,omitempty"` // 企业勋章的唯一ID - Name *string `json:"name,omitempty"` // 勋章下唯一的授予事项，最多100个字符。 + BadgeId *string `json:"badge_id,omitempty"` // 企业勋章的唯一 ID + Name *string `json:"name,omitempty"` // 勋章下唯一的授予事项，最多 100 个字符。 GrantType *int `json:"grant_type,omitempty"` // 授予名单类型 - TimeZone *string `json:"time_zone,omitempty"` // 授予名单的生效时间对应的时区，用于检查RuleDetail的时间戳的取值是否规范，取值范围为TZ database name + TimeZone *string `json:"time_zone,omitempty"` // 授予名单的生效时间对应的时区，用于检查 RuleDetail 的时间戳的取值是否规范，取值范围为 TZ database name RuleDetail *RuleDetail `json:"rule_detail,omitempty"` // 规则详情 - IsGrantAll *bool `json:"is_grant_all,omitempty"` // 是否授予给全员。1.为false时，需要关联1~500个用户群体。2.为true时，不可关联用户、用户组、部门。 - UserIds []string `json:"user_ids,omitempty"` // 授予的用户ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 - DepartmentIds []string `json:"department_ids,omitempty"` // 授予的部门ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 - GroupIds []string `json:"group_ids,omitempty"` // 授予的用户组ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 + IsGrantAll *bool `json:"is_grant_all,omitempty"` // 是否授予给全员。1.为 false 时，需要关联 1~500 个用户群体。2.为 true 时，不可关联用户、用户组、部门。 + UserIds []string `json:"user_ids,omitempty"` // 授予的用户 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 + DepartmentIds []string `json:"department_ids,omitempty"` // 授予的部门 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 + GroupIds []string `json:"group_ids,omitempty"` // 授予的用户组 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 } type GrantBuilder struct { id string // 租户内授予名单的唯一标识，该值由系统随机生成。 idFlag bool - badgeId string // 企业勋章的唯一ID + badgeId string // 企业勋章的唯一 ID badgeIdFlag bool - name string // 勋章下唯一的授予事项，最多100个字符。 + name string // 勋章下唯一的授予事项，最多 100 个字符。 nameFlag bool grantType int // 授予名单类型 grantTypeFlag bool - timeZone string // 授予名单的生效时间对应的时区，用于检查RuleDetail的时间戳的取值是否规范，取值范围为TZ database name + timeZone string // 授予名单的生效时间对应的时区，用于检查 RuleDetail 的时间戳的取值是否规范，取值范围为 TZ database name timeZoneFlag bool ruleDetail *RuleDetail // 规则详情 ruleDetailFlag bool - isGrantAll bool // 是否授予给全员。1.为false时，需要关联1~500个用户群体。2.为true时，不可关联用户、用户组、部门。 + isGrantAll bool // 是否授予给全员。1.为 false 时，需要关联 1~500 个用户群体。2.为 true 时，不可关联用户、用户组、部门。 isGrantAllFlag bool - userIds []string // 授予的用户ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 + userIds []string // 授予的用户 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 userIdsFlag bool - departmentIds []string // 授予的部门ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 + departmentIds []string // 授予的部门 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 departmentIdsFlag bool - groupIds []string // 授予的用户组ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 + groupIds []string // 授予的用户组 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 groupIdsFlag bool } @@ -3374,7 +3374,7 @@ func (builder *GrantBuilder) Id(id string) *GrantBuilder { return builder } -// 企业勋章的唯一ID +// 企业勋章的唯一 ID // // 示例值：m_qTR2HM func (builder *GrantBuilder) BadgeId(badgeId string) *GrantBuilder { @@ -3383,7 +3383,7 @@ func (builder *GrantBuilder) BadgeId(badgeId string) *GrantBuilder { return builder } -// 勋章下唯一的授予事项，最多100个字符。 +// 勋章下唯一的授予事项，最多 100 个字符。 // // 示例值：激励勋章的授予名单 func (builder *GrantBuilder) Name(name string) *GrantBuilder { @@ -3401,7 +3401,7 @@ func (builder *GrantBuilder) GrantType(grantType int) *GrantBuilder { return builder } -// 授予名单的生效时间对应的时区，用于检查RuleDetail的时间戳的取值是否规范，取值范围为TZ database name +// 授予名单的生效时间对应的时区，用于检查 RuleDetail 的时间戳的取值是否规范，取值范围为 TZ database name // // 示例值：Asia/Shanghai func (builder *GrantBuilder) TimeZone(timeZone string) *GrantBuilder { @@ -3419,7 +3419,7 @@ func (builder *GrantBuilder) RuleDetail(ruleDetail *RuleDetail) *GrantBuilder { return builder } -// 是否授予给全员。1.为false时，需要关联1~500个用户群体。2.为true时，不可关联用户、用户组、部门。 +// 是否授予给全员。1.为 false 时，需要关联 1~500 个用户群体。2.为 true 时，不可关联用户、用户组、部门。 // // 示例值：false func (builder *GrantBuilder) IsGrantAll(isGrantAll bool) *GrantBuilder { @@ -3428,7 +3428,7 @@ func (builder *GrantBuilder) IsGrantAll(isGrantAll bool) *GrantBuilder { return builder } -// 授予的用户ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 +// 授予的用户 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 // // 示例值：[u273y71] func (builder *GrantBuilder) UserIds(userIds []string) *GrantBuilder { @@ -3437,7 +3437,7 @@ func (builder *GrantBuilder) UserIds(userIds []string) *GrantBuilder { return builder } -// 授予的部门ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 +// 授予的部门 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 // // 示例值：[h121921] func (builder *GrantBuilder) DepartmentIds(departmentIds []string) *GrantBuilder { @@ -3446,7 +3446,7 @@ func (builder *GrantBuilder) DepartmentIds(departmentIds []string) *GrantBuilder return builder } -// 授予的用户组ID列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 +// 授予的用户组 ID 列表，授予名单列表接口返回结果中不返回该字段，只在详情接口返回 // // 示例值：[g122817] func (builder *GrantBuilder) GroupIds(groupIds []string) *GrantBuilder { @@ -3593,16 +3593,16 @@ func (builder *PasswordBuilder) Build() *Password { } type RuleDetail struct { - EffectiveTime *string `json:"effective_time,omitempty"` // 开始生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.时间戳必须是所在时区当天的零点时间戳，如时区为Asia/Shanghai时区时的1649606400 - ExpirationTime *string `json:"expiration_time,omitempty"` // 结束生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.最大值：不得超过effective_time+100 年；3.非永久有效：时间戳必须是所在时区当天的23:59:59时间戳，如时区为Asia/Shanghai时区时的1649692799；4.永久有效：传值为0即可 + EffectiveTime *string `json:"effective_time,omitempty"` // 开始生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.时间戳必须是所在时区当天的零点时间戳，如时区为 Asia/Shanghai 时区时的 1649606400 + ExpirationTime *string `json:"expiration_time,omitempty"` // 结束生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.最大值：不得超过 effective_time+100 年；3.非永久有效：时间戳必须是所在时区当天的 23:59:59 时间戳，如时区为 Asia/Shanghai 时区时的 1649692799；4.永久有效：传值为 0 即可 Anniversary *int `json:"anniversary,omitempty"` // 入职周年日。根据入职时间发放类型勋章，需要配置该字段。 EffectivePeriod *int `json:"effective_period,omitempty"` // 有效期限。根据入职时间发放类型勋章，需要配置该字段。 } type RuleDetailBuilder struct { - effectiveTime string // 开始生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.时间戳必须是所在时区当天的零点时间戳，如时区为Asia/Shanghai时区时的1649606400 + effectiveTime string // 开始生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.时间戳必须是所在时区当天的零点时间戳，如时区为 Asia/Shanghai 时区时的 1649606400 effectiveTimeFlag bool - expirationTime string // 结束生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.最大值：不得超过effective_time+100 年；3.非永久有效：时间戳必须是所在时区当天的23:59:59时间戳，如时区为Asia/Shanghai时区时的1649692799；4.永久有效：传值为0即可 + expirationTime string // 结束生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.最大值：不得超过 effective_time+100 年；3.非永久有效：时间戳必须是所在时区当天的 23:59:59 时间戳，如时区为 Asia/Shanghai 时区时的 1649692799；4.永久有效：传值为 0 即可 expirationTimeFlag bool anniversary int // 入职周年日。根据入职时间发放类型勋章，需要配置该字段。 anniversaryFlag bool @@ -3615,7 +3615,7 @@ func NewRuleDetailBuilder() *RuleDetailBuilder { return builder } -// 开始生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.时间戳必须是所在时区当天的零点时间戳，如时区为Asia/Shanghai时区时的1649606400 +// 开始生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.时间戳必须是所在时区当天的零点时间戳，如时区为 Asia/Shanghai 时区时的 1649606400 // // 示例值：1649606400 func (builder *RuleDetailBuilder) EffectiveTime(effectiveTime string) *RuleDetailBuilder { @@ -3624,7 +3624,7 @@ func (builder *RuleDetailBuilder) EffectiveTime(effectiveTime string) *RuleDetai return builder } -// 结束生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.最大值：不得超过effective_time+100 年；3.非永久有效：时间戳必须是所在时区当天的23:59:59时间戳，如时区为Asia/Shanghai时区时的1649692799；4.永久有效：传值为0即可 +// 结束生效的时间戳。1.手动设置有效期类型勋章，配置有效期限需要配置该字段；2.最大值：不得超过 effective_time+100 年；3.非永久有效：时间戳必须是所在时区当天的 23:59:59 时间戳，如时区为 Asia/Shanghai 时区时的 1649692799；4.永久有效：传值为 0 即可 // // 示例值：1649692799 func (builder *RuleDetailBuilder) ExpirationTime(expirationTime string) *RuleDetailBuilder { @@ -3674,7 +3674,7 @@ func (builder *RuleDetailBuilder) Build() *RuleDetail { type SplashPageStat struct { Date *string `json:"date,omitempty"` // 日期 - SplashId *string `json:"splash_id,omitempty"` // 开屏素材id + SplashId *string `json:"splash_id,omitempty"` // 开屏素材 id ImpressionCount *int `json:"impression_count,omitempty"` // 曝光数 ClickCount *int `json:"click_count,omitempty"` // 点击数 SkipCount *int `json:"skip_count,omitempty"` // 点击跳过数 @@ -3686,7 +3686,7 @@ type SplashPageStat struct { type SplashPageStatBuilder struct { date string // 日期 dateFlag bool - splashId string // 开屏素材id + splashId string // 开屏素材 id splashIdFlag bool impressionCount int // 曝光数 impressionCountFlag bool @@ -3716,7 +3716,7 @@ func (builder *SplashPageStatBuilder) Date(date string) *SplashPageStatBuilder { return builder } -// 开屏素材id +// 开屏素材 id // // 示例值： func (builder *SplashPageStatBuilder) SplashId(splashId string) *SplashPageStatBuilder { @@ -3817,23 +3817,23 @@ func (builder *SplashPageStatBuilder) Build() *SplashPageStat { } type Task struct { - OriginalUserId *string `json:"original_user_id,omitempty"` // 文档原所有者ID - TargetOwnerId *string `json:"target_owner_id,omitempty"` // 目标用户ID + OriginalUserId *string `json:"original_user_id,omitempty"` // 文档原所有者 ID + TargetOwnerId *string `json:"target_owner_id,omitempty"` // 目标用户 ID FileList []*File `json:"file_list,omitempty"` // 恢复文件列表 - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id Status *int `json:"status,omitempty"` // 任务状态 OriginalUserEmail *string `json:"original_user_email,omitempty"` // 文档原所有者邮箱 TargetOwnerEmail *string `json:"target_owner_email,omitempty"` // 文档新所有者邮箱 } type TaskBuilder struct { - originalUserId string // 文档原所有者ID + originalUserId string // 文档原所有者 ID originalUserIdFlag bool - targetOwnerId string // 目标用户ID + targetOwnerId string // 目标用户 ID targetOwnerIdFlag bool fileList []*File // 恢复文件列表 fileListFlag bool - taskId string // 任务id + taskId string // 任务 id taskIdFlag bool status int // 任务状态 statusFlag bool @@ -3848,7 +3848,7 @@ func NewTaskBuilder() *TaskBuilder { return builder } -// 文档原所有者ID +// 文档原所有者 ID // // 示例值： func (builder *TaskBuilder) OriginalUserId(originalUserId string) *TaskBuilder { @@ -3857,7 +3857,7 @@ func (builder *TaskBuilder) OriginalUserId(originalUserId string) *TaskBuilder { return builder } -// 目标用户ID +// 目标用户 ID // // 示例值： func (builder *TaskBuilder) TargetOwnerId(targetOwnerId string) *TaskBuilder { @@ -3875,7 +3875,7 @@ func (builder *TaskBuilder) FileList(fileList []*File) *TaskBuilder { return builder } -// 任务id +// 任务 id // // 示例值： func (builder *TaskBuilder) TaskId(taskId string) *TaskBuilder { @@ -3946,7 +3946,7 @@ func (builder *TaskBuilder) Build() *Task { type User struct { Name *string `json:"name,omitempty"` // 用户名称 Avatar *string `json:"avatar,omitempty"` // 用户头像 - Id *string `json:"id,omitempty"` // 用户ID + Id *string `json:"id,omitempty"` // 用户 ID } type UserBuilder struct { @@ -3954,7 +3954,7 @@ type UserBuilder struct { nameFlag bool avatar string // 用户头像 avatarFlag bool - id string // 用户ID + id string // 用户 ID idFlag bool } @@ -3981,7 +3981,7 @@ func (builder *UserBuilder) Avatar(avatar string) *UserBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：6994699009591869459 func (builder *UserBuilder) Id(id string) *UserBuilder { @@ -4008,14 +4008,14 @@ func (builder *UserBuilder) Build() *User { } type UserAnnualReport struct { - Year2021 *UserReport2021 `json:"year_2021,omitempty"` // 2021用户年度报告 - Year2022 *UserReport2022 `json:"year_2022,omitempty"` // 2022用户年度报告 + Year2021 *UserReport2021 `json:"year_2021,omitempty"` // 2021 用户年度报告 + Year2022 *UserReport2022 `json:"year_2022,omitempty"` // 2022 用户年度报告 } type UserAnnualReportBuilder struct { - year2021 *UserReport2021 // 2021用户年度报告 + year2021 *UserReport2021 // 2021 用户年度报告 year2021Flag bool - year2022 *UserReport2022 // 2022用户年度报告 + year2022 *UserReport2022 // 2022 用户年度报告 year2022Flag bool } @@ -4024,7 +4024,7 @@ func NewUserAnnualReportBuilder() *UserAnnualReportBuilder { return builder } -// 2021用户年度报告 +// 2021 用户年度报告 // // 示例值： func (builder *UserAnnualReportBuilder) Year2021(year2021 *UserReport2021) *UserAnnualReportBuilder { @@ -4033,7 +4033,7 @@ func (builder *UserAnnualReportBuilder) Year2021(year2021 *UserReport2021) *User return builder } -// 2022用户年度报告 +// 2022 用户年度报告 // // 示例值： func (builder *UserAnnualReportBuilder) Year2022(year2022 *UserReport2022) *UserAnnualReportBuilder { @@ -4054,9 +4054,9 @@ func (builder *UserAnnualReportBuilder) Build() *UserAnnualReport { } type UserReport2021 struct { - ActiveDayCount *int `json:"active_day_count,omitempty"` // 活跃时长> 0的天数 + ActiveDayCount *int `json:"active_day_count,omitempty"` // 活跃时长> 0 的天数 BusyWeek *string `json:"busy_week,omitempty"` // 工作日平均活跃最长的一周，「2021W10」格式 - P2pChatCount *string `json:"p2p_chat_count,omitempty"` // 单聊过的人数（仅限普通单聊，不包括bot等，不限本人是否有过发送消息） + P2pChatCount *string `json:"p2p_chat_count,omitempty"` // 单聊过的人数（仅限普通单聊，不包括 bot 等，不限本人是否有过发送消息） TalkedChatCount *string `json:"talked_chat_count,omitempty"` // 发过言的群数 FavoriteEmoji *string `json:"favorite_emoji,omitempty"` // 任何场景下发的表情次数最多的一个表情 ReactionCount *string `json:"reaction_count,omitempty"` // 本人使用快捷表情的次数 @@ -4068,25 +4068,25 @@ type UserReport2021 struct { CreateFileCount *string `json:"create_file_count,omitempty"` // 创建文档数 CooperateEditFileCount *string `json:"cooperate_edit_file_count,omitempty"` // 参与协作文档数 LikeRecordCount *string `json:"like_record_count,omitempty"` // 所属的文档共获得多少个点赞 - OkrCumOCount *string `json:"okr_cum_o_count,omitempty"` // 填写过的O的数量 - OkrCumKrCount *string `json:"okr_cum_kr_count,omitempty"` // 填写过的KR的数量 + OkrCumOCount *string `json:"okr_cum_o_count,omitempty"` // 填写过的 O 的数量 + OkrCumKrCount *string `json:"okr_cum_kr_count,omitempty"` // 填写过的 KR 的数量 OkrAlignedUserRankfirst *string `json:"okr_aligned_user_rankfirst,omitempty"` // 被对齐次数最多的用户 ApprovalStartCount *string `json:"approval_start_count,omitempty"` // 发起的审批流程数 ApprovalExecuteCount *string `json:"approval_execute_count,omitempty"` // 处理的审批流程数 ApprovalRelationUserRankfirst *string `json:"approval_relation_user_rankfirst,omitempty"` // 审批协作次数最多的用户（在同一个审批实例中出现过即算为审批协作） - UserId *string `json:"user_id,omitempty"` // 用户id + UserId *string `json:"user_id,omitempty"` // 用户 id BusyWeekSumDuration *string `json:"busy_week_sum_duration,omitempty"` // 工作日平均活跃最长的一周 的总活跃时长（分钟） BusyWeekMdate *string `json:"busy_week_mdate,omitempty"` // 工作日平均活跃最长的一周 的最早工作日 BusyWeekActDays *int `json:"busy_week_act_days,omitempty"` // 工作日平均活跃最长的一周 有活跃的工作日天数 - CreateReadUserCount *string `json:"create_read_user_count,omitempty"` // 创建的文档被XXX人阅读过 + CreateReadUserCount *string `json:"create_read_user_count,omitempty"` // 创建的文档被 XXX 人阅读过 } type UserReport2021Builder struct { - activeDayCount int // 活跃时长> 0的天数 + activeDayCount int // 活跃时长> 0 的天数 activeDayCountFlag bool busyWeek string // 工作日平均活跃最长的一周，「2021W10」格式 busyWeekFlag bool - p2pChatCount string // 单聊过的人数（仅限普通单聊，不包括bot等，不限本人是否有过发送消息） + p2pChatCount string // 单聊过的人数（仅限普通单聊，不包括 bot 等，不限本人是否有过发送消息） p2pChatCountFlag bool talkedChatCount string // 发过言的群数 talkedChatCountFlag bool @@ -4110,9 +4110,9 @@ type UserReport2021Builder struct { cooperateEditFileCountFlag bool likeRecordCount string // 所属的文档共获得多少个点赞 likeRecordCountFlag bool - okrCumOCount string // 填写过的O的数量 + okrCumOCount string // 填写过的 O 的数量 okrCumOCountFlag bool - okrCumKrCount string // 填写过的KR的数量 + okrCumKrCount string // 填写过的 KR 的数量 okrCumKrCountFlag bool okrAlignedUserRankfirst string // 被对齐次数最多的用户 okrAlignedUserRankfirstFlag bool @@ -4122,7 +4122,7 @@ type UserReport2021Builder struct { approvalExecuteCountFlag bool approvalRelationUserRankfirst string // 审批协作次数最多的用户（在同一个审批实例中出现过即算为审批协作） approvalRelationUserRankfirstFlag bool - userId string // 用户id + userId string // 用户 id userIdFlag bool busyWeekSumDuration string // 工作日平均活跃最长的一周 的总活跃时长（分钟） busyWeekSumDurationFlag bool @@ -4130,7 +4130,7 @@ type UserReport2021Builder struct { busyWeekMdateFlag bool busyWeekActDays int // 工作日平均活跃最长的一周 有活跃的工作日天数 busyWeekActDaysFlag bool - createReadUserCount string // 创建的文档被XXX人阅读过 + createReadUserCount string // 创建的文档被 XXX 人阅读过 createReadUserCountFlag bool } @@ -4139,7 +4139,7 @@ func NewUserReport2021Builder() *UserReport2021Builder { return builder } -// 活跃时长> 0的天数 +// 活跃时长> 0 的天数 // // 示例值：111 func (builder *UserReport2021Builder) ActiveDayCount(activeDayCount int) *UserReport2021Builder { @@ -4157,7 +4157,7 @@ func (builder *UserReport2021Builder) BusyWeek(busyWeek string) *UserReport2021B return builder } -// 单聊过的人数（仅限普通单聊，不包括bot等，不限本人是否有过发送消息） +// 单聊过的人数（仅限普通单聊，不包括 bot 等，不限本人是否有过发送消息） // // 示例值：3 func (builder *UserReport2021Builder) P2pChatCount(p2pChatCount string) *UserReport2021Builder { @@ -4265,7 +4265,7 @@ func (builder *UserReport2021Builder) LikeRecordCount(likeRecordCount string) *U return builder } -// 填写过的O的数量 +// 填写过的 O 的数量 // // 示例值：0 func (builder *UserReport2021Builder) OkrCumOCount(okrCumOCount string) *UserReport2021Builder { @@ -4274,7 +4274,7 @@ func (builder *UserReport2021Builder) OkrCumOCount(okrCumOCount string) *UserRep return builder } -// 填写过的KR的数量 +// 填写过的 KR 的数量 // // 示例值：0 func (builder *UserReport2021Builder) OkrCumKrCount(okrCumKrCount string) *UserReport2021Builder { @@ -4319,7 +4319,7 @@ func (builder *UserReport2021Builder) ApprovalRelationUserRankfirst(approvalRela return builder } -// 用户id +// 用户 id // // 示例值：ou_XXXXXXX func (builder *UserReport2021Builder) UserId(userId string) *UserReport2021Builder { @@ -4355,7 +4355,7 @@ func (builder *UserReport2021Builder) BusyWeekActDays(busyWeekActDays int) *User return builder } -// 创建的文档被XXX人阅读过 +// 创建的文档被 XXX 人阅读过 // // 示例值：10 func (builder *UserReport2021Builder) CreateReadUserCount(createReadUserCount string) *UserReport2021Builder { @@ -4470,92 +4470,92 @@ func (builder *UserReport2021Builder) Build() *UserReport2021 { } type UserReport2022 struct { - UserId *string `json:"user_id,omitempty"` // 用户id - UserRegisterDate *string `json:"user_register_date,omitempty"` // 用户的飞书激活日期，yyyyMMdd格式（201909之前的用户可能是空 - ActiveDayCount *int `json:"active_day_count,omitempty"` // 用户2022年内在飞书有活跃的天数 - MsgBusyDate *string `json:"msg_busy_date,omitempty"` // 2022全年用户发出消息条数最多的一天，yyyyMMdd格式 + UserId *string `json:"user_id,omitempty"` // 用户 id + UserRegisterDate *string `json:"user_register_date,omitempty"` // 用户的飞书激活日期，yyyyMMdd 格式（201909 之前的用户可能是空 + ActiveDayCount *int `json:"active_day_count,omitempty"` // 用户 2022 年内在飞书有活跃的天数 + MsgBusyDate *string `json:"msg_busy_date,omitempty"` // 2022 全年用户发出消息条数最多的一天，yyyyMMdd 格式 MsgBusyDateSendMsgCount *string `json:"msg_busy_date_send_msg_count,omitempty"` // 全年发消息最多一天，发出的消息数 - P2pChatCount *string `json:"p2p_chat_count,omitempty"` // 2022全年与此用户有过单聊的人数（双方任意一人发出过消息即计入） - TalkedChatCount *string `json:"talked_chat_count,omitempty"` // 2022全年用户有过发言的飞书群的数量 - PositiveReactionCount *string `json:"positive_reaction_count,omitempty"` // 2022全年用户所发消息，收到点赞、送心、碰拳等正面表情回复的总次数 - FirstPositiveReaction *string `json:"first_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第1的表情 - SecondPositiveReaction *string `json:"second_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第2的表情 - ThirdPositiveReaction *string `json:"third_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第3的表情 - FourthPositiveReaction *string `json:"fourth_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第4的表情 - FifthPositiveReaction *string `json:"fifth_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第5的表情 - CreateFileCount *string `json:"create_file_count,omitempty"` // 2022全年用户本人创建过的飞书文档数量 - CreatedFileViewCount *string `json:"created_file_view_count,omitempty"` // 此用户2022年创建的飞书文档的总阅读人数（含自己） - CommentFileCount *string `json:"comment_file_count,omitempty"` // 2022全年用户发表过评论的飞书文档数量 - AttendEventCount *string `json:"attend_event_count,omitempty"` // 2022全年用户的日程总数（主日历日程，排除被删除的日程及用户拒绝、移除的日程，包括全天日程和重复日程，重复日程在周期内计算为多次） - EventBusyDate *string `json:"event_busy_date,omitempty"` // 2022全年用户日程数量最多的一天，yyyyMMdd格式 + P2pChatCount *string `json:"p2p_chat_count,omitempty"` // 2022 全年与此用户有过单聊的人数（双方任意一人发出过消息即计入） + TalkedChatCount *string `json:"talked_chat_count,omitempty"` // 2022 全年用户有过发言的飞书群的数量 + PositiveReactionCount *string `json:"positive_reaction_count,omitempty"` // 2022 全年用户所发消息，收到点赞、送心、碰拳等正面表情回复的总次数 + FirstPositiveReaction *string `json:"first_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第 1 的表情 + SecondPositiveReaction *string `json:"second_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第 2 的表情 + ThirdPositiveReaction *string `json:"third_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第 3 的表情 + FourthPositiveReaction *string `json:"fourth_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第 4 的表情 + FifthPositiveReaction *string `json:"fifth_positive_reaction,omitempty"` // 用户所收到的正向表情回复，排第 5 的表情 + CreateFileCount *string `json:"create_file_count,omitempty"` // 2022 全年用户本人创建过的飞书文档数量 + CreatedFileViewCount *string `json:"created_file_view_count,omitempty"` // 此用户 2022 年创建的飞书文档的总阅读人数（含自己） + CommentFileCount *string `json:"comment_file_count,omitempty"` // 2022 全年用户发表过评论的飞书文档数量 + AttendEventCount *string `json:"attend_event_count,omitempty"` // 2022 全年用户的日程总数（主日历日程，排除被删除的日程及用户拒绝、移除的日程，包括全天日程和重复日程，重复日程在周期内计算为多次） + EventBusyDate *string `json:"event_busy_date,omitempty"` // 2022 全年用户日程数量最多的一天，yyyyMMdd 格式 EventBusyDateEventCount *string `json:"event_busy_date_event_count,omitempty"` // 日程最多一天的日程数量 - EventStartTimeRange1 *string `json:"event_start_time_range1,omitempty"` // 2022全年，此用户最经常的日程开始时间，精确到分钟，HH:mm格式 - ConferenceCreateCount *string `json:"conference_create_count,omitempty"` // 2022全年，基于此用户所创建的日程，发起了视频会议的次数 - TotalPartiCount *string `json:"total_parti_count,omitempty"` // 2022全年，基于此用户所创建的日程发起的视频会议，涉及的参会总人次 - OkrCumOCount *string `json:"okr_cum_o_count,omitempty"` // 2022全年此用户写过的O的数量（未删除） - OkrCumKrCount *string `json:"okr_cum_kr_count,omitempty"` // 2022全年此用户写过的KR的数量（未删除） - OkrAlignedUserCount *string `json:"okr_aligned_user_count,omitempty"` // 2022全年用户所写的OKR对齐过的去重人数（未删除） - PeopleInterviewNum *string `json:"people_interview_num,omitempty"` // 2022全年用户在飞书招聘上进行的面试总场次（候选人是海外账号的未参与计算） - SendEmailCount *string `json:"send_email_count,omitempty"` // 2022全年此用户发出邮件数量 - ReceiveEmailCount *string `json:"receive_email_count,omitempty"` // 2022全年此用户收到邮件数量 + EventStartTimeRange1 *string `json:"event_start_time_range1,omitempty"` // 2022 全年，此用户最经常的日程开始时间，精确到分钟，HH:mm 格式 + ConferenceCreateCount *string `json:"conference_create_count,omitempty"` // 2022 全年，基于此用户所创建的日程，发起了视频会议的次数 + TotalPartiCount *string `json:"total_parti_count,omitempty"` // 2022 全年，基于此用户所创建的日程发起的视频会议，涉及的参会总人次 + OkrCumOCount *string `json:"okr_cum_o_count,omitempty"` // 2022 全年此用户写过的 O 的数量（未删除） + OkrCumKrCount *string `json:"okr_cum_kr_count,omitempty"` // 2022 全年此用户写过的 KR 的数量（未删除） + OkrAlignedUserCount *string `json:"okr_aligned_user_count,omitempty"` // 2022 全年用户所写的 OKR 对齐过的去重人数（未删除） + PeopleInterviewNum *string `json:"people_interview_num,omitempty"` // 2022 全年用户在飞书招聘上进行的面试总场次（候选人是海外账号的未参与计算） + SendEmailCount *string `json:"send_email_count,omitempty"` // 2022 全年此用户发出邮件数量 + ReceiveEmailCount *string `json:"receive_email_count,omitempty"` // 2022 全年此用户收到邮件数量 } type UserReport2022Builder struct { - userId string // 用户id + userId string // 用户 id userIdFlag bool - userRegisterDate string // 用户的飞书激活日期，yyyyMMdd格式（201909之前的用户可能是空 + userRegisterDate string // 用户的飞书激活日期，yyyyMMdd 格式（201909 之前的用户可能是空 userRegisterDateFlag bool - activeDayCount int // 用户2022年内在飞书有活跃的天数 + activeDayCount int // 用户 2022 年内在飞书有活跃的天数 activeDayCountFlag bool - msgBusyDate string // 2022全年用户发出消息条数最多的一天，yyyyMMdd格式 + msgBusyDate string // 2022 全年用户发出消息条数最多的一天，yyyyMMdd 格式 msgBusyDateFlag bool msgBusyDateSendMsgCount string // 全年发消息最多一天，发出的消息数 msgBusyDateSendMsgCountFlag bool - p2pChatCount string // 2022全年与此用户有过单聊的人数（双方任意一人发出过消息即计入） + p2pChatCount string // 2022 全年与此用户有过单聊的人数（双方任意一人发出过消息即计入） p2pChatCountFlag bool - talkedChatCount string // 2022全年用户有过发言的飞书群的数量 + talkedChatCount string // 2022 全年用户有过发言的飞书群的数量 talkedChatCountFlag bool - positiveReactionCount string // 2022全年用户所发消息，收到点赞、送心、碰拳等正面表情回复的总次数 + positiveReactionCount string // 2022 全年用户所发消息，收到点赞、送心、碰拳等正面表情回复的总次数 positiveReactionCountFlag bool - firstPositiveReaction string // 用户所收到的正向表情回复，排第1的表情 + firstPositiveReaction string // 用户所收到的正向表情回复，排第 1 的表情 firstPositiveReactionFlag bool - secondPositiveReaction string // 用户所收到的正向表情回复，排第2的表情 + secondPositiveReaction string // 用户所收到的正向表情回复，排第 2 的表情 secondPositiveReactionFlag bool - thirdPositiveReaction string // 用户所收到的正向表情回复，排第3的表情 + thirdPositiveReaction string // 用户所收到的正向表情回复，排第 3 的表情 thirdPositiveReactionFlag bool - fourthPositiveReaction string // 用户所收到的正向表情回复，排第4的表情 + fourthPositiveReaction string // 用户所收到的正向表情回复，排第 4 的表情 fourthPositiveReactionFlag bool - fifthPositiveReaction string // 用户所收到的正向表情回复，排第5的表情 + fifthPositiveReaction string // 用户所收到的正向表情回复，排第 5 的表情 fifthPositiveReactionFlag bool - createFileCount string // 2022全年用户本人创建过的飞书文档数量 + createFileCount string // 2022 全年用户本人创建过的飞书文档数量 createFileCountFlag bool - createdFileViewCount string // 此用户2022年创建的飞书文档的总阅读人数（含自己） + createdFileViewCount string // 此用户 2022 年创建的飞书文档的总阅读人数（含自己） createdFileViewCountFlag bool - commentFileCount string // 2022全年用户发表过评论的飞书文档数量 + commentFileCount string // 2022 全年用户发表过评论的飞书文档数量 commentFileCountFlag bool - attendEventCount string // 2022全年用户的日程总数（主日历日程，排除被删除的日程及用户拒绝、移除的日程，包括全天日程和重复日程，重复日程在周期内计算为多次） + attendEventCount string // 2022 全年用户的日程总数（主日历日程，排除被删除的日程及用户拒绝、移除的日程，包括全天日程和重复日程，重复日程在周期内计算为多次） attendEventCountFlag bool - eventBusyDate string // 2022全年用户日程数量最多的一天，yyyyMMdd格式 + eventBusyDate string // 2022 全年用户日程数量最多的一天，yyyyMMdd 格式 eventBusyDateFlag bool eventBusyDateEventCount string // 日程最多一天的日程数量 eventBusyDateEventCountFlag bool - eventStartTimeRange1 string // 2022全年，此用户最经常的日程开始时间，精确到分钟，HH:mm格式 + eventStartTimeRange1 string // 2022 全年，此用户最经常的日程开始时间，精确到分钟，HH:mm 格式 eventStartTimeRange1Flag bool - conferenceCreateCount string // 2022全年，基于此用户所创建的日程，发起了视频会议的次数 + conferenceCreateCount string // 2022 全年，基于此用户所创建的日程，发起了视频会议的次数 conferenceCreateCountFlag bool - totalPartiCount string // 2022全年，基于此用户所创建的日程发起的视频会议，涉及的参会总人次 + totalPartiCount string // 2022 全年，基于此用户所创建的日程发起的视频会议，涉及的参会总人次 totalPartiCountFlag bool - okrCumOCount string // 2022全年此用户写过的O的数量（未删除） + okrCumOCount string // 2022 全年此用户写过的 O 的数量（未删除） okrCumOCountFlag bool - okrCumKrCount string // 2022全年此用户写过的KR的数量（未删除） + okrCumKrCount string // 2022 全年此用户写过的 KR 的数量（未删除） okrCumKrCountFlag bool - okrAlignedUserCount string // 2022全年用户所写的OKR对齐过的去重人数（未删除） + okrAlignedUserCount string // 2022 全年用户所写的 OKR 对齐过的去重人数（未删除） okrAlignedUserCountFlag bool - peopleInterviewNum string // 2022全年用户在飞书招聘上进行的面试总场次（候选人是海外账号的未参与计算） + peopleInterviewNum string // 2022 全年用户在飞书招聘上进行的面试总场次（候选人是海外账号的未参与计算） peopleInterviewNumFlag bool - sendEmailCount string // 2022全年此用户发出邮件数量 + sendEmailCount string // 2022 全年此用户发出邮件数量 sendEmailCountFlag bool - receiveEmailCount string // 2022全年此用户收到邮件数量 + receiveEmailCount string // 2022 全年此用户收到邮件数量 receiveEmailCountFlag bool } @@ -4564,7 +4564,7 @@ func NewUserReport2022Builder() *UserReport2022Builder { return builder } -// 用户id +// 用户 id // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *UserReport2022Builder) UserId(userId string) *UserReport2022Builder { @@ -4573,7 +4573,7 @@ func (builder *UserReport2022Builder) UserId(userId string) *UserReport2022Build return builder } -// 用户的飞书激活日期，yyyyMMdd格式（201909之前的用户可能是空 +// 用户的飞书激活日期，yyyyMMdd 格式（201909 之前的用户可能是空 // // 示例值：20220726 func (builder *UserReport2022Builder) UserRegisterDate(userRegisterDate string) *UserReport2022Builder { @@ -4582,7 +4582,7 @@ func (builder *UserReport2022Builder) UserRegisterDate(userRegisterDate string) return builder } -// 用户2022年内在飞书有活跃的天数 +// 用户 2022 年内在飞书有活跃的天数 // // 示例值：120 func (builder *UserReport2022Builder) ActiveDayCount(activeDayCount int) *UserReport2022Builder { @@ -4591,7 +4591,7 @@ func (builder *UserReport2022Builder) ActiveDayCount(activeDayCount int) *UserRe return builder } -// 2022全年用户发出消息条数最多的一天，yyyyMMdd格式 +// 2022 全年用户发出消息条数最多的一天，yyyyMMdd 格式 // // 示例值：20220817 func (builder *UserReport2022Builder) MsgBusyDate(msgBusyDate string) *UserReport2022Builder { @@ -4609,7 +4609,7 @@ func (builder *UserReport2022Builder) MsgBusyDateSendMsgCount(msgBusyDateSendMsg return builder } -// 2022全年与此用户有过单聊的人数（双方任意一人发出过消息即计入） +// 2022 全年与此用户有过单聊的人数（双方任意一人发出过消息即计入） // // 示例值：22 func (builder *UserReport2022Builder) P2pChatCount(p2pChatCount string) *UserReport2022Builder { @@ -4618,7 +4618,7 @@ func (builder *UserReport2022Builder) P2pChatCount(p2pChatCount string) *UserRep return builder } -// 2022全年用户有过发言的飞书群的数量 +// 2022 全年用户有过发言的飞书群的数量 // // 示例值：18 func (builder *UserReport2022Builder) TalkedChatCount(talkedChatCount string) *UserReport2022Builder { @@ -4627,7 +4627,7 @@ func (builder *UserReport2022Builder) TalkedChatCount(talkedChatCount string) *U return builder } -// 2022全年用户所发消息，收到点赞、送心、碰拳等正面表情回复的总次数 +// 2022 全年用户所发消息，收到点赞、送心、碰拳等正面表情回复的总次数 // // 示例值：100 func (builder *UserReport2022Builder) PositiveReactionCount(positiveReactionCount string) *UserReport2022Builder { @@ -4636,7 +4636,7 @@ func (builder *UserReport2022Builder) PositiveReactionCount(positiveReactionCoun return builder } -// 用户所收到的正向表情回复，排第1的表情 +// 用户所收到的正向表情回复，排第 1 的表情 // // 示例值：thumbsup func (builder *UserReport2022Builder) FirstPositiveReaction(firstPositiveReaction string) *UserReport2022Builder { @@ -4645,7 +4645,7 @@ func (builder *UserReport2022Builder) FirstPositiveReaction(firstPositiveReactio return builder } -// 用户所收到的正向表情回复，排第2的表情 +// 用户所收到的正向表情回复，排第 2 的表情 // // 示例值：muscle func (builder *UserReport2022Builder) SecondPositiveReaction(secondPositiveReaction string) *UserReport2022Builder { @@ -4654,7 +4654,7 @@ func (builder *UserReport2022Builder) SecondPositiveReaction(secondPositiveReact return builder } -// 用户所收到的正向表情回复，排第3的表情 +// 用户所收到的正向表情回复，排第 3 的表情 // // 示例值：fingerheart func (builder *UserReport2022Builder) ThirdPositiveReaction(thirdPositiveReaction string) *UserReport2022Builder { @@ -4663,7 +4663,7 @@ func (builder *UserReport2022Builder) ThirdPositiveReaction(thirdPositiveReactio return builder } -// 用户所收到的正向表情回复，排第4的表情 +// 用户所收到的正向表情回复，排第 4 的表情 // // 示例值：applaud func (builder *UserReport2022Builder) FourthPositiveReaction(fourthPositiveReaction string) *UserReport2022Builder { @@ -4672,7 +4672,7 @@ func (builder *UserReport2022Builder) FourthPositiveReaction(fourthPositiveReact return builder } -// 用户所收到的正向表情回复，排第5的表情 +// 用户所收到的正向表情回复，排第 5 的表情 // // 示例值：fistbump func (builder *UserReport2022Builder) FifthPositiveReaction(fifthPositiveReaction string) *UserReport2022Builder { @@ -4681,7 +4681,7 @@ func (builder *UserReport2022Builder) FifthPositiveReaction(fifthPositiveReactio return builder } -// 2022全年用户本人创建过的飞书文档数量 +// 2022 全年用户本人创建过的飞书文档数量 // // 示例值：12 func (builder *UserReport2022Builder) CreateFileCount(createFileCount string) *UserReport2022Builder { @@ -4690,7 +4690,7 @@ func (builder *UserReport2022Builder) CreateFileCount(createFileCount string) *U return builder } -// 此用户2022年创建的飞书文档的总阅读人数（含自己） +// 此用户 2022 年创建的飞书文档的总阅读人数（含自己） // // 示例值：11 func (builder *UserReport2022Builder) CreatedFileViewCount(createdFileViewCount string) *UserReport2022Builder { @@ -4699,7 +4699,7 @@ func (builder *UserReport2022Builder) CreatedFileViewCount(createdFileViewCount return builder } -// 2022全年用户发表过评论的飞书文档数量 +// 2022 全年用户发表过评论的飞书文档数量 // // 示例值：11 func (builder *UserReport2022Builder) CommentFileCount(commentFileCount string) *UserReport2022Builder { @@ -4708,7 +4708,7 @@ func (builder *UserReport2022Builder) CommentFileCount(commentFileCount string) return builder } -// 2022全年用户的日程总数（主日历日程，排除被删除的日程及用户拒绝、移除的日程，包括全天日程和重复日程，重复日程在周期内计算为多次） +// 2022 全年用户的日程总数（主日历日程，排除被删除的日程及用户拒绝、移除的日程，包括全天日程和重复日程，重复日程在周期内计算为多次） // // 示例值：123 func (builder *UserReport2022Builder) AttendEventCount(attendEventCount string) *UserReport2022Builder { @@ -4717,7 +4717,7 @@ func (builder *UserReport2022Builder) AttendEventCount(attendEventCount string) return builder } -// 2022全年用户日程数量最多的一天，yyyyMMdd格式 +// 2022 全年用户日程数量最多的一天，yyyyMMdd 格式 // // 示例值：20220801 func (builder *UserReport2022Builder) EventBusyDate(eventBusyDate string) *UserReport2022Builder { @@ -4735,7 +4735,7 @@ func (builder *UserReport2022Builder) EventBusyDateEventCount(eventBusyDateEvent return builder } -// 2022全年，此用户最经常的日程开始时间，精确到分钟，HH:mm格式 +// 2022 全年，此用户最经常的日程开始时间，精确到分钟，HH:mm 格式 // // 示例值：10:00 func (builder *UserReport2022Builder) EventStartTimeRange1(eventStartTimeRange1 string) *UserReport2022Builder { @@ -4744,7 +4744,7 @@ func (builder *UserReport2022Builder) EventStartTimeRange1(eventStartTimeRange1 return builder } -// 2022全年，基于此用户所创建的日程，发起了视频会议的次数 +// 2022 全年，基于此用户所创建的日程，发起了视频会议的次数 // // 示例值：123 func (builder *UserReport2022Builder) ConferenceCreateCount(conferenceCreateCount string) *UserReport2022Builder { @@ -4753,7 +4753,7 @@ func (builder *UserReport2022Builder) ConferenceCreateCount(conferenceCreateCoun return builder } -// 2022全年，基于此用户所创建的日程发起的视频会议，涉及的参会总人次 +// 2022 全年，基于此用户所创建的日程发起的视频会议，涉及的参会总人次 // // 示例值：123 func (builder *UserReport2022Builder) TotalPartiCount(totalPartiCount string) *UserReport2022Builder { @@ -4762,7 +4762,7 @@ func (builder *UserReport2022Builder) TotalPartiCount(totalPartiCount string) *U return builder } -// 2022全年此用户写过的O的数量（未删除） +// 2022 全年此用户写过的 O 的数量（未删除） // // 示例值：123 func (builder *UserReport2022Builder) OkrCumOCount(okrCumOCount string) *UserReport2022Builder { @@ -4771,7 +4771,7 @@ func (builder *UserReport2022Builder) OkrCumOCount(okrCumOCount string) *UserRep return builder } -// 2022全年此用户写过的KR的数量（未删除） +// 2022 全年此用户写过的 KR 的数量（未删除） // // 示例值：123 func (builder *UserReport2022Builder) OkrCumKrCount(okrCumKrCount string) *UserReport2022Builder { @@ -4780,7 +4780,7 @@ func (builder *UserReport2022Builder) OkrCumKrCount(okrCumKrCount string) *UserR return builder } -// 2022全年用户所写的OKR对齐过的去重人数（未删除） +// 2022 全年用户所写的 OKR 对齐过的去重人数（未删除） // // 示例值：123 func (builder *UserReport2022Builder) OkrAlignedUserCount(okrAlignedUserCount string) *UserReport2022Builder { @@ -4789,7 +4789,7 @@ func (builder *UserReport2022Builder) OkrAlignedUserCount(okrAlignedUserCount st return builder } -// 2022全年用户在飞书招聘上进行的面试总场次（候选人是海外账号的未参与计算） +// 2022 全年用户在飞书招聘上进行的面试总场次（候选人是海外账号的未参与计算） // // 示例值：123 func (builder *UserReport2022Builder) PeopleInterviewNum(peopleInterviewNum string) *UserReport2022Builder { @@ -4798,7 +4798,7 @@ func (builder *UserReport2022Builder) PeopleInterviewNum(peopleInterviewNum stri return builder } -// 2022全年此用户发出邮件数量 +// 2022 全年此用户发出邮件数量 // // 示例值：123 func (builder *UserReport2022Builder) SendEmailCount(sendEmailCount string) *UserReport2022Builder { @@ -4807,7 +4807,7 @@ func (builder *UserReport2022Builder) SendEmailCount(sendEmailCount string) *Use return builder } -// 2022全年此用户收到邮件数量 +// 2022 全年此用户收到邮件数量 // // 示例值：123 func (builder *UserReport2022Builder) ReceiveEmailCount(receiveEmailCount string) *UserReport2022Builder { @@ -4946,7 +4946,7 @@ func NewListAdminDeptStatReqBuilder() *ListAdminDeptStatReqBuilder { return builder } -// 部门ID类型 +// 部门 ID 类型 // // 示例值：open_department_id func (builder *ListAdminDeptStatReqBuilder) DepartmentIdType(departmentIdType string) *ListAdminDeptStatReqBuilder { @@ -4954,7 +4954,7 @@ func (builder *ListAdminDeptStatReqBuilder) DepartmentIdType(departmentIdType st return builder } -// 起始日期（包含），格式是YYYY-mm-dd +// 起始日期（包含），格式是 YYYY-mm-dd // // 示例值：2020-02-15 func (builder *ListAdminDeptStatReqBuilder) StartDate(startDate string) *ListAdminDeptStatReqBuilder { @@ -4962,7 +4962,7 @@ func (builder *ListAdminDeptStatReqBuilder) StartDate(startDate string) *ListAdm return builder } -// 终止日期（包含），格式是YYYY-mm-dd，起止日期之间相差不能超过91天（包含91天） +// 终止日期（包含），格式是 YYYY-mm-dd，起止日期之间相差不能超过 91 天（包含 91 天） // // 示例值：2020-02-15 func (builder *ListAdminDeptStatReqBuilder) EndDate(endDate string) *ListAdminDeptStatReqBuilder { @@ -4970,7 +4970,7 @@ func (builder *ListAdminDeptStatReqBuilder) EndDate(endDate string) *ListAdminDe return builder } -// 部门的 ID，取决于department_id_type，仅支持根部门及其下前4级子部门 +// 部门的 ID，取决于 department_id_type，仅支持根部门及其下前 4 级子部门 // // 示例值：od-382e2793cfc9471f892e8a672987654c func (builder *ListAdminDeptStatReqBuilder) DepartmentId(departmentId string) *ListAdminDeptStatReqBuilder { @@ -4978,7 +4978,7 @@ func (builder *ListAdminDeptStatReqBuilder) DepartmentId(departmentId string) *L return builder } -// 是否包含子部门，如果该值为false，则只查出本部门直属用户活跃和功能使用数据；如果该值为true，则查出该部门以及其子部门（子部门层级最多不超过根部门下的前4级）的用户活跃和功能使用数据 +// 是否包含子部门，如果该值为 false，则只查出本部门直属用户活跃和功能使用数据；如果该值为 true，则查出该部门以及其子部门（子部门层级最多不超过根部门下的前 4 级）的用户活跃和功能使用数据 // // 示例值：false func (builder *ListAdminDeptStatReqBuilder) ContainsChildDept(containsChildDept bool) *ListAdminDeptStatReqBuilder { @@ -4986,7 +4986,7 @@ func (builder *ListAdminDeptStatReqBuilder) ContainsChildDept(containsChildDept return builder } -// 分页大小，默认是10 +// 分页大小，默认是 10 // // 示例值：10 func (builder *ListAdminDeptStatReqBuilder) PageSize(pageSize int) *ListAdminDeptStatReqBuilder { @@ -4994,7 +4994,7 @@ func (builder *ListAdminDeptStatReqBuilder) PageSize(pageSize int) *ListAdminDep return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；当返回的has_more为true时，会返回新的page_token，再次调用接口，传入这个page_token，将获得下一页数据 +// 分页标记，第一次请求不填，表示从头开始遍历；当返回的 has_more 为 true 时，会返回新的 page_token，再次调用接口，传入这个 page_token，将获得下一页数据 // // 示例值：2 func (builder *ListAdminDeptStatReqBuilder) PageToken(pageToken string) *ListAdminDeptStatReqBuilder { @@ -5015,7 +5015,7 @@ type ListAdminDeptStatReq struct { type ListAdminDeptStatRespData struct { HasMore *bool `json:"has_more,omitempty"` // 分页查询时返回，代表是否还有更多数据 - PageToken *string `json:"page_token,omitempty"` // 分页标记，下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 分页标记，下一页分页的 token Items []*AdminDeptStat `json:"items,omitempty"` // 数据报表 } @@ -5042,7 +5042,7 @@ func NewListAdminUserStatReqBuilder() *ListAdminUserStatReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListAdminUserStatReqBuilder) UserIdType(userIdType string) *ListAdminUserStatReqBuilder { @@ -5050,7 +5050,7 @@ func (builder *ListAdminUserStatReqBuilder) UserIdType(userIdType string) *ListA return builder } -// 部门ID类型 +// 部门 ID 类型 // // 示例值：open_department_id func (builder *ListAdminUserStatReqBuilder) DepartmentIdType(departmentIdType string) *ListAdminUserStatReqBuilder { @@ -5058,7 +5058,7 @@ func (builder *ListAdminUserStatReqBuilder) DepartmentIdType(departmentIdType st return builder } -// 起始日期（包含），格式是YYYY-mm-dd +// 起始日期（包含），格式是 YYYY-mm-dd // // 示例值：2020-02-15 func (builder *ListAdminUserStatReqBuilder) StartDate(startDate string) *ListAdminUserStatReqBuilder { @@ -5066,7 +5066,7 @@ func (builder *ListAdminUserStatReqBuilder) StartDate(startDate string) *ListAdm return builder } -// 终止日期（包含），格式是YYYY-mm-dd。起止日期之间相差不能超过31天（包含31天） +// 终止日期（包含），格式是 YYYY-mm-dd。起止日期之间相差不能超过 31 天（包含 31 天） // // 示例值：2020-02-15 func (builder *ListAdminUserStatReqBuilder) EndDate(endDate string) *ListAdminUserStatReqBuilder { @@ -5074,7 +5074,7 @@ func (builder *ListAdminUserStatReqBuilder) EndDate(endDate string) *ListAdminUs return builder } -// 部门的 ID，取决于department_id_type +// 部门的 ID，取决于 department_id_type // // 示例值：od-382e2793cfc9471f892e8a672987654c func (builder *ListAdminUserStatReqBuilder) DepartmentId(departmentId string) *ListAdminUserStatReqBuilder { @@ -5082,7 +5082,7 @@ func (builder *ListAdminUserStatReqBuilder) DepartmentId(departmentId string) *L return builder } -// 用户的open_id，user_id或者union_id，取决于user_id_type +// 用户的 open_id，user_id 或者 union_id，取决于 user_id_type // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *ListAdminUserStatReqBuilder) UserId(userId string) *ListAdminUserStatReqBuilder { @@ -5090,7 +5090,7 @@ func (builder *ListAdminUserStatReqBuilder) UserId(userId string) *ListAdminUser return builder } -// 分页大小，默认是10 +// 分页大小，默认是 10 // // 示例值：10 func (builder *ListAdminUserStatReqBuilder) PageSize(pageSize int) *ListAdminUserStatReqBuilder { @@ -5098,7 +5098,7 @@ func (builder *ListAdminUserStatReqBuilder) PageSize(pageSize int) *ListAdminUse return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；当返回的has_more为true时，会返回新的page_token，再次调用接口，传入这个page_token，将获得下一页数据 +// 分页标记，第一次请求不填，表示从头开始遍历；当返回的 has_more 为 true 时，会返回新的 page_token，再次调用接口，传入这个 page_token，将获得下一页数据 // // 示例值：2 func (builder *ListAdminUserStatReqBuilder) PageToken(pageToken string) *ListAdminUserStatReqBuilder { @@ -5119,7 +5119,7 @@ type ListAdminUserStatReq struct { type ListAdminUserStatRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*AdminUserStat `json:"items,omitempty"` // 数据报表 } @@ -5147,7 +5147,7 @@ func NewCreateBadgeReqBuilder() *CreateBadgeReqBuilder { return builder } -// 使用该接口可以创建一枚完整的勋章信息，一个租户下最多可创建1000枚勋章。 +// 使用该接口可以创建一枚完整的勋章信息，一个租户下最多可创建 1000 枚勋章。 func (builder *CreateBadgeReqBuilder) Badge(badge *Badge) *CreateBadgeReqBuilder { builder.badge = badge return builder @@ -5192,7 +5192,7 @@ func NewGetBadgeReqBuilder() *GetBadgeReqBuilder { return builder } -// 勋章id +// 勋章 id // // 示例值：m_DjMzaK func (builder *GetBadgeReqBuilder) BadgeId(badgeId string) *GetBadgeReqBuilder { @@ -5313,7 +5313,7 @@ func NewUpdateBadgeReqBuilder() *UpdateBadgeReqBuilder { return builder } -// 勋章ID +// 勋章 ID // // 示例值：m_MzfKDM func (builder *UpdateBadgeReqBuilder) BadgeId(badgeId string) *UpdateBadgeReqBuilder { @@ -5368,7 +5368,7 @@ func NewCreateBadgeGrantReqBuilder() *CreateBadgeGrantReqBuilder { return builder } -// 勋章ID +// 勋章 ID // // 示例值：m_DjMzaK func (builder *CreateBadgeGrantReqBuilder) BadgeId(badgeId string) *CreateBadgeGrantReqBuilder { @@ -5384,7 +5384,7 @@ func (builder *CreateBadgeGrantReqBuilder) UserIdType(userIdType string) *Create return builder } -// 此次调用中使用的部门ID的类型。 +// 此次调用中使用的部门 ID 的类型。 // // 示例值：open_department_id func (builder *CreateBadgeGrantReqBuilder) DepartmentIdType(departmentIdType string) *CreateBadgeGrantReqBuilder { @@ -5392,7 +5392,7 @@ func (builder *CreateBadgeGrantReqBuilder) DepartmentIdType(departmentIdType str return builder } -// 通过该接口可以为特定勋章创建一份授予名单，一枚勋章下最多可创建1000份授予名单。 +// 通过该接口可以为特定勋章创建一份授予名单，一枚勋章下最多可创建 1000 份授予名单。 func (builder *CreateBadgeGrantReqBuilder) Grant(grant *Grant) *CreateBadgeGrantReqBuilder { builder.grant = grant return builder @@ -5439,7 +5439,7 @@ func NewDeleteBadgeGrantReqBuilder() *DeleteBadgeGrantReqBuilder { return builder } -// 企业勋章的唯一ID +// 企业勋章的唯一 ID // // 示例值：m_DjMzaK func (builder *DeleteBadgeGrantReqBuilder) BadgeId(badgeId string) *DeleteBadgeGrantReqBuilder { @@ -5512,7 +5512,7 @@ func (builder *GetBadgeGrantReqBuilder) UserIdType(userIdType string) *GetBadgeG return builder } -// 此次调用中使用的部门ID的类型。 +// 此次调用中使用的部门 ID 的类型。 // // 示例值：open_department_id func (builder *GetBadgeGrantReqBuilder) DepartmentIdType(departmentIdType string) *GetBadgeGrantReqBuilder { @@ -5566,7 +5566,7 @@ func (builder *ListBadgeGrantReqBuilder) Limit(limit int) *ListBadgeGrantReqBuil return builder } -// 企业勋章的唯一ID +// 企业勋章的唯一 ID // // 示例值：m_DjMzaK func (builder *ListBadgeGrantReqBuilder) BadgeId(badgeId string) *ListBadgeGrantReqBuilder { @@ -5598,7 +5598,7 @@ func (builder *ListBadgeGrantReqBuilder) UserIdType(userIdType string) *ListBadg return builder } -// 此次调用中使用的部门ID的类型。 +// 此次调用中使用的部门 ID 的类型。 // // 示例值：open_department_id func (builder *ListBadgeGrantReqBuilder) DepartmentIdType(departmentIdType string) *ListBadgeGrantReqBuilder { @@ -5659,7 +5659,7 @@ func NewUpdateBadgeGrantReqBuilder() *UpdateBadgeGrantReqBuilder { return builder } -// 勋章ID +// 勋章 ID // // 示例值：m_DjMzaK func (builder *UpdateBadgeGrantReqBuilder) BadgeId(badgeId string) *UpdateBadgeGrantReqBuilder { @@ -5667,7 +5667,7 @@ func (builder *UpdateBadgeGrantReqBuilder) BadgeId(badgeId string) *UpdateBadgeG return builder } -// 授予名单ID +// 授予名单 ID // // 示例值：g_uS4yux func (builder *UpdateBadgeGrantReqBuilder) GrantId(grantId string) *UpdateBadgeGrantReqBuilder { @@ -5683,7 +5683,7 @@ func (builder *UpdateBadgeGrantReqBuilder) UserIdType(userIdType string) *Update return builder } -// 此次调用中使用的部门ID的类型。 +// 此次调用中使用的部门 ID 的类型。 // // 示例值：open_department_id func (builder *UpdateBadgeGrantReqBuilder) DepartmentIdType(departmentIdType string) *UpdateBadgeGrantReqBuilder { @@ -5825,7 +5825,7 @@ func NewCreateBadgeImageReqBuilder() *CreateBadgeImageReqBuilder { return builder } -// 通过该接口可以上传勋章详情图、挂饰图的文件，获取对应的文件key +// 通过该接口可以上传勋章详情图、挂饰图的文件，获取对应的文件 key func (builder *CreateBadgeImageReqBuilder) Body(body *CreateBadgeImageReqBody) *CreateBadgeImageReqBuilder { builder.body = body return builder @@ -5849,7 +5849,7 @@ type CreateBadgeImageReq struct { } type CreateBadgeImageRespData struct { - ImageKey *string `json:"image_key,omitempty"` // 图片的key + ImageKey *string `json:"image_key,omitempty"` // 图片的 key } type CreateBadgeImageResp struct { @@ -5863,9 +5863,9 @@ func (resp *CreateBadgeImageResp) Success() bool { } type ResetPasswordReqBodyBuilder struct { - password *Password // 需要重置的密码参数，不少于8个字符，字母、数字和符号，至少三选二 + password *Password // 需要重置的密码参数，不少于 8 个字符，字母、数字和符号，至少三选二 passwordFlag bool - userId string // 待修改密码的用户ID，只针对邮箱登录凭证与企业邮箱(包括别名)相等的用户生效 + userId string // 待修改密码的用户 ID，只针对邮箱登录凭证与企业邮箱 (包括别名) 相等的用户生效 userIdFlag bool } @@ -5874,7 +5874,7 @@ func NewResetPasswordReqBodyBuilder() *ResetPasswordReqBodyBuilder { return builder } -// 需要重置的密码参数，不少于8个字符，字母、数字和符号，至少三选二 +// 需要重置的密码参数，不少于 8 个字符，字母、数字和符号，至少三选二 // //示例值：1234abcd func (builder *ResetPasswordReqBodyBuilder) Password(password *Password) *ResetPasswordReqBodyBuilder { @@ -5883,7 +5883,7 @@ func (builder *ResetPasswordReqBodyBuilder) Password(password *Password) *ResetP return builder } -// 待修改密码的用户ID，只针对邮箱登录凭证与企业邮箱(包括别名)相等的用户生效 +// 待修改密码的用户 ID，只针对邮箱登录凭证与企业邮箱 (包括别名) 相等的用户生效 // //示例值：abc123 func (builder *ResetPasswordReqBodyBuilder) UserId(userId string) *ResetPasswordReqBodyBuilder { @@ -5904,9 +5904,9 @@ func (builder *ResetPasswordReqBodyBuilder) Build() *ResetPasswordReqBody { } type ResetPasswordPathReqBodyBuilder struct { - password *Password // 需要重置的密码参数，不少于8个字符，字母、数字和符号，至少三选二 + password *Password // 需要重置的密码参数，不少于 8 个字符，字母、数字和符号，至少三选二 passwordFlag bool - userId string // 待修改密码的用户ID，只针对邮箱登录凭证与企业邮箱(包括别名)相等的用户生效 + userId string // 待修改密码的用户 ID，只针对邮箱登录凭证与企业邮箱 (包括别名) 相等的用户生效 userIdFlag bool } @@ -5915,7 +5915,7 @@ func NewResetPasswordPathReqBodyBuilder() *ResetPasswordPathReqBodyBuilder { return builder } -// 需要重置的密码参数，不少于8个字符，字母、数字和符号，至少三选二 +// 需要重置的密码参数，不少于 8 个字符，字母、数字和符号，至少三选二 // // 示例值：1234abcd func (builder *ResetPasswordPathReqBodyBuilder) Password(password *Password) *ResetPasswordPathReqBodyBuilder { @@ -5924,7 +5924,7 @@ func (builder *ResetPasswordPathReqBodyBuilder) Password(password *Password) *Re return builder } -// 待修改密码的用户ID，只针对邮箱登录凭证与企业邮箱(包括别名)相等的用户生效 +// 待修改密码的用户 ID，只针对邮箱登录凭证与企业邮箱 (包括别名) 相等的用户生效 // // 示例值：abc123 func (builder *ResetPasswordPathReqBodyBuilder) UserId(userId string) *ResetPasswordPathReqBodyBuilder { @@ -5958,7 +5958,7 @@ func NewResetPasswordReqBuilder() *ResetPasswordReqBuilder { return builder } -// 用户ID类型 +// 用户 ID 类型 // // 示例值：user_id func (builder *ResetPasswordReqBuilder) UserIdType(userIdType string) *ResetPasswordReqBuilder { @@ -5966,7 +5966,7 @@ func (builder *ResetPasswordReqBuilder) UserIdType(userIdType string) *ResetPass return builder } -// 重置用户的企业邮箱密码，仅当用户的邮箱和企业邮箱(别名)一致时生效，可用于处理飞书企业邮箱登录死锁的问题。;;邮箱死锁：当用户的登录凭证与飞书企业邮箱一致时，目前飞书登录流程要求用户输入验证码，由于飞书邮箱无单独的帐号体系，则未登录时无法收取邮箱验证码，即陷入死锁 +// 重置用户的企业邮箱密码，仅当用户的邮箱和企业邮箱 (别名) 一致时生效，可用于处理飞书企业邮箱登录死锁的问题。;;邮箱死锁：当用户的登录凭证与飞书企业邮箱一致时，目前飞书登录流程要求用户输入验证码，由于飞书邮箱无单独的帐号体系，则未登录时无法收取邮箱验证码，即陷入死锁 func (builder *ResetPasswordReqBuilder) Body(body *ResetPasswordReqBody) *ResetPasswordReqBuilder { builder.body = body return builder @@ -5981,8 +5981,8 @@ func (builder *ResetPasswordReqBuilder) Build() *ResetPasswordReq { } type ResetPasswordReqBody struct { - Password *Password `json:"password,omitempty"` // 需要重置的密码参数，不少于8个字符，字母、数字和符号，至少三选二 - UserId *string `json:"user_id,omitempty"` // 待修改密码的用户ID，只针对邮箱登录凭证与企业邮箱(包括别名)相等的用户生效 + Password *Password `json:"password,omitempty"` // 需要重置的密码参数，不少于 8 个字符，字母、数字和符号，至少三选二 + UserId *string `json:"user_id,omitempty"` // 待修改密码的用户 ID，只针对邮箱登录凭证与企业邮箱 (包括别名) 相等的用户生效 } type ResetPasswordReq struct { @@ -6017,7 +6017,7 @@ func (iterator *ListBadgeIterator) Next() (bool, *Badge, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6071,7 +6071,7 @@ func (iterator *ListBadgeGrantIterator) Next() (bool, *Grant, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/application/v6/api.go b/service/application/v6/api.go index 83ceb125..152591e2 100644 --- a/service/application/v6/api.go +++ b/service/application/v6/api.go @@ -64,9 +64,9 @@ type applicationVisibility struct { // // - 获取当前设置的推荐规则列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/app_recommend_rule/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/app_recommend_rule/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/list_appRecommendRule.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/list_appRecommendRule.go func (a *appRecommendRule) List(ctx context.Context, req *ListAppRecommendRuleReq, options ...larkcore.RequestOptionFunc) (*ListAppRecommendRuleResp, error) { // 发起请求 apiReq := req.apiReq @@ -96,11 +96,11 @@ func (a *appRecommendRule) ListByIterator(ctx context.Context, req *ListAppRecom // 获取应用信息 // -// - 根据app_id获取应用的基础信息 +// - 根据 app_id 获取应用的基础信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/get_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/get_application.go func (a *application) Get(ctx context.Context, req *GetApplicationReq, options ...larkcore.RequestOptionFunc) (*GetApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -124,9 +124,9 @@ func (a *application) Get(ctx context.Context, req *GetApplicationReq, options . // // - 更新应用的分组信息（分组会影响应用在工作台中的分类情况，请谨慎更新） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/patch_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/patch_application.go func (a *application) Patch(ctx context.Context, req *PatchApplicationReq, options ...larkcore.RequestOptionFunc) (*PatchApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -150,9 +150,9 @@ func (a *application) Patch(ctx context.Context, req *PatchApplicationReq, optio // // - 查看本企业下所有待审核的自建应用列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/underauditlist +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/underauditlist // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/underauditlist_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/underauditlist_application.go func (a *application) Underauditlist(ctx context.Context, req *UnderauditlistApplicationReq, options ...larkcore.RequestOptionFunc) (*UnderauditlistApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -184,11 +184,11 @@ func (a *application) UnderauditlistByIterator(ctx context.Context, req *Underau // // - 查看应用在某一天/某一周/某一个月的使用数据，可以查看租户整体对应用的使用情况，也可以分部门查看。 // -// - 1. 仅支持企业版/旗舰版租户使用;2. 一般每天早上10点产出前一天的数据;3. 已经支持的指标包括：应用的活跃用户数、累计用户数、新增用户数、访问页面数、打开次数;4. 数据从飞书4.10版本开始统计，使用飞书版本4.10及以下版本的用户数据不会被统计到;5. 按照部门查看数据时，会展示当前部门以及其子部门的整体使用情况;6. 调用频控为100次/分 +// - 1. 仅支持企业版/旗舰版租户使用;2. 一般每天早上 10 点产出前一天的数据;3. 已经支持的指标包括：应用的活跃用户数、累计用户数、新增用户数、访问页面数、打开次数;4. 数据从飞书 4.10 版本开始统计，使用飞书版本 4.10 及以下版本的用户数据不会被统计到;5. 按照部门查看数据时，会展示当前部门以及其子部门的整体使用情况;6. 调用频控为 100 次/分 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_usage/overview +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_usage/overview // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/overview_applicationAppUsage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/overview_applicationAppUsage.go func (a *applicationAppUsage) Overview(ctx context.Context, req *OverviewApplicationAppUsageReq, options ...larkcore.RequestOptionFunc) (*OverviewApplicationAppUsageResp, error) { // 发起请求 apiReq := req.apiReq @@ -212,9 +212,9 @@ func (a *applicationAppUsage) Overview(ctx context.Context, req *OverviewApplica // // - 根据应用 ID 和应用版本 ID 来获取同租户下的应用版本的信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_version/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_version/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/get_applicationAppVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/get_applicationAppVersion.go func (a *applicationAppVersion) Get(ctx context.Context, req *GetApplicationAppVersionReq, options ...larkcore.RequestOptionFunc) (*GetApplicationAppVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -238,9 +238,9 @@ func (a *applicationAppVersion) Get(ctx context.Context, req *GetApplicationAppV // // - 根据 app_id 获取对应应用版本列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_version/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_version/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/list_applicationAppVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/list_applicationAppVersion.go func (a *applicationAppVersion) List(ctx context.Context, req *ListApplicationAppVersionReq, options ...larkcore.RequestOptionFunc) (*ListApplicationAppVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -272,9 +272,9 @@ func (a *applicationAppVersion) ListByIterator(ctx context.Context, req *ListApp // // - 通过接口来更新应用版本的审核结果：通过后应用可以直接上架；拒绝后则开发者可以看到拒绝理由，并在修改后再次申请发布。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_version/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_version/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/patch_applicationAppVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/patch_applicationAppVersion.go func (a *applicationAppVersion) Patch(ctx context.Context, req *PatchApplicationAppVersionReq, options ...larkcore.RequestOptionFunc) (*PatchApplicationAppVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -298,9 +298,9 @@ func (a *applicationAppVersion) Patch(ctx context.Context, req *PatchApplication // // - 查询应用的反馈数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-feedback/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-feedback/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/list_applicationFeedback.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/list_applicationFeedback.go func (a *applicationFeedback) List(ctx context.Context, req *ListApplicationFeedbackReq, options ...larkcore.RequestOptionFunc) (*ListApplicationFeedbackResp, error) { // 发起请求 apiReq := req.apiReq @@ -324,9 +324,9 @@ func (a *applicationFeedback) List(ctx context.Context, req *ListApplicationFeed // // - 更新应用的反馈数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-feedback/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-feedback/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/patch_applicationFeedback.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/applicationv6/patch_applicationFeedback.go func (a *applicationFeedback) Patch(ctx context.Context, req *PatchApplicationFeedbackReq, options ...larkcore.RequestOptionFunc) (*PatchApplicationFeedbackResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/application/v6/event.go b/service/application/v6/event.go index 354d0e01..6d631827 100644 --- a/service/application/v6/event.go +++ b/service/application/v6/event.go @@ -32,7 +32,7 @@ func (h *P2ApplicationCreatedV6Handler) Event() interface{} { return &P2ApplicationCreatedV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationCreatedV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationCreatedV6)) } @@ -52,7 +52,7 @@ func (h *P2ApplicationAppVersionAuditV6Handler) Event() interface{} { return &P2ApplicationAppVersionAuditV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationAppVersionAuditV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationAppVersionAuditV6)) } @@ -72,7 +72,7 @@ func (h *P2ApplicationAppVersionPublishApplyV6Handler) Event() interface{} { return &P2ApplicationAppVersionPublishApplyV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationAppVersionPublishApplyV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationAppVersionPublishApplyV6)) } @@ -92,7 +92,7 @@ func (h *P2ApplicationAppVersionPublishRevokeV6Handler) Event() interface{} { return &P2ApplicationAppVersionPublishRevokeV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationAppVersionPublishRevokeV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationAppVersionPublishRevokeV6)) } @@ -112,7 +112,7 @@ func (h *P2ApplicationFeedbackCreatedV6Handler) Event() interface{} { return &P2ApplicationFeedbackCreatedV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationFeedbackCreatedV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationFeedbackCreatedV6)) } @@ -132,7 +132,7 @@ func (h *P2ApplicationFeedbackUpdatedV6Handler) Event() interface{} { return &P2ApplicationFeedbackUpdatedV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationFeedbackUpdatedV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationFeedbackUpdatedV6)) } @@ -152,7 +152,7 @@ func (h *P2ApplicationVisibilityAddedV6Handler) Event() interface{} { return &P2ApplicationVisibilityAddedV6{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationVisibilityAddedV6Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationVisibilityAddedV6)) } diff --git a/service/application/v6/ext_model.go b/service/application/v6/ext_model.go index 91ef454c..9e790cd5 100644 --- a/service/application/v6/ext_model.go +++ b/service/application/v6/ext_model.go @@ -27,15 +27,15 @@ func (m *P1OrderPaidV6) RawReq(req *larkevent.EventReq) { type P1OrderPaidV6Data struct { Type string `json:"type,omitempty"` // 事件类型 AppID string `json:"app_id,omitempty"` // APP ID - OrderID string `json:"order_id,omitempty"` // 用户购买付费方案时对订单ID 可作为唯一标识 - PricePlanID string `json:"price_plan_id,omitempty"` // 付费方案ID + OrderID string `json:"order_id,omitempty"` // 用户购买付费方案时对订单 ID 可作为唯一标识 + PricePlanID string `json:"price_plan_id,omitempty"` // 付费方案 ID PricePlanType string `json:"price_plan_type,omitempty"` // 用户购买方案类型 "trial" -试用；"permanent"-免费；"per_year"-企业年付费；"per_month"-企业月付费；"per_seat_per_year"-按人按年付费；"per_seat_per_month"-按人按月付费；"permanent_count"-按次付费 - BuyCount int64 `json:"buy_count,omitempty"` // 套餐购买数量 目前都为1 + BuyCount int64 `json:"buy_count,omitempty"` // 套餐购买数量 目前都为 1 Seats int64 `json:"seats,omitempty"` // 表示购买了多少人份 CreateTime string `json:"create_time,omitempty"` // PayTime string `json:"pay_time,omitempty"` // - BuyType string `json:"buy_type,omitempty"` // 购买类型 buy普通购买 upgrade为升级购买 renew为续费购买 - SrcOrderID string `json:"src_order_id,omitempty"` // 当前为升级购买时(buy_type 为upgrade)，该字段表示原订单ID，升级后原订单失效，状态变为已升级(业务方需要处理) + BuyType string `json:"buy_type,omitempty"` // 购买类型 buy 普通购买 upgrade 为升级购买 renew 为续费购买 + SrcOrderID string `json:"src_order_id,omitempty"` // 当前为升级购买时 (buy_type 为 upgrade)，该字段表示原订单 ID，升级后原订单失效，状态变为已升级 (业务方需要处理) OrderPayPrice int64 `json:"order_pay_price,omitempty"` // 订单支付价格 单位分， TenantKey string `json:"tenant_key,omitempty"` // 企业标识 } @@ -67,15 +67,15 @@ func (m *P1AppOpenV6) RawReq(req *larkevent.EventReq) { } type P1AppOpenApplicantV6 struct { - OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的open_id不同 + OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的 open_id 不同 } type P1AppOpenInstallerV6 struct { - OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的open_id不同 + OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的 open_id 不同 } type P1AppOpenInstallerEmployeeV6 struct { - OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的open_id不同 + OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的 open_id 不同 } type P1AppOpenV6Data struct { @@ -102,11 +102,11 @@ type P1AppStatusChangedV6Data struct { TenantKey string `json:"tenant_key,omitempty"` // 企业标识 Type string `json:"type,omitempty"` // 事件类型 Status string `json:"status,omitempty"` //应用状态 start_by_tenant: 租户启用; stop_by_tenant: 租户停用; stop_by_platform: 平台停用 - Operator *P1AppStatusChangeOperatorV6 `json:"operator,omitempty"` // 仅status=start_by_tenant时有此字段 + Operator *P1AppStatusChangeOperatorV6 `json:"operator,omitempty"` // 仅 status=start_by_tenant 时有此字段 } type P1AppStatusChangeOperatorV6 struct { - OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的open_id不同 + OpenID string `json:"open_id,omitempty"` // 用户对此应用的唯一标识，同一用户对不同应用的 open_id 不同 UserID string `json:"user_id,omitempty"` // 仅自建应用才会返回 - UnionId string `json:"union_id,omitempty"` // 用户在ISV下的唯一标识 + UnionId string `json:"union_id,omitempty"` // 用户在 ISV 下的唯一标识 } diff --git a/service/application/v6/model.go b/service/application/v6/model.go index 7d4be37c..51629642 100644 --- a/service/application/v6/model.go +++ b/service/application/v6/model.go @@ -25,9 +25,9 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -37,9 +37,9 @@ const ( ) const ( - UserIdTypeGetApplicationUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetApplicationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetApplicationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetApplicationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetApplicationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetApplicationOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -55,15 +55,15 @@ const ( ) const ( - UserIdTypeUnderauditlistApplicationUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnderauditlistApplicationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUnderauditlistApplicationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUnderauditlistApplicationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnderauditlistApplicationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUnderauditlistApplicationOpenId = "open_id" // 以 open_id 来识别用户 ) const ( CycleTypeDay = 1 // 日活 - CycleTypeWeek = 2 // 周活， date字段应该填自然周周一的日期 - CycleTypeMonth = 3 // 月活， date字段应该填自然月1号的日期 + CycleTypeWeek = 2 // 周活， date 字段应该填自然周周一的日期 + CycleTypeMonth = 3 // 月活， date 字段应该填自然月 1 号的日期 ) @@ -75,8 +75,8 @@ const ( ) const ( - DepartmentIdTypeDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -86,9 +86,9 @@ const ( ) const ( - UserIdTypeGetApplicationAppVersionUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetApplicationAppVersionUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetApplicationAppVersionOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetApplicationAppVersionUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetApplicationAppVersionUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetApplicationAppVersionOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -98,9 +98,9 @@ const ( ) const ( - UserIdTypeListApplicationAppVersionUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListApplicationAppVersionUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListApplicationAppVersionOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListApplicationAppVersionUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListApplicationAppVersionUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListApplicationAppVersionOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -113,9 +113,9 @@ const ( ) const ( - UserIdTypePatchApplicationAppVersionUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchApplicationAppVersionUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchApplicationAppVersionOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchApplicationAppVersionUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchApplicationAppVersionUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchApplicationAppVersionOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -305,13 +305,13 @@ func (builder *AppAbilityBuilder) Build() *AppAbility { type AppAdminUser struct { AdminType []string `json:"admin_type,omitempty"` // 管理员类型列表，如果该管理员同时是超级管理员 又是管理员，则同时返回两个角色。 ""super_admin""：超级管理员 ""admin""：管理员 返回示例：[""super_admin"",""admin""]" - UserId *string `json:"user_id,omitempty"` // 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 + UserId *string `json:"user_id,omitempty"` // 反馈用户 id，租户内用户的唯一标识 ，ID 值与查询参数中的 user_id_type 对应 } type AppAdminUserBuilder struct { adminType []string // 管理员类型列表，如果该管理员同时是超级管理员 又是管理员，则同时返回两个角色。 ""super_admin""：超级管理员 ""admin""：管理员 返回示例：[""super_admin"",""admin""]" adminTypeFlag bool - userId string // 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 + userId string // 反馈用户 id，租户内用户的唯一标识 ，ID 值与查询参数中的 user_id_type 对应 userIdFlag bool } @@ -329,7 +329,7 @@ func (builder *AppAdminUserBuilder) AdminType(adminType []string) *AppAdminUserB return builder } -// 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 +// 反馈用户 id，租户内用户的唯一标识 ，ID 值与查询参数中的 user_id_type 对应 // // 示例值：6865121785549946899 func (builder *AppAdminUserBuilder) UserId(userId string) *AppAdminUserBuilder { @@ -351,23 +351,23 @@ func (builder *AppAdminUserBuilder) Build() *AppAdminUser { } type AppBadge struct { - UserId *string `json:"user_id,omitempty"` // 用户ID - Version *string `json:"version,omitempty"` // badge数据版本号 + UserId *string `json:"user_id,omitempty"` // 用户 ID + Version *string `json:"version,omitempty"` // badge 数据版本号 Extra *string `json:"extra,omitempty"` // badge extra 信息 - Pc *ClientBadgeNum `json:"pc,omitempty"` // pc端badge数量 - Mobile *ClientBadgeNum `json:"mobile,omitempty"` // 移动端badge数量 + Pc *ClientBadgeNum `json:"pc,omitempty"` // pc 端 badge 数量 + Mobile *ClientBadgeNum `json:"mobile,omitempty"` // 移动端 badge 数量 } type AppBadgeBuilder struct { - userId string // 用户ID + userId string // 用户 ID userIdFlag bool - version string // badge数据版本号 + version string // badge 数据版本号 versionFlag bool extra string // badge extra 信息 extraFlag bool - pc *ClientBadgeNum // pc端badge数量 + pc *ClientBadgeNum // pc 端 badge 数量 pcFlag bool - mobile *ClientBadgeNum // 移动端badge数量 + mobile *ClientBadgeNum // 移动端 badge 数量 mobileFlag bool } @@ -376,7 +376,7 @@ func NewAppBadgeBuilder() *AppBadgeBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_d317f090b7258ad0372aa53963cda70d func (builder *AppBadgeBuilder) UserId(userId string) *AppBadgeBuilder { @@ -385,7 +385,7 @@ func (builder *AppBadgeBuilder) UserId(userId string) *AppBadgeBuilder { return builder } -// badge数据版本号 +// badge 数据版本号 // // 示例值：1664360599355 func (builder *AppBadgeBuilder) Version(version string) *AppBadgeBuilder { @@ -403,7 +403,7 @@ func (builder *AppBadgeBuilder) Extra(extra string) *AppBadgeBuilder { return builder } -// pc端badge数量 +// pc 端 badge 数量 // // 示例值： func (builder *AppBadgeBuilder) Pc(pc *ClientBadgeNum) *AppBadgeBuilder { @@ -412,7 +412,7 @@ func (builder *AppBadgeBuilder) Pc(pc *ClientBadgeNum) *AppBadgeBuilder { return builder } -// 移动端badge数量 +// 移动端 badge 数量 // // 示例值： func (builder *AppBadgeBuilder) Mobile(mobile *ClientBadgeNum) *AppBadgeBuilder { @@ -685,7 +685,7 @@ func (builder *AppI18nInfoBuilder) Build() *AppI18nInfo { type AppMessageTrendItem struct { ChatType *string `json:"chat_type,omitempty"` // 聊天类型，private：私聊；group：群聊 - EventType *string `json:"event_type,omitempty"` // 消息事件类型,message_send:已发送消息;bot_notify_get_message:bot 通知收到消息;message_read:消息已读 + EventType *string `json:"event_type,omitempty"` // 消息事件类型，message_send:已发送消息;bot_notify_get_message:bot 通知收到消息;message_read:消息已读 MessageType *string `json:"message_type,omitempty"` // 消息类型，大小写不敏感，text：文本消息；image：图片消息；interactive：卡片消息；post：富文本消息；share_chat：群名片 Trend []*UsageTrendItem `json:"trend,omitempty"` // } @@ -693,7 +693,7 @@ type AppMessageTrendItem struct { type AppMessageTrendItemBuilder struct { chatType string // 聊天类型，private：私聊；group：群聊 chatTypeFlag bool - eventType string // 消息事件类型,message_send:已发送消息;bot_notify_get_message:bot 通知收到消息;message_read:消息已读 + eventType string // 消息事件类型，message_send:已发送消息;bot_notify_get_message:bot 通知收到消息;message_read:消息已读 eventTypeFlag bool messageType string // 消息类型，大小写不敏感，text：文本消息；image：图片消息；interactive：卡片消息；post：富文本消息；share_chat：群名片 messageTypeFlag bool @@ -715,7 +715,7 @@ func (builder *AppMessageTrendItemBuilder) ChatType(chatType string) *AppMessage return builder } -// 消息事件类型,message_send:已发送消息;bot_notify_get_message:bot 通知收到消息;message_read:消息已读 +// 消息事件类型，message_send:已发送消息;bot_notify_get_message:bot 通知收到消息;message_read:消息已读 // // 示例值： func (builder *AppMessageTrendItemBuilder) EventType(eventType string) *AppMessageTrendItemBuilder { @@ -1707,15 +1707,15 @@ func (builder *AppVisibilityEventBuilder) Build() *AppVisibilityEvent { } type AppVisibilityItem struct { - UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识，ID值与查询参数中的user_id_type 对应 - DepartmentId *string `json:"department_id,omitempty"` // 用户所属部门的ID，ID值与查询参数中的department_id_type 对应 + UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识，ID 值与查询参数中的 user_id_type 对应 + DepartmentId *string `json:"department_id,omitempty"` // 用户所属部门的 ID，ID 值与查询参数中的 department_id_type 对应 GroupId *string `json:"group_id,omitempty"` // 用户组 ID group_id 用来标识租户内一个唯一的用户组 } type AppVisibilityItemBuilder struct { - userId string // 租户内用户的唯一标识，ID值与查询参数中的user_id_type 对应 + userId string // 租户内用户的唯一标识，ID 值与查询参数中的 user_id_type 对应 userIdFlag bool - departmentId string // 用户所属部门的ID，ID值与查询参数中的department_id_type 对应 + departmentId string // 用户所属部门的 ID，ID 值与查询参数中的 department_id_type 对应 departmentIdFlag bool groupId string // 用户组 ID group_id 用来标识租户内一个唯一的用户组 groupIdFlag bool @@ -1726,7 +1726,7 @@ func NewAppVisibilityItemBuilder() *AppVisibilityItemBuilder { return builder } -// 租户内用户的唯一标识，ID值与查询参数中的user_id_type 对应 +// 租户内用户的唯一标识，ID 值与查询参数中的 user_id_type 对应 // // 示例值：ou_d317f090b7258ad0372aa53963cda70d func (builder *AppVisibilityItemBuilder) UserId(userId string) *AppVisibilityItemBuilder { @@ -1735,7 +1735,7 @@ func (builder *AppVisibilityItemBuilder) UserId(userId string) *AppVisibilityIte return builder } -// 用户所属部门的ID，ID值与查询参数中的department_id_type 对应 +// 用户所属部门的 ID，ID 值与查询参数中的 department_id_type 对应 // // 示例值：od-aa2c50a04769feefededb7a05b7525a8 func (builder *AppVisibilityItemBuilder) DepartmentId(departmentId string) *AppVisibilityItemBuilder { @@ -2788,23 +2788,23 @@ func (builder *ApplicationAppVersionEventBuilder) Build() *ApplicationAppVersion } type ApplicationDepartmentAppUsage struct { - DepartmentId *string `json:"department_id,omitempty"` // 租户内部门的唯一标识，ID值与查询参数中的department_id_type 对应。 + DepartmentId *string `json:"department_id,omitempty"` // 租户内部门的唯一标识，ID 值与查询参数中的 department_id_type 对应。 App []*ApplicationAppUsage `json:"app,omitempty"` // 应用整体使用情况，指标值包括：uv：活跃用户数，total_users：累计用户数，new_users：新增用户数，pv：在应用（小程序或网页）中访问的页面数，lifecycle：打开应用（小程序或网页）的次数 - Gadget []*ApplicationAppUsage `json:"gadget,omitempty"` // 小程序使用情况，没有小程序形态时为null，指标值包括：uv（小程序活跃用户数）、pv（用户在小程序中的访问页面数）、lifecycle（小程序的打开次数） - Webapp []*ApplicationAppUsage `json:"webapp,omitempty"` // 网页应用使用情况，没有网页应用形态时为null，指标值包括：uv（网页应用活跃用户数）、pv（用户在网页应用中的访问页面数）、lifecycle（网页应用的打开次数） - Bot []*ApplicationAppUsage `json:"bot,omitempty"` // 机器人使用情况，没有机器人形态时为null，;指标值包括：uv（机器人的活跃用户数） + Gadget []*ApplicationAppUsage `json:"gadget,omitempty"` // 小程序使用情况，没有小程序形态时为 null，指标值包括：uv（小程序活跃用户数）、pv（用户在小程序中的访问页面数）、lifecycle（小程序的打开次数） + Webapp []*ApplicationAppUsage `json:"webapp,omitempty"` // 网页应用使用情况，没有网页应用形态时为 null，指标值包括：uv（网页应用活跃用户数）、pv（用户在网页应用中的访问页面数）、lifecycle（网页应用的打开次数） + Bot []*ApplicationAppUsage `json:"bot,omitempty"` // 机器人使用情况，没有机器人形态时为 null，;指标值包括：uv（机器人的活跃用户数） } type ApplicationDepartmentAppUsageBuilder struct { - departmentId string // 租户内部门的唯一标识，ID值与查询参数中的department_id_type 对应。 + departmentId string // 租户内部门的唯一标识，ID 值与查询参数中的 department_id_type 对应。 departmentIdFlag bool app []*ApplicationAppUsage // 应用整体使用情况，指标值包括：uv：活跃用户数，total_users：累计用户数，new_users：新增用户数，pv：在应用（小程序或网页）中访问的页面数，lifecycle：打开应用（小程序或网页）的次数 appFlag bool - gadget []*ApplicationAppUsage // 小程序使用情况，没有小程序形态时为null，指标值包括：uv（小程序活跃用户数）、pv（用户在小程序中的访问页面数）、lifecycle（小程序的打开次数） + gadget []*ApplicationAppUsage // 小程序使用情况，没有小程序形态时为 null，指标值包括：uv（小程序活跃用户数）、pv（用户在小程序中的访问页面数）、lifecycle（小程序的打开次数） gadgetFlag bool - webapp []*ApplicationAppUsage // 网页应用使用情况，没有网页应用形态时为null，指标值包括：uv（网页应用活跃用户数）、pv（用户在网页应用中的访问页面数）、lifecycle（网页应用的打开次数） + webapp []*ApplicationAppUsage // 网页应用使用情况，没有网页应用形态时为 null，指标值包括：uv（网页应用活跃用户数）、pv（用户在网页应用中的访问页面数）、lifecycle（网页应用的打开次数） webappFlag bool - bot []*ApplicationAppUsage // 机器人使用情况，没有机器人形态时为null，;指标值包括：uv（机器人的活跃用户数） + bot []*ApplicationAppUsage // 机器人使用情况，没有机器人形态时为 null，;指标值包括：uv（机器人的活跃用户数） botFlag bool } @@ -2813,7 +2813,7 @@ func NewApplicationDepartmentAppUsageBuilder() *ApplicationDepartmentAppUsageBui return builder } -// 租户内部门的唯一标识，ID值与查询参数中的department_id_type 对应。 +// 租户内部门的唯一标识，ID 值与查询参数中的 department_id_type 对应。 // // 示例值： func (builder *ApplicationDepartmentAppUsageBuilder) DepartmentId(departmentId string) *ApplicationDepartmentAppUsageBuilder { @@ -2831,7 +2831,7 @@ func (builder *ApplicationDepartmentAppUsageBuilder) App(app []*ApplicationAppUs return builder } -// 小程序使用情况，没有小程序形态时为null，指标值包括：uv（小程序活跃用户数）、pv（用户在小程序中的访问页面数）、lifecycle（小程序的打开次数） +// 小程序使用情况，没有小程序形态时为 null，指标值包括：uv（小程序活跃用户数）、pv（用户在小程序中的访问页面数）、lifecycle（小程序的打开次数） // // 示例值： func (builder *ApplicationDepartmentAppUsageBuilder) Gadget(gadget []*ApplicationAppUsage) *ApplicationDepartmentAppUsageBuilder { @@ -2840,7 +2840,7 @@ func (builder *ApplicationDepartmentAppUsageBuilder) Gadget(gadget []*Applicatio return builder } -// 网页应用使用情况，没有网页应用形态时为null，指标值包括：uv（网页应用活跃用户数）、pv（用户在网页应用中的访问页面数）、lifecycle（网页应用的打开次数） +// 网页应用使用情况，没有网页应用形态时为 null，指标值包括：uv（网页应用活跃用户数）、pv（用户在网页应用中的访问页面数）、lifecycle（网页应用的打开次数） // // 示例值： func (builder *ApplicationDepartmentAppUsageBuilder) Webapp(webapp []*ApplicationAppUsage) *ApplicationDepartmentAppUsageBuilder { @@ -2849,7 +2849,7 @@ func (builder *ApplicationDepartmentAppUsageBuilder) Webapp(webapp []*Applicatio return builder } -// 机器人使用情况，没有机器人形态时为null，;指标值包括：uv（机器人的活跃用户数） +// 机器人使用情况，没有机器人形态时为 null，;指标值包括：uv（机器人的活跃用户数） // // 示例值： func (builder *ApplicationDepartmentAppUsageBuilder) Bot(bot []*ApplicationAppUsage) *ApplicationDepartmentAppUsageBuilder { @@ -2977,29 +2977,29 @@ func (builder *ApplicationEventOwnerBuilder) Build() *ApplicationEventOwner { type ApplicationFeedback struct { FeedbackId *string `json:"feedback_id,omitempty"` // 应用反馈 ID，应用反馈记录唯一标识 - AppId *string `json:"app_id,omitempty"` // 被反馈应用ID - FeedbackTime *string `json:"feedback_time,omitempty"` // 反馈提交时间，格式为yyyy-mm-dd hh:mm:ss + AppId *string `json:"app_id,omitempty"` // 被反馈应用 ID + FeedbackTime *string `json:"feedback_time,omitempty"` // 反馈提交时间，格式为 yyyy-mm-dd hh:mm:ss TenantName *string `json:"tenant_name,omitempty"` // 反馈用户的租户名， 查询 isv 应用时返回 FeedbackType *int `json:"feedback_type,omitempty"` // 反馈类型 Status *int `json:"status,omitempty"` // 反馈处理状态 FaultType []int `json:"fault_type,omitempty"` // 故障类型列表：1: 黑屏 2: 白屏 3: 无法打开小程序 4: 卡顿 5: 小程序闪退 6: 页面加载慢 7: 死机 8: 其他异常 - FaultTime *string `json:"fault_time,omitempty"` // 故障时间，格式为yyyy-mm-dd hh:mm:ss + FaultTime *string `json:"fault_time,omitempty"` // 故障时间，格式为 yyyy-mm-dd hh:mm:ss Source *int `json:"source,omitempty"` // 反馈来源：1： 小程序 2：网页应用 3：机器人 4：webSDK Contact *string `json:"contact,omitempty"` // 用户联系方式，只有用户填写联系方式后返回 - UpdateTime *string `json:"update_time,omitempty"` // 反馈处理时间，格式为yyyy-mm-dd hh:mm:ss + UpdateTime *string `json:"update_time,omitempty"` // 反馈处理时间，格式为 yyyy-mm-dd hh:mm:ss Description *string `json:"description,omitempty"` // 反馈问题描述 - UserId *string `json:"user_id,omitempty"` // 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 - OperatorId *string `json:"operator_id,omitempty"` // 操作者id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应 - Images []string `json:"images,omitempty"` // 反馈图片url列表，url 过期时间三天 - FeedbackPath *string `json:"feedback_path,omitempty"` // 反馈页面路径;- 如触发反馈的应用类型为小程序，则上报小程序当前页面的path信息;- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的url信息;- 如为其他应用类型，则字段返回值为空 + UserId *string `json:"user_id,omitempty"` // 反馈用户 id，租户内用户的唯一标识 ，ID 值与查询参数中的 user_id_type 对应 + OperatorId *string `json:"operator_id,omitempty"` // 操作者 id，租户内用户的唯一标识， ID 值与查询参数中的 user_id_type 对应 + Images []string `json:"images,omitempty"` // 反馈图片 url 列表，url 过期时间三天 + FeedbackPath *string `json:"feedback_path,omitempty"` // 反馈页面路径;- 如触发反馈的应用类型为小程序，则上报小程序当前页面的 path 信息;- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的 url 信息;- 如为其他应用类型，则字段返回值为空 } type ApplicationFeedbackBuilder struct { feedbackId string // 应用反馈 ID，应用反馈记录唯一标识 feedbackIdFlag bool - appId string // 被反馈应用ID + appId string // 被反馈应用 ID appIdFlag bool - feedbackTime string // 反馈提交时间，格式为yyyy-mm-dd hh:mm:ss + feedbackTime string // 反馈提交时间，格式为 yyyy-mm-dd hh:mm:ss feedbackTimeFlag bool tenantName string // 反馈用户的租户名， 查询 isv 应用时返回 tenantNameFlag bool @@ -3009,23 +3009,23 @@ type ApplicationFeedbackBuilder struct { statusFlag bool faultType []int // 故障类型列表：1: 黑屏 2: 白屏 3: 无法打开小程序 4: 卡顿 5: 小程序闪退 6: 页面加载慢 7: 死机 8: 其他异常 faultTypeFlag bool - faultTime string // 故障时间，格式为yyyy-mm-dd hh:mm:ss + faultTime string // 故障时间，格式为 yyyy-mm-dd hh:mm:ss faultTimeFlag bool source int // 反馈来源：1： 小程序 2：网页应用 3：机器人 4：webSDK sourceFlag bool contact string // 用户联系方式，只有用户填写联系方式后返回 contactFlag bool - updateTime string // 反馈处理时间，格式为yyyy-mm-dd hh:mm:ss + updateTime string // 反馈处理时间，格式为 yyyy-mm-dd hh:mm:ss updateTimeFlag bool description string // 反馈问题描述 descriptionFlag bool - userId string // 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 + userId string // 反馈用户 id，租户内用户的唯一标识 ，ID 值与查询参数中的 user_id_type 对应 userIdFlag bool - operatorId string // 操作者id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应 + operatorId string // 操作者 id，租户内用户的唯一标识， ID 值与查询参数中的 user_id_type 对应 operatorIdFlag bool - images []string // 反馈图片url列表，url 过期时间三天 + images []string // 反馈图片 url 列表，url 过期时间三天 imagesFlag bool - feedbackPath string // 反馈页面路径;- 如触发反馈的应用类型为小程序，则上报小程序当前页面的path信息;- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的url信息;- 如为其他应用类型，则字段返回值为空 + feedbackPath string // 反馈页面路径;- 如触发反馈的应用类型为小程序，则上报小程序当前页面的 path 信息;- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的 url 信息;- 如为其他应用类型，则字段返回值为空 feedbackPathFlag bool } @@ -3043,7 +3043,7 @@ func (builder *ApplicationFeedbackBuilder) FeedbackId(feedbackId string) *Applic return builder } -// 被反馈应用ID +// 被反馈应用 ID // // 示例值：cli_9b445f5258795107 func (builder *ApplicationFeedbackBuilder) AppId(appId string) *ApplicationFeedbackBuilder { @@ -3052,7 +3052,7 @@ func (builder *ApplicationFeedbackBuilder) AppId(appId string) *ApplicationFeedb return builder } -// 反馈提交时间，格式为yyyy-mm-dd hh:mm:ss +// 反馈提交时间，格式为 yyyy-mm-dd hh:mm:ss // // 示例值：2022-01-30 11:30:12 func (builder *ApplicationFeedbackBuilder) FeedbackTime(feedbackTime string) *ApplicationFeedbackBuilder { @@ -3097,7 +3097,7 @@ func (builder *ApplicationFeedbackBuilder) FaultType(faultType []int) *Applicati return builder } -// 故障时间，格式为yyyy-mm-dd hh:mm:ss +// 故障时间，格式为 yyyy-mm-dd hh:mm:ss // // 示例值：2022-01-30 11:30:12 func (builder *ApplicationFeedbackBuilder) FaultTime(faultTime string) *ApplicationFeedbackBuilder { @@ -3124,7 +3124,7 @@ func (builder *ApplicationFeedbackBuilder) Contact(contact string) *ApplicationF return builder } -// 反馈处理时间，格式为yyyy-mm-dd hh:mm:ss +// 反馈处理时间，格式为 yyyy-mm-dd hh:mm:ss // // 示例值：2022-01-30 11:30:12 func (builder *ApplicationFeedbackBuilder) UpdateTime(updateTime string) *ApplicationFeedbackBuilder { @@ -3142,7 +3142,7 @@ func (builder *ApplicationFeedbackBuilder) Description(description string) *Appl return builder } -// 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 +// 反馈用户 id，租户内用户的唯一标识 ，ID 值与查询参数中的 user_id_type 对应 // // 示例值：ou_9565b69967831233761cc2f11b4c089f func (builder *ApplicationFeedbackBuilder) UserId(userId string) *ApplicationFeedbackBuilder { @@ -3151,7 +3151,7 @@ func (builder *ApplicationFeedbackBuilder) UserId(userId string) *ApplicationFee return builder } -// 操作者id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应 +// 操作者 id，租户内用户的唯一标识， ID 值与查询参数中的 user_id_type 对应 // // 示例值：ou_9565b69967831233761cc2f11b4c089f func (builder *ApplicationFeedbackBuilder) OperatorId(operatorId string) *ApplicationFeedbackBuilder { @@ -3160,7 +3160,7 @@ func (builder *ApplicationFeedbackBuilder) OperatorId(operatorId string) *Applic return builder } -// 反馈图片url列表，url 过期时间三天 +// 反馈图片 url 列表，url 过期时间三天 // // 示例值： func (builder *ApplicationFeedbackBuilder) Images(images []string) *ApplicationFeedbackBuilder { @@ -3169,7 +3169,7 @@ func (builder *ApplicationFeedbackBuilder) Images(images []string) *ApplicationF return builder } -// 反馈页面路径;- 如触发反馈的应用类型为小程序，则上报小程序当前页面的path信息;- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的url信息;- 如为其他应用类型，则字段返回值为空 +// 反馈页面路径;- 如触发反馈的应用类型为小程序，则上报小程序当前页面的 path 信息;- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的 url 信息;- 如为其他应用类型，则字段返回值为空 // // 示例值：index/page func (builder *ApplicationFeedbackBuilder) FeedbackPath(feedbackPath string) *ApplicationFeedbackBuilder { @@ -3247,25 +3247,25 @@ func (builder *ApplicationFeedbackBuilder) Build() *ApplicationFeedback { type ApplicationOwner struct { Type *int `json:"type,omitempty"` // 应用所有者类型 - OwnerId *string `json:"owner_id,omitempty"` // 应用所有者ID - Name *string `json:"name,omitempty"` // 应用开发商名称(仅商店应用返回) - HelpDesk *string `json:"help_desk,omitempty"` // 应用开发商服务台链接(仅商店应用返回) - Email *string `json:"email,omitempty"` // 应用开发商的邮箱(仅商店应用返回) - Phone *string `json:"phone,omitempty"` // 应用开发商的手机号(仅商店应用返回) + OwnerId *string `json:"owner_id,omitempty"` // 应用所有者 ID + Name *string `json:"name,omitempty"` // 应用开发商名称 (仅商店应用返回) + HelpDesk *string `json:"help_desk,omitempty"` // 应用开发商服务台链接 (仅商店应用返回) + Email *string `json:"email,omitempty"` // 应用开发商的邮箱 (仅商店应用返回) + Phone *string `json:"phone,omitempty"` // 应用开发商的手机号 (仅商店应用返回) } type ApplicationOwnerBuilder struct { type_ int // 应用所有者类型 typeFlag bool - ownerId string // 应用所有者ID + ownerId string // 应用所有者 ID ownerIdFlag bool - name string // 应用开发商名称(仅商店应用返回) + name string // 应用开发商名称 (仅商店应用返回) nameFlag bool - helpDesk string // 应用开发商服务台链接(仅商店应用返回) + helpDesk string // 应用开发商服务台链接 (仅商店应用返回) helpDeskFlag bool - email string // 应用开发商的邮箱(仅商店应用返回) + email string // 应用开发商的邮箱 (仅商店应用返回) emailFlag bool - phone string // 应用开发商的手机号(仅商店应用返回) + phone string // 应用开发商的手机号 (仅商店应用返回) phoneFlag bool } @@ -3283,7 +3283,7 @@ func (builder *ApplicationOwnerBuilder) Type(type_ int) *ApplicationOwnerBuilder return builder } -// 应用所有者ID +// 应用所有者 ID // // 示例值：ou_d317f090b7258ad0372aa53963cda70d func (builder *ApplicationOwnerBuilder) OwnerId(ownerId string) *ApplicationOwnerBuilder { @@ -3292,7 +3292,7 @@ func (builder *ApplicationOwnerBuilder) OwnerId(ownerId string) *ApplicationOwne return builder } -// 应用开发商名称(仅商店应用返回) +// 应用开发商名称 (仅商店应用返回) // // 示例值：test tenant func (builder *ApplicationOwnerBuilder) Name(name string) *ApplicationOwnerBuilder { @@ -3301,7 +3301,7 @@ func (builder *ApplicationOwnerBuilder) Name(name string) *ApplicationOwnerBuild return builder } -// 应用开发商服务台链接(仅商店应用返回) +// 应用开发商服务台链接 (仅商店应用返回) // // 示例值：https://applink.feishu.cn/client/helpdesk/open?id=6940534140529803284 func (builder *ApplicationOwnerBuilder) HelpDesk(helpDesk string) *ApplicationOwnerBuilder { @@ -3310,7 +3310,7 @@ func (builder *ApplicationOwnerBuilder) HelpDesk(helpDesk string) *ApplicationOw return builder } -// 应用开发商的邮箱(仅商店应用返回) +// 应用开发商的邮箱 (仅商店应用返回) // // 示例值：test123@163.com func (builder *ApplicationOwnerBuilder) Email(email string) *ApplicationOwnerBuilder { @@ -3319,7 +3319,7 @@ func (builder *ApplicationOwnerBuilder) Email(email string) *ApplicationOwnerBui return builder } -// 应用开发商的手机号(仅商店应用返回) +// 应用开发商的手机号 (仅商店应用返回) // // 示例值：1234534234234 func (builder *ApplicationOwnerBuilder) Phone(phone string) *ApplicationOwnerBuilder { @@ -3420,13 +3420,13 @@ func (builder *ApplicationVisibilityBuilder) Build() *ApplicationVisibility { } type ApplicationVisibilityDepartmentWhiteBlackInfo struct { - DepartmentId *string `json:"department_id,omitempty"` // 部门ID + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID InWhiteList *bool `json:"in_white_list,omitempty"` // 是否在白名单中 InBlackList *bool `json:"in_black_list,omitempty"` // 是否在黑名单中 } type ApplicationVisibilityDepartmentWhiteBlackInfoBuilder struct { - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool inWhiteList bool // 是否在白名单中 inWhiteListFlag bool @@ -3439,7 +3439,7 @@ func NewApplicationVisibilityDepartmentWhiteBlackInfoBuilder() *ApplicationVisib return builder } -// 部门ID +// 部门 ID // // 示例值：od-aa2c50a04769feefededb7a05b7525a8 func (builder *ApplicationVisibilityDepartmentWhiteBlackInfoBuilder) DepartmentId(departmentId string) *ApplicationVisibilityDepartmentWhiteBlackInfoBuilder { @@ -3484,13 +3484,13 @@ func (builder *ApplicationVisibilityDepartmentWhiteBlackInfoBuilder) Build() *Ap } type ApplicationVisibilityGroupWhiteBlackInfo struct { - GroupId *string `json:"group_id,omitempty"` // 用户组ID + GroupId *string `json:"group_id,omitempty"` // 用户组 ID InWhiteList *bool `json:"in_white_list,omitempty"` // 是否在白名单中 InBlackList *bool `json:"in_black_list,omitempty"` // 是否在黑名单中 } type ApplicationVisibilityGroupWhiteBlackInfoBuilder struct { - groupId string // 用户组ID + groupId string // 用户组 ID groupIdFlag bool inWhiteList bool // 是否在白名单中 inWhiteListFlag bool @@ -3503,7 +3503,7 @@ func NewApplicationVisibilityGroupWhiteBlackInfoBuilder() *ApplicationVisibility return builder } -// 用户组ID +// 用户组 ID // // 示例值：96815a9cd9beg8g4 func (builder *ApplicationVisibilityGroupWhiteBlackInfoBuilder) GroupId(groupId string) *ApplicationVisibilityGroupWhiteBlackInfoBuilder { @@ -3548,14 +3548,14 @@ func (builder *ApplicationVisibilityGroupWhiteBlackInfoBuilder) Build() *Applica } type ApplicationVisibilityUserWhiteBlackInfo struct { - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID InWhiteList *bool `json:"in_white_list,omitempty"` // 是否在白名单中 InBlackList *bool `json:"in_black_list,omitempty"` // 是否在黑名单中 InPaidList *bool `json:"in_paid_list,omitempty"` // 是否在付费名单中 } type ApplicationVisibilityUserWhiteBlackInfoBuilder struct { - userId string // 用户ID + userId string // 用户 ID userIdFlag bool inWhiteList bool // 是否在白名单中 inWhiteListFlag bool @@ -3570,7 +3570,7 @@ func NewApplicationVisibilityUserWhiteBlackInfoBuilder() *ApplicationVisibilityU return builder } -// 用户ID +// 用户 ID // // 示例值：ou_d317f090b7258ad0372aa53963cda70d func (builder *ApplicationVisibilityUserWhiteBlackInfoBuilder) UserId(userId string) *ApplicationVisibilityUserWhiteBlackInfoBuilder { @@ -3803,14 +3803,14 @@ func (builder *BotBuilder) Build() *Bot { } type ClientBadgeNum struct { - WebApp *int `json:"web_app,omitempty"` // h5能力的badge数量 - Gadget *int `json:"gadget,omitempty"` // 小程序能力的badge数量 + WebApp *int `json:"web_app,omitempty"` // h5 能力的 badge 数量 + Gadget *int `json:"gadget,omitempty"` // 小程序能力的 badge 数量 } type ClientBadgeNumBuilder struct { - webApp int // h5能力的badge数量 + webApp int // h5 能力的 badge 数量 webAppFlag bool - gadget int // 小程序能力的badge数量 + gadget int // 小程序能力的 badge 数量 gadgetFlag bool } @@ -3819,7 +3819,7 @@ func NewClientBadgeNumBuilder() *ClientBadgeNumBuilder { return builder } -// h5能力的badge数量 +// h5 能力的 badge 数量 // // 示例值：1 func (builder *ClientBadgeNumBuilder) WebApp(webApp int) *ClientBadgeNumBuilder { @@ -3828,7 +3828,7 @@ func (builder *ClientBadgeNumBuilder) WebApp(webApp int) *ClientBadgeNumBuilder return builder } -// 小程序能力的badge数量 +// 小程序能力的 badge 数量 // // 示例值：2 func (builder *ClientBadgeNumBuilder) Gadget(gadget int) *ClientBadgeNumBuilder { @@ -4914,15 +4914,15 @@ func (builder *ScopeBuilder) Build() *Scope { } type UsageOverviewItem struct { - PageView *string `json:"page_view,omitempty"` // 应用使用pv - UniqueVisitor *string `json:"unique_visitor,omitempty"` // 应用使用uv + PageView *string `json:"page_view,omitempty"` // 应用使用 pv + UniqueVisitor *string `json:"unique_visitor,omitempty"` // 应用使用 uv DepartmentId *string `json:"department_id,omitempty"` // 部门号 } type UsageOverviewItemBuilder struct { - pageView string // 应用使用pv + pageView string // 应用使用 pv pageViewFlag bool - uniqueVisitor string // 应用使用uv + uniqueVisitor string // 应用使用 uv uniqueVisitorFlag bool departmentId string // 部门号 departmentIdFlag bool @@ -4933,7 +4933,7 @@ func NewUsageOverviewItemBuilder() *UsageOverviewItemBuilder { return builder } -// 应用使用pv +// 应用使用 pv // // 示例值： func (builder *UsageOverviewItemBuilder) PageView(pageView string) *UsageOverviewItemBuilder { @@ -4942,7 +4942,7 @@ func (builder *UsageOverviewItemBuilder) PageView(pageView string) *UsageOvervie return builder } -// 应用使用uv +// 应用使用 uv // // 示例值： func (builder *UsageOverviewItemBuilder) UniqueVisitor(uniqueVisitor string) *UsageOverviewItemBuilder { @@ -4979,16 +4979,16 @@ func (builder *UsageOverviewItemBuilder) Build() *UsageOverviewItem { type UsageTrendItem struct { Timestamp *string `json:"timestamp,omitempty"` // 时间戳 - PageView *string `json:"page_view,omitempty"` // 应用使用pv - UniqueVisitor *string `json:"unique_visitor,omitempty"` // 应用使用uv + PageView *string `json:"page_view,omitempty"` // 应用使用 pv + UniqueVisitor *string `json:"unique_visitor,omitempty"` // 应用使用 uv } type UsageTrendItemBuilder struct { timestamp string // 时间戳 timestampFlag bool - pageView string // 应用使用pv + pageView string // 应用使用 pv pageViewFlag bool - uniqueVisitor string // 应用使用uv + uniqueVisitor string // 应用使用 uv uniqueVisitorFlag bool } @@ -5006,7 +5006,7 @@ func (builder *UsageTrendItemBuilder) Timestamp(timestamp string) *UsageTrendIte return builder } -// 应用使用pv +// 应用使用 pv // // 示例值： func (builder *UsageTrendItemBuilder) PageView(pageView string) *UsageTrendItemBuilder { @@ -5015,7 +5015,7 @@ func (builder *UsageTrendItemBuilder) PageView(pageView string) *UsageTrendItemB return builder } -// 应用使用uv +// 应用使用 uv // // 示例值： func (builder *UsageTrendItemBuilder) UniqueVisitor(uniqueVisitor string) *UsageTrendItemBuilder { @@ -5042,11 +5042,11 @@ func (builder *UsageTrendItemBuilder) Build() *UsageTrendItem { } type UsageUser struct { - UserId *string `json:"user_id,omitempty"` // 用户id + UserId *string `json:"user_id,omitempty"` // 用户 id } type UsageUserBuilder struct { - userId string // 用户id + userId string // 用户 id userIdFlag bool } @@ -5055,7 +5055,7 @@ func NewUsageUserBuilder() *UsageUserBuilder { return builder } -// 用户id +// 用户 id // // 示例值： func (builder *UsageUserBuilder) UserId(userId string) *UsageUserBuilder { @@ -5287,7 +5287,7 @@ func (builder *ListAppRecommendRuleReqBuilder) PageToken(pageToken string) *List return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListAppRecommendRuleReqBuilder) UserIdType(userIdType string) *ListAppRecommendRuleReqBuilder { @@ -5338,7 +5338,7 @@ func NewGetApplicationReqBuilder() *GetApplicationReqBuilder { return builder } -// 应用的 app_id，需要查询其他应用信息时，必须申请[获取应用信息](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)权限，仅查询本应用信息时，可填入 "me" 或者应用自身 app_id +// 应用的 app_id，需要查询其他应用信息时，必须申请 [获取应用信息](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN) 权限，仅查询本应用信息时，可填入 "me" 或者应用自身 app_id // // 示例值：cli_9b445f5258795107 func (builder *GetApplicationReqBuilder) AppId(appId string) *GetApplicationReqBuilder { @@ -5354,7 +5354,7 @@ func (builder *GetApplicationReqBuilder) Lang(lang string) *GetApplicationReqBui return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetApplicationReqBuilder) UserIdType(userIdType string) *GetApplicationReqBuilder { @@ -5491,7 +5491,7 @@ func (builder *UnderauditlistApplicationReqBuilder) PageSize(pageSize int) *Unde return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UnderauditlistApplicationReqBuilder) UserIdType(userIdType string) *UnderauditlistApplicationReqBuilder { @@ -5516,7 +5516,7 @@ type UnderauditlistApplicationReq struct { type UnderauditlistApplicationRespData struct { Items []*Application `json:"items,omitempty"` // 待审核应用列表 HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token } type UnderauditlistApplicationResp struct { @@ -5530,11 +5530,11 @@ func (resp *UnderauditlistApplicationResp) Success() bool { } type OverviewApplicationAppUsageReqBodyBuilder struct { - date string // 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 + date string // 查询日期，格式为 yyyy-mm-dd，若 cycle_type 为 1，date 可以为任何自然日；若 cycle_type 为 2，则输入的 date 必须为周一； 若 cycle_type 为 3，则输入的 date 必须为每月 1 号 dateFlag bool cycleType int // 活跃周期的统计类型 cycleTypeFlag bool - departmentId string // 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 + departmentId string // 查询的部门 id，获取方法可参考 [部门 ID 概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门 id 为空，则返回当前租户的使用数据；若填写部门 id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中 department_id_type 为空或者为 open_department_id，则此处应该填写部门的 open_department_id；若路径参数中 department_id_type 为 department_id，则此处应该填写部门的 department_id。 departmentIdFlag bool ability string // 能力类型，按能力类型进行筛选，返回对应能力的活跃数据 abilityFlag bool @@ -5545,7 +5545,7 @@ func NewOverviewApplicationAppUsageReqBodyBuilder() *OverviewApplicationAppUsage return builder } -// 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 +// 查询日期，格式为 yyyy-mm-dd，若 cycle_type 为 1，date 可以为任何自然日；若 cycle_type 为 2，则输入的 date 必须为周一； 若 cycle_type 为 3，则输入的 date 必须为每月 1 号 // //示例值：2021-07-08 func (builder *OverviewApplicationAppUsageReqBodyBuilder) Date(date string) *OverviewApplicationAppUsageReqBodyBuilder { @@ -5563,7 +5563,7 @@ func (builder *OverviewApplicationAppUsageReqBodyBuilder) CycleType(cycleType in return builder } -// 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 +// 查询的部门 id，获取方法可参考 [部门 ID 概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门 id 为空，则返回当前租户的使用数据；若填写部门 id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中 department_id_type 为空或者为 open_department_id，则此处应该填写部门的 open_department_id；若路径参数中 department_id_type 为 department_id，则此处应该填写部门的 department_id。 // //示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *OverviewApplicationAppUsageReqBodyBuilder) DepartmentId(departmentId string) *OverviewApplicationAppUsageReqBodyBuilder { @@ -5599,11 +5599,11 @@ func (builder *OverviewApplicationAppUsageReqBodyBuilder) Build() *OverviewAppli } type OverviewApplicationAppUsagePathReqBodyBuilder struct { - date string // 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 + date string // 查询日期，格式为 yyyy-mm-dd，若 cycle_type 为 1，date 可以为任何自然日；若 cycle_type 为 2，则输入的 date 必须为周一； 若 cycle_type 为 3，则输入的 date 必须为每月 1 号 dateFlag bool cycleType int // 活跃周期的统计类型 cycleTypeFlag bool - departmentId string // 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 + departmentId string // 查询的部门 id，获取方法可参考 [部门 ID 概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门 id 为空，则返回当前租户的使用数据；若填写部门 id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中 department_id_type 为空或者为 open_department_id，则此处应该填写部门的 open_department_id；若路径参数中 department_id_type 为 department_id，则此处应该填写部门的 department_id。 departmentIdFlag bool ability string // 能力类型，按能力类型进行筛选，返回对应能力的活跃数据 abilityFlag bool @@ -5614,7 +5614,7 @@ func NewOverviewApplicationAppUsagePathReqBodyBuilder() *OverviewApplicationAppU return builder } -// 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 +// 查询日期，格式为 yyyy-mm-dd，若 cycle_type 为 1，date 可以为任何自然日；若 cycle_type 为 2，则输入的 date 必须为周一； 若 cycle_type 为 3，则输入的 date 必须为每月 1 号 // // 示例值：2021-07-08 func (builder *OverviewApplicationAppUsagePathReqBodyBuilder) Date(date string) *OverviewApplicationAppUsagePathReqBodyBuilder { @@ -5632,7 +5632,7 @@ func (builder *OverviewApplicationAppUsagePathReqBodyBuilder) CycleType(cycleTyp return builder } -// 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 +// 查询的部门 id，获取方法可参考 [部门 ID 概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门 id 为空，则返回当前租户的使用数据；若填写部门 id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中 department_id_type 为空或者为 open_department_id，则此处应该填写部门的 open_department_id；若路径参数中 department_id_type 为 department_id，则此处应该填写部门的 department_id。 // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *OverviewApplicationAppUsagePathReqBodyBuilder) DepartmentId(departmentId string) *OverviewApplicationAppUsagePathReqBodyBuilder { @@ -5689,7 +5689,7 @@ func (builder *OverviewApplicationAppUsageReqBuilder) AppId(appId string) *Overv return builder } -// 调用中使用的部门ID的类型 +// 调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *OverviewApplicationAppUsageReqBuilder) DepartmentIdType(departmentIdType string) *OverviewApplicationAppUsageReqBuilder { @@ -5713,9 +5713,9 @@ func (builder *OverviewApplicationAppUsageReqBuilder) Build() *OverviewApplicati } type OverviewApplicationAppUsageReqBody struct { - Date *string `json:"date,omitempty"` // 查询日期，格式为yyyy-mm-dd，若cycle_type为1，date可以为任何自然日；若cycle_type为2，则输入的date必须为周一； 若cycle_type为3，则输入的date必须为每月1号 + Date *string `json:"date,omitempty"` // 查询日期，格式为 yyyy-mm-dd，若 cycle_type 为 1，date 可以为任何自然日；若 cycle_type 为 2，则输入的 date 必须为周一； 若 cycle_type 为 3，则输入的 date 必须为每月 1 号 CycleType *int `json:"cycle_type,omitempty"` // 活跃周期的统计类型 - DepartmentId *string `json:"department_id,omitempty"` // 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 + DepartmentId *string `json:"department_id,omitempty"` // 查询的部门 id，获取方法可参考 [部门 ID 概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview);- 若部门 id 为空，则返回当前租户的使用数据；若填写部门 id，则返回当前部门的使用数据（包含子部门的用户）； ;- 若路径参数中 department_id_type 为空或者为 open_department_id，则此处应该填写部门的 open_department_id；若路径参数中 department_id_type 为 department_id，则此处应该填写部门的 department_id。 Ability *string `json:"ability,omitempty"` // 能力类型，按能力类型进行筛选，返回对应能力的活跃数据 } @@ -5751,7 +5751,7 @@ func NewGetApplicationAppVersionReqBuilder() *GetApplicationAppVersionReqBuilder return builder } -// 应用的 app_id，需要查询其他应用版本信息时，必须申请[获取应用版本信息](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)权限，仅查询本应用版本信息时，可填入 "me" 或者应用自身 app_id +// 应用的 app_id，需要查询其他应用版本信息时，必须申请 [获取应用版本信息](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN) 权限，仅查询本应用版本信息时，可填入 "me" 或者应用自身 app_id // // 示例值：cli_9f3ca975326b501b func (builder *GetApplicationAppVersionReqBuilder) AppId(appId string) *GetApplicationAppVersionReqBuilder { @@ -5775,7 +5775,7 @@ func (builder *GetApplicationAppVersionReqBuilder) Lang(lang string) *GetApplica return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetApplicationAppVersionReqBuilder) UserIdType(userIdType string) *GetApplicationAppVersionReqBuilder { @@ -5829,7 +5829,7 @@ func (builder *ListApplicationAppVersionReqBuilder) Limit(limit int) *ListApplic return builder } -// 应用的 app_id，需要查询其他应用版本信息时，必须申请[获取应用版本信息](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)权限，仅查询本应用版本信息时，可填入 "me" 或者应用自身 app_id +// 应用的 app_id，需要查询其他应用版本信息时，必须申请 [获取应用版本信息](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN) 权限，仅查询本应用版本信息时，可填入 "me" 或者应用自身 app_id // // 示例值：cli_9b445f5258795107 func (builder *ListApplicationAppVersionReqBuilder) AppId(appId string) *ListApplicationAppVersionReqBuilder { @@ -5869,7 +5869,7 @@ func (builder *ListApplicationAppVersionReqBuilder) Order(order int) *ListApplic return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListApplicationAppVersionReqBuilder) UserIdType(userIdType string) *ListApplicationAppVersionReqBuilder { @@ -5938,7 +5938,7 @@ func (builder *PatchApplicationAppVersionReqBuilder) VersionId(versionId string) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchApplicationAppVersionReqBuilder) UserIdType(userIdType string) *PatchApplicationAppVersionReqBuilder { @@ -6012,7 +6012,7 @@ func (builder *ListApplicationFeedbackReqBuilder) AppId(appId string) *ListAppli return builder } -// 查询的起始日期，格式为yyyy-mm-dd。不填则默认为当前日期减去180天。 +// 查询的起始日期，格式为 yyyy-mm-dd。不填则默认为当前日期减去 180 天。 // // 示例值：2022-01-30 func (builder *ListApplicationFeedbackReqBuilder) FromDate(fromDate string) *ListApplicationFeedbackReqBuilder { @@ -6020,7 +6020,7 @@ func (builder *ListApplicationFeedbackReqBuilder) FromDate(fromDate string) *Lis return builder } -// 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。;只能查询 180 天内的数据。 +// 查询的结束日期，格式为 yyyy-mm-dd。不填默认为当前日期。;只能查询 180 天内的数据。 // // 示例值：2022-01-30 func (builder *ListApplicationFeedbackReqBuilder) ToDate(toDate string) *ListApplicationFeedbackReqBuilder { @@ -6117,7 +6117,7 @@ func (builder *PatchApplicationFeedbackReqBuilder) AppId(appId string) *PatchApp return builder } -// 应用反馈记录id +// 应用反馈记录 id // // 示例值：7057888018203574291 func (builder *PatchApplicationFeedbackReqBuilder) FeedbackId(feedbackId string) *PatchApplicationFeedbackReqBuilder { @@ -6141,7 +6141,7 @@ func (builder *PatchApplicationFeedbackReqBuilder) Status(status int) *PatchAppl return builder } -// 反馈处理人员id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应 +// 反馈处理人员 id，租户内用户的唯一标识， ID 值与查询参数中的 user_id_type 对应 // // 示例值：ou_9565b69967831233761cc2f11b4c089f func (builder *PatchApplicationFeedbackReqBuilder) OperatorId(operatorId string) *PatchApplicationFeedbackReqBuilder { @@ -6247,15 +6247,15 @@ func (m *P2ApplicationAppVersionPublishRevokeV6) RawReq(req *larkevent.EventReq) type P2ApplicationFeedbackCreatedV6Data struct { UserId *UserId `json:"user_id,omitempty"` // 用户 ID AppId *string `json:"app_id,omitempty"` // 被反馈应用 ID - FeedbackTime *string `json:"feedback_time,omitempty"` // 反馈提交时间，格式为yyyy-mm-dd hh:mm:ss + FeedbackTime *string `json:"feedback_time,omitempty"` // 反馈提交时间，格式为 yyyy-mm-dd hh:mm:ss TenantName *string `json:"tenant_name,omitempty"` // 反馈用户的租户名 FeedbackType *int `json:"feedback_type,omitempty"` // 反馈类型（枚举值，1：故障反馈，2：产品建议） FaultType []int `json:"fault_type,omitempty"` // 故障类型列表：1: 黑屏 2: 白屏 3: 无法打开小程序 4: 卡顿 5: 小程序闪退 6: 页面加载慢 7: 死机 8: 其他异常 - FaultTime *string `json:"fault_time,omitempty"` // 故障时间，格式为yyyy-mm-dd hh:mm:ss + FaultTime *string `json:"fault_time,omitempty"` // 故障时间，格式为 yyyy-mm-dd hh:mm:ss Source *int `json:"source,omitempty"` // 反馈来源：1： 小程序 2：网页应用 3：机器人 4：webSDK Contact *string `json:"contact,omitempty"` // 用户填写的联系方式 Description *string `json:"description,omitempty"` // 反馈详情 - Images []string `json:"images,omitempty"` // 反馈图片url列表，url 过期时间三天 + Images []string `json:"images,omitempty"` // 反馈图片 url 列表，url 过期时间三天 FeedbackId *string `json:"feedback_id,omitempty"` // 应用反馈 ID，应用反馈记录唯一标识 FeedbackPath *string `json:"feedback_path,omitempty"` // 反馈页面路径 } @@ -6271,10 +6271,10 @@ func (m *P2ApplicationFeedbackCreatedV6) RawReq(req *larkevent.EventReq) { } type P2ApplicationFeedbackUpdatedV6Data struct { - FeedbackIds []string `json:"feedback_ids,omitempty"` // 反馈id列表 + FeedbackIds []string `json:"feedback_ids,omitempty"` // 反馈 id 列表 Status *int `json:"status,omitempty"` // 反馈处理状态（枚举值，0: 未处理 1: 已处理 2: 处理中 3: 已关闭） AppId *string `json:"app_id,omitempty"` // 应用的 app_id - UpdateTime *string `json:"update_time,omitempty"` // 反馈处理时间，格式为yyyy-mm-dd hh:mm:ss + UpdateTime *string `json:"update_time,omitempty"` // 反馈处理时间，格式为 yyyy-mm-dd hh:mm:ss OperatorId *UserId `json:"operator_id,omitempty"` // 操作者用户 ID } @@ -6321,7 +6321,7 @@ func (iterator *ListAppRecommendRuleIterator) Next() (bool, *AppRecommendRule, e return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6375,7 +6375,7 @@ func (iterator *UnderauditlistApplicationIterator) Next() (bool, *Application, e return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6429,7 +6429,7 @@ func (iterator *ListApplicationAppVersionIterator) Next() (bool, *ApplicationApp return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/approval/v4/api.go b/service/approval/v4/api.go index 9d1df682..9b054c17 100644 --- a/service/approval/v4/api.go +++ b/service/approval/v4/api.go @@ -71,9 +71,9 @@ type task struct { // // - 接口谨慎调用，创建后的审批定义无法停用/删除 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_approval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_approval.go func (a *approval) Create(ctx context.Context, req *CreateApprovalReq, options ...larkcore.RequestOptionFunc) (*CreateApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -97,9 +97,9 @@ func (a *approval) Create(ctx context.Context, req *CreateApprovalReq, options . // // - 根据 Approval Code 获取某个审批定义的详情，用于构造创建审批实例的请求。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/get_approval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/get_approval.go func (a *approval) Get(ctx context.Context, req *GetApprovalReq, options ...larkcore.RequestOptionFunc) (*GetApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -123,9 +123,9 @@ func (a *approval) Get(ctx context.Context, req *GetApprovalReq, options ...lark // // - 应用订阅 approval_code 后，该应用就可以收到该审批定义对应实例的事件通知。同一应用只需要订阅一次，无需重复订阅。;;当应用不希望再收到审批事件时，可以使用取消订阅接口进行取消，取消后将不再给应用推送消息。;;订阅和取消订阅都是应用维度的，多个应用可以同时订阅同一个 approval_code，每个应用都能收到审批事件。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/subscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/subscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/subscribe_approval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/subscribe_approval.go func (a *approval) Subscribe(ctx context.Context, req *SubscribeApprovalReq, options ...larkcore.RequestOptionFunc) (*SubscribeApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -149,9 +149,9 @@ func (a *approval) Subscribe(ctx context.Context, req *SubscribeApprovalReq, opt // // - 取消订阅 approval_code 后，无法再收到该审批定义对应实例的事件通知 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/unsubscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/unsubscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/unsubscribe_approval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/unsubscribe_approval.go func (a *approval) Unsubscribe(ctx context.Context, req *UnsubscribeApprovalReq, options ...larkcore.RequestOptionFunc) (*UnsubscribeApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -177,9 +177,9 @@ func (a *approval) Unsubscribe(ctx context.Context, req *UnsubscribeApprovalReq, // // - 注意，审批中心不负责审批流程的流转，只负责展示、操作、消息通知。因此审批定义创建时没有审批流程的信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_approval/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_approval/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_externalApproval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_externalApproval.go func (e *externalApproval) Create(ctx context.Context, req *CreateExternalApprovalReq, options ...larkcore.RequestOptionFunc) (*CreateExternalApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -201,11 +201,11 @@ func (e *externalApproval) Create(ctx context.Context, req *CreateExternalApprov // 三方审批实例校验 // -// - 校验三方审批实例数据，用于判断服务端数据是否为最新的。用户提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 id。;;例如，用户可以每隔5分钟，将最近5分钟产生的实例使用该接口进行对比。 +// - 校验三方审批实例数据，用于判断服务端数据是否为最新的。用户提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 id。;;例如，用户可以每隔 5 分钟，将最近 5 分钟产生的实例使用该接口进行对比。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/check +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/check // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/check_externalInstance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/check_externalInstance.go func (e *externalInstance) Check(ctx context.Context, req *CheckExternalInstanceReq, options ...larkcore.RequestOptionFunc) (*CheckExternalInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -229,9 +229,9 @@ func (e *externalInstance) Check(ctx context.Context, req *CheckExternalInstance // // - 审批中心不负责审批的流转，审批的流转在三方系统，三方系统在审批流转后生成的审批实例、审批任务、审批抄送数据同步到审批中心。;;用户可以在审批中心中浏览三方系统同步过来的实例、任务、抄送信息，并且可以跳转回三方系统进行更详细的查看和操作，其中实例信息在【已发起】列表，任务信息在【待审批】和【已审批】列表，抄送信息在【抄送我】列表;;:::html;;;;;;;;:::;;对于审批任务，三方系统也可以配置审批任务的回调接口，这样审批人可以在审批中心中直接进行审批操作，审批中心会回调三方系统，三方系统收到回调后更新任务信息，并将新的任务信息同步回审批中心，形成闭环。;;:::html;;:::;
// -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_externalInstance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_externalInstance.go func (e *externalInstance) Create(ctx context.Context, req *CreateExternalInstanceReq, options ...larkcore.RequestOptionFunc) (*CreateExternalInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -253,11 +253,11 @@ func (e *externalInstance) Create(ctx context.Context, req *CreateExternalInstan // 获取三方审批任务状态 // -// - 该接口用于获取三方审批的状态。用户传入查询条件，接口返回满足条件的审批实例的状态。该接口支持多种参数的组合，包括如下组合：;;1.通过 instance_ids 获取指定实例的任务状态;;2.通过 user_ids 获取指定用户的任务状态;;3.通过 status 获取指定状态的所有任务;;4.通过page_token获取下一批数据 +// - 该接口用于获取三方审批的状态。用户传入查询条件，接口返回满足条件的审批实例的状态。该接口支持多种参数的组合，包括如下组合：;;1.通过 instance_ids 获取指定实例的任务状态;;2.通过 user_ids 获取指定用户的任务状态;;3.通过 status 获取指定状态的所有任务;;4.通过 page_token 获取下一批数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_task/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_task/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/list_externalTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/list_externalTask.go func (e *externalTask) List(ctx context.Context, req *ListExternalTaskReq, options ...larkcore.RequestOptionFunc) (*ListExternalTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -289,9 +289,9 @@ func (e *externalTask) ListByIterator(ctx context.Context, req *ListExternalTask // // - // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/ukTM5UjL5ETO14SOxkTN/approval-task-addsign +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/ukTM5UjL5ETO14SOxkTN/approval-task-addsign // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/addSign_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/addSign_instance.go func (i *instance) AddSign(ctx context.Context, req *AddSignInstanceReq, options ...larkcore.RequestOptionFunc) (*AddSignInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -313,11 +313,11 @@ func (i *instance) AddSign(ctx context.Context, req *AddSignInstanceReq, options // 审批实例撤回 // -// - 对于状态为“审批中”的单个审批实例进行撤销操作，撤销后审批流程结束 +// - 对于状态为 “审批中” 的单个审批实例进行撤销操作，撤销后审批流程结束 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/cancel +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/cancel // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/cancel_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/cancel_instance.go func (i *instance) Cancel(ctx context.Context, req *CancelInstanceReq, options ...larkcore.RequestOptionFunc) (*CancelInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -341,9 +341,9 @@ func (i *instance) Cancel(ctx context.Context, req *CancelInstanceReq, options . // // - 通过接口可以将当前审批实例抄送给其他人。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/cc +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/cc // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/cc_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/cc_instance.go func (i *instance) Cc(ctx context.Context, req *CcInstanceReq, options ...larkcore.RequestOptionFunc) (*CcInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -367,9 +367,9 @@ func (i *instance) Cc(ctx context.Context, req *CcInstanceReq, options ...larkco // // - 创建一个审批实例，调用方需对审批定义的表单有详细了解，将按照定义的表单结构，将表单 Value 通过接口传入 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_instance.go func (i *instance) Create(ctx context.Context, req *CreateInstanceReq, options ...larkcore.RequestOptionFunc) (*CreateInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -393,9 +393,9 @@ func (i *instance) Create(ctx context.Context, req *CreateInstanceReq, options . // // - 通过审批实例 Instance Code 获取审批实例详情。Instance Code 由 [批量获取审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/list) 接口获取。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/get_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/get_instance.go func (i *instance) Get(ctx context.Context, req *GetInstanceReq, options ...larkcore.RequestOptionFunc) (*GetInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -415,13 +415,13 @@ func (i *instance) Get(ctx context.Context, req *GetInstanceReq, options ...lark return resp, err } -// 批量获取审批实例ID +// 批量获取审批实例 ID // // - 根据 approval_code 批量获取审批实例的 instance_code，用于拉取租户下某个审批定义的全部审批实例。默认以审批创建时间先后顺序排列 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/list_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/list_instance.go func (i *instance) List(ctx context.Context, req *ListInstanceReq, options ...larkcore.RequestOptionFunc) (*ListInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -453,9 +453,9 @@ func (i *instance) ListByIterator(ctx context.Context, req *ListInstanceReq, opt // // - // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/ukTM5UjL5ETO14SOxkTN/approval-preview +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/ukTM5UjL5ETO14SOxkTN/approval-preview // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/preview_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/preview_instance.go func (i *instance) Preview(ctx context.Context, req *PreviewInstanceReq, options ...larkcore.RequestOptionFunc) (*PreviewInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -479,9 +479,9 @@ func (i *instance) Preview(ctx context.Context, req *PreviewInstanceReq, options // // - 该接口通过不同条件查询审批系统中符合条件的审批实例列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/query_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/query_instance.go func (i *instance) Query(ctx context.Context, req *QueryInstanceReq, options ...larkcore.RequestOptionFunc) (*QueryInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -513,9 +513,9 @@ func (i *instance) QueryByIterator(ctx context.Context, req *QueryInstanceReq, o // // - 该接口通过不同条件查询审批系统中符合条件的审批抄送列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/search_cc +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/search_cc // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/searchCc_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/searchCc_instance.go func (i *instance) SearchCc(ctx context.Context, req *SearchCcInstanceReq, options ...larkcore.RequestOptionFunc) (*SearchCcInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -539,9 +539,9 @@ func (i *instance) SearchCc(ctx context.Context, req *SearchCcInstanceReq, optio // // - 从当前审批任务，退回到已审批的一个或多个任务节点。退回后，已审批节点重新生成审批任务 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/specified_rollback +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/specified_rollback // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/specifiedRollback_instance.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/specifiedRollback_instance.go func (i *instance) SpecifiedRollback(ctx context.Context, req *SpecifiedRollbackInstanceReq, options ...larkcore.RequestOptionFunc) (*SpecifiedRollbackInstanceResp, error) { // 发起请求 apiReq := req.apiReq @@ -565,9 +565,9 @@ func (i *instance) SpecifiedRollback(ctx context.Context, req *SpecifiedRollback // // - 在某审批实例下创建、修改评论或评论回复（不包含审批同意、拒绝、转交等附加的理由或意见）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_instanceComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/create_instanceComment.go func (i *instanceComment) Create(ctx context.Context, req *CreateInstanceCommentReq, options ...larkcore.RequestOptionFunc) (*CreateInstanceCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -591,9 +591,9 @@ func (i *instanceComment) Create(ctx context.Context, req *CreateInstanceComment // // - 逻辑删除某审批实例下的一条评论或评论回复（不包含审批同意、拒绝、转交等附加的理由或意见）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/delete_instanceComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/delete_instanceComment.go func (i *instanceComment) Delete(ctx context.Context, req *DeleteInstanceCommentReq, options ...larkcore.RequestOptionFunc) (*DeleteInstanceCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -617,9 +617,9 @@ func (i *instanceComment) Delete(ctx context.Context, req *DeleteInstanceComment // // - 根据 Instance Code 获取某个审批实例下的全部评论与评论回复（不包含审批同意、拒绝、转交等附加的理由或意见）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/list_instanceComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/list_instanceComment.go func (i *instanceComment) List(ctx context.Context, req *ListInstanceCommentReq, options ...larkcore.RequestOptionFunc) (*ListInstanceCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -643,9 +643,9 @@ func (i *instanceComment) List(ctx context.Context, req *ListInstanceCommentReq, // // - 删除某审批实例下的全部评论与评论回复。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/remove +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance-comment/remove // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/remove_instanceComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/remove_instanceComment.go func (i *instanceComment) Remove(ctx context.Context, req *RemoveInstanceCommentReq, options ...larkcore.RequestOptionFunc) (*RemoveInstanceCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -669,9 +669,9 @@ func (i *instanceComment) Remove(ctx context.Context, req *RemoveInstanceComment // // - 对于单个审批任务进行同意操作。同意后审批流程会流转到下一个审批人。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/approve +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/approve // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/approve_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/approve_task.go func (t *task) Approve(ctx context.Context, req *ApproveTaskReq, options ...larkcore.RequestOptionFunc) (*ApproveTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -695,9 +695,9 @@ func (t *task) Approve(ctx context.Context, req *ApproveTaskReq, options ...lark // // - 根据用户和任务分组查询任务列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/query_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/query_task.go func (t *task) Query(ctx context.Context, req *QueryTaskReq, options ...larkcore.RequestOptionFunc) (*QueryTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -729,9 +729,9 @@ func (t *task) QueryByIterator(ctx context.Context, req *QueryTaskReq, options . // // - 对于单个审批任务进行拒绝操作。拒绝后审批流程结束。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/reject +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/reject // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/reject_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/reject_task.go func (t *task) Reject(ctx context.Context, req *RejectTaskReq, options ...larkcore.RequestOptionFunc) (*RejectTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -755,9 +755,9 @@ func (t *task) Reject(ctx context.Context, req *RejectTaskReq, options ...larkco // // - 对于单个退回到发起人的审批任务进行重新发起操作。发起后审批流程会流转到下一个审批人。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/resubmit +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/resubmit // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/resubmit_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/resubmit_task.go func (t *task) Resubmit(ctx context.Context, req *ResubmitTaskReq, options ...larkcore.RequestOptionFunc) (*ResubmitTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -781,9 +781,9 @@ func (t *task) Resubmit(ctx context.Context, req *ResubmitTaskReq, options ...la // // - 该接口通过不同条件查询审批系统中符合条件的审批任务列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/search_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/search_task.go func (t *task) Search(ctx context.Context, req *SearchTaskReq, options ...larkcore.RequestOptionFunc) (*SearchTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -807,9 +807,9 @@ func (t *task) Search(ctx context.Context, req *SearchTaskReq, options ...larkco // // - 对于单个审批任务进行转交操作。转交后审批流程流转给被转交人。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/transfer +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/task/transfer // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/transfer_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/approvalv4/transfer_task.go func (t *task) Transfer(ctx context.Context, req *TransferTaskReq, options ...larkcore.RequestOptionFunc) (*TransferTaskResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/approval/v4/event.go b/service/approval/v4/event.go index b920fc3c..51f3d762 100644 --- a/service/approval/v4/event.go +++ b/service/approval/v4/event.go @@ -32,7 +32,7 @@ func (h *P2ApprovalUpdatedV4Handler) Event() interface{} { return &P2ApprovalUpdatedV4{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApprovalUpdatedV4Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApprovalUpdatedV4)) } diff --git a/service/approval/v4/ext_model.go b/service/approval/v4/ext_model.go index 9082b526..96aed986 100644 --- a/service/approval/v4/ext_model.go +++ b/service/approval/v4/ext_model.go @@ -27,10 +27,10 @@ func (m *P1LeaveApprovalV4) RawReq(req *larkevent.EventReq) { type P1LeaveApprovalV4Data struct { AppID string `json:"app_id,omitempty"` // APP ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` // 事件回调此处固定为event_callback - InstanceCode string `json:"instance_code,omitempty"` // 审批实例Code - UserID string `json:"user_id,omitempty"` // 用户id - OpenID string `json:"open_id,omitempty"` // 用户open_id + Type string `json:"type,omitempty"` // 事件回调此处固定为 event_callback + InstanceCode string `json:"instance_code,omitempty"` // 审批实例 Code + UserID string `json:"user_id,omitempty"` // 用户 id + OpenID string `json:"open_id,omitempty"` // 用户 open_id OriginInstanceCode string `json:"origin_instance_code,omitempty"` // 销假单关联的原始单据 StartTime int64 `json:"start_time,omitempty"` // 销假单关联的原始单据 EndTime int64 `json:"end_time,omitempty"` // 审批结束时间 @@ -69,10 +69,10 @@ func (m *P1WorkApprovalV4) RawReq(req *larkevent.EventReq) { type P1WorkApprovalV4Data struct { AppID string `json:"app_id,omitempty"` // APP ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` //事件回调此处固定为event_callback - InstanceCode string `json:"instance_code,omitempty"` // 审批实例Code - EmployeeID string `json:"employee_id,omitempty"` // 用户id - OpenID string `json:"open_id,omitempty"` // 用户open_id + Type string `json:"type,omitempty"` //事件回调此处固定为 event_callback + InstanceCode string `json:"instance_code,omitempty"` // 审批实例 Code + EmployeeID string `json:"employee_id,omitempty"` // 用户 id + OpenID string `json:"open_id,omitempty"` // 用户 open_id StartTime int64 `json:"start_time,omitempty"` // 审批发起时间 EndTime int64 `json:"end_time,omitempty"` // 审批结束时间 WorkType string `json:"work_type,omitempty"` // 加班类型 @@ -95,10 +95,10 @@ func (m *P1ShiftApprovalV4) RawReq(req *larkevent.EventReq) { type P1ShiftApprovalV4Data struct { AppID string `json:"app_id,omitempty"` // APP ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` //事件回调此处固定为event_callback - InstanceCode string `json:"instance_code,omitempty"` // 审批实例Code - EmployeeID string `json:"employee_id,omitempty"` // 用户id - OpenID string `json:"open_id,omitempty"` // 用户open_id + Type string `json:"type,omitempty"` //事件回调此处固定为 event_callback + InstanceCode string `json:"instance_code,omitempty"` // 审批实例 Code + EmployeeID string `json:"employee_id,omitempty"` // 用户 id + OpenID string `json:"open_id,omitempty"` // 用户 open_id StartTime int64 `json:"start_time,omitempty"` // 审批发起时间 EndTime int64 `json:"end_time,omitempty"` // 审批结束时间 ShiftTime string `json:"shift_time,omitempty"` // 换班时间 @@ -119,10 +119,10 @@ func (m *P1RemedyApprovalV4) RawReq(req *larkevent.EventReq) { type P1RemedyApprovalV4Data struct { AppID string `json:"app_id,omitempty"` // APP ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` //事件回调此处固定为event_callback - InstanceCode string `json:"instance_code,omitempty"` // 审批实例Code - EmployeeID string `json:"employee_id,omitempty"` // 用户id - OpenID string `json:"open_id,omitempty"` // 用户open_id + Type string `json:"type,omitempty"` //事件回调此处固定为 event_callback + InstanceCode string `json:"instance_code,omitempty"` // 审批实例 Code + EmployeeID string `json:"employee_id,omitempty"` // 用户 id + OpenID string `json:"open_id,omitempty"` // 用户 open_id StartTime int64 `json:"start_time,omitempty"` // 审批发起时间 EndTime int64 `json:"end_time,omitempty"` // 审批结束时间 RemedyTime string `json:"remedy_time,omitempty"` // 补卡时间 @@ -142,10 +142,10 @@ func (m *P1TripApprovalV4) RawReq(req *larkevent.EventReq) { type P1TripApprovalV4Data struct { AppID string `json:"app_id,omitempty"` // APP ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` //事件回调此处固定为event_callback - InstanceCode string `json:"instance_code,omitempty"` // 审批实例Code - EmployeeID string `json:"employee_id,omitempty"` // 用户id - OpenID string `json:"open_id,omitempty"` // 用户open_id + Type string `json:"type,omitempty"` //事件回调此处固定为 event_callback + InstanceCode string `json:"instance_code,omitempty"` // 审批实例 Code + EmployeeID string `json:"employee_id,omitempty"` // 用户 id + OpenID string `json:"open_id,omitempty"` // 用户 open_id StartTime int64 `json:"start_time,omitempty"` // 审批发起时间 EndTime int64 `json:"end_time,omitempty"` // 审批结束时间 Schedules []*P1TripApprovalScheduleV4 `json:"schedules,omitempty"` // Schedule 结构数组 @@ -185,7 +185,7 @@ type P1OutApprovalV4Data struct { InstanceCode string `json:"instance_code,omitempty"` // 此审批的唯一标识 OutImage string `json:"out_image,omitempty"` OutInterval int64 `json:"out_interval,omitempty"` // 外出时长，单位秒 - OutName string `json:"out_name,omitempty"` // 通过i18n_resources里的信息换取相应语言的文案 + OutName string `json:"out_name,omitempty"` // 通过 i18n_resources 里的信息换取相应语言的文案 OutReason string `json:"out_reason,omitempty"` // 外出事由 OutStartTime string `json:"out_start_time,omitempty"` // 外出开始时间 OutEndTime string `json:"out_end_time,omitempty"` // 外出结束时间 @@ -193,13 +193,13 @@ type P1OutApprovalV4Data struct { StartTime int64 `json:"start_time,omitempty"` // 审批开始时间 EndTime int64 `json:"end_time,omitempty"` // 审批结束时间 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` // 此事件此处始终为event_callback - OpenID string `json:"open_id,omitempty"` // 申请发起人open_id + Type string `json:"type,omitempty"` // 此事件此处始终为 event_callback + OpenID string `json:"open_id,omitempty"` // 申请发起人 open_id UserID string `json:"user_id,omitempty"` // 申请发起人 } type P1OutApprovalI18nResourceV4 struct { IsDefault bool `json:"is_default,omitempty"` Locale string `json:"locale,omitempty"` - Texts map[string]string `json:"texts,omitempty"` // key对应的文案 + Texts map[string]string `json:"texts,omitempty"` // key 对应的文案 } diff --git a/service/approval/v4/model.go b/service/approval/v4/model.go index 67917cb4..47f96c3b 100644 --- a/service/approval/v4/model.go +++ b/service/approval/v4/model.go @@ -25,14 +25,14 @@ import ( ) const ( - DepartmentIdTypeDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -42,20 +42,20 @@ const ( ) const ( - UserIdTypeGetApprovalUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetApprovalUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetApprovalOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetApprovalUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetApprovalUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetApprovalOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeCreateExternalApprovalDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeCreateExternalApprovalOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeCreateExternalApprovalDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeCreateExternalApprovalOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeCreateExternalApprovalUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateExternalApprovalUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateExternalApprovalOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateExternalApprovalUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateExternalApprovalUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateExternalApprovalOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -64,7 +64,7 @@ const ( StatusRejected = "REJECTED" // 审批流程结束，结果为拒绝 StatusCanceled = "CANCELED" // 审批发起人撤回 StatusDeleted = "DELETED" // 审批被删除 - StatusHidden = "HIDDEN" // 状态隐藏(不显示状态) + StatusHidden = "HIDDEN" // 状态隐藏 (不显示状态) StatusTerminated = "TERMINATED" // 审批终止 ) @@ -85,7 +85,7 @@ const ( ExternalTaskStatusApproved = "APPROVED" // 审批流程结束，结果为同意 ExternalTaskStatusRejected = "REJECTED" // 审批流程结束，结果为拒绝 ExternalTaskStatusTransferred = "TRANSFERRED" // 任务转交 - ExternalTaskStatusDone = "DONE" // 任务通过但审批人未操作；审批人看不到这个任务, 若想要看到, 可以通过抄送该人. + ExternalTaskStatusDone = "DONE" // 任务通过但审批人未操作；审批人看不到这个任务，若想要看到，可以通过抄送该人。 ) const ( @@ -102,15 +102,15 @@ const ( ) const ( - UserIdTypeCancelInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCancelInstanceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCancelInstanceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCancelInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCancelInstanceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCancelInstanceOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCcInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCcInstanceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCcInstanceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCcInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCcInstanceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCcInstanceOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -120,15 +120,15 @@ const ( ) const ( - UserIdTypeGetInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetInstanceOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeGetInstanceUnionId = "union_id" // 以union_id来识别用户 + UserIdTypeGetInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetInstanceOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeGetInstanceUnionId = "union_id" // 以 union_id 来识别用户 ) const ( - UserIdTypePreviewInstanceOpenId = "open_id" // 以open_id来识别用户 - UserIdTypePreviewInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypePreviewInstanceUnionId = "union_id" // 以union_id来识别用户 + UserIdTypePreviewInstanceOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypePreviewInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePreviewInstanceUnionId = "union_id" // 以 union_id 来识别用户 ) const ( @@ -147,9 +147,9 @@ const ( ) const ( - UserIdTypeQueryInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeQueryInstanceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeQueryInstanceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeQueryInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeQueryInstanceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeQueryInstanceOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -165,15 +165,15 @@ const ( ) const ( - UserIdTypeSearchCcInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSearchCcInstanceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSearchCcInstanceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeSearchCcInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSearchCcInstanceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSearchCcInstanceOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeSpecifiedRollbackInstanceUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSpecifiedRollbackInstanceUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSpecifiedRollbackInstanceOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeSpecifiedRollbackInstanceUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSpecifiedRollbackInstanceUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSpecifiedRollbackInstanceOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -201,9 +201,9 @@ const ( ) const ( - UserIdTypeApproveTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeApproveTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeApproveTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeApproveTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeApproveTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeApproveTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -215,21 +215,21 @@ const ( ) const ( - UserIdTypeQueryTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeQueryTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeQueryTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeQueryTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeQueryTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeQueryTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeRejectTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeRejectTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeRejectTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeRejectTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeRejectTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeRejectTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeResubmitTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeResubmitTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeResubmitTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeResubmitTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeResubmitTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeResubmitTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -250,39 +250,39 @@ const ( ) const ( - OrderUpdateTimeDESC = 0 // 按update_time倒排 - OrderUpdateTimeASC = 1 // 按update_time正排 - OrderStartTimeDESC = 2 // 按start_time倒排 - OrderStartTimeASC = 3 // 按start_time正排 + OrderUpdateTimeDESC = 0 // 按 update_time 倒排 + OrderUpdateTimeASC = 1 // 按 update_time 正排 + OrderStartTimeDESC = 2 // 按 start_time 倒排 + OrderStartTimeASC = 3 // 按 start_time 正排 ) const ( - UserIdTypeSearchTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSearchTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSearchTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeSearchTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSearchTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSearchTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeTransferTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeTransferTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeTransferTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeTransferTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeTransferTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeTransferTaskOpenId = "open_id" // 以 open_id 来识别用户 ) type ActionConfig struct { - ActionType *string `json:"action_type,omitempty"` // 操作类型，每个任务都可以配置2个操作，会展示审批列表中，当用户操作时，回调请求会带上该字段，表示用户进行了同意操作还是拒绝操作 - ActionName *string `json:"action_name,omitempty"` // 操作名称，i18n key 用于前台展示，如果 action_type 不是 APPROVAL和REJECT，则必须提供该字段，用于展示特定的操作名称 - IsNeedReason *bool `json:"is_need_reason,omitempty"` // 是否需要意见, 如果为true,则用户操作时，会跳转到 意见填写页面 + ActionType *string `json:"action_type,omitempty"` // 操作类型，每个任务都可以配置 2 个操作，会展示审批列表中，当用户操作时，回调请求会带上该字段，表示用户进行了同意操作还是拒绝操作 + ActionName *string `json:"action_name,omitempty"` // 操作名称，i18n key 用于前台展示，如果 action_type 不是 APPROVAL 和 REJECT，则必须提供该字段，用于展示特定的操作名称 + IsNeedReason *bool `json:"is_need_reason,omitempty"` // 是否需要意见，如果为 true，则用户操作时，会跳转到 意见填写页面 IsReasonRequired *bool `json:"is_reason_required,omitempty"` // 审批意见是否必填 IsNeedAttachment *bool `json:"is_need_attachment,omitempty"` // 意见是否支持上传附件 } type ActionConfigBuilder struct { - actionType string // 操作类型，每个任务都可以配置2个操作，会展示审批列表中，当用户操作时，回调请求会带上该字段，表示用户进行了同意操作还是拒绝操作 + actionType string // 操作类型，每个任务都可以配置 2 个操作，会展示审批列表中，当用户操作时，回调请求会带上该字段，表示用户进行了同意操作还是拒绝操作 actionTypeFlag bool - actionName string // 操作名称，i18n key 用于前台展示，如果 action_type 不是 APPROVAL和REJECT，则必须提供该字段，用于展示特定的操作名称 + actionName string // 操作名称，i18n key 用于前台展示，如果 action_type 不是 APPROVAL 和 REJECT，则必须提供该字段，用于展示特定的操作名称 actionNameFlag bool - isNeedReason bool // 是否需要意见, 如果为true,则用户操作时，会跳转到 意见填写页面 + isNeedReason bool // 是否需要意见，如果为 true，则用户操作时，会跳转到 意见填写页面 isNeedReasonFlag bool isReasonRequired bool // 审批意见是否必填 isReasonRequiredFlag bool @@ -295,7 +295,7 @@ func NewActionConfigBuilder() *ActionConfigBuilder { return builder } -// 操作类型，每个任务都可以配置2个操作，会展示审批列表中，当用户操作时，回调请求会带上该字段，表示用户进行了同意操作还是拒绝操作 +// 操作类型，每个任务都可以配置 2 个操作，会展示审批列表中，当用户操作时，回调请求会带上该字段，表示用户进行了同意操作还是拒绝操作 // // 示例值：APPROVE func (builder *ActionConfigBuilder) ActionType(actionType string) *ActionConfigBuilder { @@ -304,7 +304,7 @@ func (builder *ActionConfigBuilder) ActionType(actionType string) *ActionConfigB return builder } -// 操作名称，i18n key 用于前台展示，如果 action_type 不是 APPROVAL和REJECT，则必须提供该字段，用于展示特定的操作名称 +// 操作名称，i18n key 用于前台展示，如果 action_type 不是 APPROVAL 和 REJECT，则必须提供该字段，用于展示特定的操作名称 // // 示例值：@i18n@5 func (builder *ActionConfigBuilder) ActionName(actionName string) *ActionConfigBuilder { @@ -313,7 +313,7 @@ func (builder *ActionConfigBuilder) ActionName(actionName string) *ActionConfigB return builder } -// 是否需要意见, 如果为true,则用户操作时，会跳转到 意见填写页面 +// 是否需要意见，如果为 true，则用户操作时，会跳转到 意见填写页面 // // 示例值：false func (builder *ActionConfigBuilder) IsNeedReason(isNeedReason bool) *ActionConfigBuilder { @@ -366,13 +366,13 @@ func (builder *ActionConfigBuilder) Build() *ActionConfig { } type Approval struct { - ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义code + ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code ApprovalName *string `json:"approval_name,omitempty"` // 审批定义名称 Status *string `json:"status,omitempty"` // 审批定义状态 } type ApprovalBuilder struct { - approvalCode string // 审批定义code + approvalCode string // 审批定义 code approvalCodeFlag bool approvalName string // 审批定义名称 approvalNameFlag bool @@ -385,7 +385,7 @@ func NewApprovalBuilder() *ApprovalBuilder { return builder } -// 审批定义code +// 审批定义 code // // 示例值： func (builder *ApprovalBuilder) ApprovalCode(approvalCode string) *ApprovalBuilder { @@ -430,15 +430,15 @@ func (builder *ApprovalBuilder) Build() *Approval { } type ApprovalApproverCcer struct { - Type *string `json:"type,omitempty"` // 审批/抄送人类型， ; 1. 当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3；;; 2. 当 type 为 Personal 时，需要填写对应的user_id ，用于指定用户；;; 3. 当 approver 为 Free 发起人自选时，不需要指定 user_id 和level；;; 4. ccer不支持 Free 发起人自选 - UserId *string `json:"user_id,omitempty"` // 用户id，根据user_id_type填写 + Type *string `json:"type,omitempty"` // 审批/抄送人类型， ; 1. 当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3；;; 2. 当 type 为 Personal 时，需要填写对应的 user_id ，用于指定用户；;; 3. 当 approver 为 Free 发起人自选时，不需要指定 user_id 和 level；;; 4. ccer 不支持 Free 发起人自选 + UserId *string `json:"user_id,omitempty"` // 用户 id，根据 user_id_type 填写 Level *string `json:"level,omitempty"` // 审批级数，当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3 } type ApprovalApproverCcerBuilder struct { - type_ string // 审批/抄送人类型， ; 1. 当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3；;; 2. 当 type 为 Personal 时，需要填写对应的user_id ，用于指定用户；;; 3. 当 approver 为 Free 发起人自选时，不需要指定 user_id 和level；;; 4. ccer不支持 Free 发起人自选 + type_ string // 审批/抄送人类型， ; 1. 当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3；;; 2. 当 type 为 Personal 时，需要填写对应的 user_id ，用于指定用户；;; 3. 当 approver 为 Free 发起人自选时，不需要指定 user_id 和 level；;; 4. ccer 不支持 Free 发起人自选 typeFlag bool - userId string // 用户id，根据user_id_type填写 + userId string // 用户 id，根据 user_id_type 填写 userIdFlag bool level string // 审批级数，当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3 levelFlag bool @@ -449,7 +449,7 @@ func NewApprovalApproverCcerBuilder() *ApprovalApproverCcerBuilder { return builder } -// 审批/抄送人类型， ; 1. 当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3；;; 2. 当 type 为 Personal 时，需要填写对应的user_id ，用于指定用户；;; 3. 当 approver 为 Free 发起人自选时，不需要指定 user_id 和level；;; 4. ccer不支持 Free 发起人自选 +// 审批/抄送人类型， ; 1. 当 type 为 Supervisor、SupervisorTopDown、DepartmentManager 、DepartmentManagerTopDown 这 4 种时，需要在 level 中填写对应的级数，例如：由下往上三级主管审批，level = 3；;; 2. 当 type 为 Personal 时，需要填写对应的 user_id ，用于指定用户；;; 3. 当 approver 为 Free 发起人自选时，不需要指定 user_id 和 level；;; 4. ccer 不支持 Free 发起人自选 // // 示例值：Supervisor func (builder *ApprovalApproverCcerBuilder) Type(type_ string) *ApprovalApproverCcerBuilder { @@ -458,7 +458,7 @@ func (builder *ApprovalApproverCcerBuilder) Type(type_ string) *ApprovalApprover return builder } -// 用户id，根据user_id_type填写 +// 用户 id，根据 user_id_type 填写 // // 示例值：f7cb567e func (builder *ApprovalApproverCcerBuilder) UserId(userId string) *ApprovalApproverCcerBuilder { @@ -593,14 +593,14 @@ type ApprovalCreate struct { ApprovalName *string `json:"approval_name,omitempty"` // 审批名称的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符 ApprovalCode *string `json:"approval_code,omitempty"` // 传空表示新建 Description *string `json:"description,omitempty"` // 审批描述的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符 - Viewers []*ApprovalCreateViewers `json:"viewers,omitempty"` // viewers 字段指定了哪些人能从审批应用的前台发起该审批。;; 1. 当 viewer_type 为 USER，需要填写viewer_user_id；;; 2. 当 viewer_type 为DEPARTMENT，需要填写viewer_department_id；;; 3. 当 viewer_type 为TENANT或NONE时，viewer_user_id和viewer_department_id无需填写 + Viewers []*ApprovalCreateViewers `json:"viewers,omitempty"` // viewers 字段指定了哪些人能从审批应用的前台发起该审批。;; 1. 当 viewer_type 为 USER，需要填写 viewer_user_id；;; 2. 当 viewer_type 为 DEPARTMENT，需要填写 viewer_department_id；;; 3. 当 viewer_type 为 TENANT 或 NONE 时，viewer_user_id 和 viewer_department_id 无需填写 Form *ApprovalForm `json:"form,omitempty"` // 审批定义表单 NodeList []*ApprovalNode `json:"node_list,omitempty"` // 审批定义节点，需要将开始节点作为 list 第一个元素，结束节点作为最后一个元素 Settings *ApprovalSetting `json:"settings,omitempty"` // 审批定义其他设置 Config *ApprovalConfig `json:"config,omitempty"` // 审批定义配置项，用于配置对应审批定义是否可以由用户在审批后台进行修改 Icon *int `json:"icon,omitempty"` // 审批图标枚举，详见下方说明，默认为 0 I18nResources []*I18nResource `json:"i18n_resources,omitempty"` // 国际化文案 - ProcessManagerIds []string `json:"process_manager_ids,omitempty"` // 根据user_id_type填写流程管理员的用户id + ProcessManagerIds []string `json:"process_manager_ids,omitempty"` // 根据 user_id_type 填写流程管理员的用户 id } type ApprovalCreateBuilder struct { @@ -610,7 +610,7 @@ type ApprovalCreateBuilder struct { approvalCodeFlag bool description string // 审批描述的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符 descriptionFlag bool - viewers []*ApprovalCreateViewers // viewers 字段指定了哪些人能从审批应用的前台发起该审批。;; 1. 当 viewer_type 为 USER，需要填写viewer_user_id；;; 2. 当 viewer_type 为DEPARTMENT，需要填写viewer_department_id；;; 3. 当 viewer_type 为TENANT或NONE时，viewer_user_id和viewer_department_id无需填写 + viewers []*ApprovalCreateViewers // viewers 字段指定了哪些人能从审批应用的前台发起该审批。;; 1. 当 viewer_type 为 USER，需要填写 viewer_user_id；;; 2. 当 viewer_type 为 DEPARTMENT，需要填写 viewer_department_id；;; 3. 当 viewer_type 为 TENANT 或 NONE 时，viewer_user_id 和 viewer_department_id 无需填写 viewersFlag bool form *ApprovalForm // 审批定义表单 formFlag bool @@ -624,7 +624,7 @@ type ApprovalCreateBuilder struct { iconFlag bool i18nResources []*I18nResource // 国际化文案 i18nResourcesFlag bool - processManagerIds []string // 根据user_id_type填写流程管理员的用户id + processManagerIds []string // 根据 user_id_type 填写流程管理员的用户 id processManagerIdsFlag bool } @@ -660,7 +660,7 @@ func (builder *ApprovalCreateBuilder) Description(description string) *ApprovalC return builder } -// viewers 字段指定了哪些人能从审批应用的前台发起该审批。;; 1. 当 viewer_type 为 USER，需要填写viewer_user_id；;; 2. 当 viewer_type 为DEPARTMENT，需要填写viewer_department_id；;; 3. 当 viewer_type 为TENANT或NONE时，viewer_user_id和viewer_department_id无需填写 +// viewers 字段指定了哪些人能从审批应用的前台发起该审批。;; 1. 当 viewer_type 为 USER，需要填写 viewer_user_id；;; 2. 当 viewer_type 为 DEPARTMENT，需要填写 viewer_department_id；;; 3. 当 viewer_type 为 TENANT 或 NONE 时，viewer_user_id 和 viewer_department_id 无需填写 // // 示例值： func (builder *ApprovalCreateBuilder) Viewers(viewers []*ApprovalCreateViewers) *ApprovalCreateBuilder { @@ -723,7 +723,7 @@ func (builder *ApprovalCreateBuilder) I18nResources(i18nResources []*I18nResourc return builder } -// 根据user_id_type填写流程管理员的用户id +// 根据 user_id_type 填写流程管理员的用户 id // // 示例值：["1c5ea995"] func (builder *ApprovalCreateBuilder) ProcessManagerIds(processManagerIds []string) *ApprovalCreateBuilder { @@ -775,34 +775,34 @@ func (builder *ApprovalCreateBuilder) Build() *ApprovalCreate { } type ApprovalCreateExternal struct { - BizName *string `json:"biz_name,omitempty"` // 列表中用于提示审批来自哪里，i18n key， 注意不需要“来自”前缀，审批中心会拼上前缀 + BizName *string `json:"biz_name,omitempty"` // 列表中用于提示审批来自哪里，i18n key， 注意不需要 “来自” 前缀，审批中心会拼上前缀 BizType *string `json:"biz_type,omitempty"` // 审批定义业务类别 - CreateLinkMobile *string `json:"create_link_mobile,omitempty"` // 移动端发起链接，如果设置了该链接，则会在移动端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在mobile端不显示该审批 - CreateLinkPc *string `json:"create_link_pc,omitempty"` // PC端发起链接，如果设置了该链接，则会在PC端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在PC端不显示该审批； - SupportPc *bool `json:"support_pc,omitempty"` // 审批实例、审批任务、审批抄送是否要在PC端展示，如果为 true，则PC端列表会展示该定义下的实例信息，否则，不展示 - SupportMobile *bool `json:"support_mobile,omitempty"` // 审批实例、审批任务、审批抄送是否要在移动端展示，如果为 true，则移动端列表会展示该定义下的实例信息，否则，不展示； support_pc和support_mobile不可都为false，否则不展示 + CreateLinkMobile *string `json:"create_link_mobile,omitempty"` // 移动端发起链接，如果设置了该链接，则会在移动端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在 mobile 端不显示该审批 + CreateLinkPc *string `json:"create_link_pc,omitempty"` // PC 端发起链接，如果设置了该链接，则会在 PC 端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在 PC 端不显示该审批； + SupportPc *bool `json:"support_pc,omitempty"` // 审批实例、审批任务、审批抄送是否要在 PC 端展示，如果为 true，则 PC 端列表会展示该定义下的实例信息，否则，不展示 + SupportMobile *bool `json:"support_mobile,omitempty"` // 审批实例、审批任务、审批抄送是否要在移动端展示，如果为 true，则移动端列表会展示该定义下的实例信息，否则，不展示； support_pc 和 support_mobile 不可都为 false，否则不展示 SupportBatchRead *bool `json:"support_batch_read,omitempty"` // 是否支持批量已读 EnableMarkReaded *bool `json:"enable_mark_readed,omitempty"` // 是否支持标注可读（该字段无效） EnableQuickOperate *bool `json:"enable_quick_operate,omitempty"` // 是否支持快速操作 ActionCallbackUrl *string `json:"action_callback_url,omitempty"` // 三方系统的操作回调 url，【待审批】列表的任务审批人点同意或拒绝操作后，审批中心调用该地址通知三方系统，回调地址相关信息可参见：[三方审批快捷审批回调](https://open.feishu.cn/document/ukTMukTMukTM/ukjNyYjL5YjM24SO2IjN/quick-approval-callback) - ActionCallbackToken *string `json:"action_callback_token,omitempty"` // 回调时带的 token， 用于业务系统验证请求来自审批,具体参考 [开放平台文档](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM) + ActionCallbackToken *string `json:"action_callback_token,omitempty"` // 回调时带的 token， 用于业务系统验证请求来自审批，具体参考 [开放平台文档](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM) ActionCallbackKey *string `json:"action_callback_key,omitempty"` // 请求参数加密密钥，如果配置了该参数，则会对请求参数进行加密，业务需要对请求进行解密，加解密算法参考 [关联外部选项说明](https://open.feishu.cn/document/ukTMukTMukTM/uADM4QjLwADO04CMwgDN) AllowBatchOperate *bool `json:"allow_batch_operate,omitempty"` // 是否支持批量审批 ExcludeEfficiencyStatistics *bool `json:"exclude_efficiency_statistics,omitempty"` // 审批流程数据是否不纳入效率统计 } type ApprovalCreateExternalBuilder struct { - bizName string // 列表中用于提示审批来自哪里，i18n key， 注意不需要“来自”前缀，审批中心会拼上前缀 + bizName string // 列表中用于提示审批来自哪里，i18n key， 注意不需要 “来自” 前缀，审批中心会拼上前缀 bizNameFlag bool bizType string // 审批定义业务类别 bizTypeFlag bool - createLinkMobile string // 移动端发起链接，如果设置了该链接，则会在移动端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在mobile端不显示该审批 + createLinkMobile string // 移动端发起链接，如果设置了该链接，则会在移动端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在 mobile 端不显示该审批 createLinkMobileFlag bool - createLinkPc string // PC端发起链接，如果设置了该链接，则会在PC端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在PC端不显示该审批； + createLinkPc string // PC 端发起链接，如果设置了该链接，则会在 PC 端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在 PC 端不显示该审批； createLinkPcFlag bool - supportPc bool // 审批实例、审批任务、审批抄送是否要在PC端展示，如果为 true，则PC端列表会展示该定义下的实例信息，否则，不展示 + supportPc bool // 审批实例、审批任务、审批抄送是否要在 PC 端展示，如果为 true，则 PC 端列表会展示该定义下的实例信息，否则，不展示 supportPcFlag bool - supportMobile bool // 审批实例、审批任务、审批抄送是否要在移动端展示，如果为 true，则移动端列表会展示该定义下的实例信息，否则，不展示； support_pc和support_mobile不可都为false，否则不展示 + supportMobile bool // 审批实例、审批任务、审批抄送是否要在移动端展示，如果为 true，则移动端列表会展示该定义下的实例信息，否则，不展示； support_pc 和 support_mobile 不可都为 false，否则不展示 supportMobileFlag bool supportBatchRead bool // 是否支持批量已读 supportBatchReadFlag bool @@ -812,7 +812,7 @@ type ApprovalCreateExternalBuilder struct { enableQuickOperateFlag bool actionCallbackUrl string // 三方系统的操作回调 url，【待审批】列表的任务审批人点同意或拒绝操作后，审批中心调用该地址通知三方系统，回调地址相关信息可参见：[三方审批快捷审批回调](https://open.feishu.cn/document/ukTMukTMukTM/ukjNyYjL5YjM24SO2IjN/quick-approval-callback) actionCallbackUrlFlag bool - actionCallbackToken string // 回调时带的 token， 用于业务系统验证请求来自审批,具体参考 [开放平台文档](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM) + actionCallbackToken string // 回调时带的 token， 用于业务系统验证请求来自审批，具体参考 [开放平台文档](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM) actionCallbackTokenFlag bool actionCallbackKey string // 请求参数加密密钥，如果配置了该参数，则会对请求参数进行加密，业务需要对请求进行解密，加解密算法参考 [关联外部选项说明](https://open.feishu.cn/document/ukTMukTMukTM/uADM4QjLwADO04CMwgDN) actionCallbackKeyFlag bool @@ -827,7 +827,7 @@ func NewApprovalCreateExternalBuilder() *ApprovalCreateExternalBuilder { return builder } -// 列表中用于提示审批来自哪里，i18n key， 注意不需要“来自”前缀，审批中心会拼上前缀 +// 列表中用于提示审批来自哪里，i18n key， 注意不需要 “来自” 前缀，审批中心会拼上前缀 // // 示例值：@i18n@3 func (builder *ApprovalCreateExternalBuilder) BizName(bizName string) *ApprovalCreateExternalBuilder { @@ -845,7 +845,7 @@ func (builder *ApprovalCreateExternalBuilder) BizType(bizType string) *ApprovalC return builder } -// 移动端发起链接，如果设置了该链接，则会在移动端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在mobile端不显示该审批 +// 移动端发起链接，如果设置了该链接，则会在移动端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在 mobile 端不显示该审批 // // 示例值：https://applink.feishu.cn/client/mini_program/open?appId=cli_9c90fc38e07a9101&path=pages/approval-form/index?id=9999 func (builder *ApprovalCreateExternalBuilder) CreateLinkMobile(createLinkMobile string) *ApprovalCreateExternalBuilder { @@ -854,7 +854,7 @@ func (builder *ApprovalCreateExternalBuilder) CreateLinkMobile(createLinkMobile return builder } -// PC端发起链接，如果设置了该链接，则会在PC端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在PC端不显示该审批； +// PC 端发起链接，如果设置了该链接，则会在 PC 端审批发起页展示该审批，用户点击后会跳转到该链接进行发起； 如果不填，则在 PC 端不显示该审批； // // 示例值：https://applink.feishu.cn/client/mini_program/open?mode=appCenter&appId=cli_9c90fc38e07a9101&path=pc/pages/create-form/index?id=9999 func (builder *ApprovalCreateExternalBuilder) CreateLinkPc(createLinkPc string) *ApprovalCreateExternalBuilder { @@ -863,7 +863,7 @@ func (builder *ApprovalCreateExternalBuilder) CreateLinkPc(createLinkPc string) return builder } -// 审批实例、审批任务、审批抄送是否要在PC端展示，如果为 true，则PC端列表会展示该定义下的实例信息，否则，不展示 +// 审批实例、审批任务、审批抄送是否要在 PC 端展示，如果为 true，则 PC 端列表会展示该定义下的实例信息，否则，不展示 // // 示例值：true func (builder *ApprovalCreateExternalBuilder) SupportPc(supportPc bool) *ApprovalCreateExternalBuilder { @@ -872,7 +872,7 @@ func (builder *ApprovalCreateExternalBuilder) SupportPc(supportPc bool) *Approva return builder } -// 审批实例、审批任务、审批抄送是否要在移动端展示，如果为 true，则移动端列表会展示该定义下的实例信息，否则，不展示； support_pc和support_mobile不可都为false，否则不展示 +// 审批实例、审批任务、审批抄送是否要在移动端展示，如果为 true，则移动端列表会展示该定义下的实例信息，否则，不展示； support_pc 和 support_mobile 不可都为 false，否则不展示 // // 示例值：true func (builder *ApprovalCreateExternalBuilder) SupportMobile(supportMobile bool) *ApprovalCreateExternalBuilder { @@ -917,7 +917,7 @@ func (builder *ApprovalCreateExternalBuilder) ActionCallbackUrl(actionCallbackUr return builder } -// 回调时带的 token， 用于业务系统验证请求来自审批,具体参考 [开放平台文档](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM) +// 回调时带的 token， 用于业务系统验证请求来自审批，具体参考 [开放平台文档](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM) // // 示例值：sdjkljkx9lsadf110 func (builder *ApprovalCreateExternalBuilder) ActionCallbackToken(actionCallbackToken string) *ApprovalCreateExternalBuilder { @@ -1016,16 +1016,16 @@ func (builder *ApprovalCreateExternalBuilder) Build() *ApprovalCreateExternal { type ApprovalCreateViewers struct { ViewerType *string `json:"viewer_type,omitempty"` // 可见人类型 - ViewerUserId *string `json:"viewer_user_id,omitempty"` // 当 viewer_type 是 USER，根据user_id_type填写用户id - ViewerDepartmentId *string `json:"viewer_department_id,omitempty"` // 当 viewer_type 为DEPARTMENT，根据department_id_type填写部门id + ViewerUserId *string `json:"viewer_user_id,omitempty"` // 当 viewer_type 是 USER，根据 user_id_type 填写用户 id + ViewerDepartmentId *string `json:"viewer_department_id,omitempty"` // 当 viewer_type 为 DEPARTMENT，根据 department_id_type 填写部门 id } type ApprovalCreateViewersBuilder struct { viewerType string // 可见人类型 viewerTypeFlag bool - viewerUserId string // 当 viewer_type 是 USER，根据user_id_type填写用户id + viewerUserId string // 当 viewer_type 是 USER，根据 user_id_type 填写用户 id viewerUserIdFlag bool - viewerDepartmentId string // 当 viewer_type 为DEPARTMENT，根据department_id_type填写部门id + viewerDepartmentId string // 当 viewer_type 为 DEPARTMENT，根据 department_id_type 填写部门 id viewerDepartmentIdFlag bool } @@ -1043,7 +1043,7 @@ func (builder *ApprovalCreateViewersBuilder) ViewerType(viewerType string) *Appr return builder } -// 当 viewer_type 是 USER，根据user_id_type填写用户id +// 当 viewer_type 是 USER，根据 user_id_type 填写用户 id // // 示例值：19a294c2 func (builder *ApprovalCreateViewersBuilder) ViewerUserId(viewerUserId string) *ApprovalCreateViewersBuilder { @@ -1052,7 +1052,7 @@ func (builder *ApprovalCreateViewersBuilder) ViewerUserId(viewerUserId string) * return builder } -// 当 viewer_type 为DEPARTMENT，根据department_id_type填写部门id +// 当 viewer_type 为 DEPARTMENT，根据 department_id_type 填写部门 id // // 示例值：od-ac9d697abfa990b715dcc33d58a62a9d func (builder *ApprovalCreateViewersBuilder) ViewerDepartmentId(viewerDepartmentId string) *ApprovalCreateViewersBuilder { @@ -1223,11 +1223,11 @@ func (builder *ApprovalEventBuilder) Build() *ApprovalEvent { } type ApprovalForm struct { - FormContent *string `json:"form_content,omitempty"` // 审批定义表单，json 数组，见下方form_content字段说明 + FormContent *string `json:"form_content,omitempty"` // 审批定义表单，json 数组，见下方 form_content 字段说明 } type ApprovalFormBuilder struct { - formContent string // 审批定义表单，json 数组，见下方form_content字段说明 + formContent string // 审批定义表单，json 数组，见下方 form_content 字段说明 formContentFlag bool } @@ -1236,7 +1236,7 @@ func NewApprovalFormBuilder() *ApprovalFormBuilder { return builder } -// 审批定义表单，json 数组，见下方form_content字段说明 +// 审批定义表单，json 数组，见下方 form_content 字段说明 // // 示例值：[{\"id\":\"user_name\", \"type\": \"input\", \"required\":true, \"name\":\"@i18n@widget1\"}] func (builder *ApprovalFormBuilder) FormContent(formContent string) *ApprovalFormBuilder { @@ -1257,7 +1257,7 @@ func (builder *ApprovalFormBuilder) Build() *ApprovalForm { type ApprovalNode struct { Id *string `json:"id,omitempty"` // 节点 ID，开始节点的 ID 为 START，结束节点的 ID 为 END，开始和结束节点不需要指定 name、node_type 以及 approver Name *string `json:"name,omitempty"` // 节点名称的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符 - NodeType *string `json:"node_type,omitempty"` // 审批类型枚举,当 node_type 为依次审批时，审批人必须为『发起人自选』 + NodeType *string `json:"node_type,omitempty"` // 审批类型枚举，当 node_type 为依次审批时，审批人必须为『发起人自选』 Approver []*ApprovalApproverCcer `json:"approver,omitempty"` // 审批人列表 Ccer []*ApprovalApproverCcer `json:"ccer,omitempty"` // 抄送人列表 PrivilegeField *FieldGroup `json:"privilege_field,omitempty"` // 表单项的控件权限 @@ -1271,7 +1271,7 @@ type ApprovalNodeBuilder struct { idFlag bool name string // 节点名称的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符 nameFlag bool - nodeType string // 审批类型枚举,当 node_type 为依次审批时，审批人必须为『发起人自选』 + nodeType string // 审批类型枚举，当 node_type 为依次审批时，审批人必须为『发起人自选』 nodeTypeFlag bool approver []*ApprovalApproverCcer // 审批人列表 approverFlag bool @@ -1310,7 +1310,7 @@ func (builder *ApprovalNodeBuilder) Name(name string) *ApprovalNodeBuilder { return builder } -// 审批类型枚举,当 node_type 为依次审批时，审批人必须为『发起人自选』 +// 审批类型枚举，当 node_type 为依次审批时，审批人必须为『发起人自选』 // // 示例值：AND func (builder *ApprovalNodeBuilder) NodeType(nodeType string) *ApprovalNodeBuilder { @@ -1555,14 +1555,14 @@ func (builder *ApprovalNodeInfoBuilder) Build() *ApprovalNodeInfo { type ApprovalSetting struct { RevertInterval *int `json:"revert_interval,omitempty"` // 审批实例通过后允许撤回的时间，以秒为单位，默认 31 天，0 为不可撤回 - RevertOption *int `json:"revert_option,omitempty"` // 是否支持审批通过第一个节点后撤回，默认为1，0为不支持 + RevertOption *int `json:"revert_option,omitempty"` // 是否支持审批通过第一个节点后撤回，默认为 1，0 为不支持 RejectOption *int `json:"reject_option,omitempty"` // 拒绝设置 } type ApprovalSettingBuilder struct { revertInterval int // 审批实例通过后允许撤回的时间，以秒为单位，默认 31 天，0 为不可撤回 revertIntervalFlag bool - revertOption int // 是否支持审批通过第一个节点后撤回，默认为1，0为不支持 + revertOption int // 是否支持审批通过第一个节点后撤回，默认为 1，0 为不支持 revertOptionFlag bool rejectOption int // 拒绝设置 rejectOptionFlag bool @@ -1582,7 +1582,7 @@ func (builder *ApprovalSettingBuilder) RevertInterval(revertInterval int) *Appro return builder } -// 是否支持审批通过第一个节点后撤回，默认为1，0为不支持 +// 是否支持审批通过第一个节点后撤回，默认为 1，0 为不支持 // // 示例值：0 func (builder *ApprovalSettingBuilder) RevertOption(revertOption int) *ApprovalSettingBuilder { @@ -1619,19 +1619,19 @@ func (builder *ApprovalSettingBuilder) Build() *ApprovalSetting { type ApprovalViewer struct { Type *string `json:"type,omitempty"` // 可见人类型，人员、部门或全体 - OpenId *string `json:"open_id,omitempty"` // 同一个应用中对用户进行标识的id - UserId *string `json:"user_id,omitempty"` // 用户id - UnionId *string `json:"union_id,omitempty"` // 同一个应用开发主体下对用户进行标识的id + OpenId *string `json:"open_id,omitempty"` // 同一个应用中对用户进行标识的 id + UserId *string `json:"user_id,omitempty"` // 用户 id + UnionId *string `json:"union_id,omitempty"` // 同一个应用开发主体下对用户进行标识的 id } type ApprovalViewerBuilder struct { type_ string // 可见人类型，人员、部门或全体 typeFlag bool - openId string // 同一个应用中对用户进行标识的id + openId string // 同一个应用中对用户进行标识的 id openIdFlag bool - userId string // 用户id + userId string // 用户 id userIdFlag bool - unionId string // 同一个应用开发主体下对用户进行标识的id + unionId string // 同一个应用开发主体下对用户进行标识的 id unionIdFlag bool } @@ -1649,7 +1649,7 @@ func (builder *ApprovalViewerBuilder) Type(type_ string) *ApprovalViewerBuilder return builder } -// 同一个应用中对用户进行标识的id +// 同一个应用中对用户进行标识的 id // // 示例值：ou_e03053f0541cecc3269d7a9dc34a0b21 func (builder *ApprovalViewerBuilder) OpenId(openId string) *ApprovalViewerBuilder { @@ -1658,7 +1658,7 @@ func (builder *ApprovalViewerBuilder) OpenId(openId string) *ApprovalViewerBuild return builder } -// 用户id +// 用户 id // // 示例值：f7cb567e func (builder *ApprovalViewerBuilder) UserId(userId string) *ApprovalViewerBuilder { @@ -1667,7 +1667,7 @@ func (builder *ApprovalViewerBuilder) UserId(userId string) *ApprovalViewerBuild return builder } -// 同一个应用开发主体下对用户进行标识的id +// 同一个应用开发主体下对用户进行标识的 id // // 示例值：f7cb567e func (builder *ApprovalViewerBuilder) UnionId(unionId string) *ApprovalViewerBuilder { @@ -1699,16 +1699,16 @@ func (builder *ApprovalViewerBuilder) Build() *ApprovalViewer { type ApprovalViewerInfo struct { Type *string `json:"type,omitempty"` // 可见人类型 - Id *string `json:"id,omitempty"` // 在可见人类型为DEPARTMENT时，id为部门的id ；在可见人类型为USER时，id为用户的id ；在可见人类型为ROLE时，id为角色的id ；在可见人类型为USER_GROUP时，id为用户组的id - UserId *string `json:"user_id,omitempty"` // 在可见人类型为USER时，表示可见人用户id + Id *string `json:"id,omitempty"` // 在可见人类型为 DEPARTMENT 时，id 为部门的 id ；在可见人类型为 USER 时，id 为用户的 id ；在可见人类型为 ROLE 时，id 为角色的 id ；在可见人类型为 USER_GROUP 时，id 为用户组的 id + UserId *string `json:"user_id,omitempty"` // 在可见人类型为 USER 时，表示可见人用户 id } type ApprovalViewerInfoBuilder struct { type_ string // 可见人类型 typeFlag bool - id string // 在可见人类型为DEPARTMENT时，id为部门的id ；在可见人类型为USER时，id为用户的id ；在可见人类型为ROLE时，id为角色的id ；在可见人类型为USER_GROUP时，id为用户组的id + id string // 在可见人类型为 DEPARTMENT 时，id 为部门的 id ；在可见人类型为 USER 时，id 为用户的 id ；在可见人类型为 ROLE 时，id 为角色的 id ；在可见人类型为 USER_GROUP 时，id 为用户组的 id idFlag bool - userId string // 在可见人类型为USER时，表示可见人用户id + userId string // 在可见人类型为 USER 时，表示可见人用户 id userIdFlag bool } @@ -1726,7 +1726,7 @@ func (builder *ApprovalViewerInfoBuilder) Type(type_ string) *ApprovalViewerInfo return builder } -// 在可见人类型为DEPARTMENT时，id为部门的id ；在可见人类型为USER时，id为用户的id ；在可见人类型为ROLE时，id为角色的id ；在可见人类型为USER_GROUP时，id为用户组的id +// 在可见人类型为 DEPARTMENT 时，id 为部门的 id ；在可见人类型为 USER 时，id 为用户的 id ；在可见人类型为 ROLE 时，id 为角色的 id ；在可见人类型为 USER_GROUP 时，id 为用户组的 id // // 示例值：ou_e03053f0541cecc3269d7a9dc34a0b21 func (builder *ApprovalViewerInfoBuilder) Id(id string) *ApprovalViewerInfoBuilder { @@ -1735,7 +1735,7 @@ func (builder *ApprovalViewerInfoBuilder) Id(id string) *ApprovalViewerInfoBuild return builder } -// 在可见人类型为USER时，表示可见人用户id +// 在可见人类型为 USER 时，表示可见人用户 id // // 示例值：f7cb567e func (builder *ApprovalViewerInfoBuilder) UserId(userId string) *ApprovalViewerInfoBuilder { @@ -1763,13 +1763,13 @@ func (builder *ApprovalViewerInfoBuilder) Build() *ApprovalViewerInfo { type ApproverChosenRange struct { ApproverRangeType *int `json:"approver_range_type,omitempty"` // 指定范围：0-all，1-指定角色，2-指定人员 - ApproverRangeIds []string `json:"approver_range_ids,omitempty"` // 根据上面的type，分别存放角色id与userid，type为0时本字段为空列表 + ApproverRangeIds []string `json:"approver_range_ids,omitempty"` // 根据上面的 type，分别存放角色 id 与 userid，type 为 0 时本字段为空列表 } type ApproverChosenRangeBuilder struct { approverRangeType int // 指定范围：0-all，1-指定角色，2-指定人员 approverRangeTypeFlag bool - approverRangeIds []string // 根据上面的type，分别存放角色id与userid，type为0时本字段为空列表 + approverRangeIds []string // 根据上面的 type，分别存放角色 id 与 userid，type 为 0 时本字段为空列表 approverRangeIdsFlag bool } @@ -1787,7 +1787,7 @@ func (builder *ApproverChosenRangeBuilder) ApproverRangeType(approverRangeType i return builder } -// 根据上面的type，分别存放角色id与userid，type为0时本字段为空列表 +// 根据上面的 type，分别存放角色 id 与 userid，type 为 0 时本字段为空列表 // // 示例值： func (builder *ApproverChosenRangeBuilder) ApproverRangeIds(approverRangeIds []string) *ApproverChosenRangeBuilder { @@ -1810,13 +1810,13 @@ func (builder *ApproverChosenRangeBuilder) Build() *ApproverChosenRange { type ApproverRange struct { Type *string `json:"type,omitempty"` // 审批人类型 - IdList []string `json:"id_list,omitempty"` // 审批人id + IdList []string `json:"id_list,omitempty"` // 审批人 id } type ApproverRangeBuilder struct { type_ string // 审批人类型 typeFlag bool - idList []string // 审批人id + idList []string // 审批人 id idListFlag bool } @@ -1834,7 +1834,7 @@ func (builder *ApproverRangeBuilder) Type(type_ string) *ApproverRangeBuilder { return builder } -// 审批人id +// 审批人 id // // 示例值：f7cb567e func (builder *ApproverRangeBuilder) IdList(idList []string) *ApproverRangeBuilder { @@ -1858,13 +1858,13 @@ func (builder *ApproverRangeBuilder) Build() *ApproverRange { type CcNode struct { CcId *string `json:"cc_id,omitempty"` // 审批实例内唯一标识 UserId *string `json:"user_id,omitempty"` // 抄送人 employee id - OpenId *string `json:"open_id,omitempty"` // 抄送人 open id，和user id 二者至少填一个 - Links *ExternalInstanceLink `json:"links,omitempty"` // 跳转链接，用于【抄送我的】列表中的跳转pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 + OpenId *string `json:"open_id,omitempty"` // 抄送人 open id，和 user id 二者至少填一个 + Links *ExternalInstanceLink `json:"links,omitempty"` // 跳转链接，用于【抄送我的】列表中的跳转 pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 ReadStatus *string `json:"read_status,omitempty"` // 阅读状态，空值表示不支持已读未读： Extra *string `json:"extra,omitempty"` // 扩展 json Title *string `json:"title,omitempty"` // 抄送任务名称 CreateTime *string `json:"create_time,omitempty"` // 抄送发起时间，Unix 毫秒时间戳 - UpdateTime *string `json:"update_time,omitempty"` // 抄送最近更新时间，用于推送数据版本控制更新策略同 instance 的update_time + UpdateTime *string `json:"update_time,omitempty"` // 抄送最近更新时间，用于推送数据版本控制更新策略同 instance 的 update_time DisplayMethod *string `json:"display_method,omitempty"` // 列表页打开审批任务的方式 } @@ -1873,9 +1873,9 @@ type CcNodeBuilder struct { ccIdFlag bool userId string // 抄送人 employee id userIdFlag bool - openId string // 抄送人 open id，和user id 二者至少填一个 + openId string // 抄送人 open id，和 user id 二者至少填一个 openIdFlag bool - links *ExternalInstanceLink // 跳转链接，用于【抄送我的】列表中的跳转pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 + links *ExternalInstanceLink // 跳转链接，用于【抄送我的】列表中的跳转 pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 linksFlag bool readStatus string // 阅读状态，空值表示不支持已读未读： readStatusFlag bool @@ -1885,7 +1885,7 @@ type CcNodeBuilder struct { titleFlag bool createTime string // 抄送发起时间，Unix 毫秒时间戳 createTimeFlag bool - updateTime string // 抄送最近更新时间，用于推送数据版本控制更新策略同 instance 的update_time + updateTime string // 抄送最近更新时间，用于推送数据版本控制更新策略同 instance 的 update_time updateTimeFlag bool displayMethod string // 列表页打开审批任务的方式 displayMethodFlag bool @@ -1914,7 +1914,7 @@ func (builder *CcNodeBuilder) UserId(userId string) *CcNodeBuilder { return builder } -// 抄送人 open id，和user id 二者至少填一个 +// 抄送人 open id，和 user id 二者至少填一个 // // 示例值：ou_be73cbc0ee35eb6ca54e9e7cc14998c1 func (builder *CcNodeBuilder) OpenId(openId string) *CcNodeBuilder { @@ -1923,7 +1923,7 @@ func (builder *CcNodeBuilder) OpenId(openId string) *CcNodeBuilder { return builder } -// 跳转链接，用于【抄送我的】列表中的跳转pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 +// 跳转链接，用于【抄送我的】列表中的跳转 pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 // // 示例值： func (builder *CcNodeBuilder) Links(links *ExternalInstanceLink) *CcNodeBuilder { @@ -1968,7 +1968,7 @@ func (builder *CcNodeBuilder) CreateTime(createTime string) *CcNodeBuilder { return builder } -// 抄送最近更新时间，用于推送数据版本控制更新策略同 instance 的update_time +// 抄送最近更新时间，用于推送数据版本控制更新策略同 instance 的 update_time // // 示例值：1556468012678 func (builder *CcNodeBuilder) UpdateTime(updateTime string) *CcNodeBuilder { @@ -2031,20 +2031,20 @@ func (builder *CcNodeBuilder) Build() *CcNode { } type CcSearch struct { - UserId *string `json:"user_id,omitempty"` // 根据x_user_type填写用户 id + UserId *string `json:"user_id,omitempty"` // 根据 x_user_type 填写用户 id ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code InstanceExternalId *string `json:"instance_external_id,omitempty"` // 审批实例第三方 id 注：和 approval_code 取并集 GroupExternalId *string `json:"group_external_id,omitempty"` // 审批定义分组第三方 id 注：和 instance_code 取并集 CcTitle *string `json:"cc_title,omitempty"` // 审批抄送标题（只有第三方审批有） ReadStatus *string `json:"read_status,omitempty"` // 审批抄送状态，注：若不设置，查询全部状态 若不在集合中，报错 - CcCreateTimeFrom *string `json:"cc_create_time_from,omitempty"` // 抄送查询开始时间（unix毫秒时间戳） - CcCreateTimeTo *string `json:"cc_create_time_to,omitempty"` // 抄送查询结束时间 (unix毫秒时间戳) + CcCreateTimeFrom *string `json:"cc_create_time_from,omitempty"` // 抄送查询开始时间（unix 毫秒时间戳） + CcCreateTimeTo *string `json:"cc_create_time_to,omitempty"` // 抄送查询结束时间 (unix 毫秒时间戳) Locale *string `json:"locale,omitempty"` // 地区 } type CcSearchBuilder struct { - userId string // 根据x_user_type填写用户 id + userId string // 根据 x_user_type 填写用户 id userIdFlag bool approvalCode string // 审批定义 code approvalCodeFlag bool @@ -2058,9 +2058,9 @@ type CcSearchBuilder struct { ccTitleFlag bool readStatus string // 审批抄送状态，注：若不设置，查询全部状态 若不在集合中，报错 readStatusFlag bool - ccCreateTimeFrom string // 抄送查询开始时间（unix毫秒时间戳） + ccCreateTimeFrom string // 抄送查询开始时间（unix 毫秒时间戳） ccCreateTimeFromFlag bool - ccCreateTimeTo string // 抄送查询结束时间 (unix毫秒时间戳) + ccCreateTimeTo string // 抄送查询结束时间 (unix 毫秒时间戳) ccCreateTimeToFlag bool locale string // 地区 localeFlag bool @@ -2071,7 +2071,7 @@ func NewCcSearchBuilder() *CcSearchBuilder { return builder } -// 根据x_user_type填写用户 id +// 根据 x_user_type 填写用户 id // // 示例值：lwiu098wj func (builder *CcSearchBuilder) UserId(userId string) *CcSearchBuilder { @@ -2134,7 +2134,7 @@ func (builder *CcSearchBuilder) ReadStatus(readStatus string) *CcSearchBuilder { return builder } -// 抄送查询开始时间（unix毫秒时间戳） +// 抄送查询开始时间（unix 毫秒时间戳） // // 示例值：1547654251506 func (builder *CcSearchBuilder) CcCreateTimeFrom(ccCreateTimeFrom string) *CcSearchBuilder { @@ -2143,7 +2143,7 @@ func (builder *CcSearchBuilder) CcCreateTimeFrom(ccCreateTimeFrom string) *CcSea return builder } -// 抄送查询结束时间 (unix毫秒时间戳) +// 抄送查询结束时间 (unix 毫秒时间戳) // // 示例值：1547654251506 func (builder *CcSearchBuilder) CcCreateTimeTo(ccCreateTimeTo string) *CcSearchBuilder { @@ -2287,7 +2287,7 @@ type CcSearchNode struct { CreateTime *string `json:"create_time,omitempty"` // 审批抄送开始时间 ReadStatus *string `json:"read_status,omitempty"` // 审批抄送状态 Title *string `json:"title,omitempty"` // 审批抄送名称（只有第三方审批有） - Extra *string `json:"extra,omitempty"` // 审批抄送扩展字段，string型json + Extra *string `json:"extra,omitempty"` // 审批抄送扩展字段，string 型 json Link *InstanceSearchLink `json:"link,omitempty"` // 审批抄送链接（只有第三方审批有） } @@ -2300,7 +2300,7 @@ type CcSearchNodeBuilder struct { readStatusFlag bool title string // 审批抄送名称（只有第三方审批有） titleFlag bool - extra string // 审批抄送扩展字段，string型json + extra string // 审批抄送扩展字段，string 型 json extraFlag bool link *InstanceSearchLink // 审批抄送链接（只有第三方审批有） linkFlag bool @@ -2347,7 +2347,7 @@ func (builder *CcSearchNodeBuilder) Title(title string) *CcSearchNodeBuilder { return builder } -// 审批抄送扩展字段，string型json +// 审批抄送扩展字段，string 型 json // // 示例值：{} func (builder *CcSearchNodeBuilder) Extra(extra string) *CcSearchNodeBuilder { @@ -2394,7 +2394,7 @@ func (builder *CcSearchNodeBuilder) Build() *CcSearchNode { } type Comment struct { - Id *string `json:"id,omitempty"` // 评论ID + Id *string `json:"id,omitempty"` // 评论 ID Content *string `json:"content,omitempty"` // 评论内容 CreateTime *string `json:"create_time,omitempty"` // 评论创建时间 UpdateTime *string `json:"update_time,omitempty"` // 评论更新时间 @@ -2406,7 +2406,7 @@ type Comment struct { } type CommentBuilder struct { - id string // 评论ID + id string // 评论 ID idFlag bool content string // 评论内容 contentFlag bool @@ -2431,7 +2431,7 @@ func NewCommentBuilder() *CommentBuilder { return builder } -// 评论ID +// 评论 ID // // 示例值：7081516627711524883 func (builder *CommentBuilder) Id(id string) *CommentBuilder { @@ -2442,7 +2442,7 @@ func (builder *CommentBuilder) Id(id string) *CommentBuilder { // 评论内容 // -// 示例值：{\"text\":\"x@王某自小程序的评论111我带了附件，而且我艾特了人 \",\"files\":[{\"url\":\"https://xx-xxx-xxx.bytedance.net/lark-approval-attachment/image/20220401/1/d43216ca-93b5-43a8-8a34-23c66820463a.png~tplv-k7bg0smxju-image.image?x-orig-authkey=boeorigin\&x-orig-expires=1650963890\&x-orig-sign=668QhQbRSt6638x2Ws8wFI%2FxqVg%3D#.png\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\"}]} +// 示例值：{\"text\":\"x@王某自小程序的评论 111 我带了附件，而且我艾特了人 \",\"files\":[{\"url\":\"https://xx-xxx-xxx.bytedance.net/lark-approval-attachment/image/20220401/1/d43216ca-93b5-43a8-8a34-23c66820463a.png~tplv-k7bg0smxju-image.image?x-orig-authkey=boeorigin\&x-orig-expires=1650963890\&x-orig-sign=668QhQbRSt6638x2Ws8wFI%2FxqVg%3D#.png\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\"}]} func (builder *CommentBuilder) Content(content string) *CommentBuilder { builder.content = content builder.contentFlag = true @@ -2552,17 +2552,17 @@ func (builder *CommentBuilder) Build() *Comment { } type CommentAtInfo struct { - UserId *string `json:"user_id,omitempty"` // 被艾特人的ID + UserId *string `json:"user_id,omitempty"` // 被艾特人的 ID Name *string `json:"name,omitempty"` // 被艾特人的姓名 - Offset *string `json:"offset,omitempty"` // 被艾特人在评论中的位置，从0开始 + Offset *string `json:"offset,omitempty"` // 被艾特人在评论中的位置，从 0 开始 } type CommentAtInfoBuilder struct { - userId string // 被艾特人的ID + userId string // 被艾特人的 ID userIdFlag bool name string // 被艾特人的姓名 nameFlag bool - offset string // 被艾特人在评论中的位置，从0开始 + offset string // 被艾特人在评论中的位置，从 0 开始 offsetFlag bool } @@ -2571,7 +2571,7 @@ func NewCommentAtInfoBuilder() *CommentAtInfoBuilder { return builder } -// 被艾特人的ID +// 被艾特人的 ID // // 示例值：579fd9c4 func (builder *CommentAtInfoBuilder) UserId(userId string) *CommentAtInfoBuilder { @@ -2589,7 +2589,7 @@ func (builder *CommentAtInfoBuilder) Name(name string) *CommentAtInfoBuilder { return builder } -// 被艾特人在评论中的位置，从0开始 +// 被艾特人在评论中的位置，从 0 开始 // // 示例值：1 func (builder *CommentAtInfoBuilder) Offset(offset string) *CommentAtInfoBuilder { @@ -2616,7 +2616,7 @@ func (builder *CommentAtInfoBuilder) Build() *CommentAtInfo { } type CommentReply struct { - Id *string `json:"id,omitempty"` // 评论ID + Id *string `json:"id,omitempty"` // 评论 ID Content *string `json:"content,omitempty"` // 评论内容 CreateTime *string `json:"create_time,omitempty"` // 评论创建时间 UpdateTime *string `json:"update_time,omitempty"` // 评论更新时间 @@ -2627,7 +2627,7 @@ type CommentReply struct { } type CommentReplyBuilder struct { - id string // 评论ID + id string // 评论 ID idFlag bool content string // 评论内容 contentFlag bool @@ -2650,7 +2650,7 @@ func NewCommentReplyBuilder() *CommentReplyBuilder { return builder } -// 评论ID +// 评论 ID // // 示例值：7081516611634741268 func (builder *CommentReplyBuilder) Id(id string) *CommentReplyBuilder { @@ -2661,7 +2661,7 @@ func (builder *CommentReplyBuilder) Id(id string) *CommentReplyBuilder { // 评论内容 // -// 示例值：{\"text\":\"x@张某来自小程序的评论111,这是一条回复\",\"files\":[{\"url\":\"https://xx-xxx-xxx.bytedance.net/lark-approval-attachment/image/20220401/1/d43216ca-93b5-43a8-8a34-23c66820463a.png~tplv-k7bg0smxju-image.image?x-orig-authkey=boeorigin\&x-orig-expires=1650963890\&x-orig-sign=668QhQbRSt6638x2Ws8wFI%2FxqVg%3D#.png\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\"}]} +// 示例值：{\"text\":\"x@张某来自小程序的评论 111，这是一条回复\",\"files\":[{\"url\":\"https://xx-xxx-xxx.bytedance.net/lark-approval-attachment/image/20220401/1/d43216ca-93b5-43a8-8a34-23c66820463a.png~tplv-k7bg0smxju-image.image?x-orig-authkey=boeorigin\&x-orig-expires=1650963890\&x-orig-sign=668QhQbRSt6638x2Ws8wFI%2FxqVg%3D#.png\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\"}]} func (builder *CommentReplyBuilder) Content(content string) *CommentReplyBuilder { builder.content = content builder.contentFlag = true @@ -2761,9 +2761,9 @@ func (builder *CommentReplyBuilder) Build() *CommentReply { type CommentRequest struct { Content *string `json:"content,omitempty"` // 评论内容，包含艾特人、附件等 AtInfoList []*CommentAtInfo `json:"at_info_list,omitempty"` // 评论中艾特人信息 - ParentCommentId *string `json:"parent_comment_id,omitempty"` // 父评论ID，如果是回复评论，需要传 - CommentId *string `json:"comment_id,omitempty"` // 评论ID，如果是编辑、删除一条评论，需要传 - DisableBot *bool `json:"disable_bot,omitempty"` // disable_bot=true只同步数据，不触发bot + ParentCommentId *string `json:"parent_comment_id,omitempty"` // 父评论 ID，如果是回复评论，需要传 + CommentId *string `json:"comment_id,omitempty"` // 评论 ID，如果是编辑、删除一条评论，需要传 + DisableBot *bool `json:"disable_bot,omitempty"` // disable_bot=true 只同步数据，不触发 bot Extra *string `json:"extra,omitempty"` // 附加字段 } @@ -2772,11 +2772,11 @@ type CommentRequestBuilder struct { contentFlag bool atInfoList []*CommentAtInfo // 评论中艾特人信息 atInfoListFlag bool - parentCommentId string // 父评论ID，如果是回复评论，需要传 + parentCommentId string // 父评论 ID，如果是回复评论，需要传 parentCommentIdFlag bool - commentId string // 评论ID，如果是编辑、删除一条评论，需要传 + commentId string // 评论 ID，如果是编辑、删除一条评论，需要传 commentIdFlag bool - disableBot bool // disable_bot=true只同步数据，不触发bot + disableBot bool // disable_bot=true 只同步数据，不触发 bot disableBotFlag bool extra string // 附加字段 extraFlag bool @@ -2789,7 +2789,7 @@ func NewCommentRequestBuilder() *CommentRequestBuilder { // 评论内容，包含艾特人、附件等 // -// 示例值：{\"text\":\"来自小程序的评论111我带附件中有extra \",\"files\":[{\"url\":\"xxx\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\",\"extra\":\"\"}]} +// 示例值：{\"text\":\"来自小程序的评论 111 我带附件中有 extra \",\"files\":[{\"url\":\"xxx\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\",\"extra\":\"\"}]} func (builder *CommentRequestBuilder) Content(content string) *CommentRequestBuilder { builder.content = content builder.contentFlag = true @@ -2805,7 +2805,7 @@ func (builder *CommentRequestBuilder) AtInfoList(atInfoList []*CommentAtInfo) *C return builder } -// 父评论ID，如果是回复评论，需要传 +// 父评论 ID，如果是回复评论，需要传 // // 示例值：7081516627711524883 func (builder *CommentRequestBuilder) ParentCommentId(parentCommentId string) *CommentRequestBuilder { @@ -2814,7 +2814,7 @@ func (builder *CommentRequestBuilder) ParentCommentId(parentCommentId string) *C return builder } -// 评论ID，如果是编辑、删除一条评论，需要传 +// 评论 ID，如果是编辑、删除一条评论，需要传 // // 示例值：7081516627711524883 func (builder *CommentRequestBuilder) CommentId(commentId string) *CommentRequestBuilder { @@ -2823,7 +2823,7 @@ func (builder *CommentRequestBuilder) CommentId(commentId string) *CommentReques return builder } -// disable_bot=true只同步数据，不触发bot +// disable_bot=true 只同步数据，不触发 bot // // 示例值：false func (builder *CommentRequestBuilder) DisableBot(disableBot bool) *CommentRequestBuilder { @@ -2919,13 +2919,13 @@ func (builder *CountBuilder) Build() *Count { type Definition struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code 示例值："7C468A54-8745-2245-9675-08B7C63E7A85" - ApprovalName *string `json:"approval_name,omitempty"` // 审批名称，根据传入的local字段返回对应的国际化文案，未设置该国际化文案时返回默认语言对应文案 + ApprovalName *string `json:"approval_name,omitempty"` // 审批名称，根据传入的 local 字段返回对应的国际化文案，未设置该国际化文案时返回默认语言对应文案 } type DefinitionBuilder struct { approvalCode string // 审批定义 code 示例值："7C468A54-8745-2245-9675-08B7C63E7A85" approvalCodeFlag bool - approvalName string // 审批名称，根据传入的local字段返回对应的国际化文案，未设置该国际化文案时返回默认语言对应文案 + approvalName string // 审批名称，根据传入的 local 字段返回对应的国际化文案，未设置该国际化文案时返回默认语言对应文案 approvalNameFlag bool } @@ -2943,7 +2943,7 @@ func (builder *DefinitionBuilder) ApprovalCode(approvalCode string) *DefinitionB return builder } -// 审批名称，根据传入的local字段返回对应的国际化文案，未设置该国际化文案时返回默认语言对应文案 +// 审批名称，根据传入的 local 字段返回对应的国际化文案，未设置该国际化文案时返回默认语言对应文案 // // 示例值：请假 func (builder *DefinitionBuilder) ApprovalName(approvalName string) *DefinitionBuilder { @@ -3094,13 +3094,13 @@ func (builder *ExteranlInstanceCheckResponseBuilder) Build() *ExteranlInstanceCh type ExternalApproval struct { ApprovalName *string `json:"approval_name,omitempty"` // 审批定义名称，创建审批定义返回的值，表示该实例属于哪个流程；该字段会影响到列表中该实例的标题，标题取自对应定义的 name 字段。 ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code，用户自定义，定义的唯一标识，如果不存在该 code，则创建，否则更新 - GroupCode *string `json:"group_code,omitempty"` // 审批定义所属审批分组，用户自定义； 如果group_code当前不存在，则会新建审批分组； 如果group_code已经存在，则会使用group_name更新审批分组名称 + GroupCode *string `json:"group_code,omitempty"` // 审批定义所属审批分组，用户自定义； 如果 group_code 当前不存在，则会新建审批分组； 如果 group_code 已经存在，则会使用 group_name 更新审批分组名称 GroupName *string `json:"group_name,omitempty"` // 分组名称，值的格式是 i18n key，文案放在 i18n_resource； 如果是 group_code 当前不存在，则该 group_name 必填，否则，如果填写了则会更新分组名称，不填则不更新分组名称； 审批发起页 审批定义的分组名称来自该字段 Description *string `json:"description,omitempty"` // 审批定义的说明，值的格式是 i18n key，文案放在 i18n_resource； 审批发起页 审批定义的说明内容来自该字段 External *ApprovalCreateExternal `json:"external,omitempty"` // 三方审批相关 Viewers []*ApprovalCreateViewers `json:"viewers,omitempty"` // 可见人列表，可通知配置多个可见人，只有在配置的范围内用户可以在审批发起也看到该审批，默认不传，则是任何人不可见 I18nResources []*I18nResource `json:"i18n_resources,omitempty"` // 国际化文案 - Managers []string `json:"managers,omitempty"` // 根据user_id_type填写流程管理员id + Managers []string `json:"managers,omitempty"` // 根据 user_id_type 填写流程管理员 id } type ExternalApprovalBuilder struct { @@ -3108,7 +3108,7 @@ type ExternalApprovalBuilder struct { approvalNameFlag bool approvalCode string // 审批定义 code，用户自定义，定义的唯一标识，如果不存在该 code，则创建，否则更新 approvalCodeFlag bool - groupCode string // 审批定义所属审批分组，用户自定义； 如果group_code当前不存在，则会新建审批分组； 如果group_code已经存在，则会使用group_name更新审批分组名称 + groupCode string // 审批定义所属审批分组，用户自定义； 如果 group_code 当前不存在，则会新建审批分组； 如果 group_code 已经存在，则会使用 group_name 更新审批分组名称 groupCodeFlag bool groupName string // 分组名称，值的格式是 i18n key，文案放在 i18n_resource； 如果是 group_code 当前不存在，则该 group_name 必填，否则，如果填写了则会更新分组名称，不填则不更新分组名称； 审批发起页 审批定义的分组名称来自该字段 groupNameFlag bool @@ -3120,7 +3120,7 @@ type ExternalApprovalBuilder struct { viewersFlag bool i18nResources []*I18nResource // 国际化文案 i18nResourcesFlag bool - managers []string // 根据user_id_type填写流程管理员id + managers []string // 根据 user_id_type 填写流程管理员 id managersFlag bool } @@ -3147,7 +3147,7 @@ func (builder *ExternalApprovalBuilder) ApprovalCode(approvalCode string) *Exter return builder } -// 审批定义所属审批分组，用户自定义； 如果group_code当前不存在，则会新建审批分组； 如果group_code已经存在，则会使用group_name更新审批分组名称 +// 审批定义所属审批分组，用户自定义； 如果 group_code 当前不存在，则会新建审批分组； 如果 group_code 已经存在，则会使用 group_name 更新审批分组名称 // // 示例值：work_group func (builder *ExternalApprovalBuilder) GroupCode(groupCode string) *ExternalApprovalBuilder { @@ -3201,7 +3201,7 @@ func (builder *ExternalApprovalBuilder) I18nResources(i18nResources []*I18nResou return builder } -// 根据user_id_type填写流程管理员id +// 根据 user_id_type 填写流程管理员 id // // 示例值：19a294c2 func (builder *ExternalApprovalBuilder) Managers(managers []string) *ExternalApprovalBuilder { @@ -3254,23 +3254,23 @@ type ExternalInstance struct { InstanceId *string `json:"instance_id,omitempty"` // 审批实例唯一标识，用户自定义，需确保证租户下唯一 Links *ExternalInstanceLink `json:"links,omitempty"` // 审批实例链接集合 ，用于【已发起】列表的跳转，跳转回三方系统； pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 Title *string `json:"title,omitempty"` // 审批展示名称，如果填写了该字段，则审批列表中的审批名称使用该字段，如果不填该字段，则审批名称使用审批定义的名称 - Form []*ExternalInstanceForm `json:"form,omitempty"` // 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心pc展示前2个,移动端展示前3个,长度不超过2048字符 + Form []*ExternalInstanceForm `json:"form,omitempty"` // 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心 pc 展示前 2 个，移动端展示前 3 个，长度不超过 2048 字符 UserId *string `json:"user_id,omitempty"` // 审批发起人 user_id，发起人可在【已发起】列表中看到所有已发起的审批; 在【待审批】，【已审批】【抄送我】列表中，该字段展示审批是谁发起的。审批发起人 open id，和 user id 二者至少填一个。 UserName *string `json:"user_name,omitempty"` // 审批发起人 用户名，如果发起人不是真实的用户（例如是某个部门），没有 user_id，则可以使用该字段传名称 OpenId *string `json:"open_id,omitempty"` // 审批发起人 open id，和 user id 二者至少填一个 DepartmentId *string `json:"department_id,omitempty"` // 发起人部门，用于列表中展示发起人所属部门。不传则不展示。如果用户没加入任何部门，传 ""，将展示租户名称传 department_name 展示部门名称 DepartmentName *string `json:"department_name,omitempty"` // 审批发起人 部门，如果发起人不是真实的用户（例如是某个部门），没有 department_id，则可以使用该字段传名称 - StartTime *string `json:"start_time,omitempty"` // 审批发起时间，Unix毫秒时间戳 - EndTime *string `json:"end_time,omitempty"` // 审批实例结束时间：未结束的审批为 0，Unix毫秒时间戳 + StartTime *string `json:"start_time,omitempty"` // 审批发起时间，Unix 毫秒时间戳 + EndTime *string `json:"end_time,omitempty"` // 审批实例结束时间：未结束的审批为 0，Unix 毫秒时间戳 UpdateTime *string `json:"update_time,omitempty"` // 审批实例最近更新时间；用于推送数据版本控制如果 update_mode 值为 UPDATE，则只有传过来的 update_time 有变化时（变大），才会更新审批中心中的审批实例信息。使用该字段主要用来避免并发时老的数据更新了新的数据 DisplayMethod *string `json:"display_method,omitempty"` // 列表页打开审批实例的方式 - UpdateMode *string `json:"update_mode,omitempty"` // 更新方式， 当 update_mode=REPLACE时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据 + UpdateMode *string `json:"update_mode,omitempty"` // 更新方式， 当 update_mode=REPLACE 时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE 时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据 TaskList []*ExternalInstanceTaskNode `json:"task_list,omitempty"` // 任务列表 CcList []*CcNode `json:"cc_list,omitempty"` // 抄送列表 I18nResources []*I18nResource `json:"i18n_resources,omitempty"` // 国际化文案 - TrusteeshipUrlToken *string `json:"trusteeship_url_token,omitempty"` // 单据托管认证token，托管回调会附带此token，帮助业务方认证 + TrusteeshipUrlToken *string `json:"trusteeship_url_token,omitempty"` // 单据托管认证 token，托管回调会附带此 token，帮助业务方认证 TrusteeshipUserIdType *string `json:"trusteeship_user_id_type,omitempty"` // 用户的类型，会影响请求参数用户标识域的选择，包括加签操作回传的目标用户， 目前仅支持 "user_id" - TrusteeshipUrls *TrusteeshipUrls `json:"trusteeship_urls,omitempty"` // 单据托管回调接入方的接口的URL地址 + TrusteeshipUrls *TrusteeshipUrls `json:"trusteeship_urls,omitempty"` // 单据托管回调接入方的接口的 URL 地址 } type ExternalInstanceBuilder struct { @@ -3286,7 +3286,7 @@ type ExternalInstanceBuilder struct { linksFlag bool title string // 审批展示名称，如果填写了该字段，则审批列表中的审批名称使用该字段，如果不填该字段，则审批名称使用审批定义的名称 titleFlag bool - form []*ExternalInstanceForm // 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心pc展示前2个,移动端展示前3个,长度不超过2048字符 + form []*ExternalInstanceForm // 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心 pc 展示前 2 个，移动端展示前 3 个，长度不超过 2048 字符 formFlag bool userId string // 审批发起人 user_id，发起人可在【已发起】列表中看到所有已发起的审批; 在【待审批】，【已审批】【抄送我】列表中，该字段展示审批是谁发起的。审批发起人 open id，和 user id 二者至少填一个。 userIdFlag bool @@ -3298,15 +3298,15 @@ type ExternalInstanceBuilder struct { departmentIdFlag bool departmentName string // 审批发起人 部门，如果发起人不是真实的用户（例如是某个部门），没有 department_id，则可以使用该字段传名称 departmentNameFlag bool - startTime string // 审批发起时间，Unix毫秒时间戳 + startTime string // 审批发起时间，Unix 毫秒时间戳 startTimeFlag bool - endTime string // 审批实例结束时间：未结束的审批为 0，Unix毫秒时间戳 + endTime string // 审批实例结束时间：未结束的审批为 0，Unix 毫秒时间戳 endTimeFlag bool updateTime string // 审批实例最近更新时间；用于推送数据版本控制如果 update_mode 值为 UPDATE，则只有传过来的 update_time 有变化时（变大），才会更新审批中心中的审批实例信息。使用该字段主要用来避免并发时老的数据更新了新的数据 updateTimeFlag bool displayMethod string // 列表页打开审批实例的方式 displayMethodFlag bool - updateMode string // 更新方式， 当 update_mode=REPLACE时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据 + updateMode string // 更新方式， 当 update_mode=REPLACE 时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE 时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据 updateModeFlag bool taskList []*ExternalInstanceTaskNode // 任务列表 taskListFlag bool @@ -3314,11 +3314,11 @@ type ExternalInstanceBuilder struct { ccListFlag bool i18nResources []*I18nResource // 国际化文案 i18nResourcesFlag bool - trusteeshipUrlToken string // 单据托管认证token，托管回调会附带此token，帮助业务方认证 + trusteeshipUrlToken string // 单据托管认证 token，托管回调会附带此 token，帮助业务方认证 trusteeshipUrlTokenFlag bool trusteeshipUserIdType string // 用户的类型，会影响请求参数用户标识域的选择，包括加签操作回传的目标用户， 目前仅支持 "user_id" trusteeshipUserIdTypeFlag bool - trusteeshipUrls *TrusteeshipUrls // 单据托管回调接入方的接口的URL地址 + trusteeshipUrls *TrusteeshipUrls // 单据托管回调接入方的接口的 URL 地址 trusteeshipUrlsFlag bool } @@ -3381,7 +3381,7 @@ func (builder *ExternalInstanceBuilder) Title(title string) *ExternalInstanceBui return builder } -// 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心pc展示前2个,移动端展示前3个,长度不超过2048字符 +// 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心 pc 展示前 2 个，移动端展示前 3 个，长度不超过 2048 字符 // // 示例值：[{ "name": "@i18n@2", "value": "@i18n@3" }] func (builder *ExternalInstanceBuilder) Form(form []*ExternalInstanceForm) *ExternalInstanceBuilder { @@ -3435,7 +3435,7 @@ func (builder *ExternalInstanceBuilder) DepartmentName(departmentName string) *E return builder } -// 审批发起时间，Unix毫秒时间戳 +// 审批发起时间，Unix 毫秒时间戳 // // 示例值：1556468012678 func (builder *ExternalInstanceBuilder) StartTime(startTime string) *ExternalInstanceBuilder { @@ -3444,7 +3444,7 @@ func (builder *ExternalInstanceBuilder) StartTime(startTime string) *ExternalIns return builder } -// 审批实例结束时间：未结束的审批为 0，Unix毫秒时间戳 +// 审批实例结束时间：未结束的审批为 0，Unix 毫秒时间戳 // // 示例值：1556468012678 func (builder *ExternalInstanceBuilder) EndTime(endTime string) *ExternalInstanceBuilder { @@ -3471,7 +3471,7 @@ func (builder *ExternalInstanceBuilder) DisplayMethod(displayMethod string) *Ext return builder } -// 更新方式， 当 update_mode=REPLACE时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据 +// 更新方式， 当 update_mode=REPLACE 时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE 时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据 // // 示例值：UPDATE func (builder *ExternalInstanceBuilder) UpdateMode(updateMode string) *ExternalInstanceBuilder { @@ -3507,7 +3507,7 @@ func (builder *ExternalInstanceBuilder) I18nResources(i18nResources []*I18nResou return builder } -// 单据托管认证token，托管回调会附带此token，帮助业务方认证 +// 单据托管认证 token，托管回调会附带此 token，帮助业务方认证 // // 示例值：788981c886b1c28ac29d1e68efd60683d6d90dfce80938ee9453e2a5f3e9e306 func (builder *ExternalInstanceBuilder) TrusteeshipUrlToken(trusteeshipUrlToken string) *ExternalInstanceBuilder { @@ -3525,7 +3525,7 @@ func (builder *ExternalInstanceBuilder) TrusteeshipUserIdType(trusteeshipUserIdT return builder } -// 单据托管回调接入方的接口的URL地址 +// 单据托管回调接入方的接口的 URL 地址 // // 示例值： func (builder *ExternalInstanceBuilder) TrusteeshipUrls(trusteeshipUrls *TrusteeshipUrls) *ExternalInstanceBuilder { @@ -3774,18 +3774,18 @@ type ExternalInstanceTaskNode struct { UserId *string `json:"user_id,omitempty"` // 审批人 user_id ，和 open_id 二者至少填一个。该任务会出现在审批人的【待审批】或【已审批】列表中 OpenId *string `json:"open_id,omitempty"` // 审批人 open_id，和 user_id 二者至少填一个 Title *string `json:"title,omitempty"` // 审批任务名称 - Links *ExternalInstanceLink `json:"links,omitempty"` // 【待审批】或【已审批】中使用的跳转链接，用于跳转回三方系统pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 + Links *ExternalInstanceLink `json:"links,omitempty"` //【待审批】或【已审批】中使用的跳转链接，用于跳转回三方系统 pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 Status *string `json:"status,omitempty"` // 任务状态 - Extra *string `json:"extra,omitempty"` // 扩展 json，任务结束原因需传complete_reason字段。枚举值与对应说明：; - approved：同意; - rejected：拒绝; - node_auto_reject：（因逻辑判断产生的）自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，和我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward_resign：转交（转给其他人审批）; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他（作为兜底） + Extra *string `json:"extra,omitempty"` // 扩展 json，任务结束原因需传 complete_reason 字段。枚举值与对应说明：; - approved：同意; - rejected：拒绝; - node_auto_reject：（因逻辑判断产生的）自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，和我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward_resign：转交（转给其他人审批）; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他（作为兜底） CreateTime *string `json:"create_time,omitempty"` // 任务创建时间，Unix 毫秒时间戳 EndTime *string `json:"end_time,omitempty"` // 任务完成时间：未结束的审批为 0，Unix 毫秒时间戳 - UpdateTime *string `json:"update_time,omitempty"` // task最近更新时间，用于推送数据版本控制； 更新策略同 instance 中的 update_time + UpdateTime *string `json:"update_time,omitempty"` // task 最近更新时间，用于推送数据版本控制； 更新策略同 instance 中的 update_time ActionContext *string `json:"action_context,omitempty"` // 操作上下文，当用户操作时，回调请求中带上该参数，用于传递该任务的上下文数据 - ActionConfigs []*ActionConfig `json:"action_configs,omitempty"` // 任务级别操作配置,快捷审批目前支持移动端操作 + ActionConfigs []*ActionConfig `json:"action_configs,omitempty"` // 任务级别操作配置，快捷审批目前支持移动端操作 DisplayMethod *string `json:"display_method,omitempty"` // 列表页打开审批任务的方式 ExcludeStatistics *bool `json:"exclude_statistics,omitempty"` // 三方任务支持不纳入效率统计。;false：纳入效率统计。;true：不纳入效率统计 - NodeId *string `json:"node_id,omitempty"` // 节点id：必须同时满足;- 一个流程内，每个节点id唯一。如一个流程下「直属上级」、「隔级上级」等每个节点的Node_id均不一样;- 同一个流程定义内，不同审批实例中的相同节点，Node_id要保持不变。例如张三和李四分别发起了请假申请，这2个审批实例中的「直属上级」节点的node_id应该保持一致 - NodeName *string `json:"node_name,omitempty"` // 节点名称，如「财务审批」「法务审批」，支持中英日三种语言。示例：i18n@name。需要在i18n_resources中传该名称对应的国际化文案 + NodeId *string `json:"node_id,omitempty"` // 节点 id：必须同时满足;- 一个流程内，每个节点 id 唯一。如一个流程下「直属上级」、「隔级上级」等每个节点的 Node_id 均不一样;- 同一个流程定义内，不同审批实例中的相同节点，Node_id 要保持不变。例如张三和李四分别发起了请假申请，这 2 个审批实例中的「直属上级」节点的 node_id 应该保持一致 + NodeName *string `json:"node_name,omitempty"` // 节点名称，如「财务审批」「法务审批」，支持中英日三种语言。示例：i18n@name。需要在 i18n_resources 中传该名称对应的国际化文案 } type ExternalInstanceTaskNodeBuilder struct { @@ -3797,29 +3797,29 @@ type ExternalInstanceTaskNodeBuilder struct { openIdFlag bool title string // 审批任务名称 titleFlag bool - links *ExternalInstanceLink // 【待审批】或【已审批】中使用的跳转链接，用于跳转回三方系统pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 + links *ExternalInstanceLink //【待审批】或【已审批】中使用的跳转链接，用于跳转回三方系统 pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 linksFlag bool status string // 任务状态 statusFlag bool - extra string // 扩展 json，任务结束原因需传complete_reason字段。枚举值与对应说明：; - approved：同意; - rejected：拒绝; - node_auto_reject：（因逻辑判断产生的）自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，和我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward_resign：转交（转给其他人审批）; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他（作为兜底） + extra string // 扩展 json，任务结束原因需传 complete_reason 字段。枚举值与对应说明：; - approved：同意; - rejected：拒绝; - node_auto_reject：（因逻辑判断产生的）自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，和我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward_resign：转交（转给其他人审批）; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他（作为兜底） extraFlag bool createTime string // 任务创建时间，Unix 毫秒时间戳 createTimeFlag bool endTime string // 任务完成时间：未结束的审批为 0，Unix 毫秒时间戳 endTimeFlag bool - updateTime string // task最近更新时间，用于推送数据版本控制； 更新策略同 instance 中的 update_time + updateTime string // task 最近更新时间，用于推送数据版本控制； 更新策略同 instance 中的 update_time updateTimeFlag bool actionContext string // 操作上下文，当用户操作时，回调请求中带上该参数，用于传递该任务的上下文数据 actionContextFlag bool - actionConfigs []*ActionConfig // 任务级别操作配置,快捷审批目前支持移动端操作 + actionConfigs []*ActionConfig // 任务级别操作配置，快捷审批目前支持移动端操作 actionConfigsFlag bool displayMethod string // 列表页打开审批任务的方式 displayMethodFlag bool excludeStatistics bool // 三方任务支持不纳入效率统计。;false：纳入效率统计。;true：不纳入效率统计 excludeStatisticsFlag bool - nodeId string // 节点id：必须同时满足;- 一个流程内，每个节点id唯一。如一个流程下「直属上级」、「隔级上级」等每个节点的Node_id均不一样;- 同一个流程定义内，不同审批实例中的相同节点，Node_id要保持不变。例如张三和李四分别发起了请假申请，这2个审批实例中的「直属上级」节点的node_id应该保持一致 + nodeId string // 节点 id：必须同时满足;- 一个流程内，每个节点 id 唯一。如一个流程下「直属上级」、「隔级上级」等每个节点的 Node_id 均不一样;- 同一个流程定义内，不同审批实例中的相同节点，Node_id 要保持不变。例如张三和李四分别发起了请假申请，这 2 个审批实例中的「直属上级」节点的 node_id 应该保持一致 nodeIdFlag bool - nodeName string // 节点名称，如「财务审批」「法务审批」，支持中英日三种语言。示例：i18n@name。需要在i18n_resources中传该名称对应的国际化文案 + nodeName string // 节点名称，如「财务审批」「法务审批」，支持中英日三种语言。示例：i18n@name。需要在 i18n_resources 中传该名称对应的国际化文案 nodeNameFlag bool } @@ -3864,7 +3864,7 @@ func (builder *ExternalInstanceTaskNodeBuilder) Title(title string) *ExternalIns return builder } -// 【待审批】或【已审批】中使用的跳转链接，用于跳转回三方系统pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 +//【待审批】或【已审批】中使用的跳转链接，用于跳转回三方系统 pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 // // 示例值： func (builder *ExternalInstanceTaskNodeBuilder) Links(links *ExternalInstanceLink) *ExternalInstanceTaskNodeBuilder { @@ -3882,7 +3882,7 @@ func (builder *ExternalInstanceTaskNodeBuilder) Status(status string) *ExternalI return builder } -// 扩展 json，任务结束原因需传complete_reason字段。枚举值与对应说明：; - approved：同意; - rejected：拒绝; - node_auto_reject：（因逻辑判断产生的）自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，和我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward_resign：转交（转给其他人审批）; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他（作为兜底） +// 扩展 json，任务结束原因需传 complete_reason 字段。枚举值与对应说明：; - approved：同意; - rejected：拒绝; - node_auto_reject：（因逻辑判断产生的）自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，和我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward_resign：转交（转给其他人审批）; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他（作为兜底） // // 示例值：{\"xxx\":\"xxx\",\"complete_reason\":\"approved\"} func (builder *ExternalInstanceTaskNodeBuilder) Extra(extra string) *ExternalInstanceTaskNodeBuilder { @@ -3909,7 +3909,7 @@ func (builder *ExternalInstanceTaskNodeBuilder) EndTime(endTime string) *Externa return builder } -// task最近更新时间，用于推送数据版本控制； 更新策略同 instance 中的 update_time +// task 最近更新时间，用于推送数据版本控制； 更新策略同 instance 中的 update_time // // 示例值：1556468012678 func (builder *ExternalInstanceTaskNodeBuilder) UpdateTime(updateTime string) *ExternalInstanceTaskNodeBuilder { @@ -3927,7 +3927,7 @@ func (builder *ExternalInstanceTaskNodeBuilder) ActionContext(actionContext stri return builder } -// 任务级别操作配置,快捷审批目前支持移动端操作 +// 任务级别操作配置，快捷审批目前支持移动端操作 // // 示例值： func (builder *ExternalInstanceTaskNodeBuilder) ActionConfigs(actionConfigs []*ActionConfig) *ExternalInstanceTaskNodeBuilder { @@ -3954,7 +3954,7 @@ func (builder *ExternalInstanceTaskNodeBuilder) ExcludeStatistics(excludeStatist return builder } -// 节点id：必须同时满足;- 一个流程内，每个节点id唯一。如一个流程下「直属上级」、「隔级上级」等每个节点的Node_id均不一样;- 同一个流程定义内，不同审批实例中的相同节点，Node_id要保持不变。例如张三和李四分别发起了请假申请，这2个审批实例中的「直属上级」节点的node_id应该保持一致 +// 节点 id：必须同时满足;- 一个流程内，每个节点 id 唯一。如一个流程下「直属上级」、「隔级上级」等每个节点的 Node_id 均不一样;- 同一个流程定义内，不同审批实例中的相同节点，Node_id 要保持不变。例如张三和李四分别发起了请假申请，这 2 个审批实例中的「直属上级」节点的 node_id 应该保持一致 // // 示例值：node func (builder *ExternalInstanceTaskNodeBuilder) NodeId(nodeId string) *ExternalInstanceTaskNodeBuilder { @@ -3963,7 +3963,7 @@ func (builder *ExternalInstanceTaskNodeBuilder) NodeId(nodeId string) *ExternalI return builder } -// 节点名称，如「财务审批」「法务审批」，支持中英日三种语言。示例：i18n@name。需要在i18n_resources中传该名称对应的国际化文案 +// 节点名称，如「财务审批」「法务审批」，支持中英日三种语言。示例：i18n@name。需要在 i18n_resources 中传该名称对应的国际化文案 // // 示例值：i18n@name func (builder *ExternalInstanceTaskNodeBuilder) NodeName(nodeName string) *ExternalInstanceTaskNodeBuilder { @@ -4105,7 +4105,7 @@ func (builder *ExternalTaskItemBuilder) Build() *ExternalTaskItem { type ExternalTaskList struct { InstanceId *string `json:"instance_id,omitempty"` // 审批实例 ID - ApprovalId *string `json:"approval_id,omitempty"` // 审批的id + ApprovalId *string `json:"approval_id,omitempty"` // 审批的 id ApprovalCode *string `json:"approval_code,omitempty"` // 审批对应的 approval_code Status *string `json:"status,omitempty"` // 审批实例当前的状态 UpdateTime *string `json:"update_time,omitempty"` // 审批实例最后更新时间，单位 毫秒 @@ -4115,7 +4115,7 @@ type ExternalTaskList struct { type ExternalTaskListBuilder struct { instanceId string // 审批实例 ID instanceIdFlag bool - approvalId string // 审批的id + approvalId string // 审批的 id approvalIdFlag bool approvalCode string // 审批对应的 approval_code approvalCodeFlag bool @@ -4141,7 +4141,7 @@ func (builder *ExternalTaskListBuilder) InstanceId(instanceId string) *ExternalT return builder } -// 审批的id +// 审批的 id // // 示例值：fwwweffff33111133xxx func (builder *ExternalTaskListBuilder) ApprovalId(approvalId string) *ExternalTaskListBuilder { @@ -4215,14 +4215,14 @@ func (builder *ExternalTaskListBuilder) Build() *ExternalTaskList { } type FieldGroup struct { - Writable []string `json:"writable,omitempty"` // 可写权限的表单项的 id列表 - Readable []string `json:"readable,omitempty"` // 可读权限的表单项的 id列表 + Writable []string `json:"writable,omitempty"` // 可写权限的表单项的 id 列表 + Readable []string `json:"readable,omitempty"` // 可读权限的表单项的 id 列表 } type FieldGroupBuilder struct { - writable []string // 可写权限的表单项的 id列表 + writable []string // 可写权限的表单项的 id 列表 writableFlag bool - readable []string // 可读权限的表单项的 id列表 + readable []string // 可读权限的表单项的 id 列表 readableFlag bool } @@ -4231,7 +4231,7 @@ func NewFieldGroupBuilder() *FieldGroupBuilder { return builder } -// 可写权限的表单项的 id列表 +// 可写权限的表单项的 id 列表 // // 示例值：9293493 func (builder *FieldGroupBuilder) Writable(writable []string) *FieldGroupBuilder { @@ -4240,7 +4240,7 @@ func (builder *FieldGroupBuilder) Writable(writable []string) *FieldGroupBuilder return builder } -// 可读权限的表单项的 id列表 +// 可读权限的表单项的 id 列表 // // 示例值：9293493 func (builder *FieldGroupBuilder) Readable(readable []string) *FieldGroupBuilder { @@ -4341,14 +4341,14 @@ func (builder *FileBuilder) Build() *File { } type FileUrl struct { - Name *string `json:"name,omitempty"` // 不给出即使用从url从获得的，如果给出则使用用户给出的 - Url *string `json:"url,omitempty"` // 用户上传的url + Name *string `json:"name,omitempty"` // 不给出即使用从 url 从获得的，如果给出则使用用户给出的 + Url *string `json:"url,omitempty"` // 用户上传的 url } type FileUrlBuilder struct { - name string // 不给出即使用从url从获得的，如果给出则使用用户给出的 + name string // 不给出即使用从 url 从获得的，如果给出则使用用户给出的 nameFlag bool - url string // 用户上传的url + url string // 用户上传的 url urlFlag bool } @@ -4357,7 +4357,7 @@ func NewFileUrlBuilder() *FileUrlBuilder { return builder } -// 不给出即使用从url从获得的，如果给出则使用用户给出的 +// 不给出即使用从 url 从获得的，如果给出则使用用户给出的 // // 示例值：xxxxx.png func (builder *FileUrlBuilder) Name(name string) *FileUrlBuilder { @@ -4366,7 +4366,7 @@ func (builder *FileUrlBuilder) Name(name string) *FileUrlBuilder { return builder } -// 用户上传的url +// 用户上传的 url // // 示例值：https://xxxxx.com/i/2022/06/08/xxxxx.png func (builder *FileUrlBuilder) Url(url string) *FileUrlBuilder { @@ -4391,7 +4391,7 @@ func (builder *FileUrlBuilder) Build() *FileUrl { type I18nResource struct { Locale *string `json:"locale,omitempty"` // 语言可选值有： zh-CN：中文 en-US：英文 ja-JP：日文 Texts []*I18nResourceText `json:"texts,omitempty"` // 文案 key, value, i18n key 以 @i18n@ 开头； 该字段主要用于做国际化，允许用户同时传多个语言的文案，审批中心会根据用户当前的语音环境使用对应的文案，如果没有传用户当前的语音环境文案，则会使用默认的语言文案。 - IsDefault *bool `json:"is_default,omitempty"` // 是否默认语言，默认语言需要包含所有key，非默认语言如果key不存在会使用默认语言代替 + IsDefault *bool `json:"is_default,omitempty"` // 是否默认语言，默认语言需要包含所有 key，非默认语言如果 key 不存在会使用默认语言代替 } type I18nResourceBuilder struct { @@ -4399,7 +4399,7 @@ type I18nResourceBuilder struct { localeFlag bool texts []*I18nResourceText // 文案 key, value, i18n key 以 @i18n@ 开头； 该字段主要用于做国际化，允许用户同时传多个语言的文案，审批中心会根据用户当前的语音环境使用对应的文案，如果没有传用户当前的语音环境文案，则会使用默认的语言文案。 textsFlag bool - isDefault bool // 是否默认语言，默认语言需要包含所有key，非默认语言如果key不存在会使用默认语言代替 + isDefault bool // 是否默认语言，默认语言需要包含所有 key，非默认语言如果 key 不存在会使用默认语言代替 isDefaultFlag bool } @@ -4419,14 +4419,14 @@ func (builder *I18nResourceBuilder) Locale(locale string) *I18nResourceBuilder { // 文案 key, value, i18n key 以 @i18n@ 开头； 该字段主要用于做国际化，允许用户同时传多个语言的文案，审批中心会根据用户当前的语音环境使用对应的文案，如果没有传用户当前的语音环境文案，则会使用默认的语言文案。 // -// 示例值：{ "@i18n@1": "权限申请", "@i18n@2": "OA审批", "@i18n@3": "Permission" } +// 示例值：{ "@i18n@1": "权限申请", "@i18n@2": "OA 审批", "@i18n@3": "Permission" } func (builder *I18nResourceBuilder) Texts(texts []*I18nResourceText) *I18nResourceBuilder { builder.texts = texts builder.textsFlag = true return builder } -// 是否默认语言，默认语言需要包含所有key，非默认语言如果key不存在会使用默认语言代替 +// 是否默认语言，默认语言需要包含所有 key，非默认语言如果 key 不存在会使用默认语言代替 // // 示例值：true func (builder *I18nResourceBuilder) IsDefault(isDefault bool) *I18nResourceBuilder { @@ -4452,12 +4452,12 @@ func (builder *I18nResourceBuilder) Build() *I18nResource { } type I18nResourceText struct { - Key *string `json:"key,omitempty"` // 文案key + Key *string `json:"key,omitempty"` // 文案 key Value *string `json:"value,omitempty"` // 文案 } type I18nResourceTextBuilder struct { - key string // 文案key + key string // 文案 key keyFlag bool value string // 文案 valueFlag bool @@ -4468,7 +4468,7 @@ func NewI18nResourceTextBuilder() *I18nResourceTextBuilder { return builder } -// 文案key +// 文案 key // // 示例值：@i18n@1 func (builder *I18nResourceTextBuilder) Key(key string) *I18nResourceTextBuilder { @@ -4500,7 +4500,7 @@ func (builder *I18nResourceTextBuilder) Build() *I18nResourceText { } type Instance struct { - InstanceCode *string `json:"instance_code,omitempty"` // 审批实例code + InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code ApprovalName *string `json:"approval_name,omitempty"` // 审批名称 StartTime *string `json:"start_time,omitempty"` // 审批实例发起时间戳 EndTime *string `json:"end_time,omitempty"` // 审批实例结束时间戳 @@ -4509,7 +4509,7 @@ type Instance struct { } type InstanceBuilder struct { - instanceCode string // 审批实例code + instanceCode string // 审批实例 code instanceCodeFlag bool approvalName string // 审批名称 approvalNameFlag bool @@ -4528,7 +4528,7 @@ func NewInstanceBuilder() *InstanceBuilder { return builder } -// 审批实例code +// 审批实例 code // // 示例值： func (builder *InstanceBuilder) InstanceCode(instanceCode string) *InstanceBuilder { @@ -4612,17 +4612,17 @@ func (builder *InstanceBuilder) Build() *Instance { } type InstanceCancel struct { - ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义Code - InstanceCode *string `json:"instance_code,omitempty"` // 审批实例Code - UserId *string `json:"user_id,omitempty"` // 操作用户, 根据user_id_type填写 + ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 Code + InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 Code + UserId *string `json:"user_id,omitempty"` // 操作用户，根据 user_id_type 填写 } type InstanceCancelBuilder struct { - approvalCode string // 审批定义Code + approvalCode string // 审批定义 Code approvalCodeFlag bool - instanceCode string // 审批实例Code + instanceCode string // 审批实例 Code instanceCodeFlag bool - userId string // 操作用户, 根据user_id_type填写 + userId string // 操作用户，根据 user_id_type 填写 userIdFlag bool } @@ -4631,7 +4631,7 @@ func NewInstanceCancelBuilder() *InstanceCancelBuilder { return builder } -// 审批定义Code +// 审批定义 Code // // 示例值：7C468A54-8745-2245-9675-08B7C63E7A85 func (builder *InstanceCancelBuilder) ApprovalCode(approvalCode string) *InstanceCancelBuilder { @@ -4640,7 +4640,7 @@ func (builder *InstanceCancelBuilder) ApprovalCode(approvalCode string) *Instanc return builder } -// 审批实例Code +// 审批实例 Code // // 示例值：81D31358-93AF-92D6-7425-01A5D67C4E71 func (builder *InstanceCancelBuilder) InstanceCode(instanceCode string) *InstanceCancelBuilder { @@ -4649,7 +4649,7 @@ func (builder *InstanceCancelBuilder) InstanceCode(instanceCode string) *Instanc return builder } -// 操作用户, 根据user_id_type填写 +// 操作用户，根据 user_id_type 填写 // // 示例值：f7cb567e func (builder *InstanceCancelBuilder) UserId(userId string) *InstanceCancelBuilder { @@ -4678,8 +4678,8 @@ func (builder *InstanceCancelBuilder) Build() *InstanceCancel { type InstanceCc struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code - UserId *string `json:"user_id,omitempty"` // 根据user_id_type填写发起抄送的人的用户id - CcUserIds []string `json:"cc_user_ids,omitempty"` // 根据user_id_type填写被抄送人的 用户id 列表 + UserId *string `json:"user_id,omitempty"` // 根据 user_id_type 填写发起抄送的人的用户 id + CcUserIds []string `json:"cc_user_ids,omitempty"` // 根据 user_id_type 填写被抄送人的 用户 id 列表 Comment *string `json:"comment,omitempty"` // 抄送留言 } @@ -4688,9 +4688,9 @@ type InstanceCcBuilder struct { approvalCodeFlag bool instanceCode string // 审批实例 code instanceCodeFlag bool - userId string // 根据user_id_type填写发起抄送的人的用户id + userId string // 根据 user_id_type 填写发起抄送的人的用户 id userIdFlag bool - ccUserIds []string // 根据user_id_type填写被抄送人的 用户id 列表 + ccUserIds []string // 根据 user_id_type 填写被抄送人的 用户 id 列表 ccUserIdsFlag bool comment string // 抄送留言 commentFlag bool @@ -4719,7 +4719,7 @@ func (builder *InstanceCcBuilder) InstanceCode(instanceCode string) *InstanceCcB return builder } -// 根据user_id_type填写发起抄送的人的用户id +// 根据 user_id_type 填写发起抄送的人的用户 id // // 示例值：f7cb567e func (builder *InstanceCcBuilder) UserId(userId string) *InstanceCcBuilder { @@ -4728,7 +4728,7 @@ func (builder *InstanceCcBuilder) UserId(userId string) *InstanceCcBuilder { return builder } -// 根据user_id_type填写被抄送人的 用户id 列表 +// 根据 user_id_type 填写被抄送人的 用户 id 列表 // // 示例值：f7cb567e func (builder *InstanceCcBuilder) CcUserIds(ccUserIds []string) *InstanceCcBuilder { @@ -4948,17 +4948,17 @@ func (builder *InstanceCommentBuilder) Build() *InstanceComment { type InstanceCreate struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code UserId *string `json:"user_id,omitempty"` // 发起审批用户 - OpenId *string `json:"open_id,omitempty"` // 发起审批用户 open id, 如果传了 user_id 则优先使用 user_id - DepartmentId *string `json:"department_id,omitempty"` // 发起审批用户部门id，如果用户只属于一个部门，可以不填。如果属于多个部门，默认会选择部门列表第一个部门 + OpenId *string `json:"open_id,omitempty"` // 发起审批用户 open id，如果传了 user_id 则优先使用 user_id + DepartmentId *string `json:"department_id,omitempty"` // 发起审批用户部门 id，如果用户只属于一个部门，可以不填。如果属于多个部门，默认会选择部门列表第一个部门 Form *string `json:"form,omitempty"` // json 数组，控件值 NodeApproverUserIdList []*NodeApprover `json:"node_approver_user_id_list,omitempty"` // 如果有发起人自选节点，则需要填写对应节点的审批人 - NodeApproverOpenIdList []*NodeApprover `json:"node_approver_open_id_list,omitempty"` // 审批人发起人自选 open id，与上述node_approver_user_id_list字段取并集 - NodeCcUserIdList []*NodeCc `json:"node_cc_user_id_list,omitempty"` // 如果有发起人自选节点，则可填写对应节点的抄送人，单个节点最多选择20位抄送人 - NodeCcOpenIdList []*NodeCc `json:"node_cc_open_id_list,omitempty"` // 抄送人发起人自选 open id 单个节点最多选择20位抄送人 - Uuid *string `json:"uuid,omitempty"` // 审批实例 uuid，用于幂等操作, 每个租户下面的唯一key，同一个 uuid 只能用于创建一个审批实例，如果冲突，返回错误码 60012 ，格式建议为 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX，不区分大小写 + NodeApproverOpenIdList []*NodeApprover `json:"node_approver_open_id_list,omitempty"` // 审批人发起人自选 open id，与上述 node_approver_user_id_list 字段取并集 + NodeCcUserIdList []*NodeCc `json:"node_cc_user_id_list,omitempty"` // 如果有发起人自选节点，则可填写对应节点的抄送人，单个节点最多选择 20 位抄送人 + NodeCcOpenIdList []*NodeCc `json:"node_cc_open_id_list,omitempty"` // 抄送人发起人自选 open id 单个节点最多选择 20 位抄送人 + Uuid *string `json:"uuid,omitempty"` // 审批实例 uuid，用于幂等操作，每个租户下面的唯一 key，同一个 uuid 只能用于创建一个审批实例，如果冲突，返回错误码 60012 ，格式建议为 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX，不区分大小写 AllowResubmit *bool `json:"allow_resubmit,omitempty"` // 可配置是否可以再次提交 AllowSubmitAgain *bool `json:"allow_submit_again,omitempty"` // 可配置是否可以重新提交 - CancelBotNotification *string `json:"cancel_bot_notification,omitempty"` // 配置bot是否取消通知结果 + CancelBotNotification *string `json:"cancel_bot_notification,omitempty"` // 配置 bot 是否取消通知结果 ForbidRevoke *bool `json:"forbid_revoke,omitempty"` // 配置是否可以禁止撤销 I18nResources []*I18nResource `json:"i18n_resources,omitempty"` // 国际化文案 } @@ -4968,27 +4968,27 @@ type InstanceCreateBuilder struct { approvalCodeFlag bool userId string // 发起审批用户 userIdFlag bool - openId string // 发起审批用户 open id, 如果传了 user_id 则优先使用 user_id + openId string // 发起审批用户 open id，如果传了 user_id 则优先使用 user_id openIdFlag bool - departmentId string // 发起审批用户部门id，如果用户只属于一个部门，可以不填。如果属于多个部门，默认会选择部门列表第一个部门 + departmentId string // 发起审批用户部门 id，如果用户只属于一个部门，可以不填。如果属于多个部门，默认会选择部门列表第一个部门 departmentIdFlag bool form string // json 数组，控件值 formFlag bool nodeApproverUserIdList []*NodeApprover // 如果有发起人自选节点，则需要填写对应节点的审批人 nodeApproverUserIdListFlag bool - nodeApproverOpenIdList []*NodeApprover // 审批人发起人自选 open id，与上述node_approver_user_id_list字段取并集 + nodeApproverOpenIdList []*NodeApprover // 审批人发起人自选 open id，与上述 node_approver_user_id_list 字段取并集 nodeApproverOpenIdListFlag bool - nodeCcUserIdList []*NodeCc // 如果有发起人自选节点，则可填写对应节点的抄送人，单个节点最多选择20位抄送人 + nodeCcUserIdList []*NodeCc // 如果有发起人自选节点，则可填写对应节点的抄送人，单个节点最多选择 20 位抄送人 nodeCcUserIdListFlag bool - nodeCcOpenIdList []*NodeCc // 抄送人发起人自选 open id 单个节点最多选择20位抄送人 + nodeCcOpenIdList []*NodeCc // 抄送人发起人自选 open id 单个节点最多选择 20 位抄送人 nodeCcOpenIdListFlag bool - uuid string // 审批实例 uuid，用于幂等操作, 每个租户下面的唯一key，同一个 uuid 只能用于创建一个审批实例，如果冲突，返回错误码 60012 ，格式建议为 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX，不区分大小写 + uuid string // 审批实例 uuid，用于幂等操作，每个租户下面的唯一 key，同一个 uuid 只能用于创建一个审批实例，如果冲突，返回错误码 60012 ，格式建议为 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX，不区分大小写 uuidFlag bool allowResubmit bool // 可配置是否可以再次提交 allowResubmitFlag bool allowSubmitAgain bool // 可配置是否可以重新提交 allowSubmitAgainFlag bool - cancelBotNotification string // 配置bot是否取消通知结果 + cancelBotNotification string // 配置 bot 是否取消通知结果 cancelBotNotificationFlag bool forbidRevoke bool // 配置是否可以禁止撤销 forbidRevokeFlag bool @@ -5019,7 +5019,7 @@ func (builder *InstanceCreateBuilder) UserId(userId string) *InstanceCreateBuild return builder } -// 发起审批用户 open id, 如果传了 user_id 则优先使用 user_id +// 发起审批用户 open id，如果传了 user_id 则优先使用 user_id // // 示例值：ou_3cda9c969f737aaa05e6915dce306cb9 func (builder *InstanceCreateBuilder) OpenId(openId string) *InstanceCreateBuilder { @@ -5028,7 +5028,7 @@ func (builder *InstanceCreateBuilder) OpenId(openId string) *InstanceCreateBuild return builder } -// 发起审批用户部门id，如果用户只属于一个部门，可以不填。如果属于多个部门，默认会选择部门列表第一个部门 +// 发起审批用户部门 id，如果用户只属于一个部门，可以不填。如果属于多个部门，默认会选择部门列表第一个部门 // // 示例值：9293493ccacbdb9a func (builder *InstanceCreateBuilder) DepartmentId(departmentId string) *InstanceCreateBuilder { @@ -5055,7 +5055,7 @@ func (builder *InstanceCreateBuilder) NodeApproverUserIdList(nodeApproverUserIdL return builder } -// 审批人发起人自选 open id，与上述node_approver_user_id_list字段取并集 +// 审批人发起人自选 open id，与上述 node_approver_user_id_list 字段取并集 // // 示例值： func (builder *InstanceCreateBuilder) NodeApproverOpenIdList(nodeApproverOpenIdList []*NodeApprover) *InstanceCreateBuilder { @@ -5064,7 +5064,7 @@ func (builder *InstanceCreateBuilder) NodeApproverOpenIdList(nodeApproverOpenIdL return builder } -// 如果有发起人自选节点，则可填写对应节点的抄送人，单个节点最多选择20位抄送人 +// 如果有发起人自选节点，则可填写对应节点的抄送人，单个节点最多选择 20 位抄送人 // // 示例值： func (builder *InstanceCreateBuilder) NodeCcUserIdList(nodeCcUserIdList []*NodeCc) *InstanceCreateBuilder { @@ -5073,7 +5073,7 @@ func (builder *InstanceCreateBuilder) NodeCcUserIdList(nodeCcUserIdList []*NodeC return builder } -// 抄送人发起人自选 open id 单个节点最多选择20位抄送人 +// 抄送人发起人自选 open id 单个节点最多选择 20 位抄送人 // // 示例值： func (builder *InstanceCreateBuilder) NodeCcOpenIdList(nodeCcOpenIdList []*NodeCc) *InstanceCreateBuilder { @@ -5082,7 +5082,7 @@ func (builder *InstanceCreateBuilder) NodeCcOpenIdList(nodeCcOpenIdList []*NodeC return builder } -// 审批实例 uuid，用于幂等操作, 每个租户下面的唯一key，同一个 uuid 只能用于创建一个审批实例，如果冲突，返回错误码 60012 ，格式建议为 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX，不区分大小写 +// 审批实例 uuid，用于幂等操作，每个租户下面的唯一 key，同一个 uuid 只能用于创建一个审批实例，如果冲突，返回错误码 60012 ，格式建议为 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX，不区分大小写 // // 示例值：7C468A54-8745-2245-9675-08B7C63E7A87 func (builder *InstanceCreateBuilder) Uuid(uuid string) *InstanceCreateBuilder { @@ -5109,7 +5109,7 @@ func (builder *InstanceCreateBuilder) AllowSubmitAgain(allowSubmitAgain bool) *I return builder } -// 配置bot是否取消通知结果 +// 配置 bot 是否取消通知结果 // // 示例值：0 func (builder *InstanceCreateBuilder) CancelBotNotification(cancelBotNotification string) *InstanceCreateBuilder { @@ -5197,20 +5197,20 @@ func (builder *InstanceCreateBuilder) Build() *InstanceCreate { } type InstanceSearch struct { - UserId *string `json:"user_id,omitempty"` // 根据x_user_type填写用户 id + UserId *string `json:"user_id,omitempty"` // 根据 x_user_type 填写用户 id ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code InstanceExternalId *string `json:"instance_external_id,omitempty"` // 审批实例第三方 id 注：和 approval_code 取并集 GroupExternalId *string `json:"group_external_id,omitempty"` // 审批定义分组第三方 id 注：和 instance_code 取并集 InstanceTitle *string `json:"instance_title,omitempty"` // 审批实例标题（只有第三方审批有） InstanceStatus *string `json:"instance_status,omitempty"` // 审批实例状态，注：若不设置，查询全部状态 若不在集合中，报错 - InstanceStartTimeFrom *string `json:"instance_start_time_from,omitempty"` // 实例查询开始时间（unix毫秒时间戳） - InstanceStartTimeTo *string `json:"instance_start_time_to,omitempty"` // 实例查询结束时间 (unix毫秒时间戳) + InstanceStartTimeFrom *string `json:"instance_start_time_from,omitempty"` // 实例查询开始时间（unix 毫秒时间戳） + InstanceStartTimeTo *string `json:"instance_start_time_to,omitempty"` // 实例查询结束时间 (unix 毫秒时间戳) Locale *string `json:"locale,omitempty"` // 地区 } type InstanceSearchBuilder struct { - userId string // 根据x_user_type填写用户 id + userId string // 根据 x_user_type 填写用户 id userIdFlag bool approvalCode string // 审批定义 code approvalCodeFlag bool @@ -5224,9 +5224,9 @@ type InstanceSearchBuilder struct { instanceTitleFlag bool instanceStatus string // 审批实例状态，注：若不设置，查询全部状态 若不在集合中，报错 instanceStatusFlag bool - instanceStartTimeFrom string // 实例查询开始时间（unix毫秒时间戳） + instanceStartTimeFrom string // 实例查询开始时间（unix 毫秒时间戳） instanceStartTimeFromFlag bool - instanceStartTimeTo string // 实例查询结束时间 (unix毫秒时间戳) + instanceStartTimeTo string // 实例查询结束时间 (unix 毫秒时间戳) instanceStartTimeToFlag bool locale string // 地区 localeFlag bool @@ -5237,7 +5237,7 @@ func NewInstanceSearchBuilder() *InstanceSearchBuilder { return builder } -// 根据x_user_type填写用户 id +// 根据 x_user_type 填写用户 id // // 示例值：lwiu098wj func (builder *InstanceSearchBuilder) UserId(userId string) *InstanceSearchBuilder { @@ -5300,7 +5300,7 @@ func (builder *InstanceSearchBuilder) InstanceStatus(instanceStatus string) *Ins return builder } -// 实例查询开始时间（unix毫秒时间戳） +// 实例查询开始时间（unix 毫秒时间戳） // // 示例值：1547654251506 func (builder *InstanceSearchBuilder) InstanceStartTimeFrom(instanceStartTimeFrom string) *InstanceSearchBuilder { @@ -5309,7 +5309,7 @@ func (builder *InstanceSearchBuilder) InstanceStartTimeFrom(instanceStartTimeFro return builder } -// 实例查询结束时间 (unix毫秒时间戳) +// 实例查询结束时间 (unix 毫秒时间戳) // // 示例值：1547654251506 func (builder *InstanceSearchBuilder) InstanceStartTimeTo(instanceStartTimeTo string) *InstanceSearchBuilder { @@ -5377,7 +5377,7 @@ type InstanceSearchApproval struct { Name *string `json:"name,omitempty"` // 审批定义名称 IsExternal *bool `json:"is_external,omitempty"` // 是否为第三方审批 External *InstanceSearchApprovalExternal `json:"external,omitempty"` // 第三方审批信息 - ApprovalId *string `json:"approval_id,omitempty"` // 审批定义Id + ApprovalId *string `json:"approval_id,omitempty"` // 审批定义 Id Icon *string `json:"icon,omitempty"` // 审批定义图标信息 } @@ -5390,7 +5390,7 @@ type InstanceSearchApprovalBuilder struct { isExternalFlag bool external *InstanceSearchApprovalExternal // 第三方审批信息 externalFlag bool - approvalId string // 审批定义Id + approvalId string // 审批定义 Id approvalIdFlag bool icon string // 审批定义图标信息 iconFlag bool @@ -5437,7 +5437,7 @@ func (builder *InstanceSearchApprovalBuilder) External(external *InstanceSearchA return builder } -// 审批定义Id +// 审批定义 Id // // 示例值：7090754740375519252 func (builder *InstanceSearchApprovalBuilder) ApprovalId(approvalId string) *InstanceSearchApprovalBuilder { @@ -5680,7 +5680,7 @@ type InstanceSearchNode struct { EndTime *string `json:"end_time,omitempty"` // 审批实例结束时间 Status *string `json:"status,omitempty"` // 审批实例状态 Title *string `json:"title,omitempty"` // 审批实例名称（只有第三方审批有） - Extra *string `json:"extra,omitempty"` // 审批实例扩展字段，string型json + Extra *string `json:"extra,omitempty"` // 审批实例扩展字段，string 型 json SerialId *string `json:"serial_id,omitempty"` // 审批流水号 Link *InstanceSearchLink `json:"link,omitempty"` // 审批实例链接（只有第三方审批有） } @@ -5700,7 +5700,7 @@ type InstanceSearchNodeBuilder struct { statusFlag bool title string // 审批实例名称（只有第三方审批有） titleFlag bool - extra string // 审批实例扩展字段，string型json + extra string // 审批实例扩展字段，string 型 json extraFlag bool serialId string // 审批流水号 serialIdFlag bool @@ -5776,7 +5776,7 @@ func (builder *InstanceSearchNodeBuilder) Title(title string) *InstanceSearchNod return builder } -// 审批实例扩展字段，string型json +// 审批实例扩展字段，string 型 json // // 示例值：{} func (builder *InstanceSearchNodeBuilder) Extra(extra string) *InstanceSearchNodeBuilder { @@ -5849,21 +5849,21 @@ func (builder *InstanceSearchNodeBuilder) Build() *InstanceSearchNode { type InstanceTask struct { Id *string `json:"id,omitempty"` // task id - UserId *string `json:"user_id,omitempty"` // 审批人的用户id，自动通过、自动拒绝 时为空 + UserId *string `json:"user_id,omitempty"` // 审批人的用户 id，自动通过、自动拒绝 时为空 OpenId *string `json:"open_id,omitempty"` // 审批人 open id Status *string `json:"status,omitempty"` // 任务状态 NodeId *string `json:"node_id,omitempty"` // task 所属节点 id NodeName *string `json:"node_name,omitempty"` // task 所属节点名称 - CustomNodeId *string `json:"custom_node_id,omitempty"` // task 所属节点自定义 id, 如果没设置自定义 id, 则不返回该字段 + CustomNodeId *string `json:"custom_node_id,omitempty"` // task 所属节点自定义 id，如果没设置自定义 id，则不返回该字段 Type *string `json:"type,omitempty"` // 审批方式 StartTime *string `json:"start_time,omitempty"` // task 开始时间 - EndTime *string `json:"end_time,omitempty"` // task 完成时间, 未完成为 0 + EndTime *string `json:"end_time,omitempty"` // task 完成时间，未完成为 0 } type InstanceTaskBuilder struct { id string // task id idFlag bool - userId string // 审批人的用户id，自动通过、自动拒绝 时为空 + userId string // 审批人的用户 id，自动通过、自动拒绝 时为空 userIdFlag bool openId string // 审批人 open id openIdFlag bool @@ -5873,13 +5873,13 @@ type InstanceTaskBuilder struct { nodeIdFlag bool nodeName string // task 所属节点名称 nodeNameFlag bool - customNodeId string // task 所属节点自定义 id, 如果没设置自定义 id, 则不返回该字段 + customNodeId string // task 所属节点自定义 id，如果没设置自定义 id，则不返回该字段 customNodeIdFlag bool type_ string // 审批方式 typeFlag bool startTime string // task 开始时间 startTimeFlag bool - endTime string // task 完成时间, 未完成为 0 + endTime string // task 完成时间，未完成为 0 endTimeFlag bool } @@ -5897,7 +5897,7 @@ func (builder *InstanceTaskBuilder) Id(id string) *InstanceTaskBuilder { return builder } -// 审批人的用户id，自动通过、自动拒绝 时为空 +// 审批人的用户 id，自动通过、自动拒绝 时为空 // // 示例值：f7cb567e func (builder *InstanceTaskBuilder) UserId(userId string) *InstanceTaskBuilder { @@ -5942,7 +5942,7 @@ func (builder *InstanceTaskBuilder) NodeName(nodeName string) *InstanceTaskBuild return builder } -// task 所属节点自定义 id, 如果没设置自定义 id, 则不返回该字段 +// task 所属节点自定义 id，如果没设置自定义 id，则不返回该字段 // // 示例值：manager func (builder *InstanceTaskBuilder) CustomNodeId(customNodeId string) *InstanceTaskBuilder { @@ -5969,7 +5969,7 @@ func (builder *InstanceTaskBuilder) StartTime(startTime string) *InstanceTaskBui return builder } -// task 完成时间, 未完成为 0 +// task 完成时间，未完成为 0 // // 示例值：0 func (builder *InstanceTaskBuilder) EndTime(endTime string) *InstanceTaskBuilder { @@ -6030,11 +6030,11 @@ type InstanceTimeline struct { OpenId *string `json:"open_id,omitempty"` // 动态产生用户 open id UserIdList []string `json:"user_id_list,omitempty"` // 被抄送人列表 OpenIdList []string `json:"open_id_list,omitempty"` // 被抄送人列表 - TaskId *string `json:"task_id,omitempty"` // 产生动态关联的task_id + TaskId *string `json:"task_id,omitempty"` // 产生动态关联的 task_id Comment *string `json:"comment,omitempty"` // 理由 CcUserList []*InstanceCcUser `json:"cc_user_list,omitempty"` // 抄送人列表 - Ext *string `json:"ext,omitempty"` // 动态其他信息，json格式，目前包括 user_id_list, user_id，open_id_list，open_id - NodeKey *string `json:"node_key,omitempty"` // 产生task的节点key + Ext *string `json:"ext,omitempty"` // 动态其他信息，json 格式，目前包括 user_id_list, user_id，open_id_list，open_id + NodeKey *string `json:"node_key,omitempty"` // 产生 task 的节点 key Files []*File `json:"files,omitempty"` // 审批附件 } @@ -6051,15 +6051,15 @@ type InstanceTimelineBuilder struct { userIdListFlag bool openIdList []string // 被抄送人列表 openIdListFlag bool - taskId string // 产生动态关联的task_id + taskId string // 产生动态关联的 task_id taskIdFlag bool comment string // 理由 commentFlag bool ccUserList []*InstanceCcUser // 抄送人列表 ccUserListFlag bool - ext string // 动态其他信息，json格式，目前包括 user_id_list, user_id，open_id_list，open_id + ext string // 动态其他信息，json 格式，目前包括 user_id_list, user_id，open_id_list，open_id extFlag bool - nodeKey string // 产生task的节点key + nodeKey string // 产生 task 的节点 key nodeKeyFlag bool files []*File // 审批附件 filesFlag bool @@ -6124,7 +6124,7 @@ func (builder *InstanceTimelineBuilder) OpenIdList(openIdList []string) *Instanc return builder } -// 产生动态关联的task_id +// 产生动态关联的 task_id // // 示例值：1234 func (builder *InstanceTimelineBuilder) TaskId(taskId string) *InstanceTimelineBuilder { @@ -6151,7 +6151,7 @@ func (builder *InstanceTimelineBuilder) CcUserList(ccUserList []*InstanceCcUser) return builder } -// 动态其他信息，json格式，目前包括 user_id_list, user_id，open_id_list，open_id +// 动态其他信息，json 格式，目前包括 user_id_list, user_id，open_id_list，open_id // // 示例值：{\"user_id\":\"62d4a44c\",\"open_id\":\"ou_123456\"} func (builder *InstanceTimelineBuilder) Ext(ext string) *InstanceTimelineBuilder { @@ -6160,7 +6160,7 @@ func (builder *InstanceTimelineBuilder) Ext(ext string) *InstanceTimelineBuilder return builder } -// 产生task的节点key +// 产生 task 的节点 key // // 示例值：APPROVAL_240330_4058663 func (builder *InstanceTimelineBuilder) NodeKey(nodeKey string) *InstanceTimelineBuilder { @@ -6229,19 +6229,19 @@ func (builder *InstanceTimelineBuilder) Build() *InstanceTimeline { type ManageableDefinition struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code 示例值："7C468A54-8745-2245-9675-08B7C63E7A85" - ApprovalName *string `json:"approval_name,omitempty"` // 审批名称，根据传入的local字段返回对应的国际化文案，未设置国际化文案时该字段为空 + ApprovalName *string `json:"approval_name,omitempty"` // 审批名称，根据传入的 local 字段返回对应的国际化文案，未设置国际化文案时该字段为空 ApprovalStatus *string `json:"approval_status,omitempty"` // 审批定义状态 - ApprovalAdminIds []string `json:"approval_admin_ids,omitempty"` // 有数据管理权限的审批流程管理员ID + ApprovalAdminIds []string `json:"approval_admin_ids,omitempty"` // 有数据管理权限的审批流程管理员 ID } type ManageableDefinitionBuilder struct { approvalCode string // 审批定义 code 示例值："7C468A54-8745-2245-9675-08B7C63E7A85" approvalCodeFlag bool - approvalName string // 审批名称，根据传入的local字段返回对应的国际化文案，未设置国际化文案时该字段为空 + approvalName string // 审批名称，根据传入的 local 字段返回对应的国际化文案，未设置国际化文案时该字段为空 approvalNameFlag bool approvalStatus string // 审批定义状态 approvalStatusFlag bool - approvalAdminIds []string // 有数据管理权限的审批流程管理员ID + approvalAdminIds []string // 有数据管理权限的审批流程管理员 ID approvalAdminIdsFlag bool } @@ -6259,7 +6259,7 @@ func (builder *ManageableDefinitionBuilder) ApprovalCode(approvalCode string) *M return builder } -// 审批名称，根据传入的local字段返回对应的国际化文案，未设置国际化文案时该字段为空 +// 审批名称，根据传入的 local 字段返回对应的国际化文案，未设置国际化文案时该字段为空 // // 示例值：请假 func (builder *ManageableDefinitionBuilder) ApprovalName(approvalName string) *ManageableDefinitionBuilder { @@ -6277,7 +6277,7 @@ func (builder *ManageableDefinitionBuilder) ApprovalStatus(approvalStatus string return builder } -// 有数据管理权限的审批流程管理员ID +// 有数据管理权限的审批流程管理员 ID // // 示例值： func (builder *ManageableDefinitionBuilder) ApprovalAdminIds(approvalAdminIds []string) *ManageableDefinitionBuilder { @@ -6339,11 +6339,11 @@ func (builder *ManageableInstanceItemBuilder) Build() *ManageableInstanceItem { type ManageableInstanceNode struct { Code *string `json:"code,omitempty"` // 审批实例 code - StartUserId *string `json:"start_user_id,omitempty"` // 审批实例发起人id - CurrentUserIds []string `json:"current_user_ids,omitempty"` // 当前处理人id - DepartmentId *string `json:"department_id,omitempty"` // 审批实例所属部门id + StartUserId *string `json:"start_user_id,omitempty"` // 审批实例发起人 id + CurrentUserIds []string `json:"current_user_ids,omitempty"` // 当前处理人 id + DepartmentId *string `json:"department_id,omitempty"` // 审批实例所属部门 id NodeName *string `json:"node_name,omitempty"` // 当前处理节点名称 - Form *string `json:"form,omitempty"` // json字符串，控件值 + Form *string `json:"form,omitempty"` // json 字符串，控件值 Version *string `json:"version,omitempty"` // 审批实例对应的审批定义版本 StartTime *string `json:"start_time,omitempty"` // 审批实例发起时间 EndTime *string `json:"end_time,omitempty"` // 审批实例结束时间 @@ -6355,15 +6355,15 @@ type ManageableInstanceNode struct { type ManageableInstanceNodeBuilder struct { code string // 审批实例 code codeFlag bool - startUserId string // 审批实例发起人id + startUserId string // 审批实例发起人 id startUserIdFlag bool - currentUserIds []string // 当前处理人id + currentUserIds []string // 当前处理人 id currentUserIdsFlag bool - departmentId string // 审批实例所属部门id + departmentId string // 审批实例所属部门 id departmentIdFlag bool nodeName string // 当前处理节点名称 nodeNameFlag bool - form string // json字符串，控件值 + form string // json 字符串，控件值 formFlag bool version string // 审批实例对应的审批定义版本 versionFlag bool @@ -6393,7 +6393,7 @@ func (builder *ManageableInstanceNodeBuilder) Code(code string) *ManageableInsta return builder } -// 审批实例发起人id +// 审批实例发起人 id // // 示例值：lwiu098wj func (builder *ManageableInstanceNodeBuilder) StartUserId(startUserId string) *ManageableInstanceNodeBuilder { @@ -6402,7 +6402,7 @@ func (builder *ManageableInstanceNodeBuilder) StartUserId(startUserId string) *M return builder } -// 当前处理人id +// 当前处理人 id // // 示例值：lwiu098wj func (builder *ManageableInstanceNodeBuilder) CurrentUserIds(currentUserIds []string) *ManageableInstanceNodeBuilder { @@ -6411,7 +6411,7 @@ func (builder *ManageableInstanceNodeBuilder) CurrentUserIds(currentUserIds []st return builder } -// 审批实例所属部门id +// 审批实例所属部门 id // // 示例值：od-8ec33ffec336c3a39a278bc25e931676 func (builder *ManageableInstanceNodeBuilder) DepartmentId(departmentId string) *ManageableInstanceNodeBuilder { @@ -6422,14 +6422,14 @@ func (builder *ManageableInstanceNodeBuilder) DepartmentId(departmentId string) // 当前处理节点名称 // -// 示例值：审批节点1 +// 示例值：审批节点 1 func (builder *ManageableInstanceNodeBuilder) NodeName(nodeName string) *ManageableInstanceNodeBuilder { builder.nodeName = nodeName builder.nodeNameFlag = true return builder } -// json字符串，控件值 +// json 字符串，控件值 // // 示例值：[{\"id\": \"widget1\",\"custom_id\": \"user_info\",\"name\": \"Item application\",\"type\": \"textarea\"},\"value\":\"aaaa\"] func (builder *ManageableInstanceNodeBuilder) Form(form string) *ManageableInstanceNodeBuilder { @@ -6545,21 +6545,21 @@ func (builder *ManageableInstanceNodeBuilder) Build() *ManageableInstanceNode { } type Message struct { - Id *string `json:"id,omitempty"` // 消息id标识 - ReceiveId *string `json:"receive_id,omitempty"` // 接受消息的各类id - Content *string `json:"content,omitempty"` // 消息体, json格式 + Id *string `json:"id,omitempty"` // 消息 id 标识 + ReceiveId *string `json:"receive_id,omitempty"` // 接受消息的各类 id + Content *string `json:"content,omitempty"` // 消息体，json 格式 MsgType *string `json:"msg_type,omitempty"` // 消息类型 Config *string `json:"config,omitempty"` // 发送配置 Extra *string `json:"extra,omitempty"` // 特殊配制 - Uuid *string `json:"uuid,omitempty"` // 幂等key + Uuid *string `json:"uuid,omitempty"` // 幂等 key } type MessageBuilder struct { - id string // 消息id标识 + id string // 消息 id 标识 idFlag bool - receiveId string // 接受消息的各类id + receiveId string // 接受消息的各类 id receiveIdFlag bool - content string // 消息体, json格式 + content string // 消息体，json 格式 contentFlag bool msgType string // 消息类型 msgTypeFlag bool @@ -6567,7 +6567,7 @@ type MessageBuilder struct { configFlag bool extra string // 特殊配制 extraFlag bool - uuid string // 幂等key + uuid string // 幂等 key uuidFlag bool } @@ -6576,7 +6576,7 @@ func NewMessageBuilder() *MessageBuilder { return builder } -// 消息id标识 +// 消息 id 标识 // // 示例值：1705036822442409986 func (builder *MessageBuilder) Id(id string) *MessageBuilder { @@ -6585,7 +6585,7 @@ func (builder *MessageBuilder) Id(id string) *MessageBuilder { return builder } -// 接受消息的各类id +// 接受消息的各类 id // // 示例值：ou_xxx func (builder *MessageBuilder) ReceiveId(receiveId string) *MessageBuilder { @@ -6594,7 +6594,7 @@ func (builder *MessageBuilder) ReceiveId(receiveId string) *MessageBuilder { return builder } -// 消息体, json格式 +// 消息体，json 格式 // // 示例值：{} func (builder *MessageBuilder) Content(content string) *MessageBuilder { @@ -6630,7 +6630,7 @@ func (builder *MessageBuilder) Extra(extra string) *MessageBuilder { return builder } -// 幂等key +// 幂等 key // // 示例值：a60cfe61268e10f054a3211ab72185c func (builder *MessageBuilder) Uuid(uuid string) *MessageBuilder { @@ -6767,20 +6767,20 @@ func (builder *NodeCcBuilder) Build() *NodeCc { } type PreviewNode struct { - NodeId *string `json:"node_id,omitempty"` // 节点id + NodeId *string `json:"node_id,omitempty"` // 节点 id NodeName *string `json:"node_name,omitempty"` // 节点名称 NodeType *string `json:"node_type,omitempty"` // 节点类型 “AND":会签 “OR”:或签 Comments []string `json:"comments,omitempty"` // 节点描述 - CustomNodeId *string `json:"custom_node_id,omitempty"` // 租户节点id - UserIdList []string `json:"user_id_list,omitempty"` // 审批人id列表 - EndCcIdList []string `json:"end_cc_id_list,omitempty"` // 节点结束抄送人id列表 + CustomNodeId *string `json:"custom_node_id,omitempty"` // 租户节点 id + UserIdList []string `json:"user_id_list,omitempty"` // 审批人 id 列表 + EndCcIdList []string `json:"end_cc_id_list,omitempty"` // 节点结束抄送人 id 列表 IsEmptyLogic *bool `json:"is_empty_logic,omitempty"` // 审批人是否为空 IsApproverTypeFree *bool `json:"is_approver_type_free,omitempty"` // 是否是发起人自选类型 HasCcTypeFree *bool `json:"has_cc_type_free,omitempty"` // 是否包含抄送人自选类型 } type PreviewNodeBuilder struct { - nodeId string // 节点id + nodeId string // 节点 id nodeIdFlag bool nodeName string // 节点名称 nodeNameFlag bool @@ -6788,11 +6788,11 @@ type PreviewNodeBuilder struct { nodeTypeFlag bool comments []string // 节点描述 commentsFlag bool - customNodeId string // 租户节点id + customNodeId string // 租户节点 id customNodeIdFlag bool - userIdList []string // 审批人id列表 + userIdList []string // 审批人 id 列表 userIdListFlag bool - endCcIdList []string // 节点结束抄送人id列表 + endCcIdList []string // 节点结束抄送人 id 列表 endCcIdListFlag bool isEmptyLogic bool // 审批人是否为空 isEmptyLogicFlag bool @@ -6807,7 +6807,7 @@ func NewPreviewNodeBuilder() *PreviewNodeBuilder { return builder } -// 节点id +// 节点 id // // 示例值： func (builder *PreviewNodeBuilder) NodeId(nodeId string) *PreviewNodeBuilder { @@ -6843,7 +6843,7 @@ func (builder *PreviewNodeBuilder) Comments(comments []string) *PreviewNodeBuild return builder } -// 租户节点id +// 租户节点 id // // 示例值： func (builder *PreviewNodeBuilder) CustomNodeId(customNodeId string) *PreviewNodeBuilder { @@ -6852,7 +6852,7 @@ func (builder *PreviewNodeBuilder) CustomNodeId(customNodeId string) *PreviewNod return builder } -// 审批人id列表 +// 审批人 id 列表 // // 示例值： func (builder *PreviewNodeBuilder) UserIdList(userIdList []string) *PreviewNodeBuilder { @@ -6861,7 +6861,7 @@ func (builder *PreviewNodeBuilder) UserIdList(userIdList []string) *PreviewNodeB return builder } -// 节点结束抄送人id列表 +// 节点结束抄送人 id 列表 // // 示例值： func (builder *PreviewNodeBuilder) EndCcIdList(endCcIdList []string) *PreviewNodeBuilder { @@ -7132,7 +7132,7 @@ func (builder *RemedyGroupBuilder) Build() *RemedyGroup { type RevertEvent struct { Type *string `json:"type,omitempty"` // 类型 - InstanceCode *string `json:"instance_code,omitempty"` // 实例code + InstanceCode *string `json:"instance_code,omitempty"` // 实例 code OperateTime *string `json:"operate_time,omitempty"` // 操作时间 Status *string `json:"status,omitempty"` // 状态 } @@ -7140,7 +7140,7 @@ type RevertEvent struct { type RevertEventBuilder struct { type_ string // 类型 typeFlag bool - instanceCode string // 实例code + instanceCode string // 实例 code instanceCodeFlag bool operateTime string // 操作时间 operateTimeFlag bool @@ -7162,7 +7162,7 @@ func (builder *RevertEventBuilder) Type(type_ string) *RevertEventBuilder { return builder } -// 实例code +// 实例 code // // 示例值：C04A783E-D0BB-4036-BADC-31BECC6DDA29 func (builder *RevertEventBuilder) InstanceCode(instanceCode string) *RevertEventBuilder { @@ -7211,20 +7211,20 @@ func (builder *RevertEventBuilder) Build() *RevertEvent { } type RollbackNode struct { - NodeId *string `json:"node_id,omitempty"` // 节点id + NodeId *string `json:"node_id,omitempty"` // 节点 id NodeName *string `json:"node_name,omitempty"` // 节点名称 CustomNodeId *string `json:"custom_node_id,omitempty"` // 节点自定义 id - NodeKey *string `json:"node_key,omitempty"` // 节点key + NodeKey *string `json:"node_key,omitempty"` // 节点 key } type RollbackNodeBuilder struct { - nodeId string // 节点id + nodeId string // 节点 id nodeIdFlag bool nodeName string // 节点名称 nodeNameFlag bool customNodeId string // 节点自定义 id customNodeIdFlag bool - nodeKey string // 节点key + nodeKey string // 节点 key nodeKeyFlag bool } @@ -7233,7 +7233,7 @@ func NewRollbackNodeBuilder() *RollbackNodeBuilder { return builder } -// 节点id +// 节点 id // // 示例值：46e6d96cfa756980907209209ec03b64 func (builder *RollbackNodeBuilder) NodeId(nodeId string) *RollbackNodeBuilder { @@ -7260,7 +7260,7 @@ func (builder *RollbackNodeBuilder) CustomNodeId(customNodeId string) *RollbackN return builder } -// 节点key +// 节点 key // // 示例值：APPROVAL_240330_4058663 func (builder *RollbackNodeBuilder) NodeKey(nodeKey string) *RollbackNodeBuilder { @@ -7418,23 +7418,23 @@ func (builder *SignGroupBuilder) Build() *SignGroup { } type SpecifiedRollback struct { - UserId *string `json:"user_id,omitempty"` // 用户ID - TaskId *string `json:"task_id,omitempty"` // 回退的任务ID + UserId *string `json:"user_id,omitempty"` // 用户 ID + TaskId *string `json:"task_id,omitempty"` // 回退的任务 ID Reason *string `json:"reason,omitempty"` // 退回原因 Extra *string `json:"extra,omitempty"` // 扩展字段 - TaskDefKeyList []string `json:"task_def_key_list,omitempty"` // 指定退回的任务node_key，从实例详情中获取timeline中获取，必须是PASS的任务node_key + TaskDefKeyList []string `json:"task_def_key_list,omitempty"` // 指定退回的任务 node_key，从实例详情中获取 timeline 中获取，必须是 PASS 的任务 node_key } type SpecifiedRollbackBuilder struct { - userId string // 用户ID + userId string // 用户 ID userIdFlag bool - taskId string // 回退的任务ID + taskId string // 回退的任务 ID taskIdFlag bool reason string // 退回原因 reasonFlag bool extra string // 扩展字段 extraFlag bool - taskDefKeyList []string // 指定退回的任务node_key，从实例详情中获取timeline中获取，必须是PASS的任务node_key + taskDefKeyList []string // 指定退回的任务 node_key，从实例详情中获取 timeline 中获取，必须是 PASS 的任务 node_key taskDefKeyListFlag bool } @@ -7443,7 +7443,7 @@ func NewSpecifiedRollbackBuilder() *SpecifiedRollbackBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：893g4c45 func (builder *SpecifiedRollbackBuilder) UserId(userId string) *SpecifiedRollbackBuilder { @@ -7452,7 +7452,7 @@ func (builder *SpecifiedRollbackBuilder) UserId(userId string) *SpecifiedRollbac return builder } -// 回退的任务ID +// 回退的任务 ID // // 示例值：7026591166355210260 func (builder *SpecifiedRollbackBuilder) TaskId(taskId string) *SpecifiedRollbackBuilder { @@ -7479,7 +7479,7 @@ func (builder *SpecifiedRollbackBuilder) Extra(extra string) *SpecifiedRollbackB return builder } -// 指定退回的任务node_key，从实例详情中获取timeline中获取，必须是PASS的任务node_key +// 指定退回的任务 node_key，从实例详情中获取 timeline 中获取，必须是 PASS 的任务 node_key // // 示例值：["START","APPROVAL_27997_285502","APPROVAL_462205_2734554"] func (builder *SpecifiedRollbackBuilder) TaskDefKeyList(taskDefKeyList []string) *SpecifiedRollbackBuilder { @@ -7816,9 +7816,9 @@ func (builder *TaskBuilder) Build() *Task { type TaskApprove struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 Code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 Code - UserId *string `json:"user_id,omitempty"` // 根据user_id_type填写操作用户id + UserId *string `json:"user_id,omitempty"` // 根据 user_id_type 填写操作用户 id Comment *string `json:"comment,omitempty"` // 意见 - TaskId *string `json:"task_id,omitempty"` // 任务 ID， 审批实例详情task_list中id + TaskId *string `json:"task_id,omitempty"` // 任务 ID， 审批实例详情 task_list 中 id Form *string `json:"form,omitempty"` // json 数组，控件值 } @@ -7827,11 +7827,11 @@ type TaskApproveBuilder struct { approvalCodeFlag bool instanceCode string // 审批实例 Code instanceCodeFlag bool - userId string // 根据user_id_type填写操作用户id + userId string // 根据 user_id_type 填写操作用户 id userIdFlag bool comment string // 意见 commentFlag bool - taskId string // 任务 ID， 审批实例详情task_list中id + taskId string // 任务 ID， 审批实例详情 task_list 中 id taskIdFlag bool form string // json 数组，控件值 formFlag bool @@ -7860,7 +7860,7 @@ func (builder *TaskApproveBuilder) InstanceCode(instanceCode string) *TaskApprov return builder } -// 根据user_id_type填写操作用户id +// 根据 user_id_type 填写操作用户 id // // 示例值：f7cb567e func (builder *TaskApproveBuilder) UserId(userId string) *TaskApproveBuilder { @@ -7878,7 +7878,7 @@ func (builder *TaskApproveBuilder) Comment(comment string) *TaskApproveBuilder { return builder } -// 任务 ID， 审批实例详情task_list中id +// 任务 ID， 审批实例详情 task_list 中 id // // 示例值：12345 func (builder *TaskApproveBuilder) TaskId(taskId string) *TaskApproveBuilder { @@ -7928,10 +7928,10 @@ func (builder *TaskApproveBuilder) Build() *TaskApprove { type TaskResubmit struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 Code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 Code - UserId *string `json:"user_id,omitempty"` // 根据user_id_type填写操作用户id + UserId *string `json:"user_id,omitempty"` // 根据 user_id_type 填写操作用户 id Comment *string `json:"comment,omitempty"` // 意见 - TaskId *string `json:"task_id,omitempty"` // 任务 ID， 审批实例详情task_list中id - Form *string `json:"form,omitempty"` // json 数组，控件值，同创建审批实例接口中form字段 + TaskId *string `json:"task_id,omitempty"` // 任务 ID， 审批实例详情 task_list 中 id + Form *string `json:"form,omitempty"` // json 数组，控件值，同创建审批实例接口中 form 字段 } type TaskResubmitBuilder struct { @@ -7939,13 +7939,13 @@ type TaskResubmitBuilder struct { approvalCodeFlag bool instanceCode string // 审批实例 Code instanceCodeFlag bool - userId string // 根据user_id_type填写操作用户id + userId string // 根据 user_id_type 填写操作用户 id userIdFlag bool comment string // 意见 commentFlag bool - taskId string // 任务 ID， 审批实例详情task_list中id + taskId string // 任务 ID， 审批实例详情 task_list 中 id taskIdFlag bool - form string // json 数组，控件值，同创建审批实例接口中form字段 + form string // json 数组，控件值，同创建审批实例接口中 form 字段 formFlag bool } @@ -7972,7 +7972,7 @@ func (builder *TaskResubmitBuilder) InstanceCode(instanceCode string) *TaskResub return builder } -// 根据user_id_type填写操作用户id +// 根据 user_id_type 填写操作用户 id // // 示例值：f7cb567e func (builder *TaskResubmitBuilder) UserId(userId string) *TaskResubmitBuilder { @@ -7990,7 +7990,7 @@ func (builder *TaskResubmitBuilder) Comment(comment string) *TaskResubmitBuilder return builder } -// 任务 ID， 审批实例详情task_list中id +// 任务 ID， 审批实例详情 task_list 中 id // // 示例值：12345 func (builder *TaskResubmitBuilder) TaskId(taskId string) *TaskResubmitBuilder { @@ -7999,7 +7999,7 @@ func (builder *TaskResubmitBuilder) TaskId(taskId string) *TaskResubmitBuilder { return builder } -// json 数组，控件值，同创建审批实例接口中form字段 +// json 数组，控件值，同创建审批实例接口中 form 字段 // // 示例值：[{\"id\":\"user_name\", \"type\": \"input\", \"value\":\"test\"}] func (builder *TaskResubmitBuilder) Form(form string) *TaskResubmitBuilder { @@ -8038,17 +8038,17 @@ func (builder *TaskResubmitBuilder) Build() *TaskResubmit { } type TaskRollback struct { - UserId *string `json:"user_id,omitempty"` // 用户ID - TaskId *string `json:"task_id,omitempty"` // 回退的任务ID + UserId *string `json:"user_id,omitempty"` // 用户 ID + TaskId *string `json:"task_id,omitempty"` // 回退的任务 ID Reason *string `json:"reason,omitempty"` // 退回原因 Extra *string `json:"extra,omitempty"` // 扩展字段 TaskDefKey *string `json:"task_def_key,omitempty"` // 退回节点对应的标识 } type TaskRollbackBuilder struct { - userId string // 用户ID + userId string // 用户 ID userIdFlag bool - taskId string // 回退的任务ID + taskId string // 回退的任务 ID taskIdFlag bool reason string // 退回原因 reasonFlag bool @@ -8063,7 +8063,7 @@ func NewTaskRollbackBuilder() *TaskRollbackBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：893g4c45 func (builder *TaskRollbackBuilder) UserId(userId string) *TaskRollbackBuilder { @@ -8072,7 +8072,7 @@ func (builder *TaskRollbackBuilder) UserId(userId string) *TaskRollbackBuilder { return builder } -// 回退的任务ID +// 回退的任务 ID // // 示例值：7026591166355210260 func (builder *TaskRollbackBuilder) TaskId(taskId string) *TaskRollbackBuilder { @@ -8134,22 +8134,22 @@ func (builder *TaskRollbackBuilder) Build() *TaskRollback { } type TaskSearch struct { - UserId *string `json:"user_id,omitempty"` // 根据x_user_type填写审批人id + UserId *string `json:"user_id,omitempty"` // 根据 x_user_type 填写审批人 id ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code InstanceExternalId *string `json:"instance_external_id,omitempty"` // 审批实例第三方 id 注：和 approval_code 取并集 GroupExternalId *string `json:"group_external_id,omitempty"` // 审批定义分组第三方 id 注：和 instance_code 取并集 TaskTitle *string `json:"task_title,omitempty"` // 审批任务标题（只有第三方审批有） TaskStatus *string `json:"task_status,omitempty"` // 审批任务状态，注：若不设置，查询全部状态 若不在集合中，报错 - TaskStartTimeFrom *string `json:"task_start_time_from,omitempty"` // 任务查询开始时间（unix毫秒时间戳） - TaskStartTimeTo *string `json:"task_start_time_to,omitempty"` // 任务查询结束时间 (unix毫秒时间戳) + TaskStartTimeFrom *string `json:"task_start_time_from,omitempty"` // 任务查询开始时间（unix 毫秒时间戳） + TaskStartTimeTo *string `json:"task_start_time_to,omitempty"` // 任务查询结束时间 (unix 毫秒时间戳) Locale *string `json:"locale,omitempty"` // 地区 - TaskStatusList []string `json:"task_status_list,omitempty"` // 可选择task_status中的多个状态，当填写此参数时，task_status失效 + TaskStatusList []string `json:"task_status_list,omitempty"` // 可选择 task_status 中的多个状态，当填写此参数时，task_status 失效 Order *int `json:"order,omitempty"` // 按任务时间排序 } type TaskSearchBuilder struct { - userId string // 根据x_user_type填写审批人id + userId string // 根据 x_user_type 填写审批人 id userIdFlag bool approvalCode string // 审批定义 code approvalCodeFlag bool @@ -8163,13 +8163,13 @@ type TaskSearchBuilder struct { taskTitleFlag bool taskStatus string // 审批任务状态，注：若不设置，查询全部状态 若不在集合中，报错 taskStatusFlag bool - taskStartTimeFrom string // 任务查询开始时间（unix毫秒时间戳） + taskStartTimeFrom string // 任务查询开始时间（unix 毫秒时间戳） taskStartTimeFromFlag bool - taskStartTimeTo string // 任务查询结束时间 (unix毫秒时间戳) + taskStartTimeTo string // 任务查询结束时间 (unix 毫秒时间戳) taskStartTimeToFlag bool locale string // 地区 localeFlag bool - taskStatusList []string // 可选择task_status中的多个状态，当填写此参数时，task_status失效 + taskStatusList []string // 可选择 task_status 中的多个状态，当填写此参数时，task_status 失效 taskStatusListFlag bool order int // 按任务时间排序 orderFlag bool @@ -8180,7 +8180,7 @@ func NewTaskSearchBuilder() *TaskSearchBuilder { return builder } -// 根据x_user_type填写审批人id +// 根据 x_user_type 填写审批人 id // // 示例值：lwiu098wj func (builder *TaskSearchBuilder) UserId(userId string) *TaskSearchBuilder { @@ -8243,7 +8243,7 @@ func (builder *TaskSearchBuilder) TaskStatus(taskStatus string) *TaskSearchBuild return builder } -// 任务查询开始时间（unix毫秒时间戳） +// 任务查询开始时间（unix 毫秒时间戳） // // 示例值：1547654251506 func (builder *TaskSearchBuilder) TaskStartTimeFrom(taskStartTimeFrom string) *TaskSearchBuilder { @@ -8252,7 +8252,7 @@ func (builder *TaskSearchBuilder) TaskStartTimeFrom(taskStartTimeFrom string) *T return builder } -// 任务查询结束时间 (unix毫秒时间戳) +// 任务查询结束时间 (unix 毫秒时间戳) // // 示例值：1547654251506 func (builder *TaskSearchBuilder) TaskStartTimeTo(taskStartTimeTo string) *TaskSearchBuilder { @@ -8270,7 +8270,7 @@ func (builder *TaskSearchBuilder) Locale(locale string) *TaskSearchBuilder { return builder } -// 可选择task_status中的多个状态，当填写此参数时，task_status失效 +// 可选择 task_status 中的多个状态，当填写此参数时，task_status 失效 // // 示例值：PENDING func (builder *TaskSearchBuilder) TaskStatusList(taskStatusList []string) *TaskSearchBuilder { @@ -8422,9 +8422,9 @@ type TaskSearchNode struct { EndTime *string `json:"end_time,omitempty"` // 审批任务结束时间 Status *string `json:"status,omitempty"` // 审批任务状态 Title *string `json:"title,omitempty"` // 审批任务名称（只有第三方审批有） - Extra *string `json:"extra,omitempty"` // 审批任务扩展字段，string型json + Extra *string `json:"extra,omitempty"` // 审批任务扩展字段，string 型 json Link *InstanceSearchLink `json:"link,omitempty"` // 审批任务链接（只有第三方审批有） - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id UpdateTime *string `json:"update_time,omitempty"` // 审批任务更新时间 TaskExternalId *string `json:"task_external_id,omitempty"` // 三方审批扩展 ID } @@ -8440,11 +8440,11 @@ type TaskSearchNodeBuilder struct { statusFlag bool title string // 审批任务名称（只有第三方审批有） titleFlag bool - extra string // 审批任务扩展字段，string型json + extra string // 审批任务扩展字段，string 型 json extraFlag bool link *InstanceSearchLink // 审批任务链接（只有第三方审批有） linkFlag bool - taskId string // 任务id + taskId string // 任务 id taskIdFlag bool updateTime string // 审批任务更新时间 updateTimeFlag bool @@ -8502,7 +8502,7 @@ func (builder *TaskSearchNodeBuilder) Title(title string) *TaskSearchNodeBuilder return builder } -// 审批任务扩展字段，string型json +// 审批任务扩展字段，string 型 json // // 示例值：{} func (builder *TaskSearchNodeBuilder) Extra(extra string) *TaskSearchNodeBuilder { @@ -8520,7 +8520,7 @@ func (builder *TaskSearchNodeBuilder) Link(link *InstanceSearchLink) *TaskSearch return builder } -// 任务id +// 任务 id // // 示例值：7110153401253494803 func (builder *TaskSearchNodeBuilder) TaskId(taskId string) *TaskSearchNodeBuilder { @@ -8594,10 +8594,10 @@ func (builder *TaskSearchNodeBuilder) Build() *TaskSearchNode { type TaskTransfer struct { ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 Code InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 Code - UserId *string `json:"user_id,omitempty"` // 根据user_id_type填写操作用户id + UserId *string `json:"user_id,omitempty"` // 根据 user_id_type 填写操作用户 id Comment *string `json:"comment,omitempty"` // 意见 - TransferUserId *string `json:"transfer_user_id,omitempty"` // 根据user_id_type填写被转交人唯一 ID - TaskId *string `json:"task_id,omitempty"` // 任务 ID， 审批实例详情task_list中id + TransferUserId *string `json:"transfer_user_id,omitempty"` // 根据 user_id_type 填写被转交人唯一 ID + TaskId *string `json:"task_id,omitempty"` // 任务 ID， 审批实例详情 task_list 中 id } type TaskTransferBuilder struct { @@ -8605,13 +8605,13 @@ type TaskTransferBuilder struct { approvalCodeFlag bool instanceCode string // 审批实例 Code instanceCodeFlag bool - userId string // 根据user_id_type填写操作用户id + userId string // 根据 user_id_type 填写操作用户 id userIdFlag bool comment string // 意见 commentFlag bool - transferUserId string // 根据user_id_type填写被转交人唯一 ID + transferUserId string // 根据 user_id_type 填写被转交人唯一 ID transferUserIdFlag bool - taskId string // 任务 ID， 审批实例详情task_list中id + taskId string // 任务 ID， 审批实例详情 task_list 中 id taskIdFlag bool } @@ -8638,7 +8638,7 @@ func (builder *TaskTransferBuilder) InstanceCode(instanceCode string) *TaskTrans return builder } -// 根据user_id_type填写操作用户id +// 根据 user_id_type 填写操作用户 id // // 示例值：f7cb567e func (builder *TaskTransferBuilder) UserId(userId string) *TaskTransferBuilder { @@ -8656,7 +8656,7 @@ func (builder *TaskTransferBuilder) Comment(comment string) *TaskTransferBuilder return builder } -// 根据user_id_type填写被转交人唯一 ID +// 根据 user_id_type 填写被转交人唯一 ID // // 示例值：f4ip317q func (builder *TaskTransferBuilder) TransferUserId(transferUserId string) *TaskTransferBuilder { @@ -8665,7 +8665,7 @@ func (builder *TaskTransferBuilder) TransferUserId(transferUserId string) *TaskT return builder } -// 任务 ID， 审批实例详情task_list中id +// 任务 ID， 审批实例详情 task_list 中 id // // 示例值：12345 func (builder *TaskTransferBuilder) TaskId(taskId string) *TaskTransferBuilder { @@ -8769,7 +8769,7 @@ func (builder *TaskUrlsBuilder) Build() *TaskUrls { type TripGroup struct { Type *string `json:"type,omitempty"` // 出差类型 - InstanceCode *string `json:"instance_code,omitempty"` // 实例code + InstanceCode *string `json:"instance_code,omitempty"` // 实例 code StartUser *User `json:"start_user,omitempty"` // 发起人 StartTime *string `json:"start_time,omitempty"` // 开始时间 EndTime *string `json:"end_time,omitempty"` // 结束时间 @@ -8782,7 +8782,7 @@ type TripGroup struct { type TripGroupBuilder struct { type_ string // 出差类型 typeFlag bool - instanceCode string // 实例code + instanceCode string // 实例 code instanceCodeFlag bool startUser *User // 发起人 startUserFlag bool @@ -8814,7 +8814,7 @@ func (builder *TripGroupBuilder) Type(type_ string) *TripGroupBuilder { return builder } -// 实例code +// 实例 code // // 示例值： func (builder *TripGroupBuilder) InstanceCode(instanceCode string) *TripGroupBuilder { @@ -8933,8 +8933,8 @@ type TripGroupSchedule struct { Transportation *string `json:"transportation,omitempty"` // 交通工具 TripType *string `json:"trip_type,omitempty"` // 出差类型 Remark *string `json:"remark,omitempty"` // 备注 - DepartureId *string `json:"departure_id,omitempty"` // 出发地id - DestinationIds []string `json:"destination_ids,omitempty"` // 目的地id列表 + DepartureId *string `json:"departure_id,omitempty"` // 出发地 id + DestinationIds []string `json:"destination_ids,omitempty"` // 目的地 id 列表 } type TripGroupScheduleBuilder struct { @@ -8954,9 +8954,9 @@ type TripGroupScheduleBuilder struct { tripTypeFlag bool remark string // 备注 remarkFlag bool - departureId string // 出发地id + departureId string // 出发地 id departureIdFlag bool - destinationIds []string // 目的地id列表 + destinationIds []string // 目的地 id 列表 destinationIdsFlag bool } @@ -9037,7 +9037,7 @@ func (builder *TripGroupScheduleBuilder) Remark(remark string) *TripGroupSchedul return builder } -// 出发地id +// 出发地 id // // 示例值：6c758b5dc54930abc7a454c7477d3496cfca0a62fd941e0093b2d819e0e263a6 func (builder *TripGroupScheduleBuilder) DepartureId(departureId string) *TripGroupScheduleBuilder { @@ -9046,7 +9046,7 @@ func (builder *TripGroupScheduleBuilder) DepartureId(departureId string) *TripGr return builder } -// 目的地id列表 +// 目的地 id 列表 // // 示例值： func (builder *TripGroupScheduleBuilder) DestinationIds(destinationIds []string) *TripGroupScheduleBuilder { @@ -9100,23 +9100,23 @@ func (builder *TripGroupScheduleBuilder) Build() *TripGroupSchedule { } type TrusteeshipUrls struct { - FormDetailUrl *string `json:"form_detail_url,omitempty"` // 获取表单schema相关数据的url地址 - ActionDefinitionUrl *string `json:"action_definition_url,omitempty"` // 表示获取审批操作区数据的url地址 - ApprovalNodeUrl *string `json:"approval_node_url,omitempty"` // 获取审批记录相关数据的url地址 - ActionCallbackUrl *string `json:"action_callback_url,omitempty"` // 进行审批操作时回调的url地址 - PullBusinessDataUrl *string `json:"pull_business_data_url,omitempty"` // 获取托管动态数据URL,使用该接口时必须要保证历史托管单据的数据中都同步了该接口地址,如果历史单据中没有该接口需要重新同步历史托管单据的数据来更新该URL + FormDetailUrl *string `json:"form_detail_url,omitempty"` // 获取表单 schema 相关数据的 url 地址 + ActionDefinitionUrl *string `json:"action_definition_url,omitempty"` // 表示获取审批操作区数据的 url 地址 + ApprovalNodeUrl *string `json:"approval_node_url,omitempty"` // 获取审批记录相关数据的 url 地址 + ActionCallbackUrl *string `json:"action_callback_url,omitempty"` // 进行审批操作时回调的 url 地址 + PullBusinessDataUrl *string `json:"pull_business_data_url,omitempty"` // 获取托管动态数据 URL，使用该接口时必须要保证历史托管单据的数据中都同步了该接口地址，如果历史单据中没有该接口需要重新同步历史托管单据的数据来更新该 URL } type TrusteeshipUrlsBuilder struct { - formDetailUrl string // 获取表单schema相关数据的url地址 + formDetailUrl string // 获取表单 schema 相关数据的 url 地址 formDetailUrlFlag bool - actionDefinitionUrl string // 表示获取审批操作区数据的url地址 + actionDefinitionUrl string // 表示获取审批操作区数据的 url 地址 actionDefinitionUrlFlag bool - approvalNodeUrl string // 获取审批记录相关数据的url地址 + approvalNodeUrl string // 获取审批记录相关数据的 url 地址 approvalNodeUrlFlag bool - actionCallbackUrl string // 进行审批操作时回调的url地址 + actionCallbackUrl string // 进行审批操作时回调的 url 地址 actionCallbackUrlFlag bool - pullBusinessDataUrl string // 获取托管动态数据URL,使用该接口时必须要保证历史托管单据的数据中都同步了该接口地址,如果历史单据中没有该接口需要重新同步历史托管单据的数据来更新该URL + pullBusinessDataUrl string // 获取托管动态数据 URL，使用该接口时必须要保证历史托管单据的数据中都同步了该接口地址，如果历史单据中没有该接口需要重新同步历史托管单据的数据来更新该 URL pullBusinessDataUrlFlag bool } @@ -9125,7 +9125,7 @@ func NewTrusteeshipUrlsBuilder() *TrusteeshipUrlsBuilder { return builder } -// 获取表单schema相关数据的url地址 +// 获取表单 schema 相关数据的 url 地址 // // 示例值：https://#{your_domain}/api/form_detail func (builder *TrusteeshipUrlsBuilder) FormDetailUrl(formDetailUrl string) *TrusteeshipUrlsBuilder { @@ -9134,7 +9134,7 @@ func (builder *TrusteeshipUrlsBuilder) FormDetailUrl(formDetailUrl string) *Trus return builder } -// 表示获取审批操作区数据的url地址 +// 表示获取审批操作区数据的 url 地址 // // 示例值：https://#{your_domain}/api/action_definition func (builder *TrusteeshipUrlsBuilder) ActionDefinitionUrl(actionDefinitionUrl string) *TrusteeshipUrlsBuilder { @@ -9143,7 +9143,7 @@ func (builder *TrusteeshipUrlsBuilder) ActionDefinitionUrl(actionDefinitionUrl s return builder } -// 获取审批记录相关数据的url地址 +// 获取审批记录相关数据的 url 地址 // // 示例值：https://#{your_domain}/api/approval_node func (builder *TrusteeshipUrlsBuilder) ApprovalNodeUrl(approvalNodeUrl string) *TrusteeshipUrlsBuilder { @@ -9152,7 +9152,7 @@ func (builder *TrusteeshipUrlsBuilder) ApprovalNodeUrl(approvalNodeUrl string) * return builder } -// 进行审批操作时回调的url地址 +// 进行审批操作时回调的 url 地址 // // 示例值：https://#{your_domain}/api/approval_node func (builder *TrusteeshipUrlsBuilder) ActionCallbackUrl(actionCallbackUrl string) *TrusteeshipUrlsBuilder { @@ -9161,7 +9161,7 @@ func (builder *TrusteeshipUrlsBuilder) ActionCallbackUrl(actionCallbackUrl strin return builder } -// 获取托管动态数据URL,使用该接口时必须要保证历史托管单据的数据中都同步了该接口地址,如果历史单据中没有该接口需要重新同步历史托管单据的数据来更新该URL +// 获取托管动态数据 URL，使用该接口时必须要保证历史托管单据的数据中都同步了该接口地址，如果历史单据中没有该接口需要重新同步历史托管单据的数据来更新该 URL // // 示例值：https://#{your_domain}/api/pull_business_data func (builder *TrusteeshipUrlsBuilder) PullBusinessDataUrl(pullBusinessDataUrl string) *TrusteeshipUrlsBuilder { @@ -9196,14 +9196,14 @@ func (builder *TrusteeshipUrlsBuilder) Build() *TrusteeshipUrls { } type UrlDetail struct { - OriginUrl *string `json:"origin_url,omitempty"` // 文件为空，使用url则是原url + OriginUrl *string `json:"origin_url,omitempty"` // 文件为空，使用 url 则是原 url Url *string `json:"url,omitempty"` // 文件 url Code *string `json:"code,omitempty"` // 文件标识码 Message *string `json:"message,omitempty"` // 错误信息，没有则为空 } type UrlDetailBuilder struct { - originUrl string // 文件为空，使用url则是原url + originUrl string // 文件为空，使用 url 则是原 url originUrlFlag bool url string // 文件 url urlFlag bool @@ -9218,7 +9218,7 @@ func NewUrlDetailBuilder() *UrlDetailBuilder { return builder } -// 文件为空，使用url则是原url +// 文件为空，使用 url 则是原 url // // 示例值：https://xxxxx.com/i/2022/06/08/xxxxx.png func (builder *UrlDetailBuilder) OriginUrl(originUrl string) *UrlDetailBuilder { @@ -9276,12 +9276,12 @@ func (builder *UrlDetailBuilder) Build() *UrlDetail { } type User struct { - Id *UserId `json:"id,omitempty"` // 用户id + Id *UserId `json:"id,omitempty"` // 用户 id Name *string `json:"name,omitempty"` // 用户名 } type UserBuilder struct { - id *UserId // 用户id + id *UserId // 用户 id idFlag bool name string // 用户名 nameFlag bool @@ -9292,7 +9292,7 @@ func NewUserBuilder() *UserBuilder { return builder } -// 用户id +// 用户 id // // 示例值： func (builder *UserBuilder) Id(id *UserId) *UserBuilder { @@ -9400,7 +9400,7 @@ func NewCreateApprovalReqBuilder() *CreateApprovalReqBuilder { return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *CreateApprovalReqBuilder) DepartmentIdType(departmentIdType string) *CreateApprovalReqBuilder { @@ -9408,7 +9408,7 @@ func (builder *CreateApprovalReqBuilder) DepartmentIdType(departmentIdType strin return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateApprovalReqBuilder) UserIdType(userIdType string) *CreateApprovalReqBuilder { @@ -9479,7 +9479,7 @@ func (builder *GetApprovalReqBuilder) Locale(locale string) *GetApprovalReqBuild return builder } -// 可选是否返回有数据权限审批流程管理员ID列表 +// 可选是否返回有数据权限审批流程管理员 ID 列表 // // 示例值：false func (builder *GetApprovalReqBuilder) WithAdminId(withAdminId bool) *GetApprovalReqBuilder { @@ -9487,7 +9487,7 @@ func (builder *GetApprovalReqBuilder) WithAdminId(withAdminId bool) *GetApproval return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetApprovalReqBuilder) UserIdType(userIdType string) *GetApprovalReqBuilder { @@ -9510,10 +9510,10 @@ type GetApprovalReq struct { type GetApprovalRespData struct { ApprovalName *string `json:"approval_name,omitempty"` // 审批名称 Status *string `json:"status,omitempty"` // 审批定义状态 - Form *string `json:"form,omitempty"` // 控件信息，见下方form字段说明 + Form *string `json:"form,omitempty"` // 控件信息，见下方 form 字段说明 NodeList []*ApprovalNodeInfo `json:"node_list,omitempty"` // 节点信息 Viewers []*ApprovalViewerInfo `json:"viewers,omitempty"` // 可见人列表 - ApprovalAdminIds []string `json:"approval_admin_ids,omitempty"` // 有数据管理权限的审批流程管理员ID + ApprovalAdminIds []string `json:"approval_admin_ids,omitempty"` // 有数据管理权限的审批流程管理员 ID } type GetApprovalResp struct { @@ -9622,7 +9622,7 @@ func NewCreateExternalApprovalReqBuilder() *CreateExternalApprovalReqBuilder { return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *CreateExternalApprovalReqBuilder) DepartmentIdType(departmentIdType string) *CreateExternalApprovalReqBuilder { @@ -9630,7 +9630,7 @@ func (builder *CreateExternalApprovalReqBuilder) DepartmentIdType(departmentIdTy return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateExternalApprovalReqBuilder) UserIdType(userIdType string) *CreateExternalApprovalReqBuilder { @@ -9658,7 +9658,7 @@ type CreateExternalApprovalReq struct { } type CreateExternalApprovalRespData struct { - ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义code，审批生成的唯一标识，用于三方审批实例同步时使用 + ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code，审批生成的唯一标识，用于三方审批实例同步时使用 } type CreateExternalApprovalResp struct { @@ -9739,7 +9739,7 @@ func NewCheckExternalInstanceReqBuilder() *CheckExternalInstanceReqBuilder { return builder } -// 校验三方审批实例数据，用于判断服务端数据是否为最新的。用户提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 id。;;例如，用户可以每隔5分钟，将最近5分钟产生的实例使用该接口进行对比。 +// 校验三方审批实例数据，用于判断服务端数据是否为最新的。用户提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 id。;;例如，用户可以每隔 5 分钟，将最近 5 分钟产生的实例使用该接口进行对比。 func (builder *CheckExternalInstanceReqBuilder) Body(body *CheckExternalInstanceReqBody) *CheckExternalInstanceReqBuilder { builder.body = body return builder @@ -9824,7 +9824,7 @@ func (resp *CreateExternalInstanceResp) Success() bool { type ListExternalTaskReqBodyBuilder struct { approvalCodes []string // 审批定义 Code，用于指定只获取这些定义下的数据 approvalCodesFlag bool - instanceIds []string // 审批实例 ID, 用于指定只获取这些实例下的数据，最多支持 20 个 + instanceIds []string // 审批实例 ID，用于指定只获取这些实例下的数据，最多支持 20 个 instanceIdsFlag bool userIds []string // 审批人 user_id，用于指定只获取这些用户的数据 userIdsFlag bool @@ -9846,7 +9846,7 @@ func (builder *ListExternalTaskReqBodyBuilder) ApprovalCodes(approvalCodes []str return builder } -// 审批实例 ID, 用于指定只获取这些实例下的数据，最多支持 20 个 +// 审批实例 ID，用于指定只获取这些实例下的数据，最多支持 20 个 // //示例值：oa_159160304 func (builder *ListExternalTaskReqBodyBuilder) InstanceIds(instanceIds []string) *ListExternalTaskReqBodyBuilder { @@ -9893,7 +9893,7 @@ func (builder *ListExternalTaskReqBodyBuilder) Build() *ListExternalTaskReqBody type ListExternalTaskPathReqBodyBuilder struct { approvalCodes []string // 审批定义 Code，用于指定只获取这些定义下的数据 approvalCodesFlag bool - instanceIds []string // 审批实例 ID, 用于指定只获取这些实例下的数据，最多支持 20 个 + instanceIds []string // 审批实例 ID，用于指定只获取这些实例下的数据，最多支持 20 个 instanceIdsFlag bool userIds []string // 审批人 user_id，用于指定只获取这些用户的数据 userIdsFlag bool @@ -9915,7 +9915,7 @@ func (builder *ListExternalTaskPathReqBodyBuilder) ApprovalCodes(approvalCodes [ return builder } -// 审批实例 ID, 用于指定只获取这些实例下的数据，最多支持 20 个 +// 审批实例 ID，用于指定只获取这些实例下的数据，最多支持 20 个 // // 示例值：oa_159160304 func (builder *ListExternalTaskPathReqBodyBuilder) InstanceIds(instanceIds []string) *ListExternalTaskPathReqBodyBuilder { @@ -9996,7 +9996,7 @@ func (builder *ListExternalTaskReqBuilder) PageToken(pageToken string) *ListExte return builder } -// 该接口用于获取三方审批的状态。用户传入查询条件，接口返回满足条件的审批实例的状态。该接口支持多种参数的组合，包括如下组合：;;1.通过 instance_ids 获取指定实例的任务状态;;2.通过 user_ids 获取指定用户的任务状态;;3.通过 status 获取指定状态的所有任务;;4.通过page_token获取下一批数据 +// 该接口用于获取三方审批的状态。用户传入查询条件，接口返回满足条件的审批实例的状态。该接口支持多种参数的组合，包括如下组合：;;1.通过 instance_ids 获取指定实例的任务状态;;2.通过 user_ids 获取指定用户的任务状态;;3.通过 status 获取指定状态的所有任务;;4.通过 page_token 获取下一批数据 func (builder *ListExternalTaskReqBuilder) Body(body *ListExternalTaskReqBody) *ListExternalTaskReqBuilder { builder.body = body return builder @@ -10013,7 +10013,7 @@ func (builder *ListExternalTaskReqBuilder) Build() *ListExternalTaskReq { type ListExternalTaskReqBody struct { ApprovalCodes []string `json:"approval_codes,omitempty"` // 审批定义 Code，用于指定只获取这些定义下的数据 - InstanceIds []string `json:"instance_ids,omitempty"` // 审批实例 ID, 用于指定只获取这些实例下的数据，最多支持 20 个 + InstanceIds []string `json:"instance_ids,omitempty"` // 审批实例 ID，用于指定只获取这些实例下的数据，最多支持 20 个 UserIds []string `json:"user_ids,omitempty"` // 审批人 user_id，用于指定只获取这些用户的数据 Status *string `json:"status,omitempty"` // 审批任务状态，用于指定获取该状态下的数据 } @@ -10042,19 +10042,19 @@ func (resp *ListExternalTaskResp) Success() bool { } type AddSignInstanceReqBodyBuilder struct { - userId string // 操作用户id + userId string // 操作用户 id userIdFlag bool - approvalCode string // 审批定义code + approvalCode string // 审批定义 code approvalCodeFlag bool - instanceCode string // 审批实例code + instanceCode string // 审批实例 code instanceCodeFlag bool - taskId string // 任务id + taskId string // 任务 id taskIdFlag bool comment string // 意见 commentFlag bool - addSignUserIds []string // 被加签人id + addSignUserIds []string // 被加签人 id addSignUserIdsFlag bool - addSignType int // 1/2/3分别代表前加签/后加签/并加签 + addSignType int // 1/2/3 分别代表前加签/后加签/并加签 addSignTypeFlag bool approvalMethod int // 仅在前加签、后加签时需要填写，1/2 分别代表或签/会签 approvalMethodFlag bool @@ -10065,7 +10065,7 @@ func NewAddSignInstanceReqBodyBuilder() *AddSignInstanceReqBodyBuilder { return builder } -// 操作用户id +// 操作用户 id // //示例值：b16g66e3 func (builder *AddSignInstanceReqBodyBuilder) UserId(userId string) *AddSignInstanceReqBodyBuilder { @@ -10074,7 +10074,7 @@ func (builder *AddSignInstanceReqBodyBuilder) UserId(userId string) *AddSignInst return builder } -// 审批定义code +// 审批定义 code // //示例值：3B68E280-CF10-4198-B4CD-2E3BB97981D8 func (builder *AddSignInstanceReqBodyBuilder) ApprovalCode(approvalCode string) *AddSignInstanceReqBodyBuilder { @@ -10083,7 +10083,7 @@ func (builder *AddSignInstanceReqBodyBuilder) ApprovalCode(approvalCode string) return builder } -// 审批实例code +// 审批实例 code // //示例值：289330DE-FBF1-4A47-91F9-9EFCCF11BCAE func (builder *AddSignInstanceReqBodyBuilder) InstanceCode(instanceCode string) *AddSignInstanceReqBodyBuilder { @@ -10092,7 +10092,7 @@ func (builder *AddSignInstanceReqBodyBuilder) InstanceCode(instanceCode string) return builder } -// 任务id +// 任务 id // //示例值：6955096766400167956 func (builder *AddSignInstanceReqBodyBuilder) TaskId(taskId string) *AddSignInstanceReqBodyBuilder { @@ -10110,7 +10110,7 @@ func (builder *AddSignInstanceReqBodyBuilder) Comment(comment string) *AddSignIn return builder } -// 被加签人id +// 被加签人 id // //示例值： func (builder *AddSignInstanceReqBodyBuilder) AddSignUserIds(addSignUserIds []string) *AddSignInstanceReqBodyBuilder { @@ -10119,7 +10119,7 @@ func (builder *AddSignInstanceReqBodyBuilder) AddSignUserIds(addSignUserIds []st return builder } -// 1/2/3分别代表前加签/后加签/并加签 +// 1/2/3 分别代表前加签/后加签/并加签 // //示例值：1 func (builder *AddSignInstanceReqBodyBuilder) AddSignType(addSignType int) *AddSignInstanceReqBodyBuilder { @@ -10167,19 +10167,19 @@ func (builder *AddSignInstanceReqBodyBuilder) Build() *AddSignInstanceReqBody { } type AddSignInstancePathReqBodyBuilder struct { - userId string // 操作用户id + userId string // 操作用户 id userIdFlag bool - approvalCode string // 审批定义code + approvalCode string // 审批定义 code approvalCodeFlag bool - instanceCode string // 审批实例code + instanceCode string // 审批实例 code instanceCodeFlag bool - taskId string // 任务id + taskId string // 任务 id taskIdFlag bool comment string // 意见 commentFlag bool - addSignUserIds []string // 被加签人id + addSignUserIds []string // 被加签人 id addSignUserIdsFlag bool - addSignType int // 1/2/3分别代表前加签/后加签/并加签 + addSignType int // 1/2/3 分别代表前加签/后加签/并加签 addSignTypeFlag bool approvalMethod int // 仅在前加签、后加签时需要填写，1/2 分别代表或签/会签 approvalMethodFlag bool @@ -10190,7 +10190,7 @@ func NewAddSignInstancePathReqBodyBuilder() *AddSignInstancePathReqBodyBuilder { return builder } -// 操作用户id +// 操作用户 id // // 示例值：b16g66e3 func (builder *AddSignInstancePathReqBodyBuilder) UserId(userId string) *AddSignInstancePathReqBodyBuilder { @@ -10199,7 +10199,7 @@ func (builder *AddSignInstancePathReqBodyBuilder) UserId(userId string) *AddSign return builder } -// 审批定义code +// 审批定义 code // // 示例值：3B68E280-CF10-4198-B4CD-2E3BB97981D8 func (builder *AddSignInstancePathReqBodyBuilder) ApprovalCode(approvalCode string) *AddSignInstancePathReqBodyBuilder { @@ -10208,7 +10208,7 @@ func (builder *AddSignInstancePathReqBodyBuilder) ApprovalCode(approvalCode stri return builder } -// 审批实例code +// 审批实例 code // // 示例值：289330DE-FBF1-4A47-91F9-9EFCCF11BCAE func (builder *AddSignInstancePathReqBodyBuilder) InstanceCode(instanceCode string) *AddSignInstancePathReqBodyBuilder { @@ -10217,7 +10217,7 @@ func (builder *AddSignInstancePathReqBodyBuilder) InstanceCode(instanceCode stri return builder } -// 任务id +// 任务 id // // 示例值：6955096766400167956 func (builder *AddSignInstancePathReqBodyBuilder) TaskId(taskId string) *AddSignInstancePathReqBodyBuilder { @@ -10235,7 +10235,7 @@ func (builder *AddSignInstancePathReqBodyBuilder) Comment(comment string) *AddSi return builder } -// 被加签人id +// 被加签人 id // // 示例值： func (builder *AddSignInstancePathReqBodyBuilder) AddSignUserIds(addSignUserIds []string) *AddSignInstancePathReqBodyBuilder { @@ -10244,7 +10244,7 @@ func (builder *AddSignInstancePathReqBodyBuilder) AddSignUserIds(addSignUserIds return builder } -// 1/2/3分别代表前加签/后加签/并加签 +// 1/2/3 分别代表前加签/后加签/并加签 // // 示例值：1 func (builder *AddSignInstancePathReqBodyBuilder) AddSignType(addSignType int) *AddSignInstancePathReqBodyBuilder { @@ -10319,13 +10319,13 @@ func (builder *AddSignInstanceReqBuilder) Build() *AddSignInstanceReq { } type AddSignInstanceReqBody struct { - UserId *string `json:"user_id,omitempty"` // 操作用户id - ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义code - InstanceCode *string `json:"instance_code,omitempty"` // 审批实例code - TaskId *string `json:"task_id,omitempty"` // 任务id + UserId *string `json:"user_id,omitempty"` // 操作用户 id + ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code + InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code + TaskId *string `json:"task_id,omitempty"` // 任务 id Comment *string `json:"comment,omitempty"` // 意见 - AddSignUserIds []string `json:"add_sign_user_ids,omitempty"` // 被加签人id - AddSignType *int `json:"add_sign_type,omitempty"` // 1/2/3分别代表前加签/后加签/并加签 + AddSignUserIds []string `json:"add_sign_user_ids,omitempty"` // 被加签人 id + AddSignType *int `json:"add_sign_type,omitempty"` // 1/2/3 分别代表前加签/后加签/并加签 ApprovalMethod *int `json:"approval_method,omitempty"` // 仅在前加签、后加签时需要填写，1/2 分别代表或签/会签 } @@ -10357,7 +10357,7 @@ func NewCancelInstanceReqBuilder() *CancelInstanceReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CancelInstanceReqBuilder) UserIdType(userIdType string) *CancelInstanceReqBuilder { @@ -10365,7 +10365,7 @@ func (builder *CancelInstanceReqBuilder) UserIdType(userIdType string) *CancelIn return builder } -// 对于状态为“审批中”的单个审批实例进行撤销操作，撤销后审批流程结束 +// 对于状态为 “审批中” 的单个审批实例进行撤销操作，撤销后审批流程结束 func (builder *CancelInstanceReqBuilder) InstanceCancel(instanceCancel *InstanceCancel) *CancelInstanceReqBuilder { builder.instanceCancel = instanceCancel return builder @@ -10407,7 +10407,7 @@ func NewCcInstanceReqBuilder() *CcInstanceReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CcInstanceReqBuilder) UserIdType(userIdType string) *CcInstanceReqBuilder { @@ -10502,7 +10502,7 @@ func NewGetInstanceReqBuilder() *GetInstanceReqBuilder { return builder } -// 审批实例 Code, 若在创建的时候传了uuid, 也可以通过传uuid获取 +// 审批实例 Code，若在创建的时候传了 uuid，也可以通过传 uuid 获取 // // 示例值：81D31358-93AF-92D6-7425-01A5D67C4E71 func (builder *GetInstanceReqBuilder) InstanceId(instanceId string) *GetInstanceReqBuilder { @@ -10518,7 +10518,7 @@ func (builder *GetInstanceReqBuilder) Locale(locale string) *GetInstanceReqBuild return builder } -// 发起审批用户id，仅自建应用可返回 +// 发起审批用户 id，仅自建应用可返回 // // 示例值：f7cb567e func (builder *GetInstanceReqBuilder) UserId(userId string) *GetInstanceReqBuilder { @@ -10526,7 +10526,7 @@ func (builder *GetInstanceReqBuilder) UserId(userId string) *GetInstanceReqBuild return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：user_id func (builder *GetInstanceReqBuilder) UserIdType(userIdType string) *GetInstanceReqBuilder { @@ -10555,13 +10555,13 @@ type GetInstanceRespData struct { SerialNumber *string `json:"serial_number,omitempty"` // 审批单编号 DepartmentId *string `json:"department_id,omitempty"` // 发起审批用户所在部门 Status *string `json:"status,omitempty"` // 审批实例状态 - Uuid *string `json:"uuid,omitempty"` // 用户的唯一标识id - Form *string `json:"form,omitempty"` // json字符串，控件值详情见下方 + Uuid *string `json:"uuid,omitempty"` // 用户的唯一标识 id + Form *string `json:"form,omitempty"` // json 字符串，控件值详情见下方 TaskList []*InstanceTask `json:"task_list,omitempty"` // 审批任务列表 CommentList []*InstanceComment `json:"comment_list,omitempty"` // 评论列表 Timeline []*InstanceTimeline `json:"timeline,omitempty"` // 审批动态 - ModifiedInstanceCode *string `json:"modified_instance_code,omitempty"` // 修改的原实例 code,仅在查询修改实例时显示该字段 - RevertedInstanceCode *string `json:"reverted_instance_code,omitempty"` // 撤销的原实例 code,仅在查询撤销实例时显示该字段 + ModifiedInstanceCode *string `json:"modified_instance_code,omitempty"` // 修改的原实例 code，仅在查询修改实例时显示该字段 + RevertedInstanceCode *string `json:"reverted_instance_code,omitempty"` // 撤销的原实例 code，仅在查询撤销实例时显示该字段 ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 Code Reverted *bool `json:"reverted,omitempty"` // 单据是否被撤销 InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 Code @@ -10668,19 +10668,19 @@ func (resp *ListInstanceResp) Success() bool { } type PreviewInstanceReqBodyBuilder struct { - userId string // 用户id + userId string // 用户 id userIdFlag bool - approvalCode string // 审批定义code + approvalCode string // 审批定义 code approvalCodeFlag bool - departmentId string // 部门id + departmentId string // 部门 id departmentIdFlag bool form string // 表单数据 formFlag bool - instanceCode string // 审批实例code + instanceCode string // 审批实例 code instanceCodeFlag bool locale string // 语言类型 localeFlag bool - taskId string // 任务id + taskId string // 任务 id taskIdFlag bool } @@ -10689,16 +10689,16 @@ func NewPreviewInstanceReqBodyBuilder() *PreviewInstanceReqBodyBuilder { return builder } -// 用户id +// 用户 id // -//示例值：发起审批用户id，按照user_id_type类型填写 +//示例值：发起审批用户 id，按照 user_id_type 类型填写 func (builder *PreviewInstanceReqBodyBuilder) UserId(userId string) *PreviewInstanceReqBodyBuilder { builder.userId = userId builder.userIdFlag = true return builder } -// 审批定义code +// 审批定义 code // //示例值：C2CAAA90-70D9-3214-906B-B6FFF947F00D func (builder *PreviewInstanceReqBodyBuilder) ApprovalCode(approvalCode string) *PreviewInstanceReqBodyBuilder { @@ -10707,7 +10707,7 @@ func (builder *PreviewInstanceReqBodyBuilder) ApprovalCode(approvalCode string) return builder } -// 部门id +// 部门 id // //示例值：6982332863116876308 func (builder *PreviewInstanceReqBodyBuilder) DepartmentId(departmentId string) *PreviewInstanceReqBodyBuilder { @@ -10725,7 +10725,7 @@ func (builder *PreviewInstanceReqBodyBuilder) Form(form string) *PreviewInstance return builder } -// 审批实例code +// 审批实例 code // //示例值：12345CA6-97AC-32BB-8231-47C33FFFCCFD func (builder *PreviewInstanceReqBodyBuilder) InstanceCode(instanceCode string) *PreviewInstanceReqBodyBuilder { @@ -10743,7 +10743,7 @@ func (builder *PreviewInstanceReqBodyBuilder) Locale(locale string) *PreviewInst return builder } -// 任务id +// 任务 id // //示例值：6982332863116876308 func (builder *PreviewInstanceReqBodyBuilder) TaskId(taskId string) *PreviewInstanceReqBodyBuilder { @@ -10779,19 +10779,19 @@ func (builder *PreviewInstanceReqBodyBuilder) Build() *PreviewInstanceReqBody { } type PreviewInstancePathReqBodyBuilder struct { - userId string // 用户id + userId string // 用户 id userIdFlag bool - approvalCode string // 审批定义code + approvalCode string // 审批定义 code approvalCodeFlag bool - departmentId string // 部门id + departmentId string // 部门 id departmentIdFlag bool form string // 表单数据 formFlag bool - instanceCode string // 审批实例code + instanceCode string // 审批实例 code instanceCodeFlag bool locale string // 语言类型 localeFlag bool - taskId string // 任务id + taskId string // 任务 id taskIdFlag bool } @@ -10800,16 +10800,16 @@ func NewPreviewInstancePathReqBodyBuilder() *PreviewInstancePathReqBodyBuilder { return builder } -// 用户id +// 用户 id // -// 示例值：发起审批用户id，按照user_id_type类型填写 +// 示例值：发起审批用户 id，按照 user_id_type 类型填写 func (builder *PreviewInstancePathReqBodyBuilder) UserId(userId string) *PreviewInstancePathReqBodyBuilder { builder.userId = userId builder.userIdFlag = true return builder } -// 审批定义code +// 审批定义 code // // 示例值：C2CAAA90-70D9-3214-906B-B6FFF947F00D func (builder *PreviewInstancePathReqBodyBuilder) ApprovalCode(approvalCode string) *PreviewInstancePathReqBodyBuilder { @@ -10818,7 +10818,7 @@ func (builder *PreviewInstancePathReqBodyBuilder) ApprovalCode(approvalCode stri return builder } -// 部门id +// 部门 id // // 示例值：6982332863116876308 func (builder *PreviewInstancePathReqBodyBuilder) DepartmentId(departmentId string) *PreviewInstancePathReqBodyBuilder { @@ -10836,7 +10836,7 @@ func (builder *PreviewInstancePathReqBodyBuilder) Form(form string) *PreviewInst return builder } -// 审批实例code +// 审批实例 code // // 示例值：12345CA6-97AC-32BB-8231-47C33FFFCCFD func (builder *PreviewInstancePathReqBodyBuilder) InstanceCode(instanceCode string) *PreviewInstancePathReqBodyBuilder { @@ -10854,7 +10854,7 @@ func (builder *PreviewInstancePathReqBodyBuilder) Locale(locale string) *Preview return builder } -// 任务id +// 任务 id // // 示例值：6982332863116876308 func (builder *PreviewInstancePathReqBodyBuilder) TaskId(taskId string) *PreviewInstancePathReqBodyBuilder { @@ -10903,7 +10903,7 @@ func NewPreviewInstanceReqBuilder() *PreviewInstanceReqBuilder { return builder } -// open_id(ou_开头)，union_id(on_开头)，user_id(字符串)。user_id_type不填默认为open_id +// open_id(ou_开头)，union_id(on_开头)，user_id(字符串)。user_id_type 不填默认为 open_id // // 示例值：open_id func (builder *PreviewInstanceReqBuilder) UserIdType(userIdType string) *PreviewInstanceReqBuilder { @@ -10926,13 +10926,13 @@ func (builder *PreviewInstanceReqBuilder) Build() *PreviewInstanceReq { } type PreviewInstanceReqBody struct { - UserId *string `json:"user_id,omitempty"` // 用户id - ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义code - DepartmentId *string `json:"department_id,omitempty"` // 部门id + UserId *string `json:"user_id,omitempty"` // 用户 id + ApprovalCode *string `json:"approval_code,omitempty"` // 审批定义 code + DepartmentId *string `json:"department_id,omitempty"` // 部门 id Form *string `json:"form,omitempty"` // 表单数据 - InstanceCode *string `json:"instance_code,omitempty"` // 审批实例code + InstanceCode *string `json:"instance_code,omitempty"` // 审批实例 code Locale *string `json:"locale,omitempty"` // 语言类型 - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id } type PreviewInstanceReq struct { @@ -10991,7 +10991,7 @@ func (builder *QueryInstanceReqBuilder) PageToken(pageToken string) *QueryInstan return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *QueryInstanceReqBuilder) UserIdType(userIdType string) *QueryInstanceReqBuilder { @@ -11068,7 +11068,7 @@ func (builder *SearchCcInstanceReqBuilder) PageToken(pageToken string) *SearchCc return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SearchCcInstanceReqBuilder) UserIdType(userIdType string) *SearchCcInstanceReqBuilder { @@ -11126,7 +11126,7 @@ func NewSpecifiedRollbackInstanceReqBuilder() *SpecifiedRollbackInstanceReqBuild return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SpecifiedRollbackInstanceReqBuilder) UserIdType(userIdType string) *SpecifiedRollbackInstanceReqBuilder { @@ -11176,7 +11176,7 @@ func NewCreateInstanceCommentReqBuilder() *CreateInstanceCommentReqBuilder { return builder } -// 审批实例code（或租户自定义审批实例ID） +// 审批实例 code（或租户自定义审批实例 ID） // // 示例值：6A123516-FB88-470D-A428-9AF58B71B3C0 func (builder *CreateInstanceCommentReqBuilder) InstanceId(instanceId string) *CreateInstanceCommentReqBuilder { @@ -11184,7 +11184,7 @@ func (builder *CreateInstanceCommentReqBuilder) InstanceId(instanceId string) *C return builder } -// 用户ID类型，不填默认为open_id +// 用户 ID 类型，不填默认为 open_id // // 示例值：user_id func (builder *CreateInstanceCommentReqBuilder) UserIdType(userIdType string) *CreateInstanceCommentReqBuilder { @@ -11192,7 +11192,7 @@ func (builder *CreateInstanceCommentReqBuilder) UserIdType(userIdType string) *C return builder } -// 用户ID +// 用户 ID // // 示例值：e5286g26 func (builder *CreateInstanceCommentReqBuilder) UserId(userId string) *CreateInstanceCommentReqBuilder { @@ -11221,7 +11221,7 @@ type CreateInstanceCommentReq struct { } type CreateInstanceCommentRespData struct { - CommentId *string `json:"comment_id,omitempty"` // 保存成功的comment_id + CommentId *string `json:"comment_id,omitempty"` // 保存成功的 comment_id } type CreateInstanceCommentResp struct { @@ -11247,7 +11247,7 @@ func NewDeleteInstanceCommentReqBuilder() *DeleteInstanceCommentReqBuilder { return builder } -// 审批实例code（或者租户自定义审批实例ID） +// 审批实例 code（或者租户自定义审批实例 ID） // // 示例值：6A123516-FB88-470D-A428-9AF58B71B3C0 func (builder *DeleteInstanceCommentReqBuilder) InstanceId(instanceId string) *DeleteInstanceCommentReqBuilder { @@ -11255,7 +11255,7 @@ func (builder *DeleteInstanceCommentReqBuilder) InstanceId(instanceId string) *D return builder } -// 评论ID +// 评论 ID // // 示例值：7081516627711606803 func (builder *DeleteInstanceCommentReqBuilder) CommentId(commentId string) *DeleteInstanceCommentReqBuilder { @@ -11263,7 +11263,7 @@ func (builder *DeleteInstanceCommentReqBuilder) CommentId(commentId string) *Del return builder } -// 用户ID类型，不填默认为open_id +// 用户 ID 类型，不填默认为 open_id // // 示例值：user_id func (builder *DeleteInstanceCommentReqBuilder) UserIdType(userIdType string) *DeleteInstanceCommentReqBuilder { @@ -11271,7 +11271,7 @@ func (builder *DeleteInstanceCommentReqBuilder) UserIdType(userIdType string) *D return builder } -// 根据user_id_type填写用户ID +// 根据 user_id_type 填写用户 ID // // 示例值：ou_806a18fb5bdf525e38ba219733bdbd73 func (builder *DeleteInstanceCommentReqBuilder) UserId(userId string) *DeleteInstanceCommentReqBuilder { @@ -11292,7 +11292,7 @@ type DeleteInstanceCommentReq struct { } type DeleteInstanceCommentRespData struct { - CommentId *string `json:"comment_id,omitempty"` // 删除的评论ID + CommentId *string `json:"comment_id,omitempty"` // 删除的评论 ID } type DeleteInstanceCommentResp struct { @@ -11318,7 +11318,7 @@ func NewListInstanceCommentReqBuilder() *ListInstanceCommentReqBuilder { return builder } -// 审批实例code（或者租户自定义审批实例ID） +// 审批实例 code（或者租户自定义审批实例 ID） // // 示例值：6A123516-FB88-470D-A428-9AF58B71B3C0 func (builder *ListInstanceCommentReqBuilder) InstanceId(instanceId string) *ListInstanceCommentReqBuilder { @@ -11326,7 +11326,7 @@ func (builder *ListInstanceCommentReqBuilder) InstanceId(instanceId string) *Lis return builder } -// 用户ID类型，不填默认为open_id +// 用户 ID 类型，不填默认为 open_id // // 示例值：user_id func (builder *ListInstanceCommentReqBuilder) UserIdType(userIdType string) *ListInstanceCommentReqBuilder { @@ -11334,7 +11334,7 @@ func (builder *ListInstanceCommentReqBuilder) UserIdType(userIdType string) *Lis return builder } -// 用户ID +// 用户 ID // // 示例值：e5286g26 func (builder *ListInstanceCommentReqBuilder) UserId(userId string) *ListInstanceCommentReqBuilder { @@ -11397,7 +11397,7 @@ func NewRemoveInstanceCommentReqBuilder() *RemoveInstanceCommentReqBuilder { return builder } -// 审批实例code（或者租户自定义审批实例ID） +// 审批实例 code（或者租户自定义审批实例 ID） // // 示例值：6A123516-FB88-470D-A428-9AF58B71B3C0 func (builder *RemoveInstanceCommentReqBuilder) InstanceId(instanceId string) *RemoveInstanceCommentReqBuilder { @@ -11405,7 +11405,7 @@ func (builder *RemoveInstanceCommentReqBuilder) InstanceId(instanceId string) *R return builder } -// 用户ID类型，不填默认为open_id +// 用户 ID 类型，不填默认为 open_id // // 示例值：user_id func (builder *RemoveInstanceCommentReqBuilder) UserIdType(userIdType string) *RemoveInstanceCommentReqBuilder { @@ -11413,7 +11413,7 @@ func (builder *RemoveInstanceCommentReqBuilder) UserIdType(userIdType string) *R return builder } -// 根据user_id_type填写用户ID +// 根据 user_id_type 填写用户 ID // // 示例值：ou_806a18fb5bdf525e38ba219733bdbd73 func (builder *RemoveInstanceCommentReqBuilder) UserId(userId string) *RemoveInstanceCommentReqBuilder { @@ -11434,8 +11434,8 @@ type RemoveInstanceCommentReq struct { } type RemoveInstanceCommentRespData struct { - InstanceId *string `json:"instance_id,omitempty"` // 审批实例code - ExternalId *string `json:"external_id,omitempty"` // 租户自定义审批实例ID + InstanceId *string `json:"instance_id,omitempty"` // 审批实例 code + ExternalId *string `json:"external_id,omitempty"` // 租户自定义审批实例 ID } type RemoveInstanceCommentResp struct { @@ -11462,7 +11462,7 @@ func NewApproveTaskReqBuilder() *ApproveTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ApproveTaskReqBuilder) UserIdType(userIdType string) *ApproveTaskReqBuilder { @@ -11550,7 +11550,7 @@ func (builder *QueryTaskReqBuilder) Topic(topic string) *QueryTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *QueryTaskReqBuilder) UserIdType(userIdType string) *QueryTaskReqBuilder { @@ -11603,7 +11603,7 @@ func NewRejectTaskReqBuilder() *RejectTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *RejectTaskReqBuilder) UserIdType(userIdType string) *RejectTaskReqBuilder { @@ -11653,7 +11653,7 @@ func NewResubmitTaskReqBuilder() *ResubmitTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ResubmitTaskReqBuilder) UserIdType(userIdType string) *ResubmitTaskReqBuilder { @@ -11719,7 +11719,7 @@ func (builder *SearchTaskReqBuilder) PageToken(pageToken string) *SearchTaskReqB return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SearchTaskReqBuilder) UserIdType(userIdType string) *SearchTaskReqBuilder { @@ -11777,7 +11777,7 @@ func NewTransferTaskReqBuilder() *TransferTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *TransferTaskReqBuilder) UserIdType(userIdType string) *TransferTaskReqBuilder { @@ -11845,7 +11845,7 @@ func (iterator *ListExternalTaskIterator) Next() (bool, *ExternalTaskList, error return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11899,7 +11899,7 @@ func (iterator *ListInstanceIterator) Next() (bool, string, error) { return false, "", nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, "", nil @@ -11953,7 +11953,7 @@ func (iterator *QueryInstanceIterator) Next() (bool, *InstanceSearchItem, error) return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -12007,7 +12007,7 @@ func (iterator *QueryTaskIterator) Next() (bool, *Task, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/attendance/v1/api.go b/service/attendance/v1/api.go index 40f1b26f..3fe9b73d 100644 --- a/service/attendance/v1/api.go +++ b/service/attendance/v1/api.go @@ -102,9 +102,9 @@ type userTaskRemedy struct { // // - 发起状态的审批才可以被更新为通过、不通过，已经通过的审批才可以被更新为撤销。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/process_approvalInfo.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/process_approvalInfo.go func (a *approvalInfo) Process(ctx context.Context, req *ProcessApprovalInfoReq, options ...larkcore.RequestOptionFunc) (*ProcessApprovalInfoResp, error) { // 发起请求 apiReq := req.apiReq @@ -128,9 +128,9 @@ func (a *approvalInfo) Process(ctx context.Context, req *ProcessApprovalInfoReq, // // - 通过文件 ID 下载指定的文件。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/download +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/download // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/download_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/download_file.go func (f *file) Download(ctx context.Context, req *DownloadFileReq, options ...larkcore.RequestOptionFunc) (*DownloadFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -158,11 +158,11 @@ func (f *file) Download(ctx context.Context, req *DownloadFileReq, options ...la // 上传文件 // -// - 上传文件并获取文件 ID，可用于“修改用户设置”接口中的 face_key 参数。 +// - 上传文件并获取文件 ID，可用于 “修改用户设置” 接口中的 face_key 参数。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/upload_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/upload_file.go func (f *file) Upload(ctx context.Context, req *UploadFileReq, options ...larkcore.RequestOptionFunc) (*UploadFileResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -189,9 +189,9 @@ func (f *file) Upload(ctx context.Context, req *UploadFileReq, options ...larkco // // - 出于安全考虑，目前通过该接口只允许修改自己创建的考勤组。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_group.go func (g *group) Create(ctx context.Context, req *CreateGroupReq, options ...larkcore.RequestOptionFunc) (*CreateGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -215,9 +215,9 @@ func (g *group) Create(ctx context.Context, req *CreateGroupReq, options ...lark // // - 通过班次 ID 删除班次。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/delete_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/delete_group.go func (g *group) Delete(ctx context.Context, req *DeleteGroupReq, options ...larkcore.RequestOptionFunc) (*DeleteGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -241,9 +241,9 @@ func (g *group) Delete(ctx context.Context, req *DeleteGroupReq, options ...lark // // - 通过考勤组 ID 获取考勤组详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/get_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/get_group.go func (g *group) Get(ctx context.Context, req *GetGroupReq, options ...larkcore.RequestOptionFunc) (*GetGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -267,9 +267,9 @@ func (g *group) Get(ctx context.Context, req *GetGroupReq, options ...larkcore.R // // - 翻页获取所有考勤组列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/list_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/list_group.go func (g *group) List(ctx context.Context, req *ListGroupReq, options ...larkcore.RequestOptionFunc) (*ListGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -303,9 +303,9 @@ func (g *group) ListByIterator(ctx context.Context, req *ListGroupReq, options . // // - 该接口依赖的数据和考勤组主数据间存在数据同步延时（正常数据同步 2 秒以内），因此在使用该接口时需注意评估数据延迟潜在风险。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/search_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/search_group.go func (g *group) Search(ctx context.Context, req *SearchGroupReq, options ...larkcore.RequestOptionFunc) (*SearchGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -331,9 +331,9 @@ func (g *group) Search(ctx context.Context, req *SearchGroupReq, options ...lark // // - - 创建一个考勤组前，必须先创建一个或者多个班次。;- 一个公司内的班次是共享的，你可以直接引用他人创建的班次，但是需要注意的是，若他人修改了班次，会影响到你的考勤组及其考勤结果。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_shift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_shift.go func (s *shift) Create(ctx context.Context, req *CreateShiftReq, options ...larkcore.RequestOptionFunc) (*CreateShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -357,9 +357,9 @@ func (s *shift) Create(ctx context.Context, req *CreateShiftReq, options ...lark // // - 通过班次 ID 删除班次。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/delete_shift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/delete_shift.go func (s *shift) Delete(ctx context.Context, req *DeleteShiftReq, options ...larkcore.RequestOptionFunc) (*DeleteShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -383,9 +383,9 @@ func (s *shift) Delete(ctx context.Context, req *DeleteShiftReq, options ...lark // // - 通过班次 ID 获取班次详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/get_shift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/get_shift.go func (s *shift) Get(ctx context.Context, req *GetShiftReq, options ...larkcore.RequestOptionFunc) (*GetShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -409,9 +409,9 @@ func (s *shift) Get(ctx context.Context, req *GetShiftReq, options ...larkcore.R // // - 翻页获取所有班次列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/list_shift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/list_shift.go func (s *shift) List(ctx context.Context, req *ListShiftReq, options ...larkcore.RequestOptionFunc) (*ListShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -443,9 +443,9 @@ func (s *shift) ListByIterator(ctx context.Context, req *ListShiftReq, options . // // - 通过班次的名称查询班次信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_shift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_shift.go func (s *shift) Query(ctx context.Context, req *QueryShiftReq, options ...larkcore.RequestOptionFunc) (*QueryShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -469,11 +469,11 @@ func (s *shift) Query(ctx context.Context, req *QueryShiftReq, options ...larkco // // - 由于部分企业使用的是自己的审批系统，而不是飞书审批系统，因此员工的请假、加班等数据无法流入到飞书考勤系统中，导致员工在请假时间段内依然收到打卡提醒，并且被记为缺卡。;;对于这些只使用飞书考勤系统，而未使用飞书审批系统的企业，可以通过考勤开放接口的形式，将三方审批结果数据回写到飞书考勤系统中。 // -// - 目前支持写入加班、请假、出差和外出这四种审批结果，写入只会追加(insert)，不会覆盖(update)（开放接口导入的加班假期记录，在管理后台的假期加班里查不到，只能通过[获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query)来查询） +// - 目前支持写入加班、请假、出差和外出这四种审批结果，写入只会追加 (insert)，不会覆盖 (update)（开放接口导入的加班假期记录，在管理后台的假期加班里查不到，只能通过 [获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query) 来查询） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_userApproval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_userApproval.go func (u *userApproval) Create(ctx context.Context, req *CreateUserApprovalReq, options ...larkcore.RequestOptionFunc) (*CreateUserApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -499,9 +499,9 @@ func (u *userApproval) Create(ctx context.Context, req *CreateUserApprovalReq, o // // - 请假的假期时长字段，暂未开放提供，待后续提供。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userApproval.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userApproval.go func (u *userApproval) Query(ctx context.Context, req *QueryUserApprovalReq, options ...larkcore.RequestOptionFunc) (*QueryUserApprovalResp, error) { // 发起请求 apiReq := req.apiReq @@ -525,9 +525,9 @@ func (u *userApproval) Query(ctx context.Context, req *QueryUserApprovalReq, opt // // - 班表是用来描述考勤组内人员每天按哪个班次进行上班。目前班表支持按一个整月对一位或多位人员进行排班。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/batchCreate_userDailyShift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/batchCreate_userDailyShift.go func (u *userDailyShift) BatchCreate(ctx context.Context, req *BatchCreateUserDailyShiftReq, options ...larkcore.RequestOptionFunc) (*BatchCreateUserDailyShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -551,9 +551,9 @@ func (u *userDailyShift) BatchCreate(ctx context.Context, req *BatchCreateUserDa // // - 支持查询多个用户的排班情况，查询的时间跨度不能超过 30 天。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userDailyShift.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userDailyShift.go func (u *userDailyShift) Query(ctx context.Context, req *QueryUserDailyShiftReq, options ...larkcore.RequestOptionFunc) (*QueryUserDailyShiftResp, error) { // 发起请求 apiReq := req.apiReq @@ -579,9 +579,9 @@ func (u *userDailyShift) Query(ctx context.Context, req *QueryUserDailyShiftReq, // // - 适用于考勤机数据导入等场景。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/batch_create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/batch_create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/batchCreate_userFlow.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/batchCreate_userFlow.go func (u *userFlow) BatchCreate(ctx context.Context, req *BatchCreateUserFlowReq, options ...larkcore.RequestOptionFunc) (*BatchCreateUserFlowResp, error) { // 发起请求 apiReq := req.apiReq @@ -605,9 +605,9 @@ func (u *userFlow) BatchCreate(ctx context.Context, req *BatchCreateUserFlowReq, // // - 通过打卡记录 ID 获取用户的打卡流水记录。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/get_userFlow.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/get_userFlow.go func (u *userFlow) Get(ctx context.Context, req *GetUserFlowReq, options ...larkcore.RequestOptionFunc) (*GetUserFlowResp, error) { // 发起请求 apiReq := req.apiReq @@ -631,11 +631,11 @@ func (u *userFlow) Get(ctx context.Context, req *GetUserFlowReq, options ...lark // // - 批量查询授权内员工的实际打卡流水记录。例如，企业给一个员工设定的班次是上午 9 点和下午 6 点各打一次上下班卡，但是该员工在这期间打了多次卡，该接口会把所有的打卡记录都返回。 // -// - 如果只需获取打卡结果，而不需要详细的打卡数据，可使用“获取打卡结果”的接口。 +// - 如果只需获取打卡结果，而不需要详细的打卡数据，可使用 “获取打卡结果” 的接口。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userFlow.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userFlow.go func (u *userFlow) Query(ctx context.Context, req *QueryUserFlowReq, options ...larkcore.RequestOptionFunc) (*QueryUserFlowResp, error) { // 发起请求 apiReq := req.apiReq @@ -659,9 +659,9 @@ func (u *userFlow) Query(ctx context.Context, req *QueryUserFlowReq, options ... // // - 修改授权内员工的用户设置信息，包括人脸照片文件 ID。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_setting/modify +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_setting/modify // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/modify_userSetting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/modify_userSetting.go func (u *userSetting) Modify(ctx context.Context, req *ModifyUserSettingReq, options ...larkcore.RequestOptionFunc) (*ModifyUserSettingResp, error) { // 发起请求 apiReq := req.apiReq @@ -685,9 +685,9 @@ func (u *userSetting) Modify(ctx context.Context, req *ModifyUserSettingReq, opt // // - 批量查询授权内员工的用户设置信息，包括人脸照片文件 ID、人脸照片更新时间。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_setting/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_setting/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userSetting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userSetting.go func (u *userSetting) Query(ctx context.Context, req *QueryUserSettingReq, options ...larkcore.RequestOptionFunc) (*QueryUserSettingResp, error) { // 发起请求 apiReq := req.apiReq @@ -711,9 +711,9 @@ func (u *userSetting) Query(ctx context.Context, req *QueryUserSettingReq, optio // // - 查询日度统计或月度统计的统计数据。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_data/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_data/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userStatsData.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userStatsData.go func (u *userStatsData) Query(ctx context.Context, req *QueryUserStatsDataReq, options ...larkcore.RequestOptionFunc) (*QueryUserStatsDataResp, error) { // 发起请求 apiReq := req.apiReq @@ -737,9 +737,9 @@ func (u *userStatsData) Query(ctx context.Context, req *QueryUserStatsDataReq, o // // - 查询考勤统计支持的日度统计或月度统计的统计表头。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userStatsField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userStatsField.go func (u *userStatsField) Query(ctx context.Context, req *QueryUserStatsFieldReq, options ...larkcore.RequestOptionFunc) (*QueryUserStatsFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -763,9 +763,9 @@ func (u *userStatsField) Query(ctx context.Context, req *QueryUserStatsFieldReq, // // - 查询开发者定制的日度统计或月度统计的统计报表表头设置信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userStatsView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userStatsView.go func (u *userStatsView) Query(ctx context.Context, req *QueryUserStatsViewReq, options ...larkcore.RequestOptionFunc) (*QueryUserStatsViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -789,9 +789,9 @@ func (u *userStatsView) Query(ctx context.Context, req *QueryUserStatsViewReq, o // // - 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/update_userStatsView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/update_userStatsView.go func (u *userStatsView) Update(ctx context.Context, req *UpdateUserStatsViewReq, options ...larkcore.RequestOptionFunc) (*UpdateUserStatsViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -815,11 +815,11 @@ func (u *userStatsView) Update(ctx context.Context, req *UpdateUserStatsViewReq, // // - 获取企业内员工的实际打卡结果，包括上班打卡结果和下班打卡结果。 // -// - - 如果企业给一个员工设定的班次是上午 9 点和下午 6 点各打一次上下班卡，即使员工在这期间打了多次卡，该接口也只会返回 1 条记录。;- 如果要获取打卡的详细数据，如打卡位置等信息，可使用“获取打卡流水记录”或“批量查询打卡流水记录”的接口。 +// - - 如果企业给一个员工设定的班次是上午 9 点和下午 6 点各打一次上下班卡，即使员工在这期间打了多次卡，该接口也只会返回 1 条记录。;- 如果要获取打卡的详细数据，如打卡位置等信息，可使用 “获取打卡流水记录” 或 “批量查询打卡流水记录” 的接口。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userTask.go func (u *userTask) Query(ctx context.Context, req *QueryUserTaskReq, options ...larkcore.RequestOptionFunc) (*QueryUserTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -841,11 +841,11 @@ func (u *userTask) Query(ctx context.Context, req *QueryUserTaskReq, options ... // 通知补卡审批发起 // -// - 对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口，将在三方审批系统中发起的补卡审批数据，写入到飞书考勤系统中，状态为审批中。写入后可以由[通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process) 进行状态更新 +// - 对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口，将在三方审批系统中发起的补卡审批数据，写入到飞书考勤系统中，状态为审批中。写入后可以由 [通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process) 进行状态更新 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_userTaskRemedy.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/create_userTaskRemedy.go func (u *userTaskRemedy) Create(ctx context.Context, req *CreateUserTaskRemedyReq, options ...larkcore.RequestOptionFunc) (*CreateUserTaskRemedyResp, error) { // 发起请求 apiReq := req.apiReq @@ -869,9 +869,9 @@ func (u *userTaskRemedy) Create(ctx context.Context, req *CreateUserTaskRemedyRe // // - 获取授权内员工的补卡记录。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userTaskRemedy.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/query_userTaskRemedy.go func (u *userTaskRemedy) Query(ctx context.Context, req *QueryUserTaskRemedyReq, options ...larkcore.RequestOptionFunc) (*QueryUserTaskRemedyResp, error) { // 发起请求 apiReq := req.apiReq @@ -895,9 +895,9 @@ func (u *userTaskRemedy) Query(ctx context.Context, req *QueryUserTaskRemedyReq, // // - 获取用户某天可以补的第几次上 / 下班卡的时间。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/query_user_allowed_remedys +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/query_user_allowed_remedys // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/queryUserAllowedRemedys_userTaskRemedy.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/attendancev1/queryUserAllowedRemedys_userTaskRemedy.go func (u *userTaskRemedy) QueryUserAllowedRemedys(ctx context.Context, req *QueryUserAllowedRemedysUserTaskRemedyReq, options ...larkcore.RequestOptionFunc) (*QueryUserAllowedRemedysUserTaskRemedyResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/attendance/v1/model.go b/service/attendance/v1/model.go index 6abf2eb0..bf025a6d 100644 --- a/service/attendance/v1/model.go +++ b/service/attendance/v1/model.go @@ -29,30 +29,30 @@ import ( ) const ( - EmployeeTypeEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeEmployeeNo = "employee_no" // 员工工号 ) const ( - DeptTypeOpenId = "open_id" // 开放openID + DeptTypeOpenId = "open_id" // 开放 openID ) const ( - EmployeeTypeGetGroupEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeGetGroupEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeGetGroupEmployeeNo = "employee_no" // 员工工号 ) const ( - DeptTypeGetGroupOpenId = "open_id" // 开放openID + DeptTypeGetGroupOpenId = "open_id" // 开放 openID ) const ( - EmployeeTypeCreateUserApprovalEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeCreateUserApprovalEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeCreateUserApprovalEmployeeNo = "employee_no" // 员工工号 ) const ( - CheckDateTypePeriodTime = "PeriodTime" // 单据作用时间（即写入的end_time） + CheckDateTypePeriodTime = "PeriodTime" // 单据作用时间（即写入的 end_time） CheckDateTypeCreateTime = "CreateTime" // 单据创建时间 CheckDateTypeUpdateTime = "UpdateTime" // 单据状态更新时间 ) @@ -67,43 +67,43 @@ const ( ) const ( - EmployeeTypeQueryUserApprovalEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserApprovalEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserApprovalEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeBatchCreateUserDailyShiftEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeBatchCreateUserDailyShiftEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeBatchCreateUserDailyShiftEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeQueryUserDailyShiftEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserDailyShiftEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserDailyShiftEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeBatchCreateUserFlowEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeBatchCreateUserFlowEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeBatchCreateUserFlowEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeGetUserFlowOpenId = "open_id" // 开放openID - EmployeeTypeGetUserFlowEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeGetUserFlowOpenId = "open_id" // 开放 openID + EmployeeTypeGetUserFlowEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeGetUserFlowEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeQueryUserFlowEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserFlowEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserFlowEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeModifyUserSettingEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeModifyUserSettingEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeModifyUserSettingEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeQueryUserSettingEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserSettingEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserSettingEmployeeNo = "employee_no" // 员工工号 ) @@ -119,7 +119,7 @@ const ( ) const ( - EmployeeTypeQueryUserStatsDataEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserStatsDataEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserStatsDataEmployeeNo = "employee_no" // 员工工号 ) @@ -135,7 +135,7 @@ const ( ) const ( - EmployeeTypeQueryUserStatsFieldEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserStatsFieldEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserStatsFieldEmployeeNo = "employee_no" // 员工工号 ) @@ -151,27 +151,27 @@ const ( ) const ( - EmployeeTypeQueryUserStatsViewEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserStatsViewEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserStatsViewEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeUpdateUserStatsViewEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeUpdateUserStatsViewEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeUpdateUserStatsViewEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeQueryUserTaskEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserTaskEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserTaskEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeCreateUserTaskRemedyEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeCreateUserTaskRemedyEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeCreateUserTaskRemedyEmployeeNo = "employee_no" // 员工工号 ) const ( - CheckDateTypeQueryUserTaskRemedyPeriodTime = "PeriodTime" // 单据作用时间（即remedy_time） + CheckDateTypeQueryUserTaskRemedyPeriodTime = "PeriodTime" // 单据作用时间（即 remedy_time） CheckDateTypeQueryUserTaskRemedyCreateTime = "CreateTime" // 单据创建时间 CheckDateTypeQueryUserTaskRemedyUpdateTime = "UpdateTime" // 单据状态更新时间 ) @@ -186,12 +186,12 @@ const ( ) const ( - EmployeeTypeQueryUserTaskRemedyEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserTaskRemedyEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserTaskRemedyEmployeeNo = "employee_no" // 员工工号 ) const ( - EmployeeTypeQueryUserAllowedRemedysUserTaskRemedyEmployeeId = "employee_id" // 员工employeeId + EmployeeTypeQueryUserAllowedRemedysUserTaskRemedyEmployeeId = "employee_id" // 员工 employeeId EmployeeTypeQueryUserAllowedRemedysUserTaskRemedyEmployeeNo = "employee_no" // 员工工号 ) @@ -403,7 +403,7 @@ func (builder *ChildFieldBuilder) Build() *ChildField { type ChildItem struct { Code *string `json:"code,omitempty"` // 子标题编号 - Value *string `json:"value,omitempty"` // 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为1-6） + Value *string `json:"value,omitempty"` // 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为 1-6） Title *string `json:"title,omitempty"` // 子标题名称 ColumnType *int `json:"column_type,omitempty"` // 列类型 ReadOnly *bool `json:"read_only,omitempty"` // 是否只读 @@ -414,7 +414,7 @@ type ChildItem struct { type ChildItemBuilder struct { code string // 子标题编号 codeFlag bool - value string // 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为1-6） + value string // 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为 1-6） valueFlag bool title string // 子标题名称 titleFlag bool @@ -442,7 +442,7 @@ func (builder *ChildItemBuilder) Code(code string) *ChildItemBuilder { return builder } -// 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为1-6） +// 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为 1-6） // // 示例值：0 func (builder *ChildItemBuilder) Value(value string) *ChildItemBuilder { @@ -817,7 +817,7 @@ func (builder *FreePunchCfgBuilder) Build() *FreePunchCfg { } type Group struct { - GroupId *string `json:"group_id,omitempty"` // 考勤组 ID（仅修改时提供）， 需要从“获取打卡结果”的接口中获取 groupId + GroupId *string `json:"group_id,omitempty"` // 考勤组 ID（仅修改时提供）， 需要从 “获取打卡结果” 的接口中获取 groupId GroupName *string `json:"group_name,omitempty"` // 考勤组名称 TimeZone *string `json:"time_zone,omitempty"` // 时区 BindDeptIds []string `json:"bind_dept_ids,omitempty"` // 绑定的部门 ID @@ -870,7 +870,7 @@ type Group struct { } type GroupBuilder struct { - groupId string // 考勤组 ID（仅修改时提供）， 需要从“获取打卡结果”的接口中获取 groupId + groupId string // 考勤组 ID（仅修改时提供）， 需要从 “获取打卡结果” 的接口中获取 groupId groupIdFlag bool groupName string // 考勤组名称 groupNameFlag bool @@ -977,7 +977,7 @@ func NewGroupBuilder() *GroupBuilder { return builder } -// 考勤组 ID（仅修改时提供）， 需要从“获取打卡结果”的接口中获取 groupId +// 考勤组 ID（仅修改时提供）， 需要从 “获取打卡结果” 的接口中获取 groupId // // 示例值：6919358128597097404 func (builder *GroupBuilder) GroupId(groupId string) *GroupBuilder { @@ -1648,7 +1648,7 @@ func (builder *GroupMetaBuilder) GroupId(groupId string) *GroupMetaBuilder { // 考勤组名称 // -// 示例值：考勤组1 +// 示例值：考勤组 1 func (builder *GroupMetaBuilder) GroupName(groupName string) *GroupMetaBuilder { builder.groupName = groupName builder.groupNameFlag = true @@ -2130,33 +2130,33 @@ func (builder *LocationInfoEventBuilder) Build() *LocationInfoEvent { } type LocationRecord struct { - UserId *UserId `json:"user_id,omitempty"` // 用户id + UserId *UserId `json:"user_id,omitempty"` // 用户 id Timestamp *string `json:"timestamp,omitempty"` // 时间点 Location *LocationInfoEvent `json:"location,omitempty"` // 位置信息 - Wifi *WifiInfoEvent `json:"wifi,omitempty"` // wifi信息 - RuleSnapshotId *string `json:"rule_snapshot_id,omitempty"` // 规则快照id + Wifi *WifiInfoEvent `json:"wifi,omitempty"` // wifi 信息 + RuleSnapshotId *string `json:"rule_snapshot_id,omitempty"` // 规则快照 id Type *string `json:"type,omitempty"` // 事件类型 - ScanWifiList []*ScanWifiInfo `json:"scan_wifi_list,omitempty"` // 附近的wifi设备列表 - DeviceId *string `json:"device_id,omitempty"` // 上报事件的设备ID + ScanWifiList []*ScanWifiInfo `json:"scan_wifi_list,omitempty"` // 附近的 wifi 设备列表 + DeviceId *string `json:"device_id,omitempty"` // 上报事件的设备 ID ClientInfo *string `json:"client_info,omitempty"` // } type LocationRecordBuilder struct { - userId *UserId // 用户id + userId *UserId // 用户 id userIdFlag bool timestamp string // 时间点 timestampFlag bool location *LocationInfoEvent // 位置信息 locationFlag bool - wifi *WifiInfoEvent // wifi信息 + wifi *WifiInfoEvent // wifi 信息 wifiFlag bool - ruleSnapshotId string // 规则快照id + ruleSnapshotId string // 规则快照 id ruleSnapshotIdFlag bool type_ string // 事件类型 typeFlag bool - scanWifiList []*ScanWifiInfo // 附近的wifi设备列表 + scanWifiList []*ScanWifiInfo // 附近的 wifi 设备列表 scanWifiListFlag bool - deviceId string // 上报事件的设备ID + deviceId string // 上报事件的设备 ID deviceIdFlag bool clientInfo string // clientInfoFlag bool @@ -2167,7 +2167,7 @@ func NewLocationRecordBuilder() *LocationRecordBuilder { return builder } -// 用户id +// 用户 id // // 示例值： func (builder *LocationRecordBuilder) UserId(userId *UserId) *LocationRecordBuilder { @@ -2194,7 +2194,7 @@ func (builder *LocationRecordBuilder) Location(location *LocationInfoEvent) *Loc return builder } -// wifi信息 +// wifi 信息 // // 示例值： func (builder *LocationRecordBuilder) Wifi(wifi *WifiInfoEvent) *LocationRecordBuilder { @@ -2203,7 +2203,7 @@ func (builder *LocationRecordBuilder) Wifi(wifi *WifiInfoEvent) *LocationRecordB return builder } -// 规则快照id +// 规则快照 id // // 示例值： func (builder *LocationRecordBuilder) RuleSnapshotId(ruleSnapshotId string) *LocationRecordBuilder { @@ -2221,7 +2221,7 @@ func (builder *LocationRecordBuilder) Type(type_ string) *LocationRecordBuilder return builder } -// 附近的wifi设备列表 +// 附近的 wifi 设备列表 // // 示例值： func (builder *LocationRecordBuilder) ScanWifiList(scanWifiList []*ScanWifiInfo) *LocationRecordBuilder { @@ -2230,7 +2230,7 @@ func (builder *LocationRecordBuilder) ScanWifiList(scanWifiList []*ScanWifiInfo) return builder } -// 上报事件的设备ID +// 上报事件的设备 ID // // 示例值： func (builder *LocationRecordBuilder) DeviceId(deviceId string) *LocationRecordBuilder { @@ -2287,14 +2287,14 @@ func (builder *LocationRecordBuilder) Build() *LocationRecord { type LocationSetting struct { Location *LocationInfo `json:"location,omitempty"` // 位置配置 - Wifi *WifiInfo `json:"wifi,omitempty"` // wifi配置 + Wifi *WifiInfo `json:"wifi,omitempty"` // wifi 配置 UserId *string `json:"user_id,omitempty"` // } type LocationSettingBuilder struct { location *LocationInfo // 位置配置 locationFlag bool - wifi *WifiInfo // wifi配置 + wifi *WifiInfo // wifi 配置 wifiFlag bool userId string // userIdFlag bool @@ -2314,7 +2314,7 @@ func (builder *LocationSettingBuilder) Location(location *LocationInfo) *Locatio return builder } -// wifi配置 +// wifi 配置 // // 示例值： func (builder *LocationSettingBuilder) Wifi(wifi *WifiInfo) *LocationSettingBuilder { @@ -2492,7 +2492,7 @@ func (builder *PunchTimeRuleBuilder) OnTime(onTime string) *PunchTimeRuleBuilder // 下班时间 // -// 示例值：18:00， 第二天凌晨2点， 26:00 +// 示例值：18:00， 第二天凌晨 2 点， 26:00 func (builder *PunchTimeRuleBuilder) OffTime(offTime string) *PunchTimeRuleBuilder { builder.offTime = offTime builder.offTimeFlag = true @@ -2751,7 +2751,7 @@ type Shift struct { ShiftName *string `json:"shift_name,omitempty"` // 班次名称 PunchTimes *int `json:"punch_times,omitempty"` // 打卡次数 IsFlexible *bool `json:"is_flexible,omitempty"` // 是否弹性打卡 - FlexibleMinutes *int `json:"flexible_minutes,omitempty"` // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置flexible_rule则生效 + FlexibleMinutes *int `json:"flexible_minutes,omitempty"` // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置 flexible_rule 则生效 FlexibleRule []*FlexibleRule `json:"flexible_rule,omitempty"` // 弹性打卡时间设置 NoNeedOff *bool `json:"no_need_off,omitempty"` // 不需要打下班卡 PunchTimeRule []*PunchTimeRule `json:"punch_time_rule,omitempty"` // 打卡规则 @@ -2768,7 +2768,7 @@ type ShiftBuilder struct { punchTimesFlag bool isFlexible bool // 是否弹性打卡 isFlexibleFlag bool - flexibleMinutes int // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置flexible_rule则生效 + flexibleMinutes int // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置 flexible_rule 则生效 flexibleMinutesFlag bool flexibleRule []*FlexibleRule // 弹性打卡时间设置 flexibleRuleFlag bool @@ -2823,7 +2823,7 @@ func (builder *ShiftBuilder) IsFlexible(isFlexible bool) *ShiftBuilder { return builder } -// 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置flexible_rule则生效 +// 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置 flexible_rule 则生效 // // 示例值：60 func (builder *ShiftBuilder) FlexibleMinutes(flexibleMinutes int) *ShiftBuilder { @@ -3371,7 +3371,7 @@ type UserApproval struct { Leaves []*UserLeave `json:"leaves,omitempty"` // 请假信息 OvertimeWorks []*UserOvertimeWork `json:"overtime_works,omitempty"` // 加班信息 Trips []*UserTrip `json:"trips,omitempty"` // 出差信息 - TimeZone *string `json:"time_zone,omitempty"` // 计算时间所用的时区信息，为空是0时区 + TimeZone *string `json:"time_zone,omitempty"` // 计算时间所用的时区信息，为空是 0 时区 } type UserApprovalBuilder struct { @@ -3387,7 +3387,7 @@ type UserApprovalBuilder struct { overtimeWorksFlag bool trips []*UserTrip // 出差信息 tripsFlag bool - timeZone string // 计算时间所用的时区信息，为空是0时区 + timeZone string // 计算时间所用的时区信息，为空是 0 时区 timeZoneFlag bool } @@ -3450,7 +3450,7 @@ func (builder *UserApprovalBuilder) Trips(trips []*UserTrip) *UserApprovalBuilde return builder } -// 计算时间所用的时区信息，为空是0时区 +// 计算时间所用的时区信息，为空是 0 时区 // // 示例值：Asia/Shanghai func (builder *UserApprovalBuilder) TimeZone(timeZone string) *UserApprovalBuilder { @@ -3730,7 +3730,7 @@ func (builder *UserFlowBuilder) IsWifi(isWifi bool) *UserFlowBuilder { // 记录生成方式 // -// 示例值：在开放平台调用时，此参数无效，内部值始终是7 +// 示例值：在开放平台调用时，此参数无效，内部值始终是 7 func (builder *UserFlowBuilder) Type(type_ int) *UserFlowBuilder { builder.type_ = type_ builder.typeFlag = true @@ -4548,7 +4548,7 @@ func (builder *UserStatsDataCellBuilder) Code(code string) *UserStatsDataCellBui // 数据值 // -// 示例值：无需打卡(-), 无需打卡(-) +// 示例值：无需打卡 (-)，无需打卡 (-) func (builder *UserStatsDataCellBuilder) Value(value string) *UserStatsDataCellBuilder { builder.value = value builder.valueFlag = true @@ -4707,7 +4707,7 @@ func (builder *UserStatsFieldBuilder) Build() *UserStatsField { type UserStatsView struct { ViewId *string `json:"view_id,omitempty"` // 视图 ID StatsType *string `json:"stats_type,omitempty"` // 视图类型 - UserId *string `json:"user_id,omitempty"` // 查询用户id，同【查询统计数据】、【查询统计设置】user_id + UserId *string `json:"user_id,omitempty"` // 查询用户 id，同【查询统计数据】、【查询统计设置】user_id Items []*Item `json:"items,omitempty"` // 用户设置字段 } @@ -4716,7 +4716,7 @@ type UserStatsViewBuilder struct { viewIdFlag bool statsType string // 视图类型 statsTypeFlag bool - userId string // 查询用户id，同【查询统计数据】、【查询统计设置】user_id + userId string // 查询用户 id，同【查询统计数据】、【查询统计设置】user_id userIdFlag bool items []*Item // 用户设置字段 itemsFlag bool @@ -4745,7 +4745,7 @@ func (builder *UserStatsViewBuilder) StatsType(statsType string) *UserStatsViewB return builder } -// 查询用户id，同【查询统计数据】、【查询统计设置】user_id +// 查询用户 id，同【查询统计数据】、【查询统计设置】user_id // // 示例值：ec8ddg56 func (builder *UserStatsViewBuilder) UserId(userId string) *UserStatsViewBuilder { @@ -5640,7 +5640,7 @@ func (builder *UploadFileReqBuilder) FileName(fileName string) *UploadFileReqBui return builder } -// 上传文件并获取文件 ID，可用于“修改用户设置”接口中的 face_key 参数。 +// 上传文件并获取文件 ID，可用于 “修改用户设置” 接口中的 face_key 参数。 func (builder *UploadFileReqBuilder) Body(body *UploadFileReqBody) *UploadFileReqBuilder { builder.body = body return builder @@ -5680,7 +5680,7 @@ func (resp *UploadFileResp) Success() bool { type CreateGroupReqBodyBuilder struct { group *Group // 6921319402260496386 groupFlag bool - operatorId string // 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 + operatorId string // 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 operatorIdFlag bool } @@ -5698,7 +5698,7 @@ func (builder *CreateGroupReqBodyBuilder) Group(group *Group) *CreateGroupReqBod return builder } -// 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 +// 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 // //示例值：dd31248a func (builder *CreateGroupReqBodyBuilder) OperatorId(operatorId string) *CreateGroupReqBodyBuilder { @@ -5721,7 +5721,7 @@ func (builder *CreateGroupReqBodyBuilder) Build() *CreateGroupReqBody { type CreateGroupPathReqBodyBuilder struct { group *Group // 6921319402260496386 groupFlag bool - operatorId string // 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 + operatorId string // 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 operatorIdFlag bool } @@ -5739,7 +5739,7 @@ func (builder *CreateGroupPathReqBodyBuilder) Group(group *Group) *CreateGroupPa return builder } -// 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 +// 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 // // 示例值：dd31248a func (builder *CreateGroupPathReqBodyBuilder) OperatorId(operatorId string) *CreateGroupPathReqBodyBuilder { @@ -5805,7 +5805,7 @@ func (builder *CreateGroupReqBuilder) Build() *CreateGroupReq { type CreateGroupReqBody struct { Group *Group `json:"group,omitempty"` // 6921319402260496386 - OperatorId *string `json:"operator_id,omitempty"` // 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 + OperatorId *string `json:"operator_id,omitempty"` // 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 } type CreateGroupReq struct { @@ -5918,7 +5918,7 @@ type GetGroupReq struct { } type GetGroupRespData struct { - GroupId *string `json:"group_id,omitempty"` // 考勤组的Id， 需要从获取用户打卡结果信息的接口中获取groupId，修改考勤组时必填 + GroupId *string `json:"group_id,omitempty"` // 考勤组的 Id， 需要从获取用户打卡结果信息的接口中获取 groupId，修改考勤组时必填 GroupName *string `json:"group_name,omitempty"` // 考勤组名称 TimeZone *string `json:"time_zone,omitempty"` // 考勤组时区 BindDeptIds []string `json:"bind_dept_ids,omitempty"` // @@ -5932,12 +5932,12 @@ type GetGroupRespData struct { OutPunchNeedRemark *bool `json:"out_punch_need_remark,omitempty"` // 外勤打卡需填写备注（需要允许外勤打卡才能设置生效） OutPunchNeedPhoto *bool `json:"out_punch_need_photo,omitempty"` // 外勤打卡需拍照（需要允许外勤打卡才能设置生效） OutPunchAllowedHideAddr *bool `json:"out_punch_allowed_hide_addr,omitempty"` // 外勤打卡允许员工隐藏详细地址（需要允许外勤打卡才能设置生效） - AllowPcPunch *bool `json:"allow_pc_punch,omitempty"` // 是否允许pc打卡 + AllowPcPunch *bool `json:"allow_pc_punch,omitempty"` // 是否允许 pc 打卡 AllowRemedy *bool `json:"allow_remedy,omitempty"` // 是否允许补卡 RemedyLimit *bool `json:"remedy_limit,omitempty"` // 补卡次数是否限制（需要允许补卡才能设置生效） RemedyLimitCount *int `json:"remedy_limit_count,omitempty"` // 补卡次数（需要允许补卡才能设置生效） RemedyDateLimit *bool `json:"remedy_date_limit,omitempty"` // 补卡时间是否限制（需要允许补卡才能设置生效） - RemedyDateNum *int `json:"remedy_date_num,omitempty"` // 补卡时间,几天内可以发起补卡（需要允许补卡才能设置生效） + RemedyDateNum *int `json:"remedy_date_num,omitempty"` // 补卡时间，几天内可以发起补卡（需要允许补卡才能设置生效） AllowRemedyTypeLack *bool `json:"allow_remedy_type_lack,omitempty"` // 允许缺卡补卡（需要允许补卡才能设置生效） AllowRemedyTypeLate *bool `json:"allow_remedy_type_late,omitempty"` // 允许迟到补卡（需要允许补卡才能设置生效） AllowRemedyTypeEarly *bool `json:"allow_remedy_type_early,omitempty"` // 允许早退补卡（需要允许补卡才能设置生效） @@ -5950,18 +5950,18 @@ type GetGroupRespData struct { FaceDowngrade *bool `json:"face_downgrade,omitempty"` // 脸识别失败时允许普通拍照打卡 ReplaceBasicPic *bool `json:"replace_basic_pic,omitempty"` // 是否允许替换基准图片 Machines []*Machine `json:"machines,omitempty"` // - GpsRange *int `json:"gps_range,omitempty"` // GPS打卡的地址范围 + GpsRange *int `json:"gps_range,omitempty"` // GPS 打卡的地址范围 Locations []*Location `json:"locations,omitempty"` // GroupType *int `json:"group_type,omitempty"` // 考勤类型 0：固定考勤 2：排班考勤， 3：自由班次 PunchDayShiftIds []string `json:"punch_day_shift_ids,omitempty"` // 固定班次必需填 FreePunchCfg *FreePunchCfg `json:"free_punch_cfg,omitempty"` // - CalendarId *int `json:"calendar_id,omitempty"` // 国家日历 id，（0：不根据国家日历休息, 1：中国，2：美国，3：日本，4：印度，5：新加坡），默认 1 + CalendarId *int `json:"calendar_id,omitempty"` // 国家日历 id，（0：不根据国家日历休息，1：中国，2：美国，3：日本，4：印度，5：新加坡），默认 1 NeedPunchSpecialDays []*PunchSpecialDateShift `json:"need_punch_special_days,omitempty"` // 强制需要打卡的日期 NoNeedPunchSpecialDays []*PunchSpecialDateShift `json:"no_need_punch_special_days,omitempty"` // 强制不需要打卡的日期 WorkDayNoPunchAsLack *bool `json:"work_day_no_punch_as_lack,omitempty"` // 自由班次下工作日不打卡是否记为缺卡 RemedyPeriodType *int `json:"remedy_period_type,omitempty"` // 补卡周期类型 RemedyPeriodCustomDate *int `json:"remedy_period_custom_date,omitempty"` // 补卡自定义周期起始日期 - PunchType *int `json:"punch_type,omitempty"` // 打卡类型，位运算。1:GPS打卡；2:wifi打卡；4:考勤机打卡；8:IP打卡 + PunchType *int `json:"punch_type,omitempty"` // 打卡类型，位运算。1:GPS 打卡；2:wifi 打卡；4:考勤机打卡；8:IP 打卡 EffectTime *string `json:"effect_time,omitempty"` // 生效时间，精确到秒的时间戳 FixshiftEffectTime *string `json:"fixshift_effect_time,omitempty"` // 固定班次生效时间，精确到秒的时间戳 MemberEffectTime *string `json:"member_effect_time,omitempty"` // 参加考勤的人员、部门变动生效时间，精确到秒的时间戳 @@ -6057,7 +6057,7 @@ func NewSearchGroupReqBodyBuilder() *SearchGroupReqBodyBuilder { // 考勤组名称 // -//示例值：考勤组1 +//示例值：考勤组 1 func (builder *SearchGroupReqBodyBuilder) GroupName(groupName string) *SearchGroupReqBodyBuilder { builder.groupName = groupName builder.groupNameFlag = true @@ -6075,7 +6075,7 @@ func (builder *SearchGroupReqBodyBuilder) Build() *SearchGroupReqBody { type SearchGroupPathReqBodyBuilder struct { groupName string // 考勤组名称 groupNameFlag bool - exactlyMatched bool // 是否精准匹配，默认为false:模糊匹配; true:精准匹配 + exactlyMatched bool // 是否精准匹配，默认为 false:模糊匹配; true:精准匹配 exactlyMatchedFlag bool } @@ -6086,7 +6086,7 @@ func NewSearchGroupPathReqBodyBuilder() *SearchGroupPathReqBodyBuilder { // 考勤组名称 // -// 示例值：考勤组1 +// 示例值：考勤组 1 func (builder *SearchGroupPathReqBodyBuilder) GroupName(groupName string) *SearchGroupPathReqBodyBuilder { builder.groupName = groupName builder.groupNameFlag = true @@ -6272,11 +6272,11 @@ type GetShiftReq struct { } type GetShiftRespData struct { - ShiftId *string `json:"shift_id,omitempty"` // 班次Id + ShiftId *string `json:"shift_id,omitempty"` // 班次 Id ShiftName *string `json:"shift_name,omitempty"` // 班次名称 PunchTimes *int `json:"punch_times,omitempty"` // 打卡次数 IsFlexible *bool `json:"is_flexible,omitempty"` // 是否弹性打卡 - FlexibleMinutes *int `json:"flexible_minutes,omitempty"` // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置flexible_rule则生效 + FlexibleMinutes *int `json:"flexible_minutes,omitempty"` // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置 flexible_rule 则生效 FlexibleRule []*FlexibleRule `json:"flexible_rule,omitempty"` // 弹性打卡时间设置 NoNeedOff *bool `json:"no_need_off,omitempty"` // 不需要打下班卡 PunchTimeRule []*PunchTimeRule `json:"punch_time_rule,omitempty"` // 打卡规则 @@ -6393,11 +6393,11 @@ type QueryShiftReq struct { } type QueryShiftRespData struct { - ShiftId *string `json:"shift_id,omitempty"` // 班次Id + ShiftId *string `json:"shift_id,omitempty"` // 班次 Id ShiftName *string `json:"shift_name,omitempty"` // 班次名称 PunchTimes *int `json:"punch_times,omitempty"` // 打卡次数 IsFlexible *bool `json:"is_flexible,omitempty"` // 是否弹性打卡 - FlexibleMinutes *int `json:"flexible_minutes,omitempty"` // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置flexible_rule则生效 + FlexibleMinutes *int `json:"flexible_minutes,omitempty"` // 弹性打卡时间，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置 flexible_rule 则生效 FlexibleRule []*FlexibleRule `json:"flexible_rule,omitempty"` // 弹性打卡时间设置 NoNeedOff *bool `json:"no_need_off,omitempty"` // 不需要打下班卡 PunchTimeRule []*PunchTimeRule `json:"punch_time_rule,omitempty"` // 打卡规则 @@ -6535,7 +6535,7 @@ type QueryUserApprovalReqBodyBuilder struct { checkDateFromFlag bool checkDateTo int // 查询的结束工作日，与 check_date_from 的时间间隔不超过 30 天 checkDateToFlag bool - checkDateType string // 查询依据的时间类型（不填默认依据PeriodTime） + checkDateType string // 查询依据的时间类型（不填默认依据 PeriodTime） checkDateTypeFlag bool status int // 查询状态（不填默认查询已通过状态） statusFlag bool @@ -6577,7 +6577,7 @@ func (builder *QueryUserApprovalReqBodyBuilder) CheckDateTo(checkDateTo int) *Qu return builder } -// 查询依据的时间类型（不填默认依据PeriodTime） +// 查询依据的时间类型（不填默认依据 PeriodTime） // //示例值：PeriodTime func (builder *QueryUserApprovalReqBodyBuilder) CheckDateType(checkDateType string) *QueryUserApprovalReqBodyBuilder { @@ -6646,7 +6646,7 @@ type QueryUserApprovalPathReqBodyBuilder struct { checkDateFromFlag bool checkDateTo int // 查询的结束工作日，与 check_date_from 的时间间隔不超过 30 天 checkDateToFlag bool - checkDateType string // 查询依据的时间类型（不填默认依据PeriodTime） + checkDateType string // 查询依据的时间类型（不填默认依据 PeriodTime） checkDateTypeFlag bool status int // 查询状态（不填默认查询已通过状态） statusFlag bool @@ -6688,7 +6688,7 @@ func (builder *QueryUserApprovalPathReqBodyBuilder) CheckDateTo(checkDateTo int) return builder } -// 查询依据的时间类型（不填默认依据PeriodTime） +// 查询依据的时间类型（不填默认依据 PeriodTime） // // 示例值：PeriodTime func (builder *QueryUserApprovalPathReqBodyBuilder) CheckDateType(checkDateType string) *QueryUserApprovalPathReqBodyBuilder { @@ -6790,7 +6790,7 @@ type QueryUserApprovalReqBody struct { UserIds []string `json:"user_ids,omitempty"` // employee_no 或 employee_id 列表 CheckDateFrom *int `json:"check_date_from,omitempty"` // 查询的起始工作日 CheckDateTo *int `json:"check_date_to,omitempty"` // 查询的结束工作日，与 check_date_from 的时间间隔不超过 30 天 - CheckDateType *string `json:"check_date_type,omitempty"` // 查询依据的时间类型（不填默认依据PeriodTime） + CheckDateType *string `json:"check_date_type,omitempty"` // 查询依据的时间类型（不填默认依据 PeriodTime） Status *int `json:"status,omitempty"` // 查询状态（不填默认查询已通过状态） CheckTimeFrom *string `json:"check_time_from,omitempty"` // 查询的起始时间，精确到秒的时间戳 CheckTimeTo *string `json:"check_time_to,omitempty"` // 查询的结束时间，精确到秒的时间戳 @@ -6816,9 +6816,9 @@ func (resp *QueryUserApprovalResp) Success() bool { } type BatchCreateUserDailyShiftReqBodyBuilder struct { - userDailyShifts []*UserDailyShift // 班表信息列表（数量限制50以内） + userDailyShifts []*UserDailyShift // 班表信息列表（数量限制 50 以内） userDailyShiftsFlag bool - operatorId string // 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 + operatorId string // 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 operatorIdFlag bool } @@ -6827,7 +6827,7 @@ func NewBatchCreateUserDailyShiftReqBodyBuilder() *BatchCreateUserDailyShiftReqB return builder } -// 班表信息列表（数量限制50以内） +// 班表信息列表（数量限制 50 以内） // //示例值： func (builder *BatchCreateUserDailyShiftReqBodyBuilder) UserDailyShifts(userDailyShifts []*UserDailyShift) *BatchCreateUserDailyShiftReqBodyBuilder { @@ -6836,7 +6836,7 @@ func (builder *BatchCreateUserDailyShiftReqBodyBuilder) UserDailyShifts(userDail return builder } -// 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 +// 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 // //示例值：dd31248a func (builder *BatchCreateUserDailyShiftReqBodyBuilder) OperatorId(operatorId string) *BatchCreateUserDailyShiftReqBodyBuilder { @@ -6857,9 +6857,9 @@ func (builder *BatchCreateUserDailyShiftReqBodyBuilder) Build() *BatchCreateUser } type BatchCreateUserDailyShiftPathReqBodyBuilder struct { - userDailyShifts []*UserDailyShift // 班表信息列表（数量限制50以内） + userDailyShifts []*UserDailyShift // 班表信息列表（数量限制 50 以内） userDailyShiftsFlag bool - operatorId string // 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 + operatorId string // 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 operatorIdFlag bool } @@ -6868,7 +6868,7 @@ func NewBatchCreateUserDailyShiftPathReqBodyBuilder() *BatchCreateUserDailyShift return builder } -// 班表信息列表（数量限制50以内） +// 班表信息列表（数量限制 50 以内） // // 示例值： func (builder *BatchCreateUserDailyShiftPathReqBodyBuilder) UserDailyShifts(userDailyShifts []*UserDailyShift) *BatchCreateUserDailyShiftPathReqBodyBuilder { @@ -6877,7 +6877,7 @@ func (builder *BatchCreateUserDailyShiftPathReqBodyBuilder) UserDailyShifts(user return builder } -// 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 +// 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 // // 示例值：dd31248a func (builder *BatchCreateUserDailyShiftPathReqBodyBuilder) OperatorId(operatorId string) *BatchCreateUserDailyShiftPathReqBodyBuilder { @@ -6934,8 +6934,8 @@ func (builder *BatchCreateUserDailyShiftReqBuilder) Build() *BatchCreateUserDail } type BatchCreateUserDailyShiftReqBody struct { - UserDailyShifts []*UserDailyShift `json:"user_daily_shifts,omitempty"` // 班表信息列表（数量限制50以内） - OperatorId *string `json:"operator_id,omitempty"` // 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 + UserDailyShifts []*UserDailyShift `json:"user_daily_shifts,omitempty"` // 班表信息列表（数量限制 50 以内） + OperatorId *string `json:"operator_id,omitempty"` // 操作人 uid，如果您未操作 [考勤管理后台 “API 接入” 流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 } type BatchCreateUserDailyShiftReq struct { @@ -7129,7 +7129,7 @@ func (resp *QueryUserDailyShiftResp) Success() bool { } type BatchCreateUserFlowReqBodyBuilder struct { - flowRecords []*UserFlow // 打卡流水记录列表(数量限制50) + flowRecords []*UserFlow // 打卡流水记录列表 (数量限制 50) flowRecordsFlag bool } @@ -7138,7 +7138,7 @@ func NewBatchCreateUserFlowReqBodyBuilder() *BatchCreateUserFlowReqBodyBuilder { return builder } -// 打卡流水记录列表(数量限制50) +// 打卡流水记录列表 (数量限制 50) // //示例值： func (builder *BatchCreateUserFlowReqBodyBuilder) FlowRecords(flowRecords []*UserFlow) *BatchCreateUserFlowReqBodyBuilder { @@ -7156,7 +7156,7 @@ func (builder *BatchCreateUserFlowReqBodyBuilder) Build() *BatchCreateUserFlowRe } type BatchCreateUserFlowPathReqBodyBuilder struct { - flowRecords []*UserFlow // 打卡流水记录列表(数量限制50) + flowRecords []*UserFlow // 打卡流水记录列表 (数量限制 50) flowRecordsFlag bool } @@ -7165,7 +7165,7 @@ func NewBatchCreateUserFlowPathReqBodyBuilder() *BatchCreateUserFlowPathReqBodyB return builder } -// 打卡流水记录列表(数量限制50) +// 打卡流水记录列表 (数量限制 50) // // 示例值： func (builder *BatchCreateUserFlowPathReqBodyBuilder) FlowRecords(flowRecords []*UserFlow) *BatchCreateUserFlowPathReqBodyBuilder { @@ -7219,7 +7219,7 @@ func (builder *BatchCreateUserFlowReqBuilder) Build() *BatchCreateUserFlowReq { } type BatchCreateUserFlowReqBody struct { - FlowRecords []*UserFlow `json:"flow_records,omitempty"` // 打卡流水记录列表(数量限制50) + FlowRecords []*UserFlow `json:"flow_records,omitempty"` // 打卡流水记录列表 (数量限制 50) } type BatchCreateUserFlowReq struct { @@ -7288,12 +7288,12 @@ type GetUserFlowRespData struct { LocationName *string `json:"location_name,omitempty"` // 打卡位置名称信息 CheckTime *string `json:"check_time,omitempty"` // 打卡时间，精确到秒的时间戳 Comment *string `json:"comment,omitempty"` // 打卡备注 - RecordId *string `json:"record_id,omitempty"` // 打卡记录ID + RecordId *string `json:"record_id,omitempty"` // 打卡记录 ID - Ssid *string `json:"ssid,omitempty"` // 打卡wifi ssid - Bssid *string `json:"bssid,omitempty"` // 打卡wifi MAC地址 + Ssid *string `json:"ssid,omitempty"` // 打卡 wifi ssid + Bssid *string `json:"bssid,omitempty"` // 打卡 wifi MAC 地址 IsField *bool `json:"is_field,omitempty"` // 是否为外勤打卡 - IsWifi *bool `json:"is_wifi,omitempty"` // 是否为wifi打卡 + IsWifi *bool `json:"is_wifi,omitempty"` // 是否为 wifi 打卡 Type *int `json:"type,omitempty"` // 记录生成方式 PhotoUrls []string `json:"photo_urls,omitempty"` // 打卡照片列表 @@ -7442,7 +7442,7 @@ func (builder *QueryUserFlowReqBuilder) EmployeeType(employeeType string) *Query return builder } -// 由于新入职用户可以复用已离职用户的employee_no/employee_id。如果true，返回employee_no/employee_id对应的所有在职+离职用户数据；如果false，只返回employee_no/employee_id对应的在职或最近一个离职用户数据 +// 由于新入职用户可以复用已离职用户的 employee_no/employee_id。如果 true，返回 employee_no/employee_id 对应的所有在职 + 离职用户数据；如果 false，只返回 employee_no/employee_id 对应的在职或最近一个离职用户数据 // // 示例值：true func (builder *QueryUserFlowReqBuilder) IncludeTerminatedUser(includeTerminatedUser bool) *QueryUserFlowReqBuilder { @@ -7730,7 +7730,7 @@ type QueryUserStatsDataReqBodyBuilder struct { needHistoryFlag bool currentGroupOnly bool // 只展示当前考勤组 currentGroupOnlyFlag bool - userId string // 查询用户id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） + userId string // 查询用户 id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） userIdFlag bool } @@ -7802,7 +7802,7 @@ func (builder *QueryUserStatsDataReqBodyBuilder) CurrentGroupOnly(currentGroupOn return builder } -// 查询用户id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） +// 查询用户 id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） // //示例值：ec8ddg56 func (builder *QueryUserStatsDataReqBodyBuilder) UserId(userId string) *QueryUserStatsDataReqBodyBuilder { @@ -7855,7 +7855,7 @@ type QueryUserStatsDataPathReqBodyBuilder struct { needHistoryFlag bool currentGroupOnly bool // 只展示当前考勤组 currentGroupOnlyFlag bool - userId string // 查询用户id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） + userId string // 查询用户 id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） userIdFlag bool } @@ -7927,7 +7927,7 @@ func (builder *QueryUserStatsDataPathReqBodyBuilder) CurrentGroupOnly(currentGro return builder } -// 查询用户id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） +// 查询用户 id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） // // 示例值：ec8ddg56 func (builder *QueryUserStatsDataPathReqBodyBuilder) UserId(userId string) *QueryUserStatsDataPathReqBodyBuilder { @@ -8009,7 +8009,7 @@ type QueryUserStatsDataReqBody struct { UserIds []string `json:"user_ids,omitempty"` // 查询的用户 ID 列表;（用户数量不超过 200） NeedHistory *bool `json:"need_history,omitempty"` // 是否需要历史数据 CurrentGroupOnly *bool `json:"current_group_only,omitempty"` // 只展示当前考勤组 - UserId *string `json:"user_id,omitempty"` // 查询用户id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） + UserId *string `json:"user_id,omitempty"` // 查询用户 id，同【更新统计设置】、【查询统计设置】user_id（新系统用户必填，否则会报错） } type QueryUserStatsDataReq struct { @@ -8018,7 +8018,7 @@ type QueryUserStatsDataReq struct { } type QueryUserStatsDataRespData struct { - UserDatas []*UserStatsData `json:"user_datas,omitempty"` // 用户统计数据（限制1000条，超过1000条会截断） + UserDatas []*UserStatsData `json:"user_datas,omitempty"` // 用户统计数据（限制 1000 条，超过 1000 条会截断） } type QueryUserStatsDataResp struct { @@ -8236,7 +8236,7 @@ type QueryUserStatsViewReqBodyBuilder struct { localeFlag bool statsType string // 统计类型 statsTypeFlag bool - userId string // 查询用户id，同【查询统计数据】、【更新统计设置】user_id + userId string // 查询用户 id，同【查询统计数据】、【更新统计设置】user_id userIdFlag bool } @@ -8263,7 +8263,7 @@ func (builder *QueryUserStatsViewReqBodyBuilder) StatsType(statsType string) *Qu return builder } -// 查询用户id，同【查询统计数据】、【更新统计设置】user_id +// 查询用户 id，同【查询统计数据】、【更新统计设置】user_id // //示例值：dd31248a func (builder *QueryUserStatsViewReqBodyBuilder) UserId(userId string) *QueryUserStatsViewReqBodyBuilder { @@ -8291,7 +8291,7 @@ type QueryUserStatsViewPathReqBodyBuilder struct { localeFlag bool statsType string // 统计类型 statsTypeFlag bool - userId string // 查询用户id，同【查询统计数据】、【更新统计设置】user_id + userId string // 查询用户 id，同【查询统计数据】、【更新统计设置】user_id userIdFlag bool } @@ -8318,7 +8318,7 @@ func (builder *QueryUserStatsViewPathReqBodyBuilder) StatsType(statsType string) return builder } -// 查询用户id，同【查询统计数据】、【更新统计设置】user_id +// 查询用户 id，同【查询统计数据】、【更新统计设置】user_id // // 示例值：dd31248a func (builder *QueryUserStatsViewPathReqBodyBuilder) UserId(userId string) *QueryUserStatsViewPathReqBodyBuilder { @@ -8380,7 +8380,7 @@ func (builder *QueryUserStatsViewReqBuilder) Build() *QueryUserStatsViewReq { type QueryUserStatsViewReqBody struct { Locale *string `json:"locale,omitempty"` // 语言类型 StatsType *string `json:"stats_type,omitempty"` // 统计类型 - UserId *string `json:"user_id,omitempty"` // 查询用户id，同【查询统计数据】、【更新统计设置】user_id + UserId *string `json:"user_id,omitempty"` // 查询用户 id，同【查询统计数据】、【更新统计设置】user_id } type QueryUserStatsViewReq struct { @@ -8735,7 +8735,7 @@ func (builder *CreateUserTaskRemedyReqBuilder) EmployeeType(employeeType string) return builder } -// 对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口，将在三方审批系统中发起的补卡审批数据，写入到飞书考勤系统中，状态为审批中。写入后可以由[通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process) 进行状态更新 +// 对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口，将在三方审批系统中发起的补卡审批数据，写入到飞书考勤系统中，状态为审批中。写入后可以由 [通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process) 进行状态更新 func (builder *CreateUserTaskRemedyReqBuilder) UserTaskRemedy(userTaskRemedy *UserTaskRemedy) *CreateUserTaskRemedyReqBuilder { builder.userTaskRemedy = userTaskRemedy return builder @@ -8775,7 +8775,7 @@ type QueryUserTaskRemedyReqBodyBuilder struct { checkTimeFromFlag bool checkTimeTo string // 查询的结束时间，精确到秒的时间戳 checkTimeToFlag bool - checkDateType string // 查询依据的时间类型（默认依据PeriodTime，如果使用非默认的，非特定租户不支持） + checkDateType string // 查询依据的时间类型（默认依据 PeriodTime，如果使用非默认的，非特定租户不支持） checkDateTypeFlag bool status int // 查询状态（不填默认查询已通过状态） statusFlag bool @@ -8813,7 +8813,7 @@ func (builder *QueryUserTaskRemedyReqBodyBuilder) CheckTimeTo(checkTimeTo string return builder } -// 查询依据的时间类型（默认依据PeriodTime，如果使用非默认的，非特定租户不支持） +// 查询依据的时间类型（默认依据 PeriodTime，如果使用非默认的，非特定租户不支持） // //示例值：PeriodTime func (builder *QueryUserTaskRemedyReqBodyBuilder) CheckDateType(checkDateType string) *QueryUserTaskRemedyReqBodyBuilder { @@ -8858,7 +8858,7 @@ type QueryUserTaskRemedyPathReqBodyBuilder struct { checkTimeFromFlag bool checkTimeTo string // 查询的结束时间，精确到秒的时间戳 checkTimeToFlag bool - checkDateType string // 查询依据的时间类型（默认依据PeriodTime，如果使用非默认的，非特定租户不支持） + checkDateType string // 查询依据的时间类型（默认依据 PeriodTime，如果使用非默认的，非特定租户不支持） checkDateTypeFlag bool status int // 查询状态（不填默认查询已通过状态） statusFlag bool @@ -8896,7 +8896,7 @@ func (builder *QueryUserTaskRemedyPathReqBodyBuilder) CheckTimeTo(checkTimeTo st return builder } -// 查询依据的时间类型（默认依据PeriodTime，如果使用非默认的，非特定租户不支持） +// 查询依据的时间类型（默认依据 PeriodTime，如果使用非默认的，非特定租户不支持） // // 示例值：PeriodTime func (builder *QueryUserTaskRemedyPathReqBodyBuilder) CheckDateType(checkDateType string) *QueryUserTaskRemedyPathReqBodyBuilder { @@ -8974,7 +8974,7 @@ type QueryUserTaskRemedyReqBody struct { UserIds []string `json:"user_ids,omitempty"` // employee_no 或 employee_id 列表 CheckTimeFrom *string `json:"check_time_from,omitempty"` // 查询的起始时间，精确到秒的时间戳 CheckTimeTo *string `json:"check_time_to,omitempty"` // 查询的结束时间，精确到秒的时间戳 - CheckDateType *string `json:"check_date_type,omitempty"` // 查询依据的时间类型（默认依据PeriodTime，如果使用非默认的，非特定租户不支持） + CheckDateType *string `json:"check_date_type,omitempty"` // 查询依据的时间类型（默认依据 PeriodTime，如果使用非默认的，非特定租户不支持） Status *int `json:"status,omitempty"` // 查询状态（不填默认查询已通过状态） } @@ -9157,7 +9157,7 @@ func (iterator *ListGroupIterator) Next() (bool, *GroupMeta, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -9211,7 +9211,7 @@ func (iterator *ListShiftIterator) Next() (bool, *Shift, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/auth/v3/api.go b/service/auth/v3/api.go index 12a8ea5e..d51043bc 100644 --- a/service/auth/v3/api.go +++ b/service/auth/v3/api.go @@ -49,9 +49,9 @@ type tenantAccessToken struct { // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=auth&resource=app_access_token&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=auth&resource=app_access_token&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/create_appAccessToken.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/create_appAccessToken.go func (a *appAccessToken) Create(ctx context.Context, req *CreateAppAccessTokenReq, options ...larkcore.RequestOptionFunc) (*CreateAppAccessTokenResp, error) { // 发起请求 apiReq := req.apiReq @@ -75,9 +75,9 @@ func (a *appAccessToken) Create(ctx context.Context, req *CreateAppAccessTokenRe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=internal&project=auth&resource=app_access_token&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=internal&project=auth&resource=app_access_token&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/internal_appAccessToken.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/internal_appAccessToken.go func (a *appAccessToken) Internal(ctx context.Context, req *InternalAppAccessTokenReq, options ...larkcore.RequestOptionFunc) (*InternalAppAccessTokenResp, error) { // 发起请求 apiReq := req.apiReq @@ -101,9 +101,9 @@ func (a *appAccessToken) Internal(ctx context.Context, req *InternalAppAccessTok // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=resend&project=auth&resource=app_ticket&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=resend&project=auth&resource=app_ticket&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/resend_appTicket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/resend_appTicket.go func (a *appTicket) Resend(ctx context.Context, req *ResendAppTicketReq, options ...larkcore.RequestOptionFunc) (*ResendAppTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -127,9 +127,9 @@ func (a *appTicket) Resend(ctx context.Context, req *ResendAppTicketReq, options // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=auth&resource=tenant_access_token&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=auth&resource=tenant_access_token&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/create_tenantAccessToken.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/create_tenantAccessToken.go func (t *tenantAccessToken) Create(ctx context.Context, req *CreateTenantAccessTokenReq, options ...larkcore.RequestOptionFunc) (*CreateTenantAccessTokenResp, error) { // 发起请求 apiReq := req.apiReq @@ -153,9 +153,9 @@ func (t *tenantAccessToken) Create(ctx context.Context, req *CreateTenantAccessT // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=internal&project=auth&resource=tenant_access_token&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=internal&project=auth&resource=tenant_access_token&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/internal_tenantAccessToken.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authv3/internal_tenantAccessToken.go func (t *tenantAccessToken) Internal(ctx context.Context, req *InternalTenantAccessTokenReq, options ...larkcore.RequestOptionFunc) (*InternalTenantAccessTokenResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/auth/v3/model.go b/service/auth/v3/model.go index 8691fb05..bda18355 100644 --- a/service/auth/v3/model.go +++ b/service/auth/v3/model.go @@ -27,7 +27,7 @@ type TenantAccessToken struct { } type CreateAppAccessTokenReqBodyBuilder struct { - appId string // 应用唯一标识，创建应用后获得。有关app_id 的详细介绍。 + appId string // 应用唯一标识，创建应用后获得。有关 app_id 的详细介绍。 appIdFlag bool appSecret string // 应用秘钥，创建应用后获得。 appSecretFlag bool @@ -40,7 +40,7 @@ func NewCreateAppAccessTokenReqBodyBuilder() *CreateAppAccessTokenReqBodyBuilder return builder } -// 应用唯一标识，创建应用后获得。有关app_id 的详细介绍。 +// 应用唯一标识，创建应用后获得。有关 app_id 的详细介绍。 // //示例值：cli_ddfgkk38emd38 func (builder *CreateAppAccessTokenReqBodyBuilder) AppId(appId string) *CreateAppAccessTokenReqBodyBuilder { @@ -82,7 +82,7 @@ func (builder *CreateAppAccessTokenReqBodyBuilder) Build() *CreateAppAccessToken } type CreateAppAccessTokenPathReqBodyBuilder struct { - appId string // 应用唯一标识，创建应用后获得。有关app_id 的详细介绍。 + appId string // 应用唯一标识，创建应用后获得。有关 app_id 的详细介绍。 appIdFlag bool appSecret string // 应用秘钥，创建应用后获得。 appSecretFlag bool @@ -95,7 +95,7 @@ func NewCreateAppAccessTokenPathReqBodyBuilder() *CreateAppAccessTokenPathReqBod return builder } -// 应用唯一标识，创建应用后获得。有关app_id 的详细介绍。 +// 应用唯一标识，创建应用后获得。有关 app_id 的详细介绍。 // // 示例值：cli_ddfgkk38emd38 func (builder *CreateAppAccessTokenPathReqBodyBuilder) AppId(appId string) *CreateAppAccessTokenPathReqBodyBuilder { @@ -164,7 +164,7 @@ func (builder *CreateAppAccessTokenReqBuilder) Build() *CreateAppAccessTokenReq } type CreateAppAccessTokenReqBody struct { - AppId *string `json:"app_id,omitempty"` // 应用唯一标识，创建应用后获得。有关app_id 的详细介绍。 + AppId *string `json:"app_id,omitempty"` // 应用唯一标识，创建应用后获得。有关 app_id 的详细介绍。 AppSecret *string `json:"app_secret,omitempty"` // 应用秘钥，创建应用后获得。 AppTicket *string `json:"app_ticket,omitempty"` // 平台定时推送给应用的临时凭证，通过事件监听机制获得。 } @@ -440,7 +440,7 @@ func (resp *ResendAppTicketResp) Success() bool { } type CreateTenantAccessTokenReqBodyBuilder struct { - appAccessToken string // 应用访问凭证，通过商店应用获取 app_access_token接口获取。 + appAccessToken string // 应用访问凭证，通过商店应用获取 app_access_token 接口获取。 appAccessTokenFlag bool tenantKey string // 租户在飞书上的唯一标识，也可以理解为企业标识可以通过如下方式获取： 业开通应用时，开放平台推送给应用，具体可参考【首次启用应用】事件； 用户登录到小程序、H5 应用或者浏览器应用时，在用户的身份信息中获取。 tenantKeyFlag bool @@ -451,7 +451,7 @@ func NewCreateTenantAccessTokenReqBodyBuilder() *CreateTenantAccessTokenReqBodyB return builder } -// 应用访问凭证，通过商店应用获取 app_access_token接口获取。 +// 应用访问凭证，通过商店应用获取 app_access_token 接口获取。 // //示例值：a-32bd8551db2f081cbfd26293f27516390b9feb04 func (builder *CreateTenantAccessTokenReqBodyBuilder) AppAccessToken(appAccessToken string) *CreateTenantAccessTokenReqBodyBuilder { @@ -481,7 +481,7 @@ func (builder *CreateTenantAccessTokenReqBodyBuilder) Build() *CreateTenantAcces } type CreateTenantAccessTokenPathReqBodyBuilder struct { - appAccessToken string // 应用访问凭证，通过商店应用获取 app_access_token接口获取。 + appAccessToken string // 应用访问凭证，通过商店应用获取 app_access_token 接口获取。 appAccessTokenFlag bool tenantKey string // 租户在飞书上的唯一标识，也可以理解为企业标识可以通过如下方式获取： 业开通应用时，开放平台推送给应用，具体可参考【首次启用应用】事件； 用户登录到小程序、H5 应用或者浏览器应用时，在用户的身份信息中获取。 tenantKeyFlag bool @@ -492,7 +492,7 @@ func NewCreateTenantAccessTokenPathReqBodyBuilder() *CreateTenantAccessTokenPath return builder } -// 应用访问凭证，通过商店应用获取 app_access_token接口获取。 +// 应用访问凭证，通过商店应用获取 app_access_token 接口获取。 // // 示例值：a-32bd8551db2f081cbfd26293f27516390b9feb04 func (builder *CreateTenantAccessTokenPathReqBodyBuilder) AppAccessToken(appAccessToken string) *CreateTenantAccessTokenPathReqBodyBuilder { @@ -549,7 +549,7 @@ func (builder *CreateTenantAccessTokenReqBuilder) Build() *CreateTenantAccessTok } type CreateTenantAccessTokenReqBody struct { - AppAccessToken *string `json:"app_access_token,omitempty"` // 应用访问凭证，通过商店应用获取 app_access_token接口获取。 + AppAccessToken *string `json:"app_access_token,omitempty"` // 应用访问凭证，通过商店应用获取 app_access_token 接口获取。 TenantKey *string `json:"tenant_key,omitempty"` // 租户在飞书上的唯一标识，也可以理解为企业标识可以通过如下方式获取： 业开通应用时，开放平台推送给应用，具体可参考【首次启用应用】事件； 用户登录到小程序、H5 应用或者浏览器应用时，在用户的身份信息中获取。 } diff --git a/service/authen/v1/api.go b/service/authen/v1/api.go index 314b552c..28d9cb8f 100644 --- a/service/authen/v1/api.go +++ b/service/authen/v1/api.go @@ -49,9 +49,9 @@ type userInfo struct { // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=authen&resource=access_token&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=authen&resource=access_token&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authenv1/create_accessToken.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authenv1/create_accessToken.go func (a *accessToken) Create(ctx context.Context, req *CreateAccessTokenReq, options ...larkcore.RequestOptionFunc) (*CreateAccessTokenResp, error) { // 发起请求 apiReq := req.apiReq @@ -75,9 +75,9 @@ func (a *accessToken) Create(ctx context.Context, req *CreateAccessTokenReq, opt // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=authen&resource=refresh_access_token&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=authen&resource=refresh_access_token&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authenv1/create_refreshAccessToken.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authenv1/create_refreshAccessToken.go func (r *refreshAccessToken) Create(ctx context.Context, req *CreateRefreshAccessTokenReq, options ...larkcore.RequestOptionFunc) (*CreateRefreshAccessTokenResp, error) { // 发起请求 apiReq := req.apiReq @@ -101,9 +101,9 @@ func (r *refreshAccessToken) Create(ctx context.Context, req *CreateRefreshAcces // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=authen&resource=user_info&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=authen&resource=user_info&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authenv1/get_userInfo.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/authenv1/get_userInfo.go func (u *userInfo) Get(ctx context.Context, options ...larkcore.RequestOptionFunc) (*GetUserInfoResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ diff --git a/service/authen/v1/model.go b/service/authen/v1/model.go index d3b8a8c4..3f4df49c 100644 --- a/service/authen/v1/model.go +++ b/service/authen/v1/model.go @@ -20,7 +20,7 @@ import ( type UserAccessTokenInfo struct { AccessToken *string `json:"access_token,omitempty"` // user_access_token，用于获取用户资源 TokenType *string `json:"token_type,omitempty"` // token 类型 - ExpiresIn *int `json:"expires_in,omitempty"` // `access_token`的有效期，单位: 秒 + ExpiresIn *int `json:"expires_in,omitempty"` // `access_token`的有效期，单位：秒 Name *string `json:"name,omitempty"` // 用户姓名 EnName *string `json:"en_name,omitempty"` // 用户英文名称 AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像 @@ -28,15 +28,15 @@ type UserAccessTokenInfo struct { AvatarMiddle *string `json:"avatar_middle,omitempty"` // 用户头像 240x240 AvatarBig *string `json:"avatar_big,omitempty"` // 用户头像 640x640 OpenId *string `json:"open_id,omitempty"` // 用户在应用内的唯一标识 - UnionId *string `json:"union_id,omitempty"` // 用户统一ID + UnionId *string `json:"union_id,omitempty"` // 用户统一 ID Email *string `json:"email,omitempty"` // 用户邮箱 EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务 UserId *string `json:"user_id,omitempty"` // 用户 user_id Mobile *string `json:"mobile,omitempty"` // 用户手机号 TenantKey *string `json:"tenant_key,omitempty"` // 当前企业标识 - RefreshExpiresIn *int `json:"refresh_expires_in,omitempty"` // `refresh_token` 的有效期，单位: 秒 + RefreshExpiresIn *int `json:"refresh_expires_in,omitempty"` // `refresh_token` 的有效期，单位：秒 RefreshToken *string `json:"refresh_token,omitempty"` // 刷新用户 `access_token` 时使用的 token - Sid *string `json:"sid,omitempty"` // 用户当前登录态session的唯一标识，为空则不返回 + Sid *string `json:"sid,omitempty"` // 用户当前登录态 session 的唯一标识，为空则不返回 } type UserAccessTokenInfoBuilder struct { @@ -44,7 +44,7 @@ type UserAccessTokenInfoBuilder struct { accessTokenFlag bool tokenType string // token 类型 tokenTypeFlag bool - expiresIn int // `access_token`的有效期，单位: 秒 + expiresIn int // `access_token`的有效期，单位：秒 expiresInFlag bool name string // 用户姓名 nameFlag bool @@ -60,7 +60,7 @@ type UserAccessTokenInfoBuilder struct { avatarBigFlag bool openId string // 用户在应用内的唯一标识 openIdFlag bool - unionId string // 用户统一ID + unionId string // 用户统一 ID unionIdFlag bool email string // 用户邮箱 emailFlag bool @@ -72,11 +72,11 @@ type UserAccessTokenInfoBuilder struct { mobileFlag bool tenantKey string // 当前企业标识 tenantKeyFlag bool - refreshExpiresIn int // `refresh_token` 的有效期，单位: 秒 + refreshExpiresIn int // `refresh_token` 的有效期，单位：秒 refreshExpiresInFlag bool refreshToken string // 刷新用户 `access_token` 时使用的 token refreshTokenFlag bool - sid string // 用户当前登录态session的唯一标识，为空则不返回 + sid string // 用户当前登录态 session 的唯一标识，为空则不返回 sidFlag bool } @@ -103,7 +103,7 @@ func (builder *UserAccessTokenInfoBuilder) TokenType(tokenType string) *UserAcce return builder } -// `access_token`的有效期，单位: 秒 +// `access_token`的有效期，单位：秒 // // 示例值： func (builder *UserAccessTokenInfoBuilder) ExpiresIn(expiresIn int) *UserAccessTokenInfoBuilder { @@ -175,7 +175,7 @@ func (builder *UserAccessTokenInfoBuilder) OpenId(openId string) *UserAccessToke return builder } -// 用户统一ID +// 用户统一 ID // // 示例值： func (builder *UserAccessTokenInfoBuilder) UnionId(unionId string) *UserAccessTokenInfoBuilder { @@ -229,7 +229,7 @@ func (builder *UserAccessTokenInfoBuilder) TenantKey(tenantKey string) *UserAcce return builder } -// `refresh_token` 的有效期，单位: 秒 +// `refresh_token` 的有效期，单位：秒 // // 示例值： func (builder *UserAccessTokenInfoBuilder) RefreshExpiresIn(refreshExpiresIn int) *UserAccessTokenInfoBuilder { @@ -247,7 +247,7 @@ func (builder *UserAccessTokenInfoBuilder) RefreshToken(refreshToken string) *Us return builder } -// 用户当前登录态session的唯一标识，为空则不返回 +// 用户当前登录态 session 的唯一标识，为空则不返回 // // 示例值： func (builder *UserAccessTokenInfoBuilder) Sid(sid string) *UserAccessTokenInfoBuilder { @@ -345,7 +345,7 @@ type UserInfo struct { AvatarMiddle *string `json:"avatar_middle,omitempty"` // 用户头像 240x240 AvatarBig *string `json:"avatar_big,omitempty"` // 用户头像 640x640 OpenId *string `json:"open_id,omitempty"` // 用户在应用内的唯一标识 - UnionId *string `json:"union_id,omitempty"` // 用户统一ID + UnionId *string `json:"union_id,omitempty"` // 用户统一 ID Email *string `json:"email,omitempty"` // 用户邮箱 EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务 UserId *string `json:"user_id,omitempty"` // 用户 user_id @@ -369,7 +369,7 @@ type UserInfoBuilder struct { avatarBigFlag bool openId string // 用户在应用内的唯一标识 openIdFlag bool - unionId string // 用户统一ID + unionId string // 用户统一 ID unionIdFlag bool email string // 用户邮箱 emailFlag bool @@ -453,7 +453,7 @@ func (builder *UserInfoBuilder) OpenId(openId string) *UserInfoBuilder { return builder } -// 用户统一ID +// 用户统一 ID // // 示例值： func (builder *UserInfoBuilder) UnionId(unionId string) *UserInfoBuilder { @@ -578,9 +578,9 @@ func (builder *UserInfoBuilder) Build() *UserInfo { } type CreateAccessTokenReqBodyBuilder struct { - grantType string // 授权类型，**固定值** + grantType string // 授权类型，** 固定值 ** grantTypeFlag bool - code string // 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取 + code string // 登录预授权码，调用 [获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN) 接口获取 codeFlag bool } @@ -589,7 +589,7 @@ func NewCreateAccessTokenReqBodyBuilder() *CreateAccessTokenReqBodyBuilder { return builder } -// 授权类型，**固定值** +// 授权类型，** 固定值 ** // //示例值：authorization_code func (builder *CreateAccessTokenReqBodyBuilder) GrantType(grantType string) *CreateAccessTokenReqBodyBuilder { @@ -598,7 +598,7 @@ func (builder *CreateAccessTokenReqBodyBuilder) GrantType(grantType string) *Cre return builder } -// 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取 +// 登录预授权码，调用 [获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN) 接口获取 // //示例值：xMSldislSkdK func (builder *CreateAccessTokenReqBodyBuilder) Code(code string) *CreateAccessTokenReqBodyBuilder { @@ -619,9 +619,9 @@ func (builder *CreateAccessTokenReqBodyBuilder) Build() *CreateAccessTokenReqBod } type CreateAccessTokenPathReqBodyBuilder struct { - grantType string // 授权类型，**固定值** + grantType string // 授权类型，** 固定值 ** grantTypeFlag bool - code string // 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取 + code string // 登录预授权码，调用 [获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN) 接口获取 codeFlag bool } @@ -630,7 +630,7 @@ func NewCreateAccessTokenPathReqBodyBuilder() *CreateAccessTokenPathReqBodyBuild return builder } -// 授权类型，**固定值** +// 授权类型，** 固定值 ** // // 示例值：authorization_code func (builder *CreateAccessTokenPathReqBodyBuilder) GrantType(grantType string) *CreateAccessTokenPathReqBodyBuilder { @@ -639,7 +639,7 @@ func (builder *CreateAccessTokenPathReqBodyBuilder) GrantType(grantType string) return builder } -// 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取 +// 登录预授权码，调用 [获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN) 接口获取 // // 示例值：xMSldislSkdK func (builder *CreateAccessTokenPathReqBodyBuilder) Code(code string) *CreateAccessTokenPathReqBodyBuilder { @@ -687,8 +687,8 @@ func (builder *CreateAccessTokenReqBuilder) Build() *CreateAccessTokenReq { } type CreateAccessTokenReqBody struct { - GrantType *string `json:"grant_type,omitempty"` // 授权类型，**固定值** - Code *string `json:"code,omitempty"` // 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取 + GrantType *string `json:"grant_type,omitempty"` // 授权类型，** 固定值 ** + Code *string `json:"code,omitempty"` // 登录预授权码，调用 [获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN) 接口获取 } type CreateAccessTokenReq struct { @@ -699,7 +699,7 @@ type CreateAccessTokenReq struct { type CreateAccessTokenRespData struct { AccessToken *string `json:"access_token,omitempty"` // user_access_token，用于获取用户资源 TokenType *string `json:"token_type,omitempty"` // token 类型 - ExpiresIn *int `json:"expires_in,omitempty"` // `access_token`的有效期，单位: 秒 + ExpiresIn *int `json:"expires_in,omitempty"` // `access_token`的有效期，单位：秒 Name *string `json:"name,omitempty"` // 用户姓名 EnName *string `json:"en_name,omitempty"` // 用户英文名称 AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像 @@ -707,15 +707,15 @@ type CreateAccessTokenRespData struct { AvatarMiddle *string `json:"avatar_middle,omitempty"` // 用户头像 240x240 AvatarBig *string `json:"avatar_big,omitempty"` // 用户头像 640x640 OpenId *string `json:"open_id,omitempty"` // 用户在应用内的唯一标识 - UnionId *string `json:"union_id,omitempty"` // 用户统一ID + UnionId *string `json:"union_id,omitempty"` // 用户统一 ID Email *string `json:"email,omitempty"` // 用户邮箱 EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务 UserId *string `json:"user_id,omitempty"` // 用户 user_id Mobile *string `json:"mobile,omitempty"` // 用户手机号 TenantKey *string `json:"tenant_key,omitempty"` // 当前企业标识 - RefreshExpiresIn *int `json:"refresh_expires_in,omitempty"` // `refresh_token` 的有效期，单位: 秒 + RefreshExpiresIn *int `json:"refresh_expires_in,omitempty"` // `refresh_token` 的有效期，单位：秒 RefreshToken *string `json:"refresh_token,omitempty"` // 刷新用户 `access_token` 时使用的 token - Sid *string `json:"sid,omitempty"` // 用户当前登录态session的唯一标识，为空则不返回 + Sid *string `json:"sid,omitempty"` // 用户当前登录态 session 的唯一标识，为空则不返回 } type CreateAccessTokenResp struct { @@ -729,9 +729,9 @@ func (resp *CreateAccessTokenResp) Success() bool { } type CreateRefreshAccessTokenReqBodyBuilder struct { - grantType string // 授权类型，**固定值**： + grantType string // 授权类型，** 固定值 **： grantTypeFlag bool - refreshToken string // 刷新 `user_access_token` 需要的凭证
获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** + refreshToken string // 刷新 `user_access_token` 需要的凭证
获取 user_access_token`接口和本接口均返回 `refresh_token`，** 每次请求，请注意使用最新获取到的`refresh_token`** refreshTokenFlag bool } @@ -740,7 +740,7 @@ func NewCreateRefreshAccessTokenReqBodyBuilder() *CreateRefreshAccessTokenReqBod return builder } -// 授权类型，**固定值**： +// 授权类型，** 固定值 **： // //示例值：refresh_token func (builder *CreateRefreshAccessTokenReqBodyBuilder) GrantType(grantType string) *CreateRefreshAccessTokenReqBodyBuilder { @@ -749,7 +749,7 @@ func (builder *CreateRefreshAccessTokenReqBodyBuilder) GrantType(grantType strin return builder } -// 刷新 `user_access_token` 需要的凭证
获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** +// 刷新 `user_access_token` 需要的凭证
获取 user_access_token`接口和本接口均返回 `refresh_token`，** 每次请求，请注意使用最新获取到的`refresh_token`** // //示例值：ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL func (builder *CreateRefreshAccessTokenReqBodyBuilder) RefreshToken(refreshToken string) *CreateRefreshAccessTokenReqBodyBuilder { @@ -770,9 +770,9 @@ func (builder *CreateRefreshAccessTokenReqBodyBuilder) Build() *CreateRefreshAcc } type CreateRefreshAccessTokenPathReqBodyBuilder struct { - grantType string // 授权类型，**固定值**： + grantType string // 授权类型，** 固定值 **： grantTypeFlag bool - refreshToken string // 刷新 `user_access_token` 需要的凭证
获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** + refreshToken string // 刷新 `user_access_token` 需要的凭证
获取 user_access_token`接口和本接口均返回 `refresh_token`，** 每次请求，请注意使用最新获取到的`refresh_token`** refreshTokenFlag bool } @@ -781,7 +781,7 @@ func NewCreateRefreshAccessTokenPathReqBodyBuilder() *CreateRefreshAccessTokenPa return builder } -// 授权类型，**固定值**： +// 授权类型，** 固定值 **： // // 示例值：refresh_token func (builder *CreateRefreshAccessTokenPathReqBodyBuilder) GrantType(grantType string) *CreateRefreshAccessTokenPathReqBodyBuilder { @@ -790,7 +790,7 @@ func (builder *CreateRefreshAccessTokenPathReqBodyBuilder) GrantType(grantType s return builder } -// 刷新 `user_access_token` 需要的凭证
获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** +// 刷新 `user_access_token` 需要的凭证
获取 user_access_token`接口和本接口均返回 `refresh_token`，** 每次请求，请注意使用最新获取到的`refresh_token`** // // 示例值：ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL func (builder *CreateRefreshAccessTokenPathReqBodyBuilder) RefreshToken(refreshToken string) *CreateRefreshAccessTokenPathReqBodyBuilder { @@ -838,8 +838,8 @@ func (builder *CreateRefreshAccessTokenReqBuilder) Build() *CreateRefreshAccessT } type CreateRefreshAccessTokenReqBody struct { - GrantType *string `json:"grant_type,omitempty"` // 授权类型，**固定值**： - RefreshToken *string `json:"refresh_token,omitempty"` // 刷新 `user_access_token` 需要的凭证
获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** + GrantType *string `json:"grant_type,omitempty"` // 授权类型，** 固定值 **： + RefreshToken *string `json:"refresh_token,omitempty"` // 刷新 `user_access_token` 需要的凭证
获取 user_access_token`接口和本接口均返回 `refresh_token`，** 每次请求，请注意使用最新获取到的`refresh_token`** } type CreateRefreshAccessTokenReq struct { @@ -850,7 +850,7 @@ type CreateRefreshAccessTokenReq struct { type CreateRefreshAccessTokenRespData struct { AccessToken *string `json:"access_token,omitempty"` // user_access_token，用于获取用户资源 TokenType *string `json:"token_type,omitempty"` // token 类型 - ExpiresIn *int `json:"expires_in,omitempty"` // `access_token`的有效期，单位: 秒 + ExpiresIn *int `json:"expires_in,omitempty"` // `access_token`的有效期，单位：秒 Name *string `json:"name,omitempty"` // 用户姓名 EnName *string `json:"en_name,omitempty"` // 用户英文名称 AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像 @@ -858,15 +858,15 @@ type CreateRefreshAccessTokenRespData struct { AvatarMiddle *string `json:"avatar_middle,omitempty"` // 用户头像 240x240 AvatarBig *string `json:"avatar_big,omitempty"` // 用户头像 640x640 OpenId *string `json:"open_id,omitempty"` // 用户在应用内的唯一标识 - UnionId *string `json:"union_id,omitempty"` // 用户统一ID + UnionId *string `json:"union_id,omitempty"` // 用户统一 ID Email *string `json:"email,omitempty"` // 用户邮箱 EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务 UserId *string `json:"user_id,omitempty"` // 用户 user_id Mobile *string `json:"mobile,omitempty"` // 用户手机号 TenantKey *string `json:"tenant_key,omitempty"` // 当前企业标识 - RefreshExpiresIn *int `json:"refresh_expires_in,omitempty"` // `refresh_token` 的有效期，单位: 秒 + RefreshExpiresIn *int `json:"refresh_expires_in,omitempty"` // `refresh_token` 的有效期，单位：秒 RefreshToken *string `json:"refresh_token,omitempty"` // 刷新用户 `access_token` 时使用的 token - Sid *string `json:"sid,omitempty"` // 用户当前登录态session的唯一标识，为空则不返回 + Sid *string `json:"sid,omitempty"` // 用户当前登录态 session 的唯一标识，为空则不返回 } type CreateRefreshAccessTokenResp struct { @@ -887,7 +887,7 @@ type GetUserInfoRespData struct { AvatarMiddle *string `json:"avatar_middle,omitempty"` // 用户头像 240x240 AvatarBig *string `json:"avatar_big,omitempty"` // 用户头像 640x640 OpenId *string `json:"open_id,omitempty"` // 用户在应用内的唯一标识 - UnionId *string `json:"union_id,omitempty"` // 用户统一ID + UnionId *string `json:"union_id,omitempty"` // 用户统一 ID Email *string `json:"email,omitempty"` // 用户邮箱 EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务 UserId *string `json:"user_id,omitempty"` // 用户 user_id diff --git a/service/baike/v1/api.go b/service/baike/v1/api.go index fddeda9b..cdbe3eba 100644 --- a/service/baike/v1/api.go +++ b/service/baike/v1/api.go @@ -55,9 +55,9 @@ type file struct { // // - 获取企业百科当前分类。;企业百科目前为二级分类体系，每个词条可添加多个二级分类，但每个一级分类下只能添加一个分类。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/classification/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/classification/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/list_classification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/list_classification.go func (c *classification) List(ctx context.Context, req *ListClassificationReq, options ...larkcore.RequestOptionFunc) (*ListClassificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -93,9 +93,9 @@ func (c *classification) ListByIterator(ctx context.Context, req *ListClassifica // // - · 创建新的百科词条时，无需传入 entity_id 字段;· 更新已有百科词条时，请传入对应词条的 entity_id 或 outer_info // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/draft/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/draft/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/create_draft.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/create_draft.go func (d *draft) Create(ctx context.Context, req *CreateDraftReq, options ...larkcore.RequestOptionFunc) (*CreateDraftResp, error) { // 发起请求 apiReq := req.apiReq @@ -119,9 +119,9 @@ func (d *draft) Create(ctx context.Context, req *CreateDraftReq, options ...lark // // - 根据 draft_id 更新草稿内容，已审批的草稿无法编辑 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/draft/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/draft/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/update_draft.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/update_draft.go func (d *draft) Update(ctx context.Context, req *UpdateDraftReq, options ...larkcore.RequestOptionFunc) (*UpdateDraftResp, error) { // 发起请求 apiReq := req.apiReq @@ -145,9 +145,9 @@ func (d *draft) Update(ctx context.Context, req *UpdateDraftReq, options ...lark // // - 通过此接口创建的词条，不需要百科管理员审核可直接写入词库，请慎重使用【租户管理员请慎重审批】。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/create_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/create_entity.go func (e *entity) Create(ctx context.Context, req *CreateEntityReq, options ...larkcore.RequestOptionFunc) (*CreateEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -171,9 +171,9 @@ func (e *entity) Create(ctx context.Context, req *CreateEntityReq, options ...la // // - 提取文本中可能成为百科词条的词语，且不会过滤已经成为百科词条的词语。同时，会返回推荐的别名。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/extract +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/extract // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/extract_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/extract_entity.go func (e *entity) Extract(ctx context.Context, req *ExtractEntityReq, options ...larkcore.RequestOptionFunc) (*ExtractEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -199,9 +199,9 @@ func (e *entity) Extract(ctx context.Context, req *ExtractEntityReq, options ... // // - 也支持通过 provider 和 outer_id 返回对应实体的详情数据。此时路径中的 entity_id 为固定的 enterprise_0 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/get_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/get_entity.go func (e *entity) Get(ctx context.Context, req *GetEntityReq, options ...larkcore.RequestOptionFunc) (*GetEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -225,9 +225,9 @@ func (e *entity) Get(ctx context.Context, req *GetEntityReq, options ...larkcore // // - 传入一句话，智能识别句中对应的词条，并返回词条位置和 entity_id，可在外部系统中快速实现百科词条智能高亮。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/highlight +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/highlight // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/highlight_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/highlight_entity.go func (e *entity) Highlight(ctx context.Context, req *HighlightEntityReq, options ...larkcore.RequestOptionFunc) (*HighlightEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -251,9 +251,9 @@ func (e *entity) Highlight(ctx context.Context, req *HighlightEntityReq, options // // - 分页拉取词条列表数据，支持拉取租户内的全部词条。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/list_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/list_entity.go func (e *entity) List(ctx context.Context, req *ListEntityReq, options ...larkcore.RequestOptionFunc) (*ListEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -285,9 +285,9 @@ func (e *entity) ListByIterator(ctx context.Context, req *ListEntityReq, options // // - 将关键词与词条名、别名精准匹配，并返回对应的 词条 ID。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/match +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/match // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/match_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/match_entity.go func (e *entity) Match(ctx context.Context, req *MatchEntityReq, options ...larkcore.RequestOptionFunc) (*MatchEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -311,9 +311,9 @@ func (e *entity) Match(ctx context.Context, req *MatchEntityReq, options ...lark // // - 传入关键词，与词条名、别名、释义等信息进行模糊匹配，返回搜到的词条信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/search_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/search_entity.go func (e *entity) Search(ctx context.Context, req *SearchEntityReq, options ...larkcore.RequestOptionFunc) (*SearchEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -345,9 +345,9 @@ func (e *entity) SearchByIterator(ctx context.Context, req *SearchEntityReq, opt // // - 通过此接口更新已有的词条，不需要百科管理员审核可直接写入词库，请慎重使用【租户管理员请慎重审批】。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/update_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/update_entity.go func (e *entity) Update(ctx context.Context, req *UpdateEntityReq, options ...larkcore.RequestOptionFunc) (*UpdateEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -371,9 +371,9 @@ func (e *entity) Update(ctx context.Context, req *UpdateEntityReq, options ...la // // - 通过 file_token 下载原图片 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/file/download +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/file/download // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/download_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/download_file.go func (f *file) Download(ctx context.Context, req *DownloadFileReq, options ...larkcore.RequestOptionFunc) (*DownloadFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -403,9 +403,9 @@ func (f *file) Download(ctx context.Context, req *DownloadFileReq, options ...la // // - 百科词条图片资源上传。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/file/upload +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/file/upload // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/upload_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/baikev1/upload_file.go func (f *file) Upload(ctx context.Context, req *UploadFileReq, options ...larkcore.RequestOptionFunc) (*UploadFileResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 diff --git a/service/baike/v1/model.go b/service/baike/v1/model.go index 5e9f3ea2..bb741d0d 100644 --- a/service/baike/v1/model.go +++ b/service/baike/v1/model.go @@ -27,45 +27,45 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateDraftUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateDraftUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateDraftOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateDraftUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateDraftUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateDraftOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateEntityUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateEntityUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateEntityOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateEntityUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateEntityUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateEntityOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetEntityUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetEntityUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetEntityOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetEntityUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetEntityUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetEntityOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListEntityUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListEntityUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListEntityOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListEntityUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListEntityUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListEntityOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeSearchEntityUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSearchEntityUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSearchEntityOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeSearchEntityUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSearchEntityUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSearchEntityOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateEntityUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateEntityUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateEntityOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateEntityUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateEntityUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateEntityOpenId = "open_id" // 以 open_id 来识别用户 ) type Abbreviation struct { @@ -526,7 +526,7 @@ func (builder *DraftBuilder) Build() *Draft { } type Entity struct { - Id *string `json:"id,omitempty"` // 词条 ID （需要更新某个词条时填写，若是创建新词条可不填写） + Id *string `json:"id,omitempty"` // 词条 ID（需要更新某个词条时填写，若是创建新词条可不填写） MainKeys []*Term `json:"main_keys,omitempty"` // 词条名 Aliases []*Term `json:"aliases,omitempty"` // 别名 @@ -536,11 +536,11 @@ type Entity struct { RelatedMeta *RelatedMeta `json:"related_meta,omitempty"` // 更多相关信息 Statistics *Statistics `json:"statistics,omitempty"` // 当前词条收到的反馈数据 OuterInfo *OuterInfo `json:"outer_info,omitempty"` // 外部系统关联数据 - RichText *string `json:"rich_text,omitempty"` // 富文本格式（当填写富文本内容时，description字段将会失效可不填写），支持的格式参考[企业百科指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/overview)中的释义部分 + RichText *string `json:"rich_text,omitempty"` // 富文本格式（当填写富文本内容时，description 字段将会失效可不填写），支持的格式参考 [企业百科指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/overview) 中的释义部分 } type EntityBuilder struct { - id string // 词条 ID （需要更新某个词条时填写，若是创建新词条可不填写） + id string // 词条 ID（需要更新某个词条时填写，若是创建新词条可不填写） idFlag bool mainKeys []*Term // 词条名 mainKeysFlag bool @@ -559,7 +559,7 @@ type EntityBuilder struct { statisticsFlag bool outerInfo *OuterInfo // 外部系统关联数据 outerInfoFlag bool - richText string // 富文本格式（当填写富文本内容时，description字段将会失效可不填写），支持的格式参考[企业百科指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/overview)中的释义部分 + richText string // 富文本格式（当填写富文本内容时，description 字段将会失效可不填写），支持的格式参考 [企业百科指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/overview) 中的释义部分 richTextFlag bool } @@ -568,7 +568,7 @@ func NewEntityBuilder() *EntityBuilder { return builder } -// 词条 ID （需要更新某个词条时填写，若是创建新词条可不填写） +// 词条 ID（需要更新某个词条时填写，若是创建新词条可不填写） // // 示例值：enterprise_40217521 func (builder *EntityBuilder) Id(id string) *EntityBuilder { @@ -597,7 +597,7 @@ func (builder *EntityBuilder) Aliases(aliases []*Term) *EntityBuilder { // 词条释义（纯文本格式） // -// 示例值：企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过UGC的方式，促进企业知识的保鲜和流通 +// 示例值：企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过 UGC 的方式，促进企业知识的保鲜和流通 func (builder *EntityBuilder) Description(description string) *EntityBuilder { builder.description = description builder.descriptionFlag = true @@ -649,9 +649,9 @@ func (builder *EntityBuilder) OuterInfo(outerInfo *OuterInfo) *EntityBuilder { return builder } -// 富文本格式（当填写富文本内容时，description字段将会失效可不填写），支持的格式参考[企业百科指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/overview)中的释义部分 +// 富文本格式（当填写富文本内容时，description 字段将会失效可不填写），支持的格式参考 [企业百科指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/overview) 中的释义部分 // -// 示例值：<b>加粗</b><i>斜体</i><p><a href=\"https://feishu.cn\">链接</a></p><p><span>企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过UGC的方式，促进企业知识的保鲜和流通</span></p> +// 示例值：<b>加粗</b><i>斜体</i><p><a href=\"https://feishu.cn\">链接</a></p><p><span>企业百科是飞书提供的一款知识管理工具，通过企业百科可以帮助企业将分散的知识信息进行聚合，并通过 UGC 的方式，促进企业知识的保鲜和流通</span></p> func (builder *EntityBuilder) RichText(richText string) *EntityBuilder { builder.richText = richText builder.richTextFlag = true @@ -1375,8 +1375,8 @@ func (builder *TermBuilder) Build() *Term { type WordInfo struct { InputTotal *int `json:"input_total,omitempty"` // 用户输入的总词汇量 DedupInputTotal *int `json:"dedup_input_total,omitempty"` // 用户输入的去重后的总词汇量 - EachdayInput []int `json:"eachday_input,omitempty"` // 时间区间内每一天发送的英文词数，时间是由远到近。以七天数据为例：下标6为昨天，下标5位前天以此类推 - EachdayDedupInput []int `json:"eachday_dedup_input,omitempty"` // 时间区间内每一天发送的归一化去重后的英文词数，时间是由远到近。以七天数据为例：下标6为昨天，下标5位前天以此类推 + EachdayInput []int `json:"eachday_input,omitempty"` // 时间区间内每一天发送的英文词数，时间是由远到近。以七天数据为例：下标 6 为昨天，下标 5 位前天以此类推 + EachdayDedupInput []int `json:"eachday_dedup_input,omitempty"` // 时间区间内每一天发送的归一化去重后的英文词数，时间是由远到近。以七天数据为例：下标 6 为昨天，下标 5 位前天以此类推 SendMessageTotal *int `json:"send_message_total,omitempty"` // 发送的消息总数 SendEnMessageTotal *int `json:"send_en_message_total,omitempty"` // 发送的英语消息总数 ReceiveMessageTotal *int `json:"receive_message_total,omitempty"` // 接收消息的数量 @@ -1396,9 +1396,9 @@ type WordInfoBuilder struct { inputTotalFlag bool dedupInputTotal int // 用户输入的去重后的总词汇量 dedupInputTotalFlag bool - eachdayInput []int // 时间区间内每一天发送的英文词数，时间是由远到近。以七天数据为例：下标6为昨天，下标5位前天以此类推 + eachdayInput []int // 时间区间内每一天发送的英文词数，时间是由远到近。以七天数据为例：下标 6 为昨天，下标 5 位前天以此类推 eachdayInputFlag bool - eachdayDedupInput []int // 时间区间内每一天发送的归一化去重后的英文词数，时间是由远到近。以七天数据为例：下标6为昨天，下标5位前天以此类推 + eachdayDedupInput []int // 时间区间内每一天发送的归一化去重后的英文词数，时间是由远到近。以七天数据为例：下标 6 为昨天，下标 5 位前天以此类推 eachdayDedupInputFlag bool sendMessageTotal int // 发送的消息总数 sendMessageTotalFlag bool @@ -1449,7 +1449,7 @@ func (builder *WordInfoBuilder) DedupInputTotal(dedupInputTotal int) *WordInfoBu return builder } -// 时间区间内每一天发送的英文词数，时间是由远到近。以七天数据为例：下标6为昨天，下标5位前天以此类推 +// 时间区间内每一天发送的英文词数，时间是由远到近。以七天数据为例：下标 6 为昨天，下标 5 位前天以此类推 // // 示例值： func (builder *WordInfoBuilder) EachdayInput(eachdayInput []int) *WordInfoBuilder { @@ -1458,7 +1458,7 @@ func (builder *WordInfoBuilder) EachdayInput(eachdayInput []int) *WordInfoBuilde return builder } -// 时间区间内每一天发送的归一化去重后的英文词数，时间是由远到近。以七天数据为例：下标6为昨天，下标5位前天以此类推 +// 时间区间内每一天发送的归一化去重后的英文词数，时间是由远到近。以七天数据为例：下标 6 为昨天，下标 5 位前天以此类推 // // 示例值： func (builder *WordInfoBuilder) EachdayDedupInput(eachdayDedupInput []int) *WordInfoBuilder { @@ -1717,7 +1717,7 @@ func NewCreateDraftReqBuilder() *CreateDraftReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateDraftReqBuilder) UserIdType(userIdType string) *CreateDraftReqBuilder { @@ -1780,7 +1780,7 @@ func (builder *UpdateDraftReqBuilder) DraftId(draftId string) *UpdateDraftReqBui return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateDraftReqBuilder) UserIdType(userIdType string) *UpdateDraftReqBuilder { @@ -1836,7 +1836,7 @@ func NewCreateEntityReqBuilder() *CreateEntityReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateEntityReqBuilder) UserIdType(userIdType string) *CreateEntityReqBuilder { @@ -2018,7 +2018,7 @@ func (builder *GetEntityReqBuilder) OuterId(outerId string) *GetEntityReqBuilder return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetEntityReqBuilder) UserIdType(userIdType string) *GetEntityReqBuilder { @@ -2053,7 +2053,7 @@ func (resp *GetEntityResp) Success() bool { } type HighlightEntityReqBodyBuilder struct { - text string // 需要识别百科词条的内容（不超过1000字） + text string // 需要识别百科词条的内容（不超过 1000 字） textFlag bool } @@ -2062,7 +2062,7 @@ func NewHighlightEntityReqBodyBuilder() *HighlightEntityReqBodyBuilder { return builder } -// 需要识别百科词条的内容（不超过1000字） +// 需要识别百科词条的内容（不超过 1000 字） // //示例值：企业百科是飞书提供的一款知识管理工具 func (builder *HighlightEntityReqBodyBuilder) Text(text string) *HighlightEntityReqBodyBuilder { @@ -2080,7 +2080,7 @@ func (builder *HighlightEntityReqBodyBuilder) Build() *HighlightEntityReqBody { } type HighlightEntityPathReqBodyBuilder struct { - text string // 需要识别百科词条的内容（不超过1000字） + text string // 需要识别百科词条的内容（不超过 1000 字） textFlag bool } @@ -2089,7 +2089,7 @@ func NewHighlightEntityPathReqBodyBuilder() *HighlightEntityPathReqBodyBuilder { return builder } -// 需要识别百科词条的内容（不超过1000字） +// 需要识别百科词条的内容（不超过 1000 字） // // 示例值：企业百科是飞书提供的一款知识管理工具 func (builder *HighlightEntityPathReqBodyBuilder) Text(text string) *HighlightEntityPathReqBodyBuilder { @@ -2134,7 +2134,7 @@ func (builder *HighlightEntityReqBuilder) Build() *HighlightEntityReq { } type HighlightEntityReqBody struct { - Text *string `json:"text,omitempty"` // 需要识别百科词条的内容（不超过1000字） + Text *string `json:"text,omitempty"` // 需要识别百科词条的内容（不超过 1000 字） } type HighlightEntityReq struct { @@ -2200,7 +2200,7 @@ func (builder *ListEntityReqBuilder) Provider(provider string) *ListEntityReqBui return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListEntityReqBuilder) UserIdType(userIdType string) *ListEntityReqBuilder { @@ -2432,7 +2432,7 @@ func (builder *SearchEntityReqBuilder) PageSize(pageSize int) *SearchEntityReqBu return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SearchEntityReqBuilder) UserIdType(userIdType string) *SearchEntityReqBuilder { @@ -2503,7 +2503,7 @@ func (builder *UpdateEntityReqBuilder) EntityId(entityId string) *UpdateEntityRe return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateEntityReqBuilder) UserIdType(userIdType string) *UpdateEntityReqBuilder { @@ -2665,7 +2665,7 @@ func (iterator *ListClassificationIterator) Next() (bool, *Classification, error return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2719,7 +2719,7 @@ func (iterator *ListEntityIterator) Next() (bool, *Entity, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2773,7 +2773,7 @@ func (iterator *SearchEntityIterator) Next() (bool, *Entity, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/bitable/v1/api.go b/service/bitable/v1/api.go index 585771a2..1e7d6ff4 100644 --- a/service/bitable/v1/api.go +++ b/service/bitable/v1/api.go @@ -84,9 +84,9 @@ type appTableView struct { // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=bitable&resource=app&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=bitable&resource=app&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_app.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_app.go func (a *app) Create(ctx context.Context, req *CreateAppReq, options ...larkcore.RequestOptionFunc) (*CreateAppResp, error) { // 发起请求 apiReq := req.apiReq @@ -112,9 +112,9 @@ func (a *app) Create(ctx context.Context, req *CreateAppReq, options ...larkcore // // - 该接口支持调用频率上限为 20 QPS（Query Per Second，每秒请求率） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_app.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_app.go func (a *app) Get(ctx context.Context, req *GetAppReq, options ...larkcore.RequestOptionFunc) (*GetAppResp, error) { // 发起请求 apiReq := req.apiReq @@ -142,9 +142,9 @@ func (a *app) Get(ctx context.Context, req *GetAppReq, options ...larkcore.Reque // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_app.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_app.go func (a *app) Update(ctx context.Context, req *UpdateAppReq, options ...larkcore.RequestOptionFunc) (*UpdateAppResp, error) { // 发起请求 apiReq := req.apiReq @@ -168,9 +168,9 @@ func (a *app) Update(ctx context.Context, req *UpdateAppReq, options ...larkcore // // - 该接口用于根据现有仪表盘复制出新的仪表盘 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-dashboard/copy +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-dashboard/copy // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/copy_appDashboard.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/copy_appDashboard.go func (a *appDashboard) Copy(ctx context.Context, req *CopyAppDashboardReq, options ...larkcore.RequestOptionFunc) (*CopyAppDashboardResp, error) { // 发起请求 apiReq := req.apiReq @@ -196,9 +196,9 @@ func (a *appDashboard) Copy(ctx context.Context, req *CopyAppDashboardReq, optio // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-dashboard/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-dashboard/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appDashboard.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appDashboard.go func (a *appDashboard) List(ctx context.Context, req *ListAppDashboardReq, options ...larkcore.RequestOptionFunc) (*ListAppDashboardResp, error) { // 发起请求 apiReq := req.apiReq @@ -230,9 +230,9 @@ func (a *appDashboard) ListByIterator(ctx context.Context, req *ListAppDashboard // // - 新增自定义角色 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appRole.go func (a *appRole) Create(ctx context.Context, req *CreateAppRoleReq, options ...larkcore.RequestOptionFunc) (*CreateAppRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -256,9 +256,9 @@ func (a *appRole) Create(ctx context.Context, req *CreateAppRoleReq, options ... // // - 删除自定义角色 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appRole.go func (a *appRole) Delete(ctx context.Context, req *DeleteAppRoleReq, options ...larkcore.RequestOptionFunc) (*DeleteAppRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -282,9 +282,9 @@ func (a *appRole) Delete(ctx context.Context, req *DeleteAppRoleReq, options ... // // - 列出自定义角色 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appRole.go func (a *appRole) List(ctx context.Context, req *ListAppRoleReq, options ...larkcore.RequestOptionFunc) (*ListAppRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -318,9 +318,9 @@ func (a *appRole) ListByIterator(ctx context.Context, req *ListAppRoleReq, optio // // - 更新自定义角色是全量更新，会完全覆盖旧的自定义角色设置 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_appRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_appRole.go func (a *appRole) Update(ctx context.Context, req *UpdateAppRoleReq, options ...larkcore.RequestOptionFunc) (*UpdateAppRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -344,9 +344,9 @@ func (a *appRole) Update(ctx context.Context, req *UpdateAppRoleReq, options ... // // - 批量新增自定义角色的协作者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/batch_create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/batch_create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchCreate_appRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchCreate_appRoleMember.go func (a *appRoleMember) BatchCreate(ctx context.Context, req *BatchCreateAppRoleMemberReq, options ...larkcore.RequestOptionFunc) (*BatchCreateAppRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -370,9 +370,9 @@ func (a *appRoleMember) BatchCreate(ctx context.Context, req *BatchCreateAppRole // // - 批量删除自定义角色的协作者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/batch_delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/batch_delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchDelete_appRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchDelete_appRoleMember.go func (a *appRoleMember) BatchDelete(ctx context.Context, req *BatchDeleteAppRoleMemberReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteAppRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -396,9 +396,9 @@ func (a *appRoleMember) BatchDelete(ctx context.Context, req *BatchDeleteAppRole // // - 新增自定义角色的协作者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appRoleMember.go func (a *appRoleMember) Create(ctx context.Context, req *CreateAppRoleMemberReq, options ...larkcore.RequestOptionFunc) (*CreateAppRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -422,9 +422,9 @@ func (a *appRoleMember) Create(ctx context.Context, req *CreateAppRoleMemberReq, // // - 删除自定义角色的协作者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appRoleMember.go func (a *appRoleMember) Delete(ctx context.Context, req *DeleteAppRoleMemberReq, options ...larkcore.RequestOptionFunc) (*DeleteAppRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -448,9 +448,9 @@ func (a *appRoleMember) Delete(ctx context.Context, req *DeleteAppRoleMemberReq, // // - 列出自定义角色的协作者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-role-member/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appRoleMember.go func (a *appRoleMember) List(ctx context.Context, req *ListAppRoleMemberReq, options ...larkcore.RequestOptionFunc) (*ListAppRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -484,9 +484,9 @@ func (a *appRoleMember) ListByIterator(ctx context.Context, req *ListAppRoleMemb // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/batch_create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/batch_create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchCreate_appTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchCreate_appTable.go func (a *appTable) BatchCreate(ctx context.Context, req *BatchCreateAppTableReq, options ...larkcore.RequestOptionFunc) (*BatchCreateAppTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -512,9 +512,9 @@ func (a *appTable) BatchCreate(ctx context.Context, req *BatchCreateAppTableReq, // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/batch_delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/batch_delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchDelete_appTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchDelete_appTable.go func (a *appTable) BatchDelete(ctx context.Context, req *BatchDeleteAppTableReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteAppTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -540,9 +540,9 @@ func (a *appTable) BatchDelete(ctx context.Context, req *BatchDeleteAppTableReq, // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTable.go func (a *appTable) Create(ctx context.Context, req *CreateAppTableReq, options ...larkcore.RequestOptionFunc) (*CreateAppTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -568,9 +568,9 @@ func (a *appTable) Create(ctx context.Context, req *CreateAppTableReq, options . // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTable.go func (a *appTable) Delete(ctx context.Context, req *DeleteAppTableReq, options ...larkcore.RequestOptionFunc) (*DeleteAppTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -596,9 +596,9 @@ func (a *appTable) Delete(ctx context.Context, req *DeleteAppTableReq, options . // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTable.go func (a *appTable) List(ctx context.Context, req *ListAppTableReq, options ...larkcore.RequestOptionFunc) (*ListAppTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -630,9 +630,9 @@ func (a *appTable) ListByIterator(ctx context.Context, req *ListAppTableReq, opt // // - // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTable.go func (a *appTable) Patch(ctx context.Context, req *PatchAppTableReq, options ...larkcore.RequestOptionFunc) (*PatchAppTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -658,9 +658,9 @@ func (a *appTable) Patch(ctx context.Context, req *PatchAppTableReq, options ... // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTableField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTableField.go func (a *appTableField) Create(ctx context.Context, req *CreateAppTableFieldReq, options ...larkcore.RequestOptionFunc) (*CreateAppTableFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -686,9 +686,9 @@ func (a *appTableField) Create(ctx context.Context, req *CreateAppTableFieldReq, // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTableField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTableField.go func (a *appTableField) Delete(ctx context.Context, req *DeleteAppTableFieldReq, options ...larkcore.RequestOptionFunc) (*DeleteAppTableFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -714,9 +714,9 @@ func (a *appTableField) Delete(ctx context.Context, req *DeleteAppTableFieldReq, // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableField.go func (a *appTableField) List(ctx context.Context, req *ListAppTableFieldReq, options ...larkcore.RequestOptionFunc) (*ListAppTableFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -750,9 +750,9 @@ func (a *appTableField) ListByIterator(ctx context.Context, req *ListAppTableFie // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_appTableField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_appTableField.go func (a *appTableField) Update(ctx context.Context, req *UpdateAppTableFieldReq, options ...larkcore.RequestOptionFunc) (*UpdateAppTableFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -778,9 +778,9 @@ func (a *appTableField) Update(ctx context.Context, req *UpdateAppTableFieldReq, // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_appTableForm.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_appTableForm.go func (a *appTableForm) Get(ctx context.Context, req *GetAppTableFormReq, options ...larkcore.RequestOptionFunc) (*GetAppTableFormResp, error) { // 发起请求 apiReq := req.apiReq @@ -806,9 +806,9 @@ func (a *appTableForm) Get(ctx context.Context, req *GetAppTableFormReq, options // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTableForm.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTableForm.go func (a *appTableForm) Patch(ctx context.Context, req *PatchAppTableFormReq, options ...larkcore.RequestOptionFunc) (*PatchAppTableFormResp, error) { // 发起请求 apiReq := req.apiReq @@ -834,9 +834,9 @@ func (a *appTableForm) Patch(ctx context.Context, req *PatchAppTableFormReq, opt // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form-field/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form-field/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableFormField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableFormField.go func (a *appTableFormField) List(ctx context.Context, req *ListAppTableFormFieldReq, options ...larkcore.RequestOptionFunc) (*ListAppTableFormFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -870,9 +870,9 @@ func (a *appTableFormField) ListByIterator(ctx context.Context, req *ListAppTabl // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form-field/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-form-field/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTableFormField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTableFormField.go func (a *appTableFormField) Patch(ctx context.Context, req *PatchAppTableFormFieldReq, options ...larkcore.RequestOptionFunc) (*PatchAppTableFormFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -898,9 +898,9 @@ func (a *appTableFormField) Patch(ctx context.Context, req *PatchAppTableFormFie // // - 该接口支持调用频率上限为 10 QPS（Query Per Second，每秒请求率） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchCreate_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchCreate_appTableRecord.go func (a *appTableRecord) BatchCreate(ctx context.Context, req *BatchCreateAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*BatchCreateAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -926,9 +926,9 @@ func (a *appTableRecord) BatchCreate(ctx context.Context, req *BatchCreateAppTab // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchDelete_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchDelete_appTableRecord.go func (a *appTableRecord) BatchDelete(ctx context.Context, req *BatchDeleteAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -954,9 +954,9 @@ func (a *appTableRecord) BatchDelete(ctx context.Context, req *BatchDeleteAppTab // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchUpdate_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/batchUpdate_appTableRecord.go func (a *appTableRecord) BatchUpdate(ctx context.Context, req *BatchUpdateAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*BatchUpdateAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -982,9 +982,9 @@ func (a *appTableRecord) BatchUpdate(ctx context.Context, req *BatchUpdateAppTab // // - 该接口支持调用频率上限为 10 QPS（Query Per Second，每秒请求率） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTableRecord.go func (a *appTableRecord) Create(ctx context.Context, req *CreateAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*CreateAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -1010,9 +1010,9 @@ func (a *appTableRecord) Create(ctx context.Context, req *CreateAppTableRecordRe // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTableRecord.go func (a *appTableRecord) Delete(ctx context.Context, req *DeleteAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*DeleteAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -1038,9 +1038,9 @@ func (a *appTableRecord) Delete(ctx context.Context, req *DeleteAppTableRecordRe // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_appTableRecord.go func (a *appTableRecord) Get(ctx context.Context, req *GetAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*GetAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -1066,9 +1066,9 @@ func (a *appTableRecord) Get(ctx context.Context, req *GetAppTableRecordReq, opt // // - 该接口支持调用频率上限为 10 QPS（Query Per Second，每秒请求率），1000 QPM（Query Per Minute，每分钟请求率） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableRecord.go func (a *appTableRecord) List(ctx context.Context, req *ListAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*ListAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -1102,9 +1102,9 @@ func (a *appTableRecord) ListByIterator(ctx context.Context, req *ListAppTableRe // // - 该接口支持调用频率上限为 10 QPS（Query Per Second，每秒请求率） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_appTableRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/update_appTableRecord.go func (a *appTableRecord) Update(ctx context.Context, req *UpdateAppTableRecordReq, options ...larkcore.RequestOptionFunc) (*UpdateAppTableRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -1130,9 +1130,9 @@ func (a *appTableRecord) Update(ctx context.Context, req *UpdateAppTableRecordRe // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTableView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/create_appTableView.go func (a *appTableView) Create(ctx context.Context, req *CreateAppTableViewReq, options ...larkcore.RequestOptionFunc) (*CreateAppTableViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -1158,9 +1158,9 @@ func (a *appTableView) Create(ctx context.Context, req *CreateAppTableViewReq, o // // - 该接口支持调用频率上限为 10 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTableView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/delete_appTableView.go func (a *appTableView) Delete(ctx context.Context, req *DeleteAppTableViewReq, options ...larkcore.RequestOptionFunc) (*DeleteAppTableViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -1184,9 +1184,9 @@ func (a *appTableView) Delete(ctx context.Context, req *DeleteAppTableViewReq, o // // - 该接口根据 view_id 检索现有视图 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_appTableView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/get_appTableView.go func (a *appTableView) Get(ctx context.Context, req *GetAppTableViewReq, options ...larkcore.RequestOptionFunc) (*GetAppTableViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -1212,9 +1212,9 @@ func (a *appTableView) Get(ctx context.Context, req *GetAppTableViewReq, options // // - 该接口支持调用频率上限为 20 QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/list_appTableView.go func (a *appTableView) List(ctx context.Context, req *ListAppTableViewReq, options ...larkcore.RequestOptionFunc) (*ListAppTableViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -1246,9 +1246,9 @@ func (a *appTableView) ListByIterator(ctx context.Context, req *ListAppTableView // // - 该接口用于增量修改视图信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-view/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTableView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/bitablev1/patch_appTableView.go func (a *appTableView) Patch(ctx context.Context, req *PatchAppTableViewReq, options ...larkcore.RequestOptionFunc) (*PatchAppTableViewResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/bitable/v1/model.go b/service/bitable/v1/model.go index 0b86f1cd..56e3a4e0 100644 --- a/service/bitable/v1/model.go +++ b/service/bitable/v1/model.go @@ -22,27 +22,27 @@ import ( ) const ( - MemberIdTypeOpenID = "open_id" // 以open_id来识别协作者 - MemberIdTypeUnionID = "union_id" // 以union_id来识别协作者 - MemberIdTypeUserID = "user_id" // 以user_id来识别协作者 - MemberIdTypeChatID = "chat_id" // 以chat_id来识别协作者 - MemberIdTypeDepartmentID = "department_id" // 以department_id来识别协作者 - MemberIdTypeOpenDepartmentID = "open_department_id" // 以open_department_id来识别协作者 + MemberIdTypeOpenID = "open_id" // 以 open_id 来识别协作者 + MemberIdTypeUnionID = "union_id" // 以 union_id 来识别协作者 + MemberIdTypeUserID = "user_id" // 以 user_id 来识别协作者 + MemberIdTypeChatID = "chat_id" // 以 chat_id 来识别协作者 + MemberIdTypeDepartmentID = "department_id" // 以 department_id 来识别协作者 + MemberIdTypeOpenDepartmentID = "open_department_id" // 以 open_department_id 来识别协作者 ) const ( - MemberIdTypeDeleteAppRoleMemberOpenID = "open_id" // 以open_id来识别协作者 - MemberIdTypeDeleteAppRoleMemberUnionID = "union_id" // 以union_id来识别协作者 - MemberIdTypeDeleteAppRoleMemberUserID = "user_id" // 以user_id来识别协作者 - MemberIdTypeDeleteAppRoleMemberChatID = "chat_id" // 以chat_id来识别协作者 - MemberIdTypeDeleteAppRoleMemberDepartmentID = "department_id" // 以department_id来识别协作者 - MemberIdTypeDeleteAppRoleMemberOpenDepartmentID = "open_department_id" // 以open_department_id来识别协作者 + MemberIdTypeDeleteAppRoleMemberOpenID = "open_id" // 以 open_id 来识别协作者 + MemberIdTypeDeleteAppRoleMemberUnionID = "union_id" // 以 union_id 来识别协作者 + MemberIdTypeDeleteAppRoleMemberUserID = "user_id" // 以 user_id 来识别协作者 + MemberIdTypeDeleteAppRoleMemberChatID = "chat_id" // 以 chat_id 来识别协作者 + MemberIdTypeDeleteAppRoleMemberDepartmentID = "department_id" // 以 department_id 来识别协作者 + MemberIdTypeDeleteAppRoleMemberOpenDepartmentID = "open_department_id" // 以 open_department_id 来识别协作者 ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -98,39 +98,39 @@ const ( ) const ( - UserIdTypeBatchCreateAppTableRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchCreateAppTableRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchCreateAppTableRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchCreateAppTableRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchCreateAppTableRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchCreateAppTableRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeBatchUpdateAppTableRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchUpdateAppTableRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchUpdateAppTableRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchUpdateAppTableRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchUpdateAppTableRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchUpdateAppTableRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateAppTableRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateAppTableRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateAppTableRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateAppTableRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateAppTableRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateAppTableRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetAppTableRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetAppTableRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetAppTableRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetAppTableRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetAppTableRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetAppTableRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListAppTableRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListAppTableRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListAppTableRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListAppTableRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListAppTableRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListAppTableRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateAppTableRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateAppTableRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateAppTableRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateAppTableRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateAppTableRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateAppTableRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -142,9 +142,9 @@ const ( ) const ( - UserIdTypeListAppTableViewUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListAppTableViewUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListAppTableViewOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListAppTableViewUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListAppTableViewUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListAppTableViewOpenId = "open_id" // 以 open_id 来识别用户 ) type App struct { @@ -271,7 +271,7 @@ func (builder *AppDashboardBuilder) BlockId(blockId string) *AppDashboardBuilder // 仪表盘名字 // -// 示例值：仪表盘1 +// 示例值：仪表盘 1 func (builder *AppDashboardBuilder) Name(name string) *AppDashboardBuilder { builder.name = name builder.nameFlag = true @@ -420,19 +420,19 @@ func (builder *AppFieldPropertyLocationBuilder) Build() *AppFieldPropertyLocatio type AppRole struct { RoleName *string `json:"role_name,omitempty"` // 自定义角色的名字 - RoleId *string `json:"role_id,omitempty"` // 自定义角色的id + RoleId *string `json:"role_id,omitempty"` // 自定义角色的 id TableRoles []*AppRoleTableRole `json:"table_roles,omitempty"` // 数据表角色 - BlockRoles []*AppRoleBlockRole `json:"block_roles,omitempty"` // block权限 + BlockRoles []*AppRoleBlockRole `json:"block_roles,omitempty"` // block 权限 } type AppRoleBuilder struct { roleName string // 自定义角色的名字 roleNameFlag bool - roleId string // 自定义角色的id + roleId string // 自定义角色的 id roleIdFlag bool tableRoles []*AppRoleTableRole // 数据表角色 tableRolesFlag bool - blockRoles []*AppRoleBlockRole // block权限 + blockRoles []*AppRoleBlockRole // block 权限 blockRolesFlag bool } @@ -443,14 +443,14 @@ func NewAppRoleBuilder() *AppRoleBuilder { // 自定义角色的名字 // -// 示例值：自定义角色1 +// 示例值：自定义角色 1 func (builder *AppRoleBuilder) RoleName(roleName string) *AppRoleBuilder { builder.roleName = roleName builder.roleNameFlag = true return builder } -// 自定义角色的id +// 自定义角色的 id // // 示例值：roljRpwIUt func (builder *AppRoleBuilder) RoleId(roleId string) *AppRoleBuilder { @@ -468,7 +468,7 @@ func (builder *AppRoleBuilder) TableRoles(tableRoles []*AppRoleTableRole) *AppRo return builder } -// block权限 +// block 权限 // // 示例值： func (builder *AppRoleBuilder) BlockRoles(blockRoles []*AppRoleBlockRole) *AppRoleBuilder { @@ -498,16 +498,16 @@ func (builder *AppRoleBuilder) Build() *AppRole { type AppRoleBlockRole struct { BlockId *string `json:"block_id,omitempty"` // Block 的 ID，例如列出仪表盘接口中的仪表盘 block id - BlockType *string `json:"block_type,omitempty"` // Block类型 - BlockPerm *int `json:"block_perm,omitempty"` // Block权限 + BlockType *string `json:"block_type,omitempty"` // Block 类型 + BlockPerm *int `json:"block_perm,omitempty"` // Block 权限 } type AppRoleBlockRoleBuilder struct { blockId string // Block 的 ID，例如列出仪表盘接口中的仪表盘 block id blockIdFlag bool - blockType string // Block类型 + blockType string // Block 类型 blockTypeFlag bool - blockPerm int // Block权限 + blockPerm int // Block 权限 blockPermFlag bool } @@ -525,7 +525,7 @@ func (builder *AppRoleBlockRoleBuilder) BlockId(blockId string) *AppRoleBlockRol return builder } -// Block类型 +// Block 类型 // // 示例值：dashboard func (builder *AppRoleBlockRoleBuilder) BlockType(blockType string) *AppRoleBlockRoleBuilder { @@ -534,7 +534,7 @@ func (builder *AppRoleBlockRoleBuilder) BlockType(blockType string) *AppRoleBloc return builder } -// Block权限 +// Block 权限 // // 示例值：0 func (builder *AppRoleBlockRoleBuilder) BlockPerm(blockPerm int) *AppRoleBlockRoleBuilder { @@ -561,7 +561,7 @@ func (builder *AppRoleBlockRoleBuilder) Build() *AppRoleBlockRole { } type AppRoleMember struct { - MemberId *string `json:"member_id,omitempty"` // 协作者id + MemberId *string `json:"member_id,omitempty"` // 协作者 id OpenId *string `json:"open_id,omitempty"` // 用户的 open_id UnionId *string `json:"union_id,omitempty"` // 用户的 union_id UserId *string `json:"user_id,omitempty"` // 用户的 user_id @@ -574,7 +574,7 @@ type AppRoleMember struct { } type AppRoleMemberBuilder struct { - memberId string // 协作者id + memberId string // 协作者 id memberIdFlag bool openId string // 用户的 open_id openIdFlag bool @@ -601,7 +601,7 @@ func NewAppRoleMemberBuilder() *AppRoleMemberBuilder { return builder } -// 协作者id +// 协作者 id // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *AppRoleMemberBuilder) MemberId(memberId string) *AppRoleMemberBuilder { @@ -786,28 +786,28 @@ func (builder *AppRoleMemberIdBuilder) Build() *AppRoleMemberId { type AppRoleTableRole struct { TableName *string `json:"table_name,omitempty"` // 数据表名 - TableId *string `json:"table_id,omitempty"` // 数据表ID + TableId *string `json:"table_id,omitempty"` // 数据表 ID TablePerm *int `json:"table_perm,omitempty"` // 数据表权限，`协作者可编辑自己的记录`和`可编辑指定字段`是`可编辑记录`的特殊情况，可通过指定`rec_rule`或`field_perm`参数实现相同的效果 - RecRule *AppRoleTableRoleRecRule `json:"rec_rule,omitempty"` // 记录筛选条件，在table_perm为1或2时有意义，用于指定可编辑或可阅读某些记录 - FieldPerm *AppRoleTableRoleFieldPerm `json:"field_perm,omitempty"` // 字段权限，仅在table_perm为2时有意义，设置字段可编辑或可阅读。类型为 map，key 是字段名，value 是字段权限;;**value 枚举值有：**;- `1`：可阅读;- `2`：可编辑 - AllowAddRecord *bool `json:"allow_add_record,omitempty"` // 新增记录权限，仅在table_perm为2时有意义，用于设置记录是否可以新增。 - AllowDeleteRecord *bool `json:"allow_delete_record,omitempty"` // 删除记录权限，仅在table_perm为2时有意义，用于设置记录是否可以删除 + RecRule *AppRoleTableRoleRecRule `json:"rec_rule,omitempty"` // 记录筛选条件，在 table_perm 为 1 或 2 时有意义，用于指定可编辑或可阅读某些记录 + FieldPerm *AppRoleTableRoleFieldPerm `json:"field_perm,omitempty"` // 字段权限，仅在 table_perm 为 2 时有意义，设置字段可编辑或可阅读。类型为 map，key 是字段名，value 是字段权限;;**value 枚举值有：**;- `1`：可阅读;- `2`：可编辑 + AllowAddRecord *bool `json:"allow_add_record,omitempty"` // 新增记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以新增。 + AllowDeleteRecord *bool `json:"allow_delete_record,omitempty"` // 删除记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以删除 } type AppRoleTableRoleBuilder struct { tableName string // 数据表名 tableNameFlag bool - tableId string // 数据表ID + tableId string // 数据表 ID tableIdFlag bool tablePerm int // 数据表权限，`协作者可编辑自己的记录`和`可编辑指定字段`是`可编辑记录`的特殊情况，可通过指定`rec_rule`或`field_perm`参数实现相同的效果 tablePermFlag bool - recRule *AppRoleTableRoleRecRule // 记录筛选条件，在table_perm为1或2时有意义，用于指定可编辑或可阅读某些记录 + recRule *AppRoleTableRoleRecRule // 记录筛选条件，在 table_perm 为 1 或 2 时有意义，用于指定可编辑或可阅读某些记录 recRuleFlag bool - fieldPerm *AppRoleTableRoleFieldPerm // 字段权限，仅在table_perm为2时有意义，设置字段可编辑或可阅读。类型为 map，key 是字段名，value 是字段权限;;**value 枚举值有：**;- `1`：可阅读;- `2`：可编辑 + fieldPerm *AppRoleTableRoleFieldPerm // 字段权限，仅在 table_perm 为 2 时有意义，设置字段可编辑或可阅读。类型为 map，key 是字段名，value 是字段权限;;**value 枚举值有：**;- `1`：可阅读;- `2`：可编辑 fieldPermFlag bool - allowAddRecord bool // 新增记录权限，仅在table_perm为2时有意义，用于设置记录是否可以新增。 + allowAddRecord bool // 新增记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以新增。 allowAddRecordFlag bool - allowDeleteRecord bool // 删除记录权限，仅在table_perm为2时有意义，用于设置记录是否可以删除 + allowDeleteRecord bool // 删除记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以删除 allowDeleteRecordFlag bool } @@ -818,14 +818,14 @@ func NewAppRoleTableRoleBuilder() *AppRoleTableRoleBuilder { // 数据表名 // -// 示例值：数据表1 +// 示例值：数据表 1 func (builder *AppRoleTableRoleBuilder) TableName(tableName string) *AppRoleTableRoleBuilder { builder.tableName = tableName builder.tableNameFlag = true return builder } -// 数据表ID +// 数据表 ID // // 示例值：tblKz5D60T4JlfcT func (builder *AppRoleTableRoleBuilder) TableId(tableId string) *AppRoleTableRoleBuilder { @@ -843,7 +843,7 @@ func (builder *AppRoleTableRoleBuilder) TablePerm(tablePerm int) *AppRoleTableRo return builder } -// 记录筛选条件，在table_perm为1或2时有意义，用于指定可编辑或可阅读某些记录 +// 记录筛选条件，在 table_perm 为 1 或 2 时有意义，用于指定可编辑或可阅读某些记录 // // 示例值： func (builder *AppRoleTableRoleBuilder) RecRule(recRule *AppRoleTableRoleRecRule) *AppRoleTableRoleBuilder { @@ -852,7 +852,7 @@ func (builder *AppRoleTableRoleBuilder) RecRule(recRule *AppRoleTableRoleRecRule return builder } -// 字段权限，仅在table_perm为2时有意义，设置字段可编辑或可阅读。类型为 map，key 是字段名，value 是字段权限;;**value 枚举值有：**;- `1`：可阅读;- `2`：可编辑 +// 字段权限，仅在 table_perm 为 2 时有意义，设置字段可编辑或可阅读。类型为 map，key 是字段名，value 是字段权限;;**value 枚举值有：**;- `1`：可阅读;- `2`：可编辑 // // 示例值：{"姓名": 1, "年龄": 2} func (builder *AppRoleTableRoleBuilder) FieldPerm(fieldPerm *AppRoleTableRoleFieldPerm) *AppRoleTableRoleBuilder { @@ -861,7 +861,7 @@ func (builder *AppRoleTableRoleBuilder) FieldPerm(fieldPerm *AppRoleTableRoleFie return builder } -// 新增记录权限，仅在table_perm为2时有意义，用于设置记录是否可以新增。 +// 新增记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以新增。 // // 示例值：true func (builder *AppRoleTableRoleBuilder) AllowAddRecord(allowAddRecord bool) *AppRoleTableRoleBuilder { @@ -870,7 +870,7 @@ func (builder *AppRoleTableRoleBuilder) AllowAddRecord(allowAddRecord bool) *App return builder } -// 删除记录权限，仅在table_perm为2时有意义，用于设置记录是否可以删除 +// 删除记录权限，仅在 table_perm 为 2 时有意义，用于设置记录是否可以删除 // // 示例值：true func (builder *AppRoleTableRoleBuilder) AllowDeleteRecord(allowDeleteRecord bool) *AppRoleTableRoleBuilder { @@ -916,7 +916,7 @@ type AppRoleTableRoleFieldPerm struct { type AppRoleTableRoleRecRule struct { Conditions []*AppRoleTableRoleRecRuleCondition `json:"conditions,omitempty"` // 记录筛选条件 Conjunction *string `json:"conjunction,omitempty"` // 多个筛选条件的关系 - OtherPerm *int `json:"other_perm,omitempty"` // 其他记录权限，仅在table_perm为2时有意义 + OtherPerm *int `json:"other_perm,omitempty"` // 其他记录权限，仅在 table_perm 为 2 时有意义 } type AppRoleTableRoleRecRuleBuilder struct { @@ -924,7 +924,7 @@ type AppRoleTableRoleRecRuleBuilder struct { conditionsFlag bool conjunction string // 多个筛选条件的关系 conjunctionFlag bool - otherPerm int // 其他记录权限，仅在table_perm为2时有意义 + otherPerm int // 其他记录权限，仅在 table_perm 为 2 时有意义 otherPermFlag bool } @@ -951,7 +951,7 @@ func (builder *AppRoleTableRoleRecRuleBuilder) Conjunction(conjunction string) * return builder } -// 其他记录权限，仅在table_perm为2时有意义 +// 其他记录权限，仅在 table_perm 为 2 时有意义 // // 示例值：0 func (builder *AppRoleTableRoleRecRuleBuilder) OtherPerm(otherPerm int) *AppRoleTableRoleRecRuleBuilder { @@ -979,7 +979,7 @@ func (builder *AppRoleTableRoleRecRuleBuilder) Build() *AppRoleTableRoleRecRule type AppRoleTableRoleRecRuleCondition struct { FieldName *string `json:"field_name,omitempty"` // 字段名，记录筛选条件是`创建人包含访问者本人`时，此参数值为"" Operator *string `json:"operator,omitempty"` // 运算符 - Value []string `json:"value,omitempty"` // 单选或多选字段的选项id + Value []string `json:"value,omitempty"` // 单选或多选字段的选项 id FieldType *int `json:"field_type,omitempty"` // 字段类型 } @@ -988,7 +988,7 @@ type AppRoleTableRoleRecRuleConditionBuilder struct { fieldNameFlag bool operator string // 运算符 operatorFlag bool - value []string // 单选或多选字段的选项id + value []string // 单选或多选字段的选项 id valueFlag bool fieldType int // 字段类型 fieldTypeFlag bool @@ -1017,7 +1017,7 @@ func (builder *AppRoleTableRoleRecRuleConditionBuilder) Operator(operator string return builder } -// 单选或多选字段的选项id +// 单选或多选字段的选项 id // // 示例值：["optbdVHf4q", "optrpd3eIJ"] func (builder *AppRoleTableRoleRecRuleConditionBuilder) Value(value []string) *AppRoleTableRoleRecRuleConditionBuilder { @@ -1120,7 +1120,7 @@ func (builder *AppTableBuilder) Build() *AppTable { } type AppTableCreateHeader struct { - FieldId *string `json:"field_id,omitempty"` // 字段Id + FieldId *string `json:"field_id,omitempty"` // 字段 Id FieldName *string `json:"field_name,omitempty"` // 字段名 Type *int `json:"type,omitempty"` // 字段类型 Property *AppTableFieldProperty `json:"property,omitempty"` // 字段属性 @@ -1128,7 +1128,7 @@ type AppTableCreateHeader struct { } type AppTableCreateHeaderBuilder struct { - fieldId string // 字段Id + fieldId string // 字段 Id fieldIdFlag bool fieldName string // 字段名 fieldNameFlag bool @@ -1145,7 +1145,7 @@ func NewAppTableCreateHeaderBuilder() *AppTableCreateHeaderBuilder { return builder } -// 字段Id +// 字段 Id // // 示例值：fldDOzItFG func (builder *AppTableCreateHeaderBuilder) FieldId(fieldId string) *AppTableCreateHeaderBuilder { @@ -1340,12 +1340,12 @@ func (builder *AppTableFieldBuilder) Build() *AppTableField { } type AppTableFieldDescription struct { - DisableSync *bool `json:"disable_sync,omitempty"` // 是否禁止同步，如果为true，表示禁止同步该描述内容到表单的问题描述（只在新增、修改字段时生效） + DisableSync *bool `json:"disable_sync,omitempty"` // 是否禁止同步，如果为 true，表示禁止同步该描述内容到表单的问题描述（只在新增、修改字段时生效） Text *string `json:"text,omitempty"` // 字段描述内容 } type AppTableFieldDescriptionBuilder struct { - disableSync bool // 是否禁止同步，如果为true，表示禁止同步该描述内容到表单的问题描述（只在新增、修改字段时生效） + disableSync bool // 是否禁止同步，如果为 true，表示禁止同步该描述内容到表单的问题描述（只在新增、修改字段时生效） disableSyncFlag bool text string // 字段描述内容 textFlag bool @@ -1356,7 +1356,7 @@ func NewAppTableFieldDescriptionBuilder() *AppTableFieldDescriptionBuilder { return builder } -// 是否禁止同步，如果为true，表示禁止同步该描述内容到表单的问题描述（只在新增、修改字段时生效） +// 是否禁止同步，如果为 true，表示禁止同步该描述内容到表单的问题描述（只在新增、修改字段时生效） // // 示例值：ture func (builder *AppTableFieldDescriptionBuilder) DisableSync(disableSync bool) *AppTableFieldDescriptionBuilder { @@ -1393,7 +1393,7 @@ type AppTableFieldProperty struct { DateFormatter *string `json:"date_formatter,omitempty"` // 日期、创建时间、最后更新时间字段的显示格式 AutoFill *bool `json:"auto_fill,omitempty"` // 日期字段中新纪录自动填写创建时间 Multiple *bool `json:"multiple,omitempty"` // 人员字段中允许添加多个成员，单向关联、双向关联中允许添加多个记录 - TableId *string `json:"table_id,omitempty"` // 单向关联、双向关联字段中关联的数据表的id + TableId *string `json:"table_id,omitempty"` // 单向关联、双向关联字段中关联的数据表的 id TableName *string `json:"table_name,omitempty"` // 单向关联、双向关联字段中关联的数据表的名字 BackFieldName *string `json:"back_field_name,omitempty"` // 双向关联字段中关联的数据表中对应的双向关联字段的名字 AutoSerial *AppFieldPropertyAutoSerial `json:"auto_serial,omitempty"` // 自动编号类型 @@ -1412,7 +1412,7 @@ type AppTableFieldPropertyBuilder struct { autoFillFlag bool multiple bool // 人员字段中允许添加多个成员，单向关联、双向关联中允许添加多个记录 multipleFlag bool - tableId string // 单向关联、双向关联字段中关联的数据表的id + tableId string // 单向关联、双向关联字段中关联的数据表的 id tableIdFlag bool tableName string // 单向关联、双向关联字段中关联的数据表的名字 tableNameFlag bool @@ -1476,7 +1476,7 @@ func (builder *AppTableFieldPropertyBuilder) Multiple(multiple bool) *AppTableFi return builder } -// 单向关联、双向关联字段中关联的数据表的id +// 单向关联、双向关联字段中关联的数据表的 id // // 示例值：tblsRc9GRRXKqhvW func (builder *AppTableFieldPropertyBuilder) TableId(tableId string) *AppTableFieldPropertyBuilder { @@ -1950,7 +1950,7 @@ type AppTableRecord struct { CreatedTime *int64 `json:"created_time,omitempty"` // 该记录的创建时间 LastModifiedBy *Person `json:"last_modified_by,omitempty"` // 该记录最新一次更新的修改人 LastModifiedTime *int64 `json:"last_modified_time,omitempty"` // 该记录最近一次的更新时间 - Fields map[string]interface{} `json:"fields,omitempty"` // 数据表的字段，即数据表的列;;当前接口支持的字段类型请参考[接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c);;不同类型字段的数据结构请参考[数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) + Fields map[string]interface{} `json:"fields,omitempty"` // 数据表的字段，即数据表的列;;当前接口支持的字段类型请参考 [接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c);;不同类型字段的数据结构请参考 [数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) } type AppTableRecordBuilder struct { @@ -1964,7 +1964,7 @@ type AppTableRecordBuilder struct { lastModifiedByFlag bool lastModifiedTime int64 // 该记录最近一次的更新时间 lastModifiedTimeFlag bool - fields map[string]interface{} // 数据表的字段，即数据表的列;;当前接口支持的字段类型请参考[接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c);;不同类型字段的数据结构请参考[数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) + fields map[string]interface{} // 数据表的字段，即数据表的列;;当前接口支持的字段类型请参考 [接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c);;不同类型字段的数据结构请参考 [数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) fieldsFlag bool } @@ -2018,7 +2018,7 @@ func (builder *AppTableRecordBuilder) LastModifiedTime(lastModifiedTime int64) * return builder } -// 数据表的字段，即数据表的列;;当前接口支持的字段类型请参考[接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c);;不同类型字段的数据结构请参考[数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) +// 数据表的字段，即数据表的列;;当前接口支持的字段类型请参考 [接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c);;不同类型字段的数据结构请参考 [数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) // // 示例值： func (builder *AppTableRecordBuilder) Fields(fields map[string]interface{}) *AppTableRecordBuilder { @@ -2054,16 +2054,16 @@ func (builder *AppTableRecordBuilder) Build() *AppTableRecord { } type AppTableView struct { - ViewId *string `json:"view_id,omitempty"` // 视图Id + ViewId *string `json:"view_id,omitempty"` // 视图 Id ViewName *string `json:"view_name,omitempty"` // 视图名字 ViewType *string `json:"view_type,omitempty"` // 视图类型 Property *AppTableViewProperty `json:"property,omitempty"` // 视图属性 ViewPublicLevel *string `json:"view_public_level,omitempty"` // 视图公共等级 Public、Locked、Private - ViewPrivateOwnerId *string `json:"view_private_owner_id,omitempty"` // 个人视图的owner_id，id类型和 user_id_type 参数保持一致 + ViewPrivateOwnerId *string `json:"view_private_owner_id,omitempty"` // 个人视图的 owner_id，id 类型和 user_id_type 参数保持一致 } type AppTableViewBuilder struct { - viewId string // 视图Id + viewId string // 视图 Id viewIdFlag bool viewName string // 视图名字 viewNameFlag bool @@ -2073,7 +2073,7 @@ type AppTableViewBuilder struct { propertyFlag bool viewPublicLevel string // 视图公共等级 Public、Locked、Private viewPublicLevelFlag bool - viewPrivateOwnerId string // 个人视图的owner_id，id类型和 user_id_type 参数保持一致 + viewPrivateOwnerId string // 个人视图的 owner_id，id 类型和 user_id_type 参数保持一致 viewPrivateOwnerIdFlag bool } @@ -2082,7 +2082,7 @@ func NewAppTableViewBuilder() *AppTableViewBuilder { return builder } -// 视图Id +// 视图 Id // // 示例值：vewTpR1urY func (builder *AppTableViewBuilder) ViewId(viewId string) *AppTableViewBuilder { @@ -2093,7 +2093,7 @@ func (builder *AppTableViewBuilder) ViewId(viewId string) *AppTableViewBuilder { // 视图名字 // -// 示例值：甘特视图1 +// 示例值：甘特视图 1 func (builder *AppTableViewBuilder) ViewName(viewName string) *AppTableViewBuilder { builder.viewName = viewName builder.viewNameFlag = true @@ -2127,7 +2127,7 @@ func (builder *AppTableViewBuilder) ViewPublicLevel(viewPublicLevel string) *App return builder } -// 个人视图的owner_id，id类型和 user_id_type 参数保持一致 +// 个人视图的 owner_id，id 类型和 user_id_type 参数保持一致 // // 示例值：ou_2910013f1e6456f16a0ce75ede950a0a func (builder *AppTableViewBuilder) ViewPrivateOwnerId(viewPrivateOwnerId string) *AppTableViewBuilder { @@ -2166,13 +2166,13 @@ func (builder *AppTableViewBuilder) Build() *AppTableView { type AppTableViewProperty struct { FilterInfo *AppTableViewPropertyFilterInfo `json:"filter_info,omitempty"` // 过滤条件 - HiddenFields []string `json:"hidden_fields,omitempty"` // 隐藏字段ID列表 + HiddenFields []string `json:"hidden_fields,omitempty"` // 隐藏字段 ID 列表 } type AppTableViewPropertyBuilder struct { filterInfo *AppTableViewPropertyFilterInfo // 过滤条件 filterInfoFlag bool - hiddenFields []string // 隐藏字段ID列表 + hiddenFields []string // 隐藏字段 ID 列表 hiddenFieldsFlag bool } @@ -2190,7 +2190,7 @@ func (builder *AppTableViewPropertyBuilder) FilterInfo(filterInfo *AppTableViewP return builder } -// 隐藏字段ID列表 +// 隐藏字段 ID 列表 // // 示例值：["fldCGzANXx", "fldCGzANXx"] func (builder *AppTableViewPropertyBuilder) HiddenFields(hiddenFields []string) *AppTableViewPropertyBuilder { @@ -2274,21 +2274,21 @@ func (builder *AppTableViewPropertyFilterInfoBuilder) Build() *AppTableViewPrope } type AppTableViewPropertyFilterInfoCondition struct { - FieldId *string `json:"field_id,omitempty"` // 用于过滤的字段唯一ID + FieldId *string `json:"field_id,omitempty"` // 用于过滤的字段唯一 ID Operator *string `json:"operator,omitempty"` // 过滤操作的类型 Value *string `json:"value,omitempty"` // 筛选值 - ConditionId *string `json:"condition_id,omitempty"` // 过滤条件的唯一ID + ConditionId *string `json:"condition_id,omitempty"` // 过滤条件的唯一 ID FieldType *string `json:"field_type,omitempty"` // 用于过滤的字段类型 } type AppTableViewPropertyFilterInfoConditionBuilder struct { - fieldId string // 用于过滤的字段唯一ID + fieldId string // 用于过滤的字段唯一 ID fieldIdFlag bool operator string // 过滤操作的类型 operatorFlag bool value string // 筛选值 valueFlag bool - conditionId string // 过滤条件的唯一ID + conditionId string // 过滤条件的唯一 ID conditionIdFlag bool fieldType string // 用于过滤的字段类型 fieldTypeFlag bool @@ -2299,7 +2299,7 @@ func NewAppTableViewPropertyFilterInfoConditionBuilder() *AppTableViewPropertyFi return builder } -// 用于过滤的字段唯一ID +// 用于过滤的字段唯一 ID // // 示例值：单选 func (builder *AppTableViewPropertyFilterInfoConditionBuilder) FieldId(fieldId string) *AppTableViewPropertyFilterInfoConditionBuilder { @@ -2326,7 +2326,7 @@ func (builder *AppTableViewPropertyFilterInfoConditionBuilder) Value(value strin return builder } -// 过滤条件的唯一ID +// 过滤条件的唯一 ID // // 示例值：conNaOEK6O func (builder *AppTableViewPropertyFilterInfoConditionBuilder) ConditionId(conditionId string) *AppTableViewPropertyFilterInfoConditionBuilder { @@ -2532,7 +2532,7 @@ func (builder *DeleteRecordBuilder) Build() *DeleteRecord { type DisplayApp struct { AppToken *string `json:"app_token,omitempty"` // 多维表格的 app_token;[app_token 参数说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#8121eebe) Name *string `json:"name,omitempty"` // 多维表格的名字 - Revision *int `json:"revision,omitempty"` // 多维表格的版本号（对多维表格进行修改时更新，如新增、删除数据表，修改数据表名等，初始为1，每次更新+1） + Revision *int `json:"revision,omitempty"` // 多维表格的版本号（对多维表格进行修改时更新，如新增、删除数据表，修改数据表名等，初始为 1，每次更新 +1） IsAdvanced *bool `json:"is_advanced,omitempty"` // 多维表格是否开启了高级权限。取值包括：;- true：表示开启了高级权限;- false：表示关闭了高级权限;;[了解更多：使用多维表格高级权限](https://www.feishu.cn/hc/zh-CN/articles/588604550568) } @@ -2541,7 +2541,7 @@ type DisplayAppBuilder struct { appTokenFlag bool name string // 多维表格的名字 nameFlag bool - revision int // 多维表格的版本号（对多维表格进行修改时更新，如新增、删除数据表，修改数据表名等，初始为1，每次更新+1） + revision int // 多维表格的版本号（对多维表格进行修改时更新，如新增、删除数据表，修改数据表名等，初始为 1，每次更新 +1） revisionFlag bool isAdvanced bool // 多维表格是否开启了高级权限。取值包括：;- true：表示开启了高级权限;- false：表示关闭了高级权限;;[了解更多：使用多维表格高级权限](https://www.feishu.cn/hc/zh-CN/articles/588604550568) isAdvancedFlag bool @@ -2570,7 +2570,7 @@ func (builder *DisplayAppBuilder) Name(name string) *DisplayAppBuilder { return builder } -// 多维表格的版本号（对多维表格进行修改时更新，如新增、删除数据表，修改数据表名等，初始为1，每次更新+1） +// 多维表格的版本号（对多维表格进行修改时更新，如新增、删除数据表，修改数据表名等，初始为 1，每次更新 +1） // // 示例值： func (builder *DisplayAppBuilder) Revision(revision int) *DisplayAppBuilder { @@ -2743,7 +2743,7 @@ func (builder *LocationBuilder) Adname(adname string) *LocationBuilder { // 详细地址 // -// 示例值：深圳湾创新科技中心(科苑地铁站C口步行340米) +// 示例值：深圳湾创新科技中心 (科苑地铁站 C 口步行 340 米) func (builder *LocationBuilder) Address(address string) *LocationBuilder { builder.address = address builder.addressFlag = true @@ -2761,7 +2761,7 @@ func (builder *LocationBuilder) Name(name string) *LocationBuilder { // 完整地址 // -// 示例值：字节跳动，广东省深圳市南山区深圳湾创新科技中心(科苑地铁站C口步行340米) +// 示例值：字节跳动，广东省深圳市南山区深圳湾创新科技中心 (科苑地铁站 C 口步行 340 米) func (builder *LocationBuilder) FullAddress(fullAddress string) *LocationBuilder { builder.fullAddress = fullAddress builder.fullAddressFlag = true @@ -2802,7 +2802,7 @@ func (builder *LocationBuilder) Build() *Location { } type Person struct { - Id *string `json:"id,omitempty"` // 用户id，id类型等于user_id_type所指定的类型。 + Id *string `json:"id,omitempty"` // 用户 id，id 类型等于 user_id_type 所指定的类型。 Name *string `json:"name,omitempty"` // 用户的中文名称 EnName *string `json:"en_name,omitempty"` // 用户的英文名称 Email *string `json:"email,omitempty"` // 用户的邮箱 @@ -2810,7 +2810,7 @@ type Person struct { } type PersonBuilder struct { - id string // 用户id，id类型等于user_id_type所指定的类型。 + id string // 用户 id，id 类型等于 user_id_type 所指定的类型。 idFlag bool name string // 用户的中文名称 nameFlag bool @@ -2827,7 +2827,7 @@ func NewPersonBuilder() *PersonBuilder { return builder } -// 用户id，id类型等于user_id_type所指定的类型。 +// 用户 id，id 类型等于 user_id_type 所指定的类型。 // // 示例值：testesttest func (builder *PersonBuilder) Id(id string) *PersonBuilder { @@ -2898,14 +2898,14 @@ func (builder *PersonBuilder) Build() *Person { } type ReqApp struct { - Name *string `json:"name,omitempty"` // 多维表格App名字 - FolderToken *string `json:"folder_token,omitempty"` // 多维表格App归属文件夹 + Name *string `json:"name,omitempty"` // 多维表格 App 名字 + FolderToken *string `json:"folder_token,omitempty"` // 多维表格 App 归属文件夹 } type ReqAppBuilder struct { - name string // 多维表格App名字 + name string // 多维表格 App 名字 nameFlag bool - folderToken string // 多维表格App归属文件夹 + folderToken string // 多维表格 App 归属文件夹 folderTokenFlag bool } @@ -2914,7 +2914,7 @@ func NewReqAppBuilder() *ReqAppBuilder { return builder } -// 多维表格App名字 +// 多维表格 App 名字 // // 示例值：一篇新的多维表格 func (builder *ReqAppBuilder) Name(name string) *ReqAppBuilder { @@ -2923,7 +2923,7 @@ func (builder *ReqAppBuilder) Name(name string) *ReqAppBuilder { return builder } -// 多维表格App归属文件夹 +// 多维表格 App 归属文件夹 // // 示例值：fldbcoh8O99CIMltVc func (builder *ReqAppBuilder) FolderToken(folderToken string) *ReqAppBuilder { @@ -2948,7 +2948,7 @@ func (builder *ReqAppBuilder) Build() *ReqApp { type ReqTable struct { Name *string `json:"name,omitempty"` // 数据表名字，必填字段 DefaultViewName *string `json:"default_view_name,omitempty"` // 默认表格视图的名称 - Fields []*AppTableCreateHeader `json:"fields,omitempty"` // 允许设置数据表的初始字段,默认第一个字段为索引列 + Fields []*AppTableCreateHeader `json:"fields,omitempty"` // 允许设置数据表的初始字段，默认第一个字段为索引列 } type ReqTableBuilder struct { @@ -2956,7 +2956,7 @@ type ReqTableBuilder struct { nameFlag bool defaultViewName string // 默认表格视图的名称 defaultViewNameFlag bool - fields []*AppTableCreateHeader // 允许设置数据表的初始字段,默认第一个字段为索引列 + fields []*AppTableCreateHeader // 允许设置数据表的初始字段，默认第一个字段为索引列 fieldsFlag bool } @@ -2983,7 +2983,7 @@ func (builder *ReqTableBuilder) DefaultViewName(defaultViewName string) *ReqTabl return builder } -// 允许设置数据表的初始字段,默认第一个字段为索引列 +// 允许设置数据表的初始字段，默认第一个字段为索引列 // // 示例值： func (builder *ReqTableBuilder) Fields(fields []*AppTableCreateHeader) *ReqTableBuilder { @@ -3027,7 +3027,7 @@ func NewReqViewBuilder() *ReqViewBuilder { // 视图名字 // -// 示例值：表格视图1 +// 示例值：表格视图 1 func (builder *ReqViewBuilder) ViewName(viewName string) *ReqViewBuilder { builder.viewName = viewName builder.viewNameFlag = true @@ -3126,7 +3126,7 @@ func (builder *CreateAppReqBuilder) CustomizedConfig(customizedConfig bool) *Cre return builder } -// 源app，当使用自定义配置创建方式时有效 +// 源 app，当使用自定义配置创建方式时有效 // // 示例值：Xm5EbPVCInfoqRs0HKBbyIBjc1g func (builder *CreateAppReqBuilder) SourceAppToken(sourceAppToken string) *CreateAppReqBuilder { @@ -3134,7 +3134,7 @@ func (builder *CreateAppReqBuilder) SourceAppToken(sourceAppToken string) *Creat return builder } -// 定制化权限配置类型列表，1为协作者列表，2为高级权限，类型是string +// 定制化权限配置类型列表，1 为协作者列表，2 为高级权限，类型是 string // // 示例值： func (builder *CreateAppReqBuilder) CopyTypes(copyTypes []string) *CreateAppReqBuilder { @@ -3144,7 +3144,7 @@ func (builder *CreateAppReqBuilder) CopyTypes(copyTypes []string) *CreateAppReqB return builder } -// 只有旧逻辑场景才会用到，为new时会在旧逻辑场景切换到新场景，方便旧逻辑的业务方进行切换 +// 只有旧逻辑场景才会用到，为 new 时会在旧逻辑场景切换到新场景，方便旧逻辑的业务方进行切换 // // 示例值：new func (builder *CreateAppReqBuilder) ApiType(apiType string) *CreateAppReqBuilder { @@ -3646,7 +3646,7 @@ func (builder *DeleteAppRoleReqBuilder) AppToken(appToken string) *DeleteAppRole return builder } -// 自定义角色的id +// 自定义角色的 id // // 示例值：roljRpwIUt func (builder *DeleteAppRoleReqBuilder) RoleId(roleId string) *DeleteAppRoleReqBuilder { @@ -3735,7 +3735,7 @@ type ListAppRoleReq struct { type ListAppRoleRespData struct { Items []*AppRole `json:"items,omitempty"` // 自定义角色列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 Total *int `json:"total,omitempty"` // 总数 } @@ -3772,7 +3772,7 @@ func (builder *UpdateAppRoleReqBuilder) AppToken(appToken string) *UpdateAppRole return builder } -// 自定义角色的id +// 自定义角色的 id // // 示例值：roljRpwIUt func (builder *UpdateAppRoleReqBuilder) RoleId(roleId string) *UpdateAppRoleReqBuilder { @@ -4067,7 +4067,7 @@ func (builder *CreateAppRoleMemberReqBuilder) AppToken(appToken string) *CreateA return builder } -// 自定义角色的id +// 自定义角色的 id // // 示例值：roljRpwIUt func (builder *CreateAppRoleMemberReqBuilder) RoleId(roleId string) *CreateAppRoleMemberReqBuilder { @@ -4075,7 +4075,7 @@ func (builder *CreateAppRoleMemberReqBuilder) RoleId(roleId string) *CreateAppRo return builder } -// 协作者id类型，与请求体中的member_id要对应 +// 协作者 id 类型，与请求体中的 member_id 要对应 // // 示例值：open_id func (builder *CreateAppRoleMemberReqBuilder) MemberIdType(memberIdType string) *CreateAppRoleMemberReqBuilder { @@ -4133,7 +4133,7 @@ func (builder *DeleteAppRoleMemberReqBuilder) AppToken(appToken string) *DeleteA return builder } -// 自定义角色的id +// 自定义角色的 id // // 示例值：roljRpwIUt func (builder *DeleteAppRoleMemberReqBuilder) RoleId(roleId string) *DeleteAppRoleMemberReqBuilder { @@ -4141,7 +4141,7 @@ func (builder *DeleteAppRoleMemberReqBuilder) RoleId(roleId string) *DeleteAppRo return builder } -// 协作者id +// 协作者 id // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad53uew2 func (builder *DeleteAppRoleMemberReqBuilder) MemberId(memberId string) *DeleteAppRoleMemberReqBuilder { @@ -4149,7 +4149,7 @@ func (builder *DeleteAppRoleMemberReqBuilder) MemberId(memberId string) *DeleteA return builder } -// 协作者id类型，与请求体中的member_id要对应 +// 协作者 id 类型，与请求体中的 member_id 要对应 // // 示例值：open_id func (builder *DeleteAppRoleMemberReqBuilder) MemberIdType(memberIdType string) *DeleteAppRoleMemberReqBuilder { @@ -4206,7 +4206,7 @@ func (builder *ListAppRoleMemberReqBuilder) AppToken(appToken string) *ListAppRo return builder } -// 自定义角色的id +// 自定义角色的 id // // 示例值：roljRpwIUt func (builder *ListAppRoleMemberReqBuilder) RoleId(roleId string) *ListAppRoleMemberReqBuilder { @@ -4248,7 +4248,7 @@ type ListAppRoleMemberReq struct { type ListAppRoleMemberRespData struct { Items []*AppRoleMember `json:"items,omitempty"` // 协作者列表 HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Total *int `json:"total,omitempty"` // 总数 } @@ -4338,7 +4338,7 @@ func (builder *BatchCreateAppTableReqBuilder) AppToken(appToken string) *BatchCr return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchCreateAppTableReqBuilder) UserIdType(userIdType string) *BatchCreateAppTableReqBuilder { @@ -4385,7 +4385,7 @@ func (resp *BatchCreateAppTableResp) Success() bool { } type BatchDeleteAppTableReqBodyBuilder struct { - tableIds []string // 删除的多条tableid列表 + tableIds []string // 删除的多条 tableid 列表 tableIdsFlag bool } @@ -4394,7 +4394,7 @@ func NewBatchDeleteAppTableReqBodyBuilder() *BatchDeleteAppTableReqBodyBuilder { return builder } -// 删除的多条tableid列表 +// 删除的多条 tableid 列表 // //示例值：["tblsRc9GRRXKqhvW"] func (builder *BatchDeleteAppTableReqBodyBuilder) TableIds(tableIds []string) *BatchDeleteAppTableReqBodyBuilder { @@ -4412,7 +4412,7 @@ func (builder *BatchDeleteAppTableReqBodyBuilder) Build() *BatchDeleteAppTableRe } type BatchDeleteAppTablePathReqBodyBuilder struct { - tableIds []string // 删除的多条tableid列表 + tableIds []string // 删除的多条 tableid 列表 tableIdsFlag bool } @@ -4421,7 +4421,7 @@ func NewBatchDeleteAppTablePathReqBodyBuilder() *BatchDeleteAppTablePathReqBodyB return builder } -// 删除的多条tableid列表 +// 删除的多条 tableid 列表 // // 示例值：["tblsRc9GRRXKqhvW"] func (builder *BatchDeleteAppTablePathReqBodyBuilder) TableIds(tableIds []string) *BatchDeleteAppTablePathReqBodyBuilder { @@ -4475,7 +4475,7 @@ func (builder *BatchDeleteAppTableReqBuilder) Build() *BatchDeleteAppTableReq { } type BatchDeleteAppTableReqBody struct { - TableIds []string `json:"table_ids,omitempty"` // 删除的多条tableid列表 + TableIds []string `json:"table_ids,omitempty"` // 删除的多条 tableid 列表 } type BatchDeleteAppTableReq struct { @@ -4593,8 +4593,8 @@ type CreateAppTableReq struct { type CreateAppTableRespData struct { TableId *string `json:"table_id,omitempty"` // table id - DefaultViewId *string `json:"default_view_id,omitempty"` // 默认表格视图的id，该字段仅在请求参数中填写了default_view_name或fields才会返回 - FieldIdList []string `json:"field_id_list,omitempty"` // 数据表初始字段的id列表，该字段仅在请求参数中填写了fields才会返回 + DefaultViewId *string `json:"default_view_id,omitempty"` // 默认表格视图的 id，该字段仅在请求参数中填写了 default_view_name 或 fields 才会返回 + FieldIdList []string `json:"field_id_list,omitempty"` // 数据表初始字段的 id 列表，该字段仅在请求参数中填写了 fields 才会返回 } type CreateAppTableResp struct { @@ -4717,7 +4717,7 @@ type ListAppTableReq struct { type ListAppTableRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Total *int `json:"total,omitempty"` // 总数 Items []*AppTable `json:"items,omitempty"` // 数据表信息 } @@ -5032,7 +5032,7 @@ func (builder *ListAppTableFieldReqBuilder) ViewId(viewId string) *ListAppTableF return builder } -// 控制字段描述（多行文本格式）数据的返回格式, true 表示以数组富文本形式返回 +// 控制字段描述（多行文本格式）数据的返回格式，true 表示以数组富文本形式返回 // // 示例值：true func (builder *ListAppTableFieldReqBuilder) TextFieldAsArray(textFieldAsArray bool) *ListAppTableFieldReqBuilder { @@ -5073,7 +5073,7 @@ type ListAppTableFieldReq struct { type ListAppTableFieldRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Total *int `json:"total,omitempty"` // 总数 Items []*AppTableField `json:"items,omitempty"` // 字段信息 } @@ -5369,7 +5369,7 @@ type ListAppTableFormFieldReq struct { type ListAppTableFormFieldRespData struct { Items []*AppTableFormField `json:"items,omitempty"` // 表单问题信息 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token HasMore *bool `json:"has_more,omitempty"` // 是否有下一页 Total *int `json:"total,omitempty"` // 总数 } @@ -5547,7 +5547,7 @@ func (builder *BatchCreateAppTableRecordReqBuilder) TableId(tableId string) *Bat return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchCreateAppTableRecordReqBuilder) UserIdType(userIdType string) *BatchCreateAppTableRecordReqBuilder { @@ -5602,7 +5602,7 @@ func (resp *BatchCreateAppTableRecordResp) Success() bool { } type BatchDeleteAppTableRecordReqBodyBuilder struct { - records []string // 删除的多条记录id列表 + records []string // 删除的多条记录 id 列表 recordsFlag bool } @@ -5611,7 +5611,7 @@ func NewBatchDeleteAppTableRecordReqBodyBuilder() *BatchDeleteAppTableRecordReqB return builder } -// 删除的多条记录id列表 +// 删除的多条记录 id 列表 // //示例值：[; "recIcJBbvC",; "recvmiCORa";] func (builder *BatchDeleteAppTableRecordReqBodyBuilder) Records(records []string) *BatchDeleteAppTableRecordReqBodyBuilder { @@ -5629,7 +5629,7 @@ func (builder *BatchDeleteAppTableRecordReqBodyBuilder) Build() *BatchDeleteAppT } type BatchDeleteAppTableRecordPathReqBodyBuilder struct { - records []string // 删除的多条记录id列表 + records []string // 删除的多条记录 id 列表 recordsFlag bool } @@ -5638,7 +5638,7 @@ func NewBatchDeleteAppTableRecordPathReqBodyBuilder() *BatchDeleteAppTableRecord return builder } -// 删除的多条记录id列表 +// 删除的多条记录 id 列表 // // 示例值：[; "recIcJBbvC",; "recvmiCORa";] func (builder *BatchDeleteAppTableRecordPathReqBodyBuilder) Records(records []string) *BatchDeleteAppTableRecordPathReqBodyBuilder { @@ -5700,7 +5700,7 @@ func (builder *BatchDeleteAppTableRecordReqBuilder) Build() *BatchDeleteAppTable } type BatchDeleteAppTableRecordReqBody struct { - Records []string `json:"records,omitempty"` // 删除的多条记录id列表 + Records []string `json:"records,omitempty"` // 删除的多条记录 id 列表 } type BatchDeleteAppTableRecordReq struct { @@ -5806,7 +5806,7 @@ func (builder *BatchUpdateAppTableRecordReqBuilder) TableId(tableId string) *Bat return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchUpdateAppTableRecordReqBuilder) UserIdType(userIdType string) *BatchUpdateAppTableRecordReqBuilder { @@ -5882,7 +5882,7 @@ func (builder *CreateAppTableRecordReqBuilder) TableId(tableId string) *CreateAp return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateAppTableRecordReqBuilder) UserIdType(userIdType string) *CreateAppTableRecordReqBuilder { @@ -5961,7 +5961,7 @@ func (builder *DeleteAppTableRecordReqBuilder) TableId(tableId string) *DeleteAp return builder } -// 单条记录的Id +// 单条记录的 Id // // 示例值：recpCsf4ME func (builder *DeleteAppTableRecordReqBuilder) RecordId(recordId string) *DeleteAppTableRecordReqBuilder { @@ -5982,7 +5982,7 @@ type DeleteAppTableRecordReq struct { type DeleteAppTableRecordRespData struct { Deleted *bool `json:"deleted,omitempty"` // 是否成功删除 - RecordId *string `json:"record_id,omitempty"` // 删除的记录id + RecordId *string `json:"record_id,omitempty"` // 删除的记录 id } type DeleteAppTableRecordResp struct { @@ -6032,7 +6032,7 @@ func (builder *GetAppTableRecordReqBuilder) RecordId(recordId string) *GetAppTab return builder } -// 控制多行文本字段数据的返回格式, true 表示以数组形式返回 +// 控制多行文本字段数据的返回格式，true 表示以数组形式返回 // // 示例值：true func (builder *GetAppTableRecordReqBuilder) TextFieldAsArray(textFieldAsArray bool) *GetAppTableRecordReqBuilder { @@ -6040,7 +6040,7 @@ func (builder *GetAppTableRecordReqBuilder) TextFieldAsArray(textFieldAsArray bo return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetAppTableRecordReqBuilder) UserIdType(userIdType string) *GetAppTableRecordReqBuilder { @@ -6126,7 +6126,7 @@ func (builder *ListAppTableRecordReqBuilder) TableId(tableId string) *ListAppTab return builder } -// 视图的唯一标识符，获取指定视图下的记录[view_id 参数说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#8121eebe);;注意：;当 filter 参数 或 sort 参数不为空时，请求视为对数据表中的全部数据做条件过滤，指定的view_id 会被忽略。 +// 视图的唯一标识符，获取指定视图下的记录 [view_id 参数说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#8121eebe);;注意：;当 filter 参数 或 sort 参数不为空时，请求视为对数据表中的全部数据做条件过滤，指定的 view_id 会被忽略。 // // 示例值：vewqhz51lk func (builder *ListAppTableRecordReqBuilder) ViewId(viewId string) *ListAppTableRecordReqBuilder { @@ -6134,7 +6134,7 @@ func (builder *ListAppTableRecordReqBuilder) ViewId(viewId string) *ListAppTable return builder } -// 筛选参数，用于指定本次查询的筛选条件;;注意：;;1.不支持对“人员”以及“关联字段”的属性进行过滤筛选，如人员的 OpenID。;;2.指定筛选条件时，参数长度不超过2000个字符。;;;详细请参考[筛选条件支持的公式](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter) +// 筛选参数，用于指定本次查询的筛选条件;;注意：;;1.不支持对 “人员” 以及 “关联字段” 的属性进行过滤筛选，如人员的 OpenID。;;2.指定筛选条件时，参数长度不超过 2000 个字符。;;;详细请参考 [筛选条件支持的公式](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter) // // 示例值：AND(CurrentValue.[身高]>180, CurrentValue.[体重]>150) func (builder *ListAppTableRecordReqBuilder) Filter(filter string) *ListAppTableRecordReqBuilder { @@ -6142,9 +6142,9 @@ func (builder *ListAppTableRecordReqBuilder) Filter(filter string) *ListAppTable return builder } -// 排序参数，用于指定本次查询返回结果的顺序;;注意：;;1.不支持对带“公式”和“关联字段”的表的使用。;;2.指定排序条件时，参数长度不超过1000字符。;;3.当存在多个排序条件时，数据将根据条件顺序逐层排序 +// 排序参数，用于指定本次查询返回结果的顺序;;注意：;;1.不支持对带 “公式” 和 “关联字段” 的表的使用。;;2.指定排序条件时，参数长度不超过 1000 字符。;;3.当存在多个排序条件时，数据将根据条件顺序逐层排序 // -// 示例值：["字段1 DESC","字段2 ASC"] +// 示例值：["字段 1 DESC","字段 2 ASC"] func (builder *ListAppTableRecordReqBuilder) Sort(sort string) *ListAppTableRecordReqBuilder { builder.apiReq.QueryParams.Set("sort", fmt.Sprint(sort)) return builder @@ -6152,13 +6152,13 @@ func (builder *ListAppTableRecordReqBuilder) Sort(sort string) *ListAppTableReco // 字段名称，用于指定本次查询返回记录中包含的字段 // -// 示例值：["字段1","字段2"] +// 示例值：["字段 1","字段 2"] func (builder *ListAppTableRecordReqBuilder) FieldNames(fieldNames string) *ListAppTableRecordReqBuilder { builder.apiReq.QueryParams.Set("field_names", fmt.Sprint(fieldNames)) return builder } -// 控制多行文本字段数据的返回格式，true 表示以数组形式返回。;;注意：;;1.多行文本中如果有超链接部分，则会返回链接的 URL。;;2.目前可以返回多行文本中 URL 类型为多维表格链接、飞书 doc、飞书 sheet的URL类型以及@人员的数据结构。 +// 控制多行文本字段数据的返回格式，true 表示以数组形式返回。;;注意：;;1.多行文本中如果有超链接部分，则会返回链接的 URL。;;2.目前可以返回多行文本中 URL 类型为多维表格链接、飞书 doc、飞书 sheet 的 URL 类型以及 @人员的数据结构。 // // 示例值：true func (builder *ListAppTableRecordReqBuilder) TextFieldAsArray(textFieldAsArray bool) *ListAppTableRecordReqBuilder { @@ -6166,7 +6166,7 @@ func (builder *ListAppTableRecordReqBuilder) TextFieldAsArray(textFieldAsArray b return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListAppTableRecordReqBuilder) UserIdType(userIdType string) *ListAppTableRecordReqBuilder { @@ -6174,7 +6174,7 @@ func (builder *ListAppTableRecordReqBuilder) UserIdType(userIdType string) *List return builder } -// 默认值为false，返回当前字段的默认类型和结果；当该参数的值为true时，公式 和 查找引用 类型的字段，将会以 被引用字段 的格式返回 +// 默认值为 false，返回当前字段的默认类型和结果；当该参数的值为 true 时，公式 和 查找引用 类型的字段，将会以 被引用字段 的格式返回 // // 示例值：true func (builder *ListAppTableRecordReqBuilder) DisplayFormulaRef(displayFormulaRef bool) *ListAppTableRecordReqBuilder { @@ -6223,7 +6223,7 @@ type ListAppTableRecordReq struct { type ListAppTableRecordRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Total *int `json:"total,omitempty"` // 本次请求返回的总记录数 Items []*AppTableRecord `json:"items,omitempty"` // 本次请求返回的全部记录列表 } @@ -6276,7 +6276,7 @@ func (builder *UpdateAppTableRecordReqBuilder) RecordId(recordId string) *Update return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateAppTableRecordReqBuilder) UserIdType(userIdType string) *UpdateAppTableRecordReqBuilder { @@ -6410,7 +6410,7 @@ func (builder *DeleteAppTableViewReqBuilder) TableId(tableId string) *DeleteAppT return builder } -// 视图Id +// 视图 Id // // 示例值：vewTpR1urY func (builder *DeleteAppTableViewReqBuilder) ViewId(viewId string) *DeleteAppTableViewReqBuilder { @@ -6552,7 +6552,7 @@ func (builder *ListAppTableViewReqBuilder) PageToken(pageToken string) *ListAppT return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListAppTableViewReqBuilder) UserIdType(userIdType string) *ListAppTableViewReqBuilder { @@ -6577,7 +6577,7 @@ type ListAppTableViewReq struct { type ListAppTableViewRespData struct { Items []*AppTableView `json:"items,omitempty"` // 视图信息 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 Total *int `json:"total,omitempty"` // 总数 } @@ -6768,7 +6768,7 @@ func (iterator *ListAppDashboardIterator) Next() (bool, *AppDashboard, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6822,7 +6822,7 @@ func (iterator *ListAppRoleIterator) Next() (bool, *AppRole, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6876,7 +6876,7 @@ func (iterator *ListAppRoleMemberIterator) Next() (bool, *AppRoleMember, error) return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6930,7 +6930,7 @@ func (iterator *ListAppTableIterator) Next() (bool, *AppTable, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6984,7 +6984,7 @@ func (iterator *ListAppTableFieldIterator) Next() (bool, *AppTableField, error) return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -7038,7 +7038,7 @@ func (iterator *ListAppTableFormFieldIterator) Next() (bool, *AppTableFormField, return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -7092,7 +7092,7 @@ func (iterator *ListAppTableRecordIterator) Next() (bool, *AppTableRecord, error return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -7146,7 +7146,7 @@ func (iterator *ListAppTableViewIterator) Next() (bool, *AppTableView, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/block/v2/api.go b/service/block/v2/api.go index 6501322f..f1bfc54e 100644 --- a/service/block/v2/api.go +++ b/service/block/v2/api.go @@ -44,9 +44,9 @@ type message struct { // // - 开发者可以通过该接口将部分或全部数据存放于 BlockEntity。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/block-v2/entity/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/block-v2/entity/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/blockv2/create_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/blockv2/create_entity.go func (e *entity) Create(ctx context.Context, req *CreateEntityReq, options ...larkcore.RequestOptionFunc) (*CreateEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -66,13 +66,13 @@ func (e *entity) Create(ctx context.Context, req *CreateEntityReq, options ...la return resp, err } -// 更新BlockEntity +// 更新 BlockEntity // -// - 开发者通过该接口可以更新存储在BlockEntity中的数据，并实时推送到端侧。 +// - 开发者通过该接口可以更新存储在 BlockEntity 中的数据，并实时推送到端侧。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/block-v2/entity/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/block-v2/entity/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/blockv2/update_entity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/blockv2/update_entity.go func (e *entity) Update(ctx context.Context, req *UpdateEntityReq, options ...larkcore.RequestOptionFunc) (*UpdateEntityResp, error) { // 发起请求 apiReq := req.apiReq @@ -92,13 +92,13 @@ func (e *entity) Update(ctx context.Context, req *UpdateEntityReq, options ...la return resp, err } -// Block协同数据推送 +// Block 协同数据推送 // -// - 根据BlockID向指定用户列表推送协同数据。 +// - 根据 BlockID 向指定用户列表推送协同数据。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/block-v2/message/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/block-v2/message/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/blockv2/create_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/blockv2/create_message.go func (m *message) Create(ctx context.Context, req *CreateMessageReq, options ...larkcore.RequestOptionFunc) (*CreateMessageResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/block/v2/model.go b/service/block/v2/model.go index ae283a36..e9ff2380 100644 --- a/service/block/v2/model.go +++ b/service/block/v2/model.go @@ -22,10 +22,10 @@ import ( type Entity struct { BlockId *string `json:"block_id,omitempty"` // block 唯一标识 Title *string `json:"title,omitempty"` // 标题 - BlockTypeId *string `json:"block_type_id,omitempty"` // block 类型ID + BlockTypeId *string `json:"block_type_id,omitempty"` // block 类型 ID SourceData *string `json:"source_data,omitempty"` // 业务数据 json SourceMeta *string `json:"source_meta,omitempty"` // 元数据 json - Version *string `json:"version,omitempty"` // 版本号(自增) + Version *string `json:"version,omitempty"` // 版本号 (自增) SourceLink *string `json:"source_link,omitempty"` // 链接 Summary *string `json:"summary,omitempty"` // 总括 Preview *string `json:"preview,omitempty"` // 预览 @@ -40,13 +40,13 @@ type EntityBuilder struct { blockIdFlag bool title string // 标题 titleFlag bool - blockTypeId string // block 类型ID + blockTypeId string // block 类型 ID blockTypeIdFlag bool sourceData string // 业务数据 json sourceDataFlag bool sourceMeta string // 元数据 json sourceMetaFlag bool - version string // 版本号(自增) + version string // 版本号 (自增) versionFlag bool sourceLink string // 链接 sourceLinkFlag bool @@ -87,7 +87,7 @@ func (builder *EntityBuilder) Title(title string) *EntityBuilder { return builder } -// block 类型ID +// block 类型 ID // // 示例值：blk_6204893fee000013739f5359 func (builder *EntityBuilder) BlockTypeId(blockTypeId string) *EntityBuilder { @@ -114,7 +114,7 @@ func (builder *EntityBuilder) SourceMeta(sourceMeta string) *EntityBuilder { return builder } -// 版本号(自增) +// 版本号 (自增) // // 示例值：1651716489253602 func (builder *EntityBuilder) Version(version string) *EntityBuilder { @@ -134,7 +134,7 @@ func (builder *EntityBuilder) SourceLink(sourceLink string) *EntityBuilder { // 总括 // -// 示例值：{"cn":"这是一个block"} +// 示例值：{"cn":"这是一个 block"} func (builder *EntityBuilder) Summary(summary string) *EntityBuilder { builder.summary = summary builder.summaryFlag = true @@ -143,7 +143,7 @@ func (builder *EntityBuilder) Summary(summary string) *EntityBuilder { // 预览 // -// 示例值：{"cn":"这是一个block"} +// 示例值：{"cn":"这是一个 block"} func (builder *EntityBuilder) Preview(preview string) *EntityBuilder { builder.preview = preview builder.previewFlag = true @@ -152,7 +152,7 @@ func (builder *EntityBuilder) Preview(preview string) *EntityBuilder { // 综述 json // -// 示例值：{"cn":"这是一个block","va": "this is a block"} +// 示例值：{"cn":"这是一个 block","va": "this is a block"} func (builder *EntityBuilder) I18nSummay(i18nSummay string) *EntityBuilder { builder.i18nSummay = i18nSummay builder.i18nSummayFlag = true @@ -161,7 +161,7 @@ func (builder *EntityBuilder) I18nSummay(i18nSummay string) *EntityBuilder { // 预览 json // -// 示例值：{"cn":"这是一个block","va": "this is a block"} +// 示例值：{"cn":"这是一个 block","va": "this is a block"} func (builder *EntityBuilder) I18nPreview(i18nPreview string) *EntityBuilder { builder.i18nPreview = i18nPreview builder.i18nPreviewFlag = true @@ -245,8 +245,8 @@ func (builder *EntityBuilder) Build() *Entity { type Message struct { Body *string `json:"body,omitempty"` // 协同数据内容 - Version *string `json:"version,omitempty"` // 版本号(自增) - BlockId *string `json:"block_id,omitempty"` // entity实体ID + Version *string `json:"version,omitempty"` // 版本号 (自增) + BlockId *string `json:"block_id,omitempty"` // entity 实体 ID Resource *string `json:"resource,omitempty"` // 业务来源 OpenIds []string `json:"open_ids,omitempty"` // 推送用户列表 } @@ -254,9 +254,9 @@ type Message struct { type MessageBuilder struct { body string // 协同数据内容 bodyFlag bool - version string // 版本号(自增) + version string // 版本号 (自增) versionFlag bool - blockId string // entity实体ID + blockId string // entity 实体 ID blockIdFlag bool resource string // 业务来源 resourceFlag bool @@ -278,7 +278,7 @@ func (builder *MessageBuilder) Body(body string) *MessageBuilder { return builder } -// 版本号(自增) +// 版本号 (自增) // // 示例值：1637565292196 func (builder *MessageBuilder) Version(version string) *MessageBuilder { @@ -287,7 +287,7 @@ func (builder *MessageBuilder) Version(version string) *MessageBuilder { return builder } -// entity实体ID +// entity 实体 ID // // 示例值：8116040162664047375 func (builder *MessageBuilder) BlockId(blockId string) *MessageBuilder { @@ -341,15 +341,15 @@ func (builder *MessageBuilder) Build() *Message { type CreateEntityReqBodyBuilder struct { title string // 标题 titleFlag bool - blockTypeId string // block 类型ID + blockTypeId string // block 类型 ID blockTypeIdFlag bool sourceData string // 内容 sourceDataFlag bool sourceMeta string // 元数据 sourceMetaFlag bool - version string // 版本号(自增值) + version string // 版本号 (自增值) versionFlag bool - sourceLink string // block原链接 + sourceLink string // block 原链接 sourceLinkFlag bool owner string // 所有者 ownerFlag bool @@ -372,14 +372,14 @@ func NewCreateEntityReqBodyBuilder() *CreateEntityReqBodyBuilder { // 标题 // -//示例值：已阅block +//示例值：已阅 block func (builder *CreateEntityReqBodyBuilder) Title(title string) *CreateEntityReqBodyBuilder { builder.title = title builder.titleFlag = true return builder } -// block 类型ID +// block 类型 ID // //示例值：blk_614c1c952f800014b27f87d6 func (builder *CreateEntityReqBodyBuilder) BlockTypeId(blockTypeId string) *CreateEntityReqBodyBuilder { @@ -406,7 +406,7 @@ func (builder *CreateEntityReqBodyBuilder) SourceMeta(sourceMeta string) *Create return builder } -// 版本号(自增值) +// 版本号 (自增值) // //示例值：1 func (builder *CreateEntityReqBodyBuilder) Version(version string) *CreateEntityReqBodyBuilder { @@ -415,7 +415,7 @@ func (builder *CreateEntityReqBodyBuilder) Version(version string) *CreateEntity return builder } -// block原链接 +// block 原链接 // //示例值：{"_data":"https://docs.feishu.cn/block/78","_version":1} func (builder *CreateEntityReqBodyBuilder) SourceLink(sourceLink string) *CreateEntityReqBodyBuilder { @@ -444,7 +444,7 @@ func (builder *CreateEntityReqBodyBuilder) Extra(extra string) *CreateEntityReqB // 国际化概括 // -//示例值：{"cn":"这是一个block","va": "this is a block"} +//示例值：{"cn":"这是一个 block","va": "this is a block"} func (builder *CreateEntityReqBodyBuilder) I18nSummary(i18nSummary string) *CreateEntityReqBodyBuilder { builder.i18nSummary = i18nSummary builder.i18nSummaryFlag = true @@ -453,7 +453,7 @@ func (builder *CreateEntityReqBodyBuilder) I18nSummary(i18nSummary string) *Crea // 国际化预览 // -//示例值：{"cn":"这是一个block","va": "this is a block"} +//示例值：{"cn":"这是一个 block","va": "this is a block"} func (builder *CreateEntityReqBodyBuilder) I18nPreview(i18nPreview string) *CreateEntityReqBodyBuilder { builder.i18nPreview = i18nPreview builder.i18nPreviewFlag = true @@ -462,7 +462,7 @@ func (builder *CreateEntityReqBodyBuilder) I18nPreview(i18nPreview string) *Crea // 概括 // -//示例值：{"cn":"这是一个block"} +//示例值：{"cn":"这是一个 block"} func (builder *CreateEntityReqBodyBuilder) Summary(summary string) *CreateEntityReqBodyBuilder { builder.summary = summary builder.summaryFlag = true @@ -471,7 +471,7 @@ func (builder *CreateEntityReqBodyBuilder) Summary(summary string) *CreateEntity // 预览 // -//示例值：{"cn":"这是一个block"} +//示例值：{"cn":"这是一个 block"} func (builder *CreateEntityReqBodyBuilder) Preview(preview string) *CreateEntityReqBodyBuilder { builder.preview = preview builder.previewFlag = true @@ -522,15 +522,15 @@ func (builder *CreateEntityReqBodyBuilder) Build() *CreateEntityReqBody { type CreateEntityPathReqBodyBuilder struct { title string // 标题 titleFlag bool - blockTypeId string // block 类型ID + blockTypeId string // block 类型 ID blockTypeIdFlag bool sourceData string // 内容 sourceDataFlag bool sourceMeta string // 元数据 sourceMetaFlag bool - version string // 版本号(自增值) + version string // 版本号 (自增值) versionFlag bool - sourceLink string // block原链接 + sourceLink string // block 原链接 sourceLinkFlag bool owner string // 所有者 ownerFlag bool @@ -553,14 +553,14 @@ func NewCreateEntityPathReqBodyBuilder() *CreateEntityPathReqBodyBuilder { // 标题 // -// 示例值：已阅block +// 示例值：已阅 block func (builder *CreateEntityPathReqBodyBuilder) Title(title string) *CreateEntityPathReqBodyBuilder { builder.title = title builder.titleFlag = true return builder } -// block 类型ID +// block 类型 ID // // 示例值：blk_614c1c952f800014b27f87d6 func (builder *CreateEntityPathReqBodyBuilder) BlockTypeId(blockTypeId string) *CreateEntityPathReqBodyBuilder { @@ -587,7 +587,7 @@ func (builder *CreateEntityPathReqBodyBuilder) SourceMeta(sourceMeta string) *Cr return builder } -// 版本号(自增值) +// 版本号 (自增值) // // 示例值：1 func (builder *CreateEntityPathReqBodyBuilder) Version(version string) *CreateEntityPathReqBodyBuilder { @@ -596,7 +596,7 @@ func (builder *CreateEntityPathReqBodyBuilder) Version(version string) *CreateEn return builder } -// block原链接 +// block 原链接 // // 示例值：{"_data":"https://docs.feishu.cn/block/78","_version":1} func (builder *CreateEntityPathReqBodyBuilder) SourceLink(sourceLink string) *CreateEntityPathReqBodyBuilder { @@ -625,7 +625,7 @@ func (builder *CreateEntityPathReqBodyBuilder) Extra(extra string) *CreateEntity // 国际化概括 // -// 示例值：{"cn":"这是一个block","va": "this is a block"} +// 示例值：{"cn":"这是一个 block","va": "this is a block"} func (builder *CreateEntityPathReqBodyBuilder) I18nSummary(i18nSummary string) *CreateEntityPathReqBodyBuilder { builder.i18nSummary = i18nSummary builder.i18nSummaryFlag = true @@ -634,7 +634,7 @@ func (builder *CreateEntityPathReqBodyBuilder) I18nSummary(i18nSummary string) * // 国际化预览 // -// 示例值：{"cn":"这是一个block","va": "this is a block"} +// 示例值：{"cn":"这是一个 block","va": "this is a block"} func (builder *CreateEntityPathReqBodyBuilder) I18nPreview(i18nPreview string) *CreateEntityPathReqBodyBuilder { builder.i18nPreview = i18nPreview builder.i18nPreviewFlag = true @@ -643,7 +643,7 @@ func (builder *CreateEntityPathReqBodyBuilder) I18nPreview(i18nPreview string) * // 概括 // -// 示例值：{"cn":"这是一个block"} +// 示例值：{"cn":"这是一个 block"} func (builder *CreateEntityPathReqBodyBuilder) Summary(summary string) *CreateEntityPathReqBodyBuilder { builder.summary = summary builder.summaryFlag = true @@ -652,7 +652,7 @@ func (builder *CreateEntityPathReqBodyBuilder) Summary(summary string) *CreateEn // 预览 // -// 示例值：{"cn":"这是一个block"} +// 示例值：{"cn":"这是一个 block"} func (builder *CreateEntityPathReqBodyBuilder) Preview(preview string) *CreateEntityPathReqBodyBuilder { builder.preview = preview builder.previewFlag = true @@ -729,11 +729,11 @@ func (builder *CreateEntityReqBuilder) Build() *CreateEntityReq { type CreateEntityReqBody struct { Title *string `json:"title,omitempty"` // 标题 - BlockTypeId *string `json:"block_type_id,omitempty"` // block 类型ID + BlockTypeId *string `json:"block_type_id,omitempty"` // block 类型 ID SourceData *string `json:"source_data,omitempty"` // 内容 SourceMeta *string `json:"source_meta,omitempty"` // 元数据 - Version *string `json:"version,omitempty"` // 版本号(自增值) - SourceLink *string `json:"source_link,omitempty"` // block原链接 + Version *string `json:"version,omitempty"` // 版本号 (自增值) + SourceLink *string `json:"source_link,omitempty"` // block 原链接 Owner *string `json:"owner,omitempty"` // 所有者 Extra *string `json:"extra,omitempty"` // 扩展字段 I18nSummary *string `json:"i18n_summary,omitempty"` // 国际化概括 @@ -775,7 +775,7 @@ func NewUpdateEntityReqBuilder() *UpdateEntityReqBuilder { return builder } -// block唯一标识 +// block 唯一标识 // // 示例值：7794641623571830467 func (builder *UpdateEntityReqBuilder) BlockId(blockId string) *UpdateEntityReqBuilder { @@ -783,7 +783,7 @@ func (builder *UpdateEntityReqBuilder) BlockId(blockId string) *UpdateEntityReqB return builder } -// 开发者通过该接口可以更新存储在BlockEntity中的数据，并实时推送到端侧。 +// 开发者通过该接口可以更新存储在 BlockEntity 中的数据，并实时推送到端侧。 func (builder *UpdateEntityReqBuilder) Entity(entity *Entity) *UpdateEntityReqBuilder { builder.entity = entity return builder @@ -825,7 +825,7 @@ func NewCreateMessageReqBuilder() *CreateMessageReqBuilder { return builder } -// 根据BlockID向指定用户列表推送协同数据。 +// 根据 BlockID 向指定用户列表推送协同数据。 func (builder *CreateMessageReqBuilder) Message(message *Message) *CreateMessageReqBuilder { builder.message = message return builder diff --git a/service/calendar/v4/api.go b/service/calendar/v4/api.go index 0fa3539c..b1881c2c 100644 --- a/service/calendar/v4/api.go +++ b/service/calendar/v4/api.go @@ -41,7 +41,7 @@ type CalendarService struct { CalendarEvent *calendarEvent // 日程 CalendarEventAttendee *calendarEventAttendee // 日程参与人 CalendarEventAttendeeChatMember *calendarEventAttendeeChatMember // 日程参与人群成员 - ExchangeBinding *exchangeBinding // Exchange绑定 + ExchangeBinding *exchangeBinding // Exchange 绑定 Freebusy *freebusy // freebusy Setting *setting // 日历设置 TimeoffEvent *timeoffEvent // 请假 @@ -79,9 +79,9 @@ type timeoffEvent struct { // // - 该接口用于为当前身份（应用 / 用户）创建一个共享日历。;;身份由 Header Authorization 的 Token 类型决定。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendar.go func (c *calendar) Create(ctx context.Context, req *CreateCalendarReq, options ...larkcore.RequestOptionFunc) (*CreateCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -107,9 +107,9 @@ func (c *calendar) Create(ctx context.Context, req *CreateCalendarReq, options . // // - 当前身份必须对日历具有 owner 权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_calendar.go func (c *calendar) Delete(ctx context.Context, req *DeleteCalendarReq, options ...larkcore.RequestOptionFunc) (*DeleteCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -135,9 +135,9 @@ func (c *calendar) Delete(ctx context.Context, req *DeleteCalendarReq, options . // // - 当前身份必须对日历有访问权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/get_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/get_calendar.go func (c *calendar) Get(ctx context.Context, req *GetCalendarReq, options ...larkcore.RequestOptionFunc) (*GetCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -163,9 +163,9 @@ func (c *calendar) Get(ctx context.Context, req *GetCalendarReq, options ...lark // // - 调用时首先使用 page_token 分页拉取存量数据，之后使用 sync_token 增量同步变更数据。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendar.go func (c *calendar) List(ctx context.Context, req *ListCalendarReq, options ...larkcore.RequestOptionFunc) (*ListCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -191,9 +191,9 @@ func (c *calendar) List(ctx context.Context, req *ListCalendarReq, options ...la // // - 当前身份对日历有 owner 权限时，可修改全局字段：summary, description, permission。;;当前身份对日历不具有 owner 权限时，仅可修改对自己生效的字段：color, summary_alias。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/patch_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/patch_calendar.go func (c *calendar) Patch(ctx context.Context, req *PatchCalendarReq, options ...larkcore.RequestOptionFunc) (*PatchCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -217,9 +217,9 @@ func (c *calendar) Patch(ctx context.Context, req *PatchCalendarReq, options ... // // - 获取当前身份的主日历信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/primary +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/primary // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/primary_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/primary_calendar.go func (c *calendar) Primary(ctx context.Context, req *PrimaryCalendarReq, options ...larkcore.RequestOptionFunc) (*PrimaryCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -243,9 +243,9 @@ func (c *calendar) Primary(ctx context.Context, req *PrimaryCalendarReq, options // // - 该接口用于通过关键字查询公共日历或用户主日历。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/search_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/search_calendar.go func (c *calendar) Search(ctx context.Context, req *SearchCalendarReq, options ...larkcore.RequestOptionFunc) (*SearchCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -277,11 +277,11 @@ func (c *calendar) SearchByIterator(ctx context.Context, req *SearchCalendarReq, // // - 该接口用于以当前身份（应用 / 用户）订阅某个日历。;;身份由 Header Authorization 的 Token 类型决定。 // -// - - 仅可订阅类型为 primary 或 shared 的公开日历。;- 可订阅日历数量上限为1000。 +// - - 仅可订阅类型为 primary 或 shared 的公开日历。;- 可订阅日历数量上限为 1000。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/subscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/subscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscribe_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscribe_calendar.go func (c *calendar) Subscribe(ctx context.Context, req *SubscribeCalendarReq, options ...larkcore.RequestOptionFunc) (*SubscribeCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -305,9 +305,9 @@ func (c *calendar) Subscribe(ctx context.Context, req *SubscribeCalendarReq, opt // // - 该接口用于以用户身份订阅当前身份下日历列表中的所有日历变更。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/subscription +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/subscription // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscription_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscription_calendar.go func (c *calendar) Subscription(ctx context.Context, options ...larkcore.RequestOptionFunc) (*SubscriptionCalendarResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -336,9 +336,9 @@ func (c *calendar) Subscription(ctx context.Context, options ...larkcore.Request // // - 仅可操作已经被当前身份订阅的日历。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/unsubscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/unsubscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscribe_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscribe_calendar.go func (c *calendar) Unsubscribe(ctx context.Context, req *UnsubscribeCalendarReq, options ...larkcore.RequestOptionFunc) (*UnsubscribeCalendarResp, error) { // 发起请求 apiReq := req.apiReq @@ -362,9 +362,9 @@ func (c *calendar) Unsubscribe(ctx context.Context, req *UnsubscribeCalendarReq, // // - 该接口用于以用户身份取消订阅当前身份下日历列表中的日历变更事件。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/unsubscription +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/unsubscription // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscription_calendar.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscription_calendar.go func (c *calendar) Unsubscription(ctx context.Context, options ...larkcore.RequestOptionFunc) (*UnsubscriptionCalendarResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -393,9 +393,9 @@ func (c *calendar) Unsubscription(ctx context.Context, options ...larkcore.Reque // // - 当前身份需要有日历的 owner 权限，并且日历的类型只能为 primary 或 shared。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendarAcl.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendarAcl.go func (c *calendarAcl) Create(ctx context.Context, req *CreateCalendarAclReq, options ...larkcore.RequestOptionFunc) (*CreateCalendarAclResp, error) { // 发起请求 apiReq := req.apiReq @@ -421,9 +421,9 @@ func (c *calendarAcl) Create(ctx context.Context, req *CreateCalendarAclReq, opt // // - 当前身份需要有日历的 owner 权限，并且日历的类型只能为 primary 或 shared。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_calendarAcl.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_calendarAcl.go func (c *calendarAcl) Delete(ctx context.Context, req *DeleteCalendarAclReq, options ...larkcore.RequestOptionFunc) (*DeleteCalendarAclResp, error) { // 发起请求 apiReq := req.apiReq @@ -449,9 +449,9 @@ func (c *calendarAcl) Delete(ctx context.Context, req *DeleteCalendarAclReq, opt // // - 当前身份需要有日历的 owner 权限，并且日历的类型只能为 primary 或 shared。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarAcl.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarAcl.go func (c *calendarAcl) List(ctx context.Context, req *ListCalendarAclReq, options ...larkcore.RequestOptionFunc) (*ListCalendarAclResp, error) { // 发起请求 apiReq := req.apiReq @@ -485,9 +485,9 @@ func (c *calendarAcl) ListByIterator(ctx context.Context, req *ListCalendarAclRe // // - 用户必须对日历有访问权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/subscription +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/subscription // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscription_calendarAcl.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscription_calendarAcl.go func (c *calendarAcl) Subscription(ctx context.Context, req *SubscriptionCalendarAclReq, options ...larkcore.RequestOptionFunc) (*SubscriptionCalendarAclResp, error) { // 发起请求 apiReq := req.apiReq @@ -513,9 +513,9 @@ func (c *calendarAcl) Subscription(ctx context.Context, req *SubscriptionCalenda // // - 用户必须对日历有访问权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/unsubscription +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/unsubscription // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscription_calendarAcl.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscription_calendarAcl.go func (c *calendarAcl) Unsubscription(ctx context.Context, req *UnsubscriptionCalendarAclReq, options ...larkcore.RequestOptionFunc) (*UnsubscriptionCalendarAclResp, error) { // 发起请求 apiReq := req.apiReq @@ -541,9 +541,9 @@ func (c *calendarAcl) Unsubscription(ctx context.Context, req *UnsubscriptionCal // // - 当前身份必须对日历有 writer 或 owner 权限，并且日历的类型只能为 primary 或 shared。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendarEvent.go func (c *calendarEvent) Create(ctx context.Context, req *CreateCalendarEventReq, options ...larkcore.RequestOptionFunc) (*CreateCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -569,9 +569,9 @@ func (c *calendarEvent) Create(ctx context.Context, req *CreateCalendarEventReq, // // - 当前身份必须对日历有 writer 或 owner 权限，并且日历的类型只能为 primary 或 shared。;;当前身份必须是日程的组织者。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_calendarEvent.go func (c *calendarEvent) Delete(ctx context.Context, req *DeleteCalendarEventReq, options ...larkcore.RequestOptionFunc) (*DeleteCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -595,11 +595,11 @@ func (c *calendarEvent) Delete(ctx context.Context, req *DeleteCalendarEventReq, // // - 该接口用于以当前身份（应用 / 用户）获取日历上的一个日程。;身份由 Header Authorization 的 Token 类型决定。 // -// - - 当前身份必须对日历有reader、writer或owner权限才会返回日程详细信息（调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口，role字段可查看权限）。;- [例外日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction#71c5ec78)可通过event_id的非0时间戳后缀，来获取修改的重复性日程的哪一天日程的时间信息。 +// - - 当前身份必须对日历有 reader、writer 或 owner 权限才会返回日程详细信息（调用 [获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get) 接口，role 字段可查看权限）。;- [例外日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction#71c5ec78) 可通过 event_id 的非 0 时间戳后缀，来获取修改的重复性日程的哪一天日程的时间信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/get_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/get_calendarEvent.go func (c *calendarEvent) Get(ctx context.Context, req *GetCalendarEventReq, options ...larkcore.RequestOptionFunc) (*GetCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -623,11 +623,11 @@ func (c *calendarEvent) Get(ctx context.Context, req *GetCalendarEventReq, optio // // - 该接口用于以当前身份（应用 / 用户）获取日历下的日程列表。;身份由 Header Authorization 的 Token 类型决定。 // -// - - 当前身份必须对日历有reader、writer或owner权限才会返回日程详细信息（调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口，role字段可查看权限）。;;- 仅支持primary、shared和resource类型的日历获取日程列表。;;- page_token 分页拉取存量数据，sync_token 增量同步变更数据；目前仅传anchor_time时，会返回page_token。;;- 为了确保调用方日程同步数据的一致性，在使用sync_token时，不能同时使用start_time和end_time，否则可能造成日程数据缺失。 +// - - 当前身份必须对日历有 reader、writer 或 owner 权限才会返回日程详细信息（调用 [获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get) 接口，role 字段可查看权限）。;;- 仅支持 primary、shared 和 resource 类型的日历获取日程列表。;;- page_token 分页拉取存量数据，sync_token 增量同步变更数据；目前仅传 anchor_time 时，会返回 page_token。;;- 为了确保调用方日程同步数据的一致性，在使用 sync_token 时，不能同时使用 start_time 和 end_time，否则可能造成日程数据缺失。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarEvent.go func (c *calendarEvent) List(ctx context.Context, req *ListCalendarEventReq, options ...larkcore.RequestOptionFunc) (*ListCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -653,9 +653,9 @@ func (c *calendarEvent) List(ctx context.Context, req *ListCalendarEventReq, opt // // - 当前身份必须对日历有 writer 或 owner 权限，并且日历的类型只能为 primary 或 shared。;;当前身份为日程组织者时，可修改所有可编辑字段。;;当前身份为日程参与者时，仅可编辑部分字段。（如：visibility, free_busy_status, color, reminders） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/patch_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/patch_calendarEvent.go func (c *calendarEvent) Patch(ctx context.Context, req *PatchCalendarEventReq, options ...larkcore.RequestOptionFunc) (*PatchCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -679,11 +679,11 @@ func (c *calendarEvent) Patch(ctx context.Context, req *PatchCalendarEventReq, o // // - 该接口用于以用户身份搜索某日历下的相关日程。;;身份由 Header Authorization 的 Token 类型决定。 // -// - 当前身份必须对日历有reader、writer或owner权限（调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口，role字段可查看权限）。 +// - 当前身份必须对日历有 reader、writer 或 owner 权限（调用 [获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get) 接口，role 字段可查看权限）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/search_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/search_calendarEvent.go func (c *calendarEvent) Search(ctx context.Context, req *SearchCalendarEventReq, options ...larkcore.RequestOptionFunc) (*SearchCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -715,11 +715,11 @@ func (c *calendarEvent) SearchByIterator(ctx context.Context, req *SearchCalenda // // - 该接口用于以用户身份订阅指定日历下的日程变更事件。 // -// - 当前身份必须对日历有reader、writer或owner权限（调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口，role字段可查看权限）。 +// - 当前身份必须对日历有 reader、writer 或 owner 权限（调用 [获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get) 接口，role 字段可查看权限）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/subscription +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/subscription // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscription_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/subscription_calendarEvent.go func (c *calendarEvent) Subscription(ctx context.Context, req *SubscriptionCalendarEventReq, options ...larkcore.RequestOptionFunc) (*SubscriptionCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -743,11 +743,11 @@ func (c *calendarEvent) Subscription(ctx context.Context, req *SubscriptionCalen // // - 该接口用于以用户身份取消订阅指定日历下的日程变更事件。 // -// - 当前身份必须对日历有reader、writer或owner权限（调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口，role字段可查看权限）。 +// - 当前身份必须对日历有 reader、writer 或 owner 权限（调用 [获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get) 接口，role 字段可查看权限）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/unsubscription +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/unsubscription // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscription_calendarEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/unsubscription_calendarEvent.go func (c *calendarEvent) Unsubscription(ctx context.Context, req *UnsubscriptionCalendarEventReq, options ...larkcore.RequestOptionFunc) (*UnsubscriptionCalendarEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -773,9 +773,9 @@ func (c *calendarEvent) Unsubscription(ctx context.Context, req *UnsubscriptionC // // - - 当前身份需要有日历的 writer 或 owner 权限，并且日历的类型只能为 primary 或 shared。;;- 当前身份需要是日程的组织者。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/batch_delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/batch_delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/batchDelete_calendarEventAttendee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/batchDelete_calendarEventAttendee.go func (c *calendarEventAttendee) BatchDelete(ctx context.Context, req *BatchDeleteCalendarEventAttendeeReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteCalendarEventAttendeeResp, error) { // 发起请求 apiReq := req.apiReq @@ -801,9 +801,9 @@ func (c *calendarEventAttendee) BatchDelete(ctx context.Context, req *BatchDelet // // - - 当前身份需要有日历的 writer 或 owner 权限，并且日历的类型只能为 primary 或 shared。;;- 当前身份需要是日程的组织者，或日程设置了「参与人可邀请其它参与人」权限。;;- 新添加的日程参与人必须与日程组织者在同一个企业内。;;- 使用该接口添加会议室后，会议室会进入异步的预约流程，请求结束不代表会议室预约成功，需后续再查询预约状态。;;- 每个日程最多只能有 3000 名参与人。;;- 开启管理员能力后预约会议室可不受会议室预约范围的限制（当前不支持用管理员身份给其他人的日程预约会议室） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendarEventAttendee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_calendarEventAttendee.go func (c *calendarEventAttendee) Create(ctx context.Context, req *CreateCalendarEventAttendeeReq, options ...larkcore.RequestOptionFunc) (*CreateCalendarEventAttendeeResp, error) { // 发起请求 apiReq := req.apiReq @@ -827,11 +827,11 @@ func (c *calendarEventAttendee) Create(ctx context.Context, req *CreateCalendarE // // - 获取日程的参与人列表，若参与者列表中有群组，请使用 [获取参与人群成员列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee-chat_member/list) 。 // -// - - 当前身份必须对日历有reader、writer或owner权限（调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口，role字段可查看权限）。;;- 当前身份必须有权限查看日程的参与人列表。 +// - - 当前身份必须对日历有 reader、writer 或 owner 权限（调用 [获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get) 接口，role 字段可查看权限）。;;- 当前身份必须有权限查看日程的参与人列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarEventAttendee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarEventAttendee.go func (c *calendarEventAttendee) List(ctx context.Context, req *ListCalendarEventAttendeeReq, options ...larkcore.RequestOptionFunc) (*ListCalendarEventAttendeeResp, error) { // 发起请求 apiReq := req.apiReq @@ -865,9 +865,9 @@ func (c *calendarEventAttendee) ListByIterator(ctx context.Context, req *ListCal // // - - 当前身份必须有权限查看日程的参与人列表。;;- 当前身份必须在群聊中，或有权限查看群成员列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee-chat_member/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee-chat_member/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarEventAttendeeChatMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_calendarEventAttendeeChatMember.go func (c *calendarEventAttendeeChatMember) List(ctx context.Context, req *ListCalendarEventAttendeeChatMemberReq, options ...larkcore.RequestOptionFunc) (*ListCalendarEventAttendeeChatMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -895,15 +895,15 @@ func (c *calendarEventAttendeeChatMember) ListByIterator(ctx context.Context, re limit: req.Limit}, nil } -// 创建Exchange绑定关系 +// 创建 Exchange 绑定关系 // -// - 本接口将Exchange账户绑定到飞书账户，进而支持Exchange日历的导入 +// - 本接口将 Exchange 账户绑定到飞书账户，进而支持 Exchange 日历的导入 // // - 操作用户需要是企业超级管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_exchangeBinding.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_exchangeBinding.go func (e *exchangeBinding) Create(ctx context.Context, req *CreateExchangeBindingReq, options ...larkcore.RequestOptionFunc) (*CreateExchangeBindingResp, error) { // 发起请求 apiReq := req.apiReq @@ -923,15 +923,15 @@ func (e *exchangeBinding) Create(ctx context.Context, req *CreateExchangeBinding return resp, err } -// 解除Exchange绑定关系 +// 解除 Exchange 绑定关系 // -// - 本接口解除Exchange账户和飞书账户的绑定关系，Exchange账户解除绑定后才能绑定其他飞书账户 +// - 本接口解除 Exchange 账户和飞书账户的绑定关系，Exchange 账户解除绑定后才能绑定其他飞书账户 // // - 操作用户需要是企业超级管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_exchangeBinding.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_exchangeBinding.go func (e *exchangeBinding) Delete(ctx context.Context, req *DeleteExchangeBindingReq, options ...larkcore.RequestOptionFunc) (*DeleteExchangeBindingResp, error) { // 发起请求 apiReq := req.apiReq @@ -953,13 +953,13 @@ func (e *exchangeBinding) Delete(ctx context.Context, req *DeleteExchangeBinding // 获取绑定状态 // -// - 本接口获取Exchange账户的绑定状态，包括exchange日历是否同步完成。 +// - 本接口获取 Exchange 账户的绑定状态，包括 exchange 日历是否同步完成。 // // - 操作用户需要是企业超级管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/get_exchangeBinding.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/get_exchangeBinding.go func (e *exchangeBinding) Get(ctx context.Context, req *GetExchangeBindingReq, options ...larkcore.RequestOptionFunc) (*GetExchangeBindingResp, error) { // 发起请求 apiReq := req.apiReq @@ -983,9 +983,9 @@ func (e *exchangeBinding) Get(ctx context.Context, req *GetExchangeBindingReq, o // // - 查询用户主日历或会议室的忙闲信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/freebusy/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/freebusy/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_freebusy.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/list_freebusy.go func (f *freebusy) List(ctx context.Context, req *ListFreebusyReq, options ...larkcore.RequestOptionFunc) (*ListFreebusyResp, error) { // 发起请求 apiReq := req.apiReq @@ -1005,13 +1005,13 @@ func (f *freebusy) List(ctx context.Context, req *ListFreebusyReq, options ...la return resp, err } -// 生成CalDAV配置 +// 生成 CalDAV 配置 // -// - 用于为当前用户生成一个CalDAV账号密码，用于将飞书日历信息同步到本地设备日历。 +// - 用于为当前用户生成一个 CalDAV 账号密码，用于将飞书日历信息同步到本地设备日历。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/setting/generate_caldav_conf +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/setting/generate_caldav_conf // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/generateCaldavConf_setting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/generateCaldavConf_setting.go func (s *setting) GenerateCaldavConf(ctx context.Context, req *GenerateCaldavConfSettingReq, options ...larkcore.RequestOptionFunc) (*GenerateCaldavConfSettingResp, error) { // 发起请求 apiReq := req.apiReq @@ -1035,9 +1035,9 @@ func (s *setting) GenerateCaldavConf(ctx context.Context, req *GenerateCaldavCon // // - 为指定用户创建一个请假日程，可以是一个普通请假日程，也可以是一个全天日程。;创建请假日程后，会在相应时间内，在用户个人签名页展示请假信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_timeoffEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/create_timeoffEvent.go func (t *timeoffEvent) Create(ctx context.Context, req *CreateTimeoffEventReq, options ...larkcore.RequestOptionFunc) (*CreateTimeoffEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -1061,9 +1061,9 @@ func (t *timeoffEvent) Create(ctx context.Context, req *CreateTimeoffEventReq, o // // - 删除一个指定的请假日程，请假日程删除，用户个人签名页的请假信息也会消失。;一个应用只能删除自己创建的请假日程。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_timeoffEvent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/calendarv4/delete_timeoffEvent.go func (t *timeoffEvent) Delete(ctx context.Context, req *DeleteTimeoffEventReq, options ...larkcore.RequestOptionFunc) (*DeleteTimeoffEventResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/calendar/v4/event.go b/service/calendar/v4/event.go index e443f8af..23bc28a2 100644 --- a/service/calendar/v4/event.go +++ b/service/calendar/v4/event.go @@ -32,7 +32,7 @@ func (h *P2CalendarChangedV4Handler) Event() interface{} { return &P2CalendarChangedV4{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2CalendarChangedV4Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2CalendarChangedV4)) } @@ -52,7 +52,7 @@ func (h *P2CalendarAclCreatedV4Handler) Event() interface{} { return &P2CalendarAclCreatedV4{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2CalendarAclCreatedV4Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2CalendarAclCreatedV4)) } @@ -72,7 +72,7 @@ func (h *P2CalendarAclDeletedV4Handler) Event() interface{} { return &P2CalendarAclDeletedV4{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2CalendarAclDeletedV4Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2CalendarAclDeletedV4)) } @@ -92,7 +92,7 @@ func (h *P2CalendarEventChangedV4Handler) Event() interface{} { return &P2CalendarEventChangedV4{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2CalendarEventChangedV4Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2CalendarEventChangedV4)) } diff --git a/service/calendar/v4/model.go b/service/calendar/v4/model.go index d4f8bfaa..30e6fe7a 100644 --- a/service/calendar/v4/model.go +++ b/service/calendar/v4/model.go @@ -37,9 +37,9 @@ const ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户id - UserIdTypeUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( @@ -51,19 +51,19 @@ const ( ) const ( - UserIdTypeCreateCalendarAclUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateCalendarAclUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateCalendarAclOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateCalendarAclUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateCalendarAclUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateCalendarAclOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListCalendarAclUserId = "user_id" // 以user_id来识别用户id - UserIdTypeListCalendarAclUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeListCalendarAclOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeListCalendarAclUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeListCalendarAclUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeListCalendarAclOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( - EventVisibilityDefault = "default" // 默认权限，仅向他人显示是否“忙碌” + EventVisibilityDefault = "default" // 默认权限，仅向他人显示是否 “忙碌” EventVisibilityPublic = "public" // 公开，显示日程详情 EventVisibilityPrivate = "private" // 私密，仅自己可见 ) @@ -87,7 +87,7 @@ const ( ) const ( - EventVisibilityPatchCalendarEventDefault = "default" // 默认权限，仅向他人显示是否“忙碌” + EventVisibilityPatchCalendarEventDefault = "default" // 默认权限，仅向他人显示是否 “忙碌” EventVisibilityPatchCalendarEventPublic = "public" // 公开，显示日程详情 EventVisibilityPatchCalendarEventPrivate = "private" // 私密，仅自己可见 ) @@ -105,68 +105,68 @@ const ( ) const ( - UserIdTypeSearchCalendarEventUserId = "user_id" // 以user_id来识别用户id - UserIdTypeSearchCalendarEventUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeSearchCalendarEventOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeSearchCalendarEventUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeSearchCalendarEventUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeSearchCalendarEventOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( - UserIdTypeBatchDeleteCalendarEventAttendeeUserId = "user_id" // 以user_id来识别用户id - UserIdTypeBatchDeleteCalendarEventAttendeeUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeBatchDeleteCalendarEventAttendeeOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeBatchDeleteCalendarEventAttendeeUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeBatchDeleteCalendarEventAttendeeUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeBatchDeleteCalendarEventAttendeeOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( - UserIdTypeCreateCalendarEventAttendeeUserId = "user_id" // 以user_id来识别用户id - UserIdTypeCreateCalendarEventAttendeeUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeCreateCalendarEventAttendeeOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeCreateCalendarEventAttendeeUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeCreateCalendarEventAttendeeUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeCreateCalendarEventAttendeeOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( - UserIdTypeListCalendarEventAttendeeUserId = "user_id" // 以user_id来识别用户id - UserIdTypeListCalendarEventAttendeeUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeListCalendarEventAttendeeOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeListCalendarEventAttendeeUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeListCalendarEventAttendeeUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeListCalendarEventAttendeeOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( - UserIdTypeListCalendarEventAttendeeChatMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListCalendarEventAttendeeChatMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListCalendarEventAttendeeChatMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListCalendarEventAttendeeChatMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListCalendarEventAttendeeChatMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListCalendarEventAttendeeChatMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateExchangeBindingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateExchangeBindingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateExchangeBindingOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateExchangeBindingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateExchangeBindingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateExchangeBindingOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetExchangeBindingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetExchangeBindingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetExchangeBindingOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetExchangeBindingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetExchangeBindingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetExchangeBindingOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListFreebusyUserId = "user_id" // 以user_id来识别用户id - UserIdTypeListFreebusyUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeListFreebusyOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeListFreebusyUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeListFreebusyUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeListFreebusyOpenId = "open_id" // 以 open_id 来识别用户 id ) const ( - UserIdTypeCreateTimeoffEventUserId = "user_id" // 以user_id来识别用户id - UserIdTypeCreateTimeoffEventUnionId = "union_id" // 以union_id来识别用户id - UserIdTypeCreateTimeoffEventOpenId = "open_id" // 以open_id来识别用户id + UserIdTypeCreateTimeoffEventUserId = "user_id" // 以 user_id 来识别用户 id + UserIdTypeCreateTimeoffEventUnionId = "union_id" // 以 union_id 来识别用户 id + UserIdTypeCreateTimeoffEventOpenId = "open_id" // 以 open_id 来识别用户 id ) type AclScope struct { - Type *string `json:"type,omitempty"` // 权限类型，当type为User时，值为open_id/user_id/union_id - UserId *string `json:"user_id,omitempty"` // 用户ID，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + Type *string `json:"type,omitempty"` // 权限类型，当 type 为 User 时，值为 open_id/user_id/union_id + UserId *string `json:"user_id,omitempty"` // 用户 ID，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) } type AclScopeBuilder struct { - type_ string // 权限类型，当type为User时，值为open_id/user_id/union_id + type_ string // 权限类型，当 type 为 User 时，值为 open_id/user_id/union_id typeFlag bool - userId string // 用户ID，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 用户 ID，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool } @@ -175,7 +175,7 @@ func NewAclScopeBuilder() *AclScopeBuilder { return builder } -// 权限类型，当type为User时，值为open_id/user_id/union_id +// 权限类型，当 type 为 User 时，值为 open_id/user_id/union_id // // 示例值：user func (builder *AclScopeBuilder) Type(type_ string) *AclScopeBuilder { @@ -184,7 +184,7 @@ func (builder *AclScopeBuilder) Type(type_ string) *AclScopeBuilder { return builder } -// 用户ID，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户 ID，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_xxxxxx func (builder *AclScopeBuilder) UserId(userId string) *AclScopeBuilder { @@ -207,12 +207,12 @@ func (builder *AclScopeBuilder) Build() *AclScope { } type AclScopeEvent struct { - Type *string `json:"type,omitempty"` // 权限类型，当type为User时，值为open_id/user_id/union_id + Type *string `json:"type,omitempty"` // 权限类型，当 type 为 User 时，值为 open_id/user_id/union_id UserId *UserId `json:"user_id,omitempty"` // 用户 ID } type AclScopeEventBuilder struct { - type_ string // 权限类型，当type为User时，值为open_id/user_id/union_id + type_ string // 权限类型，当 type 为 User 时，值为 open_id/user_id/union_id typeFlag bool userId *UserId // 用户 ID userIdFlag bool @@ -223,7 +223,7 @@ func NewAclScopeEventBuilder() *AclScopeEventBuilder { return builder } -// 权限类型，当type为User时，值为open_id/user_id/union_id +// 权限类型，当 type 为 User 时，值为 open_id/user_id/union_id // // 示例值：user func (builder *AclScopeEventBuilder) Type(type_ string) *AclScopeEventBuilder { @@ -254,7 +254,7 @@ func (builder *AclScopeEventBuilder) Build() *AclScopeEvent { } type AttendeeChatMember struct { - RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人RSVP状态 + RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人 RSVP 状态 IsOptional *bool `json:"is_optional,omitempty"` // 参与人是否为「可选参加」 DisplayName *string `json:"display_name,omitempty"` // 参与人名称 IsOrganizer *bool `json:"is_organizer,omitempty"` // 参与人是否为日程组织者 @@ -262,7 +262,7 @@ type AttendeeChatMember struct { } type AttendeeChatMemberBuilder struct { - rsvpStatus string // 参与人RSVP状态 + rsvpStatus string // 参与人 RSVP 状态 rsvpStatusFlag bool isOptional bool // 参与人是否为「可选参加」 isOptionalFlag bool @@ -279,7 +279,7 @@ func NewAttendeeChatMemberBuilder() *AttendeeChatMemberBuilder { return builder } -// 参与人RSVP状态 +// 参与人 RSVP 状态 // // 示例值：needs_action func (builder *AttendeeChatMemberBuilder) RsvpStatus(rsvpStatus string) *AttendeeChatMemberBuilder { @@ -350,11 +350,11 @@ func (builder *AttendeeChatMemberBuilder) Build() *AttendeeChatMember { } type Calendar struct { - CalendarId *string `json:"calendar_id,omitempty"` // 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) + CalendarId *string `json:"calendar_id,omitempty"` // 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) Summary *string `json:"summary,omitempty"` // 日历标题 Description *string `json:"description,omitempty"` // 日历描述 Permissions *string `json:"permissions,omitempty"` // 日历公开范围 - Color *int `json:"color,omitempty"` // 日历颜色，颜色RGB值的int32表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 + Color *int `json:"color,omitempty"` // 日历颜色，颜色 RGB 值的 int32 表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 Type *string `json:"type,omitempty"` // 日历类型 SummaryAlias *string `json:"summary_alias,omitempty"` // 日历备注名，修改或添加后仅对当前身份生效 IsDeleted *bool `json:"is_deleted,omitempty"` // 对于当前身份，日历是否已经被标记为删除 @@ -363,7 +363,7 @@ type Calendar struct { } type CalendarBuilder struct { - calendarId string // 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) + calendarId string // 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) calendarIdFlag bool summary string // 日历标题 summaryFlag bool @@ -371,7 +371,7 @@ type CalendarBuilder struct { descriptionFlag bool permissions string // 日历公开范围 permissionsFlag bool - color int // 日历颜色，颜色RGB值的int32表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 + color int // 日历颜色，颜色 RGB 值的 int32 表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 colorFlag bool type_ string // 日历类型 typeFlag bool @@ -390,7 +390,7 @@ func NewCalendarBuilder() *CalendarBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *CalendarBuilder) CalendarId(calendarId string) *CalendarBuilder { @@ -426,7 +426,7 @@ func (builder *CalendarBuilder) Permissions(permissions string) *CalendarBuilder return builder } -// 日历颜色，颜色RGB值的int32表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 +// 日历颜色，颜色 RGB 值的 int32 表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 // // 示例值：-1 func (builder *CalendarBuilder) Color(color int) *CalendarBuilder { @@ -526,13 +526,13 @@ func (builder *CalendarBuilder) Build() *Calendar { } type CalendarAcl struct { - AclId *string `json:"acl_id,omitempty"` // acl资源ID。参见[ACL ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) + AclId *string `json:"acl_id,omitempty"` // acl 资源 ID。参见 [ACL ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) Role *string `json:"role,omitempty"` // 对日历的访问权限 Scope *AclScope `json:"scope,omitempty"` // 权限范围 } type CalendarAclBuilder struct { - aclId string // acl资源ID。参见[ACL ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) + aclId string // acl 资源 ID。参见 [ACL ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) aclIdFlag bool role string // 对日历的访问权限 roleFlag bool @@ -545,7 +545,7 @@ func NewCalendarAclBuilder() *CalendarAclBuilder { return builder } -// acl资源ID。参见[ACL ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) +// acl 资源 ID。参见 [ACL ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) // // 示例值：user_xxxxxx func (builder *CalendarAclBuilder) AclId(aclId string) *CalendarAclBuilder { @@ -589,14 +589,14 @@ func (builder *CalendarAclBuilder) Build() *CalendarAcl { } type CalendarAclEvent struct { - AclId *string `json:"acl_id,omitempty"` // acl资源ID + AclId *string `json:"acl_id,omitempty"` // acl 资源 ID Role *string `json:"role,omitempty"` // 对日历的访问权限 Scope *AclScopeEvent `json:"scope,omitempty"` // 权限范围 UserIdList []*UserId `json:"user_id_list,omitempty"` // 需要推送事件的用户列表 } type CalendarAclEventBuilder struct { - aclId string // acl资源ID + aclId string // acl 资源 ID aclIdFlag bool role string // 对日历的访问权限 roleFlag bool @@ -611,7 +611,7 @@ func NewCalendarAclEventBuilder() *CalendarAclEventBuilder { return builder } -// acl资源ID +// acl 资源 ID // // 示例值：user_xxxxx func (builder *CalendarAclEventBuilder) AclId(aclId string) *CalendarAclEventBuilder { @@ -667,15 +667,15 @@ func (builder *CalendarAclEventBuilder) Build() *CalendarAclEvent { } type CalendarAttendeeResourceCustomization struct { - IndexKey *string `json:"index_key,omitempty"` // 每个配置的唯一ID - InputContent *string `json:"input_content,omitempty"` // 当type类型为填空时，该参数需要填入 + IndexKey *string `json:"index_key,omitempty"` // 每个配置的唯一 ID + InputContent *string `json:"input_content,omitempty"` // 当 type 类型为填空时，该参数需要填入 Options []*CustomizationOption `json:"options,omitempty"` // 每个配置的选项 } type CalendarAttendeeResourceCustomizationBuilder struct { - indexKey string // 每个配置的唯一ID + indexKey string // 每个配置的唯一 ID indexKeyFlag bool - inputContent string // 当type类型为填空时，该参数需要填入 + inputContent string // 当 type 类型为填空时，该参数需要填入 inputContentFlag bool options []*CustomizationOption // 每个配置的选项 optionsFlag bool @@ -686,7 +686,7 @@ func NewCalendarAttendeeResourceCustomizationBuilder() *CalendarAttendeeResource return builder } -// 每个配置的唯一ID +// 每个配置的唯一 ID // // 示例值：16281481596100 func (builder *CalendarAttendeeResourceCustomizationBuilder) IndexKey(indexKey string) *CalendarAttendeeResourceCustomizationBuilder { @@ -695,7 +695,7 @@ func (builder *CalendarAttendeeResourceCustomizationBuilder) IndexKey(indexKey s return builder } -// 当type类型为填空时，该参数需要填入 +// 当 type 类型为填空时，该参数需要填入 // // 示例值：xxx func (builder *CalendarAttendeeResourceCustomizationBuilder) InputContent(inputContent string) *CalendarAttendeeResourceCustomizationBuilder { @@ -730,38 +730,38 @@ func (builder *CalendarAttendeeResourceCustomizationBuilder) Build() *CalendarAt } type CalendarEvent struct { - EventId *string `json:"event_id,omitempty"` // 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) - OrganizerCalendarId *string `json:"organizer_calendar_id,omitempty"` // 日程组织者日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) + EventId *string `json:"event_id,omitempty"` // 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) + OrganizerCalendarId *string `json:"organizer_calendar_id,omitempty"` // 日程组织者日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) Summary *string `json:"summary,omitempty"` // 日程标题 Description *string `json:"description,omitempty"` // 日程描述；目前不支持编辑富文本描述，如果日程描述通过客户端编辑过，更新描述会导致富文本格式丢失 - NeedNotification *bool `json:"need_notification,omitempty"` // 更新日程是否给日程参与人发送bot通知，默认为true + NeedNotification *bool `json:"need_notification,omitempty"` // 更新日程是否给日程参与人发送 bot 通知，默认为 true StartTime *TimeInfo `json:"start_time,omitempty"` // 日程开始时间 EndTime *TimeInfo `json:"end_time,omitempty"` // 日程结束时间 Vchat *Vchat `json:"vchat,omitempty"` // 视频会议信息。 - Visibility *string `json:"visibility,omitempty"` // 日程公开范围，新建日程默认为Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + Visibility *string `json:"visibility,omitempty"` // 日程公开范围，新建日程默认为 Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 AttendeeAbility *string `json:"attendee_ability,omitempty"` // 参与人权限 - FreeBusyStatus *string `json:"free_busy_status,omitempty"` // 日程占用的忙闲状态，新建日程默认为Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + FreeBusyStatus *string `json:"free_busy_status,omitempty"` // 日程占用的忙闲状态，新建日程默认为 Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 Location *EventLocation `json:"location,omitempty"` // 日程地点 - Color *int `json:"color,omitempty"` // 日程颜色，颜色RGB值的int32表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为0或-1时默认跟随日历颜色。 + Color *int `json:"color,omitempty"` // 日程颜色，颜色 RGB 值的 int32 表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为 0 或-1 时默认跟随日历颜色。 Reminders []*Reminder `json:"reminders,omitempty"` // 日程提醒列表 - Recurrence *string `json:"recurrence,omitempty"` // 重复日程的重复性规则；参考[rfc5545](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10)；;- 不支持COUNT和UNTIL同时出现；;- 预定会议室重复日程长度不得超过两年。 + Recurrence *string `json:"recurrence,omitempty"` // 重复日程的重复性规则；参考 [rfc5545](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10)；;- 不支持 COUNT 和 UNTIL 同时出现；;- 预定会议室重复日程长度不得超过两年。 Status *string `json:"status,omitempty"` // 日程状态 IsException *bool `json:"is_exception,omitempty"` // 日程是否是一个重复日程的例外日程 - RecurringEventId *string `json:"recurring_event_id,omitempty"` // 例外日程的原重复日程的event_id + RecurringEventId *string `json:"recurring_event_id,omitempty"` // 例外日程的原重复日程的 event_id CreateTime *string `json:"create_time,omitempty"` // 日程的创建时间（秒级时间戳） - Schemas []*Schema `json:"schemas,omitempty"` // 日程自定义信息；控制日程详情页的ui展示。 + Schemas []*Schema `json:"schemas,omitempty"` // 日程自定义信息；控制日程详情页的 ui 展示。 } type CalendarEventBuilder struct { - eventId string // 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) + eventId string // 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) eventIdFlag bool - organizerCalendarId string // 日程组织者日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) + organizerCalendarId string // 日程组织者日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) organizerCalendarIdFlag bool summary string // 日程标题 summaryFlag bool description string // 日程描述；目前不支持编辑富文本描述，如果日程描述通过客户端编辑过，更新描述会导致富文本格式丢失 descriptionFlag bool - needNotification bool // 更新日程是否给日程参与人发送bot通知，默认为true + needNotification bool // 更新日程是否给日程参与人发送 bot 通知，默认为 true needNotificationFlag bool startTime *TimeInfo // 日程开始时间 startTimeFlag bool @@ -769,29 +769,29 @@ type CalendarEventBuilder struct { endTimeFlag bool vchat *Vchat // 视频会议信息。 vchatFlag bool - visibility string // 日程公开范围，新建日程默认为Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + visibility string // 日程公开范围，新建日程默认为 Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 visibilityFlag bool attendeeAbility string // 参与人权限 attendeeAbilityFlag bool - freeBusyStatus string // 日程占用的忙闲状态，新建日程默认为Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + freeBusyStatus string // 日程占用的忙闲状态，新建日程默认为 Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 freeBusyStatusFlag bool location *EventLocation // 日程地点 locationFlag bool - color int // 日程颜色，颜色RGB值的int32表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为0或-1时默认跟随日历颜色。 + color int // 日程颜色，颜色 RGB 值的 int32 表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为 0 或-1 时默认跟随日历颜色。 colorFlag bool reminders []*Reminder // 日程提醒列表 remindersFlag bool - recurrence string // 重复日程的重复性规则；参考[rfc5545](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10)；;- 不支持COUNT和UNTIL同时出现；;- 预定会议室重复日程长度不得超过两年。 + recurrence string // 重复日程的重复性规则；参考 [rfc5545](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10)；;- 不支持 COUNT 和 UNTIL 同时出现；;- 预定会议室重复日程长度不得超过两年。 recurrenceFlag bool status string // 日程状态 statusFlag bool isException bool // 日程是否是一个重复日程的例外日程 isExceptionFlag bool - recurringEventId string // 例外日程的原重复日程的event_id + recurringEventId string // 例外日程的原重复日程的 event_id recurringEventIdFlag bool createTime string // 日程的创建时间（秒级时间戳） createTimeFlag bool - schemas []*Schema // 日程自定义信息；控制日程详情页的ui展示。 + schemas []*Schema // 日程自定义信息；控制日程详情页的 ui 展示。 schemasFlag bool } @@ -800,7 +800,7 @@ func NewCalendarEventBuilder() *CalendarEventBuilder { return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：00592a0e-7edf-4678-bc9d-1b77383ef08e_0 func (builder *CalendarEventBuilder) EventId(eventId string) *CalendarEventBuilder { @@ -809,7 +809,7 @@ func (builder *CalendarEventBuilder) EventId(eventId string) *CalendarEventBuild return builder } -// 日程组织者日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日程组织者日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *CalendarEventBuilder) OrganizerCalendarId(organizerCalendarId string) *CalendarEventBuilder { @@ -836,7 +836,7 @@ func (builder *CalendarEventBuilder) Description(description string) *CalendarEv return builder } -// 更新日程是否给日程参与人发送bot通知，默认为true +// 更新日程是否给日程参与人发送 bot 通知，默认为 true // // 示例值：false func (builder *CalendarEventBuilder) NeedNotification(needNotification bool) *CalendarEventBuilder { @@ -872,7 +872,7 @@ func (builder *CalendarEventBuilder) Vchat(vchat *Vchat) *CalendarEventBuilder { return builder } -// 日程公开范围，新建日程默认为Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 +// 日程公开范围，新建日程默认为 Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 // // 示例值：default func (builder *CalendarEventBuilder) Visibility(visibility string) *CalendarEventBuilder { @@ -890,7 +890,7 @@ func (builder *CalendarEventBuilder) AttendeeAbility(attendeeAbility string) *Ca return builder } -// 日程占用的忙闲状态，新建日程默认为Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 +// 日程占用的忙闲状态，新建日程默认为 Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 // // 示例值：busy func (builder *CalendarEventBuilder) FreeBusyStatus(freeBusyStatus string) *CalendarEventBuilder { @@ -908,7 +908,7 @@ func (builder *CalendarEventBuilder) Location(location *EventLocation) *Calendar return builder } -// 日程颜色，颜色RGB值的int32表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为0或-1时默认跟随日历颜色。 +// 日程颜色，颜色 RGB 值的 int32 表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为 0 或-1 时默认跟随日历颜色。 // // 示例值：-1 func (builder *CalendarEventBuilder) Color(color int) *CalendarEventBuilder { @@ -926,7 +926,7 @@ func (builder *CalendarEventBuilder) Reminders(reminders []*Reminder) *CalendarE return builder } -// 重复日程的重复性规则；参考[rfc5545](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10)；;- 不支持COUNT和UNTIL同时出现；;- 预定会议室重复日程长度不得超过两年。 +// 重复日程的重复性规则；参考 [rfc5545](https://datatracker.ietf.org/doc/html/rfc5545#section-3.3.10)；;- 不支持 COUNT 和 UNTIL 同时出现；;- 预定会议室重复日程长度不得超过两年。 // // 示例值：FREQ=DAILY;INTERVAL=1 func (builder *CalendarEventBuilder) Recurrence(recurrence string) *CalendarEventBuilder { @@ -953,7 +953,7 @@ func (builder *CalendarEventBuilder) IsException(isException bool) *CalendarEven return builder } -// 例外日程的原重复日程的event_id +// 例外日程的原重复日程的 event_id // // 示例值：1cd45aaa-fa70-4195-80b7-c93b2e208f45 func (builder *CalendarEventBuilder) RecurringEventId(recurringEventId string) *CalendarEventBuilder { @@ -971,7 +971,7 @@ func (builder *CalendarEventBuilder) CreateTime(createTime string) *CalendarEven return builder } -// 日程自定义信息；控制日程详情页的ui展示。 +// 日程自定义信息；控制日程详情页的 ui 展示。 // // 示例值： func (builder *CalendarEventBuilder) Schemas(schemas []*Schema) *CalendarEventBuilder { @@ -1061,27 +1061,27 @@ func (builder *CalendarEventBuilder) Build() *CalendarEvent { type CalendarEventAttendee struct { Type *string `json:"type,omitempty"` // 参与人类型 - AttendeeId *string `json:"attendee_id,omitempty"` // 参与人ID。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) - RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人RSVP状态 + AttendeeId *string `json:"attendee_id,omitempty"` // 参与人 ID。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) + RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人 RSVP 状态 IsOptional *bool `json:"is_optional,omitempty"` // 参与人是否为「可选参加」，无法编辑群参与人的此字段 IsOrganizer *bool `json:"is_organizer,omitempty"` // 参与人是否为日程组织者 IsExternal *bool `json:"is_external,omitempty"` // 参与人是否为外部参与人；外部参与人不支持编辑 DisplayName *string `json:"display_name,omitempty"` // 参与人名称 - ChatMembers []*AttendeeChatMember `json:"chat_members,omitempty"` // 群中的群成员，当type为Chat时有效；群成员不支持编辑 - UserId *string `json:"user_id,omitempty"` // 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - ChatId *string `json:"chat_id,omitempty"` // chat类型参与人的群组chat_id，参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) - RoomId *string `json:"room_id,omitempty"` // resource类型参与人的会议室room_id - ThirdPartyEmail *string `json:"third_party_email,omitempty"` // third_party类型参与人的邮箱 - OperateId *string `json:"operate_id,omitempty"` // 如果日程是使用应用身份创建的，在添加会议室的时候，用来指定会议室的联系人，在会议室视图展示。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + ChatMembers []*AttendeeChatMember `json:"chat_members,omitempty"` // 群中的群成员，当 type 为 Chat 时有效；群成员不支持编辑 + UserId *string `json:"user_id,omitempty"` // 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + ChatId *string `json:"chat_id,omitempty"` // chat 类型参与人的群组 chat_id，参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + RoomId *string `json:"room_id,omitempty"` // resource 类型参与人的会议室 room_id + ThirdPartyEmail *string `json:"third_party_email,omitempty"` // third_party 类型参与人的邮箱 + OperateId *string `json:"operate_id,omitempty"` // 如果日程是使用应用身份创建的，在添加会议室的时候，用来指定会议室的联系人，在会议室视图展示。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) ResourceCustomization []*CalendarAttendeeResourceCustomization `json:"resource_customization,omitempty"` // 会议室的个性化配置 } type CalendarEventAttendeeBuilder struct { type_ string // 参与人类型 typeFlag bool - attendeeId string // 参与人ID。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) + attendeeId string // 参与人 ID。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) attendeeIdFlag bool - rsvpStatus string // 参与人RSVP状态 + rsvpStatus string // 参与人 RSVP 状态 rsvpStatusFlag bool isOptional bool // 参与人是否为「可选参加」，无法编辑群参与人的此字段 isOptionalFlag bool @@ -1091,17 +1091,17 @@ type CalendarEventAttendeeBuilder struct { isExternalFlag bool displayName string // 参与人名称 displayNameFlag bool - chatMembers []*AttendeeChatMember // 群中的群成员，当type为Chat时有效；群成员不支持编辑 + chatMembers []*AttendeeChatMember // 群中的群成员，当 type 为 Chat 时有效；群成员不支持编辑 chatMembersFlag bool - userId string // 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool - chatId string // chat类型参与人的群组chat_id，参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + chatId string // chat 类型参与人的群组 chat_id，参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) chatIdFlag bool - roomId string // resource类型参与人的会议室room_id + roomId string // resource 类型参与人的会议室 room_id roomIdFlag bool - thirdPartyEmail string // third_party类型参与人的邮箱 + thirdPartyEmail string // third_party 类型参与人的邮箱 thirdPartyEmailFlag bool - operateId string // 如果日程是使用应用身份创建的，在添加会议室的时候，用来指定会议室的联系人，在会议室视图展示。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + operateId string // 如果日程是使用应用身份创建的，在添加会议室的时候，用来指定会议室的联系人，在会议室视图展示。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) operateIdFlag bool resourceCustomization []*CalendarAttendeeResourceCustomization // 会议室的个性化配置 resourceCustomizationFlag bool @@ -1121,7 +1121,7 @@ func (builder *CalendarEventAttendeeBuilder) Type(type_ string) *CalendarEventAt return builder } -// 参与人ID。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) +// 参与人 ID。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) // // 示例值：user_xxxxxx func (builder *CalendarEventAttendeeBuilder) AttendeeId(attendeeId string) *CalendarEventAttendeeBuilder { @@ -1130,7 +1130,7 @@ func (builder *CalendarEventAttendeeBuilder) AttendeeId(attendeeId string) *Cale return builder } -// 参与人RSVP状态 +// 参与人 RSVP 状态 // // 示例值：needs_action func (builder *CalendarEventAttendeeBuilder) RsvpStatus(rsvpStatus string) *CalendarEventAttendeeBuilder { @@ -1175,7 +1175,7 @@ func (builder *CalendarEventAttendeeBuilder) DisplayName(displayName string) *Ca return builder } -// 群中的群成员，当type为Chat时有效；群成员不支持编辑 +// 群中的群成员，当 type 为 Chat 时有效；群成员不支持编辑 // // 示例值： func (builder *CalendarEventAttendeeBuilder) ChatMembers(chatMembers []*AttendeeChatMember) *CalendarEventAttendeeBuilder { @@ -1184,7 +1184,7 @@ func (builder *CalendarEventAttendeeBuilder) ChatMembers(chatMembers []*Attendee return builder } -// 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_xxxxxxxx func (builder *CalendarEventAttendeeBuilder) UserId(userId string) *CalendarEventAttendeeBuilder { @@ -1193,7 +1193,7 @@ func (builder *CalendarEventAttendeeBuilder) UserId(userId string) *CalendarEven return builder } -// chat类型参与人的群组chat_id，参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// chat 类型参与人的群组 chat_id，参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_xxxxxxxxx func (builder *CalendarEventAttendeeBuilder) ChatId(chatId string) *CalendarEventAttendeeBuilder { @@ -1202,7 +1202,7 @@ func (builder *CalendarEventAttendeeBuilder) ChatId(chatId string) *CalendarEven return builder } -// resource类型参与人的会议室room_id +// resource 类型参与人的会议室 room_id // // 示例值：omm_xxxxxxxx func (builder *CalendarEventAttendeeBuilder) RoomId(roomId string) *CalendarEventAttendeeBuilder { @@ -1211,7 +1211,7 @@ func (builder *CalendarEventAttendeeBuilder) RoomId(roomId string) *CalendarEven return builder } -// third_party类型参与人的邮箱 +// third_party 类型参与人的邮箱 // // 示例值：wangwu@email.com func (builder *CalendarEventAttendeeBuilder) ThirdPartyEmail(thirdPartyEmail string) *CalendarEventAttendeeBuilder { @@ -1220,7 +1220,7 @@ func (builder *CalendarEventAttendeeBuilder) ThirdPartyEmail(thirdPartyEmail str return builder } -// 如果日程是使用应用身份创建的，在添加会议室的时候，用来指定会议室的联系人，在会议室视图展示。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 如果日程是使用应用身份创建的，在添加会议室的时候，用来指定会议室的联系人，在会议室视图展示。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_xxxxxxxx func (builder *CalendarEventAttendeeBuilder) OperateId(operateId string) *CalendarEventAttendeeBuilder { @@ -1298,22 +1298,22 @@ func (builder *CalendarEventAttendeeBuilder) Build() *CalendarEventAttendee { } type CalendarEventAttendeeChatMember struct { - RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人RSVP状态 + RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人 RSVP 状态 IsOptional *bool `json:"is_optional,omitempty"` // 参与人是否为「可选参加」 DisplayName *string `json:"display_name,omitempty"` // 参与人名称 - OpenId *string `json:"open_id,omitempty"` // 参与人open_id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;**示例值**："ou_xxxxxxxx" + OpenId *string `json:"open_id,omitempty"` // 参与人 open_id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;** 示例值 **："ou_xxxxxxxx" IsOrganizer *bool `json:"is_organizer,omitempty"` // 参与人是否为日程组织者 IsExternal *bool `json:"is_external,omitempty"` // 参与人是否为外部参与人 } type CalendarEventAttendeeChatMemberBuilder struct { - rsvpStatus string // 参与人RSVP状态 + rsvpStatus string // 参与人 RSVP 状态 rsvpStatusFlag bool isOptional bool // 参与人是否为「可选参加」 isOptionalFlag bool displayName string // 参与人名称 displayNameFlag bool - openId string // 参与人open_id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;**示例值**："ou_xxxxxxxx" + openId string // 参与人 open_id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;** 示例值 **："ou_xxxxxxxx" openIdFlag bool isOrganizer bool // 参与人是否为日程组织者 isOrganizerFlag bool @@ -1326,7 +1326,7 @@ func NewCalendarEventAttendeeChatMemberBuilder() *CalendarEventAttendeeChatMembe return builder } -// 参与人RSVP状态 +// 参与人 RSVP 状态 // // 示例值：needs_action func (builder *CalendarEventAttendeeChatMemberBuilder) RsvpStatus(rsvpStatus string) *CalendarEventAttendeeChatMemberBuilder { @@ -1353,7 +1353,7 @@ func (builder *CalendarEventAttendeeChatMemberBuilder) DisplayName(displayName s return builder } -// 参与人open_id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;**示例值**："ou_xxxxxxxx" +// 参与人 open_id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;** 示例值 **："ou_xxxxxxxx" // // 示例值：ou_143669c5a53647f00f6c80a0253aa68b func (builder *CalendarEventAttendeeChatMemberBuilder) OpenId(openId string) *CalendarEventAttendeeChatMemberBuilder { @@ -1411,25 +1411,25 @@ func (builder *CalendarEventAttendeeChatMemberBuilder) Build() *CalendarEventAtt type CalendarEventAttendeeId struct { Type *string `json:"type,omitempty"` // 参与人类型，仅当新建参与人时可设置类型 - AttendeeId *string `json:"attendee_id,omitempty"` // 参与人ID - UserId *string `json:"user_id,omitempty"` // 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id - ChatId *string `json:"chat_id,omitempty"` // chat类型参与人的群组chat_id - RoomId *string `json:"room_id,omitempty"` // resource类型参与人的会议室room_id - ThirdPartyEmail *string `json:"third_party_email,omitempty"` // third_party类型参与人的邮箱 + AttendeeId *string `json:"attendee_id,omitempty"` // 参与人 ID + UserId *string `json:"user_id,omitempty"` // 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id + ChatId *string `json:"chat_id,omitempty"` // chat 类型参与人的群组 chat_id + RoomId *string `json:"room_id,omitempty"` // resource 类型参与人的会议室 room_id + ThirdPartyEmail *string `json:"third_party_email,omitempty"` // third_party 类型参与人的邮箱 } type CalendarEventAttendeeIdBuilder struct { type_ string // 参与人类型，仅当新建参与人时可设置类型 typeFlag bool - attendeeId string // 参与人ID + attendeeId string // 参与人 ID attendeeIdFlag bool - userId string // 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id + userId string // 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id userIdFlag bool - chatId string // chat类型参与人的群组chat_id + chatId string // chat 类型参与人的群组 chat_id chatIdFlag bool - roomId string // resource类型参与人的会议室room_id + roomId string // resource 类型参与人的会议室 room_id roomIdFlag bool - thirdPartyEmail string // third_party类型参与人的邮箱 + thirdPartyEmail string // third_party 类型参与人的邮箱 thirdPartyEmailFlag bool } @@ -1447,7 +1447,7 @@ func (builder *CalendarEventAttendeeIdBuilder) Type(type_ string) *CalendarEvent return builder } -// 参与人ID +// 参与人 ID // // 示例值： func (builder *CalendarEventAttendeeIdBuilder) AttendeeId(attendeeId string) *CalendarEventAttendeeIdBuilder { @@ -1456,7 +1456,7 @@ func (builder *CalendarEventAttendeeIdBuilder) AttendeeId(attendeeId string) *Ca return builder } -// 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id +// 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id // // 示例值：ou_xxxxxxxx func (builder *CalendarEventAttendeeIdBuilder) UserId(userId string) *CalendarEventAttendeeIdBuilder { @@ -1465,7 +1465,7 @@ func (builder *CalendarEventAttendeeIdBuilder) UserId(userId string) *CalendarEv return builder } -// chat类型参与人的群组chat_id +// chat 类型参与人的群组 chat_id // // 示例值：oc_xxxxxxxxx func (builder *CalendarEventAttendeeIdBuilder) ChatId(chatId string) *CalendarEventAttendeeIdBuilder { @@ -1474,7 +1474,7 @@ func (builder *CalendarEventAttendeeIdBuilder) ChatId(chatId string) *CalendarEv return builder } -// resource类型参与人的会议室room_id +// resource 类型参与人的会议室 room_id // // 示例值：omm_xxxxxxxx func (builder *CalendarEventAttendeeIdBuilder) RoomId(roomId string) *CalendarEventAttendeeIdBuilder { @@ -1483,7 +1483,7 @@ func (builder *CalendarEventAttendeeIdBuilder) RoomId(roomId string) *CalendarEv return builder } -// third_party类型参与人的邮箱 +// third_party 类型参与人的邮箱 // // 示例值：wangwu@email.com func (builder *CalendarEventAttendeeIdBuilder) ThirdPartyEmail(thirdPartyEmail string) *CalendarEventAttendeeIdBuilder { @@ -1523,27 +1523,27 @@ func (builder *CalendarEventAttendeeIdBuilder) Build() *CalendarEventAttendeeId type CalendarEventAttendeeResp struct { Type *string `json:"type,omitempty"` // 参与人类型，仅当新建参与人时可设置类型。 - AttendeeId *string `json:"attendee_id,omitempty"` // 参与人ID - RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人RSVP状态 + AttendeeId *string `json:"attendee_id,omitempty"` // 参与人 ID + RsvpStatus *string `json:"rsvp_status,omitempty"` // 参与人 RSVP 状态 IsOptional *bool `json:"is_optional,omitempty"` // 参与人是否为「可选参加」，无法编辑群参与人的此字段 IsOrganizer *bool `json:"is_organizer,omitempty"` // 参与人是否为日程组织者 IsExternal *bool `json:"is_external,omitempty"` // 参与人是否为外部参与人；外部参与人不支持编辑 DisplayName *string `json:"display_name,omitempty"` // 参与人名称 - ChatMembers []*AttendeeChatMember `json:"chat_members,omitempty"` // 群中的群成员，当type为Chat时有效；群成员不支持编辑 - UserId *string `json:"user_id,omitempty"` // 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id - ChatId *string `json:"chat_id,omitempty"` // chat类型参与人的群组chat_id - RoomId *string `json:"room_id,omitempty"` // resource类型参与人的会议室room_id - ThirdPartyEmail *string `json:"third_party_email,omitempty"` // third_party类型参与人的邮箱 - OperateId *string `json:"operate_id,omitempty"` // bot身份操作时，为预定的会议室指定实际预定人 + ChatMembers []*AttendeeChatMember `json:"chat_members,omitempty"` // 群中的群成员，当 type 为 Chat 时有效；群成员不支持编辑 + UserId *string `json:"user_id,omitempty"` // 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id + ChatId *string `json:"chat_id,omitempty"` // chat 类型参与人的群组 chat_id + RoomId *string `json:"room_id,omitempty"` // resource 类型参与人的会议室 room_id + ThirdPartyEmail *string `json:"third_party_email,omitempty"` // third_party 类型参与人的邮箱 + OperateId *string `json:"operate_id,omitempty"` // bot 身份操作时，为预定的会议室指定实际预定人 ResourceCustomization []*CalendarAttendeeResourceCustomization `json:"resource_customization,omitempty"` // 会议室的个性化配置 } type CalendarEventAttendeeRespBuilder struct { type_ string // 参与人类型，仅当新建参与人时可设置类型。 typeFlag bool - attendeeId string // 参与人ID + attendeeId string // 参与人 ID attendeeIdFlag bool - rsvpStatus string // 参与人RSVP状态 + rsvpStatus string // 参与人 RSVP 状态 rsvpStatusFlag bool isOptional bool // 参与人是否为「可选参加」，无法编辑群参与人的此字段 isOptionalFlag bool @@ -1553,17 +1553,17 @@ type CalendarEventAttendeeRespBuilder struct { isExternalFlag bool displayName string // 参与人名称 displayNameFlag bool - chatMembers []*AttendeeChatMember // 群中的群成员，当type为Chat时有效；群成员不支持编辑 + chatMembers []*AttendeeChatMember // 群中的群成员，当 type 为 Chat 时有效；群成员不支持编辑 chatMembersFlag bool - userId string // 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id + userId string // 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id userIdFlag bool - chatId string // chat类型参与人的群组chat_id + chatId string // chat 类型参与人的群组 chat_id chatIdFlag bool - roomId string // resource类型参与人的会议室room_id + roomId string // resource 类型参与人的会议室 room_id roomIdFlag bool - thirdPartyEmail string // third_party类型参与人的邮箱 + thirdPartyEmail string // third_party 类型参与人的邮箱 thirdPartyEmailFlag bool - operateId string // bot身份操作时，为预定的会议室指定实际预定人 + operateId string // bot 身份操作时，为预定的会议室指定实际预定人 operateIdFlag bool resourceCustomization []*CalendarAttendeeResourceCustomization // 会议室的个性化配置 resourceCustomizationFlag bool @@ -1583,7 +1583,7 @@ func (builder *CalendarEventAttendeeRespBuilder) Type(type_ string) *CalendarEve return builder } -// 参与人ID +// 参与人 ID // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) AttendeeId(attendeeId string) *CalendarEventAttendeeRespBuilder { @@ -1592,7 +1592,7 @@ func (builder *CalendarEventAttendeeRespBuilder) AttendeeId(attendeeId string) * return builder } -// 参与人RSVP状态 +// 参与人 RSVP 状态 // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) RsvpStatus(rsvpStatus string) *CalendarEventAttendeeRespBuilder { @@ -1637,7 +1637,7 @@ func (builder *CalendarEventAttendeeRespBuilder) DisplayName(displayName string) return builder } -// 群中的群成员，当type为Chat时有效；群成员不支持编辑 +// 群中的群成员，当 type 为 Chat 时有效；群成员不支持编辑 // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) ChatMembers(chatMembers []*AttendeeChatMember) *CalendarEventAttendeeRespBuilder { @@ -1646,7 +1646,7 @@ func (builder *CalendarEventAttendeeRespBuilder) ChatMembers(chatMembers []*Atte return builder } -// 参与人的用户id，依赖于user_id_type返回对应的取值，当is_external为true时，此字段只会返回open_id或者union_id +// 参与人的用户 id，依赖于 user_id_type 返回对应的取值，当 is_external 为 true 时，此字段只会返回 open_id 或者 union_id // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) UserId(userId string) *CalendarEventAttendeeRespBuilder { @@ -1655,7 +1655,7 @@ func (builder *CalendarEventAttendeeRespBuilder) UserId(userId string) *Calendar return builder } -// chat类型参与人的群组chat_id +// chat 类型参与人的群组 chat_id // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) ChatId(chatId string) *CalendarEventAttendeeRespBuilder { @@ -1664,7 +1664,7 @@ func (builder *CalendarEventAttendeeRespBuilder) ChatId(chatId string) *Calendar return builder } -// resource类型参与人的会议室room_id +// resource 类型参与人的会议室 room_id // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) RoomId(roomId string) *CalendarEventAttendeeRespBuilder { @@ -1673,7 +1673,7 @@ func (builder *CalendarEventAttendeeRespBuilder) RoomId(roomId string) *Calendar return builder } -// third_party类型参与人的邮箱 +// third_party 类型参与人的邮箱 // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) ThirdPartyEmail(thirdPartyEmail string) *CalendarEventAttendeeRespBuilder { @@ -1682,7 +1682,7 @@ func (builder *CalendarEventAttendeeRespBuilder) ThirdPartyEmail(thirdPartyEmail return builder } -// bot身份操作时，为预定的会议室指定实际预定人 +// bot 身份操作时，为预定的会议室指定实际预定人 // // 示例值： func (builder *CalendarEventAttendeeRespBuilder) OperateId(operateId string) *CalendarEventAttendeeRespBuilder { @@ -1760,32 +1760,32 @@ func (builder *CalendarEventAttendeeRespBuilder) Build() *CalendarEventAttendeeR } type CalendarEventResp struct { - EventId *string `json:"event_id,omitempty"` // 日程ID - OrganizerCalendarId *string `json:"organizer_calendar_id,omitempty"` // 日程组织者日历ID + EventId *string `json:"event_id,omitempty"` // 日程 ID + OrganizerCalendarId *string `json:"organizer_calendar_id,omitempty"` // 日程组织者日历 ID Summary *string `json:"summary,omitempty"` // 日程标题 Description *string `json:"description,omitempty"` // 日程描述 NeedNotification *bool `json:"need_notification,omitempty"` // 是否发送通知消息 StartTime *TimeInfo `json:"start_time,omitempty"` // 日程开始时间 EndTime *TimeInfo `json:"end_time,omitempty"` // 日程结束时间 - Vchat *Vchat `json:"vchat,omitempty"` // 视频会议信息，仅当日程至少有一位attendee时生效 - Visibility *string `json:"visibility,omitempty"` // 日程公开范围，新建日程默认为Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + Vchat *Vchat `json:"vchat,omitempty"` // 视频会议信息，仅当日程至少有一位 attendee 时生效 + Visibility *string `json:"visibility,omitempty"` // 日程公开范围，新建日程默认为 Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 AttendeeAbility *string `json:"attendee_ability,omitempty"` // 参与人权限 - FreeBusyStatus *string `json:"free_busy_status,omitempty"` // 日程占用的忙闲状态，新建日程默认为Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + FreeBusyStatus *string `json:"free_busy_status,omitempty"` // 日程占用的忙闲状态，新建日程默认为 Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 Location *EventLocation `json:"location,omitempty"` // 日程地点 - Color *int `json:"color,omitempty"` // 日程颜色，颜色RGB值的int32表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为0或-1时默认跟随日历颜色。 + Color *int `json:"color,omitempty"` // 日程颜色，颜色 RGB 值的 int32 表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为 0 或-1 时默认跟随日历颜色。 Reminders []*Reminder `json:"reminders,omitempty"` // 日程提醒列表 Recurrence *string `json:"recurrence,omitempty"` // 重复日程的重复性规则 Status *string `json:"status,omitempty"` // 日程状态 IsException *bool `json:"is_exception,omitempty"` // 日程是否是一个重复日程的例外日程 - RecurringEventId *string `json:"recurring_event_id,omitempty"` // 例外日程的原重复日程的event_id + RecurringEventId *string `json:"recurring_event_id,omitempty"` // 例外日程的原重复日程的 event_id CreateTime *string `json:"create_time,omitempty"` // 日程的创建时间戳 Schemas []*Schema `json:"schemas,omitempty"` // 日程自定义信息 } type CalendarEventRespBuilder struct { - eventId string // 日程ID + eventId string // 日程 ID eventIdFlag bool - organizerCalendarId string // 日程组织者日历ID + organizerCalendarId string // 日程组织者日历 ID organizerCalendarIdFlag bool summary string // 日程标题 summaryFlag bool @@ -1797,17 +1797,17 @@ type CalendarEventRespBuilder struct { startTimeFlag bool endTime *TimeInfo // 日程结束时间 endTimeFlag bool - vchat *Vchat // 视频会议信息，仅当日程至少有一位attendee时生效 + vchat *Vchat // 视频会议信息，仅当日程至少有一位 attendee 时生效 vchatFlag bool - visibility string // 日程公开范围，新建日程默认为Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + visibility string // 日程公开范围，新建日程默认为 Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 visibilityFlag bool attendeeAbility string // 参与人权限 attendeeAbilityFlag bool - freeBusyStatus string // 日程占用的忙闲状态，新建日程默认为Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 + freeBusyStatus string // 日程占用的忙闲状态，新建日程默认为 Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 freeBusyStatusFlag bool location *EventLocation // 日程地点 locationFlag bool - color int // 日程颜色，颜色RGB值的int32表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为0或-1时默认跟随日历颜色。 + color int // 日程颜色，颜色 RGB 值的 int32 表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为 0 或-1 时默认跟随日历颜色。 colorFlag bool reminders []*Reminder // 日程提醒列表 remindersFlag bool @@ -1817,7 +1817,7 @@ type CalendarEventRespBuilder struct { statusFlag bool isException bool // 日程是否是一个重复日程的例外日程 isExceptionFlag bool - recurringEventId string // 例外日程的原重复日程的event_id + recurringEventId string // 例外日程的原重复日程的 event_id recurringEventIdFlag bool createTime string // 日程的创建时间戳 createTimeFlag bool @@ -1830,7 +1830,7 @@ func NewCalendarEventRespBuilder() *CalendarEventRespBuilder { return builder } -// 日程ID +// 日程 ID // // 示例值： func (builder *CalendarEventRespBuilder) EventId(eventId string) *CalendarEventRespBuilder { @@ -1839,7 +1839,7 @@ func (builder *CalendarEventRespBuilder) EventId(eventId string) *CalendarEventR return builder } -// 日程组织者日历ID +// 日程组织者日历 ID // // 示例值： func (builder *CalendarEventRespBuilder) OrganizerCalendarId(organizerCalendarId string) *CalendarEventRespBuilder { @@ -1893,7 +1893,7 @@ func (builder *CalendarEventRespBuilder) EndTime(endTime *TimeInfo) *CalendarEve return builder } -// 视频会议信息，仅当日程至少有一位attendee时生效 +// 视频会议信息，仅当日程至少有一位 attendee 时生效 // // 示例值： func (builder *CalendarEventRespBuilder) Vchat(vchat *Vchat) *CalendarEventRespBuilder { @@ -1902,7 +1902,7 @@ func (builder *CalendarEventRespBuilder) Vchat(vchat *Vchat) *CalendarEventRespB return builder } -// 日程公开范围，新建日程默认为Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 +// 日程公开范围，新建日程默认为 Default；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 // // 示例值： func (builder *CalendarEventRespBuilder) Visibility(visibility string) *CalendarEventRespBuilder { @@ -1920,7 +1920,7 @@ func (builder *CalendarEventRespBuilder) AttendeeAbility(attendeeAbility string) return builder } -// 日程占用的忙闲状态，新建日程默认为Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 +// 日程占用的忙闲状态，新建日程默认为 Busy；仅新建日程时对所有参与人生效，之后修改该属性仅对当前身份生效 // // 示例值： func (builder *CalendarEventRespBuilder) FreeBusyStatus(freeBusyStatus string) *CalendarEventRespBuilder { @@ -1938,7 +1938,7 @@ func (builder *CalendarEventRespBuilder) Location(location *EventLocation) *Cale return builder } -// 日程颜色，颜色RGB值的int32表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为0或-1时默认跟随日历颜色。 +// 日程颜色，颜色 RGB 值的 int32 表示。仅对当前身份生效；客户端展示时会映射到色板上最接近的一种颜色；值为 0 或-1 时默认跟随日历颜色。 // // 示例值： func (builder *CalendarEventRespBuilder) Color(color int) *CalendarEventRespBuilder { @@ -1983,7 +1983,7 @@ func (builder *CalendarEventRespBuilder) IsException(isException bool) *Calendar return builder } -// 例外日程的原重复日程的event_id +// 例外日程的原重复日程的 event_id // // 示例值： func (builder *CalendarEventRespBuilder) RecurringEventId(recurringEventId string) *CalendarEventRespBuilder { @@ -2090,17 +2090,17 @@ func (builder *CalendarEventRespBuilder) Build() *CalendarEventResp { } type CalendarFreebusy struct { - StartTime *string `json:"start_time,omitempty"` // 忙闲信息开始时间，RFC3339 date_time格式 - EndTime *string `json:"end_time,omitempty"` // 忙闲信息结束时间，RFC3339 date_time格式 - CalendarId *string `json:"calendar_id,omitempty"` // 日历id + StartTime *string `json:"start_time,omitempty"` // 忙闲信息开始时间，RFC3339 date_time 格式 + EndTime *string `json:"end_time,omitempty"` // 忙闲信息结束时间，RFC3339 date_time 格式 + CalendarId *string `json:"calendar_id,omitempty"` // 日历 id } type CalendarFreebusyBuilder struct { - startTime string // 忙闲信息开始时间，RFC3339 date_time格式 + startTime string // 忙闲信息开始时间，RFC3339 date_time 格式 startTimeFlag bool - endTime string // 忙闲信息结束时间，RFC3339 date_time格式 + endTime string // 忙闲信息结束时间，RFC3339 date_time 格式 endTimeFlag bool - calendarId string // 日历id + calendarId string // 日历 id calendarIdFlag bool } @@ -2109,7 +2109,7 @@ func NewCalendarFreebusyBuilder() *CalendarFreebusyBuilder { return builder } -// 忙闲信息开始时间，RFC3339 date_time格式 +// 忙闲信息开始时间，RFC3339 date_time 格式 // // 示例值： func (builder *CalendarFreebusyBuilder) StartTime(startTime string) *CalendarFreebusyBuilder { @@ -2118,7 +2118,7 @@ func (builder *CalendarFreebusyBuilder) StartTime(startTime string) *CalendarFre return builder } -// 忙闲信息结束时间，RFC3339 date_time格式 +// 忙闲信息结束时间，RFC3339 date_time 格式 // // 示例值： func (builder *CalendarFreebusyBuilder) EndTime(endTime string) *CalendarFreebusyBuilder { @@ -2127,7 +2127,7 @@ func (builder *CalendarFreebusyBuilder) EndTime(endTime string) *CalendarFreebus return builder } -// 日历id +// 日历 id // // 示例值： func (builder *CalendarFreebusyBuilder) CalendarId(calendarId string) *CalendarFreebusyBuilder { @@ -2154,12 +2154,12 @@ func (builder *CalendarFreebusyBuilder) Build() *CalendarFreebusy { } type CalendarFreebusyError struct { - CalendarId *string `json:"calendar_id,omitempty"` // 日历id + CalendarId *string `json:"calendar_id,omitempty"` // 日历 id ErrorMsg *string `json:"error_msg,omitempty"` // 错误信息 } type CalendarFreebusyErrorBuilder struct { - calendarId string // 日历id + calendarId string // 日历 id calendarIdFlag bool errorMsg string // 错误信息 errorMsgFlag bool @@ -2170,7 +2170,7 @@ func NewCalendarFreebusyErrorBuilder() *CalendarFreebusyErrorBuilder { return builder } -// 日历id +// 日历 id // // 示例值： func (builder *CalendarFreebusyErrorBuilder) CalendarId(calendarId string) *CalendarFreebusyErrorBuilder { @@ -2202,14 +2202,14 @@ func (builder *CalendarFreebusyErrorBuilder) Build() *CalendarFreebusyError { } type CustomizationOption struct { - OptionKey *string `json:"option_key,omitempty"` // 每个选项的唯一ID - OthersContent *string `json:"others_content,omitempty"` // 当type类型为其它选项时，该参数需要填入 + OptionKey *string `json:"option_key,omitempty"` // 每个选项的唯一 ID + OthersContent *string `json:"others_content,omitempty"` // 当 type 类型为其它选项时，该参数需要填入 } type CustomizationOptionBuilder struct { - optionKey string // 每个选项的唯一ID + optionKey string // 每个选项的唯一 ID optionKeyFlag bool - othersContent string // 当type类型为其它选项时，该参数需要填入 + othersContent string // 当 type 类型为其它选项时，该参数需要填入 othersContentFlag bool } @@ -2218,7 +2218,7 @@ func NewCustomizationOptionBuilder() *CustomizationOptionBuilder { return builder } -// 每个选项的唯一ID +// 每个选项的唯一 ID // // 示例值：16281481596185 func (builder *CustomizationOptionBuilder) OptionKey(optionKey string) *CustomizationOptionBuilder { @@ -2227,7 +2227,7 @@ func (builder *CustomizationOptionBuilder) OptionKey(optionKey string) *Customiz return builder } -// 当type类型为其它选项时，该参数需要填入 +// 当 type 类型为其它选项时，该参数需要填入 // // 示例值：xxx func (builder *CustomizationOptionBuilder) OthersContent(othersContent string) *CustomizationOptionBuilder { @@ -2252,8 +2252,8 @@ func (builder *CustomizationOptionBuilder) Build() *CustomizationOption { type EventLocation struct { Name *string `json:"name,omitempty"` // 地点名称 Address *string `json:"address,omitempty"` // 地点地址 - Latitude *float64 `json:"latitude,omitempty"` // 地点坐标纬度信息，对于国内的地点，采用GCJ-02标准，海外地点采用WGS84标准 - Longitude *float64 `json:"longitude,omitempty"` // 地点坐标经度信息，对于国内的地点，采用GCJ-02标准，海外地点采用WGS84标准 + Latitude *float64 `json:"latitude,omitempty"` // 地点坐标纬度信息，对于国内的地点，采用 GCJ-02 标准，海外地点采用 WGS84 标准 + Longitude *float64 `json:"longitude,omitempty"` // 地点坐标经度信息，对于国内的地点，采用 GCJ-02 标准，海外地点采用 WGS84 标准 } type EventLocationBuilder struct { @@ -2261,9 +2261,9 @@ type EventLocationBuilder struct { nameFlag bool address string // 地点地址 addressFlag bool - latitude float64 // 地点坐标纬度信息，对于国内的地点，采用GCJ-02标准，海外地点采用WGS84标准 + latitude float64 // 地点坐标纬度信息，对于国内的地点，采用 GCJ-02 标准，海外地点采用 WGS84 标准 latitudeFlag bool - longitude float64 // 地点坐标经度信息，对于国内的地点，采用GCJ-02标准，海外地点采用WGS84标准 + longitude float64 // 地点坐标经度信息，对于国内的地点，采用 GCJ-02 标准，海外地点采用 WGS84 标准 longitudeFlag bool } @@ -2290,7 +2290,7 @@ func (builder *EventLocationBuilder) Address(address string) *EventLocationBuild return builder } -// 地点坐标纬度信息，对于国内的地点，采用GCJ-02标准，海外地点采用WGS84标准 +// 地点坐标纬度信息，对于国内的地点，采用 GCJ-02 标准，海外地点采用 WGS84 标准 // // 示例值：1.100000023841858 func (builder *EventLocationBuilder) Latitude(latitude float64) *EventLocationBuilder { @@ -2299,7 +2299,7 @@ func (builder *EventLocationBuilder) Latitude(latitude float64) *EventLocationBu return builder } -// 地点坐标经度信息，对于国内的地点，采用GCJ-02标准，海外地点采用WGS84标准 +// 地点坐标经度信息，对于国内的地点，采用 GCJ-02 标准，海外地点采用 WGS84 标准 // // 示例值：2.200000047683716 func (builder *EventLocationBuilder) Longitude(longitude float64) *EventLocationBuilder { @@ -2332,9 +2332,9 @@ func (builder *EventLocationBuilder) Build() *EventLocation { type EventSearchFilter struct { StartTime *TimeInfo `json:"start_time,omitempty"` // 搜索过滤项，日程搜索区间的开始时间，被搜索日程的事件必须与搜索区间有交集 EndTime *TimeInfo `json:"end_time,omitempty"` // 搜索过滤项，日程搜索区间的结束时间，被搜索日程的事件必须与搜索区间有交集 - UserIds []string `json:"user_ids,omitempty"` // 搜索过滤项，参与人的用户ID列表，被搜索日程中必须包含至少一个其中的参与人。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - RoomIds []string `json:"room_ids,omitempty"` // 搜索过滤项，会议室ID列表，被搜索日程中必须包含至少一个其中的会议室 - ChatIds []string `json:"chat_ids,omitempty"` // 搜索过滤项，群ID列表，被搜索日程的参与人中必须包含至少一个其中的群。参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + UserIds []string `json:"user_ids,omitempty"` // 搜索过滤项，参与人的用户 ID 列表，被搜索日程中必须包含至少一个其中的参与人。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + RoomIds []string `json:"room_ids,omitempty"` // 搜索过滤项，会议室 ID 列表，被搜索日程中必须包含至少一个其中的会议室 + ChatIds []string `json:"chat_ids,omitempty"` // 搜索过滤项，群 ID 列表，被搜索日程的参与人中必须包含至少一个其中的群。参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) } type EventSearchFilterBuilder struct { @@ -2342,11 +2342,11 @@ type EventSearchFilterBuilder struct { startTimeFlag bool endTime *TimeInfo // 搜索过滤项，日程搜索区间的结束时间，被搜索日程的事件必须与搜索区间有交集 endTimeFlag bool - userIds []string // 搜索过滤项，参与人的用户ID列表，被搜索日程中必须包含至少一个其中的参与人。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userIds []string // 搜索过滤项，参与人的用户 ID 列表，被搜索日程中必须包含至少一个其中的参与人。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdsFlag bool - roomIds []string // 搜索过滤项，会议室ID列表，被搜索日程中必须包含至少一个其中的会议室 + roomIds []string // 搜索过滤项，会议室 ID 列表，被搜索日程中必须包含至少一个其中的会议室 roomIdsFlag bool - chatIds []string // 搜索过滤项，群ID列表，被搜索日程的参与人中必须包含至少一个其中的群。参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + chatIds []string // 搜索过滤项，群 ID 列表，被搜索日程的参与人中必须包含至少一个其中的群。参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) chatIdsFlag bool } @@ -2373,7 +2373,7 @@ func (builder *EventSearchFilterBuilder) EndTime(endTime *TimeInfo) *EventSearch return builder } -// 搜索过滤项，参与人的用户ID列表，被搜索日程中必须包含至少一个其中的参与人。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 搜索过滤项，参与人的用户 ID 列表，被搜索日程中必须包含至少一个其中的参与人。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：xxxxx func (builder *EventSearchFilterBuilder) UserIds(userIds []string) *EventSearchFilterBuilder { @@ -2382,7 +2382,7 @@ func (builder *EventSearchFilterBuilder) UserIds(userIds []string) *EventSearchF return builder } -// 搜索过滤项，会议室ID列表，被搜索日程中必须包含至少一个其中的会议室 +// 搜索过滤项，会议室 ID 列表，被搜索日程中必须包含至少一个其中的会议室 // // 示例值：xxxxx func (builder *EventSearchFilterBuilder) RoomIds(roomIds []string) *EventSearchFilterBuilder { @@ -2391,7 +2391,7 @@ func (builder *EventSearchFilterBuilder) RoomIds(roomIds []string) *EventSearchF return builder } -// 搜索过滤项，群ID列表，被搜索日程的参与人中必须包含至少一个其中的群。参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 搜索过滤项，群 ID 列表，被搜索日程的参与人中必须包含至少一个其中的群。参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：xxxxx func (builder *EventSearchFilterBuilder) ChatIds(chatIds []string) *EventSearchFilterBuilder { @@ -2453,23 +2453,23 @@ func (builder *EventTimeBuilder) Build() *EventTime { } type ExchangeBinding struct { - AdminAccount *string `json:"admin_account,omitempty"` // admin账户 - ExchangeAccount *string `json:"exchange_account,omitempty"` // 用户绑定的exchange账户 - UserId *string `json:"user_id,omitempty"` // exchange账户绑定user唯一标识id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - Status *string `json:"status,omitempty"` // exchange账户同步状态 - ExchangeBindingId *string `json:"exchange_binding_id,omitempty"` // exchange绑定唯一标识id。参见[exchange绑定ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) + AdminAccount *string `json:"admin_account,omitempty"` // admin 账户 + ExchangeAccount *string `json:"exchange_account,omitempty"` // 用户绑定的 exchange 账户 + UserId *string `json:"user_id,omitempty"` // exchange 账户绑定 user 唯一标识 id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + Status *string `json:"status,omitempty"` // exchange 账户同步状态 + ExchangeBindingId *string `json:"exchange_binding_id,omitempty"` // exchange 绑定唯一标识 id。参见 [exchange 绑定 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) } type ExchangeBindingBuilder struct { - adminAccount string // admin账户 + adminAccount string // admin 账户 adminAccountFlag bool - exchangeAccount string // 用户绑定的exchange账户 + exchangeAccount string // 用户绑定的 exchange 账户 exchangeAccountFlag bool - userId string // exchange账户绑定user唯一标识id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // exchange 账户绑定 user 唯一标识 id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool - status string // exchange账户同步状态 + status string // exchange 账户同步状态 statusFlag bool - exchangeBindingId string // exchange绑定唯一标识id。参见[exchange绑定ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) + exchangeBindingId string // exchange 绑定唯一标识 id。参见 [exchange 绑定 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) exchangeBindingIdFlag bool } @@ -2478,7 +2478,7 @@ func NewExchangeBindingBuilder() *ExchangeBindingBuilder { return builder } -// admin账户 +// admin 账户 // // 示例值：email_admin_example@outlook.com func (builder *ExchangeBindingBuilder) AdminAccount(adminAccount string) *ExchangeBindingBuilder { @@ -2487,7 +2487,7 @@ func (builder *ExchangeBindingBuilder) AdminAccount(adminAccount string) *Exchan return builder } -// 用户绑定的exchange账户 +// 用户绑定的 exchange 账户 // // 示例值：email_account_example@outlook.com func (builder *ExchangeBindingBuilder) ExchangeAccount(exchangeAccount string) *ExchangeBindingBuilder { @@ -2496,7 +2496,7 @@ func (builder *ExchangeBindingBuilder) ExchangeAccount(exchangeAccount string) * return builder } -// exchange账户绑定user唯一标识id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// exchange 账户绑定 user 唯一标识 id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_xxxxxxxxxxxxxxxxxx func (builder *ExchangeBindingBuilder) UserId(userId string) *ExchangeBindingBuilder { @@ -2505,7 +2505,7 @@ func (builder *ExchangeBindingBuilder) UserId(userId string) *ExchangeBindingBui return builder } -// exchange账户同步状态 +// exchange 账户同步状态 // // 示例值：doing func (builder *ExchangeBindingBuilder) Status(status string) *ExchangeBindingBuilder { @@ -2514,7 +2514,7 @@ func (builder *ExchangeBindingBuilder) Status(status string) *ExchangeBindingBui return builder } -// exchange绑定唯一标识id。参见[exchange绑定ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) +// exchange 绑定唯一标识 id。参见 [exchange 绑定 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) // // 示例值：ZW1haWxfYWRtaW5fZXhhbXBsZUBvdXRsb29rLmNvbSBlbWFpbF9hY2NvdW50X2V4YW1wbGVAb3V0bG9vay5jb20= func (builder *ExchangeBindingBuilder) ExchangeBindingId(exchangeBindingId string) *ExchangeBindingBuilder { @@ -2597,11 +2597,11 @@ func (builder *FreebusyBuilder) Build() *Freebusy { } type Reminder struct { - Minutes *int `json:"minutes,omitempty"` // 日程提醒时间的偏移量，正数时表示在日程开始前X分钟提醒，负数时表示在日程开始后X分钟提醒;新建或更新日程时传入该字段，仅对当前身份生效 + Minutes *int `json:"minutes,omitempty"` // 日程提醒时间的偏移量，正数时表示在日程开始前 X 分钟提醒，负数时表示在日程开始后 X 分钟提醒;新建或更新日程时传入该字段，仅对当前身份生效 } type ReminderBuilder struct { - minutes int // 日程提醒时间的偏移量，正数时表示在日程开始前X分钟提醒，负数时表示在日程开始后X分钟提醒;新建或更新日程时传入该字段，仅对当前身份生效 + minutes int // 日程提醒时间的偏移量，正数时表示在日程开始前 X 分钟提醒，负数时表示在日程开始后 X 分钟提醒;新建或更新日程时传入该字段，仅对当前身份生效 minutesFlag bool } @@ -2610,7 +2610,7 @@ func NewReminderBuilder() *ReminderBuilder { return builder } -// 日程提醒时间的偏移量，正数时表示在日程开始前X分钟提醒，负数时表示在日程开始后X分钟提醒;新建或更新日程时传入该字段，仅对当前身份生效 +// 日程提醒时间的偏移量，正数时表示在日程开始前 X 分钟提醒，负数时表示在日程开始后 X 分钟提醒;新建或更新日程时传入该字段，仅对当前身份生效 // // 示例值：5 func (builder *ReminderBuilder) Minutes(minutes int) *ReminderBuilder { @@ -2629,17 +2629,17 @@ func (builder *ReminderBuilder) Build() *Reminder { } type Schema struct { - UiName *string `json:"ui_name,omitempty"` // UI名称。取值范围如下： ;- ForwardIcon: 日程转发按钮 ;- MeetingChatIcon: 会议群聊按钮 ;- MeetingMinutesIcon: 会议纪要按钮 ;- MeetingVideo: 视频会议区域 ;- RSVP: 接受/拒绝/待定区域 ;- Attendee: 参与者区域 ;- OrganizerOrCreator: 组织者/创建者区域 - UiStatus *string `json:"ui_status,omitempty"` // UI项自定义状态。**目前只支持hide** - AppLink *string `json:"app_link,omitempty"` // 按钮点击后跳转的链接; **该字段暂不支持传入。** + UiName *string `json:"ui_name,omitempty"` // UI 名称。取值范围如下： ;- ForwardIcon: 日程转发按钮 ;- MeetingChatIcon: 会议群聊按钮 ;- MeetingMinutesIcon: 会议纪要按钮 ;- MeetingVideo: 视频会议区域 ;- RSVP: 接受/拒绝/待定区域 ;- Attendee: 参与者区域 ;- OrganizerOrCreator: 组织者/创建者区域 + UiStatus *string `json:"ui_status,omitempty"` // UI 项自定义状态。** 目前只支持 hide** + AppLink *string `json:"app_link,omitempty"` // 按钮点击后跳转的链接; ** 该字段暂不支持传入。** } type SchemaBuilder struct { - uiName string // UI名称。取值范围如下： ;- ForwardIcon: 日程转发按钮 ;- MeetingChatIcon: 会议群聊按钮 ;- MeetingMinutesIcon: 会议纪要按钮 ;- MeetingVideo: 视频会议区域 ;- RSVP: 接受/拒绝/待定区域 ;- Attendee: 参与者区域 ;- OrganizerOrCreator: 组织者/创建者区域 + uiName string // UI 名称。取值范围如下： ;- ForwardIcon: 日程转发按钮 ;- MeetingChatIcon: 会议群聊按钮 ;- MeetingMinutesIcon: 会议纪要按钮 ;- MeetingVideo: 视频会议区域 ;- RSVP: 接受/拒绝/待定区域 ;- Attendee: 参与者区域 ;- OrganizerOrCreator: 组织者/创建者区域 uiNameFlag bool - uiStatus string // UI项自定义状态。**目前只支持hide** + uiStatus string // UI 项自定义状态。** 目前只支持 hide** uiStatusFlag bool - appLink string // 按钮点击后跳转的链接; **该字段暂不支持传入。** + appLink string // 按钮点击后跳转的链接; ** 该字段暂不支持传入。** appLinkFlag bool } @@ -2648,7 +2648,7 @@ func NewSchemaBuilder() *SchemaBuilder { return builder } -// UI名称。取值范围如下： ;- ForwardIcon: 日程转发按钮 ;- MeetingChatIcon: 会议群聊按钮 ;- MeetingMinutesIcon: 会议纪要按钮 ;- MeetingVideo: 视频会议区域 ;- RSVP: 接受/拒绝/待定区域 ;- Attendee: 参与者区域 ;- OrganizerOrCreator: 组织者/创建者区域 +// UI 名称。取值范围如下： ;- ForwardIcon: 日程转发按钮 ;- MeetingChatIcon: 会议群聊按钮 ;- MeetingMinutesIcon: 会议纪要按钮 ;- MeetingVideo: 视频会议区域 ;- RSVP: 接受/拒绝/待定区域 ;- Attendee: 参与者区域 ;- OrganizerOrCreator: 组织者/创建者区域 // // 示例值：ForwardIcon func (builder *SchemaBuilder) UiName(uiName string) *SchemaBuilder { @@ -2657,7 +2657,7 @@ func (builder *SchemaBuilder) UiName(uiName string) *SchemaBuilder { return builder } -// UI项自定义状态。**目前只支持hide** +// UI 项自定义状态。** 目前只支持 hide** // // 示例值：hide func (builder *SchemaBuilder) UiStatus(uiStatus string) *SchemaBuilder { @@ -2666,7 +2666,7 @@ func (builder *SchemaBuilder) UiStatus(uiStatus string) *SchemaBuilder { return builder } -// 按钮点击后跳转的链接; **该字段暂不支持传入。** +// 按钮点击后跳转的链接; ** 该字段暂不支持传入。** // // 示例值：https://applink.feishu.cn/client/calendar/event/detail?calendarId=xxxxxx&key=xxxxxx&originalTime=xxxxxx&startTime=xxxxxx func (builder *SchemaBuilder) AppLink(appLink string) *SchemaBuilder { @@ -2696,17 +2696,17 @@ type Setting struct { } type TimeInfo struct { - Date *string `json:"date,omitempty"` // 仅全天日程使用该字段，如2018-09-01。需满足 RFC3339 格式。不能与 timestamp 同时指定 - Timestamp *string `json:"timestamp,omitempty"` // 秒级时间戳，如1602504000(表示2020/10/12 20:0:00 +8时区) - Timezone *string `json:"timezone,omitempty"` // 时区名称，使用IANA Time Zone Database标准，如Asia/Shanghai；全天日程时区固定为UTC，非全天日程时区默认为Asia/Shanghai + Date *string `json:"date,omitempty"` // 仅全天日程使用该字段，如 2018-09-01。需满足 RFC3339 格式。不能与 timestamp 同时指定 + Timestamp *string `json:"timestamp,omitempty"` // 秒级时间戳，如 1602504000(表示 2020/10/12 20:0:00 +8 时区) + Timezone *string `json:"timezone,omitempty"` // 时区名称，使用 IANA Time Zone Database 标准，如 Asia/Shanghai；全天日程时区固定为 UTC，非全天日程时区默认为 Asia/Shanghai } type TimeInfoBuilder struct { - date string // 仅全天日程使用该字段，如2018-09-01。需满足 RFC3339 格式。不能与 timestamp 同时指定 + date string // 仅全天日程使用该字段，如 2018-09-01。需满足 RFC3339 格式。不能与 timestamp 同时指定 dateFlag bool - timestamp string // 秒级时间戳，如1602504000(表示2020/10/12 20:0:00 +8时区) + timestamp string // 秒级时间戳，如 1602504000(表示 2020/10/12 20:0:00 +8 时区) timestampFlag bool - timezone string // 时区名称，使用IANA Time Zone Database标准，如Asia/Shanghai；全天日程时区固定为UTC，非全天日程时区默认为Asia/Shanghai + timezone string // 时区名称，使用 IANA Time Zone Database 标准，如 Asia/Shanghai；全天日程时区固定为 UTC，非全天日程时区默认为 Asia/Shanghai timezoneFlag bool } @@ -2715,7 +2715,7 @@ func NewTimeInfoBuilder() *TimeInfoBuilder { return builder } -// 仅全天日程使用该字段，如2018-09-01。需满足 RFC3339 格式。不能与 timestamp 同时指定 +// 仅全天日程使用该字段，如 2018-09-01。需满足 RFC3339 格式。不能与 timestamp 同时指定 // // 示例值：2018-09-01 func (builder *TimeInfoBuilder) Date(date string) *TimeInfoBuilder { @@ -2724,7 +2724,7 @@ func (builder *TimeInfoBuilder) Date(date string) *TimeInfoBuilder { return builder } -// 秒级时间戳，如1602504000(表示2020/10/12 20:0:00 +8时区) +// 秒级时间戳，如 1602504000(表示 2020/10/12 20:0:00 +8 时区) // // 示例值：1602504000 func (builder *TimeInfoBuilder) Timestamp(timestamp string) *TimeInfoBuilder { @@ -2733,7 +2733,7 @@ func (builder *TimeInfoBuilder) Timestamp(timestamp string) *TimeInfoBuilder { return builder } -// 时区名称，使用IANA Time Zone Database标准，如Asia/Shanghai；全天日程时区固定为UTC，非全天日程时区默认为Asia/Shanghai +// 时区名称，使用 IANA Time Zone Database 标准，如 Asia/Shanghai；全天日程时区固定为 UTC，非全天日程时区默认为 Asia/Shanghai // // 示例值：Asia/Shanghai func (builder *TimeInfoBuilder) Timezone(timezone string) *TimeInfoBuilder { @@ -2760,25 +2760,25 @@ func (builder *TimeInfoBuilder) Build() *TimeInfo { } type TimeoffEvent struct { - TimeoffEventId *string `json:"timeoff_event_id,omitempty"` // 请假日程ID。参见[请假日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) - UserId *string `json:"user_id,omitempty"` // 用户id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + TimeoffEventId *string `json:"timeoff_event_id,omitempty"` // 请假日程 ID。参见 [请假日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) + UserId *string `json:"user_id,omitempty"` // 用户 id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) Timezone *string `json:"timezone,omitempty"` // 时区 - StartTime *string `json:"start_time,omitempty"` // 休假开始时间：;有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time与end_time格式需保持一致，否则无效。 - EndTime *string `json:"end_time,omitempty"` // 休假结束时间：;有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time与end_time格式需保持一致，否则无效。 + StartTime *string `json:"start_time,omitempty"` // 休假开始时间：;有时间戳 (1609430400) 和日期 (2021-01-01) 两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time 与 end_time 格式需保持一致，否则无效。 + EndTime *string `json:"end_time,omitempty"` // 休假结束时间：;有时间戳 (1609430400) 和日期 (2021-01-01) 两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time 与 end_time 格式需保持一致，否则无效。 Title *string `json:"title,omitempty"` // 自定义请假日程标题，没有设置则为默认日程标题 Description *string `json:"description,omitempty"` // 自定义请假日程描述，没有设置则为默认日程描述 } type TimeoffEventBuilder struct { - timeoffEventId string // 请假日程ID。参见[请假日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) + timeoffEventId string // 请假日程 ID。参见 [请假日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) timeoffEventIdFlag bool - userId string // 用户id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 用户 id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool timezone string // 时区 timezoneFlag bool - startTime string // 休假开始时间：;有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time与end_time格式需保持一致，否则无效。 + startTime string // 休假开始时间：;有时间戳 (1609430400) 和日期 (2021-01-01) 两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time 与 end_time 格式需保持一致，否则无效。 startTimeFlag bool - endTime string // 休假结束时间：;有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time与end_time格式需保持一致，否则无效。 + endTime string // 休假结束时间：;有时间戳 (1609430400) 和日期 (2021-01-01) 两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time 与 end_time 格式需保持一致，否则无效。 endTimeFlag bool title string // 自定义请假日程标题，没有设置则为默认日程标题 titleFlag bool @@ -2791,7 +2791,7 @@ func NewTimeoffEventBuilder() *TimeoffEventBuilder { return builder } -// 请假日程ID。参见[请假日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) +// 请假日程 ID。参见 [请假日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) // // 示例值：timeoff:XXXXXX-XXXX-0917-1623-aa493d591a39-XXXXXX func (builder *TimeoffEventBuilder) TimeoffEventId(timeoffEventId string) *TimeoffEventBuilder { @@ -2800,7 +2800,7 @@ func (builder *TimeoffEventBuilder) TimeoffEventId(timeoffEventId string) *Timeo return builder } -// 用户id，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户 id，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_XXXXXXXXXX func (builder *TimeoffEventBuilder) UserId(userId string) *TimeoffEventBuilder { @@ -2818,7 +2818,7 @@ func (builder *TimeoffEventBuilder) Timezone(timezone string) *TimeoffEventBuild return builder } -// 休假开始时间：;有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time与end_time格式需保持一致，否则无效。 +// 休假开始时间：;有时间戳 (1609430400) 和日期 (2021-01-01) 两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time 与 end_time 格式需保持一致，否则无效。 // // 示例值：2021-01-01 func (builder *TimeoffEventBuilder) StartTime(startTime string) *TimeoffEventBuilder { @@ -2827,7 +2827,7 @@ func (builder *TimeoffEventBuilder) StartTime(startTime string) *TimeoffEventBui return builder } -// 休假结束时间：;有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time与end_time格式需保持一致，否则无效。 +// 休假结束时间：;有时间戳 (1609430400) 和日期 (2021-01-01) 两种格式，其它格式无效；;时间戳格式是按小时休假日程，日期格式是全天休假日程；;start_time 与 end_time 格式需保持一致，否则无效。 // // 示例值：2021-01-01 func (builder *TimeoffEventBuilder) EndTime(endTime string) *TimeoffEventBuilder { @@ -2838,7 +2838,7 @@ func (builder *TimeoffEventBuilder) EndTime(endTime string) *TimeoffEventBuilder // 自定义请假日程标题，没有设置则为默认日程标题 // -// 示例值：请假中(全天) / 1-Day Time Off +// 示例值：请假中 (全天) / 1-Day Time Off func (builder *TimeoffEventBuilder) Title(title string) *TimeoffEventBuilder { builder.title = title builder.titleFlag = true @@ -2847,7 +2847,7 @@ func (builder *TimeoffEventBuilder) Title(title string) *TimeoffEventBuilder { // 自定义请假日程描述，没有设置则为默认日程描述 // -// 示例值：若删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。 +// 示例值：若删除此日程，飞书中相应的 “请假” 标签将自动消失，而请假系统中的休假申请不会被撤销。 func (builder *TimeoffEventBuilder) Description(description string) *TimeoffEventBuilder { builder.description = description builder.descriptionFlag = true @@ -2889,13 +2889,13 @@ func (builder *TimeoffEventBuilder) Build() *TimeoffEvent { type UserCalendar struct { Calendar *Calendar `json:"calendar,omitempty"` // 日历实体信息 - UserId *string `json:"user_id,omitempty"` // 日历的创建者user ID，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + UserId *string `json:"user_id,omitempty"` // 日历的创建者 user ID，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) } type UserCalendarBuilder struct { calendar *Calendar // 日历实体信息 calendarFlag bool - userId string // 日历的创建者user ID，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 日历的创建者 user ID，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool } @@ -2913,7 +2913,7 @@ func (builder *UserCalendarBuilder) Calendar(calendar *Calendar) *UserCalendarBu return builder } -// 日历的创建者user ID，参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 日历的创建者 user ID，参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_xxxxxx func (builder *UserCalendarBuilder) UserId(userId string) *UserCalendarBuilder { @@ -3000,22 +3000,22 @@ func (builder *UserIdBuilder) Build() *UserId { type Vchat struct { VcType *string `json:"vc_type,omitempty"` // 视频会议类型 - IconType *string `json:"icon_type,omitempty"` // 第三方视频会议icon类型；可以为空，为空展示默认icon。 + IconType *string `json:"icon_type,omitempty"` // 第三方视频会议 icon 类型；可以为空，为空展示默认 icon。 Description *string `json:"description,omitempty"` // 第三方视频会议文案，可以为空，为空展示默认文案 - MeetingUrl *string `json:"meeting_url,omitempty"` // 视频会议URL - LiveLink *string `json:"live_link,omitempty"` // VC视频会议转直播URL，当vc_type=vc时有值。 + MeetingUrl *string `json:"meeting_url,omitempty"` // 视频会议 URL + LiveLink *string `json:"live_link,omitempty"` // VC 视频会议转直播 URL，当 vc_type=vc 时有值。 } type VchatBuilder struct { vcType string // 视频会议类型 vcTypeFlag bool - iconType string // 第三方视频会议icon类型；可以为空，为空展示默认icon。 + iconType string // 第三方视频会议 icon 类型；可以为空，为空展示默认 icon。 iconTypeFlag bool description string // 第三方视频会议文案，可以为空，为空展示默认文案 descriptionFlag bool - meetingUrl string // 视频会议URL + meetingUrl string // 视频会议 URL meetingUrlFlag bool - liveLink string // VC视频会议转直播URL，当vc_type=vc时有值。 + liveLink string // VC 视频会议转直播 URL，当 vc_type=vc 时有值。 liveLinkFlag bool } @@ -3033,7 +3033,7 @@ func (builder *VchatBuilder) VcType(vcType string) *VchatBuilder { return builder } -// 第三方视频会议icon类型；可以为空，为空展示默认icon。 +// 第三方视频会议 icon 类型；可以为空，为空展示默认 icon。 // // 示例值：vc func (builder *VchatBuilder) IconType(iconType string) *VchatBuilder { @@ -3051,7 +3051,7 @@ func (builder *VchatBuilder) Description(description string) *VchatBuilder { return builder } -// 视频会议URL +// 视频会议 URL // // 示例值：https://example.com func (builder *VchatBuilder) MeetingUrl(meetingUrl string) *VchatBuilder { @@ -3060,7 +3060,7 @@ func (builder *VchatBuilder) MeetingUrl(meetingUrl string) *VchatBuilder { return builder } -// VC视频会议转直播URL，当vc_type=vc时有值。 +// VC 视频会议转直播 URL，当 vc_type=vc 时有值。 // // 示例值：https://meetings.feishu.cn/s/1iof4hpw6i51w func (builder *VchatBuilder) LiveLink(liveLink string) *VchatBuilder { @@ -3153,7 +3153,7 @@ func NewDeleteCalendarReqBuilder() *DeleteCalendarReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *DeleteCalendarReqBuilder) CalendarId(calendarId string) *DeleteCalendarReqBuilder { @@ -3194,7 +3194,7 @@ func NewGetCalendarReqBuilder() *GetCalendarReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *GetCalendarReqBuilder) CalendarId(calendarId string) *GetCalendarReqBuilder { @@ -3214,11 +3214,11 @@ type GetCalendarReq struct { } type GetCalendarRespData struct { - CalendarId *string `json:"calendar_id,omitempty"` // 日历OpenId + CalendarId *string `json:"calendar_id,omitempty"` // 日历 OpenId Summary *string `json:"summary,omitempty"` // 日历标题 Description *string `json:"description,omitempty"` // 日历描述 Permissions *string `json:"permissions,omitempty"` // - Color *int `json:"color,omitempty"` // 日历颜色，颜色RGB值的int32表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 + Color *int `json:"color,omitempty"` // 日历颜色，颜色 RGB 值的 int32 表示。客户端展示时会映射到色板上最接近的一种颜色。仅对当前身份生效 Type *string `json:"type,omitempty"` // 日历类型 SummaryAlias *string `json:"summary_alias,omitempty"` // 日历备注名，修改或添加后仅对当前身份生效 IsDeleted *bool `json:"is_deleted,omitempty"` // 对于当前身份，日历是否已经被标记为删除 @@ -3249,7 +3249,7 @@ func NewListCalendarReqBuilder() *ListCalendarReqBuilder { return builder } -// 一次请求要求返回最大数量，默认500，取值范围为[50. 1000] +// 一次请求要求返回最大数量，默认 500，取值范围为 [50. 1000] // // 示例值：50 func (builder *ListCalendarReqBuilder) PageSize(pageSize int) *ListCalendarReqBuilder { @@ -3257,7 +3257,7 @@ func (builder *ListCalendarReqBuilder) PageSize(pageSize int) *ListCalendarReqBu return builder } -// 上次请求Response返回的分页标记，首次请求时为空 +// 上次请求 Response 返回的分页标记，首次请求时为空 // // 示例值：ListCalendarsPageToken_xxx func (builder *ListCalendarReqBuilder) PageToken(pageToken string) *ListCalendarReqBuilder { @@ -3265,7 +3265,7 @@ func (builder *ListCalendarReqBuilder) PageToken(pageToken string) *ListCalendar return builder } -// 上次请求Response返回的增量同步标记，分页请求未结束时为空 +// 上次请求 Response 返回的增量同步标记，分页请求未结束时为空 // // 示例值：ListCalendarsSyncToken_xxx func (builder *ListCalendarReqBuilder) SyncToken(syncToken string) *ListCalendarReqBuilder { @@ -3315,7 +3315,7 @@ func NewPatchCalendarReqBuilder() *PatchCalendarReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *PatchCalendarReqBuilder) CalendarId(calendarId string) *PatchCalendarReqBuilder { @@ -3369,7 +3369,7 @@ func NewPrimaryCalendarReqBuilder() *PrimaryCalendarReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PrimaryCalendarReqBuilder) UserIdType(userIdType string) *PrimaryCalendarReqBuilder { @@ -3547,7 +3547,7 @@ func NewSubscribeCalendarReqBuilder() *SubscribeCalendarReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *SubscribeCalendarReqBuilder) CalendarId(calendarId string) *SubscribeCalendarReqBuilder { @@ -3602,7 +3602,7 @@ func NewUnsubscribeCalendarReqBuilder() *UnsubscribeCalendarReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *UnsubscribeCalendarReqBuilder) CalendarId(calendarId string) *UnsubscribeCalendarReqBuilder { @@ -3653,7 +3653,7 @@ func NewCreateCalendarAclReqBuilder() *CreateCalendarAclReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *CreateCalendarAclReqBuilder) CalendarId(calendarId string) *CreateCalendarAclReqBuilder { @@ -3661,7 +3661,7 @@ func (builder *CreateCalendarAclReqBuilder) CalendarId(calendarId string) *Creat return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateCalendarAclReqBuilder) UserIdType(userIdType string) *CreateCalendarAclReqBuilder { @@ -3690,7 +3690,7 @@ type CreateCalendarAclReq struct { } type CreateCalendarAclRespData struct { - AclId *string `json:"acl_id,omitempty"` // acl资源ID + AclId *string `json:"acl_id,omitempty"` // acl 资源 ID Role *string `json:"role,omitempty"` // 对日历的访问权限 Scope *AclScope `json:"scope,omitempty"` // 权限范围 } @@ -3718,7 +3718,7 @@ func NewDeleteCalendarAclReqBuilder() *DeleteCalendarAclReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *DeleteCalendarAclReqBuilder) CalendarId(calendarId string) *DeleteCalendarAclReqBuilder { @@ -3726,7 +3726,7 @@ func (builder *DeleteCalendarAclReqBuilder) CalendarId(calendarId string) *Delet return builder } -// acl资源ID。参见[ACL ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) +// acl 资源 ID。参见 [ACL ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/introduction) // // 示例值：user_xxxxxx func (builder *DeleteCalendarAclReqBuilder) AclId(aclId string) *DeleteCalendarAclReqBuilder { @@ -3774,7 +3774,7 @@ func (builder *ListCalendarAclReqBuilder) Limit(limit int) *ListCalendarAclReqBu return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *ListCalendarAclReqBuilder) CalendarId(calendarId string) *ListCalendarAclReqBuilder { @@ -3782,7 +3782,7 @@ func (builder *ListCalendarAclReqBuilder) CalendarId(calendarId string) *ListCal return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListCalendarAclReqBuilder) UserIdType(userIdType string) *ListCalendarAclReqBuilder { @@ -3800,7 +3800,7 @@ func (builder *ListCalendarAclReqBuilder) PageToken(pageToken string) *ListCalen // // -// 示例值：10，小于10取10 +// 示例值：10，小于 10 取 10 func (builder *ListCalendarAclReqBuilder) PageSize(pageSize int) *ListCalendarAclReqBuilder { builder.apiReq.QueryParams.Set("page_size", fmt.Sprint(pageSize)) return builder @@ -3822,7 +3822,7 @@ type ListCalendarAclReq struct { } type ListCalendarAclRespData struct { - Acls []*CalendarAcl `json:"acls,omitempty"` // 入参日历对应的acl列表 + Acls []*CalendarAcl `json:"acls,omitempty"` // 入参日历对应的 acl 列表 HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 PageToken *string `json:"page_token,omitempty"` // 下次请求需要带上的分页标记，90 天有效期 } @@ -3850,7 +3850,7 @@ func NewSubscriptionCalendarAclReqBuilder() *SubscriptionCalendarAclReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *SubscriptionCalendarAclReqBuilder) CalendarId(calendarId string) *SubscriptionCalendarAclReqBuilder { @@ -3891,7 +3891,7 @@ func NewUnsubscriptionCalendarAclReqBuilder() *UnsubscriptionCalendarAclReqBuild return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *UnsubscriptionCalendarAclReqBuilder) CalendarId(calendarId string) *UnsubscriptionCalendarAclReqBuilder { @@ -3933,7 +3933,7 @@ func NewCreateCalendarEventReqBuilder() *CreateCalendarEventReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *CreateCalendarEventReqBuilder) CalendarId(calendarId string) *CreateCalendarEventReqBuilder { @@ -3987,7 +3987,7 @@ func NewDeleteCalendarEventReqBuilder() *DeleteCalendarEventReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *DeleteCalendarEventReqBuilder) CalendarId(calendarId string) *DeleteCalendarEventReqBuilder { @@ -3995,7 +3995,7 @@ func (builder *DeleteCalendarEventReqBuilder) CalendarId(calendarId string) *Del return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：xxxxxxxxx_0 func (builder *DeleteCalendarEventReqBuilder) EventId(eventId string) *DeleteCalendarEventReqBuilder { @@ -4003,7 +4003,7 @@ func (builder *DeleteCalendarEventReqBuilder) EventId(eventId string) *DeleteCal return builder } -// 删除日程是否给日程参与人发送bot通知，默认为true +// 删除日程是否给日程参与人发送 bot 通知，默认为 true // // 示例值：false func (builder *DeleteCalendarEventReqBuilder) NeedNotification(needNotification bool) *DeleteCalendarEventReqBuilder { @@ -4045,7 +4045,7 @@ func NewGetCalendarEventReqBuilder() *GetCalendarEventReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *GetCalendarEventReqBuilder) CalendarId(calendarId string) *GetCalendarEventReqBuilder { @@ -4053,7 +4053,7 @@ func (builder *GetCalendarEventReqBuilder) CalendarId(calendarId string) *GetCal return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：xxxxxxxxx_0 func (builder *GetCalendarEventReqBuilder) EventId(eventId string) *GetCalendarEventReqBuilder { @@ -4099,7 +4099,7 @@ func NewListCalendarEventReqBuilder() *ListCalendarEventReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *ListCalendarEventReqBuilder) CalendarId(calendarId string) *ListCalendarEventReqBuilder { @@ -4107,7 +4107,7 @@ func (builder *ListCalendarEventReqBuilder) CalendarId(calendarId string) *ListC return builder } -// 一次请求要求返回最大数量，默认500，取值范围为[50, 1000] +// 一次请求要求返回最大数量，默认 500，取值范围为 [50, 1000] // // 示例值：50 func (builder *ListCalendarEventReqBuilder) PageSize(pageSize int) *ListCalendarEventReqBuilder { @@ -4115,7 +4115,7 @@ func (builder *ListCalendarEventReqBuilder) PageSize(pageSize int) *ListCalendar return builder } -// 拉取anchor_time之后的日程，为timestamp +// 拉取 anchor_time 之后的日程，为 timestamp // // 示例值：1609430400 func (builder *ListCalendarEventReqBuilder) AnchorTime(anchorTime string) *ListCalendarEventReqBuilder { @@ -4123,7 +4123,7 @@ func (builder *ListCalendarEventReqBuilder) AnchorTime(anchorTime string) *ListC return builder } -// 上次请求Response返回的分页标记，首次请求时为空 +// 上次请求 Response 返回的分页标记，首次请求时为空 // // 示例值：ListCalendarsPageToken_1632452910_1632539310 func (builder *ListCalendarEventReqBuilder) PageToken(pageToken string) *ListCalendarEventReqBuilder { @@ -4131,7 +4131,7 @@ func (builder *ListCalendarEventReqBuilder) PageToken(pageToken string) *ListCal return builder } -// 上次请求Response返回的增量同步标记，分页请求未结束时为空 +// 上次请求 Response 返回的增量同步标记，分页请求未结束时为空 // // 示例值：ListCalendarsSyncToken_1632452910 func (builder *ListCalendarEventReqBuilder) SyncToken(syncToken string) *ListCalendarEventReqBuilder { @@ -4139,7 +4139,7 @@ func (builder *ListCalendarEventReqBuilder) SyncToken(syncToken string) *ListCal return builder } -// 日程开始Unix时间戳，单位为秒 +// 日程开始 Unix 时间戳，单位为秒 // // 示例值：1631777271 func (builder *ListCalendarEventReqBuilder) StartTime(startTime string) *ListCalendarEventReqBuilder { @@ -4147,7 +4147,7 @@ func (builder *ListCalendarEventReqBuilder) StartTime(startTime string) *ListCal return builder } -// 日程结束Unix时间戳，单位为秒 +// 日程结束 Unix 时间戳，单位为秒 // // 示例值：1631777271 func (builder *ListCalendarEventReqBuilder) EndTime(endTime string) *ListCalendarEventReqBuilder { @@ -4198,7 +4198,7 @@ func NewPatchCalendarEventReqBuilder() *PatchCalendarEventReqBuilder { return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *PatchCalendarEventReqBuilder) CalendarId(calendarId string) *PatchCalendarEventReqBuilder { @@ -4206,7 +4206,7 @@ func (builder *PatchCalendarEventReqBuilder) CalendarId(calendarId string) *Patc return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：00592a0e-7edf-4678-bc9d-1b77383ef08e_0 func (builder *PatchCalendarEventReqBuilder) EventId(eventId string) *PatchCalendarEventReqBuilder { @@ -4350,7 +4350,7 @@ func (builder *SearchCalendarEventReqBuilder) Limit(limit int) *SearchCalendarEv return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *SearchCalendarEventReqBuilder) CalendarId(calendarId string) *SearchCalendarEventReqBuilder { @@ -4358,7 +4358,7 @@ func (builder *SearchCalendarEventReqBuilder) CalendarId(calendarId string) *Sea return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SearchCalendarEventReqBuilder) UserIdType(userIdType string) *SearchCalendarEventReqBuilder { @@ -4438,7 +4438,7 @@ func NewSubscriptionCalendarEventReqBuilder() *SubscriptionCalendarEventReqBuild return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *SubscriptionCalendarEventReqBuilder) CalendarId(calendarId string) *SubscriptionCalendarEventReqBuilder { @@ -4479,7 +4479,7 @@ func NewUnsubscriptionCalendarEventReqBuilder() *UnsubscriptionCalendarEventReqB return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *UnsubscriptionCalendarEventReqBuilder) CalendarId(calendarId string) *UnsubscriptionCalendarEventReqBuilder { @@ -4508,15 +4508,15 @@ func (resp *UnsubscriptionCalendarEventResp) Success() bool { } type BatchDeleteCalendarEventAttendeeReqBodyBuilder struct { - attendeeIds []string // 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) + attendeeIds []string // 要移除的参与人 ID 列表。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) attendeeIdsFlag bool - deleteIds []*CalendarEventAttendeeId // 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 + deleteIds []*CalendarEventAttendeeId // 需要删除的参与人类型实体 ID，作为 attendee_ids 字段的补充。 deleteIdsFlag bool - needNotification bool // 删除日程参与人时是否要给参与人发送bot通知，默认为true + needNotification bool // 删除日程参与人时是否要给参与人发送 bot 通知，默认为 true needNotificationFlag bool instanceStartTimeAdmin string // 使用管理员身份访问时要修改的实例 instanceStartTimeAdminFlag bool - isEnableAdmin bool // 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) + isEnableAdmin bool // 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) isEnableAdminFlag bool } @@ -4525,7 +4525,7 @@ func NewBatchDeleteCalendarEventAttendeeReqBodyBuilder() *BatchDeleteCalendarEve return builder } -// 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) +// 要移除的参与人 ID 列表。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) // //示例值：["user_xxxxx", "chat_xxxxx", "resource_xxxxx", "third_party_xxxxx"] func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) AttendeeIds(attendeeIds []string) *BatchDeleteCalendarEventAttendeeReqBodyBuilder { @@ -4534,7 +4534,7 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) AttendeeIds(atten return builder } -// 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 +// 需要删除的参与人类型实体 ID，作为 attendee_ids 字段的补充。 // //示例值： func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) DeleteIds(deleteIds []*CalendarEventAttendeeId) *BatchDeleteCalendarEventAttendeeReqBodyBuilder { @@ -4543,7 +4543,7 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) DeleteIds(deleteI return builder } -// 删除日程参与人时是否要给参与人发送bot通知，默认为true +// 删除日程参与人时是否要给参与人发送 bot 通知，默认为 true // //示例值：false func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) NeedNotification(needNotification bool) *BatchDeleteCalendarEventAttendeeReqBodyBuilder { @@ -4561,7 +4561,7 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) InstanceStartTime return builder } -// 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) +// 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) // //示例值：false func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) IsEnableAdmin(isEnableAdmin bool) *BatchDeleteCalendarEventAttendeeReqBodyBuilder { @@ -4591,15 +4591,15 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBodyBuilder) Build() *BatchDel } type BatchDeleteCalendarEventAttendeePathReqBodyBuilder struct { - attendeeIds []string // 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) + attendeeIds []string // 要移除的参与人 ID 列表。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) attendeeIdsFlag bool - deleteIds []*CalendarEventAttendeeId // 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 + deleteIds []*CalendarEventAttendeeId // 需要删除的参与人类型实体 ID，作为 attendee_ids 字段的补充。 deleteIdsFlag bool - needNotification bool // 删除日程参与人时是否要给参与人发送bot通知，默认为true + needNotification bool // 删除日程参与人时是否要给参与人发送 bot 通知，默认为 true needNotificationFlag bool instanceStartTimeAdmin string // 使用管理员身份访问时要修改的实例 instanceStartTimeAdminFlag bool - isEnableAdmin bool // 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) + isEnableAdmin bool // 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) isEnableAdminFlag bool } @@ -4608,7 +4608,7 @@ func NewBatchDeleteCalendarEventAttendeePathReqBodyBuilder() *BatchDeleteCalenda return builder } -// 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) +// 要移除的参与人 ID 列表。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) // // 示例值：["user_xxxxx", "chat_xxxxx", "resource_xxxxx", "third_party_xxxxx"] func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) AttendeeIds(attendeeIds []string) *BatchDeleteCalendarEventAttendeePathReqBodyBuilder { @@ -4617,7 +4617,7 @@ func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) AttendeeIds(a return builder } -// 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 +// 需要删除的参与人类型实体 ID，作为 attendee_ids 字段的补充。 // // 示例值： func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) DeleteIds(deleteIds []*CalendarEventAttendeeId) *BatchDeleteCalendarEventAttendeePathReqBodyBuilder { @@ -4626,7 +4626,7 @@ func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) DeleteIds(del return builder } -// 删除日程参与人时是否要给参与人发送bot通知，默认为true +// 删除日程参与人时是否要给参与人发送 bot 通知，默认为 true // // 示例值：false func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) NeedNotification(needNotification bool) *BatchDeleteCalendarEventAttendeePathReqBodyBuilder { @@ -4644,7 +4644,7 @@ func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) InstanceStart return builder } -// 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) +// 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) // // 示例值：false func (builder *BatchDeleteCalendarEventAttendeePathReqBodyBuilder) IsEnableAdmin(isEnableAdmin bool) *BatchDeleteCalendarEventAttendeePathReqBodyBuilder { @@ -4687,7 +4687,7 @@ func NewBatchDeleteCalendarEventAttendeeReqBuilder() *BatchDeleteCalendarEventAt return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *BatchDeleteCalendarEventAttendeeReqBuilder) CalendarId(calendarId string) *BatchDeleteCalendarEventAttendeeReqBuilder { @@ -4695,7 +4695,7 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBuilder) CalendarId(calendarId return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：xxxxxxxxx_0 func (builder *BatchDeleteCalendarEventAttendeeReqBuilder) EventId(eventId string) *BatchDeleteCalendarEventAttendeeReqBuilder { @@ -4703,7 +4703,7 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBuilder) EventId(eventId strin return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchDeleteCalendarEventAttendeeReqBuilder) UserIdType(userIdType string) *BatchDeleteCalendarEventAttendeeReqBuilder { @@ -4727,11 +4727,11 @@ func (builder *BatchDeleteCalendarEventAttendeeReqBuilder) Build() *BatchDeleteC } type BatchDeleteCalendarEventAttendeeReqBody struct { - AttendeeIds []string `json:"attendee_ids,omitempty"` // 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) - DeleteIds []*CalendarEventAttendeeId `json:"delete_ids,omitempty"` // 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 - NeedNotification *bool `json:"need_notification,omitempty"` // 删除日程参与人时是否要给参与人发送bot通知，默认为true + AttendeeIds []string `json:"attendee_ids,omitempty"` // 要移除的参与人 ID 列表。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) + DeleteIds []*CalendarEventAttendeeId `json:"delete_ids,omitempty"` // 需要删除的参与人类型实体 ID，作为 attendee_ids 字段的补充。 + NeedNotification *bool `json:"need_notification,omitempty"` // 删除日程参与人时是否要给参与人发送 bot 通知，默认为 true InstanceStartTimeAdmin *string `json:"instance_start_time_admin,omitempty"` // 使用管理员身份访问时要修改的实例 - IsEnableAdmin *bool `json:"is_enable_admin,omitempty"` // 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) + IsEnableAdmin *bool `json:"is_enable_admin,omitempty"` // 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) } type BatchDeleteCalendarEventAttendeeReq struct { @@ -4749,13 +4749,13 @@ func (resp *BatchDeleteCalendarEventAttendeeResp) Success() bool { } type CreateCalendarEventAttendeeReqBodyBuilder struct { - attendees []*CalendarEventAttendee // 新增参与人列表；;- 单次请求会议室的数量限制为100。 + attendees []*CalendarEventAttendee // 新增参与人列表；;- 单次请求会议室的数量限制为 100。 attendeesFlag bool - needNotification bool // 是否给参与人发送bot通知 默认为true + needNotification bool // 是否给参与人发送 bot 通知 默认为 true needNotificationFlag bool - instanceStartTimeAdmin string // 使用管理员身份访问时要修改的实例(仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) + instanceStartTimeAdmin string // 使用管理员身份访问时要修改的实例 (仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) instanceStartTimeAdminFlag bool - isEnableAdmin bool // 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) + isEnableAdmin bool // 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) isEnableAdminFlag bool } @@ -4764,7 +4764,7 @@ func NewCreateCalendarEventAttendeeReqBodyBuilder() *CreateCalendarEventAttendee return builder } -// 新增参与人列表；;- 单次请求会议室的数量限制为100。 +// 新增参与人列表；;- 单次请求会议室的数量限制为 100。 // //示例值： func (builder *CreateCalendarEventAttendeeReqBodyBuilder) Attendees(attendees []*CalendarEventAttendee) *CreateCalendarEventAttendeeReqBodyBuilder { @@ -4773,7 +4773,7 @@ func (builder *CreateCalendarEventAttendeeReqBodyBuilder) Attendees(attendees [] return builder } -// 是否给参与人发送bot通知 默认为true +// 是否给参与人发送 bot 通知 默认为 true // //示例值：false func (builder *CreateCalendarEventAttendeeReqBodyBuilder) NeedNotification(needNotification bool) *CreateCalendarEventAttendeeReqBodyBuilder { @@ -4782,7 +4782,7 @@ func (builder *CreateCalendarEventAttendeeReqBodyBuilder) NeedNotification(needN return builder } -// 使用管理员身份访问时要修改的实例(仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) +// 使用管理员身份访问时要修改的实例 (仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) // //示例值：1647320400 func (builder *CreateCalendarEventAttendeeReqBodyBuilder) InstanceStartTimeAdmin(instanceStartTimeAdmin string) *CreateCalendarEventAttendeeReqBodyBuilder { @@ -4791,7 +4791,7 @@ func (builder *CreateCalendarEventAttendeeReqBodyBuilder) InstanceStartTimeAdmin return builder } -// 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) +// 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) // //示例值：false func (builder *CreateCalendarEventAttendeeReqBodyBuilder) IsEnableAdmin(isEnableAdmin bool) *CreateCalendarEventAttendeeReqBodyBuilder { @@ -4818,13 +4818,13 @@ func (builder *CreateCalendarEventAttendeeReqBodyBuilder) Build() *CreateCalenda } type CreateCalendarEventAttendeePathReqBodyBuilder struct { - attendees []*CalendarEventAttendee // 新增参与人列表；;- 单次请求会议室的数量限制为100。 + attendees []*CalendarEventAttendee // 新增参与人列表；;- 单次请求会议室的数量限制为 100。 attendeesFlag bool - needNotification bool // 是否给参与人发送bot通知 默认为true + needNotification bool // 是否给参与人发送 bot 通知 默认为 true needNotificationFlag bool - instanceStartTimeAdmin string // 使用管理员身份访问时要修改的实例(仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) + instanceStartTimeAdmin string // 使用管理员身份访问时要修改的实例 (仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) instanceStartTimeAdminFlag bool - isEnableAdmin bool // 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) + isEnableAdmin bool // 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) isEnableAdminFlag bool } @@ -4833,7 +4833,7 @@ func NewCreateCalendarEventAttendeePathReqBodyBuilder() *CreateCalendarEventAtte return builder } -// 新增参与人列表；;- 单次请求会议室的数量限制为100。 +// 新增参与人列表；;- 单次请求会议室的数量限制为 100。 // // 示例值： func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) Attendees(attendees []*CalendarEventAttendee) *CreateCalendarEventAttendeePathReqBodyBuilder { @@ -4842,7 +4842,7 @@ func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) Attendees(attendee return builder } -// 是否给参与人发送bot通知 默认为true +// 是否给参与人发送 bot 通知 默认为 true // // 示例值：false func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) NeedNotification(needNotification bool) *CreateCalendarEventAttendeePathReqBodyBuilder { @@ -4851,7 +4851,7 @@ func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) NeedNotification(n return builder } -// 使用管理员身份访问时要修改的实例(仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) +// 使用管理员身份访问时要修改的实例 (仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) // // 示例值：1647320400 func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) InstanceStartTimeAdmin(instanceStartTimeAdmin string) *CreateCalendarEventAttendeePathReqBodyBuilder { @@ -4860,7 +4860,7 @@ func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) InstanceStartTimeA return builder } -// 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) +// 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) // // 示例值：false func (builder *CreateCalendarEventAttendeePathReqBodyBuilder) IsEnableAdmin(isEnableAdmin bool) *CreateCalendarEventAttendeePathReqBodyBuilder { @@ -4900,7 +4900,7 @@ func NewCreateCalendarEventAttendeeReqBuilder() *CreateCalendarEventAttendeeReqB return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *CreateCalendarEventAttendeeReqBuilder) CalendarId(calendarId string) *CreateCalendarEventAttendeeReqBuilder { @@ -4908,7 +4908,7 @@ func (builder *CreateCalendarEventAttendeeReqBuilder) CalendarId(calendarId stri return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：xxxxxxxxx_0 func (builder *CreateCalendarEventAttendeeReqBuilder) EventId(eventId string) *CreateCalendarEventAttendeeReqBuilder { @@ -4916,7 +4916,7 @@ func (builder *CreateCalendarEventAttendeeReqBuilder) EventId(eventId string) *C return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateCalendarEventAttendeeReqBuilder) UserIdType(userIdType string) *CreateCalendarEventAttendeeReqBuilder { @@ -4940,10 +4940,10 @@ func (builder *CreateCalendarEventAttendeeReqBuilder) Build() *CreateCalendarEve } type CreateCalendarEventAttendeeReqBody struct { - Attendees []*CalendarEventAttendee `json:"attendees,omitempty"` // 新增参与人列表；;- 单次请求会议室的数量限制为100。 - NeedNotification *bool `json:"need_notification,omitempty"` // 是否给参与人发送bot通知 默认为true - InstanceStartTimeAdmin *string `json:"instance_start_time_admin,omitempty"` // 使用管理员身份访问时要修改的实例(仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) - IsEnableAdmin *bool `json:"is_enable_admin,omitempty"` // 是否启用管理员身份(需先在管理后台设置某人为会议室管理员) + Attendees []*CalendarEventAttendee `json:"attendees,omitempty"` // 新增参与人列表；;- 单次请求会议室的数量限制为 100。 + NeedNotification *bool `json:"need_notification,omitempty"` // 是否给参与人发送 bot 通知 默认为 true + InstanceStartTimeAdmin *string `json:"instance_start_time_admin,omitempty"` // 使用管理员身份访问时要修改的实例 (仅用于重复日程修改其中的一个实例，非重复日程无需填此字段) + IsEnableAdmin *bool `json:"is_enable_admin,omitempty"` // 是否启用管理员身份 (需先在管理后台设置某人为会议室管理员) } type CreateCalendarEventAttendeeReq struct { @@ -4985,7 +4985,7 @@ func (builder *ListCalendarEventAttendeeReqBuilder) Limit(limit int) *ListCalend return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *ListCalendarEventAttendeeReqBuilder) CalendarId(calendarId string) *ListCalendarEventAttendeeReqBuilder { @@ -4993,7 +4993,7 @@ func (builder *ListCalendarEventAttendeeReqBuilder) CalendarId(calendarId string return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：xxxxxxxxx_0 func (builder *ListCalendarEventAttendeeReqBuilder) EventId(eventId string) *ListCalendarEventAttendeeReqBuilder { @@ -5001,7 +5001,7 @@ func (builder *ListCalendarEventAttendeeReqBuilder) EventId(eventId string) *Lis return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListCalendarEventAttendeeReqBuilder) UserIdType(userIdType string) *ListCalendarEventAttendeeReqBuilder { @@ -5076,7 +5076,7 @@ func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) Limit(limit int) * return builder } -// 日历ID。参见[日历ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) +// 日历 ID。参见 [日历 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/introduction) // // 示例值：feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) CalendarId(calendarId string) *ListCalendarEventAttendeeChatMemberReqBuilder { @@ -5084,7 +5084,7 @@ func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) CalendarId(calenda return builder } -// 日程ID。参见[日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) +// 日程 ID。参见 [日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/introduction) // // 示例值：xxxxxxxxx_0 func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) EventId(eventId string) *ListCalendarEventAttendeeChatMemberReqBuilder { @@ -5092,7 +5092,7 @@ func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) EventId(eventId st return builder } -// 群参与人 ID。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) +// 群参与人 ID。参见 [参与人 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) // // 示例值：chat_xxxxxx func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) AttendeeId(attendeeId string) *ListCalendarEventAttendeeChatMemberReqBuilder { @@ -5116,7 +5116,7 @@ func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) PageSize(pageSize return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListCalendarEventAttendeeChatMemberReqBuilder) UserIdType(userIdType string) *ListCalendarEventAttendeeChatMemberReqBuilder { @@ -5140,7 +5140,7 @@ type ListCalendarEventAttendeeChatMemberReq struct { } type ListCalendarEventAttendeeChatMemberRespData struct { - Items []*CalendarEventAttendeeChatMember `json:"items,omitempty"` // 群中的群成员，当type为chat时有效；群成员不支持编辑 + Items []*CalendarEventAttendeeChatMember `json:"items,omitempty"` // 群中的群成员，当 type 为 chat 时有效；群成员不支持编辑 HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 PageToken *string `json:"page_token,omitempty"` // 下次请求需要带上的分页标记 } @@ -5169,7 +5169,7 @@ func NewCreateExchangeBindingReqBuilder() *CreateExchangeBindingReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateExchangeBindingReqBuilder) UserIdType(userIdType string) *CreateExchangeBindingReqBuilder { @@ -5177,7 +5177,7 @@ func (builder *CreateExchangeBindingReqBuilder) UserIdType(userIdType string) *C return builder } -// 本接口将Exchange账户绑定到飞书账户，进而支持Exchange日历的导入 +// 本接口将 Exchange 账户绑定到飞书账户，进而支持 Exchange 日历的导入 func (builder *CreateExchangeBindingReqBuilder) ExchangeBinding(exchangeBinding *ExchangeBinding) *CreateExchangeBindingReqBuilder { builder.exchangeBinding = exchangeBinding return builder @@ -5197,11 +5197,11 @@ type CreateExchangeBindingReq struct { } type CreateExchangeBindingRespData struct { - AdminAccount *string `json:"admin_account,omitempty"` // admin账户 - ExchangeAccount *string `json:"exchange_account,omitempty"` // 用户绑定的Exchange账户 - UserId *string `json:"user_id,omitempty"` // Exchange账户绑定user唯一标识id - Status *string `json:"status,omitempty"` // Exchange账户同步状态 - ExchangeBindingId *string `json:"exchange_binding_id,omitempty"` // exchange绑定唯一标识id + AdminAccount *string `json:"admin_account,omitempty"` // admin 账户 + ExchangeAccount *string `json:"exchange_account,omitempty"` // 用户绑定的 Exchange 账户 + UserId *string `json:"user_id,omitempty"` // Exchange 账户绑定 user 唯一标识 id + Status *string `json:"status,omitempty"` // Exchange 账户同步状态 + ExchangeBindingId *string `json:"exchange_binding_id,omitempty"` // exchange 绑定唯一标识 id } type CreateExchangeBindingResp struct { @@ -5227,7 +5227,7 @@ func NewDeleteExchangeBindingReqBuilder() *DeleteExchangeBindingReqBuilder { return builder } -// exchange绑定唯一标识id。参见[exchange绑定ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) +// exchange 绑定唯一标识 id。参见 [exchange 绑定 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) // // 示例值：ZW1haWxfYWRtaW5fZXhhbXBsZUBvdXRsb29rLmNvbSBlbWFpbF9hY2NvdW50X2V4YW1wbGVAb3V0bG9vay5jb20= func (builder *DeleteExchangeBindingReqBuilder) ExchangeBindingId(exchangeBindingId string) *DeleteExchangeBindingReqBuilder { @@ -5268,7 +5268,7 @@ func NewGetExchangeBindingReqBuilder() *GetExchangeBindingReqBuilder { return builder } -// exchange绑定唯一标识id。参见[exchange绑定ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) +// exchange 绑定唯一标识 id。参见 [exchange 绑定 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/exchange_binding/introduction#12533d5e) // // 示例值：ZW1haWxfYWRtaW5fZXhhbXBsZUBvdXRsb29rLmNvbSBlbWFpbF9hY2NvdW50X2V4YW1wbGVAb3V0bG9vay5jb20= func (builder *GetExchangeBindingReqBuilder) ExchangeBindingId(exchangeBindingId string) *GetExchangeBindingReqBuilder { @@ -5276,7 +5276,7 @@ func (builder *GetExchangeBindingReqBuilder) ExchangeBindingId(exchangeBindingId return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetExchangeBindingReqBuilder) UserIdType(userIdType string) *GetExchangeBindingReqBuilder { @@ -5297,11 +5297,11 @@ type GetExchangeBindingReq struct { } type GetExchangeBindingRespData struct { - AdminAccount *string `json:"admin_account,omitempty"` // admin账户 - ExchangeAccount *string `json:"exchange_account,omitempty"` // 用户绑定的Exchange账户 - UserId *string `json:"user_id,omitempty"` // Exchange账户绑定user唯一标识id - Status *string `json:"status,omitempty"` // Exchange账户同步状态 - ExchangeBindingId *string `json:"exchange_binding_id,omitempty"` // Exchange绑定关系唯一标识ID + AdminAccount *string `json:"admin_account,omitempty"` // admin 账户 + ExchangeAccount *string `json:"exchange_account,omitempty"` // 用户绑定的 Exchange 账户 + UserId *string `json:"user_id,omitempty"` // Exchange 账户绑定 user 唯一标识 id + Status *string `json:"status,omitempty"` // Exchange 账户同步状态 + ExchangeBindingId *string `json:"exchange_binding_id,omitempty"` // Exchange 绑定关系唯一标识 ID } type GetExchangeBindingResp struct { @@ -5315,13 +5315,13 @@ func (resp *GetExchangeBindingResp) Success() bool { } type ListFreebusyReqBodyBuilder struct { - timeMin string // 查询时段开始时间，需要url编码 + timeMin string // 查询时段开始时间，需要 url 编码 timeMinFlag bool - timeMax string // 查询时段结束时间，需要url编码 + timeMax string // 查询时段结束时间，需要 url 编码 timeMaxFlag bool - userId string // 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 用户 user_id，输入时与 room_id 二选一。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool - roomId string // 会议室room_id，输入时与 user_id 二选一 + roomId string // 会议室 room_id，输入时与 user_id 二选一 roomIdFlag bool } @@ -5330,7 +5330,7 @@ func NewListFreebusyReqBodyBuilder() *ListFreebusyReqBodyBuilder { return builder } -// 查询时段开始时间，需要url编码 +// 查询时段开始时间，需要 url 编码 // //示例值：2020-10-28T12:00:00+08:00 func (builder *ListFreebusyReqBodyBuilder) TimeMin(timeMin string) *ListFreebusyReqBodyBuilder { @@ -5339,7 +5339,7 @@ func (builder *ListFreebusyReqBodyBuilder) TimeMin(timeMin string) *ListFreebusy return builder } -// 查询时段结束时间，需要url编码 +// 查询时段结束时间，需要 url 编码 // //示例值：2020-12-28T12:00:00+08:00 func (builder *ListFreebusyReqBodyBuilder) TimeMax(timeMax string) *ListFreebusyReqBodyBuilder { @@ -5348,7 +5348,7 @@ func (builder *ListFreebusyReqBodyBuilder) TimeMax(timeMax string) *ListFreebusy return builder } -// 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户 user_id，输入时与 room_id 二选一。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // //示例值：ou_xxxxxxxxxx func (builder *ListFreebusyReqBodyBuilder) UserId(userId string) *ListFreebusyReqBodyBuilder { @@ -5357,7 +5357,7 @@ func (builder *ListFreebusyReqBodyBuilder) UserId(userId string) *ListFreebusyRe return builder } -// 会议室room_id，输入时与 user_id 二选一 +// 会议室 room_id，输入时与 user_id 二选一 // //示例值：omm_xxxxxxxxxx func (builder *ListFreebusyReqBodyBuilder) RoomId(roomId string) *ListFreebusyReqBodyBuilder { @@ -5384,13 +5384,13 @@ func (builder *ListFreebusyReqBodyBuilder) Build() *ListFreebusyReqBody { } type ListFreebusyPathReqBodyBuilder struct { - timeMin string // 查询时段开始时间，需要url编码 + timeMin string // 查询时段开始时间，需要 url 编码 timeMinFlag bool - timeMax string // 查询时段结束时间，需要url编码 + timeMax string // 查询时段结束时间，需要 url 编码 timeMaxFlag bool - userId string // 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 用户 user_id，输入时与 room_id 二选一。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool - roomId string // 会议室room_id，输入时与 user_id 二选一 + roomId string // 会议室 room_id，输入时与 user_id 二选一 roomIdFlag bool } @@ -5399,7 +5399,7 @@ func NewListFreebusyPathReqBodyBuilder() *ListFreebusyPathReqBodyBuilder { return builder } -// 查询时段开始时间，需要url编码 +// 查询时段开始时间，需要 url 编码 // // 示例值：2020-10-28T12:00:00+08:00 func (builder *ListFreebusyPathReqBodyBuilder) TimeMin(timeMin string) *ListFreebusyPathReqBodyBuilder { @@ -5408,7 +5408,7 @@ func (builder *ListFreebusyPathReqBodyBuilder) TimeMin(timeMin string) *ListFree return builder } -// 查询时段结束时间，需要url编码 +// 查询时段结束时间，需要 url 编码 // // 示例值：2020-12-28T12:00:00+08:00 func (builder *ListFreebusyPathReqBodyBuilder) TimeMax(timeMax string) *ListFreebusyPathReqBodyBuilder { @@ -5417,7 +5417,7 @@ func (builder *ListFreebusyPathReqBodyBuilder) TimeMax(timeMax string) *ListFree return builder } -// 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户 user_id，输入时与 room_id 二选一。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_xxxxxxxxxx func (builder *ListFreebusyPathReqBodyBuilder) UserId(userId string) *ListFreebusyPathReqBodyBuilder { @@ -5426,7 +5426,7 @@ func (builder *ListFreebusyPathReqBodyBuilder) UserId(userId string) *ListFreebu return builder } -// 会议室room_id，输入时与 user_id 二选一 +// 会议室 room_id，输入时与 user_id 二选一 // // 示例值：omm_xxxxxxxxxx func (builder *ListFreebusyPathReqBodyBuilder) RoomId(roomId string) *ListFreebusyPathReqBodyBuilder { @@ -5466,7 +5466,7 @@ func NewListFreebusyReqBuilder() *ListFreebusyReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListFreebusyReqBuilder) UserIdType(userIdType string) *ListFreebusyReqBuilder { @@ -5489,10 +5489,10 @@ func (builder *ListFreebusyReqBuilder) Build() *ListFreebusyReq { } type ListFreebusyReqBody struct { - TimeMin *string `json:"time_min,omitempty"` // 查询时段开始时间，需要url编码 - TimeMax *string `json:"time_max,omitempty"` // 查询时段结束时间，需要url编码 - UserId *string `json:"user_id,omitempty"` // 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - RoomId *string `json:"room_id,omitempty"` // 会议室room_id，输入时与 user_id 二选一 + TimeMin *string `json:"time_min,omitempty"` // 查询时段开始时间，需要 url 编码 + TimeMax *string `json:"time_max,omitempty"` // 查询时段结束时间，需要 url 编码 + UserId *string `json:"user_id,omitempty"` // 用户 user_id，输入时与 room_id 二选一。参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + RoomId *string `json:"room_id,omitempty"` // 会议室 room_id，输入时与 user_id 二选一 } type ListFreebusyReq struct { @@ -5582,7 +5582,7 @@ func NewGenerateCaldavConfSettingReqBuilder() *GenerateCaldavConfSettingReqBuild return builder } -// 用于为当前用户生成一个CalDAV账号密码，用于将飞书日历信息同步到本地设备日历。 +// 用于为当前用户生成一个 CalDAV 账号密码，用于将飞书日历信息同步到本地设备日历。 func (builder *GenerateCaldavConfSettingReqBuilder) Body(body *GenerateCaldavConfSettingReqBody) *GenerateCaldavConfSettingReqBuilder { builder.body = body return builder @@ -5605,8 +5605,8 @@ type GenerateCaldavConfSettingReq struct { } type GenerateCaldavConfSettingRespData struct { - Password *string `json:"password,omitempty"` // caldav密码 - UserName *string `json:"user_name,omitempty"` // caldav用户名 + Password *string `json:"password,omitempty"` // caldav 密码 + UserName *string `json:"user_name,omitempty"` // caldav 用户名 ServerAddress *string `json:"server_address,omitempty"` // 服务器地址 DeviceName *string `json:"device_name,omitempty"` // 设备名 } @@ -5635,7 +5635,7 @@ func NewCreateTimeoffEventReqBuilder() *CreateTimeoffEventReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateTimeoffEventReqBuilder) UserIdType(userIdType string) *CreateTimeoffEventReqBuilder { @@ -5663,13 +5663,13 @@ type CreateTimeoffEventReq struct { } type CreateTimeoffEventRespData struct { - TimeoffEventId *string `json:"timeoff_event_id,omitempty"` // 休假申请的唯一标识id - UserId *string `json:"user_id,omitempty"` // 用户的user id + TimeoffEventId *string `json:"timeoff_event_id,omitempty"` // 休假申请的唯一标识 id + UserId *string `json:"user_id,omitempty"` // 用户的 user id Timezone *string `json:"timezone,omitempty"` // 休假人的时区 - StartTime *string `json:"start_time,omitempty"` // 休假开始时间（时间戳）/日期（2021-01-01），为日期时将生成全天日程，且与end_time对应，不符合将返回错误 - EndTime *string `json:"end_time,omitempty"` // 休假结束时间（时间戳）/日期（2021-01-01），为日期时将生成全天日程，与start_time对应，不符合将返回错误 - Title *string `json:"title,omitempty"` // 休假日程标题，可自定义例如："请假中(全天) / 1-Day Time Off"，"请假中(半天) / 0.5-Day Time Off"，"长期休假中 / Leave of Absence"，"请假中" - Description *string `json:"description,omitempty"` // 休假日程描述，可自定义,例如：;"若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。;;If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked." + StartTime *string `json:"start_time,omitempty"` // 休假开始时间（时间戳）/日期（2021-01-01），为日期时将生成全天日程，且与 end_time 对应，不符合将返回错误 + EndTime *string `json:"end_time,omitempty"` // 休假结束时间（时间戳）/日期（2021-01-01），为日期时将生成全天日程，与 start_time 对应，不符合将返回错误 + Title *string `json:"title,omitempty"` // 休假日程标题，可自定义例如："请假中 (全天) / 1-Day Time Off"，"请假中 (半天) / 0.5-Day Time Off"，"长期休假中 / Leave of Absence"，"请假中" + Description *string `json:"description,omitempty"` // 休假日程描述，可自定义，例如：;"若拒绝或删除此日程，飞书中相应的 “请假” 标签将自动消失，而请假系统中的休假申请不会被撤销。;;If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked." } type CreateTimeoffEventResp struct { @@ -5695,7 +5695,7 @@ func NewDeleteTimeoffEventReqBuilder() *DeleteTimeoffEventReqBuilder { return builder } -// 休假申请的唯一标识id。参见[请假日程ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) +// 休假申请的唯一标识 id。参见 [请假日程 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/introduction#b6611a02) // // 示例值：timeoff:XXXXXX-XXXX-0917-1623-aa493d591a39 func (builder *DeleteTimeoffEventReqBuilder) TimeoffEventId(timeoffEventId string) *DeleteTimeoffEventReqBuilder { @@ -5738,7 +5738,7 @@ func (m *P2CalendarChangedV4) RawReq(req *larkevent.EventReq) { } type P2CalendarAclCreatedV4Data struct { - AclId *string `json:"acl_id,omitempty"` // acl资源ID + AclId *string `json:"acl_id,omitempty"` // acl 资源 ID Role *string `json:"role,omitempty"` // 对日历的访问权限 Scope *AclScopeEvent `json:"scope,omitempty"` // 权限范围 UserIdList []*UserId `json:"user_id_list,omitempty"` // 需要推送事件的用户列表 @@ -5755,7 +5755,7 @@ func (m *P2CalendarAclCreatedV4) RawReq(req *larkevent.EventReq) { } type P2CalendarAclDeletedV4Data struct { - AclId *string `json:"acl_id,omitempty"` // acl资源ID + AclId *string `json:"acl_id,omitempty"` // acl 资源 ID Role *string `json:"role,omitempty"` // 对日历的访问权限 Scope *AclScopeEvent `json:"scope,omitempty"` // 权限范围 UserIdList []*UserId `json:"user_id_list,omitempty"` // 需要推送事件的用户列表 @@ -5772,7 +5772,7 @@ func (m *P2CalendarAclDeletedV4) RawReq(req *larkevent.EventReq) { } type P2CalendarEventChangedV4Data struct { - CalendarId *string `json:"calendar_id,omitempty"` // 日历id + CalendarId *string `json:"calendar_id,omitempty"` // 日历 id UserIdList []*UserId `json:"user_id_list,omitempty"` // 需要推送事件的用户列表 } @@ -5804,7 +5804,7 @@ func (iterator *SearchCalendarIterator) Next() (bool, *Calendar, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -5858,7 +5858,7 @@ func (iterator *ListCalendarAclIterator) Next() (bool, *CalendarAcl, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -5912,7 +5912,7 @@ func (iterator *SearchCalendarEventIterator) Next() (bool, *CalendarEvent, error return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -5966,7 +5966,7 @@ func (iterator *ListCalendarEventAttendeeIterator) Next() (bool, *CalendarEventA return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -6020,7 +6020,7 @@ func (iterator *ListCalendarEventAttendeeChatMemberIterator) Next() (bool, *Cale return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/contact/v3/api.go b/service/contact/v3/api.go index bc53395f..cedd8946 100644 --- a/service/contact/v3/api.go +++ b/service/contact/v3/api.go @@ -99,11 +99,11 @@ type user struct { // // - 获取企业自定义的用户字段配置信息 // -// - 调用该接口前，需要先确认[企业管理员](https://www.feishu.cn/hc/zh-CN/articles/360049067822)在[企业管理后台 - 组织架构 - 成员字段管理](http://www.feishu.cn/admin/contacts/employee-field-new/custom) 自定义字段管理栏开启了“允许开放平台API调用“。;;![通讯录.gif](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/544738c94f13ef0b9ebaff53a5133cc7_E9EGMkXyzX.gif) +// - 调用该接口前，需要先确认 [企业管理员](https://www.feishu.cn/hc/zh-CN/articles/360049067822) 在 [企业管理后台 - 组织架构 - 成员字段管理](http://www.feishu.cn/admin/contacts/employee-field-new/custom) 自定义字段管理栏开启了 “允许开放平台 API 调用 “。;;![通讯录.gif](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/544738c94f13ef0b9ebaff53a5133cc7_E9EGMkXyzX.gif) // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/custom_attr/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/custom_attr/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_customAttr.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_customAttr.go func (c *customAttr) List(ctx context.Context, req *ListCustomAttrReq, options ...larkcore.RequestOptionFunc) (*ListCustomAttrResp, error) { // 发起请求 apiReq := req.apiReq @@ -133,13 +133,13 @@ func (c *customAttr) ListByIterator(ctx context.Context, req *ListCustomAttrReq, // 获取子部门列表 // -// - 通过部门ID获取部门的子部门列表。 +// - 通过部门 ID 获取部门的子部门列表。 // -// - - 部门ID 必填，根部门的部门ID 为0。;- 使用 `user_access_token` 时，返回该用户组织架构可见性范围（[登陆企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility)）内的所有可见部门。当进行递归查询时，最多1000个部门对该用户可见。;;- 使用 ;`tenant_access_token` 则基于应用的通讯录权限范围进行权限校验与过滤。;如果部门ID为0，会检验应用是否有全员通讯录权限，如果是非0 部门ID，则会校验应用是否有该部门的通讯录权限。无部门权限返回无部门通讯录权限错误码，有权限则返回部门下子部门列表（根据fetch_child决定是否递归）。 +// - - 部门 ID 必填，根部门的部门 ID 为 0。;- 使用 `user_access_token` 时，返回该用户组织架构可见性范围（[登陆企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility)）内的所有可见部门。当进行递归查询时，最多 1000 个部门对该用户可见。;;- 使用 ;`tenant_access_token` 则基于应用的通讯录权限范围进行权限校验与过滤。;如果部门 ID 为 0，会检验应用是否有全员通讯录权限，如果是非 0 部门 ID，则会校验应用是否有该部门的通讯录权限。无部门权限返回无部门通讯录权限错误码，有权限则返回部门下子部门列表（根据 fetch_child 决定是否递归）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/children +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/children // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/children_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/children_department.go func (d *department) Children(ctx context.Context, req *ChildrenDepartmentReq, options ...larkcore.RequestOptionFunc) (*ChildrenDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -171,11 +171,11 @@ func (d *department) ChildrenByIterator(ctx context.Context, req *ChildrenDepart // // - 该接口用于向通讯录中创建部门。 // -// - 只可在应用的通讯录权限范围内的部门下创建部门。若需要在根部门下创建子部门，则应用通讯录权限范围需要设置为“全部成员”。应用商店应用无权限调用此接口。 +// - 只可在应用的通讯录权限范围内的部门下创建部门。若需要在根部门下创建子部门，则应用通讯录权限范围需要设置为 “全部成员”。应用商店应用无权限调用此接口。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_department.go func (d *department) Create(ctx context.Context, req *CreateDepartmentReq, options ...larkcore.RequestOptionFunc) (*CreateDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -201,9 +201,9 @@ func (d *department) Create(ctx context.Context, req *CreateDepartmentReq, optio // // - 应用需要同时拥有待删除部门及其父部门的通讯录授权。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_department.go func (d *department) Delete(ctx context.Context, req *DeleteDepartmentReq, options ...larkcore.RequestOptionFunc) (*DeleteDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -229,9 +229,9 @@ func (d *department) Delete(ctx context.Context, req *DeleteDepartmentReq, optio // // - - 使用`tenant_access_token`时，应用需要拥有待查询部门的通讯录授权。如果需要获取根部门信息，则需要拥有全员权限。;- 使用`user_access_token`时，用户需要有待查询部门的可见性，如果需要获取根部门信息，则要求员工可见所有人。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_department.go func (d *department) Get(ctx context.Context, req *GetDepartmentReq, options ...larkcore.RequestOptionFunc) (*GetDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -255,9 +255,9 @@ func (d *department) Get(ctx context.Context, req *GetDepartmentReq, options ... // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=department&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=department&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_department.go func (d *department) List(ctx context.Context, req *ListDepartmentReq, options ...larkcore.RequestOptionFunc) (*ListDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -289,11 +289,11 @@ func (d *department) ListByIterator(ctx context.Context, req *ListDepartmentReq, // // - 该接口用来递归获取部门父部门的信息，并按照由子到父的顺序返回有权限的父部门信息列表。 // -// - 使用`tenant_access_token`时,该接口只返回可见性范围内的父部门信息。;例如：A >>B>>C>>D四级部门，通讯录权限只到B，那么查询D部门的parent，会返回B和C两级部门。;使用user_access_token时,该接口只返回对于用户可见的父部门信息。 +// - 使用`tenant_access_token`时，该接口只返回可见性范围内的父部门信息。;例如：A >>B>>C>>D 四级部门，通讯录权限只到 B，那么查询 D 部门的 parent，会返回 B 和 C 两级部门。;使用 user_access_token 时，该接口只返回对于用户可见的父部门信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/parent +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/parent // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/parent_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/parent_department.go func (d *department) Parent(ctx context.Context, req *ParentDepartmentReq, options ...larkcore.RequestOptionFunc) (*ParentDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -327,9 +327,9 @@ func (d *department) ParentByIterator(ctx context.Context, req *ParentDepartment // // - 调用该接口需要具有该部门以及更新操作涉及的部门的通讯录权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_department.go func (d *department) Patch(ctx context.Context, req *PatchDepartmentReq, options ...larkcore.RequestOptionFunc) (*PatchDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -355,9 +355,9 @@ func (d *department) Patch(ctx context.Context, req *PatchDepartmentReq, options // // - 部门存在，但用户搜索不到并不一定是搜索有问题，可能是管理员在后台配置了权限控制，导致用户无法搜索到该部门。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/search_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/search_department.go func (d *department) Search(ctx context.Context, req *SearchDepartmentReq, options ...larkcore.RequestOptionFunc) (*SearchDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -389,9 +389,9 @@ func (d *department) SearchByIterator(ctx context.Context, req *SearchDepartment // // - 通过该接口将部门群转为普通群。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/unbind_department_chat +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/unbind_department_chat // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/unbindDepartmentChat_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/unbindDepartmentChat_department.go func (d *department) UnbindDepartmentChat(ctx context.Context, req *UnbindDepartmentChatDepartmentReq, options ...larkcore.RequestOptionFunc) (*UnbindDepartmentChatDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -415,11 +415,11 @@ func (d *department) UnbindDepartmentChat(ctx context.Context, req *UnbindDepart // // - 该接口用于更新当前部门所有信息。 // -// - - 调用该接口需要具有该部门与更新部门信息涉及的通讯录权限。;; - 没有填写的字段会被置为空值（order字段除外）。 +// - - 调用该接口需要具有该部门与更新部门信息涉及的通讯录权限。;; - 没有填写的字段会被置为空值（order 字段除外）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_department.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_department.go func (d *department) Update(ctx context.Context, req *UpdateDepartmentReq, options ...larkcore.RequestOptionFunc) (*UpdateDepartmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -443,9 +443,9 @@ func (d *department) Update(ctx context.Context, req *UpdateDepartmentReq, optio // // - 新增自定义人员类型 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_employeeTypeEnum.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_employeeTypeEnum.go func (e *employeeTypeEnum) Create(ctx context.Context, req *CreateEmployeeTypeEnumReq, options ...larkcore.RequestOptionFunc) (*CreateEmployeeTypeEnumResp, error) { // 发起请求 apiReq := req.apiReq @@ -469,9 +469,9 @@ func (e *employeeTypeEnum) Create(ctx context.Context, req *CreateEmployeeTypeEn // // - 删除自定义人员类型 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_employeeTypeEnum.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_employeeTypeEnum.go func (e *employeeTypeEnum) Delete(ctx context.Context, req *DeleteEmployeeTypeEnumReq, options ...larkcore.RequestOptionFunc) (*DeleteEmployeeTypeEnumResp, error) { // 发起请求 apiReq := req.apiReq @@ -495,9 +495,9 @@ func (e *employeeTypeEnum) Delete(ctx context.Context, req *DeleteEmployeeTypeEn // // - 该接口用于获取员工的人员类型 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_employeeTypeEnum.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_employeeTypeEnum.go func (e *employeeTypeEnum) List(ctx context.Context, req *ListEmployeeTypeEnumReq, options ...larkcore.RequestOptionFunc) (*ListEmployeeTypeEnumResp, error) { // 发起请求 apiReq := req.apiReq @@ -529,9 +529,9 @@ func (e *employeeTypeEnum) ListByIterator(ctx context.Context, req *ListEmployee // // - 更新自定义人员类型 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_employeeTypeEnum.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_employeeTypeEnum.go func (e *employeeTypeEnum) Update(ctx context.Context, req *UpdateEmployeeTypeEnumReq, options ...larkcore.RequestOptionFunc) (*UpdateEmployeeTypeEnumResp, error) { // 发起请求 apiReq := req.apiReq @@ -555,9 +555,9 @@ func (e *employeeTypeEnum) Update(ctx context.Context, req *UpdateEmployeeTypeEn // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=contact&resource=functional_role&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=contact&resource=functional_role&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_functionalRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_functionalRole.go func (f *functionalRole) Create(ctx context.Context, req *CreateFunctionalRoleReq, options ...larkcore.RequestOptionFunc) (*CreateFunctionalRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -581,9 +581,9 @@ func (f *functionalRole) Create(ctx context.Context, req *CreateFunctionalRoleRe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete&project=contact&resource=functional_role&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete&project=contact&resource=functional_role&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_functionalRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_functionalRole.go func (f *functionalRole) Delete(ctx context.Context, req *DeleteFunctionalRoleReq, options ...larkcore.RequestOptionFunc) (*DeleteFunctionalRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -607,9 +607,9 @@ func (f *functionalRole) Delete(ctx context.Context, req *DeleteFunctionalRoleRe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=contact&resource=functional_role&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=contact&resource=functional_role&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_functionalRole.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_functionalRole.go func (f *functionalRole) Update(ctx context.Context, req *UpdateFunctionalRoleReq, options ...larkcore.RequestOptionFunc) (*UpdateFunctionalRoleResp, error) { // 发起请求 apiReq := req.apiReq @@ -633,9 +633,9 @@ func (f *functionalRole) Update(ctx context.Context, req *UpdateFunctionalRoleRe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=contact&resource=functional_role.member&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=contact&resource=functional_role.member&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchCreate_functionalRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchCreate_functionalRoleMember.go func (f *functionalRoleMember) BatchCreate(ctx context.Context, req *BatchCreateFunctionalRoleMemberReq, options ...larkcore.RequestOptionFunc) (*BatchCreateFunctionalRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -659,9 +659,9 @@ func (f *functionalRoleMember) BatchCreate(ctx context.Context, req *BatchCreate // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=contact&resource=functional_role.member&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=contact&resource=functional_role.member&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchDelete_functionalRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchDelete_functionalRoleMember.go func (f *functionalRoleMember) BatchDelete(ctx context.Context, req *BatchDeleteFunctionalRoleMemberReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteFunctionalRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -685,9 +685,9 @@ func (f *functionalRoleMember) BatchDelete(ctx context.Context, req *BatchDelete // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=contact&resource=functional_role.member&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=contact&resource=functional_role.member&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_functionalRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_functionalRoleMember.go func (f *functionalRoleMember) Get(ctx context.Context, req *GetFunctionalRoleMemberReq, options ...larkcore.RequestOptionFunc) (*GetFunctionalRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -711,9 +711,9 @@ func (f *functionalRoleMember) Get(ctx context.Context, req *GetFunctionalRoleMe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=functional_role.member&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=functional_role.member&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_functionalRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_functionalRoleMember.go func (f *functionalRoleMember) List(ctx context.Context, req *ListFunctionalRoleMemberReq, options ...larkcore.RequestOptionFunc) (*ListFunctionalRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -745,9 +745,9 @@ func (f *functionalRoleMember) ListByIterator(ctx context.Context, req *ListFunc // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=scopes&project=contact&resource=functional_role.member&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=scopes&project=contact&resource=functional_role.member&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/scopes_functionalRoleMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/scopes_functionalRoleMember.go func (f *functionalRoleMember) Scopes(ctx context.Context, req *ScopesFunctionalRoleMemberReq, options ...larkcore.RequestOptionFunc) (*ScopesFunctionalRoleMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -769,11 +769,11 @@ func (f *functionalRoleMember) Scopes(ctx context.Context, req *ScopesFunctional // 创建用户组 // -// - 使用该接口创建用户组，请注意创建用户组时应用的通讯录权限范围需为“全部员工”，否则会创建失败，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 使用该接口创建用户组，请注意创建用户组时应用的通讯录权限范围需为 “全部员工”，否则会创建失败，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_group.go func (g *group) Create(ctx context.Context, req *CreateGroupReq, options ...larkcore.RequestOptionFunc) (*CreateGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -795,11 +795,11 @@ func (g *group) Create(ctx context.Context, req *CreateGroupReq, options ...lark // 删除用户组 // -// - 通过该接口可删除企业中的用户组，请注意删除用户组时应用的通讯录权限范围需为“全部员工”，否则会删除失败，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 通过该接口可删除企业中的用户组，请注意删除用户组时应用的通讯录权限范围需为 “全部员工”，否则会删除失败，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_group.go func (g *group) Delete(ctx context.Context, req *DeleteGroupReq, options ...larkcore.RequestOptionFunc) (*DeleteGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -821,11 +821,11 @@ func (g *group) Delete(ctx context.Context, req *DeleteGroupReq, options ...lark // 查询用户组 // -// - 根据用户组 ID 查询某个用户组的基本信息，支持查询普通用户组和动态用户组。请确保应用的通讯录权限范围里包括该用户组或者是“全部员工”，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 根据用户组 ID 查询某个用户组的基本信息，支持查询普通用户组和动态用户组。请确保应用的通讯录权限范围里包括该用户组或者是 “全部员工”，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_group.go func (g *group) Get(ctx context.Context, req *GetGroupReq, options ...larkcore.RequestOptionFunc) (*GetGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -847,11 +847,11 @@ func (g *group) Get(ctx context.Context, req *GetGroupReq, options ...larkcore.R // 查询用户所属用户组 // -// - 通过该接口可查询该用户所属的用户组列表，可分别查询普通用户组和动态用户组。如果应用的通讯录权限范围是“全部员工”，则可获取该员工所属的全部用户组列表。如果应用的通讯录权限范围不是“全部员工”，则仅可获取通讯录权限范围内该员工所属的用户组。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 通过该接口可查询该用户所属的用户组列表，可分别查询普通用户组和动态用户组。如果应用的通讯录权限范围是 “全部员工”，则可获取该员工所属的全部用户组列表。如果应用的通讯录权限范围不是 “全部员工”，则仅可获取通讯录权限范围内该员工所属的用户组。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/member_belong +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/member_belong // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/memberBelong_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/memberBelong_group.go func (g *group) MemberBelong(ctx context.Context, req *MemberBelongGroupReq, options ...larkcore.RequestOptionFunc) (*MemberBelongGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -873,11 +873,11 @@ func (g *group) MemberBelong(ctx context.Context, req *MemberBelongGroupReq, opt // 更新用户组 // -// - 使用该接口更新用户组信息，请注意更新用户组时应用的通讯录权限范围需为“全部员工”，否则会更新失败。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 使用该接口更新用户组信息，请注意更新用户组时应用的通讯录权限范围需为 “全部员工”，否则会更新失败。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_group.go func (g *group) Patch(ctx context.Context, req *PatchGroupReq, options ...larkcore.RequestOptionFunc) (*PatchGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -899,11 +899,11 @@ func (g *group) Patch(ctx context.Context, req *PatchGroupReq, options ...larkco // 查询用户组列表 // -// - 通过该接口可查询企业的用户组列表，可分别查询普通用户组或动态用户组。如果应用的通讯录权限范围是“全部员工”，则可获取企业全部用户组列表。如果应用的通讯录权限范围不是“全部员工”，则仅可获取通讯录权限范围内的用户组。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 通过该接口可查询企业的用户组列表，可分别查询普通用户组或动态用户组。如果应用的通讯录权限范围是 “全部员工”，则可获取企业全部用户组列表。如果应用的通讯录权限范围不是 “全部员工”，则仅可获取通讯录权限范围内的用户组。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/simplelist +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group/simplelist // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/simplelist_group.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/simplelist_group.go func (g *group) Simplelist(ctx context.Context, req *SimplelistGroupReq, options ...larkcore.RequestOptionFunc) (*SimplelistGroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -933,11 +933,11 @@ func (g *group) SimplelistByIterator(ctx context.Context, req *SimplelistGroupRe // 添加用户组成员 // -// - 向用户组中添加成员(目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是“全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 向用户组中添加成员 (目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是 “全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/add +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/add // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/add_groupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/add_groupMember.go func (g *groupMember) Add(ctx context.Context, req *AddGroupMemberReq, options ...larkcore.RequestOptionFunc) (*AddGroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -959,13 +959,13 @@ func (g *groupMember) Add(ctx context.Context, req *AddGroupMemberReq, options . // 批量添加用户组成员 // -// - 向普通用户组中批量添加成员(目前仅支持添加用户，暂不支持添加部门），如果应用的通讯录权限范围是“全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 向普通用户组中批量添加成员 (目前仅支持添加用户，暂不支持添加部门），如果应用的通讯录权限范围是 “全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 请求体中的member_type，目前仅支持user， 未来将支持department。 +// - 请求体中的 member_type，目前仅支持 user， 未来将支持 department。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/batch_add +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/batch_add // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchAdd_groupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchAdd_groupMember.go func (g *groupMember) BatchAdd(ctx context.Context, req *BatchAddGroupMemberReq, options ...larkcore.RequestOptionFunc) (*BatchAddGroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -987,13 +987,13 @@ func (g *groupMember) BatchAdd(ctx context.Context, req *BatchAddGroupMemberReq, // 批量移除用户组成员 // -// - 从普通用户组中批量移除成员 (目前仅支持移除用户，暂不支持移除部门）。如果应用的通讯录权限范围是“全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 从普通用户组中批量移除成员 (目前仅支持移除用户，暂不支持移除部门）。如果应用的通讯录权限范围是 “全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 请求体中的member_type，目前仅支持user， 未来将支持department。 +// - 请求体中的 member_type，目前仅支持 user， 未来将支持 department。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/batch_remove +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/batch_remove // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchRemove_groupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchRemove_groupMember.go func (g *groupMember) BatchRemove(ctx context.Context, req *BatchRemoveGroupMemberReq, options ...larkcore.RequestOptionFunc) (*BatchRemoveGroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1015,11 +1015,11 @@ func (g *groupMember) BatchRemove(ctx context.Context, req *BatchRemoveGroupMemb // 移除用户组成员 // -// - 从用户组中移除成员 (目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是“全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 从用户组中移除成员 (目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是 “全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/remove +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/remove // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/remove_groupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/remove_groupMember.go func (g *groupMember) Remove(ctx context.Context, req *RemoveGroupMemberReq, options ...larkcore.RequestOptionFunc) (*RemoveGroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1041,11 +1041,11 @@ func (g *groupMember) Remove(ctx context.Context, req *RemoveGroupMemberReq, opt // 查询用户组成员列表 // -// - 通过该接口可查询某个用户组的成员列表（支持查询成员中的用户和部门）, 本接口支持普通用户组和动态用户组。如果应用的通讯录权限范围是“全部员工”，则可查询企业内任何用户组的成员列表。如果应用的通讯录权限范围不是“全部员工”，则仅可查询通讯录权限范围中的用户组的成员列表，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// - 通过该接口可查询某个用户组的成员列表（支持查询成员中的用户和部门），本接口支持普通用户组和动态用户组。如果应用的通讯录权限范围是 “全部员工”，则可查询企业内任何用户组的成员列表。如果应用的通讯录权限范围不是 “全部员工”，则仅可查询通讯录权限范围中的用户组的成员列表，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/simplelist +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/group-member/simplelist // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/simplelist_groupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/simplelist_groupMember.go func (g *groupMember) Simplelist(ctx context.Context, req *SimplelistGroupMemberReq, options ...larkcore.RequestOptionFunc) (*SimplelistGroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1069,9 +1069,9 @@ func (g *groupMember) Simplelist(ctx context.Context, req *SimplelistGroupMember // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=contact&resource=job_family&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=contact&resource=job_family&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_jobFamily.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_jobFamily.go func (j *jobFamily) Create(ctx context.Context, req *CreateJobFamilyReq, options ...larkcore.RequestOptionFunc) (*CreateJobFamilyResp, error) { // 发起请求 apiReq := req.apiReq @@ -1095,9 +1095,9 @@ func (j *jobFamily) Create(ctx context.Context, req *CreateJobFamilyReq, options // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete&project=contact&resource=job_family&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete&project=contact&resource=job_family&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_jobFamily.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_jobFamily.go func (j *jobFamily) Delete(ctx context.Context, req *DeleteJobFamilyReq, options ...larkcore.RequestOptionFunc) (*DeleteJobFamilyResp, error) { // 发起请求 apiReq := req.apiReq @@ -1121,9 +1121,9 @@ func (j *jobFamily) Delete(ctx context.Context, req *DeleteJobFamilyReq, options // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=contact&resource=job_family&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=contact&resource=job_family&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_jobFamily.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_jobFamily.go func (j *jobFamily) Get(ctx context.Context, req *GetJobFamilyReq, options ...larkcore.RequestOptionFunc) (*GetJobFamilyResp, error) { // 发起请求 apiReq := req.apiReq @@ -1147,9 +1147,9 @@ func (j *jobFamily) Get(ctx context.Context, req *GetJobFamilyReq, options ...la // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=job_family&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=job_family&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_jobFamily.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_jobFamily.go func (j *jobFamily) List(ctx context.Context, req *ListJobFamilyReq, options ...larkcore.RequestOptionFunc) (*ListJobFamilyResp, error) { // 发起请求 apiReq := req.apiReq @@ -1181,9 +1181,9 @@ func (j *jobFamily) ListByIterator(ctx context.Context, req *ListJobFamilyReq, o // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=contact&resource=job_family&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=contact&resource=job_family&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_jobFamily.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_jobFamily.go func (j *jobFamily) Update(ctx context.Context, req *UpdateJobFamilyReq, options ...larkcore.RequestOptionFunc) (*UpdateJobFamilyResp, error) { // 发起请求 apiReq := req.apiReq @@ -1207,9 +1207,9 @@ func (j *jobFamily) Update(ctx context.Context, req *UpdateJobFamilyReq, options // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=contact&resource=job_level&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=contact&resource=job_level&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_jobLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_jobLevel.go func (j *jobLevel) Create(ctx context.Context, req *CreateJobLevelReq, options ...larkcore.RequestOptionFunc) (*CreateJobLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1233,9 +1233,9 @@ func (j *jobLevel) Create(ctx context.Context, req *CreateJobLevelReq, options . // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete&project=contact&resource=job_level&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete&project=contact&resource=job_level&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_jobLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_jobLevel.go func (j *jobLevel) Delete(ctx context.Context, req *DeleteJobLevelReq, options ...larkcore.RequestOptionFunc) (*DeleteJobLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1259,9 +1259,9 @@ func (j *jobLevel) Delete(ctx context.Context, req *DeleteJobLevelReq, options . // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=contact&resource=job_level&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=contact&resource=job_level&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_jobLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_jobLevel.go func (j *jobLevel) Get(ctx context.Context, req *GetJobLevelReq, options ...larkcore.RequestOptionFunc) (*GetJobLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1285,9 +1285,9 @@ func (j *jobLevel) Get(ctx context.Context, req *GetJobLevelReq, options ...lark // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=job_level&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=job_level&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_jobLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_jobLevel.go func (j *jobLevel) List(ctx context.Context, req *ListJobLevelReq, options ...larkcore.RequestOptionFunc) (*ListJobLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1319,9 +1319,9 @@ func (j *jobLevel) ListByIterator(ctx context.Context, req *ListJobLevelReq, opt // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=contact&resource=job_level&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=contact&resource=job_level&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_jobLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_jobLevel.go func (j *jobLevel) Update(ctx context.Context, req *UpdateJobLevelReq, options ...larkcore.RequestOptionFunc) (*UpdateJobLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1345,9 +1345,9 @@ func (j *jobLevel) Update(ctx context.Context, req *UpdateJobLevelReq, options . // // - 该接口用于获取应用被授权可访问的通讯录范围，包括可访问的部门列表、用户列表和用户组列表。;授权范围为全员时，返回的部门列表为该企业所有的一级部门；否则返回的部门为管理员在设置授权范围时勾选的部门（不包含勾选部门的子部门）。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/scope/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/scope/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_scope.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_scope.go func (s *scope) List(ctx context.Context, req *ListScopeReq, options ...larkcore.RequestOptionFunc) (*ListScopeResp, error) { // 发起请求 apiReq := req.apiReq @@ -1369,11 +1369,11 @@ func (s *scope) List(ctx context.Context, req *ListScopeReq, options ...larkcore // 建立部门与单位的绑定关系 // -// - 通过该接口建立部门与单位的绑定关系。由于单位是旗舰版付费功能，企业需开通相关版本，否则会绑定失败，不同版本请参考[飞书版本对比](https://www.feishu.cn/service) +// - 通过该接口建立部门与单位的绑定关系。由于单位是旗舰版付费功能，企业需开通相关版本，否则会绑定失败，不同版本请参考 [飞书版本对比](https://www.feishu.cn/service) // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/bind_department +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/bind_department // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/bindDepartment_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/bindDepartment_unit.go func (u *unit) BindDepartment(ctx context.Context, req *BindDepartmentUnitReq, options ...larkcore.RequestOptionFunc) (*BindDepartmentUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1395,11 +1395,11 @@ func (u *unit) BindDepartment(ctx context.Context, req *BindDepartmentUnitReq, o // 创建单位 // -// - 该接口用于创建单位。注意：单位功能属于旗舰版付费功能，企业需开通对应版本才可以创建单位，不同版本请参考[飞书版本对比](https://www.feishu.cn/service)。 +// - 该接口用于创建单位。注意：单位功能属于旗舰版付费功能，企业需开通对应版本才可以创建单位，不同版本请参考 [飞书版本对比](https://www.feishu.cn/service)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_unit.go func (u *unit) Create(ctx context.Context, req *CreateUnitReq, options ...larkcore.RequestOptionFunc) (*CreateUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1423,9 +1423,9 @@ func (u *unit) Create(ctx context.Context, req *CreateUnitReq, options ...larkco // // - 使用该接口删除单位，需要有更新单位的权限。注意：如果单位的单位类型被其它的业务使用，不允许删除。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_unit.go func (u *unit) Delete(ctx context.Context, req *DeleteUnitReq, options ...larkcore.RequestOptionFunc) (*DeleteUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1449,9 +1449,9 @@ func (u *unit) Delete(ctx context.Context, req *DeleteUnitReq, options ...larkco // // - 该接口用于获取单位信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_unit.go func (u *unit) Get(ctx context.Context, req *GetUnitReq, options ...larkcore.RequestOptionFunc) (*GetUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1475,9 +1475,9 @@ func (u *unit) Get(ctx context.Context, req *GetUnitReq, options ...larkcore.Req // // - 通过该接口获取企业的单位列表，需获取单位的权限 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_unit.go func (u *unit) List(ctx context.Context, req *ListUnitReq, options ...larkcore.RequestOptionFunc) (*ListUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1501,9 +1501,9 @@ func (u *unit) List(ctx context.Context, req *ListUnitReq, options ...larkcore.R // // - 通过该接口获取单位绑定的部门列表，需具有获取单位的权限 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/list_department +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/list_department // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/listDepartment_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/listDepartment_unit.go func (u *unit) ListDepartment(ctx context.Context, req *ListDepartmentUnitReq, options ...larkcore.RequestOptionFunc) (*ListDepartmentUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1527,9 +1527,9 @@ func (u *unit) ListDepartment(ctx context.Context, req *ListDepartmentUnitReq, o // // - 调用该接口，需要有更新单位的权限。注意：单位功能属于旗舰版付费功能，企业需开通对应版本才可以修改单位 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_unit.go func (u *unit) Patch(ctx context.Context, req *PatchUnitReq, options ...larkcore.RequestOptionFunc) (*PatchUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1553,9 +1553,9 @@ func (u *unit) Patch(ctx context.Context, req *PatchUnitReq, options ...larkcore // // - 通过该接口解除部门与单位的绑定关系，需更新单位的权限，需对应部门的通讯录权限。由于单位是旗舰版付费功能，企业需开通相关功能，否则会解绑失败 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/unbind_department +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/unit/unbind_department // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/unbindDepartment_unit.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/unbindDepartment_unit.go func (u *unit) UnbindDepartment(ctx context.Context, req *UnbindDepartmentUnitReq, options ...larkcore.RequestOptionFunc) (*UnbindDepartmentUnitResp, error) { // 发起请求 apiReq := req.apiReq @@ -1579,11 +1579,11 @@ func (u *unit) UnbindDepartment(ctx context.Context, req *UnbindDepartmentUnitRe // // - 通过该接口，可使用手机号/邮箱获取用户的 ID 信息，具体获取支持的 ID 类型包括 open_id、user_id、union_id，可通过查询参数指定。 // -// - 如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则返回的用户ID列表为空。 +// - 如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则返回的用户 ID 列表为空。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchGetId_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/batchGetId_user.go func (u *user) BatchGetId(ctx context.Context, req *BatchGetIdUserReq, options ...larkcore.RequestOptionFunc) (*BatchGetIdUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1605,13 +1605,13 @@ func (u *user) BatchGetId(ctx context.Context, req *BatchGetIdUserReq, options . // 创建用户 // -// - 使用该接口向通讯录创建一个用户，可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。 +// - 使用该接口向通讯录创建一个用户，可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。 // // - - 新增用户的所有部门必须都在当前应用的通讯录授权范围内才允许新增用户，如果想要在根部门下新增用户，必须要有全员权限。;- 应用商店应用无权限调用此接口。;- 创建用户后，会给用户发送邀请短信/邮件，用户在操作同意后才可访问团队。;- 返回数据中不返回手机号，如果需要请重新查询用户信息获取手机号。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/create_user.go func (u *user) Create(ctx context.Context, req *CreateUserReq, options ...larkcore.RequestOptionFunc) (*CreateUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1635,11 +1635,11 @@ func (u *user) Create(ctx context.Context, req *CreateUserReq, options ...larkco // // - 该接口用于从通讯录删除一个用户信息，可以理解为员工离职。 // -// - - 若用户归属部门A、部门B，应用的通讯录权限范围必须包括部门A和部门B才可以删除用户。;- 用户可以在删除员工时设置删除员工数据（如文档）的接收者，如果不设置则由其leader接收，如果该员工没有leader，则会将该员工的数据删除。 +// - - 若用户归属部门 A、部门 B，应用的通讯录权限范围必须包括部门 A 和部门 B 才可以删除用户。;- 用户可以在删除员工时设置删除员工数据（如文档）的接收者，如果不设置则由其 leader 接收，如果该员工没有 leader，则会将该员工的数据删除。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/delete_user.go func (u *user) Delete(ctx context.Context, req *DeleteUserReq, options ...larkcore.RequestOptionFunc) (*DeleteUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1661,13 +1661,13 @@ func (u *user) Delete(ctx context.Context, req *DeleteUserReq, options ...larkco // 获取部门直属用户列表 // -// - 基于部门ID获取部门直属用户列表。 +// - 基于部门 ID 获取部门直属用户列表。 // -// - - 部门ID 必填，根部门的部门ID为0。;- 使用 `user_access_token` 情况下根据个人组织架构的通讯录可见范围进行权限过滤，返回个人组织架构通讯录范围（[登录企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility)）内可见的用户数据。;- 使用`tenant_access_token`会根据应用通讯录的范围进行权限过滤。 如果请求的部门ID为0，则校验应用是否具有全员通讯录权限； 如果是非0的部门ID，则会验证应用是否具有该部门的通讯录权限。 无权限返回无权限错误码，有权限则返回对应部门下的直接用户列表。 +// - - 部门 ID 必填，根部门的部门 ID 为 0。;- 使用 `user_access_token` 情况下根据个人组织架构的通讯录可见范围进行权限过滤，返回个人组织架构通讯录范围（[登录企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility)）内可见的用户数据。;- 使用`tenant_access_token`会根据应用通讯录的范围进行权限过滤。 如果请求的部门 ID 为 0，则校验应用是否具有全员通讯录权限； 如果是非 0 的部门 ID，则会验证应用是否具有该部门的通讯录权限。 无权限返回无权限错误码，有权限则返回对应部门下的直接用户列表。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/find_by_department +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/find_by_department // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/findByDepartment_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/findByDepartment_user.go func (u *user) FindByDepartment(ctx context.Context, req *FindByDepartmentUserReq, options ...larkcore.RequestOptionFunc) (*FindByDepartmentUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1699,9 +1699,9 @@ func (u *user) FindByDepartmentByIterator(ctx context.Context, req *FindByDepart // // - 该接口用于获取通讯录中单个用户的信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/get_user.go func (u *user) Get(ctx context.Context, req *GetUserReq, options ...larkcore.RequestOptionFunc) (*GetUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1725,9 +1725,9 @@ func (u *user) Get(ctx context.Context, req *GetUserReq, options ...larkcore.Req // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=user&version=v3 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=user&version=v3 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/list_user.go func (u *user) List(ctx context.Context, req *ListUserReq, options ...larkcore.RequestOptionFunc) (*ListUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1759,9 +1759,9 @@ func (u *user) ListByIterator(ctx context.Context, req *ListUserReq, options ... // // - 该接口用于更新通讯录中用户的字段，未传递的参数不会更新。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/patch_user.go func (u *user) Patch(ctx context.Context, req *PatchUserReq, options ...larkcore.RequestOptionFunc) (*PatchUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1787,9 +1787,9 @@ func (u *user) Patch(ctx context.Context, req *PatchUserReq, options ...larkcore // // - 应用需要拥有待更新用户的通讯录授权，如果涉及到用户部门变更，还需要同时拥有变更前、后所有新部门的通讯录授权。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/contactv3/update_user.go func (u *user) Update(ctx context.Context, req *UpdateUserReq, options ...larkcore.RequestOptionFunc) (*UpdateUserResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/contact/v3/event.go b/service/contact/v3/event.go index 984613a1..6ff8fc21 100644 --- a/service/contact/v3/event.go +++ b/service/contact/v3/event.go @@ -32,7 +32,7 @@ func (h *P2CustomAttrEventUpdatedV3Handler) Event() interface{} { return &P2CustomAttrEventUpdatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2CustomAttrEventUpdatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2CustomAttrEventUpdatedV3)) } @@ -52,7 +52,7 @@ func (h *P2DepartmentCreatedV3Handler) Event() interface{} { return &P2DepartmentCreatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2DepartmentCreatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2DepartmentCreatedV3)) } @@ -72,7 +72,7 @@ func (h *P2DepartmentDeletedV3Handler) Event() interface{} { return &P2DepartmentDeletedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2DepartmentDeletedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2DepartmentDeletedV3)) } @@ -92,7 +92,7 @@ func (h *P2DepartmentUpdatedV3Handler) Event() interface{} { return &P2DepartmentUpdatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2DepartmentUpdatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2DepartmentUpdatedV3)) } @@ -112,7 +112,7 @@ func (h *P2EmployeeTypeEnumActivedV3Handler) Event() interface{} { return &P2EmployeeTypeEnumActivedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2EmployeeTypeEnumActivedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2EmployeeTypeEnumActivedV3)) } @@ -132,7 +132,7 @@ func (h *P2EmployeeTypeEnumCreatedV3Handler) Event() interface{} { return &P2EmployeeTypeEnumCreatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2EmployeeTypeEnumCreatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2EmployeeTypeEnumCreatedV3)) } @@ -152,7 +152,7 @@ func (h *P2EmployeeTypeEnumDeactivatedV3Handler) Event() interface{} { return &P2EmployeeTypeEnumDeactivatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2EmployeeTypeEnumDeactivatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2EmployeeTypeEnumDeactivatedV3)) } @@ -172,7 +172,7 @@ func (h *P2EmployeeTypeEnumDeletedV3Handler) Event() interface{} { return &P2EmployeeTypeEnumDeletedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2EmployeeTypeEnumDeletedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2EmployeeTypeEnumDeletedV3)) } @@ -192,7 +192,7 @@ func (h *P2EmployeeTypeEnumUpdatedV3Handler) Event() interface{} { return &P2EmployeeTypeEnumUpdatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2EmployeeTypeEnumUpdatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2EmployeeTypeEnumUpdatedV3)) } @@ -212,7 +212,7 @@ func (h *P2ScopeUpdatedV3Handler) Event() interface{} { return &P2ScopeUpdatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ScopeUpdatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ScopeUpdatedV3)) } @@ -232,7 +232,7 @@ func (h *P2UserCreatedV3Handler) Event() interface{} { return &P2UserCreatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2UserCreatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2UserCreatedV3)) } @@ -252,7 +252,7 @@ func (h *P2UserDeletedV3Handler) Event() interface{} { return &P2UserDeletedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2UserDeletedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2UserDeletedV3)) } @@ -272,7 +272,7 @@ func (h *P2UserUpdatedV3Handler) Event() interface{} { return &P2UserUpdatedV3{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2UserUpdatedV3Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2UserUpdatedV3)) } diff --git a/service/contact/v3/ext_model.go b/service/contact/v3/ext_model.go index 1e1e1933..3c8f9217 100644 --- a/service/contact/v3/ext_model.go +++ b/service/contact/v3/ext_model.go @@ -16,11 +16,11 @@ import larkevent "github.com/larksuite/oapi-sdk-go/v3/event" type P1UserChangedV3Data struct { Type string `json:"type"` // 事件类型 - AppID string `json:"app_id"` // 应用ID + AppID string `json:"app_id"` // 应用 ID TenantKey string `json:"tenant_key"` // 企业标识 - OpenID string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 - EmployeeId string `json:"employee_id"` // 即“用户ID”，仅企业自建应用会返回 - UnionId string `json:"union_id,omitempty"` // 员工对此ISV的唯一标识，同一员工对同一个ISV名下所有应用的union_id相同 + OpenID string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 + EmployeeId string `json:"employee_id"` // 即 “用户 ID”，仅企业自建应用会返回 + UnionId string `json:"union_id,omitempty"` // 员工对此 ISV 的唯一标识，同一员工对同一个 ISV 名下所有应用的 union_id 相同 } type P1UserChangedV3 struct { @@ -40,11 +40,11 @@ type P1UserStatusV3 struct { } type P1UserStatusChangedV3Data struct { Type string `json:"type"` // 事件类型 - AppID string `json:"app_id"` // 应用ID + AppID string `json:"app_id"` // 应用 ID TenantKey string `json:"tenant_key"` // 企业标识 - OpenID string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 - EmployeeId string `json:"employee_id"` // 即“用户ID”，仅企业自建应用会返回 - UnionId string `json:"union_id,omitempty"` // 员工对此ISV的唯一标识，同一员工对同一个ISV名下所有应用的union_id相同 + OpenID string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 + EmployeeId string `json:"employee_id"` // 即 “用户 ID”，仅企业自建应用会返回 + UnionId string `json:"union_id,omitempty"` // 员工对此 ISV 的唯一标识，同一员工对同一个 ISV 名下所有应用的 union_id 相同 BeforeStatus *P1UserStatusV3 `json:"before_status"` // 变化前的状态 CurrentStatus *P1UserStatusV3 `json:"current_status"` // 变化后的状态 ChangeTime string `json:"change_time"` // 状态更新的时间 @@ -62,10 +62,10 @@ func (m *P1UserStatusChangedV3) RawReq(req *larkevent.EventReq) { type P1DepartmentChangedV3Data struct { Type string `json:"type"` // 事件类型，包括 dept_add, dept_update, dept_delete - AppID string `json:"app_id"` // 应用ID + AppID string `json:"app_id"` // 应用 ID TenantKey string `json:"tenant_key"` // 企业标识 - OpenID string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 - OpenDepartmentId string `json:"open_department_id"` // 部门的Id，已废弃 + OpenID string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 + OpenDepartmentId string `json:"open_department_id"` // 部门的 Id，已废弃 } type P1DepartmentChangedV3 struct { @@ -80,7 +80,7 @@ func (m *P1DepartmentChangedV3) RawReq(req *larkevent.EventReq) { type P1ContactScopeChangedV3Data struct { Type string `json:"type"` // 事件类型 - AppID string `json:"app_id"` // 应用ID + AppID string `json:"app_id"` // 应用 ID TenantKey string `json:"tenant_key"` //企业标识 } diff --git a/service/contact/v3/model.go b/service/contact/v3/model.go index 0cca33b2..ec99eae0 100644 --- a/service/contact/v3/model.go +++ b/service/contact/v3/model.go @@ -25,74 +25,74 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeCreateDepartmentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateDepartmentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateDepartmentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateDepartmentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateDepartmentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateDepartmentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeCreateDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeCreateDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeCreateDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeCreateDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - DepartmentIdTypeDeleteDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeDeleteDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeDeleteDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeDeleteDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeGetDepartmentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetDepartmentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetDepartmentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetDepartmentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetDepartmentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetDepartmentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeGetDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeGetDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeGetDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeGetDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeListDepartmentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListDepartmentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListDepartmentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListDepartmentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListDepartmentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListDepartmentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeListDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeParentDepartmentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeParentDepartmentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeParentDepartmentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeParentDepartmentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeParentDepartmentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeParentDepartmentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeParentDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeParentDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeParentDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeParentDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypePatchDepartmentUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchDepartmentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchDepartmentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchDepartmentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchDepartmentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchDepartmentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypePatchDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypePatchDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypePatchDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypePatchDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -107,19 +107,19 @@ const ( ) const ( - DepartmentIdTypeUnbindDepartmentChatDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeUnbindDepartmentChatDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeUnbindDepartmentChatDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeUnbindDepartmentChatDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeUpdateDepartmentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateDepartmentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateDepartmentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateDepartmentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateDepartmentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateDepartmentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeUpdateDepartmentDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeUpdateDepartmentOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeUpdateDepartmentDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeUpdateDepartmentOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -147,48 +147,48 @@ const ( ) const ( - RoleMemberIDTypeOpenId = "open_id" // 用户的open_id - RoleMemberIDTypeUnionId = "union_id" // 用户的union_id - RoleMemberIDTypeUserId = "user_id" // 用户的user_id + RoleMemberIDTypeOpenId = "open_id" // 用户的 open_id + RoleMemberIDTypeUnionId = "union_id" // 用户的 union_id + RoleMemberIDTypeUserId = "user_id" // 用户的 user_id ) const ( - RoleMemberIDTypeBatchDeleteFunctionalRoleMemberOpenId = "open_id" // 用户的open_id - RoleMemberIDTypeBatchDeleteFunctionalRoleMemberUnionId = "union_id" // 用户的user_id - RoleMemberIDTypeBatchDeleteFunctionalRoleMemberUserId = "user_id" // 用户的user_id + RoleMemberIDTypeBatchDeleteFunctionalRoleMemberOpenId = "open_id" // 用户的 open_id + RoleMemberIDTypeBatchDeleteFunctionalRoleMemberUnionId = "union_id" // 用户的 user_id + RoleMemberIDTypeBatchDeleteFunctionalRoleMemberUserId = "user_id" // 用户的 user_id ) const ( - RoleMemberIDTypeGetFunctionalRoleMemberOpenId = "open_id" // 用户的open_id - RoleMemberIDTypeGetFunctionalRoleMemberUnionId = "union_id" // 用户的union_id - RoleMemberIDTypeGetFunctionalRoleMemberUserId = "user_id" // 用户的user_id + RoleMemberIDTypeGetFunctionalRoleMemberOpenId = "open_id" // 用户的 open_id + RoleMemberIDTypeGetFunctionalRoleMemberUnionId = "union_id" // 用户的 union_id + RoleMemberIDTypeGetFunctionalRoleMemberUserId = "user_id" // 用户的 user_id ) const ( - RoleMemberScopeIDTypeDepartmentId = "department_id" // 以自定义department_id来标识部门 - RoleMemberScopeIDTypeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + RoleMemberScopeIDTypeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + RoleMemberScopeIDTypeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - RoleMemberIDTypeListFunctionalRoleMemberOpenId = "open_id" // 用户的open_id - RoleMemberIDTypeListFunctionalRoleMemberUnionId = "union_id" // 用户的union_id - RoleMemberIDTypeListFunctionalRoleMemberUserId = "user_id" // 用户的user_id + RoleMemberIDTypeListFunctionalRoleMemberOpenId = "open_id" // 用户的 open_id + RoleMemberIDTypeListFunctionalRoleMemberUnionId = "union_id" // 用户的 union_id + RoleMemberIDTypeListFunctionalRoleMemberUserId = "user_id" // 用户的 user_id ) const ( - RoleMemberScopeIDTypeListFunctionalRoleMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - RoleMemberScopeIDTypeListFunctionalRoleMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + RoleMemberScopeIDTypeListFunctionalRoleMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + RoleMemberScopeIDTypeListFunctionalRoleMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - RoleMemberIDTypeScopesFunctionalRoleMemberOpenId = "open_id" // 用户的open_id - RoleMemberIDTypeScopesFunctionalRoleMemberUnionId = "union_id" // 用户的union_id - RoleMemberIDTypeScopesFunctionalRoleMemberUserId = "user_id" // 用户的user_id + RoleMemberIDTypeScopesFunctionalRoleMemberOpenId = "open_id" // 用户的 open_id + RoleMemberIDTypeScopesFunctionalRoleMemberUnionId = "union_id" // 用户的 union_id + RoleMemberIDTypeScopesFunctionalRoleMemberUserId = "user_id" // 用户的 user_id ) const ( - RoleMemberScopeIDTypeScopesFunctionalRoleMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - RoleMemberScopeIDTypeScopesFunctionalRoleMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + RoleMemberScopeIDTypeScopesFunctionalRoleMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + RoleMemberScopeIDTypeScopesFunctionalRoleMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -219,9 +219,9 @@ const ( ) const ( - MemberIdTypeAddGroupMemberOpenID = "open_id" // member_type =user时候，表示用户的open_id - MemberIdTypeAddGroupMemberUnionID = "union_id" // member_type =user时候，表示用户的union_id - MemberIdTypeAddGroupMemberUserID = "user_id" // member_type =user时候，表示用户的user_id + MemberIdTypeAddGroupMemberOpenID = "open_id" // member_type =user 时候，表示用户的 open_id + MemberIdTypeAddGroupMemberUnionID = "union_id" // member_type =user 时候，表示用户的 union_id + MemberIdTypeAddGroupMemberUserID = "user_id" // member_type =user 时候，表示用户的 user_id ) const ( @@ -229,16 +229,16 @@ const ( ) const ( - MemberIdTypeRemoveGroupMemberOpenID = "open_id" // member_type =user时候，表示用户的open_id - MemberIdTypeRemoveGroupMemberUnionID = "union_id" // member_type =user时候，表示用户的union_id - MemberIdTypeRemoveGroupMemberUserID = "user_id" // member_type =user时候，表示用户的user_id + MemberIdTypeRemoveGroupMemberOpenID = "open_id" // member_type =user 时候，表示用户的 open_id + MemberIdTypeRemoveGroupMemberUnionID = "union_id" // member_type =user 时候，表示用户的 union_id + MemberIdTypeRemoveGroupMemberUserID = "user_id" // member_type =user 时候，表示用户的 user_id ) const ( - MemberIdTypeSimplelistGroupMemberOpenId = "open_id" // member_type=user时候，表示用户的open_id；member_type=department时候，表示部门的open_id - MemberIdTypeSimplelistGroupMemberUnionId = "union_id" // member_type=user时候，表示用户的union_id - MemberIdTypeSimplelistGroupMemberUserId = "user_id" // member_type=user时候，表示用户的user_id - MemberIdTypeSimplelistGroupMemberDepartmentId = "department_id" // member_type=department时候，表示部门的department_id + MemberIdTypeSimplelistGroupMemberOpenId = "open_id" // member_type=user 时候，表示用户的 open_id；member_type=department 时候，表示部门的 open_id + MemberIdTypeSimplelistGroupMemberUnionId = "union_id" // member_type=user 时候，表示用户的 union_id + MemberIdTypeSimplelistGroupMemberUserId = "user_id" // member_type=user 时候，表示用户的 user_id + MemberIdTypeSimplelistGroupMemberDepartmentId = "department_id" // member_type=department 时候，表示部门的 department_id ) const ( @@ -253,23 +253,23 @@ const ( ) const ( - DepartmentIdTypeListScopeDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListScopeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListScopeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListScopeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - DepartmentIdTypeBindDepartmentUnitDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeBindDepartmentUnitOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeBindDepartmentUnitDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeBindDepartmentUnitOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - DepartmentIdTypeListDepartmentUnitDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListDepartmentUnitOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListDepartmentUnitDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListDepartmentUnitOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - DepartmentIdTypeUnbindDepartmentUnitDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeUnbindDepartmentUnitOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeUnbindDepartmentUnitDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeUnbindDepartmentUnitOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -286,53 +286,53 @@ const ( ) const ( - UserIdTypeCreateUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeCreateUserDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeCreateUserOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeCreateUserDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeCreateUserOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeDeleteUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeDeleteUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeDeleteUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeDeleteUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeDeleteUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeDeleteUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeFindByDepartmentUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeFindByDepartmentUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeFindByDepartmentUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeFindByDepartmentUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeFindByDepartmentUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeFindByDepartmentUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeFindByDepartmentUserDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeFindByDepartmentUserOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeFindByDepartmentUserDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeFindByDepartmentUserOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeGetUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeGetUserDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeGetUserOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeGetUserDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeGetUserOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeListUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeListUserDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListUserOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListUserDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListUserOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -343,14 +343,14 @@ const ( ) const ( - UserIdTypePatchUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypePatchUserDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypePatchUserOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypePatchUserDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypePatchUserOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -361,29 +361,29 @@ const ( ) const ( - UserIdTypeUpdateUserUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateUserUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateUserOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateUserUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateUserUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateUserOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeUpdateUserDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeUpdateUserOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeUpdateUserDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeUpdateUserOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) type AvatarInfo struct { - Avatar72 *string `json:"avatar_72,omitempty"` // 72*72像素头像链接 - Avatar240 *string `json:"avatar_240,omitempty"` // 240*240像素头像链接 - Avatar640 *string `json:"avatar_640,omitempty"` // 640*640像素头像链接 + Avatar72 *string `json:"avatar_72,omitempty"` // 72*72 像素头像链接 + Avatar240 *string `json:"avatar_240,omitempty"` // 240*240 像素头像链接 + Avatar640 *string `json:"avatar_640,omitempty"` // 640*640 像素头像链接 AvatarOrigin *string `json:"avatar_origin,omitempty"` // 原始头像链接 } type AvatarInfoBuilder struct { - avatar72 string // 72*72像素头像链接 + avatar72 string // 72*72 像素头像链接 avatar72Flag bool - avatar240 string // 240*240像素头像链接 + avatar240 string // 240*240 像素头像链接 avatar240Flag bool - avatar640 string // 640*640像素头像链接 + avatar640 string // 640*640 像素头像链接 avatar640Flag bool avatarOrigin string // 原始头像链接 avatarOriginFlag bool @@ -394,7 +394,7 @@ func NewAvatarInfoBuilder() *AvatarInfoBuilder { return builder } -// 72*72像素头像链接 +// 72*72 像素头像链接 // // 示例值：https://foo.icon.com/xxxx func (builder *AvatarInfoBuilder) Avatar72(avatar72 string) *AvatarInfoBuilder { @@ -403,7 +403,7 @@ func (builder *AvatarInfoBuilder) Avatar72(avatar72 string) *AvatarInfoBuilder { return builder } -// 240*240像素头像链接 +// 240*240 像素头像链接 // // 示例值：https://foo.icon.com/xxxx func (builder *AvatarInfoBuilder) Avatar240(avatar240 string) *AvatarInfoBuilder { @@ -412,7 +412,7 @@ func (builder *AvatarInfoBuilder) Avatar240(avatar240 string) *AvatarInfoBuilder return builder } -// 640*640像素头像链接 +// 640*640 像素头像链接 // // 示例值：https://foo.icon.com/xxxx func (builder *AvatarInfoBuilder) Avatar640(avatar640 string) *AvatarInfoBuilder { @@ -452,16 +452,16 @@ func (builder *AvatarInfoBuilder) Build() *AvatarInfo { } type CollaborationTenant struct { - TenantKey *string `json:"tenant_key,omitempty"` // 关联租户ID + TenantKey *string `json:"tenant_key,omitempty"` // 关联租户 ID Name *string `json:"name,omitempty"` // 关联租户实际名称 Nickname *string `json:"nickname,omitempty"` // 别名 ConnectTime *int `json:"connect_time,omitempty"` // 关联时间 - Avatar *AvatarInfo `json:"avatar,omitempty"` // 租户icon信息 + Avatar *AvatarInfo `json:"avatar,omitempty"` // 租户 icon 信息 Brand *string `json:"brand,omitempty"` // 租户品牌 } type CollaborationTenantBuilder struct { - tenantKey string // 关联租户ID + tenantKey string // 关联租户 ID tenantKeyFlag bool name string // 关联租户实际名称 nameFlag bool @@ -469,7 +469,7 @@ type CollaborationTenantBuilder struct { nicknameFlag bool connectTime int // 关联时间 connectTimeFlag bool - avatar *AvatarInfo // 租户icon信息 + avatar *AvatarInfo // 租户 icon 信息 avatarFlag bool brand string // 租户品牌 brandFlag bool @@ -480,7 +480,7 @@ func NewCollaborationTenantBuilder() *CollaborationTenantBuilder { return builder } -// 关联租户ID +// 关联租户 ID // // 示例值：130426ba5b8f174f func (builder *CollaborationTenantBuilder) TenantKey(tenantKey string) *CollaborationTenantBuilder { @@ -516,7 +516,7 @@ func (builder *CollaborationTenantBuilder) ConnectTime(connectTime int) *Collabo return builder } -// 租户icon信息 +// 租户 icon 信息 // // 示例值： func (builder *CollaborationTenantBuilder) Avatar(avatar *AvatarInfo) *CollaborationTenantBuilder { @@ -563,12 +563,12 @@ func (builder *CollaborationTenantBuilder) Build() *CollaborationTenant { } type ConfidentialMember struct { - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID IsConfidential *bool `json:"is_confidential,omitempty"` // 是否机密 } type ConfidentialMemberBuilder struct { - userId string // 用户ID + userId string // 用户 ID userIdFlag bool isConfidential bool // 是否机密 isConfidentialFlag bool @@ -579,7 +579,7 @@ func NewConfidentialMemberBuilder() *ConfidentialMemberBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_ddbbb39b7b4a1a6366e6021f2efec495 func (builder *ConfidentialMemberBuilder) UserId(userId string) *ConfidentialMemberBuilder { @@ -611,18 +611,18 @@ func (builder *ConfidentialMemberBuilder) Build() *ConfidentialMember { } type CustomAttr struct { - Id *string `json:"id,omitempty"` // 自定义字段id + Id *string `json:"id,omitempty"` // 自定义字段 id Type *string `json:"type,omitempty"` // 自定义字段类型，可选值有:;- `TEXT`：纯文本，用于纯文本描述人员，如备注;- `HREF`：静态 URL，用于人员 Profile 跳转链接;- `ENUMERATION`：枚举，用于结构化描述人员，如民族;- `GENERIC_USER`：用户，用于描述人和人关系，如 HRBP;- `PICTURE_ENUM`：枚举图片，以结构化的图片描述人员，如在人员 Profile 展示荣誉徽章 - Options *CustomAttrOptions `json:"options,omitempty"` // 选项定义，当type为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项 + Options *CustomAttrOptions `json:"options,omitempty"` // 选项定义，当 type 为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项 I18nName []*I18nContent `json:"i18n_name,omitempty"` // 自定义字段的字段名称 } type CustomAttrBuilder struct { - id string // 自定义字段id + id string // 自定义字段 id idFlag bool type_ string // 自定义字段类型，可选值有:;- `TEXT`：纯文本，用于纯文本描述人员，如备注;- `HREF`：静态 URL，用于人员 Profile 跳转链接;- `ENUMERATION`：枚举，用于结构化描述人员，如民族;- `GENERIC_USER`：用户，用于描述人和人关系，如 HRBP;- `PICTURE_ENUM`：枚举图片，以结构化的图片描述人员，如在人员 Profile 展示荣誉徽章 typeFlag bool - options *CustomAttrOptions // 选项定义，当type为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项 + options *CustomAttrOptions // 选项定义，当 type 为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项 optionsFlag bool i18nName []*I18nContent // 自定义字段的字段名称 i18nNameFlag bool @@ -633,7 +633,7 @@ func NewCustomAttrBuilder() *CustomAttrBuilder { return builder } -// 自定义字段id +// 自定义字段 id // // 示例值：C-6965457429001748507 func (builder *CustomAttrBuilder) Id(id string) *CustomAttrBuilder { @@ -651,7 +651,7 @@ func (builder *CustomAttrBuilder) Type(type_ string) *CustomAttrBuilder { return builder } -// 选项定义，当type为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项 +// 选项定义，当 type 为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项 // // 示例值：{} func (builder *CustomAttrBuilder) Options(options *CustomAttrOptions) *CustomAttrBuilder { @@ -736,14 +736,14 @@ func (builder *CustomAttrEventBuilder) Build() *CustomAttrEvent { } type CustomAttrGenericUser struct { - Id *string `json:"id,omitempty"` // 用户的user_id ，具体参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - Type *int `json:"type,omitempty"` // 用户类型: ;1：用户;;目前固定为1，表示用户类型 + Id *string `json:"id,omitempty"` // 用户的 user_id ，具体参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + Type *int `json:"type,omitempty"` // 用户类型: ;1：用户;;目前固定为 1，表示用户类型 } type CustomAttrGenericUserBuilder struct { - id string // 用户的user_id ，具体参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + id string // 用户的 user_id ，具体参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) idFlag bool - type_ int // 用户类型: ;1：用户;;目前固定为1，表示用户类型 + type_ int // 用户类型: ;1：用户;;目前固定为 1，表示用户类型 typeFlag bool } @@ -752,7 +752,7 @@ func NewCustomAttrGenericUserBuilder() *CustomAttrGenericUserBuilder { return builder } -// 用户的user_id ，具体参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的 user_id ，具体参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：9b2fabg5 func (builder *CustomAttrGenericUserBuilder) Id(id string) *CustomAttrGenericUserBuilder { @@ -761,7 +761,7 @@ func (builder *CustomAttrGenericUserBuilder) Id(id string) *CustomAttrGenericUse return builder } -// 用户类型: ;1：用户;;目前固定为1，表示用户类型 +// 用户类型: ;1：用户;;目前固定为 1，表示用户类型 // // 示例值：1 func (builder *CustomAttrGenericUserBuilder) Type(type_ int) *CustomAttrGenericUserBuilder { @@ -784,17 +784,17 @@ func (builder *CustomAttrGenericUserBuilder) Build() *CustomAttrGenericUser { } type CustomAttrOption struct { - Id *string `json:"id,omitempty"` // 枚举类型选项id - Value *string `json:"value,omitempty"` // 枚举选项值，当option_type为`TEXT`为文本值，当option_type为`PICTURE`时为图片链接 - Name *string `json:"name,omitempty"` // 名称，仅option_type为PICTURE时有效 + Id *string `json:"id,omitempty"` // 枚举类型选项 id + Value *string `json:"value,omitempty"` // 枚举选项值，当 option_type 为`TEXT`为文本值，当 option_type 为`PICTURE`时为图片链接 + Name *string `json:"name,omitempty"` // 名称，仅 option_type 为 PICTURE 时有效 } type CustomAttrOptionBuilder struct { - id string // 枚举类型选项id + id string // 枚举类型选项 id idFlag bool - value string // 枚举选项值，当option_type为`TEXT`为文本值，当option_type为`PICTURE`时为图片链接 + value string // 枚举选项值，当 option_type 为`TEXT`为文本值，当 option_type 为`PICTURE`时为图片链接 valueFlag bool - name string // 名称，仅option_type为PICTURE时有效 + name string // 名称，仅 option_type 为 PICTURE 时有效 nameFlag bool } @@ -803,7 +803,7 @@ func NewCustomAttrOptionBuilder() *CustomAttrOptionBuilder { return builder } -// 枚举类型选项id +// 枚举类型选项 id // // 示例值：qasdefgr func (builder *CustomAttrOptionBuilder) Id(id string) *CustomAttrOptionBuilder { @@ -812,7 +812,7 @@ func (builder *CustomAttrOptionBuilder) Id(id string) *CustomAttrOptionBuilder { return builder } -// 枚举选项值，当option_type为`TEXT`为文本值，当option_type为`PICTURE`时为图片链接 +// 枚举选项值，当 option_type 为`TEXT`为文本值，当 option_type 为`PICTURE`时为图片链接 // // 示例值：Option func (builder *CustomAttrOptionBuilder) Value(value string) *CustomAttrOptionBuilder { @@ -821,7 +821,7 @@ func (builder *CustomAttrOptionBuilder) Value(value string) *CustomAttrOptionBui return builder } -// 名称，仅option_type为PICTURE时有效 +// 名称，仅 option_type 为 PICTURE 时有效 // // 示例值：Name func (builder *CustomAttrOptionBuilder) Name(name string) *CustomAttrOptionBuilder { @@ -848,13 +848,13 @@ func (builder *CustomAttrOptionBuilder) Build() *CustomAttrOption { } type CustomAttrOptions struct { - DefaultOptionId *string `json:"default_option_id,omitempty"` // 默认选项id + DefaultOptionId *string `json:"default_option_id,omitempty"` // 默认选项 id OptionType *string `json:"option_type,omitempty"` // 选项类型 Options []*CustomAttrOption `json:"options,omitempty"` // 选项列表 } type CustomAttrOptionsBuilder struct { - defaultOptionId string // 默认选项id + defaultOptionId string // 默认选项 id defaultOptionIdFlag bool optionType string // 选项类型 optionTypeFlag bool @@ -867,7 +867,7 @@ func NewCustomAttrOptionsBuilder() *CustomAttrOptionsBuilder { return builder } -// 默认选项id +// 默认选项 id // // 示例值：qasdefgr func (builder *CustomAttrOptionsBuilder) DefaultOptionId(defaultOptionId string) *CustomAttrOptionsBuilder { @@ -913,19 +913,19 @@ func (builder *CustomAttrOptionsBuilder) Build() *CustomAttrOptions { type Department struct { Name *string `json:"name,omitempty"` // 部门名称 I18nName *DepartmentI18nName `json:"i18n_name,omitempty"` // 国际化的部门名称 - ParentDepartmentId *string `json:"parent_department_id,omitempty"` // 父部门的ID;;* 在根部门下创建新部门，该参数值为 “0” - DepartmentId *string `json:"department_id,omitempty"` // 本部门的自定义部门ID;;注意：除需要满足正则规则外，同时不能以`od-`开头 - OpenDepartmentId *string `json:"open_department_id,omitempty"` // 部门的open_id，类型与通过请求的查询参数传入的department_id_type相同 - LeaderUserId *string `json:"leader_user_id,omitempty"` // 部门主管用户ID - ChatId *string `json:"chat_id,omitempty"` // 部门群ID + ParentDepartmentId *string `json:"parent_department_id,omitempty"` // 父部门的 ID;;* 在根部门下创建新部门，该参数值为 “0” + DepartmentId *string `json:"department_id,omitempty"` // 本部门的自定义部门 ID;;注意：除需要满足正则规则外，同时不能以`od-`开头 + OpenDepartmentId *string `json:"open_department_id,omitempty"` // 部门的 open_id，类型与通过请求的查询参数传入的 department_id_type 相同 + LeaderUserId *string `json:"leader_user_id,omitempty"` // 部门主管用户 ID + ChatId *string `json:"chat_id,omitempty"` // 部门群 ID Order *string `json:"order,omitempty"` // 部门的排序，即部门在其同级部门的展示顺序 - UnitIds []string `json:"unit_ids,omitempty"` // 部门单位自定义ID列表，当前只支持一个 + UnitIds []string `json:"unit_ids,omitempty"` // 部门单位自定义 ID 列表，当前只支持一个 MemberCount *int `json:"member_count,omitempty"` // 部门下用户的个数 Status *DepartmentStatus `json:"status,omitempty"` // 部门状态 CreateGroupChat *bool `json:"create_group_chat,omitempty"` // 是否创建部门群，默认不创建 Leaders []*DepartmentLeader `json:"leaders,omitempty"` // 部门负责人 - GroupChatEmployeeTypes []int `json:"group_chat_employee_types,omitempty"` // 部门群雇员类型限制。[]空列表时，表示为无任何雇员类型。类型字段可包含以下值，支持多个类型值；若有多个，用英文','分隔：;1、正式员工;2、实习生;3、外包;4、劳务;5、顾问;6、其他自定义类型字段，可通过下方接口获取到该租户的自定义员工类型的名称，参见[获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)。 - DepartmentHrbps []string `json:"department_hrbps,omitempty"` // 部门HRBP + GroupChatEmployeeTypes []int `json:"group_chat_employee_types,omitempty"` // 部门群雇员类型限制。[] 空列表时，表示为无任何雇员类型。类型字段可包含以下值，支持多个类型值；若有多个，用英文','分隔：;1、正式员工;2、实习生;3、外包;4、劳务;5、顾问;6、其他自定义类型字段，可通过下方接口获取到该租户的自定义员工类型的名称，参见 [获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)。 + DepartmentHrbps []string `json:"department_hrbps,omitempty"` // 部门 HRBP } type DepartmentBuilder struct { @@ -933,19 +933,19 @@ type DepartmentBuilder struct { nameFlag bool i18nName *DepartmentI18nName // 国际化的部门名称 i18nNameFlag bool - parentDepartmentId string // 父部门的ID;;* 在根部门下创建新部门，该参数值为 “0” + parentDepartmentId string // 父部门的 ID;;* 在根部门下创建新部门，该参数值为 “0” parentDepartmentIdFlag bool - departmentId string // 本部门的自定义部门ID;;注意：除需要满足正则规则外，同时不能以`od-`开头 + departmentId string // 本部门的自定义部门 ID;;注意：除需要满足正则规则外，同时不能以`od-`开头 departmentIdFlag bool - openDepartmentId string // 部门的open_id，类型与通过请求的查询参数传入的department_id_type相同 + openDepartmentId string // 部门的 open_id，类型与通过请求的查询参数传入的 department_id_type 相同 openDepartmentIdFlag bool - leaderUserId string // 部门主管用户ID + leaderUserId string // 部门主管用户 ID leaderUserIdFlag bool - chatId string // 部门群ID + chatId string // 部门群 ID chatIdFlag bool order string // 部门的排序，即部门在其同级部门的展示顺序 orderFlag bool - unitIds []string // 部门单位自定义ID列表，当前只支持一个 + unitIds []string // 部门单位自定义 ID 列表，当前只支持一个 unitIdsFlag bool memberCount int // 部门下用户的个数 memberCountFlag bool @@ -955,9 +955,9 @@ type DepartmentBuilder struct { createGroupChatFlag bool leaders []*DepartmentLeader // 部门负责人 leadersFlag bool - groupChatEmployeeTypes []int // 部门群雇员类型限制。[]空列表时，表示为无任何雇员类型。类型字段可包含以下值，支持多个类型值；若有多个，用英文','分隔：;1、正式员工;2、实习生;3、外包;4、劳务;5、顾问;6、其他自定义类型字段，可通过下方接口获取到该租户的自定义员工类型的名称，参见[获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)。 + groupChatEmployeeTypes []int // 部门群雇员类型限制。[] 空列表时，表示为无任何雇员类型。类型字段可包含以下值，支持多个类型值；若有多个，用英文','分隔：;1、正式员工;2、实习生;3、外包;4、劳务;5、顾问;6、其他自定义类型字段，可通过下方接口获取到该租户的自定义员工类型的名称，参见 [获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)。 groupChatEmployeeTypesFlag bool - departmentHrbps []string // 部门HRBP + departmentHrbps []string // 部门 HRBP departmentHrbpsFlag bool } @@ -984,7 +984,7 @@ func (builder *DepartmentBuilder) I18nName(i18nName *DepartmentI18nName) *Depart return builder } -// 父部门的ID;;* 在根部门下创建新部门，该参数值为 “0” +// 父部门的 ID;;* 在根部门下创建新部门，该参数值为 “0” // // 示例值：D067 func (builder *DepartmentBuilder) ParentDepartmentId(parentDepartmentId string) *DepartmentBuilder { @@ -993,7 +993,7 @@ func (builder *DepartmentBuilder) ParentDepartmentId(parentDepartmentId string) return builder } -// 本部门的自定义部门ID;;注意：除需要满足正则规则外，同时不能以`od-`开头 +// 本部门的自定义部门 ID;;注意：除需要满足正则规则外，同时不能以`od-`开头 // // 示例值：D096 func (builder *DepartmentBuilder) DepartmentId(departmentId string) *DepartmentBuilder { @@ -1002,7 +1002,7 @@ func (builder *DepartmentBuilder) DepartmentId(departmentId string) *DepartmentB return builder } -// 部门的open_id，类型与通过请求的查询参数传入的department_id_type相同 +// 部门的 open_id，类型与通过请求的查询参数传入的 department_id_type 相同 // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *DepartmentBuilder) OpenDepartmentId(openDepartmentId string) *DepartmentBuilder { @@ -1011,7 +1011,7 @@ func (builder *DepartmentBuilder) OpenDepartmentId(openDepartmentId string) *Dep return builder } -// 部门主管用户ID +// 部门主管用户 ID // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *DepartmentBuilder) LeaderUserId(leaderUserId string) *DepartmentBuilder { @@ -1020,7 +1020,7 @@ func (builder *DepartmentBuilder) LeaderUserId(leaderUserId string) *DepartmentB return builder } -// 部门群ID +// 部门群 ID // // 示例值：oc_5ad11d72b830411d72b836c20 func (builder *DepartmentBuilder) ChatId(chatId string) *DepartmentBuilder { @@ -1038,7 +1038,7 @@ func (builder *DepartmentBuilder) Order(order string) *DepartmentBuilder { return builder } -// 部门单位自定义ID列表，当前只支持一个 +// 部门单位自定义 ID 列表，当前只支持一个 // // 示例值：custom_unit_id func (builder *DepartmentBuilder) UnitIds(unitIds []string) *DepartmentBuilder { @@ -1083,7 +1083,7 @@ func (builder *DepartmentBuilder) Leaders(leaders []*DepartmentLeader) *Departme return builder } -// 部门群雇员类型限制。[]空列表时，表示为无任何雇员类型。类型字段可包含以下值，支持多个类型值；若有多个，用英文','分隔：;1、正式员工;2、实习生;3、外包;4、劳务;5、顾问;6、其他自定义类型字段，可通过下方接口获取到该租户的自定义员工类型的名称，参见[获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)。 +// 部门群雇员类型限制。[] 空列表时，表示为无任何雇员类型。类型字段可包含以下值，支持多个类型值；若有多个，用英文','分隔：;1、正式员工;2、实习生;3、外包;4、劳务;5、顾问;6、其他自定义类型字段，可通过下方接口获取到该租户的自定义员工类型的名称，参见 [获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)。 // // 示例值：[1,2,3] func (builder *DepartmentBuilder) GroupChatEmployeeTypes(groupChatEmployeeTypes []int) *DepartmentBuilder { @@ -1092,7 +1092,7 @@ func (builder *DepartmentBuilder) GroupChatEmployeeTypes(groupChatEmployeeTypes return builder } -// 部门HRBP +// 部门 HRBP // // 示例值： func (builder *DepartmentBuilder) DepartmentHrbps(departmentHrbps []string) *DepartmentBuilder { @@ -1162,13 +1162,13 @@ func (builder *DepartmentBuilder) Build() *Department { type DepartmentLeader struct { LeaderType *int `json:"leaderType,omitempty"` // 负责人类型 - LeaderID *string `json:"leaderID,omitempty"` // 负责人ID + LeaderID *string `json:"leaderID,omitempty"` // 负责人 ID } type DepartmentLeaderBuilder struct { leaderType int // 负责人类型 leaderTypeFlag bool - leaderID string // 负责人ID + leaderID string // 负责人 ID leaderIDFlag bool } @@ -1186,7 +1186,7 @@ func (builder *DepartmentLeaderBuilder) LeaderType(leaderType int) *DepartmentLe return builder } -// 负责人ID +// 负责人 ID // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *DepartmentLeaderBuilder) LeaderID(leaderID string) *DepartmentLeaderBuilder { @@ -1209,7 +1209,7 @@ func (builder *DepartmentLeaderBuilder) Build() *DepartmentLeader { } type DepartmentCount struct { - DepartmentId *string `json:"department_id,omitempty"` // 部门ID + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID DirectDepartmentCount *int `json:"direct_department_count,omitempty"` // 部门下的直属部门数量 DirectUserCount *int `json:"direct_user_count,omitempty"` // 部门下的直属成员数量，包含部门负责人 DepartmentCount *int `json:"department_count,omitempty"` // 部门下所有部门的数量，包含递归的子部门 @@ -1217,7 +1217,7 @@ type DepartmentCount struct { } type DepartmentCountBuilder struct { - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool directDepartmentCount int // 部门下的直属部门数量 directDepartmentCountFlag bool @@ -1234,7 +1234,7 @@ func NewDepartmentCountBuilder() *DepartmentCountBuilder { return builder } -// 部门ID +// 部门 ID // // 示例值： func (builder *DepartmentCountBuilder) DepartmentId(departmentId string) *DepartmentCountBuilder { @@ -1306,30 +1306,30 @@ func (builder *DepartmentCountBuilder) Build() *DepartmentCount { type DepartmentEvent struct { Name *string `json:"name,omitempty"` // 部门名称 - ParentDepartmentId *string `json:"parent_department_id,omitempty"` // 父部门的部门open_department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) - DepartmentId *string `json:"department_id,omitempty"` // 本部门的department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) - OpenDepartmentId *string `json:"open_department_id,omitempty"` // 部门的open_department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) - LeaderUserId *string `json:"leader_user_id,omitempty"` // 部门主管用户open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - ChatId *string `json:"chat_id,omitempty"` // 部门群ID + ParentDepartmentId *string `json:"parent_department_id,omitempty"` // 父部门的部门 open_department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + DepartmentId *string `json:"department_id,omitempty"` // 本部门的 department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + OpenDepartmentId *string `json:"open_department_id,omitempty"` // 部门的 open_department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + LeaderUserId *string `json:"leader_user_id,omitempty"` // 部门主管用户 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + ChatId *string `json:"chat_id,omitempty"` // 部门群 ID Order *int `json:"order,omitempty"` // 部门的排序 Status *DepartmentStatus `json:"status,omitempty"` // 部门状态 Leaders []*DepartmentLeader `json:"leaders,omitempty"` // 部门负责人 - DepartmentHrbps []*UserId `json:"department_hrbps,omitempty"` // 部门HRBP + DepartmentHrbps []*UserId `json:"department_hrbps,omitempty"` // 部门 HRBP } type DepartmentEventBuilder struct { name string // 部门名称 nameFlag bool - parentDepartmentId string // 父部门的部门open_department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + parentDepartmentId string // 父部门的部门 open_department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) parentDepartmentIdFlag bool - departmentId string // 本部门的department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + departmentId string // 本部门的 department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) departmentIdFlag bool - openDepartmentId string // 部门的open_department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + openDepartmentId string // 部门的 open_department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) openDepartmentIdFlag bool - leaderUserId string // 部门主管用户open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + leaderUserId string // 部门主管用户 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) leaderUserIdFlag bool - chatId string // 部门群ID + chatId string // 部门群 ID chatIdFlag bool order int // 部门的排序 orderFlag bool @@ -1338,7 +1338,7 @@ type DepartmentEventBuilder struct { statusFlag bool leaders []*DepartmentLeader // 部门负责人 leadersFlag bool - departmentHrbps []*UserId // 部门HRBP + departmentHrbps []*UserId // 部门 HRBP departmentHrbpsFlag bool } @@ -1356,7 +1356,7 @@ func (builder *DepartmentEventBuilder) Name(name string) *DepartmentEventBuilder return builder } -// 父部门的部门open_department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 父部门的部门 open_department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：jkfsd89782 func (builder *DepartmentEventBuilder) ParentDepartmentId(parentDepartmentId string) *DepartmentEventBuilder { @@ -1365,7 +1365,7 @@ func (builder *DepartmentEventBuilder) ParentDepartmentId(parentDepartmentId str return builder } -// 本部门的department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 本部门的 department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：yd7sa8yf2j func (builder *DepartmentEventBuilder) DepartmentId(departmentId string) *DepartmentEventBuilder { @@ -1374,7 +1374,7 @@ func (builder *DepartmentEventBuilder) DepartmentId(departmentId string) *Depart return builder } -// 部门的open_department_id [部门相关ID概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 部门的 open_department_id [部门相关 ID 概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：od_j10j52hjksd9g0isdfg43 func (builder *DepartmentEventBuilder) OpenDepartmentId(openDepartmentId string) *DepartmentEventBuilder { @@ -1383,7 +1383,7 @@ func (builder *DepartmentEventBuilder) OpenDepartmentId(openDepartmentId string) return builder } -// 部门主管用户open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 部门主管用户 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_3j1kh45jk18fgh23hf func (builder *DepartmentEventBuilder) LeaderUserId(leaderUserId string) *DepartmentEventBuilder { @@ -1392,7 +1392,7 @@ func (builder *DepartmentEventBuilder) LeaderUserId(leaderUserId string) *Depart return builder } -// 部门群ID +// 部门群 ID // // 示例值：oc_uiy325uy23bnv48gdf func (builder *DepartmentEventBuilder) ChatId(chatId string) *DepartmentEventBuilder { @@ -1428,7 +1428,7 @@ func (builder *DepartmentEventBuilder) Leaders(leaders []*DepartmentLeader) *Dep return builder } -// 部门HRBP +// 部门 HRBP // // 示例值： func (builder *DepartmentEventBuilder) DepartmentHrbps(departmentHrbps []*UserId) *DepartmentEventBuilder { @@ -1502,7 +1502,7 @@ func NewDepartmentI18nNameBuilder() *DepartmentI18nNameBuilder { // 部门的中文名 // -// 示例值：Demo名称 +// 示例值：Demo 名称 func (builder *DepartmentI18nNameBuilder) ZhCn(zhCn string) *DepartmentI18nNameBuilder { builder.zhCn = zhCn builder.zhCnFlag = true @@ -1545,14 +1545,14 @@ func (builder *DepartmentI18nNameBuilder) Build() *DepartmentI18nName { } type DepartmentParent struct { - DepartmentId *string `json:"department_id,omitempty"` // 部门ID - ParentIds []string `json:"parent_ids,omitempty"` // 父部门ID列表，从直接父部门到根部门 + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID + ParentIds []string `json:"parent_ids,omitempty"` // 父部门 ID 列表，从直接父部门到根部门 } type DepartmentParentBuilder struct { - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool - parentIds []string // 父部门ID列表，从直接父部门到根部门 + parentIds []string // 父部门 ID 列表，从直接父部门到根部门 parentIdsFlag bool } @@ -1561,7 +1561,7 @@ func NewDepartmentParentBuilder() *DepartmentParentBuilder { return builder } -// 部门ID +// 部门 ID // // 示例值： func (builder *DepartmentParentBuilder) DepartmentId(departmentId string) *DepartmentParentBuilder { @@ -1570,7 +1570,7 @@ func (builder *DepartmentParentBuilder) DepartmentId(departmentId string) *Depar return builder } -// 父部门ID列表，从直接父部门到根部门 +// 父部门 ID 列表，从直接父部门到根部门 // // 示例值： func (builder *DepartmentParentBuilder) ParentIds(parentIds []string) *DepartmentParentBuilder { @@ -1624,13 +1624,13 @@ func (builder *DepartmentStatusBuilder) Build() *DepartmentStatus { } type DepartmentUnit struct { - UnitId *string `json:"unit_id,omitempty"` // 部门单元自定义ID + UnitId *string `json:"unit_id,omitempty"` // 部门单元自定义 ID UnitType *string `json:"unit_type,omitempty"` // 部门单元类型 UnitName *string `json:"unit_name,omitempty"` // 部门单元名称 } type DepartmentUnitBuilder struct { - unitId string // 部门单元自定义ID + unitId string // 部门单元自定义 ID unitIdFlag bool unitType string // 部门单元类型 unitTypeFlag bool @@ -1643,7 +1643,7 @@ func NewDepartmentUnitBuilder() *DepartmentUnitBuilder { return builder } -// 部门单元自定义ID +// 部门单元自定义 ID // // 示例值： func (builder *DepartmentUnitBuilder) UnitId(unitId string) *DepartmentUnitBuilder { @@ -1688,18 +1688,18 @@ func (builder *DepartmentUnitBuilder) Build() *DepartmentUnit { } type EmployeeTypeEnum struct { - EnumId *string `json:"enum_id,omitempty"` // 枚举值id - EnumValue *string `json:"enum_value,omitempty"` // 枚举的编号值，创建新的人员类型后，系统生成对应编号。对应[创建用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create)中用户信息的employee_type字段值 + EnumId *string `json:"enum_id,omitempty"` // 枚举值 id + EnumValue *string `json:"enum_value,omitempty"` // 枚举的编号值，创建新的人员类型后，系统生成对应编号。对应 [创建用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create) 中用户信息的 employee_type 字段值 Content *string `json:"content,omitempty"` // 枚举内容 EnumType *int `json:"enum_type,omitempty"` // 类型 EnumStatus *int `json:"enum_status,omitempty"` // 使用状态 - I18nContent []*I18nContent `json:"i18n_content,omitempty"` // i18n定义 + I18nContent []*I18nContent `json:"i18n_content,omitempty"` // i18n 定义 } type EmployeeTypeEnumBuilder struct { - enumId string // 枚举值id + enumId string // 枚举值 id enumIdFlag bool - enumValue string // 枚举的编号值，创建新的人员类型后，系统生成对应编号。对应[创建用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create)中用户信息的employee_type字段值 + enumValue string // 枚举的编号值，创建新的人员类型后，系统生成对应编号。对应 [创建用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create) 中用户信息的 employee_type 字段值 enumValueFlag bool content string // 枚举内容 contentFlag bool @@ -1707,7 +1707,7 @@ type EmployeeTypeEnumBuilder struct { enumTypeFlag bool enumStatus int // 使用状态 enumStatusFlag bool - i18nContent []*I18nContent // i18n定义 + i18nContent []*I18nContent // i18n 定义 i18nContentFlag bool } @@ -1716,7 +1716,7 @@ func NewEmployeeTypeEnumBuilder() *EmployeeTypeEnumBuilder { return builder } -// 枚举值id +// 枚举值 id // // 示例值：exGeIjow7zIqWMy+ONkFxA== func (builder *EmployeeTypeEnumBuilder) EnumId(enumId string) *EmployeeTypeEnumBuilder { @@ -1725,7 +1725,7 @@ func (builder *EmployeeTypeEnumBuilder) EnumId(enumId string) *EmployeeTypeEnumB return builder } -// 枚举的编号值，创建新的人员类型后，系统生成对应编号。对应[创建用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create)中用户信息的employee_type字段值 +// 枚举的编号值，创建新的人员类型后，系统生成对应编号。对应 [创建用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create) 中用户信息的 employee_type 字段值 // // 示例值：2 func (builder *EmployeeTypeEnumBuilder) EnumValue(enumValue string) *EmployeeTypeEnumBuilder { @@ -1761,7 +1761,7 @@ func (builder *EmployeeTypeEnumBuilder) EnumStatus(enumStatus int) *EmployeeType return builder } -// i18n定义 +// i18n 定义 // // 示例值： func (builder *EmployeeTypeEnumBuilder) I18nContent(i18nContent []*I18nContent) *EmployeeTypeEnumBuilder { @@ -1799,12 +1799,12 @@ func (builder *EmployeeTypeEnumBuilder) Build() *EmployeeTypeEnum { } type FunctionalRole struct { - RoleId *string `json:"role_id,omitempty"` // 角色内部ID + RoleId *string `json:"role_id,omitempty"` // 角色内部 ID RoleName *string `json:"role_name,omitempty"` // 角色名称 } type FunctionalRoleBuilder struct { - roleId string // 角色内部ID + roleId string // 角色内部 ID roleIdFlag bool roleName string // 角色名称 roleNameFlag bool @@ -1815,7 +1815,7 @@ func NewFunctionalRoleBuilder() *FunctionalRoleBuilder { return builder } -// 角色内部ID +// 角色内部 ID // // 示例值：7vrj3vk70xk7v5r func (builder *FunctionalRoleBuilder) RoleId(roleId string) *FunctionalRoleBuilder { @@ -1847,17 +1847,17 @@ func (builder *FunctionalRoleBuilder) Build() *FunctionalRole { } type FunctionalRoleMember struct { - UserId *string `json:"user_id,omitempty"` // 成员ID + UserId *string `json:"user_id,omitempty"` // 成员 ID ScopeType *string `json:"scope_type,omitempty"` // 管理范围的类型 - DepartmentIds []string `json:"department_ids,omitempty"` // 表示该角色成员的管理范围，scope_type为“指定范围”时，返回该值 + DepartmentIds []string `json:"department_ids,omitempty"` // 表示该角色成员的管理范围，scope_type 为 “指定范围” 时，返回该值 } type FunctionalRoleMemberBuilder struct { - userId string // 成员ID + userId string // 成员 ID userIdFlag bool scopeType string // 管理范围的类型 scopeTypeFlag bool - departmentIds []string // 表示该角色成员的管理范围，scope_type为“指定范围”时，返回该值 + departmentIds []string // 表示该角色成员的管理范围，scope_type 为 “指定范围” 时，返回该值 departmentIdsFlag bool } @@ -1866,7 +1866,7 @@ func NewFunctionalRoleMemberBuilder() *FunctionalRoleMemberBuilder { return builder } -// 成员ID +// 成员 ID // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *FunctionalRoleMemberBuilder) UserId(userId string) *FunctionalRoleMemberBuilder { @@ -1884,7 +1884,7 @@ func (builder *FunctionalRoleMemberBuilder) ScopeType(scopeType string) *Functio return builder } -// 表示该角色成员的管理范围，scope_type为“指定范围”时，返回该值 +// 表示该角色成员的管理范围，scope_type 为 “指定范围” 时，返回该值 // // 示例值： func (builder *FunctionalRoleMemberBuilder) DepartmentIds(departmentIds []string) *FunctionalRoleMemberBuilder { @@ -1910,12 +1910,12 @@ func (builder *FunctionalRoleMemberBuilder) Build() *FunctionalRoleMember { } type FunctionalRoleMemberResult struct { - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID Reason *int `json:"reason,omitempty"` // 成员处理结果 } type FunctionalRoleMemberResultBuilder struct { - userId string // 用户ID + userId string // 用户 ID userIdFlag bool reason int // 成员处理结果 reasonFlag bool @@ -1926,7 +1926,7 @@ func NewFunctionalRoleMemberResultBuilder() *FunctionalRoleMemberResultBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *FunctionalRoleMemberResultBuilder) UserId(userId string) *FunctionalRoleMemberResultBuilder { @@ -1958,7 +1958,7 @@ func (builder *FunctionalRoleMemberResultBuilder) Build() *FunctionalRoleMemberR } type Group struct { - Id *string `json:"id,omitempty"` // 用户组ID + Id *string `json:"id,omitempty"` // 用户组 ID Name *string `json:"name,omitempty"` // 用户组名字 Description *string `json:"description,omitempty"` // 用户组描述 MemberUserCount *int `json:"member_user_count,omitempty"` // 用户组成员中用户的数量 @@ -1966,7 +1966,7 @@ type Group struct { } type GroupBuilder struct { - id string // 用户组ID + id string // 用户组 ID idFlag bool name string // 用户组名字 nameFlag bool @@ -1983,7 +1983,7 @@ func NewGroupBuilder() *GroupBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：g193821 func (builder *GroupBuilder) Id(id string) *GroupBuilder { @@ -2054,12 +2054,12 @@ func (builder *GroupBuilder) Build() *Group { } type GroupEvent struct { - UserGroupId *string `json:"user_group_id,omitempty"` // 用户组的自定义ID + UserGroupId *string `json:"user_group_id,omitempty"` // 用户组的自定义 ID Name *string `json:"name,omitempty"` // 用户组的名称 } type GroupEventBuilder struct { - userGroupId string // 用户组的自定义ID + userGroupId string // 用户组的自定义 ID userGroupIdFlag bool name string // 用户组的名称 nameFlag bool @@ -2070,7 +2070,7 @@ func NewGroupEventBuilder() *GroupEventBuilder { return builder } -// 用户组的自定义ID +// 用户组的自定义 ID // // 示例值： func (builder *GroupEventBuilder) UserGroupId(userGroupId string) *GroupEventBuilder { @@ -2150,21 +2150,21 @@ func (builder *I18nContentBuilder) Build() *I18nContent { } type JobFamily struct { - Name *string `json:"name,omitempty"` // 序列名称。1-100字符，支持中、英文及符号 + Name *string `json:"name,omitempty"` // 序列名称。1-100 字符，支持中、英文及符号 Description *string `json:"description,omitempty"` // 序列描述，描述序列详情信息 - ParentJobFamilyId *string `json:"parent_job_family_id,omitempty"` // 上级序列ID。需是该租户的序列ID列表中的值，对应唯一的序列名称。 + ParentJobFamilyId *string `json:"parent_job_family_id,omitempty"` // 上级序列 ID。需是该租户的序列 ID 列表中的值，对应唯一的序列名称。 Status *bool `json:"status,omitempty"` // 是否启用 I18nName []*I18nContent `json:"i18n_name,omitempty"` // 多语言序列名称 I18nDescription []*I18nContent `json:"i18n_description,omitempty"` // 多语言描述 - JobFamilyId *string `json:"job_family_id,omitempty"` // 职级序列ID + JobFamilyId *string `json:"job_family_id,omitempty"` // 职级序列 ID } type JobFamilyBuilder struct { - name string // 序列名称。1-100字符，支持中、英文及符号 + name string // 序列名称。1-100 字符，支持中、英文及符号 nameFlag bool description string // 序列描述，描述序列详情信息 descriptionFlag bool - parentJobFamilyId string // 上级序列ID。需是该租户的序列ID列表中的值，对应唯一的序列名称。 + parentJobFamilyId string // 上级序列 ID。需是该租户的序列 ID 列表中的值，对应唯一的序列名称。 parentJobFamilyIdFlag bool status bool // 是否启用 statusFlag bool @@ -2172,7 +2172,7 @@ type JobFamilyBuilder struct { i18nNameFlag bool i18nDescription []*I18nContent // 多语言描述 i18nDescriptionFlag bool - jobFamilyId string // 职级序列ID + jobFamilyId string // 职级序列 ID jobFamilyIdFlag bool } @@ -2181,7 +2181,7 @@ func NewJobFamilyBuilder() *JobFamilyBuilder { return builder } -// 序列名称。1-100字符，支持中、英文及符号 +// 序列名称。1-100 字符，支持中、英文及符号 // // 示例值：产品 func (builder *JobFamilyBuilder) Name(name string) *JobFamilyBuilder { @@ -2199,7 +2199,7 @@ func (builder *JobFamilyBuilder) Description(description string) *JobFamilyBuild return builder } -// 上级序列ID。需是该租户的序列ID列表中的值，对应唯一的序列名称。 +// 上级序列 ID。需是该租户的序列 ID 列表中的值，对应唯一的序列名称。 // // 示例值：mga5oa8ayjlp9rb func (builder *JobFamilyBuilder) ParentJobFamilyId(parentJobFamilyId string) *JobFamilyBuilder { @@ -2210,7 +2210,7 @@ func (builder *JobFamilyBuilder) ParentJobFamilyId(parentJobFamilyId string) *Jo // 是否启用 // -// 示例值：true 表示启用, false表示未启用 +// 示例值：true 表示启用，false 表示未启用 func (builder *JobFamilyBuilder) Status(status bool) *JobFamilyBuilder { builder.status = status builder.statusFlag = true @@ -2235,7 +2235,7 @@ func (builder *JobFamilyBuilder) I18nDescription(i18nDescription []*I18nContent) return builder } -// 职级序列ID +// 职级序列 ID // // 示例值：mga5oa8ayjlp9rb func (builder *JobFamilyBuilder) JobFamilyId(jobFamilyId string) *JobFamilyBuilder { @@ -2278,9 +2278,9 @@ func (builder *JobFamilyBuilder) Build() *JobFamily { type JobLevel struct { Name *string `json:"name,omitempty"` // 职级名称 Description *string `json:"description,omitempty"` // 职级描述 - Order *int `json:"order,omitempty"` // 职级的排序，可填入自然数100-100000的数值，系统按照数值大小从小到大排序。不填写该字段时，默认新增排序在当前职级列表中最后位（最大值） + Order *int `json:"order,omitempty"` // 职级的排序，可填入自然数 100-100000 的数值，系统按照数值大小从小到大排序。不填写该字段时，默认新增排序在当前职级列表中最后位（最大值） Status *bool `json:"status,omitempty"` // 是否启用 - JobLevelId *string `json:"job_level_id,omitempty"` // 职级ID + JobLevelId *string `json:"job_level_id,omitempty"` // 职级 ID I18nName []*I18nContent `json:"i18n_name,omitempty"` // 多语言名称 I18nDescription []*I18nContent `json:"i18n_description,omitempty"` // 多语言描述 } @@ -2290,11 +2290,11 @@ type JobLevelBuilder struct { nameFlag bool description string // 职级描述 descriptionFlag bool - order int // 职级的排序，可填入自然数100-100000的数值，系统按照数值大小从小到大排序。不填写该字段时，默认新增排序在当前职级列表中最后位（最大值） + order int // 职级的排序，可填入自然数 100-100000 的数值，系统按照数值大小从小到大排序。不填写该字段时，默认新增排序在当前职级列表中最后位（最大值） orderFlag bool status bool // 是否启用 statusFlag bool - jobLevelId string // 职级ID + jobLevelId string // 职级 ID jobLevelIdFlag bool i18nName []*I18nContent // 多语言名称 i18nNameFlag bool @@ -2325,7 +2325,7 @@ func (builder *JobLevelBuilder) Description(description string) *JobLevelBuilder return builder } -// 职级的排序，可填入自然数100-100000的数值，系统按照数值大小从小到大排序。不填写该字段时，默认新增排序在当前职级列表中最后位（最大值） +// 职级的排序，可填入自然数 100-100000 的数值，系统按照数值大小从小到大排序。不填写该字段时，默认新增排序在当前职级列表中最后位（最大值） // // 示例值：200 func (builder *JobLevelBuilder) Order(order int) *JobLevelBuilder { @@ -2343,7 +2343,7 @@ func (builder *JobLevelBuilder) Status(status bool) *JobLevelBuilder { return builder } -// 职级ID +// 职级 ID // // 示例值：mga5oa8ayjlp9rb func (builder *JobLevelBuilder) JobLevelId(jobLevelId string) *JobLevelBuilder { @@ -2402,14 +2402,14 @@ func (builder *JobLevelBuilder) Build() *JobLevel { } type MemberResult struct { - MemberId *string `json:"member_id,omitempty"` // 成员ID - Code *int `json:"code,omitempty"` // 结果响应码，0表示成功 + MemberId *string `json:"member_id,omitempty"` // 成员 ID + Code *int `json:"code,omitempty"` // 结果响应码，0 表示成功 } type MemberResultBuilder struct { - memberId string // 成员ID + memberId string // 成员 ID memberIdFlag bool - code int // 结果响应码，0表示成功 + code int // 结果响应码，0 表示成功 codeFlag bool } @@ -2418,7 +2418,7 @@ func NewMemberResultBuilder() *MemberResultBuilder { return builder } -// 成员ID +// 成员 ID // // 示例值：u287xj12 func (builder *MemberResultBuilder) MemberId(memberId string) *MemberResultBuilder { @@ -2427,7 +2427,7 @@ func (builder *MemberResultBuilder) MemberId(memberId string) *MemberResultBuild return builder } -// 结果响应码，0表示成功 +// 结果响应码，0 表示成功 // // 示例值：0 func (builder *MemberResultBuilder) Code(code int) *MemberResultBuilder { @@ -2450,17 +2450,17 @@ func (builder *MemberResultBuilder) Build() *MemberResult { } type Memberlist struct { - MemberId *string `json:"member_id,omitempty"` // 成员ID - MemberType *string `json:"member_type,omitempty"` // 用户组成员的类型，取值为 user或department。 - MemberIdType *string `json:"member_id_type,omitempty"` // 当member_type为user时，member_id_type表示user_id_type，可选值为open_id, union_id, user_id。仅在请求参数中有效，响应体中不会返回此参数。 + MemberId *string `json:"member_id,omitempty"` // 成员 ID + MemberType *string `json:"member_type,omitempty"` // 用户组成员的类型，取值为 user 或 department。 + MemberIdType *string `json:"member_id_type,omitempty"` // 当 member_type 为 user 时，member_id_type 表示 user_id_type，可选值为 open_id, union_id, user_id。仅在请求参数中有效，响应体中不会返回此参数。 } type MemberlistBuilder struct { - memberId string // 成员ID + memberId string // 成员 ID memberIdFlag bool - memberType string // 用户组成员的类型，取值为 user或department。 + memberType string // 用户组成员的类型，取值为 user 或 department。 memberTypeFlag bool - memberIdType string // 当member_type为user时，member_id_type表示user_id_type，可选值为open_id, union_id, user_id。仅在请求参数中有效，响应体中不会返回此参数。 + memberIdType string // 当 member_type 为 user 时，member_id_type 表示 user_id_type，可选值为 open_id, union_id, user_id。仅在请求参数中有效，响应体中不会返回此参数。 memberIdTypeFlag bool } @@ -2469,7 +2469,7 @@ func NewMemberlistBuilder() *MemberlistBuilder { return builder } -// 成员ID +// 成员 ID // // 示例值：u287xj12 func (builder *MemberlistBuilder) MemberId(memberId string) *MemberlistBuilder { @@ -2478,7 +2478,7 @@ func (builder *MemberlistBuilder) MemberId(memberId string) *MemberlistBuilder { return builder } -// 用户组成员的类型，取值为 user或department。 +// 用户组成员的类型，取值为 user 或 department。 // // 示例值：user func (builder *MemberlistBuilder) MemberType(memberType string) *MemberlistBuilder { @@ -2487,7 +2487,7 @@ func (builder *MemberlistBuilder) MemberType(memberType string) *MemberlistBuild return builder } -// 当member_type为user时，member_id_type表示user_id_type，可选值为open_id, union_id, user_id。仅在请求参数中有效，响应体中不会返回此参数。 +// 当 member_type 为 user 时，member_id_type 表示 user_id_type，可选值为 open_id, union_id, user_id。仅在请求参数中有效，响应体中不会返回此参数。 // // 示例值：user_id func (builder *MemberlistBuilder) MemberIdType(memberIdType string) *MemberlistBuilder { @@ -2562,13 +2562,13 @@ func (builder *NotificationOptionBuilder) Build() *NotificationOption { type OldDepartmentObject struct { Status *DepartmentStatus `json:"status,omitempty"` // 部门状态 - OpenDepartmentId *string `json:"open_department_id,omitempty"` // 部门open_id + OpenDepartmentId *string `json:"open_department_id,omitempty"` // 部门 open_id } type OldDepartmentObjectBuilder struct { status *DepartmentStatus // 部门状态 statusFlag bool - openDepartmentId string // 部门open_id + openDepartmentId string // 部门 open_id openDepartmentIdFlag bool } @@ -2586,7 +2586,7 @@ func (builder *OldDepartmentObjectBuilder) Status(status *DepartmentStatus) *Old return builder } -// 部门open_id +// 部门 open_id // // 示例值：od-xxxxxxxx func (builder *OldDepartmentObjectBuilder) OpenDepartmentId(openDepartmentId string) *OldDepartmentObjectBuilder { @@ -2608,14 +2608,14 @@ func (builder *OldDepartmentObjectBuilder) Build() *OldDepartmentObject { } type OldUserObject struct { - DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的ID列表 - OpenId *string `json:"open_id,omitempty"` // 用户open_id + DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的 ID 列表 + OpenId *string `json:"open_id,omitempty"` // 用户 open_id } type OldUserObjectBuilder struct { - departmentIds []string // 用户所属部门的ID列表 + departmentIds []string // 用户所属部门的 ID 列表 departmentIdsFlag bool - openId string // 用户open_id + openId string // 用户 open_id openIdFlag bool } @@ -2624,7 +2624,7 @@ func NewOldUserObjectBuilder() *OldUserObjectBuilder { return builder } -// 用户所属部门的ID列表 +// 用户所属部门的 ID 列表 // // 示例值： func (builder *OldUserObjectBuilder) DepartmentIds(departmentIds []string) *OldUserObjectBuilder { @@ -2633,7 +2633,7 @@ func (builder *OldUserObjectBuilder) DepartmentIds(departmentIds []string) *OldU return builder } -// 用户open_id +// 用户 open_id // // 示例值：ou_xxxxxxxxxx func (builder *OldUserObjectBuilder) OpenId(openId string) *OldUserObjectBuilder { @@ -2720,13 +2720,13 @@ func (builder *ProductI18nNameBuilder) Build() *ProductI18nName { type ResourceAcceptor struct { ProcessingType *string `json:"processing_type,omitempty"` // 邮件处理方式 - AcceptorUserId *string `json:"acceptor_user_id,omitempty"` // 在 processing_type 为 1 （转移资源时），邮件资源接收者 + AcceptorUserId *string `json:"acceptor_user_id,omitempty"` // 在 processing_type 为 1（转移资源时），邮件资源接收者 } type ResourceAcceptorBuilder struct { processingType string // 邮件处理方式 processingTypeFlag bool - acceptorUserId string // 在 processing_type 为 1 （转移资源时），邮件资源接收者 + acceptorUserId string // 在 processing_type 为 1（转移资源时），邮件资源接收者 acceptorUserIdFlag bool } @@ -2744,7 +2744,7 @@ func (builder *ResourceAcceptorBuilder) ProcessingType(processingType string) *R return builder } -// 在 processing_type 为 1 （转移资源时），邮件资源接收者 +// 在 processing_type 为 1（转移资源时），邮件资源接收者 // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *ResourceAcceptorBuilder) AcceptorUserId(acceptorUserId string) *ResourceAcceptorBuilder { @@ -2828,14 +2828,14 @@ func (builder *ScopeBuilder) Build() *Scope { } type ShareDepartment struct { - OpenId *string `json:"open_id,omitempty"` // 共享部门的open id + OpenId *string `json:"open_id,omitempty"` // 共享部门的 open id Name *string `json:"name,omitempty"` // 部门名称 I18nName *DepartmentI18nName `json:"i18n_name,omitempty"` // 国际化的部门名称 Order *string `json:"order,omitempty"` // 部门的排序 } type ShareDepartmentBuilder struct { - openId string // 共享部门的open id + openId string // 共享部门的 open id openIdFlag bool name string // 部门名称 nameFlag bool @@ -2850,7 +2850,7 @@ func NewShareDepartmentBuilder() *ShareDepartmentBuilder { return builder } -// 共享部门的open id +// 共享部门的 open id // // 示例值：od-b025f41e599bf3d3fb5dc56b7f86142b func (builder *ShareDepartmentBuilder) OpenId(openId string) *ShareDepartmentBuilder { @@ -2907,14 +2907,14 @@ func (builder *ShareDepartmentBuilder) Build() *ShareDepartment { } type ShareUser struct { - OpenId *string `json:"open_id,omitempty"` // 用户的open_id + OpenId *string `json:"open_id,omitempty"` // 用户的 open_id Name *string `json:"name,omitempty"` // 用户的名称 EnName *string `json:"en_name,omitempty"` // 英文名 Avatar *AvatarInfo `json:"avatar,omitempty"` // 用户头像信息 } type ShareUserBuilder struct { - openId string // 用户的open_id + openId string // 用户的 open_id openIdFlag bool name string // 用户的名称 nameFlag bool @@ -2929,7 +2929,7 @@ func NewShareUserBuilder() *ShareUserBuilder { return builder } -// 用户的open_id +// 用户的 open_id // // 示例值：ou_496670738e90fb26f899088a125226c5 func (builder *ShareUserBuilder) OpenId(openId string) *ShareUserBuilder { @@ -2986,13 +2986,13 @@ func (builder *ShareUserBuilder) Build() *ShareUser { } type Unit struct { - UnitId *string `json:"unit_id,omitempty"` // 单位ID + UnitId *string `json:"unit_id,omitempty"` // 单位 ID Name *string `json:"name,omitempty"` // 单位的名字 UnitType *string `json:"unit_type,omitempty"` // 单位的类型 } type UnitBuilder struct { - unitId string // 单位ID + unitId string // 单位 ID unitIdFlag bool name string // 单位的名字 nameFlag bool @@ -3005,7 +3005,7 @@ func NewUnitBuilder() *UnitBuilder { return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *UnitBuilder) UnitId(unitId string) *UnitBuilder { @@ -3050,14 +3050,14 @@ func (builder *UnitBuilder) Build() *Unit { } type UnitDepartment struct { - UnitId *string `json:"unit_id,omitempty"` // 单位ID - DepartmentId *string `json:"department_id,omitempty"` // 部门ID + UnitId *string `json:"unit_id,omitempty"` // 单位 ID + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID } type UnitDepartmentBuilder struct { - unitId string // 单位ID + unitId string // 单位 ID unitIdFlag bool - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool } @@ -3066,7 +3066,7 @@ func NewUnitDepartmentBuilder() *UnitDepartmentBuilder { return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *UnitDepartmentBuilder) UnitId(unitId string) *UnitDepartmentBuilder { @@ -3075,7 +3075,7 @@ func (builder *UnitDepartmentBuilder) UnitId(unitId string) *UnitDepartmentBuild return builder } -// 部门ID +// 部门 ID // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *UnitDepartmentBuilder) DepartmentId(departmentId string) *UnitDepartmentBuilder { @@ -3098,9 +3098,9 @@ func (builder *UnitDepartmentBuilder) Build() *UnitDepartment { } type User struct { - UnionId *string `json:"union_id,omitempty"` // 用户的union_id，应用开发商发布的不同应用中同一用户的标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - UserId *string `json:"user_id,omitempty"` // 用户的user_id，租户内用户的唯一标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - OpenId *string `json:"open_id,omitempty"` // 用户的open_id，应用内用户的唯一标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + UnionId *string `json:"union_id,omitempty"` // 用户的 union_id，应用开发商发布的不同应用中同一用户的标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + UserId *string `json:"user_id,omitempty"` // 用户的 user_id，租户内用户的唯一标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + OpenId *string `json:"open_id,omitempty"` // 用户的 open_id，应用内用户的唯一标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) Name *string `json:"name,omitempty"` // 用户名 EnName *string `json:"en_name,omitempty"` // 英文名 Nickname *string `json:"nickname,omitempty"` // 别名 @@ -3108,39 +3108,39 @@ type User struct { Mobile *string `json:"mobile,omitempty"` // 手机号，在本企业内不可重复；未认证企业仅支持添加中国大陆手机号，通过飞书认证的企业允许添加海外手机号，注意国际电话区号前缀中必须包含加号 + MobileVisible *bool `json:"mobile_visible,omitempty"` // 手机号码可见性，true 为可见，false 为不可见，目前默认为 true。不可见时，组织员工将无法查看该员工的手机号码 Gender *int `json:"gender,omitempty"` // 性别 - AvatarKey *string `json:"avatar_key,omitempty"` // 头像的文件Key，可通过“消息与群组/消息/图片信息”中的“上传图片”接口上传并获取头像文件 Key;;“上传图片”功能参见[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) + AvatarKey *string `json:"avatar_key,omitempty"` // 头像的文件 Key，可通过 “消息与群组/消息/图片信息” 中的 “上传图片” 接口上传并获取头像文件 Key;;“上传图片” 功能参见 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) Avatar *AvatarInfo `json:"avatar,omitempty"` // 用户头像信息 - Status *UserStatus `json:"status,omitempty"` // 用户状态，枚举类型，包括is_frozen、is_resigned、is_activated、is_exited 。;;用户状态转移参见：[用户状态图](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview#4302b5a1) - DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的ID列表，一个用户可属于多个部门。;;ID值的类型与查询参数中的department_id_type 对应。;;不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) - LeaderUserId *string `json:"leader_user_id,omitempty"` // 用户的直接主管的用户ID，ID值与查询参数中的user_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;获取方式参见[如何获取user_id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get) + Status *UserStatus `json:"status,omitempty"` // 用户状态，枚举类型，包括 is_frozen、is_resigned、is_activated、is_exited 。;;用户状态转移参见：[用户状态图](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview#4302b5a1) + DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的 ID 列表，一个用户可属于多个部门。;;ID 值的类型与查询参数中的 department_id_type 对应。;;不同 ID 的说明与 department_id 的获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + LeaderUserId *string `json:"leader_user_id,omitempty"` // 用户的直接主管的用户 ID，ID 值与查询参数中的 user_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;获取方式参见 [如何获取 user_id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get) City *string `json:"city,omitempty"` // 工作城市 - Country *string `json:"country,omitempty"` // 国家或地区Code缩写，具体写入格式请参考 [国家/地区码表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/country-code-description) + Country *string `json:"country,omitempty"` // 国家或地区 Code 缩写，具体写入格式请参考 [国家/地区码表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/country-code-description) WorkStation *string `json:"work_station,omitempty"` // 工位 - JoinTime *int `json:"join_time,omitempty"` // 入职时间，时间戳格式，表示从1970年1月1日开始所经过的秒数 + JoinTime *int `json:"join_time,omitempty"` // 入职时间，时间戳格式，表示从 1970 年 1 月 1 日开始所经过的秒数 IsTenantManager *bool `json:"is_tenant_manager,omitempty"` // 是否是租户超级管理员 EmployeeNo *string `json:"employee_no,omitempty"` // 工号 - EmployeeType *int `json:"employee_type,omitempty"` // 员工类型，可选值有：;- `1`：正式员工;- `2`：实习生;- `3`：外包;- `4`：劳务;- `5`：顾问 ;同时可读取到自定义员工类型的 int 值，可通过下方接口获取到该租户的自定义员工类型的名称，参见[获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list) + EmployeeType *int `json:"employee_type,omitempty"` // 员工类型，可选值有：;- `1`：正式员工;- `2`：实习生;- `3`：外包;- `4`：劳务;- `5`：顾问 ;同时可读取到自定义员工类型的 int 值，可通过下方接口获取到该租户的自定义员工类型的名称，参见 [获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list) Orders []*UserOrder `json:"orders,omitempty"` // 用户排序信息。;;用于标记通讯录下组织架构的人员顺序，人员可能存在多个部门中，且有不同的排序。 - CustomAttrs []*UserCustomAttr `json:"custom_attrs,omitempty"` // 自定义字段，请确保你的组织管理员已在管理后台/组织架构/成员字段管理/自定义字段管理/全局设置中开启了“允许开放平台 API 调用“，否则该字段不会生效/返回。;;更多详情参见[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) - EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务;;创建用户时，企业邮箱的使用方式参见[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) + CustomAttrs []*UserCustomAttr `json:"custom_attrs,omitempty"` // 自定义字段，请确保你的组织管理员已在管理后台/组织架构/成员字段管理/自定义字段管理/全局设置中开启了 “允许开放平台 API 调用 “，否则该字段不会生效/返回。;;更多详情参见 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) + EnterpriseEmail *string `json:"enterprise_email,omitempty"` // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务;;创建用户时，企业邮箱的使用方式参见 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) JobTitle *string `json:"job_title,omitempty"` // 职务 IsFrozen *bool `json:"is_frozen,omitempty"` // 是否暂停用户 - JobLevelId *string `json:"job_level_id,omitempty"` // 职级ID - JobFamilyId *string `json:"job_family_id,omitempty"` // 序列ID - SubscriptionIds []string `json:"subscription_ids,omitempty"` // 分配给用户的席位ID列表 + JobLevelId *string `json:"job_level_id,omitempty"` // 职级 ID + JobFamilyId *string `json:"job_family_id,omitempty"` // 序列 ID + SubscriptionIds []string `json:"subscription_ids,omitempty"` // 分配给用户的席位 ID 列表 AssignInfo []*UserAssignInfo `json:"assign_info,omitempty"` // 用户席位列表 } type UserBuilder struct { - unionId string // 用户的union_id，应用开发商发布的不同应用中同一用户的标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + unionId string // 用户的 union_id，应用开发商发布的不同应用中同一用户的标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) unionIdFlag bool - userId string // 用户的user_id，租户内用户的唯一标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + userId string // 用户的 user_id，租户内用户的唯一标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool - openId string // 用户的open_id，应用内用户的唯一标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + openId string // 用户的 open_id，应用内用户的唯一标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) openIdFlag bool name string // 用户名 nameFlag bool @@ -3156,36 +3156,36 @@ type UserBuilder struct { mobileVisibleFlag bool gender int // 性别 genderFlag bool - avatarKey string // 头像的文件Key，可通过“消息与群组/消息/图片信息”中的“上传图片”接口上传并获取头像文件 Key;;“上传图片”功能参见[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) + avatarKey string // 头像的文件 Key，可通过 “消息与群组/消息/图片信息” 中的 “上传图片” 接口上传并获取头像文件 Key;;“上传图片” 功能参见 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) avatarKeyFlag bool avatar *AvatarInfo // 用户头像信息 avatarFlag bool - status *UserStatus // 用户状态，枚举类型，包括is_frozen、is_resigned、is_activated、is_exited 。;;用户状态转移参见：[用户状态图](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview#4302b5a1) + status *UserStatus // 用户状态，枚举类型，包括 is_frozen、is_resigned、is_activated、is_exited 。;;用户状态转移参见：[用户状态图](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview#4302b5a1) statusFlag bool - departmentIds []string // 用户所属部门的ID列表，一个用户可属于多个部门。;;ID值的类型与查询参数中的department_id_type 对应。;;不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) + departmentIds []string // 用户所属部门的 ID 列表，一个用户可属于多个部门。;;ID 值的类型与查询参数中的 department_id_type 对应。;;不同 ID 的说明与 department_id 的获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) departmentIdsFlag bool - leaderUserId string // 用户的直接主管的用户ID，ID值与查询参数中的user_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;获取方式参见[如何获取user_id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get) + leaderUserId string // 用户的直接主管的用户 ID，ID 值与查询参数中的 user_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;获取方式参见 [如何获取 user_id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get) leaderUserIdFlag bool city string // 工作城市 cityFlag bool - country string // 国家或地区Code缩写，具体写入格式请参考 [国家/地区码表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/country-code-description) + country string // 国家或地区 Code 缩写，具体写入格式请参考 [国家/地区码表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/country-code-description) countryFlag bool workStation string // 工位 workStationFlag bool - joinTime int // 入职时间，时间戳格式，表示从1970年1月1日开始所经过的秒数 + joinTime int // 入职时间，时间戳格式，表示从 1970 年 1 月 1 日开始所经过的秒数 joinTimeFlag bool isTenantManager bool // 是否是租户超级管理员 isTenantManagerFlag bool employeeNo string // 工号 employeeNoFlag bool - employeeType int // 员工类型，可选值有：;- `1`：正式员工;- `2`：实习生;- `3`：外包;- `4`：劳务;- `5`：顾问 ;同时可读取到自定义员工类型的 int 值，可通过下方接口获取到该租户的自定义员工类型的名称，参见[获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list) + employeeType int // 员工类型，可选值有：;- `1`：正式员工;- `2`：实习生;- `3`：外包;- `4`：劳务;- `5`：顾问 ;同时可读取到自定义员工类型的 int 值，可通过下方接口获取到该租户的自定义员工类型的名称，参见 [获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list) employeeTypeFlag bool orders []*UserOrder // 用户排序信息。;;用于标记通讯录下组织架构的人员顺序，人员可能存在多个部门中，且有不同的排序。 ordersFlag bool - customAttrs []*UserCustomAttr // 自定义字段，请确保你的组织管理员已在管理后台/组织架构/成员字段管理/自定义字段管理/全局设置中开启了“允许开放平台 API 调用“，否则该字段不会生效/返回。;;更多详情参见[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) + customAttrs []*UserCustomAttr // 自定义字段，请确保你的组织管理员已在管理后台/组织架构/成员字段管理/自定义字段管理/全局设置中开启了 “允许开放平台 API 调用 “，否则该字段不会生效/返回。;;更多详情参见 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) customAttrsFlag bool - enterpriseEmail string // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务;;创建用户时，企业邮箱的使用方式参见[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) + enterpriseEmail string // 企业邮箱，请先确保已在管理后台启用飞书邮箱服务;;创建用户时，企业邮箱的使用方式参见 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) enterpriseEmailFlag bool jobTitle string // 职务 @@ -3194,11 +3194,11 @@ type UserBuilder struct { isFrozen bool // 是否暂停用户 isFrozenFlag bool - jobLevelId string // 职级ID + jobLevelId string // 职级 ID jobLevelIdFlag bool - jobFamilyId string // 序列ID + jobFamilyId string // 序列 ID jobFamilyIdFlag bool - subscriptionIds []string // 分配给用户的席位ID列表 + subscriptionIds []string // 分配给用户的席位 ID 列表 subscriptionIdsFlag bool assignInfo []*UserAssignInfo // 用户席位列表 assignInfoFlag bool @@ -3209,7 +3209,7 @@ func NewUserBuilder() *UserBuilder { return builder } -// 用户的union_id，应用开发商发布的不同应用中同一用户的标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的 union_id，应用开发商发布的不同应用中同一用户的标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：on_94a1ee5551019f18cd73d9f111898cf2 func (builder *UserBuilder) UnionId(unionId string) *UserBuilder { @@ -3218,7 +3218,7 @@ func (builder *UserBuilder) UnionId(unionId string) *UserBuilder { return builder } -// 用户的user_id，租户内用户的唯一标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的 user_id，租户内用户的唯一标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：3e3cf96b func (builder *UserBuilder) UserId(userId string) *UserBuilder { @@ -3227,7 +3227,7 @@ func (builder *UserBuilder) UserId(userId string) *UserBuilder { return builder } -// 用户的open_id，应用内用户的唯一标识，不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的 open_id，应用内用户的唯一标识，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *UserBuilder) OpenId(openId string) *UserBuilder { @@ -3274,7 +3274,7 @@ func (builder *UserBuilder) Email(email string) *UserBuilder { // 手机号，在本企业内不可重复；未认证企业仅支持添加中国大陆手机号，通过飞书认证的企业允许添加海外手机号，注意国际电话区号前缀中必须包含加号 + // -// 示例值：13011111111 (其他例子，中国大陆手机号: 13011111111 或 +8613011111111, 非中国大陆手机号: +41446681800) +// 示例值：13011111111 (其他例子，中国大陆手机号: 13011111111 或 +8613011111111，非中国大陆手机号: +41446681800) func (builder *UserBuilder) Mobile(mobile string) *UserBuilder { builder.mobile = mobile builder.mobileFlag = true @@ -3299,7 +3299,7 @@ func (builder *UserBuilder) Gender(gender int) *UserBuilder { return builder } -// 头像的文件Key，可通过“消息与群组/消息/图片信息”中的“上传图片”接口上传并获取头像文件 Key;;“上传图片”功能参见[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) +// 头像的文件 Key，可通过 “消息与群组/消息/图片信息” 中的 “上传图片” 接口上传并获取头像文件 Key;;“上传图片” 功能参见 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) // // 示例值：2500c7a9-5fff-4d9a-a2de-3d59614ae28g func (builder *UserBuilder) AvatarKey(avatarKey string) *UserBuilder { @@ -3317,7 +3317,7 @@ func (builder *UserBuilder) Avatar(avatar *AvatarInfo) *UserBuilder { return builder } -// 用户状态，枚举类型，包括is_frozen、is_resigned、is_activated、is_exited 。;;用户状态转移参见：[用户状态图](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview#4302b5a1) +// 用户状态，枚举类型，包括 is_frozen、is_resigned、is_activated、is_exited 。;;用户状态转移参见：[用户状态图](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview#4302b5a1) // // 示例值： func (builder *UserBuilder) Status(status *UserStatus) *UserBuilder { @@ -3326,7 +3326,7 @@ func (builder *UserBuilder) Status(status *UserStatus) *UserBuilder { return builder } -// 用户所属部门的ID列表，一个用户可属于多个部门。;;ID值的类型与查询参数中的department_id_type 对应。;;不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 用户所属部门的 ID 列表，一个用户可属于多个部门。;;ID 值的类型与查询参数中的 department_id_type 对应。;;不同 ID 的说明与 department_id 的获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *UserBuilder) DepartmentIds(departmentIds []string) *UserBuilder { @@ -3335,7 +3335,7 @@ func (builder *UserBuilder) DepartmentIds(departmentIds []string) *UserBuilder { return builder } -// 用户的直接主管的用户ID，ID值与查询参数中的user_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;获取方式参见[如何获取user_id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get) +// 用户的直接主管的用户 ID，ID 值与查询参数中的 user_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;获取方式参见 [如何获取 user_id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get) // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *UserBuilder) LeaderUserId(leaderUserId string) *UserBuilder { @@ -3353,7 +3353,7 @@ func (builder *UserBuilder) City(city string) *UserBuilder { return builder } -// 国家或地区Code缩写，具体写入格式请参考 [国家/地区码表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/country-code-description) +// 国家或地区 Code 缩写，具体写入格式请参考 [国家/地区码表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/country-code-description) // // 示例值：CN func (builder *UserBuilder) Country(country string) *UserBuilder { @@ -3371,7 +3371,7 @@ func (builder *UserBuilder) WorkStation(workStation string) *UserBuilder { return builder } -// 入职时间，时间戳格式，表示从1970年1月1日开始所经过的秒数 +// 入职时间，时间戳格式，表示从 1970 年 1 月 1 日开始所经过的秒数 // // 示例值：2147483647 func (builder *UserBuilder) JoinTime(joinTime int) *UserBuilder { @@ -3398,7 +3398,7 @@ func (builder *UserBuilder) EmployeeNo(employeeNo string) *UserBuilder { return builder } -// 员工类型，可选值有：;- `1`：正式员工;- `2`：实习生;- `3`：外包;- `4`：劳务;- `5`：顾问 ;同时可读取到自定义员工类型的 int 值，可通过下方接口获取到该租户的自定义员工类型的名称，参见[获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list) +// 员工类型，可选值有：;- `1`：正式员工;- `2`：实习生;- `3`：外包;- `4`：劳务;- `5`：顾问 ;同时可读取到自定义员工类型的 int 值，可通过下方接口获取到该租户的自定义员工类型的名称，参见 [获取人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list) // // 示例值：1 func (builder *UserBuilder) EmployeeType(employeeType int) *UserBuilder { @@ -3416,7 +3416,7 @@ func (builder *UserBuilder) Orders(orders []*UserOrder) *UserBuilder { return builder } -// 自定义字段，请确保你的组织管理员已在管理后台/组织架构/成员字段管理/自定义字段管理/全局设置中开启了“允许开放平台 API 调用“，否则该字段不会生效/返回。;;更多详情参见[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) +// 自定义字段，请确保你的组织管理员已在管理后台/组织架构/成员字段管理/自定义字段管理/全局设置中开启了 “允许开放平台 API 调用 “，否则该字段不会生效/返回。;;更多详情参见 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) // // 示例值： func (builder *UserBuilder) CustomAttrs(customAttrs []*UserCustomAttr) *UserBuilder { @@ -3425,7 +3425,7 @@ func (builder *UserBuilder) CustomAttrs(customAttrs []*UserCustomAttr) *UserBuil return builder } -// 企业邮箱，请先确保已在管理后台启用飞书邮箱服务;;创建用户时，企业邮箱的使用方式参见[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) +// 企业邮箱，请先确保已在管理后台启用飞书邮箱服务;;创建用户时，企业邮箱的使用方式参见 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) // // 示例值：demo@mail.com func (builder *UserBuilder) EnterpriseEmail(enterpriseEmail string) *UserBuilder { @@ -3452,7 +3452,7 @@ func (builder *UserBuilder) IsFrozen(isFrozen bool) *UserBuilder { return builder } -// 职级ID +// 职级 ID // // 示例值：mga5oa8ayjlp9rb func (builder *UserBuilder) JobLevelId(jobLevelId string) *UserBuilder { @@ -3461,7 +3461,7 @@ func (builder *UserBuilder) JobLevelId(jobLevelId string) *UserBuilder { return builder } -// 序列ID +// 序列 ID // // 示例值：mga5oa8ayjlp9rb func (builder *UserBuilder) JobFamilyId(jobFamilyId string) *UserBuilder { @@ -3470,7 +3470,7 @@ func (builder *UserBuilder) JobFamilyId(jobFamilyId string) *UserBuilder { return builder } -// 分配给用户的席位ID列表 +// 分配给用户的席位 ID 列表 // // 示例值： func (builder *UserBuilder) SubscriptionIds(subscriptionIds []string) *UserBuilder { @@ -3615,7 +3615,7 @@ func (builder *UserBuilder) Build() *User { } type UserAssignInfo struct { - SubscriptionId *string `json:"subscription_id,omitempty"` // 席位id + SubscriptionId *string `json:"subscription_id,omitempty"` // 席位 id LicensePlanKey *string `json:"license_plan_key,omitempty"` // license_plan_key ProductName *string `json:"product_name,omitempty"` // 席位名称 I18nName *ProductI18nName `json:"i18n_name,omitempty"` // 国际化名称 @@ -3624,7 +3624,7 @@ type UserAssignInfo struct { } type UserAssignInfoBuilder struct { - subscriptionId string // 席位id + subscriptionId string // 席位 id subscriptionIdFlag bool licensePlanKey string // license_plan_key licensePlanKeyFlag bool @@ -3643,7 +3643,7 @@ func NewUserAssignInfoBuilder() *UserAssignInfoBuilder { return builder } -// 席位id +// 席位 id // // 示例值：7079609167680782300 func (builder *UserAssignInfoBuilder) SubscriptionId(subscriptionId string) *UserAssignInfoBuilder { @@ -3726,13 +3726,13 @@ func (builder *UserAssignInfoBuilder) Build() *UserAssignInfo { } type UserContactInfo struct { - UserId *string `json:"user_id,omitempty"` // 用户id，值为user_id_type所指定的类型。如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则此项为空。 + UserId *string `json:"user_id,omitempty"` // 用户 id，值为 user_id_type 所指定的类型。如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则此项为空。 Mobile *string `json:"mobile,omitempty"` // 手机号，通过手机号查询时返回 Email *string `json:"email,omitempty"` // 邮箱，通过邮箱查询时返回 } type UserContactInfoBuilder struct { - userId string // 用户id，值为user_id_type所指定的类型。如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则此项为空。 + userId string // 用户 id，值为 user_id_type 所指定的类型。如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则此项为空。 userIdFlag bool mobile string // 手机号，通过手机号查询时返回 mobileFlag bool @@ -3745,7 +3745,7 @@ func NewUserContactInfoBuilder() *UserContactInfoBuilder { return builder } -// 用户id，值为user_id_type所指定的类型。如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则此项为空。 +// 用户 id，值为 user_id_type 所指定的类型。如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则此项为空。 // // 示例值：ou_979112345678741d29069abcdef089d4 func (builder *UserContactInfoBuilder) UserId(userId string) *UserContactInfoBuilder { @@ -3790,15 +3790,15 @@ func (builder *UserContactInfoBuilder) Build() *UserContactInfo { } type UserCustomAttr struct { - Type *string `json:"type,omitempty"` // 自定义字段类型 ;- `TEXT`：文本;- `HREF`：网页;- `ENUMERATION`：枚举;- `PICTURE_ENUM`：图片;- `GENERIC_USER`：用户;;具体说明参见常见问题的[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) - Id *string `json:"id,omitempty"` // 自定义字段ID + Type *string `json:"type,omitempty"` // 自定义字段类型 ;- `TEXT`：文本;- `HREF`：网页;- `ENUMERATION`：枚举;- `PICTURE_ENUM`：图片;- `GENERIC_USER`：用户;;具体说明参见常见问题的 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) + Id *string `json:"id,omitempty"` // 自定义字段 ID Value *UserCustomAttrValue `json:"value,omitempty"` // 自定义字段取值 } type UserCustomAttrBuilder struct { - type_ string // 自定义字段类型 ;- `TEXT`：文本;- `HREF`：网页;- `ENUMERATION`：枚举;- `PICTURE_ENUM`：图片;- `GENERIC_USER`：用户;;具体说明参见常见问题的[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) + type_ string // 自定义字段类型 ;- `TEXT`：文本;- `HREF`：网页;- `ENUMERATION`：枚举;- `PICTURE_ENUM`：图片;- `GENERIC_USER`：用户;;具体说明参见常见问题的 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) typeFlag bool - id string // 自定义字段ID + id string // 自定义字段 ID idFlag bool value *UserCustomAttrValue // 自定义字段取值 valueFlag bool @@ -3809,7 +3809,7 @@ func NewUserCustomAttrBuilder() *UserCustomAttrBuilder { return builder } -// 自定义字段类型 ;- `TEXT`：文本;- `HREF`：网页;- `ENUMERATION`：枚举;- `PICTURE_ENUM`：图片;- `GENERIC_USER`：用户;;具体说明参见常见问题的[用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) +// 自定义字段类型 ;- `TEXT`：文本;- `HREF`：网页;- `ENUMERATION`：枚举;- `PICTURE_ENUM`：图片;- `GENERIC_USER`：用户;;具体说明参见常见问题的 [用户接口相关问题](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#77061525) // // 示例值：TEXT func (builder *UserCustomAttrBuilder) Type(type_ string) *UserCustomAttrBuilder { @@ -3818,7 +3818,7 @@ func (builder *UserCustomAttrBuilder) Type(type_ string) *UserCustomAttrBuilder return builder } -// 自定义字段ID +// 自定义字段 ID // // 示例值：DemoId func (builder *UserCustomAttrBuilder) Id(id string) *UserCustomAttrBuilder { @@ -3854,8 +3854,8 @@ func (builder *UserCustomAttrBuilder) Build() *UserCustomAttr { type UserCustomAttrValue struct { Text *string `json:"text,omitempty"` // 字段类型为`TEXT`时该参数定义字段值，必填；字段类型为`HREF`时该参数定义网页标题，必填 - Url *string `json:"url,omitempty"` // 字段类型为 HREF 时，该参数定义默认 URL，例如手机端跳转小程序，PC端跳转网页 - PcUrl *string `json:"pc_url,omitempty"` // 字段类型为 HREF 时，该参数定义PC端 URL + Url *string `json:"url,omitempty"` // 字段类型为 HREF 时，该参数定义默认 URL，例如手机端跳转小程序，PC 端跳转网页 + PcUrl *string `json:"pc_url,omitempty"` // 字段类型为 HREF 时，该参数定义 PC 端 URL OptionId *string `json:"option_id,omitempty"` // 字段类型为 ENUMERATION 或 PICTURE_ENUM 时，该参数定义选项值 OptionValue *string `json:"option_value,omitempty"` // 选项类型的值。;;表示 成员详情/自定义字段 中选项选中的值 Name *string `json:"name,omitempty"` // 选项类型为图片时，表示图片的名称 @@ -3866,9 +3866,9 @@ type UserCustomAttrValue struct { type UserCustomAttrValueBuilder struct { text string // 字段类型为`TEXT`时该参数定义字段值，必填；字段类型为`HREF`时该参数定义网页标题，必填 textFlag bool - url string // 字段类型为 HREF 时，该参数定义默认 URL，例如手机端跳转小程序，PC端跳转网页 + url string // 字段类型为 HREF 时，该参数定义默认 URL，例如手机端跳转小程序，PC 端跳转网页 urlFlag bool - pcUrl string // 字段类型为 HREF 时，该参数定义PC端 URL + pcUrl string // 字段类型为 HREF 时，该参数定义 PC 端 URL pcUrlFlag bool optionId string // 字段类型为 ENUMERATION 或 PICTURE_ENUM 时，该参数定义选项值 optionIdFlag bool @@ -3896,7 +3896,7 @@ func (builder *UserCustomAttrValueBuilder) Text(text string) *UserCustomAttrValu return builder } -// 字段类型为 HREF 时，该参数定义默认 URL，例如手机端跳转小程序，PC端跳转网页 +// 字段类型为 HREF 时，该参数定义默认 URL，例如手机端跳转小程序，PC 端跳转网页 // // 示例值：http://www.fs.cn func (builder *UserCustomAttrValueBuilder) Url(url string) *UserCustomAttrValueBuilder { @@ -3905,7 +3905,7 @@ func (builder *UserCustomAttrValueBuilder) Url(url string) *UserCustomAttrValueB return builder } -// 字段类型为 HREF 时，该参数定义PC端 URL +// 字段类型为 HREF 时，该参数定义 PC 端 URL // // 示例值：http://www.fs.cn func (builder *UserCustomAttrValueBuilder) PcUrl(pcUrl string) *UserCustomAttrValueBuilder { @@ -3996,13 +3996,13 @@ func (builder *UserCustomAttrValueBuilder) Build() *UserCustomAttrValue { } type UserDepartmentInfo struct { - DepartmentId *string `json:"department_id,omitempty"` // 对应的部门ID + DepartmentId *string `json:"department_id,omitempty"` // 对应的部门 ID UserOrder *int `json:"user_order,omitempty"` // 用户在部门内的排序 DepartmentOrder *int `json:"department_order,omitempty"` // 用户的部门间的排序 } type UserDepartmentInfoBuilder struct { - departmentId string // 对应的部门ID + departmentId string // 对应的部门 ID departmentIdFlag bool userOrder int // 用户在部门内的排序 userOrderFlag bool @@ -4015,7 +4015,7 @@ func NewUserDepartmentInfoBuilder() *UserDepartmentInfoBuilder { return builder } -// 对应的部门ID +// 对应的部门 ID // // 示例值： func (builder *UserDepartmentInfoBuilder) DepartmentId(departmentId string) *UserDepartmentInfoBuilder { @@ -4060,8 +4060,8 @@ func (builder *UserDepartmentInfoBuilder) Build() *UserDepartmentInfo { } type UserEvent struct { - OpenId *string `json:"open_id,omitempty"` // 用户的open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) - UnionId *string `json:"union_id,omitempty"` // 用户的union_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + OpenId *string `json:"open_id,omitempty"` // 用户的 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + UnionId *string `json:"union_id,omitempty"` // 用户的 union_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) Name *string `json:"name,omitempty"` // 用户名 EnName *string `json:"en_name,omitempty"` // 英文名 @@ -4074,8 +4074,8 @@ type UserEvent struct { Gender *int `json:"gender,omitempty"` // 性别 Avatar *AvatarInfo `json:"avatar,omitempty"` // 用户头像信息 Status *UserStatus `json:"status,omitempty"` // 用户状态 - DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的ID列表 - LeaderUserId *string `json:"leader_user_id,omitempty"` // 用户的直接主管的用户open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + DepartmentIds []string `json:"department_ids,omitempty"` // 用户所属部门的 ID 列表 + LeaderUserId *string `json:"leader_user_id,omitempty"` // 用户的直接主管的用户 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) City *string `json:"city,omitempty"` // 城市 Country *string `json:"country,omitempty"` // 国家 WorkStation *string `json:"work_station,omitempty"` // 工位 @@ -4087,14 +4087,14 @@ type UserEvent struct { Orders []*UserOrder `json:"orders,omitempty"` // 用户排序信息 CustomAttrs []*UserCustomAttr `json:"custom_attrs,omitempty"` // 自定义属性 - JobLevelId *string `json:"job_level_id,omitempty"` // 职级ID - JobFamilyId *string `json:"job_family_id,omitempty"` // 序列ID + JobLevelId *string `json:"job_level_id,omitempty"` // 职级 ID + JobFamilyId *string `json:"job_family_id,omitempty"` // 序列 ID } type UserEventBuilder struct { - openId string // 用户的open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + openId string // 用户的 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) openIdFlag bool - unionId string // 用户的union_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + unionId string // 用户的 union_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) unionIdFlag bool userId string // 租户内用户的唯一标识 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) userIdFlag bool @@ -4119,9 +4119,9 @@ type UserEventBuilder struct { avatarFlag bool status *UserStatus // 用户状态 statusFlag bool - departmentIds []string // 用户所属部门的ID列表 + departmentIds []string // 用户所属部门的 ID 列表 departmentIdsFlag bool - leaderUserId string // 用户的直接主管的用户open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + leaderUserId string // 用户的直接主管的用户 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) leaderUserIdFlag bool city string // 城市 cityFlag bool @@ -4142,9 +4142,9 @@ type UserEventBuilder struct { customAttrs []*UserCustomAttr // 自定义属性 customAttrsFlag bool - jobLevelId string // 职级ID + jobLevelId string // 职级 ID jobLevelIdFlag bool - jobFamilyId string // 序列ID + jobFamilyId string // 序列 ID jobFamilyIdFlag bool } @@ -4153,7 +4153,7 @@ func NewUserEventBuilder() *UserEventBuilder { return builder } -// 用户的open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *UserEventBuilder) OpenId(openId string) *UserEventBuilder { @@ -4162,7 +4162,7 @@ func (builder *UserEventBuilder) OpenId(openId string) *UserEventBuilder { return builder } -// 用户的union_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的 union_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：on_576833b917gda3d939b9a3c2d53e72c8 func (builder *UserEventBuilder) UnionId(unionId string) *UserEventBuilder { @@ -4270,7 +4270,7 @@ func (builder *UserEventBuilder) Status(status *UserStatus) *UserEventBuilder { return builder } -// 用户所属部门的ID列表 +// 用户所属部门的 ID 列表 // // 示例值： func (builder *UserEventBuilder) DepartmentIds(departmentIds []string) *UserEventBuilder { @@ -4279,7 +4279,7 @@ func (builder *UserEventBuilder) DepartmentIds(departmentIds []string) *UserEven return builder } -// 用户的直接主管的用户open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户的直接主管的用户 open_id [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：ou_3ghm8a2u0eftg0ff377125s5dd275z09 func (builder *UserEventBuilder) LeaderUserId(leaderUserId string) *UserEventBuilder { @@ -4360,7 +4360,7 @@ func (builder *UserEventBuilder) CustomAttrs(customAttrs []*UserCustomAttr) *Use return builder } -// 职级ID +// 职级 ID // // 示例值：mga5oa8ayjlp9rb func (builder *UserEventBuilder) JobLevelId(jobLevelId string) *UserEventBuilder { @@ -4369,7 +4369,7 @@ func (builder *UserEventBuilder) JobLevelId(jobLevelId string) *UserEventBuilder return builder } -// 序列ID +// 序列 ID // // 示例值：mga5oa8ayjlp9rb func (builder *UserEventBuilder) JobFamilyId(jobFamilyId string) *UserEventBuilder { @@ -4483,7 +4483,7 @@ func (builder *UserEventBuilder) Build() *UserEvent { } type UserGroup struct { - UserGroupId *string `json:"user_group_id,omitempty"` // 用户组的自定义ID + UserGroupId *string `json:"user_group_id,omitempty"` // 用户组的自定义 ID Name *string `json:"name,omitempty"` // 用户组的名称 Type *int `json:"type,omitempty"` // 用户组的类型 MemberCount *int `json:"member_count,omitempty"` // 成员数量 @@ -4491,7 +4491,7 @@ type UserGroup struct { } type UserGroupBuilder struct { - userGroupId string // 用户组的自定义ID + userGroupId string // 用户组的自定义 ID userGroupIdFlag bool name string // 用户组的名称 nameFlag bool @@ -4508,7 +4508,7 @@ func NewUserGroupBuilder() *UserGroupBuilder { return builder } -// 用户组的自定义ID +// 用户组的自定义 ID // // 示例值：test func (builder *UserGroupBuilder) UserGroupId(userGroupId string) *UserGroupBuilder { @@ -4646,13 +4646,13 @@ func (builder *UserIdBuilder) Build() *UserId { } type UserOrder struct { - DepartmentId *string `json:"department_id,omitempty"` // 排序信息对应的部门ID， ID值与查询参数中的department_id_type 对应。;;表示用户所在的、且需要排序的部门。;;不同 ID 的说明参见及获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) + DepartmentId *string `json:"department_id,omitempty"` // 排序信息对应的部门 ID， ID 值与查询参数中的 department_id_type 对应。;;表示用户所在的、且需要排序的部门。;;不同 ID 的说明参见及获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) UserOrder *int `json:"user_order,omitempty"` // 用户在其直属部门内的排序，数值越大，排序越靠前 DepartmentOrder *int `json:"department_order,omitempty"` // 用户所属的多个部门间的排序，数值越大，排序越靠前 } type UserOrderBuilder struct { - departmentId string // 排序信息对应的部门ID， ID值与查询参数中的department_id_type 对应。;;表示用户所在的、且需要排序的部门。;;不同 ID 的说明参见及获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) + departmentId string // 排序信息对应的部门 ID， ID 值与查询参数中的 department_id_type 对应。;;表示用户所在的、且需要排序的部门。;;不同 ID 的说明参见及获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) departmentIdFlag bool userOrder int // 用户在其直属部门内的排序，数值越大，排序越靠前 userOrderFlag bool @@ -4665,7 +4665,7 @@ func NewUserOrderBuilder() *UserOrderBuilder { return builder } -// 排序信息对应的部门ID， ID值与查询参数中的department_id_type 对应。;;表示用户所在的、且需要排序的部门。;;不同 ID 的说明参见及获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) +// 排序信息对应的部门 ID， ID 值与查询参数中的 department_id_type 对应。;;表示用户所在的、且需要排序的部门。;;不同 ID 的说明参见及获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *UserOrderBuilder) DepartmentId(departmentId string) *UserOrderBuilder { @@ -4710,26 +4710,26 @@ func (builder *UserOrderBuilder) Build() *UserOrder { } type UserPosition struct { - PositionCode *string `json:"position_code,omitempty"` // 岗位Code + PositionCode *string `json:"position_code,omitempty"` // 岗位 Code PositionName *string `json:"position_name,omitempty"` // 岗位名称 - DepartmentId *string `json:"department_id,omitempty"` // 岗位部门ID - LeaderUserId *string `json:"leader_user_id,omitempty"` // 上级领导ID - LeaderPositionCode *string `json:"leader_position_code,omitempty"` // 本岗位领导的岗位code - IsMajor *bool `json:"is_major,omitempty"` // 是否主岗，只允许一个主岗sd + DepartmentId *string `json:"department_id,omitempty"` // 岗位部门 ID + LeaderUserId *string `json:"leader_user_id,omitempty"` // 上级领导 ID + LeaderPositionCode *string `json:"leader_position_code,omitempty"` // 本岗位领导的岗位 code + IsMajor *bool `json:"is_major,omitempty"` // 是否主岗，只允许一个主岗 sd } type UserPositionBuilder struct { - positionCode string // 岗位Code + positionCode string // 岗位 Code positionCodeFlag bool positionName string // 岗位名称 positionNameFlag bool - departmentId string // 岗位部门ID + departmentId string // 岗位部门 ID departmentIdFlag bool - leaderUserId string // 上级领导ID + leaderUserId string // 上级领导 ID leaderUserIdFlag bool - leaderPositionCode string // 本岗位领导的岗位code + leaderPositionCode string // 本岗位领导的岗位 code leaderPositionCodeFlag bool - isMajor bool // 是否主岗，只允许一个主岗sd + isMajor bool // 是否主岗，只允许一个主岗 sd isMajorFlag bool } @@ -4738,7 +4738,7 @@ func NewUserPositionBuilder() *UserPositionBuilder { return builder } -// 岗位Code +// 岗位 Code // // 示例值： func (builder *UserPositionBuilder) PositionCode(positionCode string) *UserPositionBuilder { @@ -4756,7 +4756,7 @@ func (builder *UserPositionBuilder) PositionName(positionName string) *UserPosit return builder } -// 岗位部门ID +// 岗位部门 ID // // 示例值： func (builder *UserPositionBuilder) DepartmentId(departmentId string) *UserPositionBuilder { @@ -4765,7 +4765,7 @@ func (builder *UserPositionBuilder) DepartmentId(departmentId string) *UserPosit return builder } -// 上级领导ID +// 上级领导 ID // // 示例值： func (builder *UserPositionBuilder) LeaderUserId(leaderUserId string) *UserPositionBuilder { @@ -4774,7 +4774,7 @@ func (builder *UserPositionBuilder) LeaderUserId(leaderUserId string) *UserPosit return builder } -// 本岗位领导的岗位code +// 本岗位领导的岗位 code // // 示例值： func (builder *UserPositionBuilder) LeaderPositionCode(leaderPositionCode string) *UserPositionBuilder { @@ -4783,7 +4783,7 @@ func (builder *UserPositionBuilder) LeaderPositionCode(leaderPositionCode string return builder } -// 是否主岗，只允许一个主岗sd +// 是否主岗，只允许一个主岗 sd // // 示例值： func (builder *UserPositionBuilder) IsMajor(isMajor bool) *UserPositionBuilder { @@ -5003,7 +5003,7 @@ func (builder *ChildrenDepartmentReqBuilder) Limit(limit int) *ChildrenDepartmen return builder } -// 部门ID，根部门的部门ID 为0;;department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 部门 ID，根部门的部门 ID 为 0;;department_id 的获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：D096 func (builder *ChildrenDepartmentReqBuilder) DepartmentId(departmentId string) *ChildrenDepartmentReqBuilder { @@ -5011,7 +5011,7 @@ func (builder *ChildrenDepartmentReqBuilder) DepartmentId(departmentId string) * return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ChildrenDepartmentReqBuilder) UserIdType(userIdType string) *ChildrenDepartmentReqBuilder { @@ -5019,7 +5019,7 @@ func (builder *ChildrenDepartmentReqBuilder) UserIdType(userIdType string) *Chil return builder } -// 此次调用中使用的部门ID的类型;;不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 此次调用中使用的部门 ID 的类型;;不同 ID 的说明与 department_id 的获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：open_department_id func (builder *ChildrenDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *ChildrenDepartmentReqBuilder { @@ -5043,7 +5043,7 @@ func (builder *ChildrenDepartmentReqBuilder) PageSize(pageSize int) *ChildrenDep return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该page_token 获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 // // 示例值：AQD9/Rn9eij9Pm39ED40/RD/cIFmu77WxpxPB/2oHfQLZ+G8JG6tK7+ZnHiT7COhD2hMSICh/eBl7cpzU6JEC3J7COKNe4jrQ8ExwBCR func (builder *ChildrenDepartmentReqBuilder) PageToken(pageToken string) *ChildrenDepartmentReqBuilder { @@ -5068,7 +5068,7 @@ type ChildrenDepartmentReq struct { type ChildrenDepartmentRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*Department `json:"items,omitempty"` // 部门列表 } @@ -5096,7 +5096,7 @@ func NewCreateDepartmentReqBuilder() *CreateDepartmentReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateDepartmentReqBuilder) UserIdType(userIdType string) *CreateDepartmentReqBuilder { @@ -5104,7 +5104,7 @@ func (builder *CreateDepartmentReqBuilder) UserIdType(userIdType string) *Create return builder } -// 此次调用中使用的部门ID的类型;;不同 ID 的说明参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 此次调用中使用的部门 ID 的类型;;不同 ID 的说明参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：open_department_id func (builder *CreateDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *CreateDepartmentReqBuilder { @@ -5166,7 +5166,7 @@ func NewDeleteDepartmentReqBuilder() *DeleteDepartmentReqBuilder { return builder } -// 部门ID，需要与查询参数中传入的department_id_type类型保持一致。 +// 部门 ID，需要与查询参数中传入的 department_id_type 类型保持一致。 // // 示例值：D096 func (builder *DeleteDepartmentReqBuilder) DepartmentId(departmentId string) *DeleteDepartmentReqBuilder { @@ -5174,7 +5174,7 @@ func (builder *DeleteDepartmentReqBuilder) DepartmentId(departmentId string) *De return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *DeleteDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *DeleteDepartmentReqBuilder { @@ -5216,7 +5216,7 @@ func NewGetDepartmentReqBuilder() *GetDepartmentReqBuilder { return builder } -// 需要获取的部门ID;;不同 ID 的说明及获取方式 参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 需要获取的部门 ID;;不同 ID 的说明及获取方式 参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：D096 func (builder *GetDepartmentReqBuilder) DepartmentId(departmentId string) *GetDepartmentReqBuilder { @@ -5224,7 +5224,7 @@ func (builder *GetDepartmentReqBuilder) DepartmentId(departmentId string) *GetDe return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetDepartmentReqBuilder) UserIdType(userIdType string) *GetDepartmentReqBuilder { @@ -5232,7 +5232,7 @@ func (builder *GetDepartmentReqBuilder) UserIdType(userIdType string) *GetDepart return builder } -// 此次调用中使用的部门ID的类型;;不同 ID 的说明 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 此次调用中使用的部门 ID 的类型;;不同 ID 的说明 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：open_department_id func (builder *GetDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *GetDepartmentReqBuilder { @@ -5286,7 +5286,7 @@ func (builder *ListDepartmentReqBuilder) Limit(limit int) *ListDepartmentReqBuil return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListDepartmentReqBuilder) UserIdType(userIdType string) *ListDepartmentReqBuilder { @@ -5294,7 +5294,7 @@ func (builder *ListDepartmentReqBuilder) UserIdType(userIdType string) *ListDepa return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值： func (builder *ListDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *ListDepartmentReqBuilder { @@ -5302,7 +5302,7 @@ func (builder *ListDepartmentReqBuilder) DepartmentIdType(departmentIdType strin return builder } -// 父部门的ID，填上获取部门下所有子部门 +// 父部门的 ID，填上获取部门下所有子部门 // // 示例值： func (builder *ListDepartmentReqBuilder) ParentDepartmentId(parentDepartmentId string) *ListDepartmentReqBuilder { @@ -5350,7 +5350,7 @@ type ListDepartmentReq struct { type ListDepartmentRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*Department `json:"items,omitempty"` // } @@ -5384,7 +5384,7 @@ func (builder *ParentDepartmentReqBuilder) Limit(limit int) *ParentDepartmentReq return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ParentDepartmentReqBuilder) UserIdType(userIdType string) *ParentDepartmentReqBuilder { @@ -5392,7 +5392,7 @@ func (builder *ParentDepartmentReqBuilder) UserIdType(userIdType string) *Parent return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *ParentDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *ParentDepartmentReqBuilder { @@ -5400,7 +5400,7 @@ func (builder *ParentDepartmentReqBuilder) DepartmentIdType(departmentIdType str return builder } -// 部门ID +// 部门 ID // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *ParentDepartmentReqBuilder) DepartmentId(departmentId string) *ParentDepartmentReqBuilder { @@ -5440,7 +5440,7 @@ type ParentDepartmentReq struct { type ParentDepartmentRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*Department `json:"items,omitempty"` // } @@ -5468,7 +5468,7 @@ func NewPatchDepartmentReqBuilder() *PatchDepartmentReqBuilder { return builder } -// 部门ID，需要与查询参数中传入的department_id_type类型保持一致。;;注意：除需要满足正则规则外，同时不能以od-开头 +// 部门 ID，需要与查询参数中传入的 department_id_type 类型保持一致。;;注意：除需要满足正则规则外，同时不能以 od-开头 // // 示例值：D096 func (builder *PatchDepartmentReqBuilder) DepartmentId(departmentId string) *PatchDepartmentReqBuilder { @@ -5476,7 +5476,7 @@ func (builder *PatchDepartmentReqBuilder) DepartmentId(departmentId string) *Pat return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchDepartmentReqBuilder) UserIdType(userIdType string) *PatchDepartmentReqBuilder { @@ -5484,7 +5484,7 @@ func (builder *PatchDepartmentReqBuilder) UserIdType(userIdType string) *PatchDe return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *PatchDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *PatchDepartmentReqBuilder { @@ -5601,7 +5601,7 @@ func (builder *SearchDepartmentReqBuilder) Limit(limit int) *SearchDepartmentReq return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SearchDepartmentReqBuilder) UserIdType(userIdType string) *SearchDepartmentReqBuilder { @@ -5609,7 +5609,7 @@ func (builder *SearchDepartmentReqBuilder) UserIdType(userIdType string) *Search return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *SearchDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *SearchDepartmentReqBuilder { @@ -5676,7 +5676,7 @@ func (resp *SearchDepartmentResp) Success() bool { } type UnbindDepartmentChatDepartmentReqBodyBuilder struct { - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool } @@ -5685,7 +5685,7 @@ func NewUnbindDepartmentChatDepartmentReqBodyBuilder() *UnbindDepartmentChatDepa return builder } -// 部门ID +// 部门 ID // //示例值：D096 func (builder *UnbindDepartmentChatDepartmentReqBodyBuilder) DepartmentId(departmentId string) *UnbindDepartmentChatDepartmentReqBodyBuilder { @@ -5703,7 +5703,7 @@ func (builder *UnbindDepartmentChatDepartmentReqBodyBuilder) Build() *UnbindDepa } type UnbindDepartmentChatDepartmentPathReqBodyBuilder struct { - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool } @@ -5712,7 +5712,7 @@ func NewUnbindDepartmentChatDepartmentPathReqBodyBuilder() *UnbindDepartmentChat return builder } -// 部门ID +// 部门 ID // // 示例值：D096 func (builder *UnbindDepartmentChatDepartmentPathReqBodyBuilder) DepartmentId(departmentId string) *UnbindDepartmentChatDepartmentPathReqBodyBuilder { @@ -5743,7 +5743,7 @@ func NewUnbindDepartmentChatDepartmentReqBuilder() *UnbindDepartmentChatDepartme return builder } -// 此次调用中使用的部门ID的类型，默认为"open_department_id" +// 此次调用中使用的部门 ID 的类型，默认为"open_department_id" // // 示例值：open_department_id func (builder *UnbindDepartmentChatDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *UnbindDepartmentChatDepartmentReqBuilder { @@ -5766,7 +5766,7 @@ func (builder *UnbindDepartmentChatDepartmentReqBuilder) Build() *UnbindDepartme } type UnbindDepartmentChatDepartmentReqBody struct { - DepartmentId *string `json:"department_id,omitempty"` // 部门ID + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID } type UnbindDepartmentChatDepartmentReq struct { @@ -5797,7 +5797,7 @@ func NewUpdateDepartmentReqBuilder() *UpdateDepartmentReqBuilder { return builder } -// 部门ID，需要与查询参数中传入的department_id_type类型保持一致。;;;注意：除需要满足正则规则外，同时不能以od-开头 +// 部门 ID，需要与查询参数中传入的 department_id_type 类型保持一致。;;;注意：除需要满足正则规则外，同时不能以 od-开头 // // 示例值：D096 func (builder *UpdateDepartmentReqBuilder) DepartmentId(departmentId string) *UpdateDepartmentReqBuilder { @@ -5805,7 +5805,7 @@ func (builder *UpdateDepartmentReqBuilder) DepartmentId(departmentId string) *Up return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateDepartmentReqBuilder) UserIdType(userIdType string) *UpdateDepartmentReqBuilder { @@ -5813,7 +5813,7 @@ func (builder *UpdateDepartmentReqBuilder) UserIdType(userIdType string) *Update return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *UpdateDepartmentReqBuilder) DepartmentIdType(departmentIdType string) *UpdateDepartmentReqBuilder { @@ -5914,7 +5914,7 @@ func NewDeleteEmployeeTypeEnumReqBuilder() *DeleteEmployeeTypeEnumReqBuilder { return builder } -// 枚举值id +// 枚举值 id // // 示例值：exGeIjow7zIqWMy+ONkFxA== func (builder *DeleteEmployeeTypeEnumReqBuilder) EnumId(enumId string) *DeleteEmployeeTypeEnumReqBuilder { @@ -5995,7 +5995,7 @@ type ListEmployeeTypeEnumReq struct { type ListEmployeeTypeEnumRespData struct { Items []*EmployeeTypeEnum `json:"items,omitempty"` // 枚举数据 HasMore *bool `json:"has_more,omitempty"` // 是否下一页 - PageToken *string `json:"page_token,omitempty"` // 分页token + PageToken *string `json:"page_token,omitempty"` // 分页 token } type ListEmployeeTypeEnumResp struct { @@ -6022,7 +6022,7 @@ func NewUpdateEmployeeTypeEnumReqBuilder() *UpdateEmployeeTypeEnumReqBuilder { return builder } -// 枚举值id +// 枚举值 id // // 示例值：exGeIjow7zIqWMy+ONkFxA== func (builder *UpdateEmployeeTypeEnumReqBuilder) EnumId(enumId string) *UpdateEmployeeTypeEnumReqBuilder { @@ -6154,7 +6154,7 @@ type CreateFunctionalRoleReq struct { } type CreateFunctionalRoleRespData struct { - RoleId *string `json:"role_id,omitempty"` // 角色ID，在单租户下唯一 + RoleId *string `json:"role_id,omitempty"` // 角色 ID，在单租户下唯一 } type CreateFunctionalRoleResp struct { @@ -6317,7 +6317,7 @@ func (resp *UpdateFunctionalRoleResp) Success() bool { } type BatchCreateFunctionalRoleMemberReqBodyBuilder struct { - members []string // 角色添加的角色成员列表（一批用户的UserID列表) + members []string // 角色添加的角色成员列表（一批用户的 UserID 列表) membersFlag bool } @@ -6326,7 +6326,7 @@ func NewBatchCreateFunctionalRoleMemberReqBodyBuilder() *BatchCreateFunctionalRo return builder } -// 角色添加的角色成员列表（一批用户的UserID列表) +// 角色添加的角色成员列表（一批用户的 UserID 列表) // //示例值： func (builder *BatchCreateFunctionalRoleMemberReqBodyBuilder) Members(members []string) *BatchCreateFunctionalRoleMemberReqBodyBuilder { @@ -6344,7 +6344,7 @@ func (builder *BatchCreateFunctionalRoleMemberReqBodyBuilder) Build() *BatchCrea } type BatchCreateFunctionalRoleMemberPathReqBodyBuilder struct { - members []string // 角色添加的角色成员列表（一批用户的UserID列表) + members []string // 角色添加的角色成员列表（一批用户的 UserID 列表) membersFlag bool } @@ -6353,7 +6353,7 @@ func NewBatchCreateFunctionalRoleMemberPathReqBodyBuilder() *BatchCreateFunction return builder } -// 角色添加的角色成员列表（一批用户的UserID列表) +// 角色添加的角色成员列表（一批用户的 UserID 列表) // // 示例值： func (builder *BatchCreateFunctionalRoleMemberPathReqBodyBuilder) Members(members []string) *BatchCreateFunctionalRoleMemberPathReqBodyBuilder { @@ -6392,7 +6392,7 @@ func (builder *BatchCreateFunctionalRoleMemberReqBuilder) RoleId(roleId string) return builder } -// 成员ID类型 +// 成员 ID 类型 // // 示例值：open_id func (builder *BatchCreateFunctionalRoleMemberReqBuilder) UserIdType(userIdType string) *BatchCreateFunctionalRoleMemberReqBuilder { @@ -6416,7 +6416,7 @@ func (builder *BatchCreateFunctionalRoleMemberReqBuilder) Build() *BatchCreateFu } type BatchCreateFunctionalRoleMemberReqBody struct { - Members []string `json:"members,omitempty"` // 角色添加的角色成员列表（一批用户的UserID列表) + Members []string `json:"members,omitempty"` // 角色添加的角色成员列表（一批用户的 UserID 列表) } type BatchCreateFunctionalRoleMemberReq struct { @@ -6439,7 +6439,7 @@ func (resp *BatchCreateFunctionalRoleMemberResp) Success() bool { } type BatchDeleteFunctionalRoleMemberReqBodyBuilder struct { - members []string // 角色删除的角色成员列表（一批用户的UserID列表) + members []string // 角色删除的角色成员列表（一批用户的 UserID 列表) membersFlag bool } @@ -6448,7 +6448,7 @@ func NewBatchDeleteFunctionalRoleMemberReqBodyBuilder() *BatchDeleteFunctionalRo return builder } -// 角色删除的角色成员列表（一批用户的UserID列表) +// 角色删除的角色成员列表（一批用户的 UserID 列表) // //示例值： func (builder *BatchDeleteFunctionalRoleMemberReqBodyBuilder) Members(members []string) *BatchDeleteFunctionalRoleMemberReqBodyBuilder { @@ -6466,7 +6466,7 @@ func (builder *BatchDeleteFunctionalRoleMemberReqBodyBuilder) Build() *BatchDele } type BatchDeleteFunctionalRoleMemberPathReqBodyBuilder struct { - members []string // 角色删除的角色成员列表（一批用户的UserID列表) + members []string // 角色删除的角色成员列表（一批用户的 UserID 列表) membersFlag bool } @@ -6475,7 +6475,7 @@ func NewBatchDeleteFunctionalRoleMemberPathReqBodyBuilder() *BatchDeleteFunction return builder } -// 角色删除的角色成员列表（一批用户的UserID列表) +// 角色删除的角色成员列表（一批用户的 UserID 列表) // // 示例值： func (builder *BatchDeleteFunctionalRoleMemberPathReqBodyBuilder) Members(members []string) *BatchDeleteFunctionalRoleMemberPathReqBodyBuilder { @@ -6514,7 +6514,7 @@ func (builder *BatchDeleteFunctionalRoleMemberReqBuilder) RoleId(roleId string) return builder } -// 成员ID类型 +// 成员 ID 类型 // // 示例值：open_id func (builder *BatchDeleteFunctionalRoleMemberReqBuilder) UserIdType(userIdType string) *BatchDeleteFunctionalRoleMemberReqBuilder { @@ -6538,7 +6538,7 @@ func (builder *BatchDeleteFunctionalRoleMemberReqBuilder) Build() *BatchDeleteFu } type BatchDeleteFunctionalRoleMemberReqBody struct { - Members []string `json:"members,omitempty"` // 角色删除的角色成员列表（一批用户的UserID列表) + Members []string `json:"members,omitempty"` // 角色删除的角色成员列表（一批用户的 UserID 列表) } type BatchDeleteFunctionalRoleMemberReq struct { @@ -6581,7 +6581,7 @@ func (builder *GetFunctionalRoleMemberReqBuilder) RoleId(roleId string) *GetFunc return builder } -// 要查询的角色内成员ID +// 要查询的角色内成员 ID // // 示例值：od-123456 func (builder *GetFunctionalRoleMemberReqBuilder) MemberId(memberId string) *GetFunctionalRoleMemberReqBuilder { @@ -6597,7 +6597,7 @@ func (builder *GetFunctionalRoleMemberReqBuilder) UserIdType(userIdType string) return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *GetFunctionalRoleMemberReqBuilder) DepartmentIdType(departmentIdType string) *GetFunctionalRoleMemberReqBuilder { @@ -6683,7 +6683,7 @@ func (builder *ListFunctionalRoleMemberReqBuilder) UserIdType(userIdType string) return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *ListFunctionalRoleMemberReqBuilder) DepartmentIdType(departmentIdType string) *ListFunctionalRoleMemberReqBuilder { @@ -6723,7 +6723,7 @@ func (resp *ListFunctionalRoleMemberResp) Success() bool { } type ScopesFunctionalRoleMemberReqBodyBuilder struct { - members []string // 角色修改的角色成员列表（一批用户的UserID列表) + members []string // 角色修改的角色成员列表（一批用户的 UserID 列表) membersFlag bool departments []string // 角色内用户的管理范围 departmentsFlag bool @@ -6734,7 +6734,7 @@ func NewScopesFunctionalRoleMemberReqBodyBuilder() *ScopesFunctionalRoleMemberRe return builder } -// 角色修改的角色成员列表（一批用户的UserID列表) +// 角色修改的角色成员列表（一批用户的 UserID 列表) // //示例值： func (builder *ScopesFunctionalRoleMemberReqBodyBuilder) Members(members []string) *ScopesFunctionalRoleMemberReqBodyBuilder { @@ -6764,7 +6764,7 @@ func (builder *ScopesFunctionalRoleMemberReqBodyBuilder) Build() *ScopesFunction } type ScopesFunctionalRoleMemberPathReqBodyBuilder struct { - members []string // 角色修改的角色成员列表（一批用户的UserID列表) + members []string // 角色修改的角色成员列表（一批用户的 UserID 列表) membersFlag bool departments []string // 角色内用户的管理范围 departmentsFlag bool @@ -6775,7 +6775,7 @@ func NewScopesFunctionalRoleMemberPathReqBodyBuilder() *ScopesFunctionalRoleMemb return builder } -// 角色修改的角色成员列表（一批用户的UserID列表) +// 角色修改的角色成员列表（一批用户的 UserID 列表) // // 示例值： func (builder *ScopesFunctionalRoleMemberPathReqBodyBuilder) Members(members []string) *ScopesFunctionalRoleMemberPathReqBodyBuilder { @@ -6834,7 +6834,7 @@ func (builder *ScopesFunctionalRoleMemberReqBuilder) UserIdType(userIdType strin return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *ScopesFunctionalRoleMemberReqBuilder) DepartmentIdType(departmentIdType string) *ScopesFunctionalRoleMemberReqBuilder { @@ -6858,7 +6858,7 @@ func (builder *ScopesFunctionalRoleMemberReqBuilder) Build() *ScopesFunctionalRo } type ScopesFunctionalRoleMemberReqBody struct { - Members []string `json:"members,omitempty"` // 角色修改的角色成员列表（一批用户的UserID列表) + Members []string `json:"members,omitempty"` // 角色修改的角色成员列表（一批用户的 UserID 列表) Departments []string `json:"departments,omitempty"` // 角色内用户的管理范围 } @@ -6882,13 +6882,13 @@ func (resp *ScopesFunctionalRoleMemberResp) Success() bool { } type CreateGroupReqBodyBuilder struct { - groupId string // 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义group_id数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 + groupId string // 自定义用户组 ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义 group_id 数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 groupIdFlag bool name string // 用户组的名字，企业内唯一，最大长度：100 字符 nameFlag bool description string // 用户组描述 descriptionFlag bool - type_ int // 用户组的类型。默认为1表示普通用户组 + type_ int // 用户组的类型。默认为 1 表示普通用户组 typeFlag bool } @@ -6897,7 +6897,7 @@ func NewCreateGroupReqBodyBuilder() *CreateGroupReqBodyBuilder { return builder } -// 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义group_id数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 +// 自定义用户组 ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义 group_id 数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 // //示例值：g122817 func (builder *CreateGroupReqBodyBuilder) GroupId(groupId string) *CreateGroupReqBodyBuilder { @@ -6917,14 +6917,14 @@ func (builder *CreateGroupReqBodyBuilder) Name(name string) *CreateGroupReqBodyB // 用户组描述 // -//示例值：IT服务人员的集合 +//示例值：IT 服务人员的集合 func (builder *CreateGroupReqBodyBuilder) Description(description string) *CreateGroupReqBodyBuilder { builder.description = description builder.descriptionFlag = true return builder } -// 用户组的类型。默认为1表示普通用户组 +// 用户组的类型。默认为 1 表示普通用户组 // //示例值：1 func (builder *CreateGroupReqBodyBuilder) Type(type_ int) *CreateGroupReqBodyBuilder { @@ -6951,13 +6951,13 @@ func (builder *CreateGroupReqBodyBuilder) Build() *CreateGroupReqBody { } type CreateGroupPathReqBodyBuilder struct { - groupId string // 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义group_id数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 + groupId string // 自定义用户组 ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义 group_id 数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 groupIdFlag bool name string // 用户组的名字，企业内唯一，最大长度：100 字符 nameFlag bool description string // 用户组描述 descriptionFlag bool - type_ int // 用户组的类型。默认为1表示普通用户组 + type_ int // 用户组的类型。默认为 1 表示普通用户组 typeFlag bool } @@ -6966,7 +6966,7 @@ func NewCreateGroupPathReqBodyBuilder() *CreateGroupPathReqBodyBuilder { return builder } -// 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义group_id数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 +// 自定义用户组 ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义 group_id 数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 // // 示例值：g122817 func (builder *CreateGroupPathReqBodyBuilder) GroupId(groupId string) *CreateGroupPathReqBodyBuilder { @@ -6986,14 +6986,14 @@ func (builder *CreateGroupPathReqBodyBuilder) Name(name string) *CreateGroupPath // 用户组描述 // -// 示例值：IT服务人员的集合 +// 示例值：IT 服务人员的集合 func (builder *CreateGroupPathReqBodyBuilder) Description(description string) *CreateGroupPathReqBodyBuilder { builder.description = description builder.descriptionFlag = true return builder } -// 用户组的类型。默认为1表示普通用户组 +// 用户组的类型。默认为 1 表示普通用户组 // // 示例值：1 func (builder *CreateGroupPathReqBodyBuilder) Type(type_ int) *CreateGroupPathReqBodyBuilder { @@ -7033,7 +7033,7 @@ func NewCreateGroupReqBuilder() *CreateGroupReqBuilder { return builder } -// 使用该接口创建用户组，请注意创建用户组时应用的通讯录权限范围需为“全部员工”，否则会创建失败，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// 使用该接口创建用户组，请注意创建用户组时应用的通讯录权限范围需为 “全部员工”，否则会创建失败，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 func (builder *CreateGroupReqBuilder) Body(body *CreateGroupReqBody) *CreateGroupReqBuilder { builder.body = body return builder @@ -7047,10 +7047,10 @@ func (builder *CreateGroupReqBuilder) Build() *CreateGroupReq { } type CreateGroupReqBody struct { - GroupId *string `json:"group_id,omitempty"` // 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义group_id数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 + GroupId *string `json:"group_id,omitempty"` // 自定义用户组 ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。;;自定义 group_id 数据校验规则：;;最大长度：64 字符;;校验规则：数字、大小写字母的组合，不能包含空格 Name *string `json:"name,omitempty"` // 用户组的名字，企业内唯一，最大长度：100 字符 Description *string `json:"description,omitempty"` // 用户组描述 - Type *int `json:"type,omitempty"` // 用户组的类型。默认为1表示普通用户组 + Type *int `json:"type,omitempty"` // 用户组的类型。默认为 1 表示普通用户组 } type CreateGroupReq struct { @@ -7059,7 +7059,7 @@ type CreateGroupReq struct { } type CreateGroupRespData struct { - GroupId *string `json:"group_id,omitempty"` // 用户组ID + GroupId *string `json:"group_id,omitempty"` // 用户组 ID } type CreateGroupResp struct { @@ -7085,7 +7085,7 @@ func NewDeleteGroupReqBuilder() *DeleteGroupReqBuilder { return builder } -// 需删除的用户组ID +// 需删除的用户组 ID // // 示例值：g1837191 func (builder *DeleteGroupReqBuilder) GroupId(groupId string) *DeleteGroupReqBuilder { @@ -7126,7 +7126,7 @@ func NewGetGroupReqBuilder() *GetGroupReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：g193821 func (builder *GetGroupReqBuilder) GroupId(groupId string) *GetGroupReqBuilder { @@ -7172,7 +7172,7 @@ func NewMemberBelongGroupReqBuilder() *MemberBelongGroupReqBuilder { return builder } -// 成员ID +// 成员 ID // // 示例值：u287xj12 func (builder *MemberBelongGroupReqBuilder) MemberId(memberId string) *MemberBelongGroupReqBuilder { @@ -7180,7 +7180,7 @@ func (builder *MemberBelongGroupReqBuilder) MemberId(memberId string) *MemberBel return builder } -// 成员ID类型 +// 成员 ID 类型 // // 示例值：open_id func (builder *MemberBelongGroupReqBuilder) MemberIdType(memberIdType string) *MemberBelongGroupReqBuilder { @@ -7204,7 +7204,7 @@ func (builder *MemberBelongGroupReqBuilder) PageSize(pageSize int) *MemberBelong return builder } -// 分页查询Token +// 分页查询 Token // // 示例值：AQD9/Rn9eij9Pm39ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JKiSIkdexPw= func (builder *MemberBelongGroupReqBuilder) PageToken(pageToken string) *MemberBelongGroupReqBuilder { @@ -7224,8 +7224,8 @@ type MemberBelongGroupReq struct { } type MemberBelongGroupRespData struct { - GroupList []string `json:"group_list,omitempty"` // 用户组ID列表 - PageToken *string `json:"page_token,omitempty"` // 分页查询Token + GroupList []string `json:"group_list,omitempty"` // 用户组 ID 列表 + PageToken *string `json:"page_token,omitempty"` // 分页查询 Token HasMore *bool `json:"has_more,omitempty"` // 是否有更多结果 } @@ -7335,7 +7335,7 @@ func NewPatchGroupReqBuilder() *PatchGroupReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：g187131 func (builder *PatchGroupReqBuilder) GroupId(groupId string) *PatchGroupReqBuilder { @@ -7343,7 +7343,7 @@ func (builder *PatchGroupReqBuilder) GroupId(groupId string) *PatchGroupReqBuild return builder } -// 使用该接口更新用户组信息，请注意更新用户组时应用的通讯录权限范围需为“全部员工”，否则会更新失败。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// 使用该接口更新用户组信息，请注意更新用户组时应用的通讯录权限范围需为 “全部员工”，否则会更新失败。[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 func (builder *PatchGroupReqBuilder) Body(body *PatchGroupReqBody) *PatchGroupReqBuilder { builder.body = body return builder @@ -7436,7 +7436,7 @@ type SimplelistGroupReq struct { type SimplelistGroupRespData struct { Grouplist []*Group `json:"grouplist,omitempty"` // 用户组列表 - PageToken *string `json:"page_token,omitempty"` // 下次分页获取的page_token + PageToken *string `json:"page_token,omitempty"` // 下次分页获取的 page_token HasMore *bool `json:"has_more,omitempty"` // 是否还需要分页获取 } @@ -7453,9 +7453,9 @@ func (resp *SimplelistGroupResp) Success() bool { type AddGroupMemberReqBodyBuilder struct { memberType string // 用户组成员的类型，取值为 user memberTypeFlag bool - memberIdType string // 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id + memberIdType string // 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id memberIdTypeFlag bool - memberId string // 添加的成员ID + memberId string // 添加的成员 ID memberIdFlag bool } @@ -7473,7 +7473,7 @@ func (builder *AddGroupMemberReqBodyBuilder) MemberType(memberType string) *AddG return builder } -// 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id +// 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id // //示例值：open_id func (builder *AddGroupMemberReqBodyBuilder) MemberIdType(memberIdType string) *AddGroupMemberReqBodyBuilder { @@ -7482,7 +7482,7 @@ func (builder *AddGroupMemberReqBodyBuilder) MemberIdType(memberIdType string) * return builder } -// 添加的成员ID +// 添加的成员 ID // //示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *AddGroupMemberReqBodyBuilder) MemberId(memberId string) *AddGroupMemberReqBodyBuilder { @@ -7508,9 +7508,9 @@ func (builder *AddGroupMemberReqBodyBuilder) Build() *AddGroupMemberReqBody { type AddGroupMemberPathReqBodyBuilder struct { memberType string // 用户组成员的类型，取值为 user memberTypeFlag bool - memberIdType string // 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id + memberIdType string // 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id memberIdTypeFlag bool - memberId string // 添加的成员ID + memberId string // 添加的成员 ID memberIdFlag bool } @@ -7528,7 +7528,7 @@ func (builder *AddGroupMemberPathReqBodyBuilder) MemberType(memberType string) * return builder } -// 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id +// 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id // // 示例值：open_id func (builder *AddGroupMemberPathReqBodyBuilder) MemberIdType(memberIdType string) *AddGroupMemberPathReqBodyBuilder { @@ -7537,7 +7537,7 @@ func (builder *AddGroupMemberPathReqBodyBuilder) MemberIdType(memberIdType strin return builder } -// 添加的成员ID +// 添加的成员 ID // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *AddGroupMemberPathReqBodyBuilder) MemberId(memberId string) *AddGroupMemberPathReqBodyBuilder { @@ -7574,7 +7574,7 @@ func NewAddGroupMemberReqBuilder() *AddGroupMemberReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：g281721 func (builder *AddGroupMemberReqBuilder) GroupId(groupId string) *AddGroupMemberReqBuilder { @@ -7582,7 +7582,7 @@ func (builder *AddGroupMemberReqBuilder) GroupId(groupId string) *AddGroupMember return builder } -// 向用户组中添加成员(目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是“全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// 向用户组中添加成员 (目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是 “全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 func (builder *AddGroupMemberReqBuilder) Body(body *AddGroupMemberReqBody) *AddGroupMemberReqBuilder { builder.body = body return builder @@ -7598,8 +7598,8 @@ func (builder *AddGroupMemberReqBuilder) Build() *AddGroupMemberReq { type AddGroupMemberReqBody struct { MemberType *string `json:"member_type,omitempty"` // 用户组成员的类型，取值为 user - MemberIdType *string `json:"member_id_type,omitempty"` // 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id - MemberId *string `json:"member_id,omitempty"` // 添加的成员ID + MemberIdType *string `json:"member_id_type,omitempty"` // 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id + MemberId *string `json:"member_id,omitempty"` // 添加的成员 ID } type AddGroupMemberReq struct { @@ -7684,7 +7684,7 @@ func NewBatchAddGroupMemberReqBuilder() *BatchAddGroupMemberReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：test_group func (builder *BatchAddGroupMemberReqBuilder) GroupId(groupId string) *BatchAddGroupMemberReqBuilder { @@ -7692,7 +7692,7 @@ func (builder *BatchAddGroupMemberReqBuilder) GroupId(groupId string) *BatchAddG return builder } -// 向普通用户组中批量添加成员(目前仅支持添加用户，暂不支持添加部门），如果应用的通讯录权限范围是“全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// 向普通用户组中批量添加成员 (目前仅支持添加用户，暂不支持添加部门），如果应用的通讯录权限范围是 “全部员工”，则可将任何成员添加到任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员添加到通讯录权限范围的用户组中，[点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 func (builder *BatchAddGroupMemberReqBuilder) Body(body *BatchAddGroupMemberReqBody) *BatchAddGroupMemberReqBuilder { builder.body = body return builder @@ -7797,7 +7797,7 @@ func NewBatchRemoveGroupMemberReqBuilder() *BatchRemoveGroupMemberReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：test_group func (builder *BatchRemoveGroupMemberReqBuilder) GroupId(groupId string) *BatchRemoveGroupMemberReqBuilder { @@ -7805,7 +7805,7 @@ func (builder *BatchRemoveGroupMemberReqBuilder) GroupId(groupId string) *BatchR return builder } -// 从普通用户组中批量移除成员 (目前仅支持移除用户，暂不支持移除部门）。如果应用的通讯录权限范围是“全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// 从普通用户组中批量移除成员 (目前仅支持移除用户，暂不支持移除部门）。如果应用的通讯录权限范围是 “全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 func (builder *BatchRemoveGroupMemberReqBuilder) Body(body *BatchRemoveGroupMemberReqBody) *BatchRemoveGroupMemberReqBuilder { builder.body = body return builder @@ -7840,9 +7840,9 @@ func (resp *BatchRemoveGroupMemberResp) Success() bool { type RemoveGroupMemberReqBodyBuilder struct { memberType string // 用户组成员的类型，取值为 user memberTypeFlag bool - memberId string // 操作移除的用户组成员ID + memberId string // 操作移除的用户组成员 ID memberIdFlag bool - memberIdType string // 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id + memberIdType string // 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id memberIdTypeFlag bool } @@ -7860,7 +7860,7 @@ func (builder *RemoveGroupMemberReqBodyBuilder) MemberType(memberType string) *R return builder } -// 操作移除的用户组成员ID +// 操作移除的用户组成员 ID // //示例值：xj82871k func (builder *RemoveGroupMemberReqBodyBuilder) MemberId(memberId string) *RemoveGroupMemberReqBodyBuilder { @@ -7869,7 +7869,7 @@ func (builder *RemoveGroupMemberReqBodyBuilder) MemberId(memberId string) *Remov return builder } -// 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id +// 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id // //示例值：open_id func (builder *RemoveGroupMemberReqBodyBuilder) MemberIdType(memberIdType string) *RemoveGroupMemberReqBodyBuilder { @@ -7895,9 +7895,9 @@ func (builder *RemoveGroupMemberReqBodyBuilder) Build() *RemoveGroupMemberReqBod type RemoveGroupMemberPathReqBodyBuilder struct { memberType string // 用户组成员的类型，取值为 user memberTypeFlag bool - memberId string // 操作移除的用户组成员ID + memberId string // 操作移除的用户组成员 ID memberIdFlag bool - memberIdType string // 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id + memberIdType string // 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id memberIdTypeFlag bool } @@ -7915,7 +7915,7 @@ func (builder *RemoveGroupMemberPathReqBodyBuilder) MemberType(memberType string return builder } -// 操作移除的用户组成员ID +// 操作移除的用户组成员 ID // // 示例值：xj82871k func (builder *RemoveGroupMemberPathReqBodyBuilder) MemberId(memberId string) *RemoveGroupMemberPathReqBodyBuilder { @@ -7924,7 +7924,7 @@ func (builder *RemoveGroupMemberPathReqBodyBuilder) MemberId(memberId string) *R return builder } -// 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id +// 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id // // 示例值：open_id func (builder *RemoveGroupMemberPathReqBodyBuilder) MemberIdType(memberIdType string) *RemoveGroupMemberPathReqBodyBuilder { @@ -7961,7 +7961,7 @@ func NewRemoveGroupMemberReqBuilder() *RemoveGroupMemberReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：g198123 func (builder *RemoveGroupMemberReqBuilder) GroupId(groupId string) *RemoveGroupMemberReqBuilder { @@ -7969,7 +7969,7 @@ func (builder *RemoveGroupMemberReqBuilder) GroupId(groupId string) *RemoveGroup return builder } -// 从用户组中移除成员 (目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是“全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是“全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 +// 从用户组中移除成员 (目前成员仅支持用户，未来会支持部门)，如果应用的通讯录权限范围是 “全部员工”，则可将任何成员移出任何用户组。如果应用的通讯录权限范围不是 “全部员工”，则仅可将通讯录权限范围中的成员从通讯录权限范围的用户组中移除， [点击了解通讯录权限范围](https://open.feishu.cn/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。 func (builder *RemoveGroupMemberReqBuilder) Body(body *RemoveGroupMemberReqBody) *RemoveGroupMemberReqBuilder { builder.body = body return builder @@ -7985,8 +7985,8 @@ func (builder *RemoveGroupMemberReqBuilder) Build() *RemoveGroupMemberReq { type RemoveGroupMemberReqBody struct { MemberType *string `json:"member_type,omitempty"` // 用户组成员的类型，取值为 user - MemberId *string `json:"member_id,omitempty"` // 操作移除的用户组成员ID - MemberIdType *string `json:"member_id_type,omitempty"` // 当member_type =user时候，member_id_type表示user_id_type，枚举值为open_id, union_id, user_id + MemberId *string `json:"member_id,omitempty"` // 操作移除的用户组成员 ID + MemberIdType *string `json:"member_id_type,omitempty"` // 当 member_type =user 时候，member_id_type 表示 user_id_type，枚举值为 open_id, union_id, user_id } type RemoveGroupMemberReq struct { @@ -8016,7 +8016,7 @@ func NewSimplelistGroupMemberReqBuilder() *SimplelistGroupMemberReqBuilder { return builder } -// 用户组ID +// 用户组 ID // // 示例值：g128187 func (builder *SimplelistGroupMemberReqBuilder) GroupId(groupId string) *SimplelistGroupMemberReqBuilder { @@ -8040,7 +8040,7 @@ func (builder *SimplelistGroupMemberReqBuilder) PageToken(pageToken string) *Sim return builder } -// 欲获取成员ID类型。;当member_type=user时候，member_id_type表示user_id_type，枚举值open_id, union_id和user_id。;当member_type=department时候，member_id_type表示department_id_type，枚举值open_id和department_id。 +// 欲获取成员 ID 类型。;当 member_type=user 时候，member_id_type 表示 user_id_type，枚举值 open_id, union_id 和 user_id。;当 member_type=department 时候，member_id_type 表示 department_id_type，枚举值 open_id 和 department_id。 // // 示例值：open_id func (builder *SimplelistGroupMemberReqBuilder) MemberIdType(memberIdType string) *SimplelistGroupMemberReqBuilder { @@ -8070,7 +8070,7 @@ type SimplelistGroupMemberReq struct { type SimplelistGroupMemberRespData struct { Memberlist []*Memberlist `json:"memberlist,omitempty"` // 成员列表 - PageToken *string `json:"page_token,omitempty"` // 下次分页获取的page_token + PageToken *string `json:"page_token,omitempty"` // 下次分页获取的 page_token HasMore *bool `json:"has_more,omitempty"` // 是否还需要分页获取 } @@ -8143,7 +8143,7 @@ func NewDeleteJobFamilyReqBuilder() *DeleteJobFamilyReqBuilder { return builder } -// 序列ID +// 序列 ID // // 示例值：mga5oa8ayjlp9rb func (builder *DeleteJobFamilyReqBuilder) JobFamilyId(jobFamilyId string) *DeleteJobFamilyReqBuilder { @@ -8184,7 +8184,7 @@ func NewGetJobFamilyReqBuilder() *GetJobFamilyReqBuilder { return builder } -// 序列ID +// 序列 ID // // 示例值：mga5oa8ayjlp9rb func (builder *GetJobFamilyReqBuilder) JobFamilyId(jobFamilyId string) *GetJobFamilyReqBuilder { @@ -8253,7 +8253,7 @@ func (builder *ListJobFamilyReqBuilder) PageToken(pageToken string) *ListJobFami return builder } -// 序列名称,传入该字段时，可查询指定序列名称对应的序列信息 +// 序列名称，传入该字段时，可查询指定序列名称对应的序列信息 // // 示例值：2-2 func (builder *ListJobFamilyReqBuilder) Name(name string) *ListJobFamilyReqBuilder { @@ -8277,7 +8277,7 @@ type ListJobFamilyReq struct { type ListJobFamilyRespData struct { Items []*JobFamily `json:"items,omitempty"` // 序列信息 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 } @@ -8305,7 +8305,7 @@ func NewUpdateJobFamilyReqBuilder() *UpdateJobFamilyReqBuilder { return builder } -// 序列ID +// 序列 ID // // 示例值：mga5oa8ayjlp9rb func (builder *UpdateJobFamilyReqBuilder) JobFamilyId(jobFamilyId string) *UpdateJobFamilyReqBuilder { @@ -8405,7 +8405,7 @@ func NewDeleteJobLevelReqBuilder() *DeleteJobLevelReqBuilder { return builder } -// 职级ID +// 职级 ID // // 示例值：mga5oa8ayjlp9rb func (builder *DeleteJobLevelReqBuilder) JobLevelId(jobLevelId string) *DeleteJobLevelReqBuilder { @@ -8446,7 +8446,7 @@ func NewGetJobLevelReqBuilder() *GetJobLevelReqBuilder { return builder } -// 职级ID +// 职级 ID // // 示例值：mga5oa8ayjlp9rb func (builder *GetJobLevelReqBuilder) JobLevelId(jobLevelId string) *GetJobLevelReqBuilder { @@ -8567,7 +8567,7 @@ func NewUpdateJobLevelReqBuilder() *UpdateJobLevelReqBuilder { return builder } -// 职级ID +// 职级 ID // // 示例值：mga5oa8ayjlp9rb func (builder *UpdateJobLevelReqBuilder) JobLevelId(jobLevelId string) *UpdateJobLevelReqBuilder { @@ -8621,7 +8621,7 @@ func NewListScopeReqBuilder() *ListScopeReqBuilder { return builder } -// 返回值的用户ID的类型 +// 返回值的用户 ID 的类型 // // 示例值：user_id func (builder *ListScopeReqBuilder) UserIdType(userIdType string) *ListScopeReqBuilder { @@ -8629,7 +8629,7 @@ func (builder *ListScopeReqBuilder) UserIdType(userIdType string) *ListScopeReqB return builder } -// 返回值的部门ID的类型 +// 返回值的部门 ID 的类型 // // 示例值：department_id func (builder *ListScopeReqBuilder) DepartmentIdType(departmentIdType string) *ListScopeReqBuilder { @@ -8666,7 +8666,7 @@ type ListScopeReq struct { type ListScopeRespData struct { DepartmentIds []string `json:"department_ids,omitempty"` // 已授权部门列表，授权范围为全员可见时返回的是当前企业的所有一级部门列表 - UserIds []string `json:"user_ids,omitempty"` // 已授权用户列表，应用申请了获取用户user_id 权限时返回；当授权范围为全员可见时返回的是当前企业所有顶级部门用户列表 + UserIds []string `json:"user_ids,omitempty"` // 已授权用户列表，应用申请了获取用户 user_id 权限时返回；当授权范围为全员可见时返回的是当前企业所有顶级部门用户列表 GroupIds []string `json:"group_ids,omitempty"` // 已授权的用户组，授权范围为全员可见时返回的是当前企业所有用户组 HasMore *bool `json:"has_more,omitempty"` // 是否还有更多项 PageToken *string `json:"page_token,omitempty"` // 分页标记，当 has_more 为 true 时，会同时返回新的 page_token @@ -8683,11 +8683,11 @@ func (resp *ListScopeResp) Success() bool { } type BindDepartmentUnitReqBodyBuilder struct { - unitId string // 单位ID + unitId string // 单位 ID unitIdFlag bool - departmentId string // 单位关联的部门ID + departmentId string // 单位关联的部门 ID departmentIdFlag bool - departmentIdType string // 此次调用中使用的部门ID的类型 + departmentIdType string // 此次调用中使用的部门 ID 的类型 departmentIdTypeFlag bool } @@ -8696,7 +8696,7 @@ func NewBindDepartmentUnitReqBodyBuilder() *BindDepartmentUnitReqBodyBuilder { return builder } -// 单位ID +// 单位 ID // //示例值：BU121 func (builder *BindDepartmentUnitReqBodyBuilder) UnitId(unitId string) *BindDepartmentUnitReqBodyBuilder { @@ -8705,7 +8705,7 @@ func (builder *BindDepartmentUnitReqBodyBuilder) UnitId(unitId string) *BindDepa return builder } -// 单位关联的部门ID +// 单位关联的部门 ID // //示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *BindDepartmentUnitReqBodyBuilder) DepartmentId(departmentId string) *BindDepartmentUnitReqBodyBuilder { @@ -8714,7 +8714,7 @@ func (builder *BindDepartmentUnitReqBodyBuilder) DepartmentId(departmentId strin return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // //示例值：open_department_id func (builder *BindDepartmentUnitReqBodyBuilder) DepartmentIdType(departmentIdType string) *BindDepartmentUnitReqBodyBuilder { @@ -8738,11 +8738,11 @@ func (builder *BindDepartmentUnitReqBodyBuilder) Build() *BindDepartmentUnitReqB } type BindDepartmentUnitPathReqBodyBuilder struct { - unitId string // 单位ID + unitId string // 单位 ID unitIdFlag bool - departmentId string // 单位关联的部门ID + departmentId string // 单位关联的部门 ID departmentIdFlag bool - departmentIdType string // 此次调用中使用的部门ID的类型 + departmentIdType string // 此次调用中使用的部门 ID 的类型 departmentIdTypeFlag bool } @@ -8751,7 +8751,7 @@ func NewBindDepartmentUnitPathReqBodyBuilder() *BindDepartmentUnitPathReqBodyBui return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *BindDepartmentUnitPathReqBodyBuilder) UnitId(unitId string) *BindDepartmentUnitPathReqBodyBuilder { @@ -8760,7 +8760,7 @@ func (builder *BindDepartmentUnitPathReqBodyBuilder) UnitId(unitId string) *Bind return builder } -// 单位关联的部门ID +// 单位关联的部门 ID // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *BindDepartmentUnitPathReqBodyBuilder) DepartmentId(departmentId string) *BindDepartmentUnitPathReqBodyBuilder { @@ -8769,7 +8769,7 @@ func (builder *BindDepartmentUnitPathReqBodyBuilder) DepartmentId(departmentId s return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *BindDepartmentUnitPathReqBodyBuilder) DepartmentIdType(departmentIdType string) *BindDepartmentUnitPathReqBodyBuilder { @@ -8806,7 +8806,7 @@ func NewBindDepartmentUnitReqBuilder() *BindDepartmentUnitReqBuilder { return builder } -// 通过该接口建立部门与单位的绑定关系。由于单位是旗舰版付费功能，企业需开通相关版本，否则会绑定失败，不同版本请参考[飞书版本对比](https://www.feishu.cn/service) +// 通过该接口建立部门与单位的绑定关系。由于单位是旗舰版付费功能，企业需开通相关版本，否则会绑定失败，不同版本请参考 [飞书版本对比](https://www.feishu.cn/service) func (builder *BindDepartmentUnitReqBuilder) Body(body *BindDepartmentUnitReqBody) *BindDepartmentUnitReqBuilder { builder.body = body return builder @@ -8820,9 +8820,9 @@ func (builder *BindDepartmentUnitReqBuilder) Build() *BindDepartmentUnitReq { } type BindDepartmentUnitReqBody struct { - UnitId *string `json:"unit_id,omitempty"` // 单位ID - DepartmentId *string `json:"department_id,omitempty"` // 单位关联的部门ID - DepartmentIdType *string `json:"department_id_type,omitempty"` // 此次调用中使用的部门ID的类型 + UnitId *string `json:"unit_id,omitempty"` // 单位 ID + DepartmentId *string `json:"department_id,omitempty"` // 单位关联的部门 ID + DepartmentIdType *string `json:"department_id_type,omitempty"` // 此次调用中使用的部门 ID 的类型 } type BindDepartmentUnitReq struct { @@ -8840,11 +8840,11 @@ func (resp *BindDepartmentUnitResp) Success() bool { } type CreateUnitReqBodyBuilder struct { - unitId string // 单位ID。可自定义，不传时默认自动生成。1-64字节范围大小，需为数字字母 + unitId string // 单位 ID。可自定义，不传时默认自动生成。1-64 字节范围大小，需为数字字母 unitIdFlag bool - name string // 单位的名字，长度范围为1-100个字符 + name string // 单位的名字，长度范围为 1-100 个字符 nameFlag bool - unitType string // 单位类型，长度范围为1-100个字符，创建后不可修改 + unitType string // 单位类型，长度范围为 1-100 个字符，创建后不可修改 unitTypeFlag bool } @@ -8853,7 +8853,7 @@ func NewCreateUnitReqBodyBuilder() *CreateUnitReqBodyBuilder { return builder } -// 单位ID。可自定义，不传时默认自动生成。1-64字节范围大小，需为数字字母 +// 单位 ID。可自定义，不传时默认自动生成。1-64 字节范围大小，需为数字字母 // //示例值：BU121 func (builder *CreateUnitReqBodyBuilder) UnitId(unitId string) *CreateUnitReqBodyBuilder { @@ -8862,7 +8862,7 @@ func (builder *CreateUnitReqBodyBuilder) UnitId(unitId string) *CreateUnitReqBod return builder } -// 单位的名字，长度范围为1-100个字符 +// 单位的名字，长度范围为 1-100 个字符 // //示例值：消费者事业部 func (builder *CreateUnitReqBodyBuilder) Name(name string) *CreateUnitReqBodyBuilder { @@ -8871,7 +8871,7 @@ func (builder *CreateUnitReqBodyBuilder) Name(name string) *CreateUnitReqBodyBui return builder } -// 单位类型，长度范围为1-100个字符，创建后不可修改 +// 单位类型，长度范围为 1-100 个字符，创建后不可修改 // //示例值：子公司 func (builder *CreateUnitReqBodyBuilder) UnitType(unitType string) *CreateUnitReqBodyBuilder { @@ -8895,11 +8895,11 @@ func (builder *CreateUnitReqBodyBuilder) Build() *CreateUnitReqBody { } type CreateUnitPathReqBodyBuilder struct { - unitId string // 单位ID。可自定义，不传时默认自动生成。1-64字节范围大小，需为数字字母 + unitId string // 单位 ID。可自定义，不传时默认自动生成。1-64 字节范围大小，需为数字字母 unitIdFlag bool - name string // 单位的名字，长度范围为1-100个字符 + name string // 单位的名字，长度范围为 1-100 个字符 nameFlag bool - unitType string // 单位类型，长度范围为1-100个字符，创建后不可修改 + unitType string // 单位类型，长度范围为 1-100 个字符，创建后不可修改 unitTypeFlag bool } @@ -8908,7 +8908,7 @@ func NewCreateUnitPathReqBodyBuilder() *CreateUnitPathReqBodyBuilder { return builder } -// 单位ID。可自定义，不传时默认自动生成。1-64字节范围大小，需为数字字母 +// 单位 ID。可自定义，不传时默认自动生成。1-64 字节范围大小，需为数字字母 // // 示例值：BU121 func (builder *CreateUnitPathReqBodyBuilder) UnitId(unitId string) *CreateUnitPathReqBodyBuilder { @@ -8917,7 +8917,7 @@ func (builder *CreateUnitPathReqBodyBuilder) UnitId(unitId string) *CreateUnitPa return builder } -// 单位的名字，长度范围为1-100个字符 +// 单位的名字，长度范围为 1-100 个字符 // // 示例值：消费者事业部 func (builder *CreateUnitPathReqBodyBuilder) Name(name string) *CreateUnitPathReqBodyBuilder { @@ -8926,7 +8926,7 @@ func (builder *CreateUnitPathReqBodyBuilder) Name(name string) *CreateUnitPathRe return builder } -// 单位类型，长度范围为1-100个字符，创建后不可修改 +// 单位类型，长度范围为 1-100 个字符，创建后不可修改 // // 示例值：子公司 func (builder *CreateUnitPathReqBodyBuilder) UnitType(unitType string) *CreateUnitPathReqBodyBuilder { @@ -8963,7 +8963,7 @@ func NewCreateUnitReqBuilder() *CreateUnitReqBuilder { return builder } -// 该接口用于创建单位。注意：单位功能属于旗舰版付费功能，企业需开通对应版本才可以创建单位，不同版本请参考[飞书版本对比](https://www.feishu.cn/service)。 +// 该接口用于创建单位。注意：单位功能属于旗舰版付费功能，企业需开通对应版本才可以创建单位，不同版本请参考 [飞书版本对比](https://www.feishu.cn/service)。 func (builder *CreateUnitReqBuilder) Body(body *CreateUnitReqBody) *CreateUnitReqBuilder { builder.body = body return builder @@ -8977,9 +8977,9 @@ func (builder *CreateUnitReqBuilder) Build() *CreateUnitReq { } type CreateUnitReqBody struct { - UnitId *string `json:"unit_id,omitempty"` // 单位ID。可自定义，不传时默认自动生成。1-64字节范围大小，需为数字字母 - Name *string `json:"name,omitempty"` // 单位的名字，长度范围为1-100个字符 - UnitType *string `json:"unit_type,omitempty"` // 单位类型，长度范围为1-100个字符，创建后不可修改 + UnitId *string `json:"unit_id,omitempty"` // 单位 ID。可自定义，不传时默认自动生成。1-64 字节范围大小，需为数字字母 + Name *string `json:"name,omitempty"` // 单位的名字，长度范围为 1-100 个字符 + UnitType *string `json:"unit_type,omitempty"` // 单位类型，长度范围为 1-100 个字符，创建后不可修改 } type CreateUnitReq struct { @@ -8988,7 +8988,7 @@ type CreateUnitReq struct { } type CreateUnitRespData struct { - UnitId *string `json:"unit_id,omitempty"` // 单位ID，可自定义 + UnitId *string `json:"unit_id,omitempty"` // 单位 ID，可自定义 } type CreateUnitResp struct { @@ -9014,7 +9014,7 @@ func NewDeleteUnitReqBuilder() *DeleteUnitReqBuilder { return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *DeleteUnitReqBuilder) UnitId(unitId string) *DeleteUnitReqBuilder { @@ -9055,7 +9055,7 @@ func NewGetUnitReqBuilder() *GetUnitReqBuilder { return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *GetUnitReqBuilder) UnitId(unitId string) *GetUnitReqBuilder { @@ -9101,7 +9101,7 @@ func NewListUnitReqBuilder() *ListUnitReqBuilder { return builder } -// 分页大小，默认50，取值范围 1-100 +// 分页大小，默认 50，取值范围 1-100 // // 示例值：50 func (builder *ListUnitReqBuilder) PageSize(pageSize int) *ListUnitReqBuilder { @@ -9131,7 +9131,7 @@ type ListUnitReq struct { type ListUnitRespData struct { Unitlist []*Unit `json:"unitlist,omitempty"` // 单位列表 HasMore *bool `json:"has_more,omitempty"` // 是否还有分页数据 - PageToken *string `json:"page_token,omitempty"` // 分页下次调用的page_token值 + PageToken *string `json:"page_token,omitempty"` // 分页下次调用的 page_token 值 } type ListUnitResp struct { @@ -9157,7 +9157,7 @@ func NewListDepartmentUnitReqBuilder() *ListDepartmentUnitReqBuilder { return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *ListDepartmentUnitReqBuilder) UnitId(unitId string) *ListDepartmentUnitReqBuilder { @@ -9165,7 +9165,7 @@ func (builder *ListDepartmentUnitReqBuilder) UnitId(unitId string) *ListDepartme return builder } -// 此次调用中预获取的部门ID的类型 +// 此次调用中预获取的部门 ID 的类型 // // 示例值：open_department_id func (builder *ListDepartmentUnitReqBuilder) DepartmentIdType(departmentIdType string) *ListDepartmentUnitReqBuilder { @@ -9284,7 +9284,7 @@ func NewPatchUnitReqBuilder() *PatchUnitReqBuilder { return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *PatchUnitReqBuilder) UnitId(unitId string) *PatchUnitReqBuilder { @@ -9325,11 +9325,11 @@ func (resp *PatchUnitResp) Success() bool { } type UnbindDepartmentUnitReqBodyBuilder struct { - unitId string // 单位ID + unitId string // 单位 ID unitIdFlag bool - departmentId string // 预解除关联的部门ID + departmentId string // 预解除关联的部门 ID departmentIdFlag bool - departmentIdType string // 此次调用中使用的部门ID的类型 + departmentIdType string // 此次调用中使用的部门 ID 的类型 departmentIdTypeFlag bool } @@ -9338,7 +9338,7 @@ func NewUnbindDepartmentUnitReqBodyBuilder() *UnbindDepartmentUnitReqBodyBuilder return builder } -// 单位ID +// 单位 ID // //示例值：BU121 func (builder *UnbindDepartmentUnitReqBodyBuilder) UnitId(unitId string) *UnbindDepartmentUnitReqBodyBuilder { @@ -9347,7 +9347,7 @@ func (builder *UnbindDepartmentUnitReqBodyBuilder) UnitId(unitId string) *Unbind return builder } -// 预解除关联的部门ID +// 预解除关联的部门 ID // //示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *UnbindDepartmentUnitReqBodyBuilder) DepartmentId(departmentId string) *UnbindDepartmentUnitReqBodyBuilder { @@ -9356,7 +9356,7 @@ func (builder *UnbindDepartmentUnitReqBodyBuilder) DepartmentId(departmentId str return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // //示例值：open_department_id func (builder *UnbindDepartmentUnitReqBodyBuilder) DepartmentIdType(departmentIdType string) *UnbindDepartmentUnitReqBodyBuilder { @@ -9380,11 +9380,11 @@ func (builder *UnbindDepartmentUnitReqBodyBuilder) Build() *UnbindDepartmentUnit } type UnbindDepartmentUnitPathReqBodyBuilder struct { - unitId string // 单位ID + unitId string // 单位 ID unitIdFlag bool - departmentId string // 预解除关联的部门ID + departmentId string // 预解除关联的部门 ID departmentIdFlag bool - departmentIdType string // 此次调用中使用的部门ID的类型 + departmentIdType string // 此次调用中使用的部门 ID 的类型 departmentIdTypeFlag bool } @@ -9393,7 +9393,7 @@ func NewUnbindDepartmentUnitPathReqBodyBuilder() *UnbindDepartmentUnitPathReqBod return builder } -// 单位ID +// 单位 ID // // 示例值：BU121 func (builder *UnbindDepartmentUnitPathReqBodyBuilder) UnitId(unitId string) *UnbindDepartmentUnitPathReqBodyBuilder { @@ -9402,7 +9402,7 @@ func (builder *UnbindDepartmentUnitPathReqBodyBuilder) UnitId(unitId string) *Un return builder } -// 预解除关联的部门ID +// 预解除关联的部门 ID // // 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 func (builder *UnbindDepartmentUnitPathReqBodyBuilder) DepartmentId(departmentId string) *UnbindDepartmentUnitPathReqBodyBuilder { @@ -9411,7 +9411,7 @@ func (builder *UnbindDepartmentUnitPathReqBodyBuilder) DepartmentId(departmentId return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *UnbindDepartmentUnitPathReqBodyBuilder) DepartmentIdType(departmentIdType string) *UnbindDepartmentUnitPathReqBodyBuilder { @@ -9462,9 +9462,9 @@ func (builder *UnbindDepartmentUnitReqBuilder) Build() *UnbindDepartmentUnitReq } type UnbindDepartmentUnitReqBody struct { - UnitId *string `json:"unit_id,omitempty"` // 单位ID - DepartmentId *string `json:"department_id,omitempty"` // 预解除关联的部门ID - DepartmentIdType *string `json:"department_id_type,omitempty"` // 此次调用中使用的部门ID的类型 + UnitId *string `json:"unit_id,omitempty"` // 单位 ID + DepartmentId *string `json:"department_id,omitempty"` // 预解除关联的部门 ID + DepartmentIdType *string `json:"department_id_type,omitempty"` // 此次调用中使用的部门 ID 的类型 } type UnbindDepartmentUnitReq struct { @@ -9482,9 +9482,9 @@ func (resp *UnbindDepartmentUnitResp) Success() bool { } type BatchGetIdUserReqBodyBuilder struct { - emails []string // 要查询的用户邮箱，最多 50 条。;;注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。;;本接口返回的用户ID数量为emails数量与mobiles数量的和。 + emails []string // 要查询的用户邮箱，最多 50 条。;;注意，emails 与 mobiles 相互独立，每条用户邮箱返回对应的用户 ID。;;本接口返回的用户 ID 数量为 emails 数量与 mobiles 数量的和。 emailsFlag bool - mobiles []string // 要查询的用户手机号，最多 50 条。;;注意;1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 + mobiles []string // 要查询的用户手机号，最多 50 条。;;注意;1. emails 与 mobiles 相互独立，每条用户手机号返回对应的用户 ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 mobilesFlag bool } @@ -9493,7 +9493,7 @@ func NewBatchGetIdUserReqBodyBuilder() *BatchGetIdUserReqBodyBuilder { return builder } -// 要查询的用户邮箱，最多 50 条。;;注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。;;本接口返回的用户ID数量为emails数量与mobiles数量的和。 +// 要查询的用户邮箱，最多 50 条。;;注意，emails 与 mobiles 相互独立，每条用户邮箱返回对应的用户 ID。;;本接口返回的用户 ID 数量为 emails 数量与 mobiles 数量的和。 // //示例值：zhangsan@a.com func (builder *BatchGetIdUserReqBodyBuilder) Emails(emails []string) *BatchGetIdUserReqBodyBuilder { @@ -9502,7 +9502,7 @@ func (builder *BatchGetIdUserReqBodyBuilder) Emails(emails []string) *BatchGetId return builder } -// 要查询的用户手机号，最多 50 条。;;注意;1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 +// 要查询的用户手机号，最多 50 条。;;注意;1. emails 与 mobiles 相互独立，每条用户手机号返回对应的用户 ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 // //示例值：13812345678 func (builder *BatchGetIdUserReqBodyBuilder) Mobiles(mobiles []string) *BatchGetIdUserReqBodyBuilder { @@ -9523,9 +9523,9 @@ func (builder *BatchGetIdUserReqBodyBuilder) Build() *BatchGetIdUserReqBody { } type BatchGetIdUserPathReqBodyBuilder struct { - emails []string // 要查询的用户邮箱，最多 50 条。;;注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。;;本接口返回的用户ID数量为emails数量与mobiles数量的和。 + emails []string // 要查询的用户邮箱，最多 50 条。;;注意，emails 与 mobiles 相互独立，每条用户邮箱返回对应的用户 ID。;;本接口返回的用户 ID 数量为 emails 数量与 mobiles 数量的和。 emailsFlag bool - mobiles []string // 要查询的用户手机号，最多 50 条。;;注意;1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 + mobiles []string // 要查询的用户手机号，最多 50 条。;;注意;1. emails 与 mobiles 相互独立，每条用户手机号返回对应的用户 ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 mobilesFlag bool } @@ -9534,7 +9534,7 @@ func NewBatchGetIdUserPathReqBodyBuilder() *BatchGetIdUserPathReqBodyBuilder { return builder } -// 要查询的用户邮箱，最多 50 条。;;注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。;;本接口返回的用户ID数量为emails数量与mobiles数量的和。 +// 要查询的用户邮箱，最多 50 条。;;注意，emails 与 mobiles 相互独立，每条用户邮箱返回对应的用户 ID。;;本接口返回的用户 ID 数量为 emails 数量与 mobiles 数量的和。 // // 示例值：zhangsan@a.com func (builder *BatchGetIdUserPathReqBodyBuilder) Emails(emails []string) *BatchGetIdUserPathReqBodyBuilder { @@ -9543,7 +9543,7 @@ func (builder *BatchGetIdUserPathReqBodyBuilder) Emails(emails []string) *BatchG return builder } -// 要查询的用户手机号，最多 50 条。;;注意;1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 +// 要查询的用户手机号，最多 50 条。;;注意;1. emails 与 mobiles 相互独立，每条用户手机号返回对应的用户 ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 // // 示例值：13812345678 func (builder *BatchGetIdUserPathReqBodyBuilder) Mobiles(mobiles []string) *BatchGetIdUserPathReqBodyBuilder { @@ -9577,7 +9577,7 @@ func NewBatchGetIdUserReqBuilder() *BatchGetIdUserReqBuilder { return builder } -// 返回的用户ID的类型 +// 返回的用户 ID 的类型 // // 示例值：user_id func (builder *BatchGetIdUserReqBuilder) UserIdType(userIdType string) *BatchGetIdUserReqBuilder { @@ -9600,8 +9600,8 @@ func (builder *BatchGetIdUserReqBuilder) Build() *BatchGetIdUserReq { } type BatchGetIdUserReqBody struct { - Emails []string `json:"emails,omitempty"` // 要查询的用户邮箱，最多 50 条。;;注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。;;本接口返回的用户ID数量为emails数量与mobiles数量的和。 - Mobiles []string `json:"mobiles,omitempty"` // 要查询的用户手机号，最多 50 条。;;注意;1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 + Emails []string `json:"emails,omitempty"` // 要查询的用户邮箱，最多 50 条。;;注意，emails 与 mobiles 相互独立，每条用户邮箱返回对应的用户 ID。;;本接口返回的用户 ID 数量为 emails 数量与 mobiles 数量的和。 + Mobiles []string `json:"mobiles,omitempty"` // 要查询的用户手机号，最多 50 条。;;注意;1. emails 与 mobiles 相互独立，每条用户手机号返回对应的用户 ID。;2. 非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 } type BatchGetIdUserReq struct { @@ -9610,7 +9610,7 @@ type BatchGetIdUserReq struct { } type BatchGetIdUserRespData struct { - UserList []*UserContactInfo `json:"user_list,omitempty"` // 手机号或者邮箱对应的用户id信息 + UserList []*UserContactInfo `json:"user_list,omitempty"` // 手机号或者邮箱对应的用户 id 信息 } type BatchGetIdUserResp struct { @@ -9637,7 +9637,7 @@ func NewCreateUserReqBuilder() *CreateUserReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateUserReqBuilder) UserIdType(userIdType string) *CreateUserReqBuilder { @@ -9645,7 +9645,7 @@ func (builder *CreateUserReqBuilder) UserIdType(userIdType string) *CreateUserRe return builder } -// 此次调用中使用的部门ID的类型。;;不同 ID 的说明参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 此次调用中使用的部门 ID 的类型。;;不同 ID 的说明参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：open_department_id func (builder *CreateUserReqBuilder) DepartmentIdType(departmentIdType string) *CreateUserReqBuilder { @@ -9661,7 +9661,7 @@ func (builder *CreateUserReqBuilder) ClientToken(clientToken string) *CreateUser return builder } -// 使用该接口向通讯录创建一个用户，可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。 +// 使用该接口向通讯录创建一个用户，可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照 [应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。 func (builder *CreateUserReqBuilder) User(user *User) *CreateUserReqBuilder { builder.user = user return builder @@ -9958,7 +9958,7 @@ func NewDeleteUserReqBuilder() *DeleteUserReqBuilder { return builder } -// 用户ID，需要与查询参数中的user_id_type类型保持一致。 +// 用户 ID，需要与查询参数中的 user_id_type 类型保持一致。 // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *DeleteUserReqBuilder) UserId(userId string) *DeleteUserReqBuilder { @@ -9966,7 +9966,7 @@ func (builder *DeleteUserReqBuilder) UserId(userId string) *DeleteUserReqBuilder return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *DeleteUserReqBuilder) UserIdType(userIdType string) *DeleteUserReqBuilder { @@ -10034,7 +10034,7 @@ func (builder *FindByDepartmentUserReqBuilder) Limit(limit int) *FindByDepartmen return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *FindByDepartmentUserReqBuilder) UserIdType(userIdType string) *FindByDepartmentUserReqBuilder { @@ -10042,7 +10042,7 @@ func (builder *FindByDepartmentUserReqBuilder) UserIdType(userIdType string) *Fi return builder } -// 此次调用中使用的部门ID的类型;;部门ID类型的区别参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 此次调用中使用的部门 ID 的类型;;部门 ID 类型的区别参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：open_department_id func (builder *FindByDepartmentUserReqBuilder) DepartmentIdType(departmentIdType string) *FindByDepartmentUserReqBuilder { @@ -10050,7 +10050,7 @@ func (builder *FindByDepartmentUserReqBuilder) DepartmentIdType(departmentIdType return builder } -// 填写该字段表示获取该部门下用户，必填。根部门的部门ID为0。;;ID值与查询参数中的department_id_type 对应。;;不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 填写该字段表示获取该部门下用户，必填。根部门的部门 ID 为 0。;;ID 值与查询参数中的 department_id_type 对应。;;不同 ID 的说明与 department_id 的获取方式参见 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：od-xxxxxxxxxxxxx func (builder *FindByDepartmentUserReqBuilder) DepartmentId(departmentId string) *FindByDepartmentUserReqBuilder { @@ -10066,7 +10066,7 @@ func (builder *FindByDepartmentUserReqBuilder) PageSize(pageSize int) *FindByDep return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该page_token 获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 // // 示例值：AQD9/Rn9eij9Pm39ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JKiSIkdexPw= func (builder *FindByDepartmentUserReqBuilder) PageToken(pageToken string) *FindByDepartmentUserReqBuilder { @@ -10090,7 +10090,7 @@ type FindByDepartmentUserReq struct { type FindByDepartmentUserRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*User `json:"items,omitempty"` // 用户信息列表 } @@ -10117,7 +10117,7 @@ func NewGetUserReqBuilder() *GetUserReqBuilder { return builder } -// 用户ID，类型需要与查询参数中的user_id_type保持一致。;;例如user_id_type=open_id，user_id的类型需为open_id;;不同ID的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 用户 ID，类型需要与查询参数中的 user_id_type 保持一致。;;例如 user_id_type=open_id，user_id 的类型需为 open_id;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：7be5fg9a func (builder *GetUserReqBuilder) UserId(userId string) *GetUserReqBuilder { @@ -10125,7 +10125,7 @@ func (builder *GetUserReqBuilder) UserId(userId string) *GetUserReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetUserReqBuilder) UserIdType(userIdType string) *GetUserReqBuilder { @@ -10133,7 +10133,7 @@ func (builder *GetUserReqBuilder) UserIdType(userIdType string) *GetUserReqBuild return builder } -// 此次调用中使用的部门ID的类型;;不同 ID 的说明 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) +// 此次调用中使用的部门 ID 的类型;;不同 ID 的说明 [部门 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) // // 示例值：open_department_id func (builder *GetUserReqBuilder) DepartmentIdType(departmentIdType string) *GetUserReqBuilder { @@ -10187,7 +10187,7 @@ func (builder *ListUserReqBuilder) Limit(limit int) *ListUserReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListUserReqBuilder) UserIdType(userIdType string) *ListUserReqBuilder { @@ -10195,7 +10195,7 @@ func (builder *ListUserReqBuilder) UserIdType(userIdType string) *ListUserReqBui return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值： func (builder *ListUserReqBuilder) DepartmentIdType(departmentIdType string) *ListUserReqBuilder { @@ -10243,7 +10243,7 @@ type ListUserReq struct { type ListUserRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*User `json:"items,omitempty"` // } @@ -10271,7 +10271,7 @@ func NewPatchUserReqBuilder() *PatchUserReqBuilder { return builder } -// 用户ID，需要与查询参数中的user_id_type类型保持一致。 +// 用户 ID，需要与查询参数中的 user_id_type 类型保持一致。 // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *PatchUserReqBuilder) UserId(userId string) *PatchUserReqBuilder { @@ -10279,7 +10279,7 @@ func (builder *PatchUserReqBuilder) UserId(userId string) *PatchUserReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchUserReqBuilder) UserIdType(userIdType string) *PatchUserReqBuilder { @@ -10287,7 +10287,7 @@ func (builder *PatchUserReqBuilder) UserIdType(userIdType string) *PatchUserReqB return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *PatchUserReqBuilder) DepartmentIdType(departmentIdType string) *PatchUserReqBuilder { @@ -10343,7 +10343,7 @@ func NewUpdateUserReqBuilder() *UpdateUserReqBuilder { return builder } -// 用户ID，需要与查询参数中的user_id_type类型保持一致。 +// 用户 ID，需要与查询参数中的 user_id_type 类型保持一致。 // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *UpdateUserReqBuilder) UserId(userId string) *UpdateUserReqBuilder { @@ -10351,7 +10351,7 @@ func (builder *UpdateUserReqBuilder) UserId(userId string) *UpdateUserReqBuilder return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateUserReqBuilder) UserIdType(userIdType string) *UpdateUserReqBuilder { @@ -10359,7 +10359,7 @@ func (builder *UpdateUserReqBuilder) UserIdType(userIdType string) *UpdateUserRe return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *UpdateUserReqBuilder) DepartmentIdType(departmentIdType string) *UpdateUserReqBuilder { @@ -10579,7 +10579,7 @@ func (m *P2UserDeletedV3) RawReq(req *larkevent.EventReq) { type P2UserUpdatedV3Data struct { Object *UserEvent `json:"object,omitempty"` // 变更后信息 - OldObject *UserEvent `json:"old_object,omitempty"` // 变更前信息，body中只包含有变更的字段 + OldObject *UserEvent `json:"old_object,omitempty"` // 变更前信息，body 中只包含有变更的字段 } type P2UserUpdatedV3 struct { @@ -10610,7 +10610,7 @@ func (iterator *ListCustomAttrIterator) Next() (bool, *CustomAttr, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10664,7 +10664,7 @@ func (iterator *ChildrenDepartmentIterator) Next() (bool, *Department, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10718,7 +10718,7 @@ func (iterator *ListDepartmentIterator) Next() (bool, *Department, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10772,7 +10772,7 @@ func (iterator *ParentDepartmentIterator) Next() (bool, *Department, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10826,7 +10826,7 @@ func (iterator *SearchDepartmentIterator) Next() (bool, *Department, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10880,7 +10880,7 @@ func (iterator *ListEmployeeTypeEnumIterator) Next() (bool, *EmployeeTypeEnum, e return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10934,7 +10934,7 @@ func (iterator *ListFunctionalRoleMemberIterator) Next() (bool, *FunctionalRoleM return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10988,7 +10988,7 @@ func (iterator *SimplelistGroupIterator) Next() (bool, *Group, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11042,7 +11042,7 @@ func (iterator *ListJobFamilyIterator) Next() (bool, *JobFamily, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11096,7 +11096,7 @@ func (iterator *ListJobLevelIterator) Next() (bool, *JobLevel, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11150,7 +11150,7 @@ func (iterator *FindByDepartmentUserIterator) Next() (bool, *User, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11204,7 +11204,7 @@ func (iterator *ListUserIterator) Next() (bool, *User, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/corehr/v1/api.go b/service/corehr/v1/api.go index 3df450a2..bb7ed570 100644 --- a/service/corehr/v1/api.go +++ b/service/corehr/v1/api.go @@ -39,9 +39,9 @@ type leave struct { // // - 批量获取员工的请假记录数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_request_history +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_request_history // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/corehrv1/leaveRequestHistory_leave.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/corehrv1/leaveRequestHistory_leave.go func (l *leave) LeaveRequestHistory(ctx context.Context, req *LeaveRequestHistoryLeaveReq, options ...larkcore.RequestOptionFunc) (*LeaveRequestHistoryLeaveResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/corehr/v1/model.go b/service/corehr/v1/model.go index fb54628c..dce0b5f5 100644 --- a/service/corehr/v1/model.go +++ b/service/corehr/v1/model.go @@ -29,7 +29,7 @@ const ( type Address struct { FullAddressLocalScript *string `json:"full_address_local_script,omitempty"` // 完整地址（本地文字） FullAddressWesternScript *string `json:"full_address_western_script,omitempty"` // 完整地址（西方文字） - Id *string `json:"id,omitempty"` // 地址ID + Id *string `json:"id,omitempty"` // 地址 ID CountryRegionId *string `json:"country_region_id,omitempty"` // 国家 / 地区 RegionId *string `json:"region_id,omitempty"` // 主要行政区 CityId *string `json:"city_id,omitempty"` // 城市 @@ -44,7 +44,7 @@ type Address struct { LocalAddressLine8 *string `json:"local_address_line8,omitempty"` // 地址行 8（非拉丁语系的本地文字） LocalAddressLine9 *string `json:"local_address_line9,omitempty"` // 地址行 9（非拉丁语系的本地文字） PostalCode *string `json:"postal_code,omitempty"` // 邮政编码 - AddressTypeList []*Enum `json:"address_type_list,omitempty"` // 地址类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义部分获得 + AddressTypeList []*Enum `json:"address_type_list,omitempty"` // 地址类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 地址类型（address_type）枚举定义部分获得 IsPrimary *bool `json:"is_primary,omitempty"` // 是否为主要地址 IsPublic *bool `json:"is_public,omitempty"` // 是否为公开地址 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 @@ -55,7 +55,7 @@ type AddressBuilder struct { fullAddressLocalScriptFlag bool fullAddressWesternScript string // 完整地址（西方文字） fullAddressWesternScriptFlag bool - id string // 地址ID + id string // 地址 ID idFlag bool countryRegionId string // 国家 / 地区 countryRegionIdFlag bool @@ -85,7 +85,7 @@ type AddressBuilder struct { localAddressLine9Flag bool postalCode string // 邮政编码 postalCodeFlag bool - addressTypeList []*Enum // 地址类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义部分获得 + addressTypeList []*Enum // 地址类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 地址类型（address_type）枚举定义部分获得 addressTypeListFlag bool isPrimary bool // 是否为主要地址 isPrimaryFlag bool @@ -118,7 +118,7 @@ func (builder *AddressBuilder) FullAddressWesternScript(fullAddressWesternScript return builder } -// 地址ID +// 地址 ID // // 示例值：6989822217869624863 func (builder *AddressBuilder) Id(id string) *AddressBuilder { @@ -165,7 +165,7 @@ func (builder *AddressBuilder) DistinctId(distinctId string) *AddressBuilder { // 地址行 1（非拉丁语系的本地文字） // -// 示例值：丹佛测试地址-纽埃时区 +// 示例值：丹佛测试地址 - 纽埃时区 func (builder *AddressBuilder) LocalAddressLine1(localAddressLine1 string) *AddressBuilder { builder.localAddressLine1 = localAddressLine1 builder.localAddressLine1Flag = true @@ -253,7 +253,7 @@ func (builder *AddressBuilder) PostalCode(postalCode string) *AddressBuilder { return builder } -// 地址类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义部分获得 +// 地址类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 地址类型（address_type）枚举定义部分获得 // // 示例值： func (builder *AddressBuilder) AddressTypeList(addressTypeList []*Enum) *AddressBuilder { @@ -457,17 +457,17 @@ func (builder *ApplicationInfoBuilder) Build() *ApplicationInfo { } type AssignedOrganization struct { - OrgKey *string `json:"org_key,omitempty"` // 管理对象key + OrgKey *string `json:"org_key,omitempty"` // 管理对象 key OrgName *Name `json:"org_name,omitempty"` // 管理对象名称 - OrgIdList []string `json:"org_id_list,omitempty"` // 管理对象id列表 + OrgIdList []string `json:"org_id_list,omitempty"` // 管理对象 id 列表 } type AssignedOrganizationBuilder struct { - orgKey string // 管理对象key + orgKey string // 管理对象 key orgKeyFlag bool orgName *Name // 管理对象名称 orgNameFlag bool - orgIdList []string // 管理对象id列表 + orgIdList []string // 管理对象 id 列表 orgIdListFlag bool } @@ -476,7 +476,7 @@ func NewAssignedOrganizationBuilder() *AssignedOrganizationBuilder { return builder } -// 管理对象key +// 管理对象 key // // 示例值：department func (builder *AssignedOrganizationBuilder) OrgKey(orgKey string) *AssignedOrganizationBuilder { @@ -494,7 +494,7 @@ func (builder *AssignedOrganizationBuilder) OrgName(orgName *Name) *AssignedOrga return builder } -// 管理对象id列表 +// 管理对象 id 列表 // // 示例值： func (builder *AssignedOrganizationBuilder) OrgIdList(orgIdList []string) *AssignedOrganizationBuilder { @@ -567,18 +567,18 @@ func (builder *AttachmentFieldSettingBuilder) Build() *AttachmentFieldSetting { } type BackgroundCheck struct { - Id *string `json:"id,omitempty"` // 背调ID + Id *string `json:"id,omitempty"` // 背调 ID Package *int `json:"package,omitempty"` // 套餐 Status *int `json:"status,omitempty"` // 状态 CreatedTime *string `json:"created_time,omitempty"` // 创建时间 ModifiedTime *string `json:"modified_time,omitempty"` // 修改时间 - TargetId *string `json:"target_id,omitempty"` // 背调对象ID + TargetId *string `json:"target_id,omitempty"` // 背调对象 ID Outcome *int `json:"outcome,omitempty"` // 结果 Report *BackgroundCheckReportObject `json:"report,omitempty"` // 报告 } type BackgroundCheckBuilder struct { - id string // 背调ID + id string // 背调 ID idFlag bool package_ int // 套餐 packageFlag bool @@ -588,7 +588,7 @@ type BackgroundCheckBuilder struct { createdTimeFlag bool modifiedTime string // 修改时间 modifiedTimeFlag bool - targetId string // 背调对象ID + targetId string // 背调对象 ID targetIdFlag bool outcome int // 结果 outcomeFlag bool @@ -601,7 +601,7 @@ func NewBackgroundCheckBuilder() *BackgroundCheckBuilder { return builder } -// 背调ID +// 背调 ID // // 示例值： func (builder *BackgroundCheckBuilder) Id(id string) *BackgroundCheckBuilder { @@ -646,7 +646,7 @@ func (builder *BackgroundCheckBuilder) ModifiedTime(modifiedTime string) *Backgr return builder } -// 背调对象ID +// 背调对象 ID // // 示例值： func (builder *BackgroundCheckBuilder) TargetId(targetId string) *BackgroundCheckBuilder { @@ -838,20 +838,20 @@ func (builder *BackgroundCheckReportObjectBuilder) Build() *BackgroundCheckRepor } type BackgroundCheckTarget struct { - Id *string `json:"id,omitempty"` // 背调对象ID + Id *string `json:"id,omitempty"` // 背调对象 ID FirstName *string `json:"first_name,omitempty"` // 姓 LastName *string `json:"last_name,omitempty"` // 名 Email *string `json:"email,omitempty"` // 邮箱 WorkCountry *BackgroundCheckCountry `json:"work_country,omitempty"` // 工作国家 WorkCity *BackgroundCheckCity `json:"work_city,omitempty"` // 工作城市 JobTitle *string `json:"job_title,omitempty"` // 职称 - OfferHrEmail *string `json:"offer_hr_email,omitempty"` // offer HR的电子邮件 + OfferHrEmail *string `json:"offer_hr_email,omitempty"` // offer HR 的电子邮件 BizUnit *string `json:"biz_unit,omitempty"` // 业务单元 - OfferHrDepartmentId *string `json:"offer_hr_department_id,omitempty"` // offer HR的部门ID + OfferHrDepartmentId *string `json:"offer_hr_department_id,omitempty"` // offer HR 的部门 ID } type BackgroundCheckTargetBuilder struct { - id string // 背调对象ID + id string // 背调对象 ID idFlag bool firstName string // 姓 firstNameFlag bool @@ -865,11 +865,11 @@ type BackgroundCheckTargetBuilder struct { workCityFlag bool jobTitle string // 职称 jobTitleFlag bool - offerHrEmail string // offer HR的电子邮件 + offerHrEmail string // offer HR 的电子邮件 offerHrEmailFlag bool bizUnit string // 业务单元 bizUnitFlag bool - offerHrDepartmentId string // offer HR的部门ID + offerHrDepartmentId string // offer HR 的部门 ID offerHrDepartmentIdFlag bool } @@ -878,7 +878,7 @@ func NewBackgroundCheckTargetBuilder() *BackgroundCheckTargetBuilder { return builder } -// 背调对象ID +// 背调对象 ID // // 示例值： func (builder *BackgroundCheckTargetBuilder) Id(id string) *BackgroundCheckTargetBuilder { @@ -941,7 +941,7 @@ func (builder *BackgroundCheckTargetBuilder) JobTitle(jobTitle string) *Backgrou return builder } -// offer HR的电子邮件 +// offer HR 的电子邮件 // // 示例值： func (builder *BackgroundCheckTargetBuilder) OfferHrEmail(offerHrEmail string) *BackgroundCheckTargetBuilder { @@ -959,7 +959,7 @@ func (builder *BackgroundCheckTargetBuilder) BizUnit(bizUnit string) *Background return builder } -// offer HR的部门ID +// offer HR 的部门 ID // // 示例值： func (builder *BackgroundCheckTargetBuilder) OfferHrDepartmentId(offerHrDepartmentId string) *BackgroundCheckTargetBuilder { @@ -1021,10 +1021,10 @@ type BankAccount struct { BankId *string `json:"bank_id,omitempty"` // 银行 ID BranchId *string `json:"branch_id,omitempty"` // 支行 ID CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 - CountryRegionId *string `json:"country_region_id,omitempty"` // 国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 - BankAccountUsage []*Enum `json:"bank_account_usage,omitempty"` // 银行卡用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（bank_account_usage）枚举定义部分获得 - BankAccountType *Enum `json:"bank_account_type,omitempty"` // 银行卡类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（bank_account_type）枚举定义部分获得 - CurrencyId *string `json:"currency_id,omitempty"` // 货币id + CountryRegionId *string `json:"country_region_id,omitempty"` // 国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 + BankAccountUsage []*Enum `json:"bank_account_usage,omitempty"` // 银行卡用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 银行卡用途（bank_account_usage）枚举定义部分获得 + BankAccountType *Enum `json:"bank_account_type,omitempty"` // 银行卡类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 银行卡类型（bank_account_type）枚举定义部分获得 + CurrencyId *string `json:"currency_id,omitempty"` // 货币 id } type BankAccountBuilder struct { @@ -1046,13 +1046,13 @@ type BankAccountBuilder struct { branchIdFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool - countryRegionId string // 国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 + countryRegionId string // 国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 countryRegionIdFlag bool - bankAccountUsage []*Enum // 银行卡用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（bank_account_usage）枚举定义部分获得 + bankAccountUsage []*Enum // 银行卡用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 银行卡用途（bank_account_usage）枚举定义部分获得 bankAccountUsageFlag bool - bankAccountType *Enum // 银行卡类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（bank_account_type）枚举定义部分获得 + bankAccountType *Enum // 银行卡类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 银行卡类型（bank_account_type）枚举定义部分获得 bankAccountTypeFlag bool - currencyId string // 货币id + currencyId string // 货币 id currencyIdFlag bool } @@ -1142,7 +1142,7 @@ func (builder *BankAccountBuilder) CustomFields(customFields []*ObjectFieldData) return builder } -// 国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 +// 国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 // // 示例值：12 func (builder *BankAccountBuilder) CountryRegionId(countryRegionId string) *BankAccountBuilder { @@ -1151,7 +1151,7 @@ func (builder *BankAccountBuilder) CountryRegionId(countryRegionId string) *Bank return builder } -// 银行卡用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（bank_account_usage）枚举定义部分获得 +// 银行卡用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 银行卡用途（bank_account_usage）枚举定义部分获得 // // 示例值： func (builder *BankAccountBuilder) BankAccountUsage(bankAccountUsage []*Enum) *BankAccountBuilder { @@ -1160,7 +1160,7 @@ func (builder *BankAccountBuilder) BankAccountUsage(bankAccountUsage []*Enum) *B return builder } -// 银行卡类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（bank_account_type）枚举定义部分获得 +// 银行卡类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 银行卡类型（bank_account_type）枚举定义部分获得 // // 示例值： func (builder *BankAccountBuilder) BankAccountType(bankAccountType *Enum) *BankAccountBuilder { @@ -1169,7 +1169,7 @@ func (builder *BankAccountBuilder) BankAccountType(bankAccountType *Enum) *BankA return builder } -// 货币id +// 货币 id // // 示例值：12QueryCountryRegionSubdivisionDataReq func (builder *BankAccountBuilder) CurrencyId(currencyId string) *BankAccountBuilder { @@ -1232,13 +1232,13 @@ func (builder *BankAccountBuilder) Build() *BankAccount { } type BpRoleOrganization struct { - RoleKey *string `json:"role_key,omitempty"` // 角色类型的唯一标识;- HRBP：与部门有关，role_key 固定为 「hrbp」;- 属地 BP：与部门、工作地点有关，role_key 固定为 「location_bp」 + RoleKey *string `json:"role_key,omitempty"` // 角色类型的唯一标识;- HRBP：与部门有关，role_key 固定为「hrbp」;- 属地 BP：与部门、工作地点有关，role_key 固定为「location_bp」 DepartmentId *string `json:"department_id,omitempty"` // 部门 ID，查询 HRBP 需输入部门 ID WorkLocationId *string `json:"work_location_id,omitempty"` // 工作地点 ID，查询属地 BP 需要输入部门 ID 与 工作地点 ID } type BpRoleOrganizationBuilder struct { - roleKey string // 角色类型的唯一标识;- HRBP：与部门有关，role_key 固定为 「hrbp」;- 属地 BP：与部门、工作地点有关，role_key 固定为 「location_bp」 + roleKey string // 角色类型的唯一标识;- HRBP：与部门有关，role_key 固定为「hrbp」;- 属地 BP：与部门、工作地点有关，role_key 固定为「location_bp」 roleKeyFlag bool departmentId string // 部门 ID，查询 HRBP 需输入部门 ID departmentIdFlag bool @@ -1251,7 +1251,7 @@ func NewBpRoleOrganizationBuilder() *BpRoleOrganizationBuilder { return builder } -// 角色类型的唯一标识;- HRBP：与部门有关，role_key 固定为 「hrbp」;- 属地 BP：与部门、工作地点有关，role_key 固定为 「location_bp」 +// 角色类型的唯一标识;- HRBP：与部门有关，role_key 固定为「hrbp」;- 属地 BP：与部门、工作地点有关，role_key 固定为「location_bp」 // // 示例值：location_bp func (builder *BpRoleOrganizationBuilder) RoleKey(roleKey string) *BpRoleOrganizationBuilder { @@ -1296,14 +1296,14 @@ func (builder *BpRoleOrganizationBuilder) Build() *BpRoleOrganization { } type BpmDataengineI18n struct { - ZhCn *string `json:"zh_cn,omitempty"` // i18n类型字段，中文值 - EnUs *string `json:"en_us,omitempty"` // i18n类型字段，英文值 + ZhCn *string `json:"zh_cn,omitempty"` // i18n 类型字段，中文值 + EnUs *string `json:"en_us,omitempty"` // i18n 类型字段，英文值 } type BpmDataengineI18nBuilder struct { - zhCn string // i18n类型字段，中文值 + zhCn string // i18n 类型字段，中文值 zhCnFlag bool - enUs string // i18n类型字段，英文值 + enUs string // i18n 类型字段，英文值 enUsFlag bool } @@ -1312,7 +1312,7 @@ func NewBpmDataengineI18nBuilder() *BpmDataengineI18nBuilder { return builder } -// i18n类型字段，中文值 +// i18n 类型字段，中文值 // // 示例值： func (builder *BpmDataengineI18nBuilder) ZhCn(zhCn string) *BpmDataengineI18nBuilder { @@ -1321,7 +1321,7 @@ func (builder *BpmDataengineI18nBuilder) ZhCn(zhCn string) *BpmDataengineI18nBui return builder } -// i18n类型字段，英文值 +// i18n 类型字段，英文值 // // 示例值： func (builder *BpmDataengineI18nBuilder) EnUs(enUs string) *BpmDataengineI18nBuilder { @@ -1529,13 +1529,13 @@ func (builder *CommonSchemaOptionBuilder) Build() *CommonSchemaOption { type Company struct { Id *string `json:"id,omitempty"` // 公司 ID HiberarchyCommon *HiberarchyCommon `json:"hiberarchy_common,omitempty"` // 层级关系，内层字段见实体 - Type *Enum `json:"type,omitempty"` // 性质，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)公司类型（company_type）枚举定义部分获得 - IndustryList []*Enum `json:"industry_list,omitempty"` // 行业，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)行业（industry）枚举定义部分获得 + Type *Enum `json:"type,omitempty"` // 性质，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 公司类型（company_type）枚举定义部分获得 + IndustryList []*Enum `json:"industry_list,omitempty"` // 行业，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 行业（industry）枚举定义部分获得 LegalRepresentative []*I18n `json:"legal_representative,omitempty"` // 法定代表人 PostCode *string `json:"post_code,omitempty"` // 邮编 TaxPayerId *string `json:"tax_payer_id,omitempty"` // 纳税人识别号 Confidential *bool `json:"confidential,omitempty"` // 是否保密 - SubTypeList []*Enum `json:"sub_type_list,omitempty"` // 主体类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)主体类型（company_sub_type）枚举定义部分获得 + SubTypeList []*Enum `json:"sub_type_list,omitempty"` // 主体类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 主体类型（company_sub_type）枚举定义部分获得 BranchCompany *bool `json:"branch_company,omitempty"` // 是否为分公司 PrimaryManager []*I18n `json:"primary_manager,omitempty"` // 主要负责人 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 @@ -1546,9 +1546,9 @@ type CompanyBuilder struct { idFlag bool hiberarchyCommon *HiberarchyCommon // 层级关系，内层字段见实体 hiberarchyCommonFlag bool - type_ *Enum // 性质，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)公司类型（company_type）枚举定义部分获得 + type_ *Enum // 性质，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 公司类型（company_type）枚举定义部分获得 typeFlag bool - industryList []*Enum // 行业，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)行业（industry）枚举定义部分获得 + industryList []*Enum // 行业，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 行业（industry）枚举定义部分获得 industryListFlag bool legalRepresentative []*I18n // 法定代表人 legalRepresentativeFlag bool @@ -1558,7 +1558,7 @@ type CompanyBuilder struct { taxPayerIdFlag bool confidential bool // 是否保密 confidentialFlag bool - subTypeList []*Enum // 主体类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)主体类型（company_sub_type）枚举定义部分获得 + subTypeList []*Enum // 主体类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 主体类型（company_sub_type）枚举定义部分获得 subTypeListFlag bool branchCompany bool // 是否为分公司 branchCompanyFlag bool @@ -1591,7 +1591,7 @@ func (builder *CompanyBuilder) HiberarchyCommon(hiberarchyCommon *HiberarchyComm return builder } -// 性质，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)公司类型（company_type）枚举定义部分获得 +// 性质，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 公司类型（company_type）枚举定义部分获得 // // 示例值： func (builder *CompanyBuilder) Type(type_ *Enum) *CompanyBuilder { @@ -1600,7 +1600,7 @@ func (builder *CompanyBuilder) Type(type_ *Enum) *CompanyBuilder { return builder } -// 行业，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)行业（industry）枚举定义部分获得 +// 行业，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 行业（industry）枚举定义部分获得 // // 示例值： func (builder *CompanyBuilder) IndustryList(industryList []*Enum) *CompanyBuilder { @@ -1645,7 +1645,7 @@ func (builder *CompanyBuilder) Confidential(confidential bool) *CompanyBuilder { return builder } -// 主体类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)主体类型（company_sub_type）枚举定义部分获得 +// 主体类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 主体类型（company_sub_type）枚举定义部分获得 // // 示例值： func (builder *CompanyBuilder) SubTypeList(subTypeList []*Enum) *CompanyBuilder { @@ -1728,22 +1728,22 @@ func (builder *CompanyBuilder) Build() *Company { } type Contract struct { - Id *string `json:"id,omitempty"` // 合同ID + Id *string `json:"id,omitempty"` // 合同 ID EffectiveTime *string `json:"effective_time,omitempty"` // 合同开始日期 ExpirationTime *string `json:"expiration_time,omitempty"` // 实际结束日期 EmploymentId *string `json:"employment_id,omitempty"` // 雇员 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 - ContractType *Enum `json:"contract_type,omitempty"` // 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 - FirstPartyCompanyId *string `json:"first_party_company_id,omitempty"` // 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + ContractType *Enum `json:"contract_type,omitempty"` // 合同类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 合同类型（contract_type）枚举定义部分获得 + FirstPartyCompanyId *string `json:"first_party_company_id,omitempty"` // 甲方，引用 Company 的 ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 PersonId *string `json:"person_id,omitempty"` // Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 - DurationType *Enum `json:"duration_type,omitempty"` // 期限类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同期限类型（duration_type）枚举定义部分获得 + DurationType *Enum `json:"duration_type,omitempty"` // 期限类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 合同期限类型（duration_type）枚举定义部分获得 ContractEndDate *string `json:"contract_end_date,omitempty"` // 合同结束日期 ContractNumber *string `json:"contract_number,omitempty"` // 合同编号 - SigningType *Enum `json:"signing_type,omitempty"` // 签订类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)签订类型（signing_type）枚举定义部分获得 + SigningType *Enum `json:"signing_type,omitempty"` // 签订类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 签订类型（signing_type）枚举定义部分获得 } type ContractBuilder struct { - id string // 合同ID + id string // 合同 ID idFlag bool effectiveTime string // 合同开始日期 effectiveTimeFlag bool @@ -1751,21 +1751,21 @@ type ContractBuilder struct { expirationTimeFlag bool employmentId string // 雇员 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 employmentIdFlag bool - contractType *Enum // 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 + contractType *Enum // 合同类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 合同类型（contract_type）枚举定义部分获得 contractTypeFlag bool - firstPartyCompanyId string // 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + firstPartyCompanyId string // 甲方，引用 Company 的 ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 firstPartyCompanyIdFlag bool personId string // Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 personIdFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool - durationType *Enum // 期限类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同期限类型（duration_type）枚举定义部分获得 + durationType *Enum // 期限类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 合同期限类型（duration_type）枚举定义部分获得 durationTypeFlag bool contractEndDate string // 合同结束日期 contractEndDateFlag bool contractNumber string // 合同编号 contractNumberFlag bool - signingType *Enum // 签订类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)签订类型（signing_type）枚举定义部分获得 + signingType *Enum // 签订类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 签订类型（signing_type）枚举定义部分获得 signingTypeFlag bool } @@ -1774,7 +1774,7 @@ func NewContractBuilder() *ContractBuilder { return builder } -// 合同ID +// 合同 ID // // 示例值：6919737965274990093 func (builder *ContractBuilder) Id(id string) *ContractBuilder { @@ -1810,7 +1810,7 @@ func (builder *ContractBuilder) EmploymentId(employmentId string) *ContractBuild return builder } -// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 +// 合同类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 合同类型（contract_type）枚举定义部分获得 // // 示例值： func (builder *ContractBuilder) ContractType(contractType *Enum) *ContractBuilder { @@ -1819,7 +1819,7 @@ func (builder *ContractBuilder) ContractType(contractType *Enum) *ContractBuilde return builder } -// 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 +// 甲方，引用 Company 的 ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 // // 示例值：6892686614112241165 func (builder *ContractBuilder) FirstPartyCompanyId(firstPartyCompanyId string) *ContractBuilder { @@ -1846,7 +1846,7 @@ func (builder *ContractBuilder) CustomFields(customFields []*ObjectFieldData) *C return builder } -// 期限类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同期限类型（duration_type）枚举定义部分获得 +// 期限类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 合同期限类型（duration_type）枚举定义部分获得 // // 示例值：fixed_term func (builder *ContractBuilder) DurationType(durationType *Enum) *ContractBuilder { @@ -1873,7 +1873,7 @@ func (builder *ContractBuilder) ContractNumber(contractNumber string) *ContractB return builder } -// 签订类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)签订类型（signing_type）枚举定义部分获得 +// 签订类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 签订类型（signing_type）枚举定义部分获得 // // 示例值： func (builder *ContractBuilder) SigningType(signingType *Enum) *ContractBuilder { @@ -1933,17 +1933,17 @@ func (builder *ContractBuilder) Build() *Contract { type CostCenter struct { IsAutogenerate *bool `json:"is_autogenerate,omitempty"` // 是否自动生成 - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 Name []*I18n `json:"name,omitempty"` // 实体名称 Active *bool `json:"active,omitempty"` // 当前实体是否启用 Code *string `json:"code,omitempty"` // 成本中心的编码 Description []*I18n `json:"description,omitempty"` // 成本中心的描述 EffectiveTime *string `json:"effective_time,omitempty"` // 成本中心生效时间 ExpirationTime *string `json:"expiration_time,omitempty"` // 成本中心失效时间 - Managers []string `json:"managers,omitempty"` // 成本中心管理员，lookup 到 Employment 的ID + Managers []string `json:"managers,omitempty"` // 成本中心管理员，lookup 到 Employment 的 ID Parent *string `json:"parent,omitempty"` // 上级成本中心 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 - EmploymentId *string `json:"employment_id,omitempty"` // 雇员ID + EmploymentId *string `json:"employment_id,omitempty"` // 雇员 ID Rate *int `json:"rate,omitempty"` // 雇员占成本中心比例 SupportCostCenter []*SupportCostCenterItem `json:"support_cost_center,omitempty"` // 支持的业务线列表 } @@ -1951,7 +1951,7 @@ type CostCenter struct { type CostCenterBuilder struct { isAutogenerate bool // 是否自动生成 isAutogenerateFlag bool - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool name []*I18n // 实体名称 nameFlag bool @@ -1965,13 +1965,13 @@ type CostCenterBuilder struct { effectiveTimeFlag bool expirationTime string // 成本中心失效时间 expirationTimeFlag bool - managers []string // 成本中心管理员，lookup 到 Employment 的ID + managers []string // 成本中心管理员，lookup 到 Employment 的 ID managersFlag bool parent string // 上级成本中心 parentFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool - employmentId string // 雇员ID + employmentId string // 雇员 ID employmentIdFlag bool rate int // 雇员占成本中心比例 rateFlag bool @@ -1993,7 +1993,7 @@ func (builder *CostCenterBuilder) IsAutogenerate(isAutogenerate bool) *CostCente return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：6950635856373745165 func (builder *CostCenterBuilder) Id(id string) *CostCenterBuilder { @@ -2056,7 +2056,7 @@ func (builder *CostCenterBuilder) ExpirationTime(expirationTime string) *CostCen return builder } -// 成本中心管理员，lookup 到 Employment 的ID +// 成本中心管理员，lookup 到 Employment 的 ID // // 示例值： func (builder *CostCenterBuilder) Managers(managers []string) *CostCenterBuilder { @@ -2083,7 +2083,7 @@ func (builder *CostCenterBuilder) CustomFields(customFields []*ObjectFieldData) return builder } -// 雇员ID +// 雇员 ID // // 示例值：6950635856373745165 func (builder *CostCenterBuilder) EmploymentId(employmentId string) *CostCenterBuilder { @@ -2168,17 +2168,17 @@ func (builder *CostCenterBuilder) Build() *CostCenter { type CostCenterQuery struct { IsAutogenerate *bool `json:"is_autogenerate,omitempty"` // 是否自动生成 - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 Name []*I18n `json:"name,omitempty"` // 实体名称 Active *bool `json:"active,omitempty"` // 当前实体是否启用 Code *string `json:"code,omitempty"` // 成本中心的编码 Description []*I18n `json:"description,omitempty"` // 成本中心的描述 EffectiveTime *string `json:"effective_time,omitempty"` // 成本中心生效时间 ExpirationTime *string `json:"expiration_time,omitempty"` // 成本中心失效时间 - Managers []string `json:"managers,omitempty"` // 成本中心管理员，lookup 到 Employment 的ID + Managers []string `json:"managers,omitempty"` // 成本中心管理员，lookup 到 Employment 的 ID Parent *string `json:"parent,omitempty"` // 上级成本中心 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 - EmploymentId *string `json:"employment_id,omitempty"` // 雇员ID + EmploymentId *string `json:"employment_id,omitempty"` // 雇员 ID Rate *int `json:"rate,omitempty"` // 雇员占成本中心比例 SupportCostCenter []*SupportCostCenterItem `json:"support_cost_center,omitempty"` // 支持的业务线列表 } @@ -2186,7 +2186,7 @@ type CostCenterQuery struct { type CostCenterQueryBuilder struct { isAutogenerate bool // 是否自动生成 isAutogenerateFlag bool - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool name []*I18n // 实体名称 nameFlag bool @@ -2200,13 +2200,13 @@ type CostCenterQueryBuilder struct { effectiveTimeFlag bool expirationTime string // 成本中心失效时间 expirationTimeFlag bool - managers []string // 成本中心管理员，lookup 到 Employment 的ID + managers []string // 成本中心管理员，lookup 到 Employment 的 ID managersFlag bool parent string // 上级成本中心 parentFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool - employmentId string // 雇员ID + employmentId string // 雇员 ID employmentIdFlag bool rate int // 雇员占成本中心比例 rateFlag bool @@ -2228,7 +2228,7 @@ func (builder *CostCenterQueryBuilder) IsAutogenerate(isAutogenerate bool) *Cost return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：6950635856373745165 func (builder *CostCenterQueryBuilder) Id(id string) *CostCenterQueryBuilder { @@ -2291,7 +2291,7 @@ func (builder *CostCenterQueryBuilder) ExpirationTime(expirationTime string) *Co return builder } -// 成本中心管理员，lookup 到 Employment 的ID +// 成本中心管理员，lookup 到 Employment 的 ID // // 示例值： func (builder *CostCenterQueryBuilder) Managers(managers []string) *CostCenterQueryBuilder { @@ -2318,7 +2318,7 @@ func (builder *CostCenterQueryBuilder) CustomFields(customFields []*ObjectFieldD return builder } -// 雇员ID +// 雇员 ID // // 示例值：6950635856373745165 func (builder *CostCenterQueryBuilder) EmploymentId(employmentId string) *CostCenterQueryBuilder { @@ -2402,14 +2402,14 @@ func (builder *CostCenterQueryBuilder) Build() *CostCenterQuery { } type CountryRegion struct { - Id *string `json:"id,omitempty"` // 国家/地区id + Id *string `json:"id,omitempty"` // 国家/地区 id Name []*I18n `json:"name,omitempty"` // 国家/地区名称 Alpha3Code *string `json:"alpha_3_code,omitempty"` // 国家地区三字码 Alpha2Code *string `json:"alpha_2_code,omitempty"` // 国家地区二字码 } type CountryRegionBuilder struct { - id string // 国家/地区id + id string // 国家/地区 id idFlag bool name []*I18n // 国家/地区名称 nameFlag bool @@ -2424,7 +2424,7 @@ func NewCountryRegionBuilder() *CountryRegionBuilder { return builder } -// 国家/地区id +// 国家/地区 id // // 示例值：1 func (builder *CountryRegionBuilder) Id(id string) *CountryRegionBuilder { @@ -2529,15 +2529,15 @@ func (builder *CpstBandWidthBuilder) Build() *CpstBandWidth { } type CpstCurrency struct { - CurrencyId *string `json:"currency_id,omitempty"` // 币种ID - Code *string `json:"code,omitempty"` // 币种code + CurrencyId *string `json:"currency_id,omitempty"` // 币种 ID + Code *string `json:"code,omitempty"` // 币种 code Name *CpstI18n `json:"name,omitempty"` // 币种名称 } type CpstCurrencyBuilder struct { - currencyId string // 币种ID + currencyId string // 币种 ID currencyIdFlag bool - code string // 币种code + code string // 币种 code codeFlag bool name *CpstI18n // 币种名称 nameFlag bool @@ -2548,7 +2548,7 @@ func NewCpstCurrencyBuilder() *CpstCurrencyBuilder { return builder } -// 币种ID +// 币种 ID // // 示例值：6863329932261459464 func (builder *CpstCurrencyBuilder) CurrencyId(currencyId string) *CpstCurrencyBuilder { @@ -2557,7 +2557,7 @@ func (builder *CpstCurrencyBuilder) CurrencyId(currencyId string) *CpstCurrencyB return builder } -// 币种code +// 币种 code // // 示例值：CNY func (builder *CpstCurrencyBuilder) Code(code string) *CpstCurrencyBuilder { @@ -2592,17 +2592,17 @@ func (builder *CpstCurrencyBuilder) Build() *CpstCurrency { } type CpstGrade struct { - GradeId *string `json:"grade_id,omitempty"` // 薪资等级ID - GradeTid *string `json:"grade_tid,omitempty"` // 薪资等级时间轴ID + GradeId *string `json:"grade_id,omitempty"` // 薪资等级 ID + GradeTid *string `json:"grade_tid,omitempty"` // 薪资等级时间轴 ID GradeStandardValue *CpstGradeStandardValue `json:"grade_standard_value,omitempty"` // 带宽上下限和标准值 Currency *CpstCurrency `json:"currency,omitempty"` // 币种 Description *CpstI18n `json:"description,omitempty"` // 薪资标准描述 } type CpstGradeBuilder struct { - gradeId string // 薪资等级ID + gradeId string // 薪资等级 ID gradeIdFlag bool - gradeTid string // 薪资等级时间轴ID + gradeTid string // 薪资等级时间轴 ID gradeTidFlag bool gradeStandardValue *CpstGradeStandardValue // 带宽上下限和标准值 gradeStandardValueFlag bool @@ -2617,7 +2617,7 @@ func NewCpstGradeBuilder() *CpstGradeBuilder { return builder } -// 薪资等级ID +// 薪资等级 ID // // 示例值：7174758360888215084 func (builder *CpstGradeBuilder) GradeId(gradeId string) *CpstGradeBuilder { @@ -2626,7 +2626,7 @@ func (builder *CpstGradeBuilder) GradeId(gradeId string) *CpstGradeBuilder { return builder } -// 薪资等级时间轴ID +// 薪资等级时间轴 ID // // 示例值：7174758360888247852 func (builder *CpstGradeBuilder) GradeTid(gradeTid string) *CpstGradeBuilder { @@ -2810,13 +2810,13 @@ func (builder *CpstI18nBuilder) Build() *CpstI18n { } type CpstMatchItem struct { - StandardId *string `json:"standard_id,omitempty"` // 薪资标准表ID + StandardId *string `json:"standard_id,omitempty"` // 薪资标准表 ID Grade *CpstGrade `json:"grade,omitempty"` // 薪资等级 EffectiveTime *string `json:"effective_time,omitempty"` // 生效时间 } type CpstMatchItemBuilder struct { - standardId string // 薪资标准表ID + standardId string // 薪资标准表 ID standardIdFlag bool grade *CpstGrade // 薪资等级 gradeFlag bool @@ -2829,7 +2829,7 @@ func NewCpstMatchItemBuilder() *CpstMatchItemBuilder { return builder } -// 薪资标准表ID +// 薪资标准表 ID // // 示例值：7174758593538295340 func (builder *CpstMatchItemBuilder) StandardId(standardId string) *CpstMatchItemBuilder { @@ -2905,17 +2905,17 @@ func (builder *CpstStandardTypeBuilder) Build() *CpstStandardType { } type Currency struct { - Id *string `json:"id,omitempty"` // 货币id - CountryRegionId *string `json:"country_region_id,omitempty"` // 货币所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 + Id *string `json:"id,omitempty"` // 货币 id + CountryRegionId *string `json:"country_region_id,omitempty"` // 货币所属国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 CurrencyName []*I18n `json:"currency_name,omitempty"` // 货币名称 NumericCode *int `json:"numeric_code,omitempty"` // 数字代码 CurrencyAlpha3Code *string `json:"currency_alpha_3_code,omitempty"` // 三位字母代码 } type CurrencyBuilder struct { - id string // 货币id + id string // 货币 id idFlag bool - countryRegionId string // 货币所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 + countryRegionId string // 货币所属国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 countryRegionIdFlag bool currencyName []*I18n // 货币名称 currencyNameFlag bool @@ -2930,7 +2930,7 @@ func NewCurrencyBuilder() *CurrencyBuilder { return builder } -// 货币id +// 货币 id // // 示例值：1 func (builder *CurrencyBuilder) Id(id string) *CurrencyBuilder { @@ -2939,7 +2939,7 @@ func (builder *CurrencyBuilder) Id(id string) *CurrencyBuilder { return builder } -// 货币所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 +// 货币所属国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 // // 示例值：12 func (builder *CurrencyBuilder) CountryRegionId(countryRegionId string) *CurrencyBuilder { @@ -3349,7 +3349,7 @@ func (builder *DateTimeFieldSettingBuilder) Build() *DateTimeFieldSetting { type Department struct { Id *string `json:"id,omitempty"` // 部门 ID - SubType *Enum `json:"sub_type,omitempty"` // 部门子类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)部门子类型（department_sub_type）枚举定义部分获得 + SubType *Enum `json:"sub_type,omitempty"` // 部门子类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 部门子类型（department_sub_type）枚举定义部分获得 Manager *string `json:"manager,omitempty"` // 部门负责人 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 IsConfidential *bool `json:"is_confidential,omitempty"` // 是否保密 HiberarchyCommon *HiberarchyCommon `json:"hiberarchy_common,omitempty"` // 层级关系，内层字段见实体 @@ -3361,7 +3361,7 @@ type Department struct { type DepartmentBuilder struct { id string // 部门 ID idFlag bool - subType *Enum // 部门子类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)部门子类型（department_sub_type）枚举定义部分获得 + subType *Enum // 部门子类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 部门子类型（department_sub_type）枚举定义部分获得 subTypeFlag bool manager string // 部门负责人 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 managerFlag bool @@ -3391,7 +3391,7 @@ func (builder *DepartmentBuilder) Id(id string) *DepartmentBuilder { return builder } -// 部门子类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)部门子类型（department_sub_type）枚举定义部分获得 +// 部门子类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 部门子类型（department_sub_type）枚举定义部分获得 // // 示例值： func (builder *DepartmentBuilder) SubType(subType *Enum) *DepartmentBuilder { @@ -3489,7 +3489,7 @@ func (builder *DepartmentBuilder) Build() *Department { } type DepartmentCreate struct { - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 SubType *Enum `json:"sub_type,omitempty"` // 子类型 Manager *string `json:"manager,omitempty"` // 部门负责人 IsConfidential *bool `json:"is_confidential,omitempty"` // 是否保密 @@ -3500,7 +3500,7 @@ type DepartmentCreate struct { } type DepartmentCreateBuilder struct { - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool subType *Enum // 子类型 subTypeFlag bool @@ -3523,7 +3523,7 @@ func NewDepartmentCreateBuilder() *DepartmentCreateBuilder { return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：4719456877659520852 func (builder *DepartmentCreateBuilder) Id(id string) *DepartmentCreateBuilder { @@ -3631,12 +3631,12 @@ func (builder *DepartmentCreateBuilder) Build() *DepartmentCreate { type Dependent struct { Name *PersonName `json:"name,omitempty"` // 亲属姓名 - Relationship *Enum `json:"relationship,omitempty"` // 亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得 - Gender *Enum `json:"gender,omitempty"` // 亲属性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得 + Relationship *Enum `json:"relationship,omitempty"` // 亲属关系，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 亲属关系（relationship）枚举定义获得 + Gender *Enum `json:"gender,omitempty"` // 亲属性别，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 性别（gender）枚举定义部分获得 DateOfBirth *string `json:"date_of_birth,omitempty"` // 生日 NationalityId *string `json:"nationality_id,omitempty"` // 国籍 NationalIdList []*NationalId `json:"national_id_list,omitempty"` // 证件号码 - SpousesWorkingStatus *Enum `json:"spouses_working_status,omitempty"` // 配偶工作状态，比如working（在岗）、not_working（不在岗） + SpousesWorkingStatus *Enum `json:"spouses_working_status,omitempty"` // 配偶工作状态，比如 working（在岗）、not_working（不在岗） IsThisPersonCoveredByHealthInsurance *bool `json:"is_this_person_covered_by_health_insurance,omitempty"` // 包含家属医疗保险 IsThisPersonAllowedForTaxDeduction *bool `json:"is_this_person_allowed_for_tax_deduction,omitempty"` // 允许家属抵扣税款 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 @@ -3645,9 +3645,9 @@ type Dependent struct { type DependentBuilder struct { name *PersonName // 亲属姓名 nameFlag bool - relationship *Enum // 亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得 + relationship *Enum // 亲属关系，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 亲属关系（relationship）枚举定义获得 relationshipFlag bool - gender *Enum // 亲属性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得 + gender *Enum // 亲属性别，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 性别（gender）枚举定义部分获得 genderFlag bool dateOfBirth string // 生日 dateOfBirthFlag bool @@ -3655,7 +3655,7 @@ type DependentBuilder struct { nationalityIdFlag bool nationalIdList []*NationalId // 证件号码 nationalIdListFlag bool - spousesWorkingStatus *Enum // 配偶工作状态，比如working（在岗）、not_working（不在岗） + spousesWorkingStatus *Enum // 配偶工作状态，比如 working（在岗）、not_working（不在岗） spousesWorkingStatusFlag bool isThisPersonCoveredByHealthInsurance bool // 包含家属医疗保险 isThisPersonCoveredByHealthInsuranceFlag bool @@ -3679,7 +3679,7 @@ func (builder *DependentBuilder) Name(name *PersonName) *DependentBuilder { return builder } -// 亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得 +// 亲属关系，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 亲属关系（relationship）枚举定义获得 // // 示例值： func (builder *DependentBuilder) Relationship(relationship *Enum) *DependentBuilder { @@ -3688,7 +3688,7 @@ func (builder *DependentBuilder) Relationship(relationship *Enum) *DependentBuil return builder } -// 亲属性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得 +// 亲属性别，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 性别（gender）枚举定义部分获得 // // 示例值： func (builder *DependentBuilder) Gender(gender *Enum) *DependentBuilder { @@ -3724,7 +3724,7 @@ func (builder *DependentBuilder) NationalIdList(nationalIdList []*NationalId) *D return builder } -// 配偶工作状态，比如working（在岗）、not_working（不在岗） +// 配偶工作状态，比如 working（在岗）、not_working（不在岗） // // 示例值： func (builder *DependentBuilder) SpousesWorkingStatus(spousesWorkingStatus *Enum) *DependentBuilder { @@ -3800,14 +3800,14 @@ func (builder *DependentBuilder) Build() *Dependent { } type DimensionValue struct { - ApiName *string `json:"api_name,omitempty"` // 管理维度名称 eg. department（部门）、job_family(序列) 更多可以去元数据平台搜索cpst_management_dimension - ValueList []string `json:"value_list,omitempty"` // 值列表 例如部门ID + ApiName *string `json:"api_name,omitempty"` // 管理维度名称 eg. department（部门）、job_family(序列) 更多可以去元数据平台搜索 cpst_management_dimension + ValueList []string `json:"value_list,omitempty"` // 值列表 例如部门 ID } type DimensionValueBuilder struct { - apiName string // 管理维度名称 eg. department（部门）、job_family(序列) 更多可以去元数据平台搜索cpst_management_dimension + apiName string // 管理维度名称 eg. department（部门）、job_family(序列) 更多可以去元数据平台搜索 cpst_management_dimension apiNameFlag bool - valueList []string // 值列表 例如部门ID + valueList []string // 值列表 例如部门 ID valueListFlag bool } @@ -3816,7 +3816,7 @@ func NewDimensionValueBuilder() *DimensionValueBuilder { return builder } -// 管理维度名称 eg. department（部门）、job_family(序列) 更多可以去元数据平台搜索cpst_management_dimension +// 管理维度名称 eg. department（部门）、job_family(序列) 更多可以去元数据平台搜索 cpst_management_dimension // // 示例值：department func (builder *DimensionValueBuilder) ApiName(apiName string) *DimensionValueBuilder { @@ -3825,7 +3825,7 @@ func (builder *DimensionValueBuilder) ApiName(apiName string) *DimensionValueBui return builder } -// 值列表 例如部门ID +// 值列表 例如部门 ID // // 示例值： func (builder *DimensionValueBuilder) ValueList(valueList []string) *DimensionValueBuilder { @@ -3848,14 +3848,14 @@ func (builder *DimensionValueBuilder) Build() *DimensionValue { type Education struct { School []*I18n `json:"school,omitempty"` // 学校 - LevelOfEducation *Enum `json:"level_of_education,omitempty"` // 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（level_of_education）枚举定义获得 + LevelOfEducation *Enum `json:"level_of_education,omitempty"` // 学历，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 学历（level_of_education）枚举定义获得 StartDate *string `json:"start_date,omitempty"` // 开始日期 EndDate *string `json:"end_date,omitempty"` // 结束日期 FieldOfStudy []*I18n `json:"field_of_study,omitempty"` // 专业 - Degree *Enum `json:"degree,omitempty"` // 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（degree）枚举定义获得 + Degree *Enum `json:"degree,omitempty"` // 学位，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 学位（degree）枚举定义获得 SchoolName *Enum `json:"school_name,omitempty"` // 学校名称 FieldOfStudyName *Enum `json:"field_of_study_name,omitempty"` // 专业名称 - CountryRegionId *string `json:"country_region_id,omitempty"` // 国家地区ID + CountryRegionId *string `json:"country_region_id,omitempty"` // 国家地区 ID ExpectedEndDate *string `json:"expected_end_date,omitempty"` // 预期结束日期 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 } @@ -3863,7 +3863,7 @@ type Education struct { type EducationBuilder struct { school []*I18n // 学校 schoolFlag bool - levelOfEducation *Enum // 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（level_of_education）枚举定义获得 + levelOfEducation *Enum // 学历，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 学历（level_of_education）枚举定义获得 levelOfEducationFlag bool startDate string // 开始日期 startDateFlag bool @@ -3871,13 +3871,13 @@ type EducationBuilder struct { endDateFlag bool fieldOfStudy []*I18n // 专业 fieldOfStudyFlag bool - degree *Enum // 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（degree）枚举定义获得 + degree *Enum // 学位，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 学位（degree）枚举定义获得 degreeFlag bool schoolName *Enum // 学校名称 schoolNameFlag bool fieldOfStudyName *Enum // 专业名称 fieldOfStudyNameFlag bool - countryRegionId string // 国家地区ID + countryRegionId string // 国家地区 ID countryRegionIdFlag bool expectedEndDate string // 预期结束日期 expectedEndDateFlag bool @@ -3899,7 +3899,7 @@ func (builder *EducationBuilder) School(school []*I18n) *EducationBuilder { return builder } -// 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（level_of_education）枚举定义获得 +// 学历，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 学历（level_of_education）枚举定义获得 // // 示例值： func (builder *EducationBuilder) LevelOfEducation(levelOfEducation *Enum) *EducationBuilder { @@ -3935,7 +3935,7 @@ func (builder *EducationBuilder) FieldOfStudy(fieldOfStudy []*I18n) *EducationBu return builder } -// 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（degree）枚举定义获得 +// 学位，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 学位（degree）枚举定义获得 // // 示例值： func (builder *EducationBuilder) Degree(degree *Enum) *EducationBuilder { @@ -3962,7 +3962,7 @@ func (builder *EducationBuilder) FieldOfStudyName(fieldOfStudyName *Enum) *Educa return builder } -// 国家地区ID +// 国家地区 ID // // 示例值：1 func (builder *EducationBuilder) CountryRegionId(countryRegionId string) *EducationBuilder { @@ -4035,7 +4035,7 @@ type Email struct { Email *string `json:"email,omitempty"` // 邮箱号 IsPrimary *bool `json:"is_primary,omitempty"` // 是否为主要邮箱 IsPublic *bool `json:"is_public,omitempty"` // 是否为公开邮箱 - EmailUsage *Enum `json:"email_usage,omitempty"` // 邮箱用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 + EmailUsage *Enum `json:"email_usage,omitempty"` // 邮箱用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 邮箱用途（email_usage）枚举定义获得 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 } @@ -4046,7 +4046,7 @@ type EmailBuilder struct { isPrimaryFlag bool isPublic bool // 是否为公开邮箱 isPublicFlag bool - emailUsage *Enum // 邮箱用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 + emailUsage *Enum // 邮箱用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 邮箱用途（email_usage）枚举定义获得 emailUsageFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool @@ -4084,7 +4084,7 @@ func (builder *EmailBuilder) IsPublic(isPublic bool) *EmailBuilder { return builder } -// 邮箱用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 +// 邮箱用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 邮箱用途（email_usage）枚举定义获得 // // 示例值： func (builder *EmailBuilder) EmailUsage(emailUsage *Enum) *EmailBuilder { @@ -4127,7 +4127,7 @@ func (builder *EmailBuilder) Build() *Email { type EmergencyContact struct { Name *PersonName `json:"name,omitempty"` // 紧急联系人姓名 - Relationship *Enum `json:"relationship,omitempty"` // 紧急联系人与本人亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得 + Relationship *Enum `json:"relationship,omitempty"` // 紧急联系人与本人亲属关系，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 亲属关系（relationship）枚举定义获得 PhoneIst []*Phone `json:"phone_ist,omitempty"` // 紧急联系人电话 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 LegalName *string `json:"legal_name,omitempty"` // 法定姓名 @@ -4136,7 +4136,7 @@ type EmergencyContact struct { type EmergencyContactBuilder struct { name *PersonName // 紧急联系人姓名 nameFlag bool - relationship *Enum // 紧急联系人与本人亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得 + relationship *Enum // 紧急联系人与本人亲属关系，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 亲属关系（relationship）枚举定义获得 relationshipFlag bool phoneIst []*Phone // 紧急联系人电话 phoneIstFlag bool @@ -4160,7 +4160,7 @@ func (builder *EmergencyContactBuilder) Name(name *PersonName) *EmergencyContact return builder } -// 紧急联系人与本人亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得 +// 紧急联系人与本人亲属关系，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 亲属关系（relationship）枚举定义获得 // // 示例值： func (builder *EmergencyContactBuilder) Relationship(relationship *Enum) *EmergencyContactBuilder { @@ -4218,7 +4218,7 @@ func (builder *EmergencyContactBuilder) Build() *EmergencyContact { } type EmployeeType struct { - Id *string `json:"id,omitempty"` // 雇员类型ID + Id *string `json:"id,omitempty"` // 雇员类型 ID Name []*I18n `json:"name,omitempty"` // 名称 DefaultEmployeeType *bool `json:"default_employee_type,omitempty"` // 是否为默认人员类型，每个租户只能定义一个默认人员类型 Active *bool `json:"active,omitempty"` // 启用 @@ -4227,7 +4227,7 @@ type EmployeeType struct { } type EmployeeTypeBuilder struct { - id string // 雇员类型ID + id string // 雇员类型 ID idFlag bool name []*I18n // 名称 nameFlag bool @@ -4246,7 +4246,7 @@ func NewEmployeeTypeBuilder() *EmployeeTypeBuilder { return builder } -// 雇员类型ID +// 雇员类型 ID // // 示例值：6919732473504990727 func (builder *EmployeeTypeBuilder) Id(id string) *EmployeeTypeBuilder { @@ -4328,7 +4328,7 @@ func (builder *EmployeeTypeBuilder) Build() *EmployeeType { } type Employment struct { - PrehireId *string `json:"prehire_id,omitempty"` // 待入职ID + PrehireId *string `json:"prehire_id,omitempty"` // 待入职 ID EmployeeTypeId *string `json:"employee_type_id,omitempty"` // 人员类型 Tenure *string `json:"tenure,omitempty"` // 司龄 DepartmentId *string `json:"department_id,omitempty"` // 部门 ID，详细信息可通过【查询单个部门】接口获得 @@ -4338,30 +4338,30 @@ type Employment struct { JobId *string `json:"job_id,omitempty"` // 职务 ID，详细信息可通过【查询单个职务】接口获得 CompanyId *string `json:"company_id,omitempty"` // 法人主体 ID，详细信息可通过【查询单个公司】接口获得 WorkingHoursTypeId *string `json:"working_hours_type_id,omitempty"` // 工时制度 ID，详细信息可通过【查询单个工时制度】接口获得 - Id *string `json:"id,omitempty"` // 雇员ID + Id *string `json:"id,omitempty"` // 雇员 ID SeniorityDate *string `json:"seniority_date,omitempty"` // 资历起算日期 EmployeeNumber *string `json:"employee_number,omitempty"` // 员工编号 EffectiveTime *string `json:"effective_time,omitempty"` // 入职日期 - ExpirationTime *string `json:"expiration_time,omitempty"` // 离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为“在职”，次日凌晨将更改为“离职” - EmploymentType *Enum `json:"employment_type,omitempty"` // 雇佣类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)雇佣类型（employment_type）枚举定义获得 + ExpirationTime *string `json:"expiration_time,omitempty"` // 离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为 “在职”，次日凌晨将更改为 “离职” + EmploymentType *Enum `json:"employment_type,omitempty"` // 雇佣类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 雇佣类型（employment_type）枚举定义获得 PersonId *string `json:"person_id,omitempty"` // 个人信息 ID，详细信息可通过【查询单个个人信息】接口获得 ProbationPeriod *int `json:"probation_period,omitempty"` // 试用期时长（月份） OnProbation *string `json:"on_probation,omitempty"` // 是否在试用期中;- 满足以下任一条件时，该字段值为`"true"`：; - 预计试用结束日期非空，且实际结束日期为空; - 预计试用结束日期非空，实际结束日期非空，且当日日期小于等于实际结束日期;- 其余情况下，该字段值为`"false"`； ProbationEndDate *string `json:"probation_end_date,omitempty"` // 试用期结束日期（实际结束日期） PrimaryEmployment *bool `json:"primary_employment,omitempty"` // 是否是主雇佣信息 - EmploymentStatus *Enum `json:"employment_status,omitempty"` // 雇员状态，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)雇员状态（employment_status）枚举定义获得 + EmploymentStatus *Enum `json:"employment_status,omitempty"` // 雇员状态，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 雇员状态（employment_status）枚举定义获得 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 WorkEmailList []*Email `json:"work_email_list,omitempty"` // 工作邮箱列表，只有当邮箱下面所有条件时，才在个人信息页面可见： ;- is_primary = "true";- is_public = "true";- email_usage = "work" EmailAddress *string `json:"email_address,omitempty"` // 邮箱 - ReasonForOffboarding *Enum `json:"reason_for_offboarding,omitempty"` // 离职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)离职原因（reason_for_offboarding）枚举定义部分获得 - CostCenterList []*JobDataCostCenter `json:"cost_center_list,omitempty"` // 成本中心id列表 + ReasonForOffboarding *Enum `json:"reason_for_offboarding,omitempty"` // 离职原因，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 离职原因（reason_for_offboarding）枚举定义部分获得 + CostCenterList []*JobDataCostCenter `json:"cost_center_list,omitempty"` // 成本中心 id 列表 AtsApplicationId *string `json:"ats_application_id,omitempty"` // 招聘应用 ID Rehire *Enum `json:"rehire,omitempty"` // 是否离职重聘 RehireEmploymentId *string `json:"rehire_employment_id,omitempty"` // 历史雇佣信息 ID，可以通过【查询单个雇佣信息】查询详细信息 } type EmploymentBuilder struct { - prehireId string // 待入职ID + prehireId string // 待入职 ID prehireIdFlag bool employeeTypeId string // 人员类型 employeeTypeIdFlag bool @@ -4381,7 +4381,7 @@ type EmploymentBuilder struct { companyIdFlag bool workingHoursTypeId string // 工时制度 ID，详细信息可通过【查询单个工时制度】接口获得 workingHoursTypeIdFlag bool - id string // 雇员ID + id string // 雇员 ID idFlag bool seniorityDate string // 资历起算日期 seniorityDateFlag bool @@ -4389,9 +4389,9 @@ type EmploymentBuilder struct { employeeNumberFlag bool effectiveTime string // 入职日期 effectiveTimeFlag bool - expirationTime string // 离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为“在职”，次日凌晨将更改为“离职” + expirationTime string // 离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为 “在职”，次日凌晨将更改为 “离职” expirationTimeFlag bool - employmentType *Enum // 雇佣类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)雇佣类型（employment_type）枚举定义获得 + employmentType *Enum // 雇佣类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 雇佣类型（employment_type）枚举定义获得 employmentTypeFlag bool personId string // 个人信息 ID，详细信息可通过【查询单个个人信息】接口获得 personIdFlag bool @@ -4403,7 +4403,7 @@ type EmploymentBuilder struct { probationEndDateFlag bool primaryEmployment bool // 是否是主雇佣信息 primaryEmploymentFlag bool - employmentStatus *Enum // 雇员状态，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)雇员状态（employment_status）枚举定义获得 + employmentStatus *Enum // 雇员状态，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 雇员状态（employment_status）枚举定义获得 employmentStatusFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool @@ -4411,9 +4411,9 @@ type EmploymentBuilder struct { workEmailListFlag bool emailAddress string // 邮箱 emailAddressFlag bool - reasonForOffboarding *Enum // 离职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)离职原因（reason_for_offboarding）枚举定义部分获得 + reasonForOffboarding *Enum // 离职原因，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 离职原因（reason_for_offboarding）枚举定义部分获得 reasonForOffboardingFlag bool - costCenterList []*JobDataCostCenter // 成本中心id列表 + costCenterList []*JobDataCostCenter // 成本中心 id 列表 costCenterListFlag bool atsApplicationId string // 招聘应用 ID atsApplicationIdFlag bool @@ -4428,7 +4428,7 @@ func NewEmploymentBuilder() *EmploymentBuilder { return builder } -// 待入职ID +// 待入职 ID // // 示例值：1 func (builder *EmploymentBuilder) PrehireId(prehireId string) *EmploymentBuilder { @@ -4518,7 +4518,7 @@ func (builder *EmploymentBuilder) WorkingHoursTypeId(workingHoursTypeId string) return builder } -// 雇员ID +// 雇员 ID // // 示例值：6893014062142064135 func (builder *EmploymentBuilder) Id(id string) *EmploymentBuilder { @@ -4554,7 +4554,7 @@ func (builder *EmploymentBuilder) EffectiveTime(effectiveTime string) *Employmen return builder } -// 离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为“在职”，次日凌晨将更改为“离职” +// 离职日期，即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为 “在职”，次日凌晨将更改为 “离职” // // 示例值：2021-01-01 00:00:00 func (builder *EmploymentBuilder) ExpirationTime(expirationTime string) *EmploymentBuilder { @@ -4563,7 +4563,7 @@ func (builder *EmploymentBuilder) ExpirationTime(expirationTime string) *Employm return builder } -// 雇佣类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)雇佣类型（employment_type）枚举定义获得 +// 雇佣类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 雇佣类型（employment_type）枚举定义获得 // // 示例值： func (builder *EmploymentBuilder) EmploymentType(employmentType *Enum) *EmploymentBuilder { @@ -4617,7 +4617,7 @@ func (builder *EmploymentBuilder) PrimaryEmployment(primaryEmployment bool) *Emp return builder } -// 雇员状态，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)雇员状态（employment_status）枚举定义获得 +// 雇员状态，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 雇员状态（employment_status）枚举定义获得 // // 示例值： func (builder *EmploymentBuilder) EmploymentStatus(employmentStatus *Enum) *EmploymentBuilder { @@ -4653,7 +4653,7 @@ func (builder *EmploymentBuilder) EmailAddress(emailAddress string) *EmploymentB return builder } -// 离职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)离职原因（reason_for_offboarding）枚举定义部分获得 +// 离职原因，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 离职原因（reason_for_offboarding）枚举定义部分获得 // // 示例值： func (builder *EmploymentBuilder) ReasonForOffboarding(reasonForOffboarding *Enum) *EmploymentBuilder { @@ -4662,7 +4662,7 @@ func (builder *EmploymentBuilder) ReasonForOffboarding(reasonForOffboarding *Enu return builder } -// 成本中心id列表 +// 成本中心 id 列表 // // 示例值： func (builder *EmploymentBuilder) CostCenterList(costCenterList []*JobDataCostCenter) *EmploymentBuilder { @@ -4817,12 +4817,12 @@ func (builder *EmploymentBuilder) Build() *Employment { } type EmploymentCostCenter struct { - EmploymentId *string `json:"employment_id,omitempty"` // 雇员ID + EmploymentId *string `json:"employment_id,omitempty"` // 雇员 ID CostCenter []*CostCenter `json:"cost_center,omitempty"` // 自定义字段 } type EmploymentCostCenterBuilder struct { - employmentId string // 雇员ID + employmentId string // 雇员 ID employmentIdFlag bool costCenter []*CostCenter // 自定义字段 costCenterFlag bool @@ -4833,7 +4833,7 @@ func NewEmploymentCostCenterBuilder() *EmploymentCostCenterBuilder { return builder } -// 雇员ID +// 雇员 ID // // 示例值：6950635856373745165 func (builder *EmploymentCostCenterBuilder) EmploymentId(employmentId string) *EmploymentCostCenterBuilder { @@ -4864,7 +4864,7 @@ func (builder *EmploymentCostCenterBuilder) Build() *EmploymentCostCenter { } type EmploymentCreate struct { - PrehireId *string `json:"prehire_id,omitempty"` // 待入职ID + PrehireId *string `json:"prehire_id,omitempty"` // 待入职 ID EmployeeTypeId *string `json:"employee_type_id,omitempty"` // 人员类型 Tenure *string `json:"tenure,omitempty"` // 司龄 DepartmentId *string `json:"department_id,omitempty"` // 部门 ID，枚举值及详细信息可通过【批量查询部门】接口查询获得 @@ -4874,13 +4874,13 @@ type EmploymentCreate struct { JobId *string `json:"job_id,omitempty"` // 职务 ID，枚举值及详细信息可通过【批量查询职务】接口查询获得 CompanyId *string `json:"company_id,omitempty"` // 法人主体 ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 WorkingHoursTypeId *string `json:"working_hours_type_id,omitempty"` // 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 SeniorityDate *string `json:"seniority_date,omitempty"` // 资历起算日期 EmployeeNumber *string `json:"employee_number,omitempty"` // 员工编号 EffectiveTime *string `json:"effective_time,omitempty"` // 入职日期 ExpirationTime *string `json:"expiration_time,omitempty"` // 离职日期 EmploymentType *Enum `json:"employment_type,omitempty"` // 雇佣类型 - PersonId *string `json:"person_id,omitempty"` // 人员信息，引用Person的ID + PersonId *string `json:"person_id,omitempty"` // 人员信息，引用 Person 的 ID ProbationPeriod *int `json:"probation_period,omitempty"` // 试用期时长 OnProbation *string `json:"on_probation,omitempty"` // 是否在试用期中 ProbationEndDate *string `json:"probation_end_date,omitempty"` // 试用期结束日期 @@ -4890,14 +4890,14 @@ type EmploymentCreate struct { WorkEmailList []*Email `json:"work_email_list,omitempty"` // 工作邮箱列表，只有当邮箱下面所有条件时，才在个人信息页面可见： ;- is_primary = "true";- is_public = "true";- email_usage = "work" EmailAddress *string `json:"email_address,omitempty"` // 邮箱 ReasonForOffboarding *Enum `json:"reason_for_offboarding,omitempty"` // 离职原因 - CostCenterList []*JobDataCostCenter `json:"cost_center_list,omitempty"` // 成本中心id列表 + CostCenterList []*JobDataCostCenter `json:"cost_center_list,omitempty"` // 成本中心 id 列表 AtsApplicationId *string `json:"ats_application_id,omitempty"` // 招聘应用 ID Rehire *Enum `json:"rehire,omitempty"` // 是否离职重聘 RehireEmploymentId *string `json:"rehire_employment_id,omitempty"` // 历史雇佣信息 ID } type EmploymentCreateBuilder struct { - prehireId string // 待入职ID + prehireId string // 待入职 ID prehireIdFlag bool employeeTypeId string // 人员类型 employeeTypeIdFlag bool @@ -4917,7 +4917,7 @@ type EmploymentCreateBuilder struct { companyIdFlag bool workingHoursTypeId string // 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 workingHoursTypeIdFlag bool - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool seniorityDate string // 资历起算日期 seniorityDateFlag bool @@ -4929,7 +4929,7 @@ type EmploymentCreateBuilder struct { expirationTimeFlag bool employmentType *Enum // 雇佣类型 employmentTypeFlag bool - personId string // 人员信息，引用Person的ID + personId string // 人员信息，引用 Person 的 ID personIdFlag bool probationPeriod int // 试用期时长 probationPeriodFlag bool @@ -4949,7 +4949,7 @@ type EmploymentCreateBuilder struct { emailAddressFlag bool reasonForOffboarding *Enum // 离职原因 reasonForOffboardingFlag bool - costCenterList []*JobDataCostCenter // 成本中心id列表 + costCenterList []*JobDataCostCenter // 成本中心 id 列表 costCenterListFlag bool atsApplicationId string // 招聘应用 ID atsApplicationIdFlag bool @@ -4964,7 +4964,7 @@ func NewEmploymentCreateBuilder() *EmploymentCreateBuilder { return builder } -// 待入职ID +// 待入职 ID // // 示例值：1 func (builder *EmploymentCreateBuilder) PrehireId(prehireId string) *EmploymentCreateBuilder { @@ -5054,7 +5054,7 @@ func (builder *EmploymentCreateBuilder) WorkingHoursTypeId(workingHoursTypeId st return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：6893014062142064135 func (builder *EmploymentCreateBuilder) Id(id string) *EmploymentCreateBuilder { @@ -5108,7 +5108,7 @@ func (builder *EmploymentCreateBuilder) EmploymentType(employmentType *Enum) *Em return builder } -// 人员信息，引用Person的ID +// 人员信息，引用 Person 的 ID // // 示例值：6919733936050406926 func (builder *EmploymentCreateBuilder) PersonId(personId string) *EmploymentCreateBuilder { @@ -5198,7 +5198,7 @@ func (builder *EmploymentCreateBuilder) ReasonForOffboarding(reasonForOffboardin return builder } -// 成本中心id列表 +// 成本中心 id 列表 // // 示例值： func (builder *EmploymentCreateBuilder) CostCenterList(costCenterList []*JobDataCostCenter) *EmploymentCreateBuilder { @@ -5353,14 +5353,14 @@ func (builder *EmploymentCreateBuilder) Build() *EmploymentCreate { } type EmploymentLeaveBalance struct { - EmploymentId *string `json:"employment_id,omitempty"` // 雇佣信息ID + EmploymentId *string `json:"employment_id,omitempty"` // 雇佣信息 ID EmploymentName []*I18n `json:"employment_name,omitempty"` // 员工姓名 AsOfDate *string `json:"as_of_date,omitempty"` // 截止日期，即查询截止到某天余额数据的日期 LeaveBalanceList []*LeaveBalance `json:"leave_balance_list,omitempty"` // 假期余额列表 } type EmploymentLeaveBalanceBuilder struct { - employmentId string // 雇佣信息ID + employmentId string // 雇佣信息 ID employmentIdFlag bool employmentName []*I18n // 员工姓名 employmentNameFlag bool @@ -5375,7 +5375,7 @@ func NewEmploymentLeaveBalanceBuilder() *EmploymentLeaveBalanceBuilder { return builder } -// 雇佣信息ID +// 雇佣信息 ID // // 示例值：4718803945687580505 func (builder *EmploymentLeaveBalanceBuilder) EmploymentId(employmentId string) *EmploymentLeaveBalanceBuilder { @@ -5525,11 +5525,11 @@ func (builder *EnumFieldSettingBuilder) Build() *EnumFieldSetting { } type File struct { - Id *string `json:"id,omitempty"` // 上传文件ID + Id *string `json:"id,omitempty"` // 上传文件 ID } type FileBuilder struct { - id string // 上传文件ID + id string // 上传文件 ID idFlag bool } @@ -5538,7 +5538,7 @@ func NewFileBuilder() *FileBuilder { return builder } -// 上传文件ID +// 上传文件 ID // // 示例值：150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200 func (builder *FileBuilder) Id(id string) *FileBuilder { @@ -5605,15 +5605,15 @@ func (builder *FilterRuleValueBuilder) Build() *FilterRuleValue { } type FormFieldVariable struct { - VariableApiName *string `json:"variable_api_name,omitempty"` // 变量api名称 - VariableName *BpmDataengineI18n `json:"variable_name,omitempty"` // 变量名称的i18n描述 + VariableApiName *string `json:"variable_api_name,omitempty"` // 变量 api 名称 + VariableName *BpmDataengineI18n `json:"variable_name,omitempty"` // 变量名称的 i18n 描述 VariableValue *FormVariableValueInfo `json:"variable_value,omitempty"` // 变量值的对象 } type FormFieldVariableBuilder struct { - variableApiName string // 变量api名称 + variableApiName string // 变量 api 名称 variableApiNameFlag bool - variableName *BpmDataengineI18n // 变量名称的i18n描述 + variableName *BpmDataengineI18n // 变量名称的 i18n 描述 variableNameFlag bool variableValue *FormVariableValueInfo // 变量值的对象 variableValueFlag bool @@ -5624,7 +5624,7 @@ func NewFormFieldVariableBuilder() *FormFieldVariableBuilder { return builder } -// 变量api名称 +// 变量 api 名称 // // 示例值： func (builder *FormFieldVariableBuilder) VariableApiName(variableApiName string) *FormFieldVariableBuilder { @@ -5633,7 +5633,7 @@ func (builder *FormFieldVariableBuilder) VariableApiName(variableApiName string) return builder } -// 变量名称的i18n描述 +// 变量名称的 i18n 描述 // // 示例值： func (builder *FormFieldVariableBuilder) VariableName(variableName *BpmDataengineI18n) *FormFieldVariableBuilder { @@ -5699,11 +5699,11 @@ func (builder *FormFieldVariableBoolValueBuilder) Build() *FormFieldVariableBool } type FormFieldVariableDateValue struct { - Value *int `json:"value,omitempty"` // 日期变量的值，从1970起的天数 + Value *int `json:"value,omitempty"` // 日期变量的值，从 1970 起的天数 } type FormFieldVariableDateValueBuilder struct { - value int // 日期变量的值，从1970起的天数 + value int // 日期变量的值，从 1970 起的天数 valueFlag bool } @@ -5712,7 +5712,7 @@ func NewFormFieldVariableDateValueBuilder() *FormFieldVariableDateValueBuilder { return builder } -// 日期变量的值，从1970起的天数 +// 日期变量的值，从 1970 起的天数 // // 示例值：10000 func (builder *FormFieldVariableDateValueBuilder) Value(value int) *FormFieldVariableDateValueBuilder { @@ -5779,11 +5779,11 @@ func (builder *FormFieldVariableDatetimeValueBuilder) Build() *FormFieldVariable } type FormFieldVariableDepartmentValue struct { - Value *string `json:"value,omitempty"` // 部门ID + Value *string `json:"value,omitempty"` // 部门 ID } type FormFieldVariableDepartmentValueBuilder struct { - value string // 部门ID + value string // 部门 ID valueFlag bool } @@ -5792,7 +5792,7 @@ func NewFormFieldVariableDepartmentValueBuilder() *FormFieldVariableDepartmentVa return builder } -// 部门ID +// 部门 ID // // 示例值：201933311 func (builder *FormFieldVariableDepartmentValueBuilder) Value(value string) *FormFieldVariableDepartmentValueBuilder { @@ -5812,13 +5812,13 @@ func (builder *FormFieldVariableDepartmentValueBuilder) Build() *FormFieldVariab type FormFieldVariableEmploymentValue struct { Value *string `json:"value,omitempty"` // employmentID - UserId *string `json:"user_id,omitempty"` // 员工ID 如3158117 + UserId *string `json:"user_id,omitempty"` // 员工 ID 如 3158117 } type FormFieldVariableEmploymentValueBuilder struct { value string // employmentID valueFlag bool - userId string // 员工ID 如3158117 + userId string // 员工 ID 如 3158117 userIdFlag bool } @@ -5836,7 +5836,7 @@ func (builder *FormFieldVariableEmploymentValueBuilder) Value(value string) *For return builder } -// 员工ID 如3158117 +// 员工 ID 如 3158117 // // 示例值： func (builder *FormFieldVariableEmploymentValueBuilder) UserId(userId string) *FormFieldVariableEmploymentValueBuilder { @@ -5921,17 +5921,17 @@ func (builder *FormFieldVariableEnumValueBuilder) Build() *FormFieldVariableEnum } type FormFieldVariableFileValue struct { - SourceType *int `json:"source_type,omitempty"` // 文件源类型（1BPM; 2主数据） - FileId *string `json:"file_id,omitempty"` // 文件id + SourceType *int `json:"source_type,omitempty"` // 文件源类型（1BPM; 2 主数据） + FileId *string `json:"file_id,omitempty"` // 文件 id FileName *string `json:"file_name,omitempty"` // 文件名称 Length *int `json:"length,omitempty"` // 文件长度 MimeType *string `json:"mime_type,omitempty"` // mime type } type FormFieldVariableFileValueBuilder struct { - sourceType int // 文件源类型（1BPM; 2主数据） + sourceType int // 文件源类型（1BPM; 2 主数据） sourceTypeFlag bool - fileId string // 文件id + fileId string // 文件 id fileIdFlag bool fileName string // 文件名称 fileNameFlag bool @@ -5946,7 +5946,7 @@ func NewFormFieldVariableFileValueBuilder() *FormFieldVariableFileValueBuilder { return builder } -// 文件源类型（1BPM; 2主数据） +// 文件源类型（1BPM; 2 主数据） // // 示例值：1 func (builder *FormFieldVariableFileValueBuilder) SourceType(sourceType int) *FormFieldVariableFileValueBuilder { @@ -5955,7 +5955,7 @@ func (builder *FormFieldVariableFileValueBuilder) SourceType(sourceType int) *Fo return builder } -// 文件id +// 文件 id // // 示例值：abc_file_xyz func (builder *FormFieldVariableFileValueBuilder) FileId(fileId string) *FormFieldVariableFileValueBuilder { @@ -6017,11 +6017,11 @@ func (builder *FormFieldVariableFileValueBuilder) Build() *FormFieldVariableFile } type FormFieldVariableI18nValue struct { - Value *BpmDataengineI18n `json:"value,omitempty"` // i18n值 + Value *BpmDataengineI18n `json:"value,omitempty"` // i18n 值 } type FormFieldVariableI18nValueBuilder struct { - value *BpmDataengineI18n // i18n值 + value *BpmDataengineI18n // i18n 值 valueFlag bool } @@ -6030,7 +6030,7 @@ func NewFormFieldVariableI18nValueBuilder() *FormFieldVariableI18nValueBuilder { return builder } -// i18n值 +// i18n 值 // // 示例值： func (builder *FormFieldVariableI18nValueBuilder) Value(value *BpmDataengineI18n) *FormFieldVariableI18nValueBuilder { @@ -6058,7 +6058,7 @@ type FormFieldVariableListObject struct { BoolValue *FormFieldVariableBoolValue `json:"bool_value,omitempty"` // 布尔变量对象 DepartmentValue *FormFieldVariableDepartmentValue `json:"department_value,omitempty"` // 部门变量对象 FileValue *FormFieldVariableFileValue `json:"file_value,omitempty"` // 文件变量对象 - I18nValue *FormFieldVariableI18nValue `json:"i18n_value,omitempty"` // i18n变量对象 + I18nValue *FormFieldVariableI18nValue `json:"i18n_value,omitempty"` // i18n 变量对象 ObjectValue *FormFieldVariableObjectValue `json:"object_value,omitempty"` // 对象变量 } @@ -6083,7 +6083,7 @@ type FormFieldVariableListObjectBuilder struct { departmentValueFlag bool fileValue *FormFieldVariableFileValue // 文件变量对象 fileValueFlag bool - i18nValue *FormFieldVariableI18nValue // i18n变量对象 + i18nValue *FormFieldVariableI18nValue // i18n 变量对象 i18nValueFlag bool objectValue *FormFieldVariableObjectValue // 对象变量 objectValueFlag bool @@ -6184,7 +6184,7 @@ func (builder *FormFieldVariableListObjectBuilder) FileValue(fileValue *FormFiel return builder } -// i18n变量对象 +// i18n 变量对象 // // 示例值： func (builder *FormFieldVariableListObjectBuilder) I18nValue(i18nValue *FormFieldVariableI18nValue) *FormFieldVariableListObjectBuilder { @@ -6310,14 +6310,14 @@ func (builder *FormFieldVariableNumberValueBuilder) Build() *FormFieldVariableNu } type FormFieldVariableObjectValue struct { - Value *string `json:"value,omitempty"` // 对象ID - WkApiName *string `json:"wk_api_name,omitempty"` // 主数据apiName + Value *string `json:"value,omitempty"` // 对象 ID + WkApiName *string `json:"wk_api_name,omitempty"` // 主数据 apiName } type FormFieldVariableObjectValueBuilder struct { - value string // 对象ID + value string // 对象 ID valueFlag bool - wkApiName string // 主数据apiName + wkApiName string // 主数据 apiName wkApiNameFlag bool } @@ -6326,7 +6326,7 @@ func NewFormFieldVariableObjectValueBuilder() *FormFieldVariableObjectValueBuild return builder } -// 对象ID +// 对象 ID // // 示例值：203948191 func (builder *FormFieldVariableObjectValueBuilder) Value(value string) *FormFieldVariableObjectValueBuilder { @@ -6335,7 +6335,7 @@ func (builder *FormFieldVariableObjectValueBuilder) Value(value string) *FormFie return builder } -// 主数据apiName +// 主数据 apiName // // 示例值：object1 func (builder *FormFieldVariableObjectValueBuilder) WkApiName(wkApiName string) *FormFieldVariableObjectValueBuilder { @@ -6431,7 +6431,7 @@ type FormVariableValueInfo struct { BoolValue *FormFieldVariableBoolValue `json:"bool_value,omitempty"` // 布尔变量对象 DepartmentValue *FormFieldVariableDepartmentValue `json:"department_value,omitempty"` // 部门变量对象 FileValue *FormFieldVariableFileValue `json:"file_value,omitempty"` // 文件变量对象 - I18nValue *FormFieldVariableI18nValue `json:"i18n_value,omitempty"` // i18n变量对象 + I18nValue *FormFieldVariableI18nValue `json:"i18n_value,omitempty"` // i18n 变量对象 ObjectValue *FormFieldVariableObjectValue `json:"object_value,omitempty"` // 对象变量 ListValue *FormFieldVariableListValue `json:"list_value,omitempty"` // 列表对象 } @@ -6457,7 +6457,7 @@ type FormVariableValueInfoBuilder struct { departmentValueFlag bool fileValue *FormFieldVariableFileValue // 文件变量对象 fileValueFlag bool - i18nValue *FormFieldVariableI18nValue // i18n变量对象 + i18nValue *FormFieldVariableI18nValue // i18n 变量对象 i18nValueFlag bool objectValue *FormFieldVariableObjectValue // 对象变量 objectValueFlag bool @@ -6560,7 +6560,7 @@ func (builder *FormVariableValueInfoBuilder) FileValue(fileValue *FormFieldVaria return builder } -// i18n变量对象 +// i18n 变量对象 // // 示例值： func (builder *FormVariableValueInfoBuilder) I18nValue(i18nValue *FormFieldVariableI18nValue) *FormVariableValueInfoBuilder { @@ -6634,7 +6634,7 @@ func (builder *FormVariableValueInfoBuilder) Build() *FormVariableValueInfo { type HiberarchyCommon struct { ParentId *string `json:"parent_id,omitempty"` // 上级组织 ID Name []*I18n `json:"name,omitempty"` // 名称 - Type *Enum `json:"type,omitempty"` // 组织类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)组织类型（organization_type）枚举定义部分获得 + Type *Enum `json:"type,omitempty"` // 组织类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 组织类型（organization_type）枚举定义部分获得 Active *bool `json:"active,omitempty"` // 是否启用 EffectiveTime *string `json:"effective_time,omitempty"` // 生效时间 ExpirationTime *string `json:"expiration_time,omitempty"` // 失效时间 @@ -6650,7 +6650,7 @@ type HiberarchyCommonBuilder struct { parentIdFlag bool name []*I18n // 名称 nameFlag bool - type_ *Enum // 组织类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)组织类型（organization_type）枚举定义部分获得 + type_ *Enum // 组织类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 组织类型（organization_type）枚举定义部分获得 typeFlag bool active bool // 是否启用 activeFlag bool @@ -6693,7 +6693,7 @@ func (builder *HiberarchyCommonBuilder) Name(name []*I18n) *HiberarchyCommonBuil return builder } -// 组织类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)组织类型（organization_type）枚举定义部分获得 +// 组织类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 组织类型（organization_type）枚举定义部分获得 // // 示例值： func (builder *HiberarchyCommonBuilder) Type(type_ *Enum) *HiberarchyCommonBuilder { @@ -6820,13 +6820,13 @@ func (builder *HiberarchyCommonBuilder) Build() *HiberarchyCommon { } type Hrbp struct { - EmploymentIdList []string `json:"employment_id_list,omitempty"` // HRBP/属地 BP 的雇员ID ：;;对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP；;;对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP + EmploymentIdList []string `json:"employment_id_list,omitempty"` // HRBP/属地 BP 的雇员 ID ：;;对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP；;;对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP DepartmentId *string `json:"department_id,omitempty"` // 部门 ID WorkLocationId *string `json:"work_location_id,omitempty"` // 工作地点 ID } type HrbpBuilder struct { - employmentIdList []string // HRBP/属地 BP 的雇员ID ：;;对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP；;;对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP + employmentIdList []string // HRBP/属地 BP 的雇员 ID ：;;对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP；;;对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP employmentIdListFlag bool departmentId string // 部门 ID departmentIdFlag bool @@ -6839,7 +6839,7 @@ func NewHrbpBuilder() *HrbpBuilder { return builder } -// HRBP/属地 BP 的雇员ID ：;;对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP；;;对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP +// HRBP/属地 BP 的雇员 ID ：;;对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP；;;对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP // // 示例值： func (builder *HrbpBuilder) EmploymentIdList(employmentIdList []string) *HrbpBuilder { @@ -7403,13 +7403,13 @@ type JobData struct { EffectiveTime *string `json:"effective_time,omitempty"` // 生效时间 ExpirationTime *string `json:"expiration_time,omitempty"` // 失效时间 JobFamilyId *string `json:"job_family_id,omitempty"` // 职务序列 ID，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 - AssignmentStartReason *Enum `json:"assignment_start_reason,omitempty"` // 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)任职原因（assignment_start_reason）枚举定义部分获得 + AssignmentStartReason *Enum `json:"assignment_start_reason,omitempty"` // 任职原因，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得 ProbationExpectedEndDate *string `json:"probation_expected_end_date,omitempty"` // 预计试用期结束日期 - ProbationOutcome *Enum `json:"probation_outcome,omitempty"` // 试用期结果，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)试用期结果（probation_outcome）枚举定义部分获得 + ProbationOutcome *Enum `json:"probation_outcome,omitempty"` // 试用期结果，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 试用期结果（probation_outcome）枚举定义部分获得 WeeklyWorkingHours *int `json:"weekly_working_hours,omitempty"` // 周工作时长 - DirectManagerId *string `json:"direct_manager_id,omitempty"` // 实线主管的任职记录ID - DottedLineManagerIdList []string `json:"dotted_line_manager_id_list,omitempty"` // 虚线主管的任职记录ID - SecondDirectManagerId *string `json:"second_direct_manager_id,omitempty"` // 第二实线主管的任职记录ID + DirectManagerId *string `json:"direct_manager_id,omitempty"` // 实线主管的任职记录 ID + DottedLineManagerIdList []string `json:"dotted_line_manager_id_list,omitempty"` // 虚线主管的任职记录 ID + SecondDirectManagerId *string `json:"second_direct_manager_id,omitempty"` // 第二实线主管的任职记录 ID CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 } @@ -7444,19 +7444,19 @@ type JobDataBuilder struct { expirationTimeFlag bool jobFamilyId string // 职务序列 ID，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 jobFamilyIdFlag bool - assignmentStartReason *Enum // 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)任职原因（assignment_start_reason）枚举定义部分获得 + assignmentStartReason *Enum // 任职原因，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得 assignmentStartReasonFlag bool probationExpectedEndDate string // 预计试用期结束日期 probationExpectedEndDateFlag bool - probationOutcome *Enum // 试用期结果，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)试用期结果（probation_outcome）枚举定义部分获得 + probationOutcome *Enum // 试用期结果，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 试用期结果（probation_outcome）枚举定义部分获得 probationOutcomeFlag bool weeklyWorkingHours int // 周工作时长 weeklyWorkingHoursFlag bool - directManagerId string // 实线主管的任职记录ID + directManagerId string // 实线主管的任职记录 ID directManagerIdFlag bool - dottedLineManagerIdList []string // 虚线主管的任职记录ID + dottedLineManagerIdList []string // 虚线主管的任职记录 ID dottedLineManagerIdListFlag bool - secondDirectManagerId string // 第二实线主管的任职记录ID + secondDirectManagerId string // 第二实线主管的任职记录 ID secondDirectManagerIdFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool @@ -7602,7 +7602,7 @@ func (builder *JobDataBuilder) JobFamilyId(jobFamilyId string) *JobDataBuilder { return builder } -// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)任职原因（assignment_start_reason）枚举定义部分获得 +// 任职原因，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得 // // 示例值：onboarding func (builder *JobDataBuilder) AssignmentStartReason(assignmentStartReason *Enum) *JobDataBuilder { @@ -7620,7 +7620,7 @@ func (builder *JobDataBuilder) ProbationExpectedEndDate(probationExpectedEndDate return builder } -// 试用期结果，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)试用期结果（probation_outcome）枚举定义部分获得 +// 试用期结果，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 试用期结果（probation_outcome）枚举定义部分获得 // // 示例值：passed func (builder *JobDataBuilder) ProbationOutcome(probationOutcome *Enum) *JobDataBuilder { @@ -7638,7 +7638,7 @@ func (builder *JobDataBuilder) WeeklyWorkingHours(weeklyWorkingHours int) *JobDa return builder } -// 实线主管的任职记录ID +// 实线主管的任职记录 ID // // 示例值：6890452208593372679 func (builder *JobDataBuilder) DirectManagerId(directManagerId string) *JobDataBuilder { @@ -7647,7 +7647,7 @@ func (builder *JobDataBuilder) DirectManagerId(directManagerId string) *JobDataB return builder } -// 虚线主管的任职记录ID +// 虚线主管的任职记录 ID // // 示例值：["6971723901730686501"] func (builder *JobDataBuilder) DottedLineManagerIdList(dottedLineManagerIdList []string) *JobDataBuilder { @@ -7656,7 +7656,7 @@ func (builder *JobDataBuilder) DottedLineManagerIdList(dottedLineManagerIdList [ return builder } -// 第二实线主管的任职记录ID +// 第二实线主管的任职记录 ID // // 示例值：6890452208593372679 func (builder *JobDataBuilder) SecondDirectManagerId(secondDirectManagerId string) *JobDataBuilder { @@ -7768,13 +7768,13 @@ func (builder *JobDataBuilder) Build() *JobData { } type JobDataCostCenter struct { - CostCenterId *string `json:"cost_center_id,omitempty"` // 成本中心id，可以通过【查询单个成本中心信息】接口获取对应的成本中心信息 + CostCenterId *string `json:"cost_center_id,omitempty"` // 成本中心 id，可以通过【查询单个成本中心信息】接口获取对应的成本中心信息 Rate *int `json:"rate,omitempty"` // 分摊比例 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 } type JobDataCostCenterBuilder struct { - costCenterId string // 成本中心id，可以通过【查询单个成本中心信息】接口获取对应的成本中心信息 + costCenterId string // 成本中心 id，可以通过【查询单个成本中心信息】接口获取对应的成本中心信息 costCenterIdFlag bool rate int // 分摊比例 rateFlag bool @@ -7787,7 +7787,7 @@ func NewJobDataCostCenterBuilder() *JobDataCostCenterBuilder { return builder } -// 成本中心id，可以通过【查询单个成本中心信息】接口获取对应的成本中心信息 +// 成本中心 id，可以通过【查询单个成本中心信息】接口获取对应的成本中心信息 // // 示例值：6950635856373745165 func (builder *JobDataCostCenterBuilder) CostCenterId(costCenterId string) *JobDataCostCenterBuilder { @@ -8098,7 +8098,7 @@ func (builder *JobLevelBuilder) Build() *JobLevel { } type LeaveBalance struct { - LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期类型ID + LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期类型 ID LeaveTypeName []*I18n `json:"leave_type_name,omitempty"` // 假期类型名称 HistoricalCyclesLeft *string `json:"historical_cycles_left,omitempty"` // 结转的历史周期授予时长 ThisCycleTotal *string `json:"this_cycle_total,omitempty"` // 本周期授予时长 @@ -8108,7 +8108,7 @@ type LeaveBalance struct { } type LeaveBalanceBuilder struct { - leaveTypeId string // 假期类型ID + leaveTypeId string // 假期类型 ID leaveTypeIdFlag bool leaveTypeName []*I18n // 假期类型名称 leaveTypeNameFlag bool @@ -8129,7 +8129,7 @@ func NewLeaveBalanceBuilder() *LeaveBalanceBuilder { return builder } -// 假期类型ID +// 假期类型 ID // // 示例值：4718803945687580505 func (builder *LeaveBalanceBuilder) LeaveTypeId(leaveTypeId string) *LeaveBalanceBuilder { @@ -8448,10 +8448,10 @@ func (builder *LeaveGrantingRecordBuilder) Build() *LeaveGrantingRecord { } type LeaveRequest struct { - LeaveRequestId *string `json:"leave_request_id,omitempty"` // 请假记录ID - EmploymentId *string `json:"employment_id,omitempty"` // 雇佣信息ID + LeaveRequestId *string `json:"leave_request_id,omitempty"` // 请假记录 ID + EmploymentId *string `json:"employment_id,omitempty"` // 雇佣信息 ID EmploymentName []*I18n `json:"employment_name,omitempty"` // 员工姓名 - LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期类型ID + LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期类型 ID LeaveTypeName []*I18n `json:"leave_type_name,omitempty"` // 假期类型名称 StartTime *string `json:"start_time,omitempty"` // 假期开始时间，格式可能为：;; - 字符串日期：如 "2022-09-09";; - 字符串日期加 morning/afternoon：如 "2022-09-09 morning"" EndTime *string `json:"end_time,omitempty"` // 假期结束时间，格式可能为：;; - 字符串日期：如 "2022-09-09";; - 字符串日期加 morning/afternoon：如 "2022-09-09 morning"" @@ -8466,13 +8466,13 @@ type LeaveRequest struct { } type LeaveRequestBuilder struct { - leaveRequestId string // 请假记录ID + leaveRequestId string // 请假记录 ID leaveRequestIdFlag bool - employmentId string // 雇佣信息ID + employmentId string // 雇佣信息 ID employmentIdFlag bool employmentName []*I18n // 员工姓名 employmentNameFlag bool - leaveTypeId string // 假期类型ID + leaveTypeId string // 假期类型 ID leaveTypeIdFlag bool leaveTypeName []*I18n // 假期类型名称 leaveTypeNameFlag bool @@ -8503,7 +8503,7 @@ func NewLeaveRequestBuilder() *LeaveRequestBuilder { return builder } -// 请假记录ID +// 请假记录 ID // // 示例值：4718803945687580505 func (builder *LeaveRequestBuilder) LeaveRequestId(leaveRequestId string) *LeaveRequestBuilder { @@ -8512,7 +8512,7 @@ func (builder *LeaveRequestBuilder) LeaveRequestId(leaveRequestId string) *Leave return builder } -// 雇佣信息ID +// 雇佣信息 ID // // 示例值：4718803945687580505 func (builder *LeaveRequestBuilder) EmploymentId(employmentId string) *LeaveRequestBuilder { @@ -8530,7 +8530,7 @@ func (builder *LeaveRequestBuilder) EmploymentName(employmentName []*I18n) *Leav return builder } -// 假期类型ID +// 假期类型 ID // // 示例值：0 func (builder *LeaveRequestBuilder) LeaveTypeId(leaveTypeId string) *LeaveRequestBuilder { @@ -8702,12 +8702,12 @@ func (builder *LeaveRequestBuilder) Build() *LeaveRequest { } type LeaveSubtype struct { - LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期子类ID + LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期子类 ID LeaveTypeName []*I18n `json:"leave_type_name,omitempty"` // 假期子类名称 } type LeaveSubtypeBuilder struct { - leaveTypeId string // 假期子类ID + leaveTypeId string // 假期子类 ID leaveTypeIdFlag bool leaveTypeName []*I18n // 假期子类名称 leaveTypeNameFlag bool @@ -8718,7 +8718,7 @@ func NewLeaveSubtypeBuilder() *LeaveSubtypeBuilder { return builder } -// 假期子类ID +// 假期子类 ID // // 示例值：4718803945687580505 func (builder *LeaveSubtypeBuilder) LeaveTypeId(leaveTypeId string) *LeaveSubtypeBuilder { @@ -8749,7 +8749,7 @@ func (builder *LeaveSubtypeBuilder) Build() *LeaveSubtype { } type LeaveType struct { - LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期类型ID + LeaveTypeId *string `json:"leave_type_id,omitempty"` // 假期类型 ID LeaveTypeName []*I18n `json:"leave_type_name,omitempty"` // 假期类型名称 Status *int `json:"status,omitempty"` // 假期类型状态;;可选值有：;;- 1：已启用;;- 2：已停用 LeaveSubtypeList []*LeaveSubtype `json:"leave_subtype_list,omitempty"` // 假期子类列表 @@ -8760,7 +8760,7 @@ type LeaveType struct { } type LeaveTypeBuilder struct { - leaveTypeId string // 假期类型ID + leaveTypeId string // 假期类型 ID leaveTypeIdFlag bool leaveTypeName []*I18n // 假期类型名称 leaveTypeNameFlag bool @@ -8783,7 +8783,7 @@ func NewLeaveTypeBuilder() *LeaveTypeBuilder { return builder } -// 假期类型ID +// 假期类型 ID // // 示例值：4718803945687580505 func (builder *LeaveTypeBuilder) LeaveTypeId(leaveTypeId string) *LeaveTypeBuilder { @@ -8893,13 +8893,13 @@ func (builder *LeaveTypeBuilder) Build() *LeaveType { type Location struct { Id *string `json:"id,omitempty"` // 地点 ID HiberarchyCommon *HiberarchyCommon `json:"hiberarchy_common,omitempty"` // 层级关系，内层字段见实体 - LocationUsageList []*Enum `json:"location_usage_list,omitempty"` // 地点用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地点用途（location_usage）枚举定义部分获得 + LocationUsageList []*Enum `json:"location_usage_list,omitempty"` // 地点用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 地点用途（location_usage）枚举定义部分获得 Address []*Address `json:"address,omitempty"` // 地址 WorkingHoursTypeId *string `json:"working_hours_type_id,omitempty"` // 工时制度 ID，枚举值可通过【批量查询工时制度】接口获取 EffectiveTime *string `json:"effective_time,omitempty"` // 生效时间 ExpirationTime *string `json:"expiration_time,omitempty"` // 失效时间 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 - Locale *Enum `json:"locale,omitempty"` // 区域设置，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)区域设置（locale）枚举定义部分获得 + Locale *Enum `json:"locale,omitempty"` // 区域设置，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 区域设置（locale）枚举定义部分获得 TimeZoneId *string `json:"time_zone_id,omitempty"` // 时区 DisplayLanguageId *string `json:"display_language_id,omitempty"` // 默认显示语言 } @@ -8909,7 +8909,7 @@ type LocationBuilder struct { idFlag bool hiberarchyCommon *HiberarchyCommon // 层级关系，内层字段见实体 hiberarchyCommonFlag bool - locationUsageList []*Enum // 地点用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地点用途（location_usage）枚举定义部分获得 + locationUsageList []*Enum // 地点用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 地点用途（location_usage）枚举定义部分获得 locationUsageListFlag bool address []*Address // 地址 addressFlag bool @@ -8921,7 +8921,7 @@ type LocationBuilder struct { expirationTimeFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool - locale *Enum // 区域设置，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)区域设置（locale）枚举定义部分获得 + locale *Enum // 区域设置，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 区域设置（locale）枚举定义部分获得 localeFlag bool timeZoneId string // 时区 timeZoneIdFlag bool @@ -8952,7 +8952,7 @@ func (builder *LocationBuilder) HiberarchyCommon(hiberarchyCommon *HiberarchyCom return builder } -// 地点用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地点用途（location_usage）枚举定义部分获得 +// 地点用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 地点用途（location_usage）枚举定义部分获得 // // 示例值： func (builder *LocationBuilder) LocationUsageList(locationUsageList []*Enum) *LocationBuilder { @@ -9006,7 +9006,7 @@ func (builder *LocationBuilder) CustomFields(customFields []*ObjectFieldData) *L return builder } -// 区域设置，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)区域设置（locale）枚举定义部分获得 +// 区域设置，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 区域设置（locale）枚举定义部分获得 // // 示例值：zh_cn func (builder *LocationBuilder) Locale(locale *Enum) *LocationBuilder { @@ -9616,19 +9616,19 @@ func (builder *NationalIdTypeBuilder) Build() *NationalIdType { type NumberFieldSetting struct { NumberFieldType *int `json:"number_field_type,omitempty"` // 数字类型，含以下枚举值：;1. Percent 百分比;2. Integer 整数;3. Value 数值（浮点数）;4. Money 金额（浮点数） - DecimalPlaces *int `json:"decimal_places,omitempty"` // 小数部分位数（浮点数整数部分和小数部分分别最大30位） + DecimalPlaces *int `json:"decimal_places,omitempty"` // 小数部分位数（浮点数整数部分和小数部分分别最大 30 位） RoundType *int `json:"round_type,omitempty"` // 四舍五入规则，含以下枚举值：;;0. Round 四舍五入;1. Ceil 向上舍入;2. Floor 向下舍入 - DecimalTotalPlaces *int `json:"decimal_total_places,omitempty"` // 整数+小数总位数 + DecimalTotalPlaces *int `json:"decimal_total_places,omitempty"` // 整数 + 小数总位数 } type NumberFieldSettingBuilder struct { numberFieldType int // 数字类型，含以下枚举值：;1. Percent 百分比;2. Integer 整数;3. Value 数值（浮点数）;4. Money 金额（浮点数） numberFieldTypeFlag bool - decimalPlaces int // 小数部分位数（浮点数整数部分和小数部分分别最大30位） + decimalPlaces int // 小数部分位数（浮点数整数部分和小数部分分别最大 30 位） decimalPlacesFlag bool roundType int // 四舍五入规则，含以下枚举值：;;0. Round 四舍五入;1. Ceil 向上舍入;2. Floor 向下舍入 roundTypeFlag bool - decimalTotalPlaces int // 整数+小数总位数 + decimalTotalPlaces int // 整数 + 小数总位数 decimalTotalPlacesFlag bool } @@ -9646,7 +9646,7 @@ func (builder *NumberFieldSettingBuilder) NumberFieldType(numberFieldType int) * return builder } -// 小数部分位数（浮点数整数部分和小数部分分别最大30位） +// 小数部分位数（浮点数整数部分和小数部分分别最大 30 位） // // 示例值：1 func (builder *NumberFieldSettingBuilder) DecimalPlaces(decimalPlaces int) *NumberFieldSettingBuilder { @@ -9664,7 +9664,7 @@ func (builder *NumberFieldSettingBuilder) RoundType(roundType int) *NumberFieldS return builder } -// 整数+小数总位数 +// 整数 + 小数总位数 // // 示例值：1 func (builder *NumberFieldSettingBuilder) DecimalTotalPlaces(decimalTotalPlaces int) *NumberFieldSettingBuilder { @@ -9791,14 +9791,14 @@ func (builder *ObjectBuilder) Build() *Object { type ObjectData struct { ObjectName *string `json:"object_name,omitempty"` // 自定义实体名称 - Id *string `json:"id,omitempty"` // 自定义实体ID + Id *string `json:"id,omitempty"` // 自定义实体 ID FieldList []*ObjectFieldData `json:"field_list,omitempty"` // 自定义实体字段 } type ObjectDataBuilder struct { objectName string // 自定义实体名称 objectNameFlag bool - id string // 自定义实体ID + id string // 自定义实体 ID idFlag bool fieldList []*ObjectFieldData // 自定义实体字段 fieldListFlag bool @@ -9818,7 +9818,7 @@ func (builder *ObjectDataBuilder) ObjectName(objectName string) *ObjectDataBuild return builder } -// 自定义实体ID +// 自定义实体 ID // // 示例值：6862995757234914824 func (builder *ObjectDataBuilder) Id(id string) *ObjectDataBuilder { @@ -9854,13 +9854,13 @@ func (builder *ObjectDataBuilder) Build() *ObjectData { type ObjectFieldData struct { FieldName *string `json:"field_name,omitempty"` // 字段名 - Value *string `json:"value,omitempty"` // 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + Value *string `json:"value,omitempty"` // 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同 (如 123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") } type ObjectFieldDataBuilder struct { fieldName string // 字段名 fieldNameFlag bool - value string // 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + value string // 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同 (如 123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") valueFlag bool } @@ -9878,7 +9878,7 @@ func (builder *ObjectFieldDataBuilder) FieldName(fieldName string) *ObjectFieldD return builder } -// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") +// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同 (如 123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") // // 示例值：\"Sandy\" func (builder *ObjectFieldDataBuilder) Value(value string) *ObjectFieldDataBuilder { @@ -10344,7 +10344,7 @@ func (builder *OffboardingInfoBuilder) Build() *OffboardingInfo { type OffboardingReason struct { OffboardingReasonUniqueIdentifier *string `json:"offboarding_reason_unique_identifier,omitempty"` // 离职原因唯一标识 Name []*I18n `json:"name,omitempty"` // 名称 - Active *bool `json:"active,omitempty"` // 是否启用，true为启用 + Active *bool `json:"active,omitempty"` // 是否启用，true 为启用 ParentOffboardingReasonUniqueIdentifier *string `json:"parent_offboarding_reason_unique_identifier,omitempty"` // 当前离职原因的父级原因唯一标识 CreatedTime *string `json:"created_time,omitempty"` // 创建时间 UpdatedTime *string `json:"updated_time,omitempty"` // 更新时间 @@ -10355,7 +10355,7 @@ type OffboardingReasonBuilder struct { offboardingReasonUniqueIdentifierFlag bool name []*I18n // 名称 nameFlag bool - active bool // 是否启用，true为启用 + active bool // 是否启用，true 为启用 activeFlag bool parentOffboardingReasonUniqueIdentifier string // 当前离职原因的父级原因唯一标识 parentOffboardingReasonUniqueIdentifierFlag bool @@ -10388,7 +10388,7 @@ func (builder *OffboardingReasonBuilder) Name(name []*I18n) *OffboardingReasonBu return builder } -// 是否启用，true为启用 +// 是否启用，true 为启用 // // 示例值：true func (builder *OffboardingReasonBuilder) Active(active bool) *OffboardingReasonBuilder { @@ -10454,17 +10454,17 @@ func (builder *OffboardingReasonBuilder) Build() *OffboardingReason { type PermissionDetail struct { Role *SecurityGroup `json:"role,omitempty"` // 角色 - AssignedOrganizationList [][]*AssignedOrganization `json:"assigned_organization_list,omitempty"` // 指定管理对象列表，如果该值为null，则使用设置数据权限 - GrantorRuleList []*PermissionSecurityGroup `json:"grantor_rule_list,omitempty"` // 设置数据权限，如果该值为null，则使用指定管理对象列表 + AssignedOrganizationList [][]*AssignedOrganization `json:"assigned_organization_list,omitempty"` // 指定管理对象列表，如果该值为 null，则使用设置数据权限 + GrantorRuleList []*PermissionSecurityGroup `json:"grantor_rule_list,omitempty"` // 设置数据权限，如果该值为 null，则使用指定管理对象列表 UpdateTime *string `json:"update_time,omitempty"` // 更新时间 } type PermissionDetailBuilder struct { role *SecurityGroup // 角色 roleFlag bool - assignedOrganizationList [][]*AssignedOrganization // 指定管理对象列表，如果该值为null，则使用设置数据权限 + assignedOrganizationList [][]*AssignedOrganization // 指定管理对象列表，如果该值为 null，则使用设置数据权限 assignedOrganizationListFlag bool - grantorRuleList []*PermissionSecurityGroup // 设置数据权限，如果该值为null，则使用指定管理对象列表 + grantorRuleList []*PermissionSecurityGroup // 设置数据权限，如果该值为 null，则使用指定管理对象列表 grantorRuleListFlag bool updateTime string // 更新时间 updateTimeFlag bool @@ -10484,7 +10484,7 @@ func (builder *PermissionDetailBuilder) Role(role *SecurityGroup) *PermissionDet return builder } -// 指定管理对象列表，如果该值为null，则使用设置数据权限 +// 指定管理对象列表，如果该值为 null，则使用设置数据权限 // // 示例值： func (builder *PermissionDetailBuilder) AssignedOrganizationList(assignedOrganizationList [][]*AssignedOrganization) *PermissionDetailBuilder { @@ -10493,7 +10493,7 @@ func (builder *PermissionDetailBuilder) AssignedOrganizationList(assignedOrganiz return builder } -// 设置数据权限，如果该值为null，则使用指定管理对象列表 +// 设置数据权限，如果该值为 null，则使用指定管理对象列表 // // 示例值： func (builder *PermissionDetailBuilder) GrantorRuleList(grantorRuleList []*PermissionSecurityGroup) *PermissionDetailBuilder { @@ -10582,11 +10582,11 @@ type Person struct { PreferredName *string `json:"preferred_name,omitempty"` // 常用名 Id *string `json:"id,omitempty"` // Person ID NameList []*PersonName `json:"name_list,omitempty"` // 姓名 - Gender *Enum `json:"gender,omitempty"` // 性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得 + Gender *Enum `json:"gender,omitempty"` // 性别，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 性别（gender）枚举定义部分获得 DateOfBirth *string `json:"date_of_birth,omitempty"` // 出生日期 - NationalityId *string `json:"nationality_id,omitempty"` // 国籍id - Race *Enum `json:"race,omitempty"` // 民族 / 种族，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)民族（race）枚举定义部分获得 - MaritalStatus *Enum `json:"marital_status,omitempty"` // 婚姻状况，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)婚姻状况（marital_status）枚举定义部分获得 + NationalityId *string `json:"nationality_id,omitempty"` // 国籍 id + Race *Enum `json:"race,omitempty"` // 民族 / 种族，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 民族（race）枚举定义部分获得 + MaritalStatus *Enum `json:"marital_status,omitempty"` // 婚姻状况，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 婚姻状况（marital_status）枚举定义部分获得 PhoneList []*Phone `json:"phone_list,omitempty"` // 电话列表，只有当满足下面所有条件时，电话在个人信息页才可见:;- 电话号码不为空;- is_primary = "true" ;- phone_usage = "home" AddressList []*Address `json:"address_list,omitempty"` // 地址列表 EmailList []*Email `json:"email_list,omitempty"` // 邮箱列表 @@ -10618,15 +10618,15 @@ type PersonBuilder struct { idFlag bool nameList []*PersonName // 姓名 nameListFlag bool - gender *Enum // 性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得 + gender *Enum // 性别，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 性别（gender）枚举定义部分获得 genderFlag bool dateOfBirth string // 出生日期 dateOfBirthFlag bool - nationalityId string // 国籍id + nationalityId string // 国籍 id nationalityIdFlag bool - race *Enum // 民族 / 种族，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)民族（race）枚举定义部分获得 + race *Enum // 民族 / 种族，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 民族（race）枚举定义部分获得 raceFlag bool - maritalStatus *Enum // 婚姻状况，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)婚姻状况（marital_status）枚举定义部分获得 + maritalStatus *Enum // 婚姻状况，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 婚姻状况（marital_status）枚举定义部分获得 maritalStatusFlag bool phoneList []*Phone // 电话列表，只有当满足下面所有条件时，电话在个人信息页才可见:;- 电话号码不为空;- is_primary = "true" ;- phone_usage = "home" phoneListFlag bool @@ -10716,7 +10716,7 @@ func (builder *PersonBuilder) NameList(nameList []*PersonName) *PersonBuilder { return builder } -// 性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得 +// 性别，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 性别（gender）枚举定义部分获得 // // 示例值： func (builder *PersonBuilder) Gender(gender *Enum) *PersonBuilder { @@ -10734,7 +10734,7 @@ func (builder *PersonBuilder) DateOfBirth(dateOfBirth string) *PersonBuilder { return builder } -// 国籍id +// 国籍 id // // 示例值：123456789 func (builder *PersonBuilder) NationalityId(nationalityId string) *PersonBuilder { @@ -10743,7 +10743,7 @@ func (builder *PersonBuilder) NationalityId(nationalityId string) *PersonBuilder return builder } -// 民族 / 种族，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)民族（race）枚举定义部分获得 +// 民族 / 种族，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 民族（race）枚举定义部分获得 // // 示例值： func (builder *PersonBuilder) Race(race *Enum) *PersonBuilder { @@ -10752,7 +10752,7 @@ func (builder *PersonBuilder) Race(race *Enum) *PersonBuilder { return builder } -// 婚姻状况，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)婚姻状况（marital_status）枚举定义部分获得 +// 婚姻状况，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 婚姻状况（marital_status）枚举定义部分获得 // // 示例值： func (builder *PersonBuilder) MaritalStatus(maritalStatus *Enum) *PersonBuilder { @@ -11025,8 +11025,8 @@ func (builder *PersonBuilder) Build() *Person { type PersonInfoChn struct { Id *string `json:"id,omitempty"` // 个人附加信息 ID NativeRegion *string `json:"native_region,omitempty"` // 籍贯 ID;- 枚举值可通过「查询单条省份/行政区信息」接口获取 - PoliticalAffiliationList []*Enum `json:"political_affiliation_list,omitempty"` // 政治面貌，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)政治面貌（political_affiliation）枚举定义部分获得 - HukouType *Enum `json:"hukou_type,omitempty"` // 户口类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)户口类型（hukou_type）枚举定义部分获得 + PoliticalAffiliationList []*Enum `json:"political_affiliation_list,omitempty"` // 政治面貌，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 政治面貌（political_affiliation）枚举定义部分获得 + HukouType *Enum `json:"hukou_type,omitempty"` // 户口类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 户口类型（hukou_type）枚举定义部分获得 HukouLocation *string `json:"hukou_location,omitempty"` // 户口所在地 PersonId *string `json:"person_id,omitempty"` // Person ID CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 @@ -11038,9 +11038,9 @@ type PersonInfoChnBuilder struct { idFlag bool nativeRegion string // 籍贯 ID;- 枚举值可通过「查询单条省份/行政区信息」接口获取 nativeRegionFlag bool - politicalAffiliationList []*Enum // 政治面貌，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)政治面貌（political_affiliation）枚举定义部分获得 + politicalAffiliationList []*Enum // 政治面貌，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 政治面貌（political_affiliation）枚举定义部分获得 politicalAffiliationListFlag bool - hukouType *Enum // 户口类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)户口类型（hukou_type）枚举定义部分获得 + hukouType *Enum // 户口类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 户口类型（hukou_type）枚举定义部分获得 hukouTypeFlag bool hukouLocation string // 户口所在地 hukouLocationFlag bool @@ -11075,7 +11075,7 @@ func (builder *PersonInfoChnBuilder) NativeRegion(nativeRegion string) *PersonIn return builder } -// 政治面貌，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)政治面貌（political_affiliation）枚举定义部分获得 +// 政治面貌，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 政治面貌（political_affiliation）枚举定义部分获得 // // 示例值： func (builder *PersonInfoChnBuilder) PoliticalAffiliationList(politicalAffiliationList []*Enum) *PersonInfoChnBuilder { @@ -11084,7 +11084,7 @@ func (builder *PersonInfoChnBuilder) PoliticalAffiliationList(politicalAffiliati return builder } -// 户口类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)户口类型（hukou_type）枚举定义部分获得 +// 户口类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 户口类型（hukou_type）枚举定义部分获得 // // 示例值： func (builder *PersonInfoChnBuilder) HukouType(hukouType *Enum) *PersonInfoChnBuilder { @@ -11164,8 +11164,8 @@ func (builder *PersonInfoChnBuilder) Build() *PersonInfoChn { } type PersonInfoMys struct { - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 - PersonId *string `json:"person_id,omitempty"` // 关联人员ID + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 + PersonId *string `json:"person_id,omitempty"` // 关联人员 ID PreviousIncomeInTheCurrentYear *bool `json:"previous_income_in_the_current_year,omitempty"` // 是否本年度在前雇主已有工作收入 FreshGraduate *bool `json:"fresh_graduate,omitempty"` // 是否应届毕业生 PreviousEmployersList []*PreviousEmployer `json:"previous_employers_list,omitempty"` // 雇主信息列表 @@ -11182,9 +11182,9 @@ type PersonInfoMys struct { } type PersonInfoMysBuilder struct { - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool - personId string // 关联人员ID + personId string // 关联人员 ID personIdFlag bool previousIncomeInTheCurrentYear bool // 是否本年度在前雇主已有工作收入 previousIncomeInTheCurrentYearFlag bool @@ -11219,7 +11219,7 @@ func NewPersonInfoMysBuilder() *PersonInfoMysBuilder { return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：6950635856373745165 func (builder *PersonInfoMysBuilder) Id(id string) *PersonInfoMysBuilder { @@ -11228,7 +11228,7 @@ func (builder *PersonInfoMysBuilder) Id(id string) *PersonInfoMysBuilder { return builder } -// 关联人员ID +// 关联人员 ID // // 示例值：6919733647952053768 func (builder *PersonInfoMysBuilder) PersonId(personId string) *PersonInfoMysBuilder { @@ -11421,10 +11421,10 @@ type PersonName struct { LocalPrimary *string `json:"local_primary,omitempty"` // 姓 - 本地文字 LocalFirstName *string `json:"local_first_name,omitempty"` // 名 - 本地文字 CountryRegionId *string `json:"country_region_id,omitempty"` // 国家 / 地区 - NameType *Enum `json:"name_type,omitempty"` // 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（name_type）枚举定义部分获得 + NameType *Enum `json:"name_type,omitempty"` // 姓名类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 姓名类型（name_type）枚举定义部分获得 LocalFirstName2 *string `json:"local_first_name_2,omitempty"` // 名 - 第二本地文字 LocalPrimary2 *string `json:"local_primary_2,omitempty"` // 姓 - 第二本地文字 - AdditionalNameType *Enum `json:"additional_name_type,omitempty"` // 补充姓名类型，比如emergency_contact_name（紧急联系人姓名） + AdditionalNameType *Enum `json:"additional_name_type,omitempty"` // 补充姓名类型，比如 emergency_contact_name（紧急联系人姓名） FirstName *string `json:"first_name,omitempty"` // 名 FullName *string `json:"full_name,omitempty"` // 全名 Hereditary *string `json:"hereditary,omitempty"` // 姓氏称谓 @@ -11451,13 +11451,13 @@ type PersonNameBuilder struct { localFirstNameFlag bool countryRegionId string // 国家 / 地区 countryRegionIdFlag bool - nameType *Enum // 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（name_type）枚举定义部分获得 + nameType *Enum // 姓名类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 姓名类型（name_type）枚举定义部分获得 nameTypeFlag bool localFirstName2 string // 名 - 第二本地文字 localFirstName2Flag bool localPrimary2 string // 姓 - 第二本地文字 localPrimary2Flag bool - additionalNameType *Enum // 补充姓名类型，比如emergency_contact_name（紧急联系人姓名） + additionalNameType *Enum // 补充姓名类型，比如 emergency_contact_name（紧急联系人姓名） additionalNameTypeFlag bool firstName string // 名 firstNameFlag bool @@ -11527,7 +11527,7 @@ func (builder *PersonNameBuilder) CountryRegionId(countryRegionId string) *Perso return builder } -// 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（name_type）枚举定义部分获得 +// 姓名类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 姓名类型（name_type）枚举定义部分获得 // // 示例值： func (builder *PersonNameBuilder) NameType(nameType *Enum) *PersonNameBuilder { @@ -11554,7 +11554,7 @@ func (builder *PersonNameBuilder) LocalPrimary2(localPrimary2 string) *PersonNam return builder } -// 补充姓名类型，比如emergency_contact_name（紧急联系人姓名） +// 补充姓名类型，比如 emergency_contact_name（紧急联系人姓名） // // 示例值： func (builder *PersonNameBuilder) AdditionalNameType(additionalNameType *Enum) *PersonNameBuilder { @@ -11878,8 +11878,8 @@ type Phone struct { InternationalAreaCode *Enum `json:"international_area_code,omitempty"` // 国家区号;;常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度） PhoneNumber *string `json:"phone_number,omitempty"` // 电话号码 FormattedPhoneNumber *string `json:"formatted_phone_number,omitempty"` // 完整电话号码 - DeviceType *Enum `json:"device_type,omitempty"` // 设备类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)设备类型（device_type）枚举定义部分获得 - PhoneUsage *Enum `json:"phone_usage,omitempty"` // 电话用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)电话用途（phone_usage）枚举定义部分获得 + DeviceType *Enum `json:"device_type,omitempty"` // 设备类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 设备类型（device_type）枚举定义部分获得 + PhoneUsage *Enum `json:"phone_usage,omitempty"` // 电话用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 电话用途（phone_usage）枚举定义部分获得 IsPrimary *bool `json:"is_primary,omitempty"` // 是否为主要电话 IsPublic *bool `json:"is_public,omitempty"` // 是否为公开电话 CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 @@ -11892,9 +11892,9 @@ type PhoneBuilder struct { phoneNumberFlag bool formattedPhoneNumber string // 完整电话号码 formattedPhoneNumberFlag bool - deviceType *Enum // 设备类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)设备类型（device_type）枚举定义部分获得 + deviceType *Enum // 设备类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 设备类型（device_type）枚举定义部分获得 deviceTypeFlag bool - phoneUsage *Enum // 电话用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)电话用途（phone_usage）枚举定义部分获得 + phoneUsage *Enum // 电话用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 电话用途（phone_usage）枚举定义部分获得 phoneUsageFlag bool isPrimary bool // 是否为主要电话 isPrimaryFlag bool @@ -11936,7 +11936,7 @@ func (builder *PhoneBuilder) FormattedPhoneNumber(formattedPhoneNumber string) * return builder } -// 设备类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)设备类型（device_type）枚举定义部分获得 +// 设备类型，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 设备类型（device_type）枚举定义部分获得 // // 示例值： func (builder *PhoneBuilder) DeviceType(deviceType *Enum) *PhoneBuilder { @@ -11945,7 +11945,7 @@ func (builder *PhoneBuilder) DeviceType(deviceType *Enum) *PhoneBuilder { return builder } -// 电话用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)电话用途（phone_usage）枚举定义部分获得 +// 电话用途，枚举值可通过文档 [【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 电话用途（phone_usage）枚举定义部分获得 // // 示例值： func (builder *PhoneBuilder) PhoneUsage(phoneUsage *Enum) *PhoneBuilder { @@ -12016,20 +12016,20 @@ func (builder *PhoneBuilder) Build() *Phone { type PreHire struct { AtsApplicationId *string `json:"ats_application_id,omitempty"` // 招聘系统的候选人 ID - Id *string `json:"id,omitempty"` // 待入职ID + Id *string `json:"id,omitempty"` // 待入职 ID HireDate *string `json:"hire_date,omitempty"` // 入职日期 EmployeeType *Enum `json:"employee_type,omitempty"` // 雇佣类型 WorkerId *string `json:"worker_id,omitempty"` // 人员编号 EmployeeTypeId *string `json:"employee_type_id,omitempty"` // 雇佣类型 - PersonId *string `json:"person_id,omitempty"` // 引用Person ID + PersonId *string `json:"person_id,omitempty"` // 引用 Person ID CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 - OnboardingStatus *Enum `json:"onboarding_status,omitempty"` // 入职状态;;- 待入职(preboarding);;- 已删除(deleted);;- 准备就绪(day_one);;- 已撤销(withdrawn);;- 已完成(completed) + OnboardingStatus *Enum `json:"onboarding_status,omitempty"` // 入职状态;;- 待入职 (preboarding);;- 已删除 (deleted);;- 准备就绪 (day_one);;- 已撤销 (withdrawn);;- 已完成 (completed) } type PreHireBuilder struct { atsApplicationId string // 招聘系统的候选人 ID atsApplicationIdFlag bool - id string // 待入职ID + id string // 待入职 ID idFlag bool hireDate string // 入职日期 hireDateFlag bool @@ -12039,11 +12039,11 @@ type PreHireBuilder struct { workerIdFlag bool employeeTypeId string // 雇佣类型 employeeTypeIdFlag bool - personId string // 引用Person ID + personId string // 引用 Person ID personIdFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool - onboardingStatus *Enum // 入职状态;;- 待入职(preboarding);;- 已删除(deleted);;- 准备就绪(day_one);;- 已撤销(withdrawn);;- 已完成(completed) + onboardingStatus *Enum // 入职状态;;- 待入职 (preboarding);;- 已删除 (deleted);;- 准备就绪 (day_one);;- 已撤销 (withdrawn);;- 已完成 (completed) onboardingStatusFlag bool } @@ -12061,7 +12061,7 @@ func (builder *PreHireBuilder) AtsApplicationId(atsApplicationId string) *PreHir return builder } -// 待入职ID +// 待入职 ID // // 示例值：154545454 func (builder *PreHireBuilder) Id(id string) *PreHireBuilder { @@ -12106,7 +12106,7 @@ func (builder *PreHireBuilder) EmployeeTypeId(employeeTypeId string) *PreHireBui return builder } -// 引用Person ID +// 引用 Person ID // // 示例值：656464648662 func (builder *PreHireBuilder) PersonId(personId string) *PreHireBuilder { @@ -12124,7 +12124,7 @@ func (builder *PreHireBuilder) CustomFields(customFields []*ObjectFieldData) *Pr return builder } -// 入职状态;;- 待入职(preboarding);;- 已删除(deleted);;- 准备就绪(day_one);;- 已撤销(withdrawn);;- 已完成(completed) +// 入职状态;;- 待入职 (preboarding);;- 已删除 (deleted);;- 准备就绪 (day_one);;- 已撤销 (withdrawn);;- 已完成 (completed) // // 示例值： func (builder *PreHireBuilder) OnboardingStatus(onboardingStatus *Enum) *PreHireBuilder { @@ -12173,22 +12173,22 @@ func (builder *PreHireBuilder) Build() *PreHire { type PreHireQuery struct { AtsApplicationId *string `json:"ats_application_id,omitempty"` // 招聘系统的候选人 ID - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 HireDate *string `json:"hire_date,omitempty"` // 入职日期 EmployeeType *Enum `json:"employee_type,omitempty"` // 雇佣类型 WorkerId *string `json:"worker_id,omitempty"` // 人员编号 EmployeeTypeId *string `json:"employee_type_id,omitempty"` // 雇佣类型 - PersonId *string `json:"person_id,omitempty"` // 引用Person ID + PersonId *string `json:"person_id,omitempty"` // 引用 Person ID CustomFields []*ObjectFieldData `json:"custom_fields,omitempty"` // 自定义字段 OnboardingStatus *Enum `json:"onboarding_status,omitempty"` // 入职状态 WorkEmailList []*Email `json:"work_email_list,omitempty"` // 工作邮箱 - DepartmentId *string `json:"department_id,omitempty"` // 部门ID + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID } type PreHireQueryBuilder struct { atsApplicationId string // 招聘系统的候选人 ID atsApplicationIdFlag bool - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool hireDate string // 入职日期 hireDateFlag bool @@ -12198,7 +12198,7 @@ type PreHireQueryBuilder struct { workerIdFlag bool employeeTypeId string // 雇佣类型 employeeTypeIdFlag bool - personId string // 引用Person ID + personId string // 引用 Person ID personIdFlag bool customFields []*ObjectFieldData // 自定义字段 customFieldsFlag bool @@ -12206,7 +12206,7 @@ type PreHireQueryBuilder struct { onboardingStatusFlag bool workEmailList []*Email // 工作邮箱 workEmailListFlag bool - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool } @@ -12224,7 +12224,7 @@ func (builder *PreHireQueryBuilder) AtsApplicationId(atsApplicationId string) *P return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：154545454 func (builder *PreHireQueryBuilder) Id(id string) *PreHireQueryBuilder { @@ -12269,7 +12269,7 @@ func (builder *PreHireQueryBuilder) EmployeeTypeId(employeeTypeId string) *PreHi return builder } -// 引用Person ID +// 引用 Person ID // // 示例值：656464648662 func (builder *PreHireQueryBuilder) PersonId(personId string) *PreHireQueryBuilder { @@ -12305,7 +12305,7 @@ func (builder *PreHireQueryBuilder) WorkEmailList(workEmailList []*Email) *PreHi return builder } -// 部门ID +// 部门 ID // // 示例值：656464648662 func (builder *PreHireQueryBuilder) DepartmentId(departmentId string) *PreHireQueryBuilder { @@ -12360,7 +12360,7 @@ func (builder *PreHireQueryBuilder) Build() *PreHireQuery { } type PreviousEmployer struct { - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 EmployerName *string `json:"employer_name,omitempty"` // 雇主名称 EmployerReferenceNumber *string `json:"employer_reference_number,omitempty"` // 雇主税参考号 EmploymentOrder *string `json:"employment_order,omitempty"` // 雇佣顺序 @@ -12368,7 +12368,7 @@ type PreviousEmployer struct { } type PreviousEmployerBuilder struct { - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool employerName string // 雇主名称 employerNameFlag bool @@ -12385,7 +12385,7 @@ func NewPreviousEmployerBuilder() *PreviousEmployerBuilder { return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：6950635856373745165 func (builder *PreviousEmployerBuilder) Id(id string) *PreviousEmployerBuilder { @@ -12455,11 +12455,11 @@ func (builder *PreviousEmployerBuilder) Build() *PreviousEmployer { } type Process struct { - Id *string `json:"id,omitempty"` // 流程ID + Id *string `json:"id,omitempty"` // 流程 ID } type ProcessBuilder struct { - id string // 流程ID + id string // 流程 ID idFlag bool } @@ -12468,7 +12468,7 @@ func NewProcessBuilder() *ProcessBuilder { return builder } -// 流程ID +// 流程 ID // // 示例值： func (builder *ProcessBuilder) Id(id string) *ProcessBuilder { @@ -12488,13 +12488,13 @@ func (builder *ProcessBuilder) Build() *Process { type ReferenceObject struct { ApiName *string `json:"api_name,omitempty"` // cpst_item(项目)、 cpst_indicator(指标) - Id *string `json:"id,omitempty"` // 值列表 例如部门ID + Id *string `json:"id,omitempty"` // 值列表 例如部门 ID } type ReferenceObjectBuilder struct { apiName string // cpst_item(项目)、 cpst_indicator(指标) apiNameFlag bool - id string // 值列表 例如部门ID + id string // 值列表 例如部门 ID idFlag bool } @@ -12512,7 +12512,7 @@ func (builder *ReferenceObjectBuilder) ApiName(apiName string) *ReferenceObjectB return builder } -// 值列表 例如部门ID +// 值列表 例如部门 ID // // 示例值：7156853394442044972 func (builder *ReferenceObjectBuilder) Id(id string) *ReferenceObjectBuilder { @@ -12535,7 +12535,7 @@ func (builder *ReferenceObjectBuilder) Build() *ReferenceObject { } type ResidentTax struct { - Id *string `json:"id,omitempty"` // 实体在CoreHR内部的唯一键 + Id *string `json:"id,omitempty"` // 实体在 CoreHR 内部的唯一键 YearResidentTax *string `json:"year_resident_tax,omitempty"` // 年度 TaxAddress *Address `json:"tax_address,omitempty"` // 纳税地址 TaxCountryRegionId *string `json:"tax_country_region_id,omitempty"` // 纳税国家地区 @@ -12545,7 +12545,7 @@ type ResidentTax struct { } type ResidentTaxBuilder struct { - id string // 实体在CoreHR内部的唯一键 + id string // 实体在 CoreHR 内部的唯一键 idFlag bool yearResidentTax string // 年度 yearResidentTaxFlag bool @@ -12566,7 +12566,7 @@ func NewResidentTaxBuilder() *ResidentTaxBuilder { return builder } -// 实体在CoreHR内部的唯一键 +// 实体在 CoreHR 内部的唯一键 // // 示例值：6950635856373745165 func (builder *ResidentTaxBuilder) Id(id string) *ResidentTaxBuilder { @@ -12722,12 +12722,12 @@ func (builder *RoleAuthorizationBuilder) Build() *RoleAuthorization { } type RuleDimension struct { - EntityKey *string `json:"entity_key,omitempty"` // 维度的key + EntityKey *string `json:"entity_key,omitempty"` // 维度的 key EntityName *Name `json:"entity_name,omitempty"` // 维度名称 } type RuleDimensionBuilder struct { - entityKey string // 维度的key + entityKey string // 维度的 key entityKeyFlag bool entityName *Name // 维度名称 entityNameFlag bool @@ -12738,7 +12738,7 @@ func NewRuleDimensionBuilder() *RuleDimensionBuilder { return builder } -// 维度的key +// 维度的 key // // 示例值：员工 func (builder *RuleDimensionBuilder) EntityKey(entityKey string) *RuleDimensionBuilder { @@ -12769,8 +12769,8 @@ func (builder *RuleDimensionBuilder) Build() *RuleDimension { } type SecurityGroup struct { - Id *string `json:"id,omitempty"` // 角色ID - Code *string `json:"code,omitempty"` // 角色code，通常用于与其他系统进行交互 + Id *string `json:"id,omitempty"` // 角色 ID + Code *string `json:"code,omitempty"` // 角色 code，通常用于与其他系统进行交互 Name *Name `json:"name,omitempty"` // 角色名称 ActiveStatus *int `json:"active_status,omitempty"` // 状态，1 = Inactive / 停用，;2 = Active / 启用，3 = TobeActivated / 待启用 Description *Name `json:"description,omitempty"` // 角色描述 @@ -12778,9 +12778,9 @@ type SecurityGroup struct { } type SecurityGroupBuilder struct { - id string // 角色ID + id string // 角色 ID idFlag bool - code string // 角色code，通常用于与其他系统进行交互 + code string // 角色 code，通常用于与其他系统进行交互 codeFlag bool name *Name // 角色名称 nameFlag bool @@ -12797,7 +12797,7 @@ func NewSecurityGroupBuilder() *SecurityGroupBuilder { return builder } -// 角色ID +// 角色 ID // // 示例值：7034393015968122400 func (builder *SecurityGroupBuilder) Id(id string) *SecurityGroupBuilder { @@ -12806,7 +12806,7 @@ func (builder *SecurityGroupBuilder) Id(id string) *SecurityGroupBuilder { return builder } -// 角色code，通常用于与其他系统进行交互 +// 角色 code，通常用于与其他系统进行交互 // // 示例值：department_manager func (builder *SecurityGroupBuilder) Code(code string) *SecurityGroupBuilder { @@ -12879,18 +12879,18 @@ func (builder *SecurityGroupBuilder) Build() *SecurityGroup { } type Subdivision struct { - Id *string `json:"id,omitempty"` // 省份/行政区id + Id *string `json:"id,omitempty"` // 省份/行政区 id Name []*I18n `json:"name,omitempty"` // 省份/行政区名称 - CountryRegionId *string `json:"country_region_id,omitempty"` // 所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 + CountryRegionId *string `json:"country_region_id,omitempty"` // 所属国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 SubdivisionType *Enum `json:"subdivision_type,omitempty"` // 行政区类型，枚举值可通过文档【飞书人事枚举常量】行政区类型（subdivision_type）枚举定义部分获得 } type SubdivisionBuilder struct { - id string // 省份/行政区id + id string // 省份/行政区 id idFlag bool name []*I18n // 省份/行政区名称 nameFlag bool - countryRegionId string // 所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 + countryRegionId string // 所属国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 countryRegionIdFlag bool subdivisionType *Enum // 行政区类型，枚举值可通过文档【飞书人事枚举常量】行政区类型（subdivision_type）枚举定义部分获得 subdivisionTypeFlag bool @@ -12901,7 +12901,7 @@ func NewSubdivisionBuilder() *SubdivisionBuilder { return builder } -// 省份/行政区id +// 省份/行政区 id // // 示例值：12 func (builder *SubdivisionBuilder) Id(id string) *SubdivisionBuilder { @@ -12919,7 +12919,7 @@ func (builder *SubdivisionBuilder) Name(name []*I18n) *SubdivisionBuilder { return builder } -// 所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得 +// 所属国家/地区 id，详细信息可通过【查询国家/地区信息】接口查询获得 // // 示例值：12 func (builder *SubdivisionBuilder) CountryRegionId(countryRegionId string) *SubdivisionBuilder { @@ -12957,20 +12957,20 @@ func (builder *SubdivisionBuilder) Build() *Subdivision { } type Subregion struct { - Id *string `json:"id,omitempty"` // 城市/区域id + Id *string `json:"id,omitempty"` // 城市/区域 id Name []*I18n `json:"name,omitempty"` // 城市/区域名称 - SubdivisionId *string `json:"subdivision_id,omitempty"` // 所属省份/行政区id，详细信息可通过【查询省份/行政区信息】接口查询获得 - SuperiorSubregionId *string `json:"superior_subregion_id,omitempty"` // 上级城市/区域区id + SubdivisionId *string `json:"subdivision_id,omitempty"` // 所属省份/行政区 id，详细信息可通过【查询省份/行政区信息】接口查询获得 + SuperiorSubregionId *string `json:"superior_subregion_id,omitempty"` // 上级城市/区域区 id } type SubregionBuilder struct { - id string // 城市/区域id + id string // 城市/区域 id idFlag bool name []*I18n // 城市/区域名称 nameFlag bool - subdivisionId string // 所属省份/行政区id，详细信息可通过【查询省份/行政区信息】接口查询获得 + subdivisionId string // 所属省份/行政区 id，详细信息可通过【查询省份/行政区信息】接口查询获得 subdivisionIdFlag bool - superiorSubregionId string // 上级城市/区域区id + superiorSubregionId string // 上级城市/区域区 id superiorSubregionIdFlag bool } @@ -12979,7 +12979,7 @@ func NewSubregionBuilder() *SubregionBuilder { return builder } -// 城市/区域id +// 城市/区域 id // // 示例值：12 func (builder *SubregionBuilder) Id(id string) *SubregionBuilder { @@ -12997,7 +12997,7 @@ func (builder *SubregionBuilder) Name(name []*I18n) *SubregionBuilder { return builder } -// 所属省份/行政区id，详细信息可通过【查询省份/行政区信息】接口查询获得 +// 所属省份/行政区 id，详细信息可通过【查询省份/行政区信息】接口查询获得 // // 示例值：12 func (builder *SubregionBuilder) SubdivisionId(subdivisionId string) *SubregionBuilder { @@ -13006,7 +13006,7 @@ func (builder *SubregionBuilder) SubdivisionId(subdivisionId string) *SubregionB return builder } -// 上级城市/区域区id +// 上级城市/区域区 id // // 示例值：12 func (builder *SubregionBuilder) SuperiorSubregionId(superiorSubregionId string) *SubregionBuilder { @@ -13036,12 +13036,12 @@ func (builder *SubregionBuilder) Build() *Subregion { } type SupportCostCenterItem struct { - CostCenterId *string `json:"cost_center_id,omitempty"` // 支持的成本中心id + CostCenterId *string `json:"cost_center_id,omitempty"` // 支持的成本中心 id Rate *int `json:"rate,omitempty"` // 分摊比例 } type SupportCostCenterItemBuilder struct { - costCenterId string // 支持的成本中心id + costCenterId string // 支持的成本中心 id costCenterIdFlag bool rate int // 分摊比例 rateFlag bool @@ -13052,7 +13052,7 @@ func NewSupportCostCenterItemBuilder() *SupportCostCenterItemBuilder { return builder } -// 支持的成本中心id +// 支持的成本中心 id // // 示例值：6950635856373745165 func (builder *SupportCostCenterItemBuilder) CostCenterId(costCenterId string) *SupportCostCenterItemBuilder { @@ -13119,7 +13119,7 @@ type TextFieldSetting struct { IsMultilingual *bool `json:"is_multilingual,omitempty"` // 是否多语言 IsMultiline *bool `json:"is_multiline,omitempty"` // 是否多行 MaxLength *int `json:"max_length,omitempty"` // 最大长度 - IsUrlType *bool `json:"is_url_type,omitempty"` // 是否是URL类型 + IsUrlType *bool `json:"is_url_type,omitempty"` // 是否是 URL 类型 } type TextFieldSettingBuilder struct { @@ -13129,7 +13129,7 @@ type TextFieldSettingBuilder struct { isMultilineFlag bool maxLength int // 最大长度 maxLengthFlag bool - isUrlType bool // 是否是URL类型 + isUrlType bool // 是否是 URL 类型 isUrlTypeFlag bool } @@ -13165,7 +13165,7 @@ func (builder *TextFieldSettingBuilder) MaxLength(maxLength int) *TextFieldSetti return builder } -// 是否是URL类型 +// 是否是 URL 类型 // // 示例值：true func (builder *TextFieldSettingBuilder) IsUrlType(isUrlType bool) *TextFieldSettingBuilder { @@ -13197,7 +13197,7 @@ func (builder *TextFieldSettingBuilder) Build() *TextFieldSetting { type TransferInfo struct { Remark *string `json:"remark,omitempty"` // 备注 - OfferInfo *string `json:"offer_info,omitempty"` // offer信息 + OfferInfo *string `json:"offer_info,omitempty"` // offer 信息 TargetDottedManagerClean *bool `json:"target_dotted_manager_clean,omitempty"` // 是否撤销虚线上级 ProbationExist *bool `json:"probation_exist,omitempty"` // 是否有试用期 OriginalDepartment *string `json:"original_department,omitempty"` // 原部门 @@ -13245,7 +13245,7 @@ type TransferInfo struct { type TransferInfoBuilder struct { remark string // 备注 remarkFlag bool - offerInfo string // offer信息 + offerInfo string // offer 信息 offerInfoFlag bool targetDottedManagerClean bool // 是否撤销虚线上级 targetDottedManagerCleanFlag bool @@ -13347,7 +13347,7 @@ func (builder *TransferInfoBuilder) Remark(remark string) *TransferInfoBuilder { return builder } -// offer信息 +// offer 信息 // // 示例值：优质人才，加急处理 func (builder *TransferInfoBuilder) OfferInfo(offerInfo string) *TransferInfoBuilder { @@ -14413,7 +14413,7 @@ func NewLeaveRequestHistoryLeaveReqBuilder() *LeaveRequestHistoryLeaveReqBuilder return builder } -// 页码标识，获取第一页传空，每次查询会返回下一页的page_token +// 页码标识，获取第一页传空，每次查询会返回下一页的 page_token // // 示例值：eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 func (builder *LeaveRequestHistoryLeaveReqBuilder) PageToken(pageToken string) *LeaveRequestHistoryLeaveReqBuilder { @@ -14421,7 +14421,7 @@ func (builder *LeaveRequestHistoryLeaveReqBuilder) PageToken(pageToken string) * return builder } -// 每页获取记录数量，最大100 +// 每页获取记录数量，最大 100 // // 示例值：100 func (builder *LeaveRequestHistoryLeaveReqBuilder) PageSize(pageSize string) *LeaveRequestHistoryLeaveReqBuilder { diff --git a/service/docx/v1/api.go b/service/docx/v1/api.go index 355d90c9..e51c7562 100644 --- a/service/docx/v1/api.go +++ b/service/docx/v1/api.go @@ -49,13 +49,13 @@ type documentBlockChildren struct { // // - 创建新版文档，文档标题和目录可选。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnyoyCgwS8ywWwMtQr9yjZ2f)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnyoyCgwS8ywWwMtQr9yjZ2f)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 3 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/create_document.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/create_document.go func (d *document) Create(ctx context.Context, req *CreateDocumentReq, options ...larkcore.RequestOptionFunc) (*CreateDocumentResp, error) { // 发起请求 apiReq := req.apiReq @@ -79,13 +79,13 @@ func (d *document) Create(ctx context.Context, req *CreateDocumentReq, options . // // - 获取文档最新版本号、标题等 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnWKAE4aSaIU4GcdLInSaVde)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnWKAE4aSaIU4GcdLInSaVde)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 5 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/get_document.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/get_document.go func (d *document) Get(ctx context.Context, req *GetDocumentReq, options ...larkcore.RequestOptionFunc) (*GetDocumentResp, error) { // 发起请求 apiReq := req.apiReq @@ -109,13 +109,13 @@ func (d *document) Get(ctx context.Context, req *GetDocumentReq, options ...lark // // - 获取文档的纯文本内容。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnQeqI4wiKIMis6GNvCOBuqg)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnQeqI4wiKIMis6GNvCOBuqg)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 5 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/raw_content +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/raw_content // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/rawContent_document.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/rawContent_document.go func (d *document) RawContent(ctx context.Context, req *RawContentDocumentReq, options ...larkcore.RequestOptionFunc) (*RawContentDocumentResp, error) { // 发起请求 apiReq := req.apiReq @@ -139,13 +139,13 @@ func (d *document) RawContent(ctx context.Context, req *RawContentDocumentReq, o // // - 批量更新块的富文本内容。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnMiwAKCiE6oQEkPyhvmmQEe)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnMiwAKCiE6oQEkPyhvmmQEe)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 3 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/batch_update +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/batch_update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/batchUpdate_documentBlock.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/batchUpdate_documentBlock.go func (d *documentBlock) BatchUpdate(ctx context.Context, req *BatchUpdateDocumentBlockReq, options ...larkcore.RequestOptionFunc) (*BatchUpdateDocumentBlockResp, error) { // 发起请求 apiReq := req.apiReq @@ -169,13 +169,13 @@ func (d *documentBlock) BatchUpdate(ctx context.Context, req *BatchUpdateDocumen // // - 获取指定块的富文本内容。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnamKaccZKqIMopnREJCZUMe#doxcnWEMWYAg2YMkEq0SZXHzaih)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnamKaccZKqIMopnREJCZUMe#doxcnWEMWYAg2YMkEq0SZXHzaih)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 5 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/get_documentBlock.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/get_documentBlock.go func (d *documentBlock) Get(ctx context.Context, req *GetDocumentBlockReq, options ...larkcore.RequestOptionFunc) (*GetDocumentBlockResp, error) { // 发起请求 apiReq := req.apiReq @@ -199,13 +199,13 @@ func (d *documentBlock) Get(ctx context.Context, req *GetDocumentBlockReq, optio // // - 获取文档所有块的富文本内容并分页返回。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnamKaccZKqIMopnREJCZUMe#doxcn6AkCE2AUUm2WwxID7lS7Xc)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnamKaccZKqIMopnREJCZUMe#doxcn6AkCE2AUUm2WwxID7lS7Xc)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 5 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/list_documentBlock.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/list_documentBlock.go func (d *documentBlock) List(ctx context.Context, req *ListDocumentBlockReq, options ...larkcore.RequestOptionFunc) (*ListDocumentBlockResp, error) { // 发起请求 apiReq := req.apiReq @@ -237,13 +237,13 @@ func (d *documentBlock) ListByIterator(ctx context.Context, req *ListDocumentBlo // // - 更新指定的块。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnEeyS0I8MMqoieIMpK7jm8g)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnEeyS0I8MMqoieIMpK7jm8g)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 3 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/patch_documentBlock.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/patch_documentBlock.go func (d *documentBlock) Patch(ctx context.Context, req *PatchDocumentBlockReq, options ...larkcore.RequestOptionFunc) (*PatchDocumentBlockResp, error) { // 发起请求 apiReq := req.apiReq @@ -267,13 +267,13 @@ func (d *documentBlock) Patch(ctx context.Context, req *PatchDocumentBlockReq, o // // - 指定需要操作的块，删除其指定范围的子块。如果操作成功，接口将返回应用删除操作后的文档版本号。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcngCsscGk0WacO258mYDgM6b)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcngCsscGk0WacO258mYDgM6b)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 3 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block-children/batch_delete +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block-children/batch_delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/batchDelete_documentBlockChildren.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/batchDelete_documentBlockChildren.go func (d *documentBlockChildren) BatchDelete(ctx context.Context, req *BatchDeleteDocumentBlockChildrenReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteDocumentBlockChildrenResp, error) { // 发起请求 apiReq := req.apiReq @@ -297,13 +297,13 @@ func (d *documentBlockChildren) BatchDelete(ctx context.Context, req *BatchDelet // // - 指定需要操作的块，为其创建一批子块，并插入到指定位置。如果操作成功，接口将返回新创建子块的富文本内容。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnm0ooUe0s20GwwVB3a05rtb)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnm0ooUe0s20GwwVB3a05rtb)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 3 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block-children/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block-children/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/create_documentBlockChildren.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/create_documentBlockChildren.go func (d *documentBlockChildren) Create(ctx context.Context, req *CreateDocumentBlockChildrenReq, options ...larkcore.RequestOptionFunc) (*CreateDocumentBlockChildrenResp, error) { // 发起请求 apiReq := req.apiReq @@ -327,13 +327,13 @@ func (d *documentBlockChildren) Create(ctx context.Context, req *CreateDocumentB // // - 给定一个指定版本的文档，并指定需要操作的块，分页遍历其所有子块富文本内容 。如果不指定版本，则会默认查询最新版本。 // -// - 在调用此接口前，请仔细阅读[新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnE2UK2yY0gEGK8nBMPtB0vd)，了解相关规则及约束。 +// - 在调用此接口前，请仔细阅读 [新版文档 OpenAPI 接口校验规则](https://bytedance.feishu.cn/docx/doxcnby5Y0yoACL3PdfZqrJEm6f#doxcnE2UK2yY0gEGK8nBMPtB0vd)，了解相关规则及约束。 // // - 频率限制：单个应用调用频率上限为每秒 5 次。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block-children/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block-children/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/get_documentBlockChildren.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/docxv1/get_documentBlockChildren.go func (d *documentBlockChildren) Get(ctx context.Context, req *GetDocumentBlockChildrenReq, options ...larkcore.RequestOptionFunc) (*GetDocumentBlockChildrenResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/docx/v1/model.go b/service/docx/v1/model.go index 1be8eba7..f53c1829 100644 --- a/service/docx/v1/model.go +++ b/service/docx/v1/model.go @@ -30,49 +30,49 @@ const ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetDocumentBlockUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetDocumentBlockUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetDocumentBlockOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetDocumentBlockUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetDocumentBlockUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetDocumentBlockOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListDocumentBlockUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListDocumentBlockUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListDocumentBlockOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListDocumentBlockUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListDocumentBlockUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListDocumentBlockOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypePatchDocumentBlockUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchDocumentBlockUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchDocumentBlockOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchDocumentBlockUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchDocumentBlockUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchDocumentBlockOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateDocumentBlockChildrenUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateDocumentBlockChildrenUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateDocumentBlockChildrenOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateDocumentBlockChildrenUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateDocumentBlockChildrenUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateDocumentBlockChildrenOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetDocumentBlockChildrenUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetDocumentBlockChildrenUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetDocumentBlockChildrenOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetDocumentBlockChildrenUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetDocumentBlockChildrenUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetDocumentBlockChildrenOpenId = "open_id" // 以 open_id 来识别用户 ) type AddOns struct { - ComponentId *string `json:"component_id,omitempty"` // 团队互动应用唯一ID + ComponentId *string `json:"component_id,omitempty"` // 团队互动应用唯一 ID ComponentTypeId *string `json:"component_type_id,omitempty"` // 团队互动应用类型，比如问答互动"blk_636a0a6657db8001c8df5488" Record *string `json:"record,omitempty"` // 文档小组件内容数据，JSON 字符串 } type AddOnsBuilder struct { - componentId string // 团队互动应用唯一ID + componentId string // 团队互动应用唯一 ID componentIdFlag bool componentTypeId string // 团队互动应用类型，比如问答互动"blk_636a0a6657db8001c8df5488" componentTypeIdFlag bool @@ -85,7 +85,7 @@ func NewAddOnsBuilder() *AddOnsBuilder { return builder } -// 团队互动应用唯一ID +// 团队互动应用唯一 ID // // 示例值：7056882725002051603 func (builder *AddOnsBuilder) ComponentId(componentId string) *AddOnsBuilder { @@ -1015,11 +1015,11 @@ func (builder *ChatCardBuilder) Build() *ChatCard { } type DeleteGridColumnRequest struct { - ColumnIndex *int `json:"column_index,omitempty"` // 删除列索引，从 0 开始，如 0 表示删除第一列（-1表示删除最后一列） + ColumnIndex *int `json:"column_index,omitempty"` // 删除列索引，从 0 开始，如 0 表示删除第一列（-1 表示删除最后一列） } type DeleteGridColumnRequestBuilder struct { - columnIndex int // 删除列索引，从 0 开始，如 0 表示删除第一列（-1表示删除最后一列） + columnIndex int // 删除列索引，从 0 开始，如 0 表示删除第一列（-1 表示删除最后一列） columnIndexFlag bool } @@ -1028,7 +1028,7 @@ func NewDeleteGridColumnRequestBuilder() *DeleteGridColumnRequestBuilder { return builder } -// 删除列索引，从 0 开始，如 0 表示删除第一列（-1表示删除最后一列） +// 删除列索引，从 0 开始，如 0 表示删除第一列（-1 表示删除最后一列） // // 示例值：0 func (builder *DeleteGridColumnRequestBuilder) ColumnIndex(columnIndex int) *DeleteGridColumnRequestBuilder { @@ -1654,11 +1654,11 @@ func (builder *InlineFileBuilder) Build() *InlineFile { } type InsertGridColumnRequest struct { - ColumnIndex *int `json:"column_index,omitempty"` // 插入列索引，从 1 开始，如 1 表示在第一列后插入，注意不允许传 0（-1表示在最后一列后插入） + ColumnIndex *int `json:"column_index,omitempty"` // 插入列索引，从 1 开始，如 1 表示在第一列后插入，注意不允许传 0（-1 表示在最后一列后插入） } type InsertGridColumnRequestBuilder struct { - columnIndex int // 插入列索引，从 1 开始，如 1 表示在第一列后插入，注意不允许传 0（-1表示在最后一列后插入） + columnIndex int // 插入列索引，从 1 开始，如 1 表示在第一列后插入，注意不允许传 0（-1 表示在最后一列后插入） columnIndexFlag bool } @@ -1667,7 +1667,7 @@ func NewInsertGridColumnRequestBuilder() *InsertGridColumnRequestBuilder { return builder } -// 插入列索引，从 1 开始，如 1 表示在第一列后插入，注意不允许传 0（-1表示在最后一列后插入） +// 插入列索引，从 1 开始，如 1 表示在第一列后插入，注意不允许传 0（-1 表示在最后一列后插入） // // 示例值：1 func (builder *InsertGridColumnRequestBuilder) ColumnIndex(columnIndex int) *InsertGridColumnRequestBuilder { @@ -1686,11 +1686,11 @@ func (builder *InsertGridColumnRequestBuilder) Build() *InsertGridColumnRequest } type InsertTableColumnRequest struct { - ColumnIndex *int `json:"column_index,omitempty"` // 插入的列在表格中的索引。（-1表示在表格末尾插入一列） + ColumnIndex *int `json:"column_index,omitempty"` // 插入的列在表格中的索引。（-1 表示在表格末尾插入一列） } type InsertTableColumnRequestBuilder struct { - columnIndex int // 插入的列在表格中的索引。（-1表示在表格末尾插入一列） + columnIndex int // 插入的列在表格中的索引。（-1 表示在表格末尾插入一列） columnIndexFlag bool } @@ -1699,7 +1699,7 @@ func NewInsertTableColumnRequestBuilder() *InsertTableColumnRequestBuilder { return builder } -// 插入的列在表格中的索引。（-1表示在表格末尾插入一列） +// 插入的列在表格中的索引。（-1 表示在表格末尾插入一列） // // 示例值：-1 func (builder *InsertTableColumnRequestBuilder) ColumnIndex(columnIndex int) *InsertTableColumnRequestBuilder { @@ -1718,11 +1718,11 @@ func (builder *InsertTableColumnRequestBuilder) Build() *InsertTableColumnReques } type InsertTableRowRequest struct { - RowIndex *int `json:"row_index,omitempty"` // 插入的行在表格中的索引。（-1表示在表格末尾插入一行） + RowIndex *int `json:"row_index,omitempty"` // 插入的行在表格中的索引。（-1 表示在表格末尾插入一行） } type InsertTableRowRequestBuilder struct { - rowIndex int // 插入的行在表格中的索引。（-1表示在表格末尾插入一行） + rowIndex int // 插入的行在表格中的索引。（-1 表示在表格末尾插入一行） rowIndexFlag bool } @@ -1731,7 +1731,7 @@ func NewInsertTableRowRequestBuilder() *InsertTableRowRequestBuilder { return builder } -// 插入的行在表格中的索引。（-1表示在表格末尾插入一行） +// 插入的行在表格中的索引。（-1 表示在表格末尾插入一行） // // 示例值：-1 func (builder *InsertTableRowRequestBuilder) RowIndex(rowIndex int) *InsertTableRowRequestBuilder { @@ -1750,12 +1750,12 @@ func (builder *InsertTableRowRequestBuilder) Build() *InsertTableRowRequest { } type Isv struct { - ComponentId *string `json:"component_id,omitempty"` // 团队互动应用唯一ID + ComponentId *string `json:"component_id,omitempty"` // 团队互动应用唯一 ID ComponentTypeId *string `json:"component_type_id,omitempty"` // 团队互动应用类型，比如信息收集"blk_5f992038c64240015d280958" } type IsvBuilder struct { - componentId string // 团队互动应用唯一ID + componentId string // 团队互动应用唯一 ID componentIdFlag bool componentTypeId string // 团队互动应用类型，比如信息收集"blk_5f992038c64240015d280958" componentTypeIdFlag bool @@ -1766,7 +1766,7 @@ func NewIsvBuilder() *IsvBuilder { return builder } -// 团队互动应用唯一ID +// 团队互动应用唯一 ID // // 示例值：7056882725002051603 func (builder *IsvBuilder) ComponentId(componentId string) *IsvBuilder { @@ -2131,7 +2131,7 @@ func (builder *ObjectiveIdWithKrIdBuilder) Build() *ObjectiveIdWithKrId { } type Okr struct { - OkrId *string `json:"okr_id,omitempty"` // OKR ID，获取需要插入的 OKR ID 可见[获取用户的 OKR 列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list) + OkrId *string `json:"okr_id,omitempty"` // OKR ID，获取需要插入的 OKR ID 可见 [获取用户的 OKR 列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list) Objectives []*ObjectiveIdWithKrId `json:"objectives,omitempty"` // OKR Block 中的 Objective ID 和 Key Result ID，此值为空时插入 OKR 下所有的 Objective 和 Key Result PeriodDisplayStatus *string `json:"period_display_status,omitempty"` // 周期的状态 PeriodNameZh *string `json:"period_name_zh,omitempty"` // 周期名 - 中文 @@ -2141,7 +2141,7 @@ type Okr struct { } type OkrBuilder struct { - okrId string // OKR ID，获取需要插入的 OKR ID 可见[获取用户的 OKR 列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list) + okrId string // OKR ID，获取需要插入的 OKR ID 可见 [获取用户的 OKR 列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list) okrIdFlag bool objectives []*ObjectiveIdWithKrId // OKR Block 中的 Objective ID 和 Key Result ID，此值为空时插入 OKR 下所有的 Objective 和 Key Result objectivesFlag bool @@ -2162,7 +2162,7 @@ func NewOkrBuilder() *OkrBuilder { return builder } -// OKR ID，获取需要插入的 OKR ID 可见[获取用户的 OKR 列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list) +// OKR ID，获取需要插入的 OKR ID 可见 [获取用户的 OKR 列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list) // // 示例值：7076349900476448796 func (builder *OkrBuilder) OkrId(okrId string) *OkrBuilder { @@ -2545,7 +2545,7 @@ type OkrProgress struct { type OkrProgressRate struct { Mode *string `json:"mode,omitempty"` // 状态模式 - Current *float64 `json:"current,omitempty"` // 当前进度, advanced 模式使用 + Current *float64 `json:"current,omitempty"` // 当前进度，advanced 模式使用 Percent *float64 `json:"percent,omitempty"` // 当前进度百分比，simple 模式使用 ProgressStatus *string `json:"progress_status,omitempty"` // 进展状态 Start *float64 `json:"start,omitempty"` // 进度起始值，advanced 模式使用 @@ -2556,7 +2556,7 @@ type OkrProgressRate struct { type OkrProgressRateBuilder struct { mode string // 状态模式 modeFlag bool - current float64 // 当前进度, advanced 模式使用 + current float64 // 当前进度，advanced 模式使用 currentFlag bool percent float64 // 当前进度百分比，simple 模式使用 percentFlag bool @@ -2584,7 +2584,7 @@ func (builder *OkrProgressRateBuilder) Mode(mode string) *OkrProgressRateBuilder return builder } -// 当前进度, advanced 模式使用 +// 当前进度，advanced 模式使用 // // 示例值：0 func (builder *OkrProgressRateBuilder) Current(current float64) *OkrProgressRateBuilder { @@ -3077,7 +3077,7 @@ func (builder *TableMergeInfoBuilder) Build() *TableMergeInfo { type TableProperty struct { RowSize *int `json:"row_size,omitempty"` // 行数 ColumnSize *int `json:"column_size,omitempty"` // 列数 - ColumnWidth []int `json:"column_width,omitempty"` // 列宽，单位px + ColumnWidth []int `json:"column_width,omitempty"` // 列宽，单位 px MergeInfo []*TableMergeInfo `json:"merge_info,omitempty"` // 单元格合并信息 } @@ -3086,7 +3086,7 @@ type TablePropertyBuilder struct { rowSizeFlag bool columnSize int // 列数 columnSizeFlag bool - columnWidth []int // 列宽，单位px + columnWidth []int // 列宽，单位 px columnWidthFlag bool mergeInfo []*TableMergeInfo // 单元格合并信息 mergeInfoFlag bool @@ -3115,7 +3115,7 @@ func (builder *TablePropertyBuilder) ColumnSize(columnSize int) *TablePropertyBu return builder } -// 列宽，单位px +// 列宽，单位 px // // 示例值：100 func (builder *TablePropertyBuilder) ColumnWidth(columnWidth []int) *TablePropertyBuilder { @@ -3153,11 +3153,11 @@ func (builder *TablePropertyBuilder) Build() *TableProperty { } type Task struct { - TaskId *string `json:"task_id,omitempty"` // 任务 ID，查询具体任务详情见[获取任务详情;](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get) + TaskId *string `json:"task_id,omitempty"` // 任务 ID，查询具体任务详情见 [获取任务详情;](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get) } type TaskBuilder struct { - taskId string // 任务 ID，查询具体任务详情见[获取任务详情;](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get) + taskId string // 任务 ID，查询具体任务详情见 [获取任务详情;](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get) taskIdFlag bool } @@ -3166,7 +3166,7 @@ func NewTaskBuilder() *TaskBuilder { return builder } -// 任务 ID，查询具体任务详情见[获取任务详情;](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get) +// 任务 ID，查询具体任务详情见 [获取任务详情;](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get) // // 示例值： func (builder *TaskBuilder) TaskId(taskId string) *TaskBuilder { @@ -4228,7 +4228,7 @@ func (builder *ViewBuilder) Build() *View { } type CreateDocumentReqBodyBuilder struct { - folderToken string // 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token应用权限仅允许操作应用创建的目录 + folderToken string // 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token 应用权限仅允许操作应用创建的目录 folderTokenFlag bool title string // 文档标题，只支持纯文本 titleFlag bool @@ -4239,7 +4239,7 @@ func NewCreateDocumentReqBodyBuilder() *CreateDocumentReqBodyBuilder { return builder } -// 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token应用权限仅允许操作应用创建的目录 +// 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token 应用权限仅允许操作应用创建的目录 // //示例值：fldcnqquW1svRIYVT2Np6IuLCKd func (builder *CreateDocumentReqBodyBuilder) FolderToken(folderToken string) *CreateDocumentReqBodyBuilder { @@ -4269,7 +4269,7 @@ func (builder *CreateDocumentReqBodyBuilder) Build() *CreateDocumentReqBody { } type CreateDocumentPathReqBodyBuilder struct { - folderToken string // 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token应用权限仅允许操作应用创建的目录 + folderToken string // 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token 应用权限仅允许操作应用创建的目录 folderTokenFlag bool title string // 文档标题，只支持纯文本 titleFlag bool @@ -4280,7 +4280,7 @@ func NewCreateDocumentPathReqBodyBuilder() *CreateDocumentPathReqBodyBuilder { return builder } -// 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token应用权限仅允许操作应用创建的目录 +// 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token 应用权限仅允许操作应用创建的目录 // // 示例值：fldcnqquW1svRIYVT2Np6IuLCKd func (builder *CreateDocumentPathReqBodyBuilder) FolderToken(folderToken string) *CreateDocumentPathReqBodyBuilder { @@ -4337,7 +4337,7 @@ func (builder *CreateDocumentReqBuilder) Build() *CreateDocumentReq { } type CreateDocumentReqBody struct { - FolderToken *string `json:"folder_token,omitempty"` // 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token应用权限仅允许操作应用创建的目录 + FolderToken *string `json:"folder_token,omitempty"` // 文件夹 token，获取方式见云文档接口快速入门；空表示根目录，tenant_access_token 应用权限仅允许操作应用创建的目录 Title *string `json:"title,omitempty"` // 文档标题，只支持纯文本 } @@ -4537,7 +4537,7 @@ func (builder *BatchUpdateDocumentBlockReqBuilder) DocumentId(documentId string) return builder } -// 操作的文档版本，-1表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 操作的文档版本，-1 表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *BatchUpdateDocumentBlockReqBuilder) DocumentRevisionId(documentRevisionId int) *BatchUpdateDocumentBlockReqBuilder { @@ -4553,7 +4553,7 @@ func (builder *BatchUpdateDocumentBlockReqBuilder) ClientToken(clientToken strin return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchUpdateDocumentBlockReqBuilder) UserIdType(userIdType string) *BatchUpdateDocumentBlockReqBuilder { @@ -4630,7 +4630,7 @@ func (builder *GetDocumentBlockReqBuilder) BlockId(blockId string) *GetDocumentB return builder } -// 查询的文档版本，-1表示文档最新版本。若此时查询的版本为文档最新版本，则需要持有文档的阅读权限；若此时查询的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 查询的文档版本，-1 表示文档最新版本。若此时查询的版本为文档最新版本，则需要持有文档的阅读权限；若此时查询的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *GetDocumentBlockReqBuilder) DocumentRevisionId(documentRevisionId int) *GetDocumentBlockReqBuilder { @@ -4638,7 +4638,7 @@ func (builder *GetDocumentBlockReqBuilder) DocumentRevisionId(documentRevisionId return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetDocumentBlockReqBuilder) UserIdType(userIdType string) *GetDocumentBlockReqBuilder { @@ -4716,7 +4716,7 @@ func (builder *ListDocumentBlockReqBuilder) PageToken(pageToken string) *ListDoc return builder } -// 查询的文档版本，-1表示文档最新版本。若此时查询的版本为文档最新版本，则需要持有文档的阅读权限；若此时查询的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 查询的文档版本，-1 表示文档最新版本。若此时查询的版本为文档最新版本，则需要持有文档的阅读权限；若此时查询的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *ListDocumentBlockReqBuilder) DocumentRevisionId(documentRevisionId int) *ListDocumentBlockReqBuilder { @@ -4724,7 +4724,7 @@ func (builder *ListDocumentBlockReqBuilder) DocumentRevisionId(documentRevisionI return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListDocumentBlockReqBuilder) UserIdType(userIdType string) *ListDocumentBlockReqBuilder { @@ -4793,7 +4793,7 @@ func (builder *PatchDocumentBlockReqBuilder) BlockId(blockId string) *PatchDocum return builder } -// 操作的文档版本，-1表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 操作的文档版本，-1 表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *PatchDocumentBlockReqBuilder) DocumentRevisionId(documentRevisionId int) *PatchDocumentBlockReqBuilder { @@ -4809,7 +4809,7 @@ func (builder *PatchDocumentBlockReqBuilder) ClientToken(clientToken string) *Pa return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchDocumentBlockReqBuilder) UserIdType(userIdType string) *PatchDocumentBlockReqBuilder { @@ -4965,7 +4965,7 @@ func (builder *BatchDeleteDocumentBlockChildrenReqBuilder) BlockId(blockId strin return builder } -// 操作的文档版本，-1表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 操作的文档版本，-1 表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *BatchDeleteDocumentBlockChildrenReqBuilder) DocumentRevisionId(documentRevisionId int) *BatchDeleteDocumentBlockChildrenReqBuilder { @@ -5133,7 +5133,7 @@ func (builder *CreateDocumentBlockChildrenReqBuilder) BlockId(blockId string) *C return builder } -// 操作的文档版本，-1表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 操作的文档版本，-1 表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *CreateDocumentBlockChildrenReqBuilder) DocumentRevisionId(documentRevisionId int) *CreateDocumentBlockChildrenReqBuilder { @@ -5149,7 +5149,7 @@ func (builder *CreateDocumentBlockChildrenReqBuilder) ClientToken(clientToken st return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateDocumentBlockChildrenReqBuilder) UserIdType(userIdType string) *CreateDocumentBlockChildrenReqBuilder { @@ -5234,7 +5234,7 @@ func (builder *GetDocumentBlockChildrenReqBuilder) BlockId(blockId string) *GetD return builder } -// 操作的文档版本，-1表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 +// 操作的文档版本，-1 表示文档最新版本。若此时操作的版本为文档最新版本，则需要持有文档的阅读权限；若此时操作的版本为文档的历史版本，则需要持有文档的编辑权限。 // // 示例值：-1 func (builder *GetDocumentBlockChildrenReqBuilder) DocumentRevisionId(documentRevisionId int) *GetDocumentBlockChildrenReqBuilder { @@ -5258,7 +5258,7 @@ func (builder *GetDocumentBlockChildrenReqBuilder) PageSize(pageSize int) *GetDo return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetDocumentBlockChildrenReqBuilder) UserIdType(userIdType string) *GetDocumentBlockChildrenReqBuilder { @@ -5315,7 +5315,7 @@ func (iterator *ListDocumentBlockIterator) Next() (bool, *Block, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -5369,7 +5369,7 @@ func (iterator *GetDocumentBlockChildrenIterator) Next() (bool, *Block, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/drive/v1/api.go b/service/drive/v1/api.go index 8f59efcf..0bce42af 100644 --- a/service/drive/v1/api.go +++ b/service/drive/v1/api.go @@ -95,9 +95,9 @@ type permissionPublic struct { // // - 创建导出任务，将云文件导出为指定格式的本地文件。该接口为异步接口，需要通过轮询 [查询导出任务结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/get) 接口获取任务结果。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_exportTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_exportTask.go func (e *exportTask) Create(ctx context.Context, req *CreateExportTaskReq, options ...larkcore.RequestOptionFunc) (*CreateExportTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -119,11 +119,11 @@ func (e *exportTask) Create(ctx context.Context, req *CreateExportTaskReq, optio // 下载导出文件 // -// - 根据任务导出结果的token，下载导出文件 +// - 根据任务导出结果的 token，下载导出文件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/download +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/download // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/download_exportTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/download_exportTask.go func (e *exportTask) Download(ctx context.Context, req *DownloadExportTaskReq, options ...larkcore.RequestOptionFunc) (*DownloadExportTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -151,11 +151,11 @@ func (e *exportTask) Download(ctx context.Context, req *DownloadExportTaskReq, o // 查询导出任务结果 // -// - 根据[创建导出任务](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create)的ticket查询导出任务的结果，前提条件需要先调用创建导出任务接口。;;通过该接口获取到下载文件的 token 后调用[下载导出文件接口](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/download)将文件进行下载 +// - 根据 [创建导出任务](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create) 的 ticket 查询导出任务的结果，前提条件需要先调用创建导出任务接口。;;通过该接口获取到下载文件的 token 后调用 [下载导出文件接口](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/download) 将文件进行下载 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_exportTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_exportTask.go func (e *exportTask) Get(ctx context.Context, req *GetExportTaskReq, options ...larkcore.RequestOptionFunc) (*GetExportTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -177,13 +177,13 @@ func (e *exportTask) Get(ctx context.Context, req *GetExportTaskReq, options ... // 复制文件 // -// - 将文件复制到用户云空间的其他文件夹中。不支持复制文件夹。;;如果目标文件夹是我的空间，则复制的文件会在「**我的空间**」的「**归我所有**」列表里。 +// - 将文件复制到用户云空间的其他文件夹中。不支持复制文件夹。;;如果目标文件夹是我的空间，则复制的文件会在「** 我的空间 **」的「** 归我所有 **」列表里。 // -// - 该接口不支持并发拷贝多个文件，且调用频率上限为 5QPS 且 10000次/天 +// - 该接口不支持并发拷贝多个文件，且调用频率上限为 5QPS 且 10000 次/天 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/copy +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/copy // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/copy_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/copy_file.go func (f *file) Copy(ctx context.Context, req *CopyFileReq, options ...larkcore.RequestOptionFunc) (*CopyFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -207,11 +207,11 @@ func (f *file) Copy(ctx context.Context, req *CopyFileReq, options ...larkcore.R // // - 在用户云空间的指定文件夹中创建一个新的空文件夹。 // -// - 该接口不支持并发创建，且调用频率上限为 5QPS 以及 10000次/天 +// - 该接口不支持并发创建，且调用频率上限为 5QPS 以及 10000 次/天 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/create_folder +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/create_folder // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/createFolder_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/createFolder_file.go func (f *file) CreateFolder(ctx context.Context, req *CreateFolderFileReq, options ...larkcore.RequestOptionFunc) (*CreateFolderFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -237,11 +237,11 @@ func (f *file) CreateFolder(ctx context.Context, req *CreateFolderFileReq, optio // // - 要删除文件需要确保应用具有下述两种权限之一：;1. 该应用是文件所有者并且具有该文件所在父文件夹的编辑权限。;2. 该应用并非文件所有者，但是是该文件所在父文件夹的所有者或者拥有该父文件夹的所有权限（full access）。 // -// - 该接口不支持并发调用，且调用频率上限为5QPS。删除文件夹会异步执行并返回一个task_id，可以使用[task_check](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/task_check)接口查询任务执行状态。 +// - 该接口不支持并发调用，且调用频率上限为 5QPS。删除文件夹会异步执行并返回一个 task_id，可以使用 [task_check](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/task_check) 接口查询任务执行状态。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_file.go func (f *file) Delete(ctx context.Context, req *DeleteFileReq, options ...larkcore.RequestOptionFunc) (*DeleteFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -263,13 +263,13 @@ func (f *file) Delete(ctx context.Context, req *DeleteFileReq, options ...larkco // 下载文件 // -// - 使用该接口可以下载在云空间目录下的文件（不含飞书文档/表格/思维导图等在线文档）。支持range下载。 +// - 使用该接口可以下载在云空间目录下的文件（不含飞书文档/表格/思维导图等在线文档）。支持 range 下载。 // -// - 该接口支持调用频率上限为5QPS +// - 该接口支持调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/download +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/download // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/download_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/download_file.go func (f *file) Download(ctx context.Context, req *DownloadFileReq, options ...larkcore.RequestOptionFunc) (*DownloadFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -299,9 +299,9 @@ func (f *file) Download(ctx context.Context, req *DownloadFileReq, options ...la // // - 获取用户云空间中指定文件夹下的文件清单。清单类型包括文件、各种在线文档（文档、电子表格、多维表格、思维笔记）、文件夹和快捷方式。该接口支持分页，但是不会递归的获取子文件夹的清单。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_file.go func (f *file) List(ctx context.Context, req *ListFileReq, options ...larkcore.RequestOptionFunc) (*ListFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -325,9 +325,9 @@ func (f *file) List(ctx context.Context, req *ListFileReq, options ...larkcore.R // // - 将文件或者文件夹移动到用户云空间的其他位置。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/move +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/move // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/move_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/move_file.go func (f *file) Move(ctx context.Context, req *MoveFileReq, options ...larkcore.RequestOptionFunc) (*MoveFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -349,11 +349,11 @@ func (f *file) Move(ctx context.Context, req *MoveFileReq, options ...larkcore.R // 订阅云文档事件 // -// - 该接口仅支持**文档拥有者**订阅自己文档的通知事件，可订阅的文档类型为**旧版文档**、**新版文档**、**电子表格**和**多维表格**。在调用该接口之前请确保正确[配置事件回调网址和订阅事件类型](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#2eb3504a)(暂不支持单独订阅文档维度的某类事件)，事件类型参考[事件列表](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-list)。 +// - 该接口仅支持 ** 文档拥有者 ** 订阅自己文档的通知事件，可订阅的文档类型为 ** 旧版文档 **、** 新版文档 **、** 电子表格 ** 和 ** 多维表格 **。在调用该接口之前请确保正确 [配置事件回调网址和订阅事件类型](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#2eb3504a)(暂不支持单独订阅文档维度的某类事件)，事件类型参考 [事件列表](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-list)。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/subscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/subscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/subscribe_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/subscribe_file.go func (f *file) Subscribe(ctx context.Context, req *SubscribeFileReq, options ...larkcore.RequestOptionFunc) (*SubscribeFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -377,9 +377,9 @@ func (f *file) Subscribe(ctx context.Context, req *SubscribeFileReq, options ... // // - 查询删除文件夹等异步任务的状态信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/task_check +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/task_check // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/taskCheck_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/taskCheck_file.go func (f *file) TaskCheck(ctx context.Context, req *TaskCheckFileReq, options ...larkcore.RequestOptionFunc) (*TaskCheckFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -403,13 +403,13 @@ func (f *file) TaskCheck(ctx context.Context, req *TaskCheckFileReq, options ... // // - 向云空间指定目录下上传一个小文件。 // -// - 请不要使用这个接口上传大于20MB的文件，如果有这个需求可以尝试使用[分片上传接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/multipart-upload-file-/introduction)。 +// - 请不要使用这个接口上传大于 20MB 的文件，如果有这个需求可以尝试使用 [分片上传接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/multipart-upload-file-/introduction)。 // -// - 该接口支持调用频率上限为5QPS +// - 该接口支持调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_all +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_all // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadAll_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadAll_file.go func (f *file) UploadAll(ctx context.Context, req *UploadAllFileReq, options ...larkcore.RequestOptionFunc) (*UploadAllFileResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -434,11 +434,11 @@ func (f *file) UploadAll(ctx context.Context, req *UploadAllFileReq, options ... // // - 触发完成上传。 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_finish +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_finish // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadFinish_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadFinish_file.go func (f *file) UploadFinish(ctx context.Context, req *UploadFinishFileReq, options ...larkcore.RequestOptionFunc) (*UploadFinishFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -462,11 +462,11 @@ func (f *file) UploadFinish(ctx context.Context, req *UploadFinishFileReq, optio // // - 上传对应的文件块。 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_part +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_part // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPart_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPart_file.go func (f *file) UploadPart(ctx context.Context, req *UploadPartFileReq, options ...larkcore.RequestOptionFunc) (*UploadPartFileResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -489,15 +489,15 @@ func (f *file) UploadPart(ctx context.Context, req *UploadPartFileReq, options . // 分片上传文件（预上传） // -// - 发送初始化请求获取上传事务ID和分块策略，目前是以4MB大小进行定长分片。 +// - 发送初始化请求获取上传事务 ID 和分块策略，目前是以 4MB 大小进行定长分片。 // -// - 你在24小时内可保存上传事务ID和上传进度，以便可以恢复上传 +// - 你在 24 小时内可保存上传事务 ID 和上传进度，以便可以恢复上传 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_prepare +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_prepare // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPrepare_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPrepare_file.go func (f *file) UploadPrepare(ctx context.Context, req *UploadPrepareFileReq, options ...larkcore.RequestOptionFunc) (*UploadPrepareFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -521,9 +521,9 @@ func (f *file) UploadPrepare(ctx context.Context, req *UploadPrepareFileReq, opt // // - 往云文档添加一条全局评论。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_fileComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_fileComment.go func (f *fileComment) Create(ctx context.Context, req *CreateFileCommentReq, options ...larkcore.RequestOptionFunc) (*CreateFileCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -547,9 +547,9 @@ func (f *fileComment) Create(ctx context.Context, req *CreateFileCommentReq, opt // // - 获取云文档中的某条评论。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileComment.go func (f *fileComment) Get(ctx context.Context, req *GetFileCommentReq, options ...larkcore.RequestOptionFunc) (*GetFileCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -573,9 +573,9 @@ func (f *fileComment) Get(ctx context.Context, req *GetFileCommentReq, options . // // - 该接口用于根据文档 token 分页获取文档评论。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_fileComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_fileComment.go func (f *fileComment) List(ctx context.Context, req *ListFileCommentReq, options ...larkcore.RequestOptionFunc) (*ListFileCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -607,9 +607,9 @@ func (f *fileComment) ListByIterator(ctx context.Context, req *ListFileCommentRe // // - 解决或恢复云文档中的评论。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/patch_fileComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/patch_fileComment.go func (f *fileComment) Patch(ctx context.Context, req *PatchFileCommentReq, options ...larkcore.RequestOptionFunc) (*PatchFileCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -633,9 +633,9 @@ func (f *fileComment) Patch(ctx context.Context, req *PatchFileCommentReq, optio // // - 删除云文档中的某条回复。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_fileCommentReply.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_fileCommentReply.go func (f *fileCommentReply) Delete(ctx context.Context, req *DeleteFileCommentReplyReq, options ...larkcore.RequestOptionFunc) (*DeleteFileCommentReplyResp, error) { // 发起请求 apiReq := req.apiReq @@ -659,9 +659,9 @@ func (f *fileCommentReply) Delete(ctx context.Context, req *DeleteFileCommentRep // // - 更新云文档中的某条回复。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment-reply/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/update_fileCommentReply.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/update_fileCommentReply.go func (f *fileCommentReply) Update(ctx context.Context, req *UpdateFileCommentReplyReq, options ...larkcore.RequestOptionFunc) (*UpdateFileCommentReplyResp, error) { // 发起请求 apiReq := req.apiReq @@ -685,9 +685,9 @@ func (f *fileCommentReply) Update(ctx context.Context, req *UpdateFileCommentRep // // - 此接口用于获取文件统计信息，包括文档阅读人数、次数和点赞数。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-statistics/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-statistics/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileStatistics.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileStatistics.go func (f *fileStatistics) Get(ctx context.Context, req *GetFileStatisticsReq, options ...larkcore.RequestOptionFunc) (*GetFileStatisticsResp, error) { // 发起请求 apiReq := req.apiReq @@ -709,11 +709,11 @@ func (f *fileStatistics) Get(ctx context.Context, req *GetFileStatisticsReq, opt // 创建订阅 // -// - 订阅文档中的变更事件，当前支持文档评论订阅，订阅后文档评论更新会有“云文档助手”推送给订阅的用户 +// - 订阅文档中的变更事件，当前支持文档评论订阅，订阅后文档评论更新会有 “云文档助手” 推送给订阅的用户 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-subscription/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-subscription/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_fileSubscription.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_fileSubscription.go func (f *fileSubscription) Create(ctx context.Context, req *CreateFileSubscriptionReq, options ...larkcore.RequestOptionFunc) (*CreateFileSubscriptionResp, error) { // 发起请求 apiReq := req.apiReq @@ -735,11 +735,11 @@ func (f *fileSubscription) Create(ctx context.Context, req *CreateFileSubscripti // 获取订阅状态 // -// - 根据订阅ID获取该订阅的状态 +// - 根据订阅 ID 获取该订阅的状态 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-subscription/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-subscription/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileSubscription.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileSubscription.go func (f *fileSubscription) Get(ctx context.Context, req *GetFileSubscriptionReq, options ...larkcore.RequestOptionFunc) (*GetFileSubscriptionResp, error) { // 发起请求 apiReq := req.apiReq @@ -761,11 +761,11 @@ func (f *fileSubscription) Get(ctx context.Context, req *GetFileSubscriptionReq, // 更新订阅状态 // -// - 根据订阅ID更新订阅状态 +// - 根据订阅 ID 更新订阅状态 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-subscription/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-subscription/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/patch_fileSubscription.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/patch_fileSubscription.go func (f *fileSubscription) Patch(ctx context.Context, req *PatchFileSubscriptionReq, options ...larkcore.RequestOptionFunc) (*PatchFileSubscriptionResp, error) { // 发起请求 apiReq := req.apiReq @@ -789,9 +789,9 @@ func (f *fileSubscription) Patch(ctx context.Context, req *PatchFileSubscription // // - 创建文档版本。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_fileVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_fileVersion.go func (f *fileVersion) Create(ctx context.Context, req *CreateFileVersionReq, options ...larkcore.RequestOptionFunc) (*CreateFileVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -815,9 +815,9 @@ func (f *fileVersion) Create(ctx context.Context, req *CreateFileVersionReq, opt // // - 删除文档版本。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_fileVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_fileVersion.go func (f *fileVersion) Delete(ctx context.Context, req *DeleteFileVersionReq, options ...larkcore.RequestOptionFunc) (*DeleteFileVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -841,9 +841,9 @@ func (f *fileVersion) Delete(ctx context.Context, req *DeleteFileVersionReq, opt // // - 获取文档版本。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_fileVersion.go func (f *fileVersion) Get(ctx context.Context, req *GetFileVersionReq, options ...larkcore.RequestOptionFunc) (*GetFileVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -867,9 +867,9 @@ func (f *fileVersion) Get(ctx context.Context, req *GetFileVersionReq, options . // // - 获取文档所有版本。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_fileVersion.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_fileVersion.go func (f *fileVersion) List(ctx context.Context, req *ListFileVersionReq, options ...larkcore.RequestOptionFunc) (*ListFileVersionResp, error) { // 发起请求 apiReq := req.apiReq @@ -899,11 +899,11 @@ func (f *fileVersion) ListByIterator(ctx context.Context, req *ListFileVersionRe // 创建导入任务 // -// - 创建导入任务。支持导入为 doc、docx、sheet、bitable，参考[导入用户指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/import-user-guide) +// - 创建导入任务。支持导入为 doc、docx、sheet、bitable，参考 [导入用户指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/import-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_importTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_importTask.go func (i *importTask) Create(ctx context.Context, req *CreateImportTaskReq, options ...larkcore.RequestOptionFunc) (*CreateImportTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -927,9 +927,9 @@ func (i *importTask) Create(ctx context.Context, req *CreateImportTaskReq, optio // // - 根据创建导入任务返回的 ticket 查询导入结果。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_importTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_importTask.go func (i *importTask) Get(ctx context.Context, req *GetImportTaskReq, options ...larkcore.RequestOptionFunc) (*GetImportTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -951,13 +951,13 @@ func (i *importTask) Get(ctx context.Context, req *GetImportTaskReq, options ... // 获取素材临时下载链接 // -// - 通过file_token获取素材临时下载链接，链接时效性是24小时，过期失效。 +// - 通过 file_token 获取素材临时下载链接，链接时效性是 24 小时，过期失效。 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/batch_get_tmp_download_url +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/batch_get_tmp_download_url // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/batchGetTmpDownloadUrl_media.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/batchGetTmpDownloadUrl_media.go func (m *media) BatchGetTmpDownloadUrl(ctx context.Context, req *BatchGetTmpDownloadUrlMediaReq, options ...larkcore.RequestOptionFunc) (*BatchGetTmpDownloadUrlMediaResp, error) { // 发起请求 apiReq := req.apiReq @@ -979,13 +979,13 @@ func (m *media) BatchGetTmpDownloadUrl(ctx context.Context, req *BatchGetTmpDown // 下载素材 // -// - 使用该接口可以下载素材。素材表示在各种创作容器里的文件，如Doc文档内的图片，文件均属于素材。支持range下载。 +// - 使用该接口可以下载素材。素材表示在各种创作容器里的文件，如 Doc 文档内的图片，文件均属于素材。支持 range 下载。 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/download +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/download // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/download_media.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/download_media.go func (m *media) Download(ctx context.Context, req *DownloadMediaReq, options ...larkcore.RequestOptionFunc) (*DownloadMediaResp, error) { // 发起请求 apiReq := req.apiReq @@ -1015,13 +1015,13 @@ func (m *media) Download(ctx context.Context, req *DownloadMediaReq, options ... // // - 将文件、图片、视频等素材文件上传到指定云文档中。素材文件在云空间中不会显示，只会显示在对应云文档中。 // -// - 请不要使用这个接口上传大于20MB的文件，如果有这个需求可以尝试使用[分片上传接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/multipart-upload-media/introduction)。 +// - 请不要使用这个接口上传大于 20MB 的文件，如果有这个需求可以尝试使用 [分片上传接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/multipart-upload-media/introduction)。 // -// - 该接口支持调用频率上限为5QPS +// - 该接口支持调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadAll_media.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadAll_media.go func (m *media) UploadAll(ctx context.Context, req *UploadAllMediaReq, options ...larkcore.RequestOptionFunc) (*UploadAllMediaResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -1046,11 +1046,11 @@ func (m *media) UploadAll(ctx context.Context, req *UploadAllMediaReq, options . // // - 触发完成上传。 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_finish +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_finish // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadFinish_media.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadFinish_media.go func (m *media) UploadFinish(ctx context.Context, req *UploadFinishMediaReq, options ...larkcore.RequestOptionFunc) (*UploadFinishMediaResp, error) { // 发起请求 apiReq := req.apiReq @@ -1074,11 +1074,11 @@ func (m *media) UploadFinish(ctx context.Context, req *UploadFinishMediaReq, opt // // - 上传对应的文件块。 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_part +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_part // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPart_media.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPart_media.go func (m *media) UploadPart(ctx context.Context, req *UploadPartMediaReq, options ...larkcore.RequestOptionFunc) (*UploadPartMediaResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -1101,15 +1101,15 @@ func (m *media) UploadPart(ctx context.Context, req *UploadPartMediaReq, options // 分片上传素材（预上传） // -// - 发送初始化请求获取上传事务ID和分块策略，目前是以4MB大小进行定长分片。 +// - 发送初始化请求获取上传事务 ID 和分块策略，目前是以 4MB 大小进行定长分片。 // -// - 您在24小时内可保存上传事务ID和上传进度，以便可以恢复上传 +// - 您在 24 小时内可保存上传事务 ID 和上传进度，以便可以恢复上传 // -// - 该接口不支持太高的并发，且调用频率上限为5QPS +// - 该接口不支持太高的并发，且调用频率上限为 5QPS // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_prepare +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_prepare // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPrepare_media.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/uploadPrepare_media.go func (m *media) UploadPrepare(ctx context.Context, req *UploadPrepareMediaReq, options ...larkcore.RequestOptionFunc) (*UploadPrepareMediaResp, error) { // 发起请求 apiReq := req.apiReq @@ -1133,9 +1133,9 @@ func (m *media) UploadPrepare(ctx context.Context, req *UploadPrepareMediaReq, o // // - 该接口用于根据 token 获取各类文件的元数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/meta/batch_query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/meta/batch_query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/batchQuery_meta.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/batchQuery_meta.go func (m *meta) BatchQuery(ctx context.Context, req *BatchQueryMetaReq, options ...larkcore.RequestOptionFunc) (*BatchQueryMetaResp, error) { // 发起请求 apiReq := req.apiReq @@ -1159,9 +1159,9 @@ func (m *meta) BatchQuery(ctx context.Context, req *BatchQueryMetaReq, options . // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=auth&project=drive&resource=permission.member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=auth&project=drive&resource=permission.member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/auth_permissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/auth_permissionMember.go func (p *permissionMember) Auth(ctx context.Context, req *AuthPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*AuthPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1185,9 +1185,9 @@ func (p *permissionMember) Auth(ctx context.Context, req *AuthPermissionMemberRe // // - 该接口用于根据 filetoken 给用户增加文档的权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_permissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/create_permissionMember.go func (p *permissionMember) Create(ctx context.Context, req *CreatePermissionMemberReq, options ...larkcore.RequestOptionFunc) (*CreatePermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1211,9 +1211,9 @@ func (p *permissionMember) Create(ctx context.Context, req *CreatePermissionMemb // // - 该接口用于根据 filetoken 移除文档协作者的权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_permissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/delete_permissionMember.go func (p *permissionMember) Delete(ctx context.Context, req *DeletePermissionMemberReq, options ...larkcore.RequestOptionFunc) (*DeletePermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1239,9 +1239,9 @@ func (p *permissionMember) Delete(ctx context.Context, req *DeletePermissionMemb // // - - 你能获取到协作者列表的前提是你对该文档有分享权限;- 目前仅支持人、群、组织架构三种类型的协作者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_permissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/list_permissionMember.go func (p *permissionMember) List(ctx context.Context, req *ListPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*ListPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1265,9 +1265,9 @@ func (p *permissionMember) List(ctx context.Context, req *ListPermissionMemberRe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=transfer_owner&project=drive&resource=permission.member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=transfer_owner&project=drive&resource=permission.member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/transferOwner_permissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/transferOwner_permissionMember.go func (p *permissionMember) TransferOwner(ctx context.Context, req *TransferOwnerPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*TransferOwnerPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1291,11 +1291,11 @@ func (p *permissionMember) TransferOwner(ctx context.Context, req *TransferOwner // // - 该接口用于根据 filetoken 更新文档协作者的权限。 // -// - 该接口要求文档协作者已存在，如还未对文档协作者授权请先调用[「增加权限」 ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create)接口进行授权。 +// - 该接口要求文档协作者已存在，如还未对文档协作者授权请先调用 [「增加权限」](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create) 接口进行授权。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/update_permissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/update_permissionMember.go func (p *permissionMember) Update(ctx context.Context, req *UpdatePermissionMemberReq, options ...larkcore.RequestOptionFunc) (*UpdatePermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1319,9 +1319,9 @@ func (p *permissionMember) Update(ctx context.Context, req *UpdatePermissionMemb // // - 该接口用于根据 filetoken 获取云文档的权限设置。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_permissionPublic.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/get_permissionPublic.go func (p *permissionPublic) Get(ctx context.Context, req *GetPermissionPublicReq, options ...larkcore.RequestOptionFunc) (*GetPermissionPublicResp, error) { // 发起请求 apiReq := req.apiReq @@ -1345,9 +1345,9 @@ func (p *permissionPublic) Get(ctx context.Context, req *GetPermissionPublicReq, // // - 该接口用于根据 filetoken 更新云文档的权限设置。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/patch_permissionPublic.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/drivev1/patch_permissionPublic.go func (p *permissionPublic) Patch(ctx context.Context, req *PatchPermissionPublicReq, options ...larkcore.RequestOptionFunc) (*PatchPermissionPublicResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/drive/v1/api_ext.go b/service/drive/v1/api_ext.go index 9e7bfed3..728e5066 100644 --- a/service/drive/v1/api_ext.go +++ b/service/drive/v1/api_ext.go @@ -48,7 +48,7 @@ func (iterator *ListFileIterator) Next() (bool, *File, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/drive/v1/event.go b/service/drive/v1/event.go index d6d402bb..55a01bad 100644 --- a/service/drive/v1/event.go +++ b/service/drive/v1/event.go @@ -32,7 +32,7 @@ func (h *P2FileBitableFieldChangedV1Handler) Event() interface{} { return &P2FileBitableFieldChangedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FileBitableFieldChangedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FileBitableFieldChangedV1)) } @@ -52,7 +52,7 @@ func (h *P2FileDeletedV1Handler) Event() interface{} { return &P2FileDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FileDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FileDeletedV1)) } @@ -72,7 +72,7 @@ func (h *P2FileEditV1Handler) Event() interface{} { return &P2FileEditV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FileEditV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FileEditV1)) } @@ -92,7 +92,7 @@ func (h *P2FilePermissionMemberAddedV1Handler) Event() interface{} { return &P2FilePermissionMemberAddedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FilePermissionMemberAddedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FilePermissionMemberAddedV1)) } @@ -112,7 +112,7 @@ func (h *P2FilePermissionMemberRemovedV1Handler) Event() interface{} { return &P2FilePermissionMemberRemovedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FilePermissionMemberRemovedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FilePermissionMemberRemovedV1)) } @@ -132,7 +132,7 @@ func (h *P2FileReadV1Handler) Event() interface{} { return &P2FileReadV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FileReadV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FileReadV1)) } @@ -152,7 +152,7 @@ func (h *P2FileTitleUpdatedV1Handler) Event() interface{} { return &P2FileTitleUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FileTitleUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FileTitleUpdatedV1)) } @@ -172,7 +172,7 @@ func (h *P2FileTrashedV1Handler) Event() interface{} { return &P2FileTrashedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2FileTrashedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2FileTrashedV1)) } diff --git a/service/drive/v1/model.go b/service/drive/v1/model.go index 9e2bb0b5..c6f9762f 100644 --- a/service/drive/v1/model.go +++ b/service/drive/v1/model.go @@ -55,10 +55,10 @@ const ( const ( TypeDeleteFileFile = "file" // 文件类型 - TypeDeleteFileDocx = "docx" // docx文档类型 + TypeDeleteFileDocx = "docx" // docx 文档类型 TypeDeleteFileBitable = "bitable" // 多维表格类型 TypeDeleteFileFolder = "folder" // 文件夹类型 - TypeDeleteFileDoc = "doc" // doc文档类型 + TypeDeleteFileDoc = "doc" // doc 文档类型 TypeDeleteFileSheet = "sheet" // 电子表格类型 TypeDeleteFileMindnote = "mindnote" // 思维笔记类型 TypeDeleteFileShortcut = "shortcut" // 快捷方式类型 @@ -68,7 +68,7 @@ const ( TypeMoveFileFile = "file" // 普通文件类型 TypeMoveFileDocx = "docx" // 新版文档类型 TypeMoveFileBitable = "bitable" // 多维表格类型 - TypeMoveFileDoc = "doc" // doc文档类型 + TypeMoveFileDoc = "doc" // doc 文档类型 TypeMoveFileSheet = "sheet" // 电子表格类型 TypeMoveFileMindnote = "mindnote" // 思维笔记类型 TypeMoveFileFolder = "folder" // 文件夹类型 @@ -76,7 +76,7 @@ const ( const ( FileTypeDoc = "doc" // 文档 - FileTypeDocx = "docx" // docx文档 + FileTypeDocx = "docx" // docx 文档 FileTypeSheet = "sheet" // 表格 FileTypeBitable = "bitable" // 多维表格 ) @@ -95,9 +95,9 @@ const ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -108,9 +108,9 @@ const ( ) const ( - UserIdTypeGetFileCommentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetFileCommentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetFileCommentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetFileCommentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetFileCommentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetFileCommentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -121,9 +121,9 @@ const ( ) const ( - UserIdTypeListFileCommentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListFileCommentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListFileCommentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListFileCommentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListFileCommentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListFileCommentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -148,19 +148,19 @@ const ( ) const ( - UserIdTypeUpdateFileCommentReplyUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateFileCommentReplyUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateFileCommentReplyOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateFileCommentReplyUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateFileCommentReplyUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateFileCommentReplyOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - FileTypeGetFileStatisticsDoc = "doc" // doc文档 + FileTypeGetFileStatisticsDoc = "doc" // doc 文档 FileTypeGetFileStatisticsSheet = "sheet" // 表格 FileTypeGetFileStatisticsMindnote = "mindnote" // 思维笔记 FileTypeGetFileStatisticsBitable = "bitable" // 多维表格 - FileTypeGetFileStatisticsWiki = "wiki" // 知识库wiki + FileTypeGetFileStatisticsWiki = "wiki" // 知识库 wiki FileTypeGetFileStatisticsFile = "file" // 文件 - FileTypeGetFileStatisticsDocx = "docx" // docx文档 + FileTypeGetFileStatisticsDocx = "docx" // docx 文档 ) const ( @@ -169,8 +169,8 @@ const ( const ( FileTypeCreateFileSubscriptionDoc = "doc" // 文档 - FileTypeCreateFileSubscriptionDocx = "docx" // 文档2.0 - FileTypeCreateFileSubscriptionWiki = "wiki" // 知识库wiki + FileTypeCreateFileSubscriptionDocx = "docx" // 文档 2.0 + FileTypeCreateFileSubscriptionWiki = "wiki" // 知识库 wiki ) const ( @@ -179,14 +179,14 @@ const ( const ( FileTypeGetFileSubscriptionDoc = "doc" // 文档 - FileTypeGetFileSubscriptionDocx = "docx" // 文档2.0 - FileTypeGetFileSubscriptionWiki = "wiki" // 知识库wiki + FileTypeGetFileSubscriptionDocx = "docx" // 文档 2.0 + FileTypeGetFileSubscriptionWiki = "wiki" // 知识库 wiki ) const ( - FileTypePatchFileSubscriptionDoc = "doc" // 文档1.0 - FileTypePatchFileSubscriptionDocx = "docx" // 文档2.0 - FileTypePatchFileSubscriptionWiki = "wiki" // 知识库wiki + FileTypePatchFileSubscriptionDoc = "doc" // 文档 1.0 + FileTypePatchFileSubscriptionDocx = "docx" // 文档 2.0 + FileTypePatchFileSubscriptionWiki = "wiki" // 知识库 wiki ) const ( @@ -196,72 +196,72 @@ const ( ) const ( - ObjTypeDoc = "doc" // doc文档 - ObjTypeSheet = "sheet" // sheet文档 - ObjTypeBitable = "bitable" // bitable文档 - ObjTypeDocx = "docx" // docx文档 + ObjTypeDoc = "doc" // doc 文档 + ObjTypeSheet = "sheet" // sheet 文档 + ObjTypeBitable = "bitable" // bitable 文档 + ObjTypeDocx = "docx" // docx 文档 ) const ( - ParentTypeCreateFileVersionDoc = "doc" // doc文档 - ParentTypeCreateFileVersionObjTypeSheet = "sheet" // sheet文档 - ParentTypeCreateFileVersionObjTypeBitable = "bitable" // bitable文档 - ParentTypeCreateFileVersionObjTypeDocx = "docx" // docx文档 + ParentTypeCreateFileVersionDoc = "doc" // doc 文档 + ParentTypeCreateFileVersionObjTypeSheet = "sheet" // sheet 文档 + ParentTypeCreateFileVersionObjTypeBitable = "bitable" // bitable 文档 + ParentTypeCreateFileVersionObjTypeDocx = "docx" // docx 文档 ) const ( - UserIdTypeCreateFileVersionUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateFileVersionUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateFileVersionOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateFileVersionUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateFileVersionUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateFileVersionOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - ObjTypeDeleteFileVersionDoc = "doc" // doc文档 - ObjTypeDeleteFileVersionSheet = "sheet" // sheet文档 - ObjTypeDeleteFileVersionBitable = "bitable" // bitable文档 - ObjTypeDeleteFileVersionDocx = "docx" // docx文档 + ObjTypeDeleteFileVersionDoc = "doc" // doc 文档 + ObjTypeDeleteFileVersionSheet = "sheet" // sheet 文档 + ObjTypeDeleteFileVersionBitable = "bitable" // bitable 文档 + ObjTypeDeleteFileVersionDocx = "docx" // docx 文档 ) const ( - UserIdTypeDeleteFileVersionOpenId = "open_id" // 用户open_id - UserIdTypeDeleteFileVersionUnionId = "union_id" // 用户union_id - UserIdTypeDeleteFileVersionUserId = "user_id" // 用户user_id + UserIdTypeDeleteFileVersionOpenId = "open_id" // 用户 open_id + UserIdTypeDeleteFileVersionUnionId = "union_id" // 用户 union_id + UserIdTypeDeleteFileVersionUserId = "user_id" // 用户 user_id ) const ( - ObjTypeGetFileVersionDoc = "doc" // doc文档 - ObjTypeGetFileVersionSheet = "sheet" // sheet文档 - ObjTypeGetFileVersionBitable = "bitable" // bitable文档 - ObjTypeGetFileVersionDocx = "docx" // docx文档 + ObjTypeGetFileVersionDoc = "doc" // doc 文档 + ObjTypeGetFileVersionSheet = "sheet" // sheet 文档 + ObjTypeGetFileVersionBitable = "bitable" // bitable 文档 + ObjTypeGetFileVersionDocx = "docx" // docx 文档 ) const ( - UserIdTypeGetFileVersionOpenId = "open_id" // 用户open_id - UserIdTypeGetFileVersionUnionId = "union_id" // 用户union_id - UserIdTypeGetFileVersionUserId = "user_id" // 用户user_id + UserIdTypeGetFileVersionOpenId = "open_id" // 用户 open_id + UserIdTypeGetFileVersionUnionId = "union_id" // 用户 union_id + UserIdTypeGetFileVersionUserId = "user_id" // 用户 user_id ) const ( - ObjTypeListFileVersionDoc = "doc" // doc文档 - ObjTypeListFileVersionSheet = "sheet" // sheet文档 - ObjTypeListFileVersionBitable = "bitable" // bitable文档 - ObjTypeListFileVersionDocx = "docx" // docx文档 + ObjTypeListFileVersionDoc = "doc" // doc 文档 + ObjTypeListFileVersionSheet = "sheet" // sheet 文档 + ObjTypeListFileVersionBitable = "bitable" // bitable 文档 + ObjTypeListFileVersionDocx = "docx" // docx 文档 ) const ( - UserIdTypeListFileVersionOpenId = "open_id" // 用户open_id - UserIdTypeListFileVersionUnionId = "union_id" // 用户union_id - UserIdTypeListFileVersionUserId = "user_id" // 用户user_id + UserIdTypeListFileVersionOpenId = "open_id" // 用户 open_id + UserIdTypeListFileVersionUnionId = "union_id" // 用户 union_id + UserIdTypeListFileVersionUserId = "user_id" // 用户 user_id ) const ( - ParentTypeUploadAllMediaDocImage = "doc_image" // docs图片 - ParentTypeUploadAllMediaDocxImage = "docx_image" // docx图片 - ParentTypeUploadAllMediaSheetImage = "sheet_image" // sheet图片 - ParentTypeUploadAllMediaDocFile = "doc_file" // doc文件 - ParentTypeUploadAllMediaDocxFile = "docx_file" // docx文件 - ParentTypeUploadAllMediaSheetFile = "sheet_file" // sheet文件 - ParentTypeUploadAllMediaVcVirtualBackground = "vc_virtual_background" // vc虚拟背景 + ParentTypeUploadAllMediaDocImage = "doc_image" // docs 图片 + ParentTypeUploadAllMediaDocxImage = "docx_image" // docx 图片 + ParentTypeUploadAllMediaSheetImage = "sheet_image" // sheet 图片 + ParentTypeUploadAllMediaDocFile = "doc_file" // doc 文件 + ParentTypeUploadAllMediaDocxFile = "docx_file" // docx 文件 + ParentTypeUploadAllMediaSheetFile = "sheet_file" // sheet 文件 + ParentTypeUploadAllMediaVcVirtualBackground = "vc_virtual_background" // vc 虚拟背景 ParentTypeUploadAllMediaBitableImage = "bitable_image" // 多维表格图片 ParentTypeUploadAllMediaBitableFile = "bitable_file" // 多维表格文件 ParentTypeUploadAllMediaMoments = "moments" // 同事圈 @@ -269,23 +269,23 @@ const ( ) const ( - ParentTypeUploadPrepareMediaDocImage = "doc_image" // docs图片 - ParentTypeUploadPrepareMediaDocxImage = "docx_image" // docx图片 - ParentTypeUploadPrepareMediaSheetImage = "sheet_image" // sheet图片 - ParentTypeUploadPrepareMediaDocFile = "doc_file" // doc文件 - ParentTypeUploadPrepareMediaDocxFile = "docx_file" // docx文件 - ParentTypeUploadPrepareMediaSheetFile = "sheet_file" // sheet文件 - ParentTypeUploadPrepareMediaVcVirtualBackground = "vc_virtual_background" // vc虚拟背景 - ParentTypeUploadPrepareMediaBitableImage = "bitable_image" // bitable图片 - ParentTypeUploadPrepareMediaBitableFile = "bitable_file" // bitable文件 + ParentTypeUploadPrepareMediaDocImage = "doc_image" // docs 图片 + ParentTypeUploadPrepareMediaDocxImage = "docx_image" // docx 图片 + ParentTypeUploadPrepareMediaSheetImage = "sheet_image" // sheet 图片 + ParentTypeUploadPrepareMediaDocFile = "doc_file" // doc 文件 + ParentTypeUploadPrepareMediaDocxFile = "docx_file" // docx 文件 + ParentTypeUploadPrepareMediaSheetFile = "sheet_file" // sheet 文件 + ParentTypeUploadPrepareMediaVcVirtualBackground = "vc_virtual_background" // vc 虚拟背景 + ParentTypeUploadPrepareMediaBitableImage = "bitable_image" // bitable 图片 + ParentTypeUploadPrepareMediaBitableFile = "bitable_file" // bitable 文件 ParentTypeUploadPrepareMediaMoments = "moments" // 同事圈 ParentTypeUploadPrepareMediaCcmImportOpen = "ccm_import_open" // 云文档导入文件 ) const ( - UserIdTypeBatchQueryMetaUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchQueryMetaUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchQueryMetaOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchQueryMetaUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchQueryMetaUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchQueryMetaOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -311,10 +311,10 @@ const ( const ( MemberTypeEmail = "email" // 飞书邮箱 - MemberTypeOpenId = "openid" // 开放平台ID - MemberTypeOpenChat = "openchat" // 开放平台群组ID - MemberTypeOpenDepartmentId = "opendepartmentid" // 开放平台部门ID - MemberTypeUserId = "userid" // 用户自定义ID + MemberTypeOpenId = "openid" // 开放平台 ID + MemberTypeOpenChat = "openchat" // 开放平台群组 ID + MemberTypeOpenDepartmentId = "opendepartmentid" // 开放平台部门 ID + MemberTypeUserId = "userid" // 用户自定义 ID ) const ( @@ -349,10 +349,10 @@ const ( const ( MemberTypeDeletePermissionMemberEmail = "email" // 邮箱地址 - MemberTypeDeletePermissionMemberOpenID = "openid" // 开放平台ID - MemberTypeDeletePermissionMemberOpenChatID = "openchat" // 开放平台群ID - MemberTypeDeletePermissionMemberOpenDepartmentID = "opendepartmentid" // 开放平台部门ID - MemberTypeDeletePermissionMemberUserID = "userid" // 自定义用户ID + MemberTypeDeletePermissionMemberOpenID = "openid" // 开放平台 ID + MemberTypeDeletePermissionMemberOpenChatID = "openchat" // 开放平台群 ID + MemberTypeDeletePermissionMemberOpenDepartmentID = "opendepartmentid" // 开放平台部门 ID + MemberTypeDeletePermissionMemberUserID = "userid" // 自定义用户 ID ) const ( @@ -368,8 +368,8 @@ const ( const ( MemberTypeTransferOwnerPermissionMemberEmail = "email" // 飞书邮箱 - MemberTypeTransferOwnerPermissionMemberOpenId = "openid" // 开放平台ID - MemberTypeTransferOwnerPermissionMemberUserId = "userid" // 用户自定义ID + MemberTypeTransferOwnerPermissionMemberOpenId = "openid" // 开放平台 ID + MemberTypeTransferOwnerPermissionMemberUserId = "userid" // 用户自定义 ID ) const ( @@ -385,10 +385,10 @@ const ( const ( MemberTypeUpdatePermissionMemberEmail = "email" // 飞书邮箱 - MemberTypeUpdatePermissionMemberOpenId = "openid" // 开放平台ID - MemberTypeUpdatePermissionMemberOpenChat = "openchat" // 开放平台群组ID - MemberTypeUpdatePermissionMemberOpenDepartmentId = "opendepartmentid" // 开放平台部门ID - MemberTypeUpdatePermissionMemberUserId = "userid" // 用户自定义ID + MemberTypeUpdatePermissionMemberOpenId = "openid" // 开放平台 ID + MemberTypeUpdatePermissionMemberOpenChat = "openchat" // 开放平台群组 ID + MemberTypeUpdatePermissionMemberOpenDepartmentId = "opendepartmentid" // 开放平台部门 ID + MemberTypeUpdatePermissionMemberUserId = "userid" // 用户自定义 ID ) const ( @@ -439,8 +439,8 @@ const ( const ( LinkShareEntityTenantReadable = "tenant_readable" // 组织内获得链接的人可阅读 LinkShareEntityTenantEditable = "tenant_editable" // 组织内获得链接的人可编辑 - LinkShareEntityAnyoneReadable = "anyone_readable" // 互联网上获得链接的任何人可阅读（仅external_access=“true”时有效） - LinkShareEntityAnyoneEditable = "anyone_editable" // 互联网上获得链接的任何人可编辑（仅external_access=“true”时有效） + LinkShareEntityAnyoneReadable = "anyone_readable" // 互联网上获得链接的任何人可阅读（仅 external_access=“true” 时有效） + LinkShareEntityAnyoneEditable = "anyone_editable" // 互联网上获得链接的任何人可编辑（仅 external_access=“true” 时有效） LinkShareEntityClosed = "closed" // 关闭链接分享 ) @@ -745,11 +745,11 @@ type BitableTableFieldActionValueProperty struct { DateFormatter *string `json:"date_formatter,omitempty"` // 日期、创建时间、最后更新时间字段的显示格式 AutoFill *bool `json:"auto_fill,omitempty"` // 日期字段中新纪录自动填写创建时间 Multiple *bool `json:"multiple,omitempty"` // 人员字段中允许添加多个成员，单向关联、双向关联中允许添加多个记录 - TableId *string `json:"table_id,omitempty"` // 单向关联、双向关联字段中关联的数据表的ID + TableId *string `json:"table_id,omitempty"` // 单向关联、双向关联字段中关联的数据表的 ID TableName *string `json:"table_name,omitempty"` // 单向关联、双向关联字段中关联的数据表的名字 BackFieldName *string `json:"back_field_name,omitempty"` // 双向关联字段中关联的数据表中对应的双向关联字段的名字 InputType *string `json:"input_type,omitempty"` // 地理位置输入限制 - BackFieldId *string `json:"back_field_id,omitempty"` // 双向关联字段中关联的数据表中对应的双向关联字段的id + BackFieldId *string `json:"back_field_id,omitempty"` // 双向关联字段中关联的数据表中对应的双向关联字段的 id AutoSerial *BitableTableFieldActionValuePropertyAutoSerial `json:"auto_serial,omitempty"` // 自动编号类型 Options []*BitableTableFieldActionValuePropertyOption `json:"options,omitempty"` // 单选、多选字段的选项信息 FormulaExpression *string `json:"formula_expression,omitempty"` // 公式字段的公式表达式 @@ -764,7 +764,7 @@ type BitableTableFieldActionValuePropertyBuilder struct { autoFillFlag bool multiple bool // 人员字段中允许添加多个成员，单向关联、双向关联中允许添加多个记录 multipleFlag bool - tableId string // 单向关联、双向关联字段中关联的数据表的ID + tableId string // 单向关联、双向关联字段中关联的数据表的 ID tableIdFlag bool tableName string // 单向关联、双向关联字段中关联的数据表的名字 tableNameFlag bool @@ -772,7 +772,7 @@ type BitableTableFieldActionValuePropertyBuilder struct { backFieldNameFlag bool inputType string // 地理位置输入限制 inputTypeFlag bool - backFieldId string // 双向关联字段中关联的数据表中对应的双向关联字段的id + backFieldId string // 双向关联字段中关联的数据表中对应的双向关联字段的 id backFieldIdFlag bool autoSerial *BitableTableFieldActionValuePropertyAutoSerial // 自动编号类型 autoSerialFlag bool @@ -823,7 +823,7 @@ func (builder *BitableTableFieldActionValuePropertyBuilder) Multiple(multiple bo return builder } -// 单向关联、双向关联字段中关联的数据表的ID +// 单向关联、双向关联字段中关联的数据表的 ID // // 示例值：tblIniLz0Ic8oXyN func (builder *BitableTableFieldActionValuePropertyBuilder) TableId(tableId string) *BitableTableFieldActionValuePropertyBuilder { @@ -859,7 +859,7 @@ func (builder *BitableTableFieldActionValuePropertyBuilder) InputType(inputType return builder } -// 双向关联字段中关联的数据表中对应的双向关联字段的id +// 双向关联字段中关联的数据表中对应的双向关联字段的 id // // 示例值：fldmj5qNii func (builder *BitableTableFieldActionValuePropertyBuilder) BackFieldId(backFieldId string) *BitableTableFieldActionValuePropertyBuilder { @@ -1043,14 +1043,14 @@ func (builder *BitableTableFieldActionValuePropertyAutoSerialOptionsBuilder) Bui type BitableTableFieldActionValuePropertyOption struct { Name *string `json:"name,omitempty"` // 选项名 - Id *string `json:"id,omitempty"` // 选项ID + Id *string `json:"id,omitempty"` // 选项 ID Color *int `json:"color,omitempty"` // 选项颜色 } type BitableTableFieldActionValuePropertyOptionBuilder struct { name string // 选项名 nameFlag bool - id string // 选项ID + id string // 选项 ID idFlag bool color int // 选项颜色 colorFlag bool @@ -1070,7 +1070,7 @@ func (builder *BitableTableFieldActionValuePropertyOptionBuilder) Name(name stri return builder } -// 选项ID +// 选项 ID // // 示例值：optabcef func (builder *BitableTableFieldActionValuePropertyOptionBuilder) Id(id string) *BitableTableFieldActionValuePropertyOptionBuilder { @@ -1278,20 +1278,20 @@ func (builder *BitableTableRecordActionFieldIdentityBuilder) Build() *BitableTab } type BitableTableRecordActionFieldIdentityUser struct { - UserId *UserId `json:"user_id,omitempty"` // 用户ID + UserId *UserId `json:"user_id,omitempty"` // 用户 ID Name *string `json:"name,omitempty"` // 用户名称 EnName *string `json:"en_name,omitempty"` // 用户英文名称 - AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像URL + AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像 URL } type BitableTableRecordActionFieldIdentityUserBuilder struct { - userId *UserId // 用户ID + userId *UserId // 用户 ID userIdFlag bool name string // 用户名称 nameFlag bool enName string // 用户英文名称 enNameFlag bool - avatarUrl string // 用户头像URL + avatarUrl string // 用户头像 URL avatarUrlFlag bool } @@ -1300,7 +1300,7 @@ func NewBitableTableRecordActionFieldIdentityUserBuilder() *BitableTableRecordAc return builder } -// 用户ID +// 用户 ID // // 示例值： func (builder *BitableTableRecordActionFieldIdentityUserBuilder) UserId(userId *UserId) *BitableTableRecordActionFieldIdentityUserBuilder { @@ -1327,7 +1327,7 @@ func (builder *BitableTableRecordActionFieldIdentityUserBuilder) EnName(enName s return builder } -// 用户头像URL +// 用户头像 URL // // 示例值： func (builder *BitableTableRecordActionFieldIdentityUserBuilder) AvatarUrl(avatarUrl string) *BitableTableRecordActionFieldIdentityUserBuilder { @@ -1358,19 +1358,19 @@ func (builder *BitableTableRecordActionFieldIdentityUserBuilder) Build() *Bitabl type Collaborator struct { MemberType *string `json:"member_type,omitempty"` // 协作者类型 "user" or "chat" - MemberOpenId *string `json:"member_open_id,omitempty"` // 协作者openid - MemberUserId *string `json:"member_user_id,omitempty"` // 协作者userid(仅当member_type="user"时有效) - Perm *string `json:"perm,omitempty"` // 协作者权限 (注意: **有"edit"权限的协作者一定有"view"权限**) + MemberOpenId *string `json:"member_open_id,omitempty"` // 协作者 openid + MemberUserId *string `json:"member_user_id,omitempty"` // 协作者 userid(仅当 member_type="user"时有效) + Perm *string `json:"perm,omitempty"` // 协作者权限 (注意: ** 有"edit"权限的协作者一定有"view"权限 **) } type CollaboratorBuilder struct { memberType string // 协作者类型 "user" or "chat" memberTypeFlag bool - memberOpenId string // 协作者openid + memberOpenId string // 协作者 openid memberOpenIdFlag bool - memberUserId string // 协作者userid(仅当member_type="user"时有效) + memberUserId string // 协作者 userid(仅当 member_type="user"时有效) memberUserIdFlag bool - perm string // 协作者权限 (注意: **有"edit"权限的协作者一定有"view"权限**) + perm string // 协作者权限 (注意: ** 有"edit"权限的协作者一定有"view"权限 **) permFlag bool } @@ -1388,7 +1388,7 @@ func (builder *CollaboratorBuilder) MemberType(memberType string) *CollaboratorB return builder } -// 协作者openid +// 协作者 openid // // 示例值：ou_65b0affcc6c342a50e4c66f700137b64 func (builder *CollaboratorBuilder) MemberOpenId(memberOpenId string) *CollaboratorBuilder { @@ -1397,7 +1397,7 @@ func (builder *CollaboratorBuilder) MemberOpenId(memberOpenId string) *Collabora return builder } -// 协作者userid(仅当member_type="user"时有效) +// 协作者 userid(仅当 member_type="user"时有效) // // 示例值：96g3c421 func (builder *CollaboratorBuilder) MemberUserId(memberUserId string) *CollaboratorBuilder { @@ -1406,7 +1406,7 @@ func (builder *CollaboratorBuilder) MemberUserId(memberUserId string) *Collabora return builder } -// 协作者权限 (注意: **有"edit"权限的协作者一定有"view"权限**) +// 协作者权限 (注意: ** 有"edit"权限的协作者一定有"view"权限 **) // // 示例值：view func (builder *CollaboratorBuilder) Perm(perm string) *CollaboratorBuilder { @@ -1437,11 +1437,11 @@ func (builder *CollaboratorBuilder) Build() *Collaborator { } type DocsLink struct { - Url *string `json:"url,omitempty"` // 回复 at云文档 + Url *string `json:"url,omitempty"` // 回复 at 云文档 } type DocsLinkBuilder struct { - url string // 回复 at云文档 + url string // 回复 at 云文档 urlFlag bool } @@ -1450,7 +1450,7 @@ func NewDocsLinkBuilder() *DocsLinkBuilder { return builder } -// 回复 at云文档 +// 回复 at 云文档 // // 示例值：https://bytedance.feishu.cn/docs/doccnHh7U87HOFpii5u5Gabcef func (builder *DocsLinkBuilder) Url(url string) *DocsLinkBuilder { @@ -1473,7 +1473,7 @@ type ExportTask struct { Token *string `json:"token,omitempty"` // 导出文档 token [获取文档 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) Type *string `json:"type,omitempty"` // 导出文档类型 [文档类型说明](/ssl::ttdoc/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#560bf735) FileName *string `json:"file_name,omitempty"` // 导出文件名 - SubId *string `json:"sub_id,omitempty"` // 导出子表ID，仅当将电子表格/多维表格导出为 csv 时使用;;;[获取电子表格子表ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 文档中的 sheet_id;;[获取多维表格子表ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list) 文档中的 table_id + SubId *string `json:"sub_id,omitempty"` // 导出子表 ID，仅当将电子表格/多维表格导出为 csv 时使用;;;[获取电子表格子表 ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 文档中的 sheet_id;;[获取多维表格子表 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list) 文档中的 table_id FileToken *string `json:"file_token,omitempty"` // 导出文件 drive token FileSize *int `json:"file_size,omitempty"` // 导出文件大小，单位字节 JobErrorMsg *string `json:"job_error_msg,omitempty"` // 任务失败原因 @@ -1489,7 +1489,7 @@ type ExportTaskBuilder struct { typeFlag bool fileName string // 导出文件名 fileNameFlag bool - subId string // 导出子表ID，仅当将电子表格/多维表格导出为 csv 时使用;;;[获取电子表格子表ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 文档中的 sheet_id;;[获取多维表格子表ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list) 文档中的 table_id + subId string // 导出子表 ID，仅当将电子表格/多维表格导出为 csv 时使用;;;[获取电子表格子表 ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 文档中的 sheet_id;;[获取多维表格子表 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list) 文档中的 table_id subIdFlag bool fileToken string // 导出文件 drive token fileTokenFlag bool @@ -1542,7 +1542,7 @@ func (builder *ExportTaskBuilder) FileName(fileName string) *ExportTaskBuilder { return builder } -// 导出子表ID，仅当将电子表格/多维表格导出为 csv 时使用;;;[获取电子表格子表ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 文档中的 sheet_id;;[获取多维表格子表ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list) 文档中的 table_id +// 导出子表 ID，仅当将电子表格/多维表格导出为 csv 时使用;;;[获取电子表格子表 ID](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 文档中的 sheet_id;;[获取多维表格子表 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list) 文档中的 table_id // // 示例值：tblKz5D60T4JlfcT func (builder *ExportTaskBuilder) SubId(subId string) *ExportTaskBuilder { @@ -1740,13 +1740,13 @@ func (builder *FileBuilder) Build() *File { } type FileComment struct { - CommentId *string `json:"comment_id,omitempty"` // 评论ID（创建新评论可不填；如填写，则视为回复已有评论） - UserId *string `json:"user_id,omitempty"` // 用户ID + CommentId *string `json:"comment_id,omitempty"` // 评论 ID（创建新评论可不填；如填写，则视为回复已有评论） + UserId *string `json:"user_id,omitempty"` // 用户 ID CreateTime *int `json:"create_time,omitempty"` // 创建时间 UpdateTime *int `json:"update_time,omitempty"` // 更新时间 IsSolved *bool `json:"is_solved,omitempty"` // 是否已解决 SolvedTime *int `json:"solved_time,omitempty"` // 解决评论时间 - SolverUserId *string `json:"solver_user_id,omitempty"` // 解决评论者的用户ID + SolverUserId *string `json:"solver_user_id,omitempty"` // 解决评论者的用户 ID HasMore *bool `json:"has_more,omitempty"` // 是否有更多回复 PageToken *string `json:"page_token,omitempty"` // 回复分页标记 IsWhole *bool `json:"is_whole,omitempty"` // 是否是全文评论 @@ -1755,9 +1755,9 @@ type FileComment struct { } type FileCommentBuilder struct { - commentId string // 评论ID（创建新评论可不填；如填写，则视为回复已有评论） + commentId string // 评论 ID（创建新评论可不填；如填写，则视为回复已有评论） commentIdFlag bool - userId string // 用户ID + userId string // 用户 ID userIdFlag bool createTime int // 创建时间 createTimeFlag bool @@ -1767,7 +1767,7 @@ type FileCommentBuilder struct { isSolvedFlag bool solvedTime int // 解决评论时间 solvedTimeFlag bool - solverUserId string // 解决评论者的用户ID + solverUserId string // 解决评论者的用户 ID solverUserIdFlag bool hasMore bool // 是否有更多回复 hasMoreFlag bool @@ -1786,7 +1786,7 @@ func NewFileCommentBuilder() *FileCommentBuilder { return builder } -// 评论ID（创建新评论可不填；如填写，则视为回复已有评论） +// 评论 ID（创建新评论可不填；如填写，则视为回复已有评论） // // 示例值：6916106822734512356 func (builder *FileCommentBuilder) CommentId(commentId string) *FileCommentBuilder { @@ -1795,7 +1795,7 @@ func (builder *FileCommentBuilder) CommentId(commentId string) *FileCommentBuild return builder } -// 用户ID +// 用户 ID // // 示例值：ou_cc19b2bfb93f8a44db4b4d6eababcef func (builder *FileCommentBuilder) UserId(userId string) *FileCommentBuilder { @@ -1840,7 +1840,7 @@ func (builder *FileCommentBuilder) SolvedTime(solvedTime int) *FileCommentBuilde return builder } -// 解决评论者的用户ID +// 解决评论者的用户 ID // // 示例值：null func (builder *FileCommentBuilder) SolverUserId(solverUserId string) *FileCommentBuilder { @@ -1947,18 +1947,18 @@ func (builder *FileCommentBuilder) Build() *FileComment { } type FileCommentReply struct { - ReplyId *string `json:"reply_id,omitempty"` // 回复ID - UserId *string `json:"user_id,omitempty"` // 用户ID + ReplyId *string `json:"reply_id,omitempty"` // 回复 ID + UserId *string `json:"user_id,omitempty"` // 用户 ID CreateTime *int `json:"create_time,omitempty"` // 创建时间 UpdateTime *int `json:"update_time,omitempty"` // 更新时间 Content *ReplyContent `json:"content,omitempty"` // 回复内容 - Extra *ReplyExtra `json:"extra,omitempty"` // 回复的其他内容，图片token等 + Extra *ReplyExtra `json:"extra,omitempty"` // 回复的其他内容，图片 token 等 } type FileCommentReplyBuilder struct { - replyId string // 回复ID + replyId string // 回复 ID replyIdFlag bool - userId string // 用户ID + userId string // 用户 ID userIdFlag bool createTime int // 创建时间 createTimeFlag bool @@ -1966,7 +1966,7 @@ type FileCommentReplyBuilder struct { updateTimeFlag bool content *ReplyContent // 回复内容 contentFlag bool - extra *ReplyExtra // 回复的其他内容，图片token等 + extra *ReplyExtra // 回复的其他内容，图片 token 等 extraFlag bool } @@ -1975,7 +1975,7 @@ func NewFileCommentReplyBuilder() *FileCommentReplyBuilder { return builder } -// 回复ID +// 回复 ID // // 示例值：6916106822734512356 func (builder *FileCommentReplyBuilder) ReplyId(replyId string) *FileCommentReplyBuilder { @@ -1984,7 +1984,7 @@ func (builder *FileCommentReplyBuilder) ReplyId(replyId string) *FileCommentRepl return builder } -// 用户ID +// 用户 ID // // 示例值：ou_cc19b2bfb93f8a44db4b4d6eab2abcef func (builder *FileCommentReplyBuilder) UserId(userId string) *FileCommentReplyBuilder { @@ -2020,7 +2020,7 @@ func (builder *FileCommentReplyBuilder) Content(content *ReplyContent) *FileComm return builder } -// 回复的其他内容，图片token等 +// 回复的其他内容，图片 token 等 // // 示例值： func (builder *FileCommentReplyBuilder) Extra(extra *ReplyExtra) *FileCommentReplyBuilder { @@ -2057,14 +2057,14 @@ func (builder *FileCommentReplyBuilder) Build() *FileCommentReply { } type FileSubscription struct { - SubscriptionId *string `json:"subscription_id,omitempty"` // 订阅关系ID + SubscriptionId *string `json:"subscription_id,omitempty"` // 订阅关系 ID SubscriptionType *string `json:"subscription_type,omitempty"` // 订阅类型 IsSubcribe *bool `json:"is_subcribe,omitempty"` // 是否订阅 FileType *string `json:"file_type,omitempty"` // 文档类型 } type FileSubscriptionBuilder struct { - subscriptionId string // 订阅关系ID + subscriptionId string // 订阅关系 ID subscriptionIdFlag bool subscriptionType string // 订阅类型 subscriptionTypeFlag bool @@ -2079,7 +2079,7 @@ func NewFileSubscriptionBuilder() *FileSubscriptionBuilder { return builder } -// 订阅关系ID +// 订阅关系 ID // // 示例值：1234567890987654321 func (builder *FileSubscriptionBuilder) SubscriptionId(subscriptionId string) *FileSubscriptionBuilder { @@ -2137,14 +2137,14 @@ func (builder *FileSubscriptionBuilder) Build() *FileSubscription { } type FileSearch struct { - DocsToken *string `json:"docs_token,omitempty"` // 文档token + DocsToken *string `json:"docs_token,omitempty"` // 文档 token DocsType *string `json:"docs_type,omitempty"` // 文档类型 Title *string `json:"title,omitempty"` // 标题 OwnerId *string `json:"owner_id,omitempty"` // 文件所有者 } type FileSearchBuilder struct { - docsToken string // 文档token + docsToken string // 文档 token docsTokenFlag bool docsType string // 文档类型 docsTypeFlag bool @@ -2159,7 +2159,7 @@ func NewFileSearchBuilder() *FileSearchBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doxbcxcAgzUTcPI5xR7c6nGJDGc func (builder *FileSearchBuilder) DocsToken(docsToken string) *FileSearchBuilder { @@ -2299,7 +2299,7 @@ func (builder *FileStatisticsBuilder) Build() *FileStatistics { type FileUploadInfo struct { FileName *string `json:"file_name,omitempty"` // 文件名 ParentType *string `json:"parent_type,omitempty"` // 上传点类型 - ParentNode *string `json:"parent_node,omitempty"` // 文件夹的token + ParentNode *string `json:"parent_node,omitempty"` // 文件夹的 token Size *int `json:"size,omitempty"` // 文件大小 } @@ -2308,7 +2308,7 @@ type FileUploadInfoBuilder struct { fileNameFlag bool parentType string // 上传点类型 parentTypeFlag bool - parentNode string // 文件夹的token + parentNode string // 文件夹的 token parentNodeFlag bool size int // 文件大小 sizeFlag bool @@ -2337,7 +2337,7 @@ func (builder *FileUploadInfoBuilder) ParentType(parentType string) *FileUploadI return builder } -// 文件夹的token +// 文件夹的 token // // 示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *FileUploadInfoBuilder) ParentNode(parentNode string) *FileUploadInfoBuilder { @@ -2377,29 +2377,29 @@ func (builder *FileUploadInfoBuilder) Build() *FileUploadInfo { } type ImportTask struct { - Ticket *string `json:"ticket,omitempty"` // 任务ID + Ticket *string `json:"ticket,omitempty"` // 任务 ID FileExtension *string `json:"file_extension,omitempty"` // 导入文件格式后缀 - FileToken *string `json:"file_token,omitempty"` // 导入文件Drive FileToken + FileToken *string `json:"file_token,omitempty"` // 导入文件 Drive FileToken Type *string `json:"type,omitempty"` // 导入目标云文档格式 - FileName *string `json:"file_name,omitempty"` // 导入目标云文档文件名 ，若为空使用Drive文件名 + FileName *string `json:"file_name,omitempty"` // 导入目标云文档文件名 ，若为空使用 Drive 文件名 Point *ImportTaskMountPoint `json:"point,omitempty"` // 挂载点 JobStatus *int `json:"job_status,omitempty"` // 任务状态 JobErrorMsg *string `json:"job_error_msg,omitempty"` // 任务失败原因 - Token *string `json:"token,omitempty"` // 导入云文档Token - Url *string `json:"url,omitempty"` // 导入云文档URL + Token *string `json:"token,omitempty"` // 导入云文档 Token + Url *string `json:"url,omitempty"` // 导入云文档 URL Extra []string `json:"extra,omitempty"` // 任务成功后的提示信息 } type ImportTaskBuilder struct { - ticket string // 任务ID + ticket string // 任务 ID ticketFlag bool fileExtension string // 导入文件格式后缀 fileExtensionFlag bool - fileToken string // 导入文件Drive FileToken + fileToken string // 导入文件 Drive FileToken fileTokenFlag bool type_ string // 导入目标云文档格式 typeFlag bool - fileName string // 导入目标云文档文件名 ，若为空使用Drive文件名 + fileName string // 导入目标云文档文件名 ，若为空使用 Drive 文件名 fileNameFlag bool point *ImportTaskMountPoint // 挂载点 pointFlag bool @@ -2407,9 +2407,9 @@ type ImportTaskBuilder struct { jobStatusFlag bool jobErrorMsg string // 任务失败原因 jobErrorMsgFlag bool - token string // 导入云文档Token + token string // 导入云文档 Token tokenFlag bool - url string // 导入云文档URL + url string // 导入云文档 URL urlFlag bool extra []string // 任务成功后的提示信息 extraFlag bool @@ -2420,7 +2420,7 @@ func NewImportTaskBuilder() *ImportTaskBuilder { return builder } -// 任务ID +// 任务 ID // // 示例值：6990281865xxxxxxxx7843 func (builder *ImportTaskBuilder) Ticket(ticket string) *ImportTaskBuilder { @@ -2438,7 +2438,7 @@ func (builder *ImportTaskBuilder) FileExtension(fileExtension string) *ImportTas return builder } -// 导入文件Drive FileToken +// 导入文件 Drive FileToken // // 示例值：boxcnxe5OxxxxxxxSNdsJviENsk func (builder *ImportTaskBuilder) FileToken(fileToken string) *ImportTaskBuilder { @@ -2456,7 +2456,7 @@ func (builder *ImportTaskBuilder) Type(type_ string) *ImportTaskBuilder { return builder } -// 导入目标云文档文件名 ，若为空使用Drive文件名 +// 导入目标云文档文件名 ，若为空使用 Drive 文件名 // // 示例值：test func (builder *ImportTaskBuilder) FileName(fileName string) *ImportTaskBuilder { @@ -2492,7 +2492,7 @@ func (builder *ImportTaskBuilder) JobErrorMsg(jobErrorMsg string) *ImportTaskBui return builder } -// 导入云文档Token +// 导入云文档 Token // // 示例值：shtcnVBTG6SuxxxxxxxkM2tUX func (builder *ImportTaskBuilder) Token(token string) *ImportTaskBuilder { @@ -2501,7 +2501,7 @@ func (builder *ImportTaskBuilder) Token(token string) *ImportTaskBuilder { return builder } -// 导入云文档URL +// 导入云文档 URL // // 示例值：https://bytedance.feishu.cn/sheets/shtcnVBTG6SuxxxxxxxkM2tUX func (builder *ImportTaskBuilder) Url(url string) *ImportTaskBuilder { @@ -2568,13 +2568,13 @@ func (builder *ImportTaskBuilder) Build() *ImportTask { type ImportTaskMountPoint struct { MountType *int `json:"mount_type,omitempty"` // 挂载类型 - MountKey *string `json:"mount_key,omitempty"` // 挂载位置,对于mount_type=1, 云空间目录token，空表示根目录 + MountKey *string `json:"mount_key,omitempty"` // 挂载位置，对于 mount_type=1，云空间目录 token，空表示根目录 } type ImportTaskMountPointBuilder struct { mountType int // 挂载类型 mountTypeFlag bool - mountKey string // 挂载位置,对于mount_type=1, 云空间目录token，空表示根目录 + mountKey string // 挂载位置，对于 mount_type=1，云空间目录 token，空表示根目录 mountKeyFlag bool } @@ -2592,7 +2592,7 @@ func (builder *ImportTaskMountPointBuilder) MountType(mountType int) *ImportTask return builder } -// 挂载位置,对于mount_type=1, 云空间目录token，空表示根目录 +// 挂载位置，对于 mount_type=1，云空间目录 token，空表示根目录 // // 示例值：fldxxxxxxxx func (builder *ImportTaskMountPointBuilder) MountKey(mountKey string) *ImportTaskMountPointBuilder { @@ -2618,7 +2618,7 @@ type Media struct { FileToken *string `json:"file_token,omitempty"` // 文件标识符 FileName *string `json:"file_name,omitempty"` // 文件名 Size *int `json:"size,omitempty"` // 文件大小 - MimeType *string `json:"mime_type,omitempty"` // 文件MIME类型 + MimeType *string `json:"mime_type,omitempty"` // 文件 MIME 类型 } type MediaBuilder struct { @@ -2628,7 +2628,7 @@ type MediaBuilder struct { fileNameFlag bool size int // 文件大小 sizeFlag bool - mimeType string // 文件MIME类型 + mimeType string // 文件 MIME 类型 mimeTypeFlag bool } @@ -2664,7 +2664,7 @@ func (builder *MediaBuilder) Size(size int) *MediaBuilder { return builder } -// 文件MIME类型 +// 文件 MIME 类型 // // 示例值： func (builder *MediaBuilder) MimeType(mimeType string) *MediaBuilder { @@ -2699,7 +2699,7 @@ type MediaUploadInfo struct { ParentType *string `json:"parent_type,omitempty"` // 上传点类型 ParentNode *string `json:"parent_node,omitempty"` // 上传点的标识符 Size *int `json:"size,omitempty"` // 文件大小 - Extra *string `json:"extra,omitempty"` // 扩展信息(可选) + Extra *string `json:"extra,omitempty"` // 扩展信息 (可选) } type MediaUploadInfoBuilder struct { @@ -2711,7 +2711,7 @@ type MediaUploadInfoBuilder struct { parentNodeFlag bool size int // 文件大小 sizeFlag bool - extra string // 扩展信息(可选) + extra string // 扩展信息 (可选) extraFlag bool } @@ -2756,7 +2756,7 @@ func (builder *MediaUploadInfoBuilder) Size(size int) *MediaUploadInfoBuilder { return builder } -// 扩展信息(可选) +// 扩展信息 (可选) // // 示例值：{\"test\":\"test\"} func (builder *MediaUploadInfoBuilder) Extra(extra string) *MediaUploadInfoBuilder { @@ -2919,19 +2919,19 @@ func (builder *MemberBuilder) Build() *Member { } type Meta struct { - DocToken *string `json:"doc_token,omitempty"` // 文件token + DocToken *string `json:"doc_token,omitempty"` // 文件 token DocType *string `json:"doc_type,omitempty"` // 文件类型 Title *string `json:"title,omitempty"` // 标题 OwnerId *string `json:"owner_id,omitempty"` // 文件所有者 - CreateTime *string `json:"create_time,omitempty"` // 创建时间（Unix时间戳） + CreateTime *string `json:"create_time,omitempty"` // 创建时间（Unix 时间戳） LatestModifyUser *string `json:"latest_modify_user,omitempty"` // 最后编辑者 - LatestModifyTime *string `json:"latest_modify_time,omitempty"` // 最后编辑时间（Unix时间戳） + LatestModifyTime *string `json:"latest_modify_time,omitempty"` // 最后编辑时间（Unix 时间戳） Url *string `json:"url,omitempty"` // 文档链接 SecLabelName *string `json:"sec_label_name,omitempty"` // 文档密级标签名称 } type MetaBuilder struct { - docToken string // 文件token + docToken string // 文件 token docTokenFlag bool docType string // 文件类型 docTypeFlag bool @@ -2939,11 +2939,11 @@ type MetaBuilder struct { titleFlag bool ownerId string // 文件所有者 ownerIdFlag bool - createTime string // 创建时间（Unix时间戳） + createTime string // 创建时间（Unix 时间戳） createTimeFlag bool latestModifyUser string // 最后编辑者 latestModifyUserFlag bool - latestModifyTime string // 最后编辑时间（Unix时间戳） + latestModifyTime string // 最后编辑时间（Unix 时间戳） latestModifyTimeFlag bool url string // 文档链接 urlFlag bool @@ -2956,7 +2956,7 @@ func NewMetaBuilder() *MetaBuilder { return builder } -// 文件token +// 文件 token // // 示例值：doccnfYZzTlvXqZIGTdAHKabcef func (builder *MetaBuilder) DocToken(docToken string) *MetaBuilder { @@ -2992,7 +2992,7 @@ func (builder *MetaBuilder) OwnerId(ownerId string) *MetaBuilder { return builder } -// 创建时间（Unix时间戳） +// 创建时间（Unix 时间戳） // // 示例值：1652066345 func (builder *MetaBuilder) CreateTime(createTime string) *MetaBuilder { @@ -3010,7 +3010,7 @@ func (builder *MetaBuilder) LatestModifyUser(latestModifyUser string) *MetaBuild return builder } -// 最后编辑时间（Unix时间戳） +// 最后编辑时间（Unix 时间戳） // // 示例值：1652066345 func (builder *MetaBuilder) LatestModifyTime(latestModifyTime string) *MetaBuilder { @@ -3079,12 +3079,12 @@ func (builder *MetaBuilder) Build() *Meta { } type MetaFailed struct { - Token *string `json:"token,omitempty"` // 获取元数据失败的文档token + Token *string `json:"token,omitempty"` // 获取元数据失败的文档 token Code *int `json:"code,omitempty"` // 获取元数据失败的错误码 } type MetaFailedBuilder struct { - token string // 获取元数据失败的文档token + token string // 获取元数据失败的文档 token tokenFlag bool code int // 获取元数据失败的错误码 codeFlag bool @@ -3095,7 +3095,7 @@ func NewMetaFailedBuilder() *MetaFailedBuilder { return builder } -// 获取元数据失败的文档token +// 获取元数据失败的文档 token // // 示例值：boxcnrHpsg1QDqXAAAyachabcef func (builder *MetaFailedBuilder) Token(token string) *MetaFailedBuilder { @@ -3127,12 +3127,12 @@ func (builder *MetaFailedBuilder) Build() *MetaFailed { } type MetaRequest struct { - RequestDocs []*RequestDoc `json:"request_docs,omitempty"` // 请求文档, 一次不超过200个 + RequestDocs []*RequestDoc `json:"request_docs,omitempty"` // 请求文档，一次不超过 200 个 WithUrl *bool `json:"with_url,omitempty"` // 是否获取文档链接 } type MetaRequestBuilder struct { - requestDocs []*RequestDoc // 请求文档, 一次不超过200个 + requestDocs []*RequestDoc // 请求文档，一次不超过 200 个 requestDocsFlag bool withUrl bool // 是否获取文档链接 withUrlFlag bool @@ -3143,7 +3143,7 @@ func NewMetaRequestBuilder() *MetaRequestBuilder { return builder } -// 请求文档, 一次不超过200个 +// 请求文档，一次不超过 200 个 // // 示例值： func (builder *MetaRequestBuilder) RequestDocs(requestDocs []*RequestDoc) *MetaRequestBuilder { @@ -3174,14 +3174,14 @@ func (builder *MetaRequestBuilder) Build() *MetaRequest { } type Owner struct { - MemberType *string `json:"member_type,omitempty"` // 文档拥有者的ID类型 - MemberId *string `json:"member_id,omitempty"` // 文档拥有者的ID，与文档拥有者的ID类型需要对应 + MemberType *string `json:"member_type,omitempty"` // 文档拥有者的 ID 类型 + MemberId *string `json:"member_id,omitempty"` // 文档拥有者的 ID，与文档拥有者的 ID 类型需要对应 } type OwnerBuilder struct { - memberType string // 文档拥有者的ID类型 + memberType string // 文档拥有者的 ID 类型 memberTypeFlag bool - memberId string // 文档拥有者的ID，与文档拥有者的ID类型需要对应 + memberId string // 文档拥有者的 ID，与文档拥有者的 ID 类型需要对应 memberIdFlag bool } @@ -3190,7 +3190,7 @@ func NewOwnerBuilder() *OwnerBuilder { return builder } -// 文档拥有者的ID类型 +// 文档拥有者的 ID 类型 // // 示例值：openid func (builder *OwnerBuilder) MemberType(memberType string) *OwnerBuilder { @@ -3199,7 +3199,7 @@ func (builder *OwnerBuilder) MemberType(memberType string) *OwnerBuilder { return builder } -// 文档拥有者的ID，与文档拥有者的ID类型需要对应 +// 文档拥有者的 ID，与文档拥有者的 ID 类型需要对应 // // 示例值：string func (builder *OwnerBuilder) MemberId(memberId string) *OwnerBuilder { @@ -3222,7 +3222,7 @@ func (builder *OwnerBuilder) Build() *Owner { } type PermissionPublic struct { - ExternalAccess *bool `json:"external_access,omitempty"` // 允许内容被分享到组织外;;**可选值有：** ;- `true`: 允许;- `false`: 不允许 + ExternalAccess *bool `json:"external_access,omitempty"` // 允许内容被分享到组织外;;** 可选值有：** ;- `true`: 允许;- `false`: 不允许 SecurityEntity *string `json:"security_entity,omitempty"` // 谁可以复制内容、创建副本、打印、下载 CommentEntity *string `json:"comment_entity,omitempty"` // 可评论设置 ShareEntity *string `json:"share_entity,omitempty"` // 谁可以添加和管理协作者 @@ -3232,7 +3232,7 @@ type PermissionPublic struct { } type PermissionPublicBuilder struct { - externalAccess bool // 允许内容被分享到组织外;;**可选值有：** ;- `true`: 允许;- `false`: 不允许 + externalAccess bool // 允许内容被分享到组织外;;** 可选值有：** ;- `true`: 允许;- `false`: 不允许 externalAccessFlag bool securityEntity string // 谁可以复制内容、创建副本、打印、下载 securityEntityFlag bool @@ -3253,7 +3253,7 @@ func NewPermissionPublicBuilder() *PermissionPublicBuilder { return builder } -// 允许内容被分享到组织外;;**可选值有：** ;- `true`: 允许;- `false`: 不允许 +// 允许内容被分享到组织外;;** 可选值有：** ;- `true`: 允许;- `false`: 不允许 // // 示例值：true func (builder *PermissionPublicBuilder) ExternalAccess(externalAccess bool) *PermissionPublicBuilder { @@ -3462,11 +3462,11 @@ func (builder *PermissionPublicRequestBuilder) Build() *PermissionPublicRequest } type Person struct { - UserId *string `json:"user_id,omitempty"` // 回复 at联系人 + UserId *string `json:"user_id,omitempty"` // 回复 at 联系人 } type PersonBuilder struct { - userId string // 回复 at联系人 + userId string // 回复 at 联系人 userIdFlag bool } @@ -3475,7 +3475,7 @@ func NewPersonBuilder() *PersonBuilder { return builder } -// 回复 at联系人 +// 回复 at 联系人 // // 示例值：ou_cc19b2bfb93f8a44db4b4d6eababcef func (builder *PersonBuilder) UserId(userId string) *PersonBuilder { @@ -3650,11 +3650,11 @@ func (builder *ReplyElementBuilder) Build() *ReplyElement { } type ReplyExtra struct { - ImageList []string `json:"image_list,omitempty"` // 评论中的图片token list + ImageList []string `json:"image_list,omitempty"` // 评论中的图片 token list } type ReplyExtraBuilder struct { - imageList []string // 评论中的图片token list + imageList []string // 评论中的图片 token list imageListFlag bool } @@ -3663,7 +3663,7 @@ func NewReplyExtraBuilder() *ReplyExtraBuilder { return builder } -// 评论中的图片token list +// 评论中的图片 token list // // 示例值：["xfsfseewewabcef"] func (builder *ReplyExtraBuilder) ImageList(imageList []string) *ReplyExtraBuilder { @@ -3712,12 +3712,12 @@ func (builder *ReplyListBuilder) Build() *ReplyList { } type RequestDoc struct { - DocToken *string `json:"doc_token,omitempty"` // 文件的 token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) + DocToken *string `json:"doc_token,omitempty"` // 文件的 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) DocType *string `json:"doc_type,omitempty"` // 文件类型 } type RequestDocBuilder struct { - docToken string // 文件的 token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) + docToken string // 文件的 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) docTokenFlag bool docType string // 文件类型 docTypeFlag bool @@ -3728,7 +3728,7 @@ func NewRequestDocBuilder() *RequestDocBuilder { return builder } -// 文件的 token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) +// 文件的 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#08bb5df6) // // 示例值：doccnfYZzTlvXqZIGTdAHKabcef func (builder *RequestDocBuilder) DocToken(docToken string) *RequestDocBuilder { @@ -3761,13 +3761,13 @@ func (builder *RequestDocBuilder) Build() *RequestDoc { type ShortcutInfo struct { TargetType *string `json:"target_type,omitempty"` // 快捷方式指向的原文件类型 - TargetToken *string `json:"target_token,omitempty"` // 快捷方式指向的原文件token + TargetToken *string `json:"target_token,omitempty"` // 快捷方式指向的原文件 token } type ShortcutInfoBuilder struct { targetType string // 快捷方式指向的原文件类型 targetTypeFlag bool - targetToken string // 快捷方式指向的原文件token + targetToken string // 快捷方式指向的原文件 token targetTokenFlag bool } @@ -3785,7 +3785,7 @@ func (builder *ShortcutInfoBuilder) TargetType(targetType string) *ShortcutInfoB return builder } -// 快捷方式指向的原文件token +// 快捷方式指向的原文件 token // // 示例值： func (builder *ShortcutInfoBuilder) TargetToken(targetToken string) *ShortcutInfoBuilder { @@ -3888,12 +3888,12 @@ func (builder *TmpDownloadUrlBuilder) Build() *TmpDownloadUrl { } type TokenType struct { - Token *string `json:"token,omitempty"` // 文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)的第 4 项 + Token *string `json:"token,omitempty"` // 文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) 的第 4 项 Type *string `json:"type,omitempty"` // 文档类型 "isv" } type TokenTypeBuilder struct { - token string // 文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)的第 4 项 + token string // 文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) 的第 4 项 tokenFlag bool type_ string // 文档类型 "isv" typeFlag bool @@ -3904,7 +3904,7 @@ func NewTokenTypeBuilder() *TokenTypeBuilder { return builder } -// 文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)的第 4 项 +// 文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) 的第 4 项 // // 示例值：isvcnBKgoMyY5OMbUG6FioTXuBe func (builder *TokenTypeBuilder) Token(token string) *TokenTypeBuilder { @@ -4083,8 +4083,8 @@ type Version struct { Name *string `json:"name,omitempty"` // 版本文档标题 Version *string `json:"version,omitempty"` // 版本文档版本号 ParentToken *string `json:"parent_token,omitempty"` // shtbcpM2mm3znrLfWnf4browTYp - OwnerId *string `json:"owner_id,omitempty"` // 版本文档所有者id - CreatorId *string `json:"creator_id,omitempty"` // 版本文档创建者id + OwnerId *string `json:"owner_id,omitempty"` // 版本文档所有者 id + CreatorId *string `json:"creator_id,omitempty"` // 版本文档创建者 id CreateTime *string `json:"create_time,omitempty"` // 版本文档创建时间 UpdateTime *string `json:"update_time,omitempty"` // 版本文档更新时间 Status *string `json:"status,omitempty"` // 版本文档状态 @@ -4099,9 +4099,9 @@ type VersionBuilder struct { versionFlag bool parentToken string // shtbcpM2mm3znrLfWnf4browTYp parentTokenFlag bool - ownerId string // 版本文档所有者id + ownerId string // 版本文档所有者 id ownerIdFlag bool - creatorId string // 版本文档创建者id + creatorId string // 版本文档创建者 id creatorIdFlag bool createTime string // 版本文档创建时间 createTimeFlag bool @@ -4147,7 +4147,7 @@ func (builder *VersionBuilder) ParentToken(parentToken string) *VersionBuilder { return builder } -// 版本文档所有者id +// 版本文档所有者 id // // 示例值：694699009591869450 func (builder *VersionBuilder) OwnerId(ownerId string) *VersionBuilder { @@ -4156,7 +4156,7 @@ func (builder *VersionBuilder) OwnerId(ownerId string) *VersionBuilder { return builder } -// 版本文档创建者id +// 版本文档创建者 id // // 示例值：694699009591869451 func (builder *VersionBuilder) CreatorId(creatorId string) *VersionBuilder { @@ -4288,7 +4288,7 @@ type CreateExportTaskReq struct { } type CreateExportTaskRespData struct { - Ticket *string `json:"ticket,omitempty"` // 导出任务ID + Ticket *string `json:"ticket,omitempty"` // 导出任务 ID } type CreateExportTaskResp struct { @@ -4314,7 +4314,7 @@ func NewDownloadExportTaskReqBuilder() *DownloadExportTaskReqBuilder { return builder } -// 导出文档token +// 导出文档 token // // 示例值：boxcnNAlfwHxxxxxxxxxxSaLSec func (builder *DownloadExportTaskReqBuilder) FileToken(fileToken string) *DownloadExportTaskReqBuilder { @@ -4370,7 +4370,7 @@ func NewGetExportTaskReqBuilder() *GetExportTaskReqBuilder { return builder } -// 导出任务ID，[创建导出任务](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create) 响应中的 ticket 字段 +// 导出任务 ID，[创建导出任务](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create) 响应中的 ticket 字段 // // 示例值：6933093124755423251 func (builder *GetExportTaskReqBuilder) Ticket(ticket string) *GetExportTaskReqBuilder { @@ -4417,7 +4417,7 @@ type CopyFileReqBodyBuilder struct { nameFlag bool type_ string // 被复制文件的类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。 typeFlag bool - folderToken string // 文件被复制到的目标文件夹token + folderToken string // 文件被复制到的目标文件夹 token folderTokenFlag bool extra []*Property // 用户自定义请求附加参数，用于实现特殊的复制语义 extraFlag bool @@ -4446,7 +4446,7 @@ func (builder *CopyFileReqBodyBuilder) Type(type_ string) *CopyFileReqBodyBuilde return builder } -// 文件被复制到的目标文件夹token +// 文件被复制到的目标文件夹 token // //示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *CopyFileReqBodyBuilder) FolderToken(folderToken string) *CopyFileReqBodyBuilder { @@ -4486,7 +4486,7 @@ type CopyFilePathReqBodyBuilder struct { nameFlag bool type_ string // 被复制文件的类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。 typeFlag bool - folderToken string // 文件被复制到的目标文件夹token + folderToken string // 文件被复制到的目标文件夹 token folderTokenFlag bool extra []*Property // 用户自定义请求附加参数，用于实现特殊的复制语义 extraFlag bool @@ -4515,7 +4515,7 @@ func (builder *CopyFilePathReqBodyBuilder) Type(type_ string) *CopyFilePathReqBo return builder } -// 文件被复制到的目标文件夹token +// 文件被复制到的目标文件夹 token // // 示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *CopyFilePathReqBodyBuilder) FolderToken(folderToken string) *CopyFilePathReqBodyBuilder { @@ -4564,7 +4564,7 @@ func NewCopyFileReqBuilder() *CopyFileReqBuilder { return builder } -// 被复制的文件token +// 被复制的文件 token // // 示例值：doccngpahSdXrFPIBD4XdIabcef func (builder *CopyFileReqBuilder) FileToken(fileToken string) *CopyFileReqBuilder { @@ -4572,7 +4572,7 @@ func (builder *CopyFileReqBuilder) FileToken(fileToken string) *CopyFileReqBuild return builder } -// 将文件复制到用户云空间的其他文件夹中。不支持复制文件夹。;;如果目标文件夹是我的空间，则复制的文件会在「**我的空间**」的「**归我所有**」列表里。 +// 将文件复制到用户云空间的其他文件夹中。不支持复制文件夹。;;如果目标文件夹是我的空间，则复制的文件会在「** 我的空间 **」的「** 归我所有 **」列表里。 func (builder *CopyFileReqBuilder) Body(body *CopyFileReqBody) *CopyFileReqBuilder { builder.body = body return builder @@ -4589,7 +4589,7 @@ func (builder *CopyFileReqBuilder) Build() *CopyFileReq { type CopyFileReqBody struct { Name *string `json:"name,omitempty"` // 被复制文件的新名称 Type *string `json:"type,omitempty"` // 被复制文件的类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。 - FolderToken *string `json:"folder_token,omitempty"` // 文件被复制到的目标文件夹token + FolderToken *string `json:"folder_token,omitempty"` // 文件被复制到的目标文件夹 token Extra []*Property `json:"extra,omitempty"` // 用户自定义请求附加参数，用于实现特殊的复制语义 } @@ -4615,7 +4615,7 @@ func (resp *CopyFileResp) Success() bool { type CreateFolderFileReqBodyBuilder struct { name string // 文件夹名称 nameFlag bool - folderToken string // 父文件夹token + folderToken string // 父文件夹 token folderTokenFlag bool } @@ -4633,7 +4633,7 @@ func (builder *CreateFolderFileReqBodyBuilder) Name(name string) *CreateFolderFi return builder } -// 父文件夹token +// 父文件夹 token // //示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *CreateFolderFileReqBodyBuilder) FolderToken(folderToken string) *CreateFolderFileReqBodyBuilder { @@ -4656,7 +4656,7 @@ func (builder *CreateFolderFileReqBodyBuilder) Build() *CreateFolderFileReqBody type CreateFolderFilePathReqBodyBuilder struct { name string // 文件夹名称 nameFlag bool - folderToken string // 父文件夹token + folderToken string // 父文件夹 token folderTokenFlag bool } @@ -4674,7 +4674,7 @@ func (builder *CreateFolderFilePathReqBodyBuilder) Name(name string) *CreateFold return builder } -// 父文件夹token +// 父文件夹 token // // 示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *CreateFolderFilePathReqBodyBuilder) FolderToken(folderToken string) *CreateFolderFilePathReqBodyBuilder { @@ -4723,7 +4723,7 @@ func (builder *CreateFolderFileReqBuilder) Build() *CreateFolderFileReq { type CreateFolderFileReqBody struct { Name *string `json:"name,omitempty"` // 文件夹名称 - FolderToken *string `json:"folder_token,omitempty"` // 父文件夹token + FolderToken *string `json:"folder_token,omitempty"` // 父文件夹 token } type CreateFolderFileReq struct { @@ -4732,8 +4732,8 @@ type CreateFolderFileReq struct { } type CreateFolderFileRespData struct { - Token *string `json:"token,omitempty"` // 创建文件夹的token - Url *string `json:"url,omitempty"` // 创建文件夹的访问url + Token *string `json:"token,omitempty"` // 创建文件夹的 token + Url *string `json:"url,omitempty"` // 创建文件夹的访问 url } type CreateFolderFileResp struct { @@ -4759,7 +4759,7 @@ func NewDeleteFileReqBuilder() *DeleteFileReqBuilder { return builder } -// 需要删除的文件token +// 需要删除的文件 token // // 示例值：boxcnrHpsg1QDqXAAAyachabcef func (builder *DeleteFileReqBuilder) FileToken(fileToken string) *DeleteFileReqBuilder { @@ -4788,7 +4788,7 @@ type DeleteFileReq struct { } type DeleteFileRespData struct { - TaskId *string `json:"task_id,omitempty"` // 异步任务id，删除文件夹时返回 + TaskId *string `json:"task_id,omitempty"` // 异步任务 id，删除文件夹时返回 } type DeleteFileResp struct { @@ -4886,7 +4886,7 @@ func (builder *ListFileReqBuilder) PageToken(pageToken string) *ListFileReqBuild return builder } -// 文件夹的token（若不填写该参数或填写空字符串，则默认获取用户云空间下的清单，且不支持分页） +// 文件夹的 token（若不填写该参数或填写空字符串，则默认获取用户云空间下的清单，且不支持分页） // // 示例值：fldbcO1UuPz8VwnpPx5a9abcef func (builder *ListFileReqBuilder) FolderToken(folderToken string) *ListFileReqBuilder { @@ -4907,7 +4907,7 @@ type ListFileReq struct { type ListFileRespData struct { Files []*File `json:"files,omitempty"` // 文件夹清单列表 - NextPageToken *string `json:"next_page_token,omitempty"` // 分页标记，当 has_more 为 true 时，会同时返回下一次遍历的page_token，否则则不返回 + NextPageToken *string `json:"next_page_token,omitempty"` // 分页标记，当 has_more 为 true 时，会同时返回下一次遍历的 page_token，否则则不返回 HasMore *bool `json:"has_more,omitempty"` // } @@ -4924,7 +4924,7 @@ func (resp *ListFileResp) Success() bool { type MoveFileReqBodyBuilder struct { type_ string // 文件类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。 typeFlag bool - folderToken string // 目标文件夹token + folderToken string // 目标文件夹 token folderTokenFlag bool } @@ -4942,7 +4942,7 @@ func (builder *MoveFileReqBodyBuilder) Type(type_ string) *MoveFileReqBodyBuilde return builder } -// 目标文件夹token +// 目标文件夹 token // //示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *MoveFileReqBodyBuilder) FolderToken(folderToken string) *MoveFileReqBodyBuilder { @@ -4965,7 +4965,7 @@ func (builder *MoveFileReqBodyBuilder) Build() *MoveFileReqBody { type MoveFilePathReqBodyBuilder struct { type_ string // 文件类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。 typeFlag bool - folderToken string // 目标文件夹token + folderToken string // 目标文件夹 token folderTokenFlag bool } @@ -4983,7 +4983,7 @@ func (builder *MoveFilePathReqBodyBuilder) Type(type_ string) *MoveFilePathReqBo return builder } -// 目标文件夹token +// 目标文件夹 token // // 示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *MoveFilePathReqBodyBuilder) FolderToken(folderToken string) *MoveFilePathReqBodyBuilder { @@ -5017,7 +5017,7 @@ func NewMoveFileReqBuilder() *MoveFileReqBuilder { return builder } -// 需要移动的文件token +// 需要移动的文件 token // // 示例值：boxcnrHpsg1QDqXAAAyachabcef func (builder *MoveFileReqBuilder) FileToken(fileToken string) *MoveFileReqBuilder { @@ -5041,7 +5041,7 @@ func (builder *MoveFileReqBuilder) Build() *MoveFileReq { type MoveFileReqBody struct { Type *string `json:"type,omitempty"` // 文件类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。 - FolderToken *string `json:"folder_token,omitempty"` // 目标文件夹token + FolderToken *string `json:"folder_token,omitempty"` // 目标文件夹 token } type MoveFileReq struct { @@ -5050,7 +5050,7 @@ type MoveFileReq struct { } type MoveFileRespData struct { - TaskId *string `json:"task_id,omitempty"` // 异步任务id，移动文件夹时返回 + TaskId *string `json:"task_id,omitempty"` // 异步任务 id，移动文件夹时返回 } type MoveFileResp struct { @@ -5076,7 +5076,7 @@ func NewSubscribeFileReqBuilder() *SubscribeFileReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doccnxxxxxxxxxxxxxxxxxxxxxx func (builder *SubscribeFileReqBuilder) FileToken(fileToken string) *SubscribeFileReqBuilder { @@ -5126,7 +5126,7 @@ func NewTaskCheckFileReqBuilder() *TaskCheckFileReqBuilder { return builder } -// 文件相关异步任务id +// 文件相关异步任务 id // // 示例值：12345 func (builder *TaskCheckFileReqBuilder) TaskId(taskId string) *TaskCheckFileReqBuilder { @@ -5146,7 +5146,7 @@ type TaskCheckFileReq struct { } type TaskCheckFileRespData struct { - Status *string `json:"status,omitempty"` // 异步任务的执行状态，如果任务执行成功则返回success，如果任务执行失败则返回fail，如果任务还在执行中则返回process。 + Status *string `json:"status,omitempty"` // 异步任务的执行状态，如果任务执行成功则返回 success，如果任务执行失败则返回 fail，如果任务还在执行中则返回 process。 } type TaskCheckFileResp struct { @@ -5164,11 +5164,11 @@ type UploadAllFileReqBodyBuilder struct { fileNameFlag bool parentType string // 上传点类型。 parentTypeFlag bool - parentNode string // 文件夹token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) + parentNode string // 文件夹 token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) parentNodeFlag bool size int // 文件大小（以字节为单位）。 sizeFlag bool - checksum string // 文件adler32校验和(可选)。 + checksum string // 文件 adler32 校验和 (可选)。 checksumFlag bool file io.Reader // 文件二进制内容。 fileFlag bool @@ -5197,7 +5197,7 @@ func (builder *UploadAllFileReqBodyBuilder) ParentType(parentType string) *Uploa return builder } -// 文件夹token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) +// 文件夹 token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) // //示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *UploadAllFileReqBodyBuilder) ParentNode(parentNode string) *UploadAllFileReqBodyBuilder { @@ -5215,7 +5215,7 @@ func (builder *UploadAllFileReqBodyBuilder) Size(size int) *UploadAllFileReqBody return builder } -// 文件adler32校验和(可选)。 +// 文件 adler32 校验和 (可选)。 // //示例值：123423882374238912356 func (builder *UploadAllFileReqBodyBuilder) Checksum(checksum string) *UploadAllFileReqBodyBuilder { @@ -5261,11 +5261,11 @@ type UploadAllFilePathReqBodyBuilder struct { fileNameFlag bool parentType string // 上传点类型。 parentTypeFlag bool - parentNode string // 文件夹token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) + parentNode string // 文件夹 token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) parentNodeFlag bool size int // 文件大小（以字节为单位）。 sizeFlag bool - checksum string // 文件adler32校验和(可选)。 + checksum string // 文件 adler32 校验和 (可选)。 checksumFlag bool filePath string // 文件二进制内容。 filePathFlag bool @@ -5294,7 +5294,7 @@ func (builder *UploadAllFilePathReqBodyBuilder) ParentType(parentType string) *U return builder } -// 文件夹token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) +// 文件夹 token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) // // 示例值：fldbcO1UuPz8VwnpPx5a92abcef func (builder *UploadAllFilePathReqBodyBuilder) ParentNode(parentNode string) *UploadAllFilePathReqBodyBuilder { @@ -5312,7 +5312,7 @@ func (builder *UploadAllFilePathReqBodyBuilder) Size(size int) *UploadAllFilePat return builder } -// 文件adler32校验和(可选)。 +// 文件 adler32 校验和 (可选)。 // // 示例值：123423882374238912356 func (builder *UploadAllFilePathReqBodyBuilder) Checksum(checksum string) *UploadAllFilePathReqBodyBuilder { @@ -5387,9 +5387,9 @@ func (builder *UploadAllFileReqBuilder) Build() *UploadAllFileReq { type UploadAllFileReqBody struct { FileName *string `json:"file_name,omitempty"` // 文件名。 ParentType *string `json:"parent_type,omitempty"` // 上传点类型。 - ParentNode *string `json:"parent_node,omitempty"` // 文件夹token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) + ParentNode *string `json:"parent_node,omitempty"` // 文件夹 token，;获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) Size *int `json:"size,omitempty"` // 文件大小（以字节为单位）。 - Checksum *string `json:"checksum,omitempty"` // 文件adler32校验和(可选)。 + Checksum *string `json:"checksum,omitempty"` // 文件 adler32 校验和 (可选)。 File io.Reader `json:"file,omitempty"` // 文件二进制内容。 } @@ -5413,7 +5413,7 @@ func (resp *UploadAllFileResp) Success() bool { } type UploadFinishFileReqBodyBuilder struct { - uploadId string // 分片上传事务ID + uploadId string // 分片上传事务 ID uploadIdFlag bool blockNum int // 分片数量 blockNumFlag bool @@ -5424,7 +5424,7 @@ func NewUploadFinishFileReqBodyBuilder() *UploadFinishFileReqBodyBuilder { return builder } -// 分片上传事务ID +// 分片上传事务 ID // //示例值：7111211691345512356 func (builder *UploadFinishFileReqBodyBuilder) UploadId(uploadId string) *UploadFinishFileReqBodyBuilder { @@ -5454,7 +5454,7 @@ func (builder *UploadFinishFileReqBodyBuilder) Build() *UploadFinishFileReqBody } type UploadFinishFilePathReqBodyBuilder struct { - uploadId string // 分片上传事务ID + uploadId string // 分片上传事务 ID uploadIdFlag bool blockNum int // 分片数量 blockNumFlag bool @@ -5465,7 +5465,7 @@ func NewUploadFinishFilePathReqBodyBuilder() *UploadFinishFilePathReqBodyBuilder return builder } -// 分片上传事务ID +// 分片上传事务 ID // // 示例值：7111211691345512356 func (builder *UploadFinishFilePathReqBodyBuilder) UploadId(uploadId string) *UploadFinishFilePathReqBodyBuilder { @@ -5522,7 +5522,7 @@ func (builder *UploadFinishFileReqBuilder) Build() *UploadFinishFileReq { } type UploadFinishFileReqBody struct { - UploadId *string `json:"upload_id,omitempty"` // 分片上传事务ID + UploadId *string `json:"upload_id,omitempty"` // 分片上传事务 ID BlockNum *int `json:"block_num,omitempty"` // 分片数量 } @@ -5532,7 +5532,7 @@ type UploadFinishFileReq struct { } type UploadFinishFileRespData struct { - FileToken *string `json:"file_token,omitempty"` // 新创建的文件token + FileToken *string `json:"file_token,omitempty"` // 新创建的文件 token } type UploadFinishFileResp struct { @@ -5546,13 +5546,13 @@ func (resp *UploadFinishFileResp) Success() bool { } type UploadPartFileReqBodyBuilder struct { - uploadId string // 分片上传事务ID。 + uploadId string // 分片上传事务 ID。 uploadIdFlag bool - seq int // 块号，从0开始计数。 + seq int // 块号，从 0 开始计数。 seqFlag bool size int // 块大小（以字节为单位）。 sizeFlag bool - checksum string // 文件分块adler32校验和(可选)。 + checksum string // 文件分块 adler32 校验和 (可选)。 checksumFlag bool file io.Reader // 文件分片二进制内容。 fileFlag bool @@ -5563,7 +5563,7 @@ func NewUploadPartFileReqBodyBuilder() *UploadPartFileReqBodyBuilder { return builder } -// 分片上传事务ID。 +// 分片上传事务 ID。 // //示例值：7111211691345512356 func (builder *UploadPartFileReqBodyBuilder) UploadId(uploadId string) *UploadPartFileReqBodyBuilder { @@ -5572,7 +5572,7 @@ func (builder *UploadPartFileReqBodyBuilder) UploadId(uploadId string) *UploadPa return builder } -// 块号，从0开始计数。 +// 块号，从 0 开始计数。 // //示例值：0 func (builder *UploadPartFileReqBodyBuilder) Seq(seq int) *UploadPartFileReqBodyBuilder { @@ -5590,7 +5590,7 @@ func (builder *UploadPartFileReqBodyBuilder) Size(size int) *UploadPartFileReqBo return builder } -// 文件分块adler32校验和(可选)。 +// 文件分块 adler32 校验和 (可选)。 // //示例值：12342388237783212356 func (builder *UploadPartFileReqBodyBuilder) Checksum(checksum string) *UploadPartFileReqBodyBuilder { @@ -5629,13 +5629,13 @@ func (builder *UploadPartFileReqBodyBuilder) Build() *UploadPartFileReqBody { } type UploadPartFilePathReqBodyBuilder struct { - uploadId string // 分片上传事务ID。 + uploadId string // 分片上传事务 ID。 uploadIdFlag bool - seq int // 块号，从0开始计数。 + seq int // 块号，从 0 开始计数。 seqFlag bool size int // 块大小（以字节为单位）。 sizeFlag bool - checksum string // 文件分块adler32校验和(可选)。 + checksum string // 文件分块 adler32 校验和 (可选)。 checksumFlag bool filePath string // 文件分片二进制内容。 filePathFlag bool @@ -5646,7 +5646,7 @@ func NewUploadPartFilePathReqBodyBuilder() *UploadPartFilePathReqBodyBuilder { return builder } -// 分片上传事务ID。 +// 分片上传事务 ID。 // // 示例值：7111211691345512356 func (builder *UploadPartFilePathReqBodyBuilder) UploadId(uploadId string) *UploadPartFilePathReqBodyBuilder { @@ -5655,7 +5655,7 @@ func (builder *UploadPartFilePathReqBodyBuilder) UploadId(uploadId string) *Uplo return builder } -// 块号，从0开始计数。 +// 块号，从 0 开始计数。 // // 示例值：0 func (builder *UploadPartFilePathReqBodyBuilder) Seq(seq int) *UploadPartFilePathReqBodyBuilder { @@ -5673,7 +5673,7 @@ func (builder *UploadPartFilePathReqBodyBuilder) Size(size int) *UploadPartFileP return builder } -// 文件分块adler32校验和(可选)。 +// 文件分块 adler32 校验和 (可选)。 // // 示例值：12342388237783212356 func (builder *UploadPartFilePathReqBodyBuilder) Checksum(checksum string) *UploadPartFilePathReqBodyBuilder { @@ -5743,10 +5743,10 @@ func (builder *UploadPartFileReqBuilder) Build() *UploadPartFileReq { } type UploadPartFileReqBody struct { - UploadId *string `json:"upload_id,omitempty"` // 分片上传事务ID。 - Seq *int `json:"seq,omitempty"` // 块号，从0开始计数。 + UploadId *string `json:"upload_id,omitempty"` // 分片上传事务 ID。 + Seq *int `json:"seq,omitempty"` // 块号，从 0 开始计数。 Size *int `json:"size,omitempty"` // 块大小（以字节为单位）。 - Checksum *string `json:"checksum,omitempty"` // 文件分块adler32校验和(可选)。 + Checksum *string `json:"checksum,omitempty"` // 文件分块 adler32 校验和 (可选)。 File io.Reader `json:"file,omitempty"` // 文件分片二进制内容。 } @@ -5778,7 +5778,7 @@ func NewUploadPrepareFileReqBuilder() *UploadPrepareFileReqBuilder { return builder } -// 发送初始化请求获取上传事务ID和分块策略，目前是以4MB大小进行定长分片。 +// 发送初始化请求获取上传事务 ID 和分块策略，目前是以 4MB 大小进行定长分片。 func (builder *UploadPrepareFileReqBuilder) FileUploadInfo(fileUploadInfo *FileUploadInfo) *UploadPrepareFileReqBuilder { builder.fileUploadInfo = fileUploadInfo return builder @@ -5797,7 +5797,7 @@ type UploadPrepareFileReq struct { } type UploadPrepareFileRespData struct { - UploadId *string `json:"upload_id,omitempty"` // 分片上传事务ID + UploadId *string `json:"upload_id,omitempty"` // 分片上传事务 ID BlockSize *int `json:"block_size,omitempty"` // 分片大小策略 BlockNum *int `json:"block_num,omitempty"` // 分片数量 } @@ -5826,7 +5826,7 @@ func NewCreateFileCommentReqBuilder() *CreateFileCommentReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doccnGp4UK1UskrOEJwBXd3**** func (builder *CreateFileCommentReqBuilder) FileToken(fileToken string) *CreateFileCommentReqBuilder { @@ -5842,7 +5842,7 @@ func (builder *CreateFileCommentReqBuilder) FileType(fileType string) *CreateFil return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateFileCommentReqBuilder) UserIdType(userIdType string) *CreateFileCommentReqBuilder { @@ -5871,13 +5871,13 @@ type CreateFileCommentReq struct { } type CreateFileCommentRespData struct { - CommentId *string `json:"comment_id,omitempty"` // 评论ID - UserId *string `json:"user_id,omitempty"` // 用户ID + CommentId *string `json:"comment_id,omitempty"` // 评论 ID + UserId *string `json:"user_id,omitempty"` // 用户 ID CreateTime *int `json:"create_time,omitempty"` // 创建时间 UpdateTime *int `json:"update_time,omitempty"` // 更新时间 IsSolved *bool `json:"is_solved,omitempty"` // 是否已解决 SolvedTime *int `json:"solved_time,omitempty"` // 解决评论时间 - SolverUserId *string `json:"solver_user_id,omitempty"` // 解决评论者的用户ID + SolverUserId *string `json:"solver_user_id,omitempty"` // 解决评论者的用户 ID HasMore *bool `json:"has_more,omitempty"` // 是否有更多回复 PageToken *string `json:"page_token,omitempty"` // 回复分页标记 IsWhole *bool `json:"is_whole,omitempty"` // 是否是全文评论 @@ -5908,7 +5908,7 @@ func NewGetFileCommentReqBuilder() *GetFileCommentReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doccnHh7U87HOFpii5u5G***** func (builder *GetFileCommentReqBuilder) FileToken(fileToken string) *GetFileCommentReqBuilder { @@ -5916,7 +5916,7 @@ func (builder *GetFileCommentReqBuilder) FileToken(fileToken string) *GetFileCom return builder } -// 评论ID +// 评论 ID // // 示例值：6916106822734578184 func (builder *GetFileCommentReqBuilder) CommentId(commentId string) *GetFileCommentReqBuilder { @@ -5932,7 +5932,7 @@ func (builder *GetFileCommentReqBuilder) FileType(fileType string) *GetFileComme return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetFileCommentReqBuilder) UserIdType(userIdType string) *GetFileCommentReqBuilder { @@ -5953,13 +5953,13 @@ type GetFileCommentReq struct { } type GetFileCommentRespData struct { - CommentId *string `json:"comment_id,omitempty"` // 评论ID - UserId *string `json:"user_id,omitempty"` // 用户ID + CommentId *string `json:"comment_id,omitempty"` // 评论 ID + UserId *string `json:"user_id,omitempty"` // 用户 ID CreateTime *int `json:"create_time,omitempty"` // 创建时间 UpdateTime *int `json:"update_time,omitempty"` // 更新时间 IsSolved *bool `json:"is_solved,omitempty"` // 是否已解决 SolvedTime *int `json:"solved_time,omitempty"` // 解决评论时间 - SolverUserId *string `json:"solver_user_id,omitempty"` // 解决评论者的用户ID + SolverUserId *string `json:"solver_user_id,omitempty"` // 解决评论者的用户 ID HasMore *bool `json:"has_more,omitempty"` // 是否有更多回复 PageToken *string `json:"page_token,omitempty"` // 回复分页标记 IsWhole *bool `json:"is_whole,omitempty"` // 是否是全文评论 @@ -5997,7 +5997,7 @@ func (builder *ListFileCommentReqBuilder) Limit(limit int) *ListFileCommentReqBu return builder } -// 文档token +// 文档 token // // 示例值：XIHSdYSI7oMEU1xrsnxc8fabcef func (builder *ListFileCommentReqBuilder) FileToken(fileToken string) *ListFileCommentReqBuilder { @@ -6045,7 +6045,7 @@ func (builder *ListFileCommentReqBuilder) PageSize(pageSize int) *ListFileCommen return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListFileCommentReqBuilder) UserIdType(userIdType string) *ListFileCommentReqBuilder { @@ -6070,7 +6070,7 @@ type ListFileCommentReq struct { type ListFileCommentRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*FileComment `json:"items,omitempty"` // 评论列表 } @@ -6152,7 +6152,7 @@ func NewPatchFileCommentReqBuilder() *PatchFileCommentReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doccnGp4UK1UskrOEJwBXd3**** func (builder *PatchFileCommentReqBuilder) FileToken(fileToken string) *PatchFileCommentReqBuilder { @@ -6160,7 +6160,7 @@ func (builder *PatchFileCommentReqBuilder) FileToken(fileToken string) *PatchFil return builder } -// 评论ID +// 评论 ID // // 示例值：6916106822734578184 func (builder *PatchFileCommentReqBuilder) CommentId(commentId string) *PatchFileCommentReqBuilder { @@ -6222,7 +6222,7 @@ func NewDeleteFileCommentReplyReqBuilder() *DeleteFileCommentReplyReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doccnHh7U87HOFpii5u5G***** func (builder *DeleteFileCommentReplyReqBuilder) FileToken(fileToken string) *DeleteFileCommentReplyReqBuilder { @@ -6230,7 +6230,7 @@ func (builder *DeleteFileCommentReplyReqBuilder) FileToken(fileToken string) *De return builder } -// 评论ID +// 评论 ID // // 示例值：6916106822734578184 func (builder *DeleteFileCommentReplyReqBuilder) CommentId(commentId string) *DeleteFileCommentReplyReqBuilder { @@ -6238,7 +6238,7 @@ func (builder *DeleteFileCommentReplyReqBuilder) CommentId(commentId string) *De return builder } -// 回复ID +// 回复 ID // // 示例值：6916106822734594568 func (builder *DeleteFileCommentReplyReqBuilder) ReplyId(replyId string) *DeleteFileCommentReplyReqBuilder { @@ -6343,7 +6343,7 @@ func NewUpdateFileCommentReplyReqBuilder() *UpdateFileCommentReplyReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doccnHh7U87HOFpii5u5G***** func (builder *UpdateFileCommentReplyReqBuilder) FileToken(fileToken string) *UpdateFileCommentReplyReqBuilder { @@ -6351,7 +6351,7 @@ func (builder *UpdateFileCommentReplyReqBuilder) FileToken(fileToken string) *Up return builder } -// 评论ID +// 评论 ID // // 示例值：6916106822734578184 func (builder *UpdateFileCommentReplyReqBuilder) CommentId(commentId string) *UpdateFileCommentReplyReqBuilder { @@ -6359,7 +6359,7 @@ func (builder *UpdateFileCommentReplyReqBuilder) CommentId(commentId string) *Up return builder } -// 回复ID +// 回复 ID // // 示例值：6916106822734594568 func (builder *UpdateFileCommentReplyReqBuilder) ReplyId(replyId string) *UpdateFileCommentReplyReqBuilder { @@ -6375,7 +6375,7 @@ func (builder *UpdateFileCommentReplyReqBuilder) FileType(fileType string) *Upda return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateFileCommentReplyReqBuilder) UserIdType(userIdType string) *UpdateFileCommentReplyReqBuilder { @@ -6487,7 +6487,7 @@ func NewCreateFileSubscriptionReqBuilder() *CreateFileSubscriptionReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doxcnxxxxxxxxxxxxxxxxxxxxxx func (builder *CreateFileSubscriptionReqBuilder) FileToken(fileToken string) *CreateFileSubscriptionReqBuilder { @@ -6495,7 +6495,7 @@ func (builder *CreateFileSubscriptionReqBuilder) FileToken(fileToken string) *Cr return builder } -// 订阅文档中的变更事件，当前支持文档评论订阅，订阅后文档评论更新会有“云文档助手”推送给订阅的用户 +// 订阅文档中的变更事件，当前支持文档评论订阅，订阅后文档评论更新会有 “云文档助手” 推送给订阅的用户 func (builder *CreateFileSubscriptionReqBuilder) FileSubscription(fileSubscription *FileSubscription) *CreateFileSubscriptionReqBuilder { builder.fileSubscription = fileSubscription return builder @@ -6542,7 +6542,7 @@ func NewGetFileSubscriptionReqBuilder() *GetFileSubscriptionReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doxcnxxxxxxxxxxxxxxxxxxxxxx func (builder *GetFileSubscriptionReqBuilder) FileToken(fileToken string) *GetFileSubscriptionReqBuilder { @@ -6550,7 +6550,7 @@ func (builder *GetFileSubscriptionReqBuilder) FileToken(fileToken string) *GetFi return builder } -// 订阅关系ID +// 订阅关系 ID // // 示例值：1234567890987654321 func (builder *GetFileSubscriptionReqBuilder) SubscriptionId(subscriptionId string) *GetFileSubscriptionReqBuilder { @@ -6558,7 +6558,7 @@ func (builder *GetFileSubscriptionReqBuilder) SubscriptionId(subscriptionId stri return builder } -// 根据订阅ID获取该订阅的状态 +// 根据订阅 ID 获取该订阅的状态 func (builder *GetFileSubscriptionReqBuilder) FileSubscription(fileSubscription *FileSubscription) *GetFileSubscriptionReqBuilder { builder.fileSubscription = fileSubscription return builder @@ -6687,7 +6687,7 @@ func NewPatchFileSubscriptionReqBuilder() *PatchFileSubscriptionReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：doxcnxxxxxxxxxxxxxxxxxxxxxx func (builder *PatchFileSubscriptionReqBuilder) FileToken(fileToken string) *PatchFileSubscriptionReqBuilder { @@ -6695,7 +6695,7 @@ func (builder *PatchFileSubscriptionReqBuilder) FileToken(fileToken string) *Pat return builder } -// 订阅关系ID +// 订阅关系 ID // // 示例值：1234567890987654321 func (builder *PatchFileSubscriptionReqBuilder) SubscriptionId(subscriptionId string) *PatchFileSubscriptionReqBuilder { @@ -6703,7 +6703,7 @@ func (builder *PatchFileSubscriptionReqBuilder) SubscriptionId(subscriptionId st return builder } -// 根据订阅ID更新订阅状态 +// 根据订阅 ID 更新订阅状态 func (builder *PatchFileSubscriptionReqBuilder) Body(body *PatchFileSubscriptionReqBody) *PatchFileSubscriptionReqBuilder { builder.body = body return builder @@ -6755,7 +6755,7 @@ func NewCreateFileVersionReqBuilder() *CreateFileVersionReqBuilder { return builder } -// 源文档token +// 源文档 token // // 示例值：doxbcyvqZlSc9WlHvQMlSJwUrsb func (builder *CreateFileVersionReqBuilder) FileToken(fileToken string) *CreateFileVersionReqBuilder { @@ -6763,7 +6763,7 @@ func (builder *CreateFileVersionReqBuilder) FileToken(fileToken string) *CreateF return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateFileVersionReqBuilder) UserIdType(userIdType string) *CreateFileVersionReqBuilder { @@ -6795,8 +6795,8 @@ type CreateFileVersionRespData struct { Name *string `json:"name,omitempty"` // 版本文档标题 Version *string `json:"version,omitempty"` // 版本文档版本号 ParentToken *string `json:"parent_token,omitempty"` // shtbcpM2mm3znrLfWnf4browTYp - OwnerId *string `json:"owner_id,omitempty"` // 版本文档所有者id - CreatorId *string `json:"creator_id,omitempty"` // 版本文档创建者id + OwnerId *string `json:"owner_id,omitempty"` // 版本文档所有者 id + CreatorId *string `json:"creator_id,omitempty"` // 版本文档创建者 id CreateTime *string `json:"create_time,omitempty"` // 版本文档创建时间 UpdateTime *string `json:"update_time,omitempty"` // 版本文档更新时间 Status *string `json:"status,omitempty"` // 版本文档状态 @@ -6827,7 +6827,7 @@ func NewDeleteFileVersionReqBuilder() *DeleteFileVersionReqBuilder { return builder } -// 版本文档token +// 版本文档 token // // 示例值：doxbcyvqZlSc9WlHvQMlSJwUrsb func (builder *DeleteFileVersionReqBuilder) FileToken(fileToken string) *DeleteFileVersionReqBuilder { @@ -6851,7 +6851,7 @@ func (builder *DeleteFileVersionReqBuilder) ObjType(objType string) *DeleteFileV return builder } -// 用户ID类型 +// 用户 ID 类型 // // 示例值： func (builder *DeleteFileVersionReqBuilder) UserIdType(userIdType string) *DeleteFileVersionReqBuilder { @@ -6893,7 +6893,7 @@ func NewGetFileVersionReqBuilder() *GetFileVersionReqBuilder { return builder } -// 源文档token +// 源文档 token // // 示例值：shtbcqqoXZJaKYrfN5IHQg4sVFZ func (builder *GetFileVersionReqBuilder) FileToken(fileToken string) *GetFileVersionReqBuilder { @@ -6917,7 +6917,7 @@ func (builder *GetFileVersionReqBuilder) ObjType(objType string) *GetFileVersion return builder } -// 用户ID类型 +// 用户 ID 类型 // // 示例值： func (builder *GetFileVersionReqBuilder) UserIdType(userIdType string) *GetFileVersionReqBuilder { @@ -6957,8 +6957,8 @@ type GetFileVersionRespData struct { Name *string `json:"name,omitempty"` // 版本文档标题 Version *string `json:"version,omitempty"` // 版本文档版本号 ParentToken *string `json:"parent_token,omitempty"` // shtbcpM2mm3znrLfWnf4browTYp - OwnerId *string `json:"owner_id,omitempty"` // 版本文档所有者id - CreatorId *string `json:"creator_id,omitempty"` // 版本文档创建者id + OwnerId *string `json:"owner_id,omitempty"` // 版本文档所有者 id + CreatorId *string `json:"creator_id,omitempty"` // 版本文档创建者 id CreateTime *string `json:"create_time,omitempty"` // 版本文档创建时间 UpdateTime *string `json:"update_time,omitempty"` // 版本文档更新时间 Status *string `json:"status,omitempty"` // 版本文档状态 @@ -6996,7 +6996,7 @@ func (builder *ListFileVersionReqBuilder) Limit(limit int) *ListFileVersionReqBu return builder } -// 源文档token +// 源文档 token // // 示例值：shtbcpM2mm3znrLfWnf4browTYp23 func (builder *ListFileVersionReqBuilder) FileToken(fileToken string) *ListFileVersionReqBuilder { @@ -7028,7 +7028,7 @@ func (builder *ListFileVersionReqBuilder) ObjType(objType string) *ListFileVersi return builder } -// 用户id类型 +// 用户 id 类型 // // 示例值： func (builder *ListFileVersionReqBuilder) UserIdType(userIdType string) *ListFileVersionReqBuilder { @@ -7053,7 +7053,7 @@ type ListFileVersionReq struct { type ListFileVersionRespData struct { Items []*Version `json:"items,omitempty"` // 版本文档列表 - PageToken *string `json:"page_token,omitempty"` // 下一页请求token + PageToken *string `json:"page_token,omitempty"` // 下一页请求 token HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 } @@ -7081,7 +7081,7 @@ func NewCreateImportTaskReqBuilder() *CreateImportTaskReqBuilder { return builder } -// 创建导入任务。支持导入为 doc、docx、sheet、bitable，参考[导入用户指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/import-user-guide) +// 创建导入任务。支持导入为 doc、docx、sheet、bitable，参考 [导入用户指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/import-user-guide) func (builder *CreateImportTaskReqBuilder) ImportTask(importTask *ImportTask) *CreateImportTaskReqBuilder { builder.importTask = importTask return builder @@ -7100,7 +7100,7 @@ type CreateImportTaskReq struct { } type CreateImportTaskRespData struct { - Ticket *string `json:"ticket,omitempty"` // 导入任务ID + Ticket *string `json:"ticket,omitempty"` // 导入任务 ID } type CreateImportTaskResp struct { @@ -7126,7 +7126,7 @@ func NewGetImportTaskReqBuilder() *GetImportTaskReqBuilder { return builder } -// 导入任务ID +// 导入任务 ID // // 示例值：6990281865xxxxxxxx7843 func (builder *GetImportTaskReqBuilder) Ticket(ticket string) *GetImportTaskReqBuilder { @@ -7182,9 +7182,9 @@ func (builder *BatchGetTmpDownloadUrlMediaReqBuilder) FileTokens(fileTokens []st return builder } -// 拓展信息(可选) +// 拓展信息 (可选) // -// 示例值：[请参考-上传点类型及对应Extra说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction) +// 示例值：[请参考 - 上传点类型及对应 Extra 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction) func (builder *BatchGetTmpDownloadUrlMediaReqBuilder) Extra(extra string) *BatchGetTmpDownloadUrlMediaReqBuilder { builder.apiReq.QueryParams.Set("extra", fmt.Sprint(extra)) return builder @@ -7238,7 +7238,7 @@ func (builder *DownloadMediaReqBuilder) FileToken(fileToken string) *DownloadMed // 扩展信息 // -// 示例值：[请参考-上传点类型及对应Extra说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction) +// 示例值：[请参考 - 上传点类型及对应 Extra 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction) func (builder *DownloadMediaReqBuilder) Extra(extra string) *DownloadMediaReqBuilder { builder.apiReq.QueryParams.Set("extra", fmt.Sprint(extra)) return builder @@ -7285,13 +7285,13 @@ type UploadAllMediaReqBodyBuilder struct { fileNameFlag bool parentType string // 上传点类型。 parentTypeFlag bool - parentNode string // 上传点的token。 + parentNode string // 上传点的 token。 parentNodeFlag bool size int // 文件大小（以字节为单位）。 sizeFlag bool - checksum string // 文件adler32校验和（可选）。 + checksum string // 文件 adler32 校验和（可选）。 checksumFlag bool - extra string // 扩展信息(可选)。 + extra string // 扩展信息 (可选)。 extraFlag bool file io.Reader // 文件二进制内容。 fileFlag bool @@ -7320,7 +7320,7 @@ func (builder *UploadAllMediaReqBodyBuilder) ParentType(parentType string) *Uplo return builder } -// 上传点的token。 +// 上传点的 token。 // //示例值：doccnFivLCfJfblZjGZtxgabcef func (builder *UploadAllMediaReqBodyBuilder) ParentNode(parentNode string) *UploadAllMediaReqBodyBuilder { @@ -7338,7 +7338,7 @@ func (builder *UploadAllMediaReqBodyBuilder) Size(size int) *UploadAllMediaReqBo return builder } -// 文件adler32校验和（可选）。 +// 文件 adler32 校验和（可选）。 // //示例值：12345678 func (builder *UploadAllMediaReqBodyBuilder) Checksum(checksum string) *UploadAllMediaReqBodyBuilder { @@ -7347,7 +7347,7 @@ func (builder *UploadAllMediaReqBodyBuilder) Checksum(checksum string) *UploadAl return builder } -// 扩展信息(可选)。 +// 扩展信息 (可选)。 // //示例值：{"test":"test"} func (builder *UploadAllMediaReqBodyBuilder) Extra(extra string) *UploadAllMediaReqBodyBuilder { @@ -7396,13 +7396,13 @@ type UploadAllMediaPathReqBodyBuilder struct { fileNameFlag bool parentType string // 上传点类型。 parentTypeFlag bool - parentNode string // 上传点的token。 + parentNode string // 上传点的 token。 parentNodeFlag bool size int // 文件大小（以字节为单位）。 sizeFlag bool - checksum string // 文件adler32校验和（可选）。 + checksum string // 文件 adler32 校验和（可选）。 checksumFlag bool - extra string // 扩展信息(可选)。 + extra string // 扩展信息 (可选)。 extraFlag bool filePath string // 文件二进制内容。 filePathFlag bool @@ -7431,7 +7431,7 @@ func (builder *UploadAllMediaPathReqBodyBuilder) ParentType(parentType string) * return builder } -// 上传点的token。 +// 上传点的 token。 // // 示例值：doccnFivLCfJfblZjGZtxgabcef func (builder *UploadAllMediaPathReqBodyBuilder) ParentNode(parentNode string) *UploadAllMediaPathReqBodyBuilder { @@ -7449,7 +7449,7 @@ func (builder *UploadAllMediaPathReqBodyBuilder) Size(size int) *UploadAllMediaP return builder } -// 文件adler32校验和（可选）。 +// 文件 adler32 校验和（可选）。 // // 示例值：12345678 func (builder *UploadAllMediaPathReqBodyBuilder) Checksum(checksum string) *UploadAllMediaPathReqBodyBuilder { @@ -7458,7 +7458,7 @@ func (builder *UploadAllMediaPathReqBodyBuilder) Checksum(checksum string) *Uplo return builder } -// 扩展信息(可选)。 +// 扩展信息 (可选)。 // // 示例值：{"test":"test"} func (builder *UploadAllMediaPathReqBodyBuilder) Extra(extra string) *UploadAllMediaPathReqBodyBuilder { @@ -7536,10 +7536,10 @@ func (builder *UploadAllMediaReqBuilder) Build() *UploadAllMediaReq { type UploadAllMediaReqBody struct { FileName *string `json:"file_name,omitempty"` // 文件名。 ParentType *string `json:"parent_type,omitempty"` // 上传点类型。 - ParentNode *string `json:"parent_node,omitempty"` // 上传点的token。 + ParentNode *string `json:"parent_node,omitempty"` // 上传点的 token。 Size *int `json:"size,omitempty"` // 文件大小（以字节为单位）。 - Checksum *string `json:"checksum,omitempty"` // 文件adler32校验和（可选）。 - Extra *string `json:"extra,omitempty"` // 扩展信息(可选)。 + Checksum *string `json:"checksum,omitempty"` // 文件 adler32 校验和（可选）。 + Extra *string `json:"extra,omitempty"` // 扩展信息 (可选)。 File io.Reader `json:"file,omitempty"` // 文件二进制内容。 } @@ -7563,7 +7563,7 @@ func (resp *UploadAllMediaResp) Success() bool { } type UploadFinishMediaReqBodyBuilder struct { - uploadId string // 分片上传事务ID + uploadId string // 分片上传事务 ID uploadIdFlag bool blockNum int // 分片数量 blockNumFlag bool @@ -7574,7 +7574,7 @@ func NewUploadFinishMediaReqBodyBuilder() *UploadFinishMediaReqBodyBuilder { return builder } -// 分片上传事务ID +// 分片上传事务 ID // //示例值：7111211691345512356 func (builder *UploadFinishMediaReqBodyBuilder) UploadId(uploadId string) *UploadFinishMediaReqBodyBuilder { @@ -7604,7 +7604,7 @@ func (builder *UploadFinishMediaReqBodyBuilder) Build() *UploadFinishMediaReqBod } type UploadFinishMediaPathReqBodyBuilder struct { - uploadId string // 分片上传事务ID + uploadId string // 分片上传事务 ID uploadIdFlag bool blockNum int // 分片数量 blockNumFlag bool @@ -7615,7 +7615,7 @@ func NewUploadFinishMediaPathReqBodyBuilder() *UploadFinishMediaPathReqBodyBuild return builder } -// 分片上传事务ID +// 分片上传事务 ID // // 示例值：7111211691345512356 func (builder *UploadFinishMediaPathReqBodyBuilder) UploadId(uploadId string) *UploadFinishMediaPathReqBodyBuilder { @@ -7672,7 +7672,7 @@ func (builder *UploadFinishMediaReqBuilder) Build() *UploadFinishMediaReq { } type UploadFinishMediaReqBody struct { - UploadId *string `json:"upload_id,omitempty"` // 分片上传事务ID + UploadId *string `json:"upload_id,omitempty"` // 分片上传事务 ID BlockNum *int `json:"block_num,omitempty"` // 分片数量 } @@ -7696,13 +7696,13 @@ func (resp *UploadFinishMediaResp) Success() bool { } type UploadPartMediaReqBodyBuilder struct { - uploadId string // 分片上传事务ID。 + uploadId string // 分片上传事务 ID。 uploadIdFlag bool - seq int // 块号，从0开始计数。 + seq int // 块号，从 0 开始计数。 seqFlag bool size int // 块大小（以字节为单位）。 sizeFlag bool - checksum string // 文件分块adler32校验和(可选)。 + checksum string // 文件分块 adler32 校验和 (可选)。 checksumFlag bool file io.Reader // 文件分片二进制内容。 fileFlag bool @@ -7713,7 +7713,7 @@ func NewUploadPartMediaReqBodyBuilder() *UploadPartMediaReqBodyBuilder { return builder } -// 分片上传事务ID。 +// 分片上传事务 ID。 // //示例值：7111211691345512356 func (builder *UploadPartMediaReqBodyBuilder) UploadId(uploadId string) *UploadPartMediaReqBodyBuilder { @@ -7722,7 +7722,7 @@ func (builder *UploadPartMediaReqBodyBuilder) UploadId(uploadId string) *UploadP return builder } -// 块号，从0开始计数。 +// 块号，从 0 开始计数。 // //示例值：0 func (builder *UploadPartMediaReqBodyBuilder) Seq(seq int) *UploadPartMediaReqBodyBuilder { @@ -7740,7 +7740,7 @@ func (builder *UploadPartMediaReqBodyBuilder) Size(size int) *UploadPartMediaReq return builder } -// 文件分块adler32校验和(可选)。 +// 文件分块 adler32 校验和 (可选)。 // //示例值：12345678 func (builder *UploadPartMediaReqBodyBuilder) Checksum(checksum string) *UploadPartMediaReqBodyBuilder { @@ -7779,13 +7779,13 @@ func (builder *UploadPartMediaReqBodyBuilder) Build() *UploadPartMediaReqBody { } type UploadPartMediaPathReqBodyBuilder struct { - uploadId string // 分片上传事务ID。 + uploadId string // 分片上传事务 ID。 uploadIdFlag bool - seq int // 块号，从0开始计数。 + seq int // 块号，从 0 开始计数。 seqFlag bool size int // 块大小（以字节为单位）。 sizeFlag bool - checksum string // 文件分块adler32校验和(可选)。 + checksum string // 文件分块 adler32 校验和 (可选)。 checksumFlag bool filePath string // 文件分片二进制内容。 filePathFlag bool @@ -7796,7 +7796,7 @@ func NewUploadPartMediaPathReqBodyBuilder() *UploadPartMediaPathReqBodyBuilder { return builder } -// 分片上传事务ID。 +// 分片上传事务 ID。 // // 示例值：7111211691345512356 func (builder *UploadPartMediaPathReqBodyBuilder) UploadId(uploadId string) *UploadPartMediaPathReqBodyBuilder { @@ -7805,7 +7805,7 @@ func (builder *UploadPartMediaPathReqBodyBuilder) UploadId(uploadId string) *Upl return builder } -// 块号，从0开始计数。 +// 块号，从 0 开始计数。 // // 示例值：0 func (builder *UploadPartMediaPathReqBodyBuilder) Seq(seq int) *UploadPartMediaPathReqBodyBuilder { @@ -7823,7 +7823,7 @@ func (builder *UploadPartMediaPathReqBodyBuilder) Size(size int) *UploadPartMedi return builder } -// 文件分块adler32校验和(可选)。 +// 文件分块 adler32 校验和 (可选)。 // // 示例值：12345678 func (builder *UploadPartMediaPathReqBodyBuilder) Checksum(checksum string) *UploadPartMediaPathReqBodyBuilder { @@ -7893,10 +7893,10 @@ func (builder *UploadPartMediaReqBuilder) Build() *UploadPartMediaReq { } type UploadPartMediaReqBody struct { - UploadId *string `json:"upload_id,omitempty"` // 分片上传事务ID。 - Seq *int `json:"seq,omitempty"` // 块号，从0开始计数。 + UploadId *string `json:"upload_id,omitempty"` // 分片上传事务 ID。 + Seq *int `json:"seq,omitempty"` // 块号，从 0 开始计数。 Size *int `json:"size,omitempty"` // 块大小（以字节为单位）。 - Checksum *string `json:"checksum,omitempty"` // 文件分块adler32校验和(可选)。 + Checksum *string `json:"checksum,omitempty"` // 文件分块 adler32 校验和 (可选)。 File io.Reader `json:"file,omitempty"` // 文件分片二进制内容。 } @@ -7928,7 +7928,7 @@ func NewUploadPrepareMediaReqBuilder() *UploadPrepareMediaReqBuilder { return builder } -// 发送初始化请求获取上传事务ID和分块策略，目前是以4MB大小进行定长分片。 +// 发送初始化请求获取上传事务 ID 和分块策略，目前是以 4MB 大小进行定长分片。 func (builder *UploadPrepareMediaReqBuilder) MediaUploadInfo(mediaUploadInfo *MediaUploadInfo) *UploadPrepareMediaReqBuilder { builder.mediaUploadInfo = mediaUploadInfo return builder @@ -7947,7 +7947,7 @@ type UploadPrepareMediaReq struct { } type UploadPrepareMediaRespData struct { - UploadId *string `json:"upload_id,omitempty"` // 分片上传事务ID + UploadId *string `json:"upload_id,omitempty"` // 分片上传事务 ID BlockSize *int `json:"block_size,omitempty"` // 分片大小策略 BlockNum *int `json:"block_num,omitempty"` // 分片数量 } @@ -7976,7 +7976,7 @@ func NewBatchQueryMetaReqBuilder() *BatchQueryMetaReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchQueryMetaReqBuilder) UserIdType(userIdType string) *BatchQueryMetaReqBuilder { @@ -8248,7 +8248,7 @@ func (builder *ListPermissionMemberReqBuilder) Type(type_ string) *ListPermissio return builder } -// 指定返回的协作者字段信息，如无指定则默认不返回;;**可选值有：** ;- `name`：协作者名;- `type`：协作者类型;- `avatar`：头像;- `external_label`：外部标签;;**注意：** ;- 你可以使用特殊值`*`指定返回目前支持的所有字段;- 你可以使用`,`分隔若干个你想指定返回的字段，如：`name,avatar`;- 按需指定返回字段接口性能更好 +// 指定返回的协作者字段信息，如无指定则默认不返回;;** 可选值有：** ;- `name`：协作者名;- `type`：协作者类型;- `avatar`：头像;- `external_label`：外部标签;;** 注意：** ;- 你可以使用特殊值`*`指定返回目前支持的所有字段;- 你可以使用`,`分隔若干个你想指定返回的字段，如：`name,avatar`;- 按需指定返回字段接口性能更好 // // 示例值：* func (builder *ListPermissionMemberReqBuilder) Fields(fields string) *ListPermissionMemberReqBuilder { @@ -8387,7 +8387,7 @@ func (builder *UpdatePermissionMemberReqBuilder) MemberId(memberId string) *Upda return builder } -// 更新权限后是否通知对方;;**注意：** 使用`tenant_access_token`访问不支持该参数 +// 更新权限后是否通知对方;;** 注意：** 使用`tenant_access_token`访问不支持该参数 // // 示例值：false func (builder *UpdatePermissionMemberReqBuilder) NeedNotification(needNotification bool) *UpdatePermissionMemberReqBuilder { @@ -8558,12 +8558,12 @@ func (resp *PatchPermissionPublicResp) Success() bool { type P2FileBitableFieldChangedV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - TableId *string `json:"table_id,omitempty"` // 多维表格数据表ID + FileToken *string `json:"file_token,omitempty"` // 文档 token + TableId *string `json:"table_id,omitempty"` // 多维表格数据表 ID OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID ActionList []*BitableTableFieldAction `json:"action_list,omitempty"` // 字段变更操作列表 Revision *int `json:"revision,omitempty"` // 多维表格数据表的版本号 - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 UpdateTime *int `json:"update_time,omitempty"` // 字段变更时间 } @@ -8579,9 +8579,9 @@ func (m *P2FileBitableFieldChangedV1) RawReq(req *larkevent.EventReq) { type P2FileDeletedV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorId *UserId `json:"operator_id,omitempty"` // 操作者id - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorId *UserId `json:"operator_id,omitempty"` // 操作者 id + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 } type P2FileDeletedV1 struct { @@ -8596,10 +8596,10 @@ func (m *P2FileDeletedV1) RawReq(req *larkevent.EventReq) { type P2FileEditV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorIdList []*UserId `json:"operator_id_list,omitempty"` // 操作者id列表 - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 - SheetId *string `json:"sheet_id,omitempty"` // 表格的子SheetID，当表格发生编辑时将会包含此字段 + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorIdList []*UserId `json:"operator_id_list,omitempty"` // 操作者 id 列表 + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 + SheetId *string `json:"sheet_id,omitempty"` // 表格的子 SheetID，当表格发生编辑时将会包含此字段 } type P2FileEditV1 struct { @@ -8614,12 +8614,12 @@ func (m *P2FileEditV1) RawReq(req *larkevent.EventReq) { type P2FilePermissionMemberAddedV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorId *UserId `json:"operator_id,omitempty"` // 操作者id + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorId *UserId `json:"operator_id,omitempty"` // 操作者 id UserList []*UserId `json:"user_list,omitempty"` // 添加的用户列表 ChatList []string `json:"chat_list,omitempty"` // OpenDepartmentIdList []string `json:"open_department_id_list,omitempty"` // - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 } type P2FilePermissionMemberAddedV1 struct { @@ -8634,12 +8634,12 @@ func (m *P2FilePermissionMemberAddedV1) RawReq(req *larkevent.EventReq) { type P2FilePermissionMemberRemovedV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorId *UserId `json:"operator_id,omitempty"` // 操作者id + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorId *UserId `json:"operator_id,omitempty"` // 操作者 id UserList []*UserId `json:"user_list,omitempty"` // 移除的用户列表 ChatList []string `json:"chat_list,omitempty"` // OpenDepartmentIdList []string `json:"open_department_id_list,omitempty"` // - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 } type P2FilePermissionMemberRemovedV1 struct { @@ -8654,9 +8654,9 @@ func (m *P2FilePermissionMemberRemovedV1) RawReq(req *larkevent.EventReq) { type P2FileReadV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorIdList []*UserId `json:"operator_id_list,omitempty"` // 操作者id列表 - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorIdList []*UserId `json:"operator_id_list,omitempty"` // 操作者 id 列表 + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 } type P2FileReadV1 struct { @@ -8671,9 +8671,9 @@ func (m *P2FileReadV1) RawReq(req *larkevent.EventReq) { type P2FileTitleUpdatedV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorId *UserId `json:"operator_id,omitempty"` // 操作者id - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorId *UserId `json:"operator_id,omitempty"` // 操作者 id + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 } type P2FileTitleUpdatedV1 struct { @@ -8688,9 +8688,9 @@ func (m *P2FileTitleUpdatedV1) RawReq(req *larkevent.EventReq) { type P2FileTrashedV1Data struct { FileType *string `json:"file_type,omitempty"` // 文档类型 - FileToken *string `json:"file_token,omitempty"` // 文档token - OperatorId *UserId `json:"operator_id,omitempty"` // 操作者id - SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户id列表 + FileToken *string `json:"file_token,omitempty"` // 文档 token + OperatorId *UserId `json:"operator_id,omitempty"` // 操作者 id + SubscriberIdList []*UserId `json:"subscriber_id_list,omitempty"` // 订阅用户 id 列表 } type P2FileTrashedV1 struct { @@ -8721,7 +8721,7 @@ func (iterator *ListFileCommentIterator) Next() (bool, *FileComment, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -8775,7 +8775,7 @@ func (iterator *ListFileVersionIterator) Next() (bool, *Version, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/ehr/v1/api.go b/service/ehr/v1/api.go index 53c18a34..60358248 100644 --- a/service/ehr/v1/api.go +++ b/service/ehr/v1/api.go @@ -43,13 +43,13 @@ type employee struct { // 下载附件 // -// - 根据文件 token 下载文件。;;调用 「批量获取员工花名册信息」接口的返回值中，「文件」类型的字段 id，即是文件 token +// - 根据文件 token 下载文件。;;调用「批量获取员工花名册信息」接口的返回值中，「文件」类型的字段 id，即是文件 token // // - ![image.png](//sf1-ttcdn-tos.pstatp.com/obj/open-platform-opendoc/bed391d2a8ce6ed2d5985ea69bf92850_9GY1mnuDXP.png) // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/attachment/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/attachment/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/ehrv1/get_attachment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/ehrv1/get_attachment.go func (a *attachment) Get(ctx context.Context, req *GetAttachmentReq, options ...larkcore.RequestOptionFunc) (*GetAttachmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -79,9 +79,9 @@ func (a *attachment) Get(ctx context.Context, req *GetAttachmentReq, options ... // // - 根据员工飞书用户 ID / 员工状态 / 雇员类型等搜索条件 ，批量获取员工花名册字段信息。字段包括「系统标准字段 / system_fields」和「自定义字段 / custom_fields」 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/employee/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/employee/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/ehrv1/list_employee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/ehrv1/list_employee.go func (e *employee) List(ctx context.Context, req *ListEmployeeReq, options ...larkcore.RequestOptionFunc) (*ListEmployeeResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/ehr/v1/model.go b/service/ehr/v1/model.go index 49db7b87..753184d8 100644 --- a/service/ehr/v1/model.go +++ b/service/ehr/v1/model.go @@ -27,14 +27,14 @@ import ( ) const ( - ViewBasic = "basic" // 概览, 只返回 id、name 等基本信息 + ViewBasic = "basic" // 概览，只返回 id、name 等基本信息 ViewFull = "full" // 返回详细信息 ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) type Attachment struct { @@ -166,14 +166,14 @@ func (builder *ContractCompanyBuilder) Build() *ContractCompany { } type CustomFields struct { - Key *string `json:"key,omitempty"` // 自定义字段key + Key *string `json:"key,omitempty"` // 自定义字段 key Label *string `json:"label,omitempty"` // 自定义字段名称 Type *string `json:"type,omitempty"` // 自定义字段类型 Value *string `json:"value,omitempty"` // 根据 type 不同，结构不同，不同 type 对应的数据结构在 type 的枚举值中有描述 } type CustomFieldsBuilder struct { - key string // 自定义字段key + key string // 自定义字段 key keyFlag bool label string // 自定义字段名称 labelFlag bool @@ -188,7 +188,7 @@ func NewCustomFieldsBuilder() *CustomFieldsBuilder { return builder } -// 自定义字段key +// 自定义字段 key // // 示例值：field_xxxxxxxx func (builder *CustomFieldsBuilder) Key(key string) *CustomFieldsBuilder { @@ -285,7 +285,7 @@ func (builder *EducationBuilder) Level(level int) *EducationBuilder { // 毕业学校 // -// 示例值：XXXX大学 +// 示例值：XXXX 大学 func (builder *EducationBuilder) School(school string) *EducationBuilder { builder.school = school builder.schoolFlag = true @@ -294,7 +294,7 @@ func (builder *EducationBuilder) School(school string) *EducationBuilder { // 专业 // -// 示例值：XXX专业 +// 示例值：XXX 专业 func (builder *EducationBuilder) Major(major string) *EducationBuilder { builder.major = major builder.majorFlag = true @@ -1058,7 +1058,7 @@ func (builder *SystemFieldsBuilder) HukouType(hukouType int) *SystemFieldsBuilde // 户口所在地 // -// 示例值：北京市海淀区XXXX +// 示例值：北京市海淀区 XXXX func (builder *SystemFieldsBuilder) HukouLocation(hukouLocation string) *SystemFieldsBuilder { builder.hukouLocation = hukouLocation builder.hukouLocationFlag = true @@ -1265,7 +1265,7 @@ func (builder *SystemFieldsBuilder) PersonalEmail(personalEmail string) *SystemF // 家庭地址 // -// 示例值：北京市海淀区XXXXX +// 示例值：北京市海淀区 XXXXX func (builder *SystemFieldsBuilder) FamilyAddress(familyAddress string) *SystemFieldsBuilder { builder.familyAddress = familyAddress builder.familyAddressFlag = true @@ -1695,7 +1695,7 @@ func NewWorkExperienceBuilder() *WorkExperienceBuilder { // 公司 // -// 示例值：XXXX公司 +// 示例值：XXXX 公司 func (builder *WorkExperienceBuilder) Company(company string) *WorkExperienceBuilder { builder.company = company builder.companyFlag = true @@ -1704,7 +1704,7 @@ func (builder *WorkExperienceBuilder) Company(company string) *WorkExperienceBui // 部门 // -// 示例值：部门1 +// 示例值：部门 1 func (builder *WorkExperienceBuilder) Department(department string) *WorkExperienceBuilder { builder.department = department builder.departmentFlag = true @@ -1944,7 +1944,7 @@ func (builder *ListEmployeeReqBuilder) EndTime(endTime string) *ListEmployeeReqB return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListEmployeeReqBuilder) UserIdType(userIdType string) *ListEmployeeReqBuilder { @@ -1962,7 +1962,7 @@ func (builder *ListEmployeeReqBuilder) UserIds(userIds []string) *ListEmployeeRe return builder } -// 分页标记，第一次请求可以不填，表示从头开始遍历；分页查询返回结果has_more 为 true 时会同时返回新的 page_token, 下次遍历可使用该返回的 page_token 获取更多信息。 +// 分页标记，第一次请求可以不填，表示从头开始遍历；分页查询返回结果 has_more 为 true 时会同时返回新的 page_token，下次遍历可使用该返回的 page_token 获取更多信息。 // // 示例值：10 func (builder *ListEmployeeReqBuilder) PageToken(pageToken string) *ListEmployeeReqBuilder { @@ -2026,7 +2026,7 @@ func (iterator *ListEmployeeIterator) Next() (bool, *Employee, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/event/v1/api.go b/service/event/v1/api.go index 63731eae..11de965b 100644 --- a/service/event/v1/api.go +++ b/service/event/v1/api.go @@ -41,9 +41,9 @@ type outboundIp struct { // // - IP 地址有变更可能，建议应用每隔 6 小时定时拉取最新的 IP 地址，以免由于企业防火墙设置，导致应用无法及时接收到飞书开放平台推送的事件。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-v1/outbound_ip/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-v1/outbound_ip/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/eventv1/list_outboundIp.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/eventv1/list_outboundIp.go func (o *outboundIp) List(ctx context.Context, req *ListOutboundIpReq, options ...larkcore.RequestOptionFunc) (*ListOutboundIpResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/event/v1/model.go b/service/event/v1/model.go index d3da1027..f8adc95d 100644 --- a/service/event/v1/model.go +++ b/service/event/v1/model.go @@ -42,7 +42,7 @@ func (builder *ListOutboundIpReqBuilder) Limit(limit int) *ListOutboundIpReqBuil return builder } -// 分页大小，默认10，取值范围 10-50 +// 分页大小，默认 10，取值范围 10-50 // // 示例值：10 func (builder *ListOutboundIpReqBuilder) PageSize(pageSize int) *ListOutboundIpReqBuilder { @@ -74,7 +74,7 @@ type ListOutboundIpReq struct { type ListOutboundIpRespData struct { IpList []string `json:"ip_list,omitempty"` // outbound ip - PageToken *string `json:"page_token,omitempty"` // 分页下次调用的page_token值 + PageToken *string `json:"page_token,omitempty"` // 分页下次调用的 page_token 值 HasMore *bool `json:"has_more,omitempty"` // 是否还有分页数据 } @@ -106,7 +106,7 @@ func (iterator *ListOutboundIpIterator) Next() (bool, string, error) { return false, "", nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, "", nil diff --git a/service/face_detection/v1/api.go b/service/face_detection/v1/api.go index 3f6f98a2..990efbc5 100644 --- a/service/face_detection/v1/api.go +++ b/service/face_detection/v1/api.go @@ -41,9 +41,9 @@ type image struct { // // - 注意：返回值为 -1 表示该功能还暂未实现 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/face_detection-v1/image/detect_face_attributes +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/face_detection-v1/image/detect_face_attributes // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/face_detectionv1/detectFaceAttributes_image.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/face_detectionv1/detectFaceAttributes_image.go func (i *image) DetectFaceAttributes(ctx context.Context, req *DetectFaceAttributesImageReq, options ...larkcore.RequestOptionFunc) (*DetectFaceAttributesImageResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/gray_test_open_sg/v1/api.go b/service/gray_test_open_sg/v1/api.go index b59ef7e9..80e9ce9b 100644 --- a/service/gray_test_open_sg/v1/api.go +++ b/service/gray_test_open_sg/v1/api.go @@ -39,9 +39,9 @@ type moto struct { // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=gray_test_open_sg&resource=moto&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=gray_test_open_sg&resource=moto&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/gray_test_open_sgv1/create_moto.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/gray_test_open_sgv1/create_moto.go func (m *moto) Create(ctx context.Context, req *CreateMotoReq, options ...larkcore.RequestOptionFunc) (*CreateMotoResp, error) { // 发起请求 apiReq := req.apiReq @@ -65,9 +65,9 @@ func (m *moto) Create(ctx context.Context, req *CreateMotoReq, options ...larkco // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=gray_test_open_sg&resource=moto&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=gray_test_open_sg&resource=moto&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/gray_test_open_sgv1/get_moto.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/gray_test_open_sgv1/get_moto.go func (m *moto) Get(ctx context.Context, req *GetMotoReq, options ...larkcore.RequestOptionFunc) (*GetMotoResp, error) { // 发起请求 apiReq := req.apiReq @@ -91,9 +91,9 @@ func (m *moto) Get(ctx context.Context, req *GetMotoReq, options ...larkcore.Req // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=gray_test_open_sg&resource=moto&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=gray_test_open_sg&resource=moto&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/gray_test_open_sgv1/list_moto.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/gray_test_open_sgv1/list_moto.go func (m *moto) List(ctx context.Context, req *ListMotoReq, options ...larkcore.RequestOptionFunc) (*ListMotoResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/gray_test_open_sg/v1/model.go b/service/gray_test_open_sg/v1/model.go index 6ee994f9..448e71b8 100644 --- a/service/gray_test_open_sg/v1/model.go +++ b/service/gray_test_open_sg/v1/model.go @@ -376,7 +376,7 @@ func (iterator *ListMotoIterator) Next() (bool, string, error) { return false, "", nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, "", nil diff --git a/service/helpdesk/v1/api.go b/service/helpdesk/v1/api.go index d80911b4..95bb537b 100644 --- a/service/helpdesk/v1/api.go +++ b/service/helpdesk/v1/api.go @@ -100,9 +100,9 @@ type ticketCustomizedField struct { // // - 该接口用于获取客服邮箱地址 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent/agent_email +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent/agent_email // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/agentEmail_agent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/agentEmail_agent.go func (a *agent) AgentEmail(ctx context.Context, options ...larkcore.RequestOptionFunc) (*AgentEmailAgentResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -129,9 +129,9 @@ func (a *agent) AgentEmail(ctx context.Context, options ...larkcore.RequestOptio // // - 更新客服状态等信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_agent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_agent.go func (a *agent) Patch(ctx context.Context, req *PatchAgentReq, options ...larkcore.RequestOptionFunc) (*PatchAgentResp, error) { // 发起请求 apiReq := req.apiReq @@ -155,9 +155,9 @@ func (a *agent) Patch(ctx context.Context, req *PatchAgentReq, options ...larkco // // - 该接口用于删除客服 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent-schedules/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent-schedules/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_agentSchedules.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_agentSchedules.go func (a *agentSchedules) Delete(ctx context.Context, req *DeleteAgentSchedulesReq, options ...larkcore.RequestOptionFunc) (*DeleteAgentSchedulesResp, error) { // 发起请求 apiReq := req.apiReq @@ -181,9 +181,9 @@ func (a *agentSchedules) Delete(ctx context.Context, req *DeleteAgentSchedulesRe // // - 该接口用于获取客服信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent-schedules/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent-schedules/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_agentSchedules.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_agentSchedules.go func (a *agentSchedules) Get(ctx context.Context, req *GetAgentSchedulesReq, options ...larkcore.RequestOptionFunc) (*GetAgentSchedulesResp, error) { // 发起请求 apiReq := req.apiReq @@ -207,9 +207,9 @@ func (a *agentSchedules) Get(ctx context.Context, req *GetAgentSchedulesReq, opt // // - 该接口用于更新客服的日程 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent-schedules/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent-schedules/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_agentSchedules.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_agentSchedules.go func (a *agentSchedules) Patch(ctx context.Context, req *PatchAgentSchedulesReq, options ...larkcore.RequestOptionFunc) (*PatchAgentSchedulesResp, error) { // 发起请求 apiReq := req.apiReq @@ -233,9 +233,9 @@ func (a *agentSchedules) Patch(ctx context.Context, req *PatchAgentSchedulesReq, // // - 该接口用于创建客服 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_schedule/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_schedule/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_agentSchedule.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_agentSchedule.go func (a *agentSchedule) Create(ctx context.Context, req *CreateAgentScheduleReq, options ...larkcore.RequestOptionFunc) (*CreateAgentScheduleResp, error) { // 发起请求 apiReq := req.apiReq @@ -259,9 +259,9 @@ func (a *agentSchedule) Create(ctx context.Context, req *CreateAgentScheduleReq, // // - 该接口用于获取所有客服信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_schedule/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_schedule/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_agentSchedule.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_agentSchedule.go func (a *agentSchedule) List(ctx context.Context, req *ListAgentScheduleReq, options ...larkcore.RequestOptionFunc) (*ListAgentScheduleResp, error) { // 发起请求 apiReq := req.apiReq @@ -285,9 +285,9 @@ func (a *agentSchedule) List(ctx context.Context, req *ListAgentScheduleReq, opt // // - 该接口用于创建客服技能 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_agentSkill.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_agentSkill.go func (a *agentSkill) Create(ctx context.Context, req *CreateAgentSkillReq, options ...larkcore.RequestOptionFunc) (*CreateAgentSkillResp, error) { // 发起请求 apiReq := req.apiReq @@ -311,9 +311,9 @@ func (a *agentSkill) Create(ctx context.Context, req *CreateAgentSkillReq, optio // // - 该接口用于删除客服技能 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_agentSkill.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_agentSkill.go func (a *agentSkill) Delete(ctx context.Context, req *DeleteAgentSkillReq, options ...larkcore.RequestOptionFunc) (*DeleteAgentSkillResp, error) { // 发起请求 apiReq := req.apiReq @@ -337,9 +337,9 @@ func (a *agentSkill) Delete(ctx context.Context, req *DeleteAgentSkillReq, optio // // - 该接口用于获取客服技能 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_agentSkill.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_agentSkill.go func (a *agentSkill) Get(ctx context.Context, req *GetAgentSkillReq, options ...larkcore.RequestOptionFunc) (*GetAgentSkillResp, error) { // 发起请求 apiReq := req.apiReq @@ -363,9 +363,9 @@ func (a *agentSkill) Get(ctx context.Context, req *GetAgentSkillReq, options ... // // - 获取全部客服技能 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_agentSkill.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_agentSkill.go func (a *agentSkill) List(ctx context.Context, options ...larkcore.RequestOptionFunc) (*ListAgentSkillResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -392,9 +392,9 @@ func (a *agentSkill) List(ctx context.Context, options ...larkcore.RequestOption // // - 该接口用于更新客服技能 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_agentSkill.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_agentSkill.go func (a *agentSkill) Patch(ctx context.Context, req *PatchAgentSkillReq, options ...larkcore.RequestOptionFunc) (*PatchAgentSkillResp, error) { // 发起请求 apiReq := req.apiReq @@ -418,9 +418,9 @@ func (a *agentSkill) Patch(ctx context.Context, req *PatchAgentSkillReq, options // // - 该接口用于获取全部客服技能。仅支持自建应用。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_agentSkillRule.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_agentSkillRule.go func (a *agentSkillRule) List(ctx context.Context, options ...larkcore.RequestOptionFunc) (*ListAgentSkillRuleResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -447,9 +447,9 @@ func (a *agentSkillRule) List(ctx context.Context, options ...larkcore.RequestOp // // - 通过服务台机器人给指定用户的服务台专属群或私聊发送消息，支持文本、富文本、卡片、图片。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/bot-message/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/bot-message/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_botMessage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_botMessage.go func (b *botMessage) Create(ctx context.Context, req *CreateBotMessageReq, options ...larkcore.RequestOptionFunc) (*CreateBotMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -473,9 +473,9 @@ func (b *botMessage) Create(ctx context.Context, req *CreateBotMessageReq, optio // // - 该接口用于创建知识库分类。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_category.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_category.go func (c *category) Create(ctx context.Context, req *CreateCategoryReq, options ...larkcore.RequestOptionFunc) (*CreateCategoryResp, error) { // 发起请求 apiReq := req.apiReq @@ -499,9 +499,9 @@ func (c *category) Create(ctx context.Context, req *CreateCategoryReq, options . // // - 该接口用于删除知识库分类详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_category.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_category.go func (c *category) Delete(ctx context.Context, req *DeleteCategoryReq, options ...larkcore.RequestOptionFunc) (*DeleteCategoryResp, error) { // 发起请求 apiReq := req.apiReq @@ -525,9 +525,9 @@ func (c *category) Delete(ctx context.Context, req *DeleteCategoryReq, options . // // - 该接口用于获取知识库分类。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_category.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_category.go func (c *category) Get(ctx context.Context, req *GetCategoryReq, options ...larkcore.RequestOptionFunc) (*GetCategoryResp, error) { // 发起请求 apiReq := req.apiReq @@ -551,9 +551,9 @@ func (c *category) Get(ctx context.Context, req *GetCategoryReq, options ...lark // // - 该接口用于获取服务台知识库所有分类 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_category.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_category.go func (c *category) List(ctx context.Context, req *ListCategoryReq, options ...larkcore.RequestOptionFunc) (*ListCategoryResp, error) { // 发起请求 apiReq := req.apiReq @@ -577,9 +577,9 @@ func (c *category) List(ctx context.Context, req *ListCategoryReq, options ...la // // - 该接口用于更新知识库分类详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/category/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_category.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_category.go func (c *category) Patch(ctx context.Context, req *PatchCategoryReq, options ...larkcore.RequestOptionFunc) (*PatchCategoryResp, error) { // 发起请求 apiReq := req.apiReq @@ -603,9 +603,9 @@ func (c *category) Patch(ctx context.Context, req *PatchCategoryReq, options ... // // - 用于订阅服务台事件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/event/subscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/event/subscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/subscribe_event.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/subscribe_event.go func (e *event) Subscribe(ctx context.Context, req *SubscribeEventReq, options ...larkcore.RequestOptionFunc) (*SubscribeEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -629,9 +629,9 @@ func (e *event) Subscribe(ctx context.Context, req *SubscribeEventReq, options . // // - 用于取消订阅服务台事件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/event/unsubscribe +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/event/unsubscribe // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/unsubscribe_event.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/unsubscribe_event.go func (e *event) Unsubscribe(ctx context.Context, req *UnsubscribeEventReq, options ...larkcore.RequestOptionFunc) (*UnsubscribeEventResp, error) { // 发起请求 apiReq := req.apiReq @@ -655,9 +655,9 @@ func (e *event) Unsubscribe(ctx context.Context, req *UnsubscribeEventReq, optio // // - 该接口用于创建知识库。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_faq.go func (f *faq) Create(ctx context.Context, req *CreateFaqReq, options ...larkcore.RequestOptionFunc) (*CreateFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -681,9 +681,9 @@ func (f *faq) Create(ctx context.Context, req *CreateFaqReq, options ...larkcore // // - 该接口用于删除知识库。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_faq.go func (f *faq) Delete(ctx context.Context, req *DeleteFaqReq, options ...larkcore.RequestOptionFunc) (*DeleteFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -707,9 +707,9 @@ func (f *faq) Delete(ctx context.Context, req *DeleteFaqReq, options ...larkcore // // - 该接口用于获取知识库图像。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/faq_image +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/faq_image // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/faqImage_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/faqImage_faq.go func (f *faq) FaqImage(ctx context.Context, req *FaqImageFaqReq, options ...larkcore.RequestOptionFunc) (*FaqImageFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -739,9 +739,9 @@ func (f *faq) FaqImage(ctx context.Context, req *FaqImageFaqReq, options ...lark // // - 该接口用于获取服务台知识库详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_faq.go func (f *faq) Get(ctx context.Context, req *GetFaqReq, options ...larkcore.RequestOptionFunc) (*GetFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -765,9 +765,9 @@ func (f *faq) Get(ctx context.Context, req *GetFaqReq, options ...larkcore.Reque // // - 该接口用于获取服务台知识库详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_faq.go func (f *faq) List(ctx context.Context, req *ListFaqReq, options ...larkcore.RequestOptionFunc) (*ListFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -799,9 +799,9 @@ func (f *faq) ListByIterator(ctx context.Context, req *ListFaqReq, options ...la // // - 该接口用于修改知识库。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_faq.go func (f *faq) Patch(ctx context.Context, req *PatchFaqReq, options ...larkcore.RequestOptionFunc) (*PatchFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -825,9 +825,9 @@ func (f *faq) Patch(ctx context.Context, req *PatchFaqReq, options ...larkcore.R // // - 该接口用于搜索服务台知识库。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/faq/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/search_faq.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/search_faq.go func (f *faq) Search(ctx context.Context, req *SearchFaqReq, options ...larkcore.RequestOptionFunc) (*SearchFaqResp, error) { // 发起请求 apiReq := req.apiReq @@ -859,9 +859,9 @@ func (f *faq) SearchByIterator(ctx context.Context, req *SearchFaqReq, options . // // - 提交审核后，如果需要取消审核，则调用此接口 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/cancel_approve +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/cancel_approve // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/cancelApprove_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/cancelApprove_notification.go func (n *notification) CancelApprove(ctx context.Context, req *CancelApproveNotificationReq, options ...larkcore.RequestOptionFunc) (*CancelApproveNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -885,9 +885,9 @@ func (n *notification) CancelApprove(ctx context.Context, req *CancelApproveNoti // // - 取消推送接口，审核通过后待调度可以调用，发送过程中可以调用（会撤回已发送的消息），发送完成后可以需要推送（会撤回所有已发送的消息） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/cancel_send +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/cancel_send // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/cancelSend_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/cancelSend_notification.go func (n *notification) CancelSend(ctx context.Context, req *CancelSendNotificationReq, options ...larkcore.RequestOptionFunc) (*CancelSendNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -911,9 +911,9 @@ func (n *notification) CancelSend(ctx context.Context, req *CancelSendNotificati // // - 调用接口创建推送，创建成功后为草稿状态 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_notification.go func (n *notification) Create(ctx context.Context, req *CreateNotificationReq, options ...larkcore.RequestOptionFunc) (*CreateNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -937,9 +937,9 @@ func (n *notification) Create(ctx context.Context, req *CreateNotificationReq, o // // - 审核通过后调用此接口设置推送时间，等待调度系统调度，发送消息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/execute_send +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/execute_send // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/executeSend_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/executeSend_notification.go func (n *notification) ExecuteSend(ctx context.Context, req *ExecuteSendNotificationReq, options ...larkcore.RequestOptionFunc) (*ExecuteSendNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -963,9 +963,9 @@ func (n *notification) ExecuteSend(ctx context.Context, req *ExecuteSendNotifica // // - 查询推送详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_notification.go func (n *notification) Get(ctx context.Context, req *GetNotificationReq, options ...larkcore.RequestOptionFunc) (*GetNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -989,9 +989,9 @@ func (n *notification) Get(ctx context.Context, req *GetNotificationReq, options // // - 更新推送信息，只有在草稿状态下才可以调用此接口进行更新 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_notification.go func (n *notification) Patch(ctx context.Context, req *PatchNotificationReq, options ...larkcore.RequestOptionFunc) (*PatchNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -1015,9 +1015,9 @@ func (n *notification) Patch(ctx context.Context, req *PatchNotificationReq, opt // // - 在正式执行推送之前是可以调用此接口预览设置的推送内容 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/preview +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/preview // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/preview_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/preview_notification.go func (n *notification) Preview(ctx context.Context, req *PreviewNotificationReq, options ...larkcore.RequestOptionFunc) (*PreviewNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -1039,11 +1039,11 @@ func (n *notification) Preview(ctx context.Context, req *PreviewNotificationReq, // 提交审核 // -// - 正常情况下调用创建推送接口后，就可以调用提交审核接口，如果创建人是服务台owner则会自动审核通过，否则会通知服务台owner审核此推送信息 +// - 正常情况下调用创建推送接口后，就可以调用提交审核接口，如果创建人是服务台 owner 则会自动审核通过，否则会通知服务台 owner 审核此推送信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/submit_approve +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/notification/submit_approve // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/submitApprove_notification.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/submitApprove_notification.go func (n *notification) SubmitApprove(ctx context.Context, req *SubmitApproveNotificationReq, options ...larkcore.RequestOptionFunc) (*SubmitApproveNotificationResp, error) { // 发起请求 apiReq := req.apiReq @@ -1067,9 +1067,9 @@ func (n *notification) SubmitApprove(ctx context.Context, req *SubmitApproveNoti // // - 该接口用于回复用户提问结果至工单，需要工单仍处于进行中且未接入人工状态。仅支持自建应用。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/answer_user_query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/answer_user_query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/answerUserQuery_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/answerUserQuery_ticket.go func (t *ticket) AnswerUserQuery(ctx context.Context, req *AnswerUserQueryTicketReq, options ...larkcore.RequestOptionFunc) (*AnswerUserQueryTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1093,9 +1093,9 @@ func (t *ticket) AnswerUserQuery(ctx context.Context, req *AnswerUserQueryTicket // // - 该接口用于获取服务台自定义字段详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/customized_fields +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/customized_fields // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/customizedFields_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/customizedFields_ticket.go func (t *ticket) CustomizedFields(ctx context.Context, req *CustomizedFieldsTicketReq, options ...larkcore.RequestOptionFunc) (*CustomizedFieldsTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1119,9 +1119,9 @@ func (t *ticket) CustomizedFields(ctx context.Context, req *CustomizedFieldsTick // // - 该接口用于获取单个服务台工单详情。仅支持自建应用。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_ticket.go func (t *ticket) Get(ctx context.Context, req *GetTicketReq, options ...larkcore.RequestOptionFunc) (*GetTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1145,9 +1145,9 @@ func (t *ticket) Get(ctx context.Context, req *GetTicketReq, options ...larkcore // // - 该接口用于获取全部工单详情。仅支持自建应用。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_ticket.go func (t *ticket) List(ctx context.Context, req *ListTicketReq, options ...larkcore.RequestOptionFunc) (*ListTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1171,9 +1171,9 @@ func (t *ticket) List(ctx context.Context, req *ListTicketReq, options ...larkco // // - 该接口用于创建服务台对话。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/start_service +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/start_service // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/startService_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/startService_ticket.go func (t *ticket) StartService(ctx context.Context, req *StartServiceTicketReq, options ...larkcore.RequestOptionFunc) (*StartServiceTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1197,9 +1197,9 @@ func (t *ticket) StartService(ctx context.Context, req *StartServiceTicketReq, o // // - 该接口用于获取服务台工单消息图象。仅支持自建应用。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/ticket_image +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/ticket_image // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/ticketImage_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/ticketImage_ticket.go func (t *ticket) TicketImage(ctx context.Context, req *TicketImageTicketReq, options ...larkcore.RequestOptionFunc) (*TicketImageTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1229,9 +1229,9 @@ func (t *ticket) TicketImage(ctx context.Context, req *TicketImageTicketReq, opt // // - 该接口用于更新服务台工单详情。只会更新数据，不会触发相关操作。如修改工单状态到关单，不会关闭聊天页面。仅支持自建应用。要更新的工单字段必须至少输入一项。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/update_ticket.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/update_ticket.go func (t *ticket) Update(ctx context.Context, req *UpdateTicketReq, options ...larkcore.RequestOptionFunc) (*UpdateTicketResp, error) { // 发起请求 apiReq := req.apiReq @@ -1255,9 +1255,9 @@ func (t *ticket) Update(ctx context.Context, req *UpdateTicketReq, options ...la // // - 该接口用于工单发送消息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_ticketMessage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_ticketMessage.go func (t *ticketMessage) Create(ctx context.Context, req *CreateTicketMessageReq, options ...larkcore.RequestOptionFunc) (*CreateTicketMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1281,9 +1281,9 @@ func (t *ticketMessage) Create(ctx context.Context, req *CreateTicketMessageReq, // // - 该接口用于获取服务台工单消息详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_ticketMessage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_ticketMessage.go func (t *ticketMessage) List(ctx context.Context, req *ListTicketMessageReq, options ...larkcore.RequestOptionFunc) (*ListTicketMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1307,9 +1307,9 @@ func (t *ticketMessage) List(ctx context.Context, req *ListTicketMessageReq, opt // // - 该接口用于创建自定义字段 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_ticketCustomizedField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/create_ticketCustomizedField.go func (t *ticketCustomizedField) Create(ctx context.Context, req *CreateTicketCustomizedFieldReq, options ...larkcore.RequestOptionFunc) (*CreateTicketCustomizedFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -1333,9 +1333,9 @@ func (t *ticketCustomizedField) Create(ctx context.Context, req *CreateTicketCus // // - 该接口用于删除工单自定义字段。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_ticketCustomizedField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/delete_ticketCustomizedField.go func (t *ticketCustomizedField) Delete(ctx context.Context, req *DeleteTicketCustomizedFieldReq, options ...larkcore.RequestOptionFunc) (*DeleteTicketCustomizedFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -1359,9 +1359,9 @@ func (t *ticketCustomizedField) Delete(ctx context.Context, req *DeleteTicketCus // // - 该接口用于获取工单自定义字段详情。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_ticketCustomizedField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/get_ticketCustomizedField.go func (t *ticketCustomizedField) Get(ctx context.Context, req *GetTicketCustomizedFieldReq, options ...larkcore.RequestOptionFunc) (*GetTicketCustomizedFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -1385,9 +1385,9 @@ func (t *ticketCustomizedField) Get(ctx context.Context, req *GetTicketCustomize // // - 该接口用于获取全部工单自定义字段。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_ticketCustomizedField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/list_ticketCustomizedField.go func (t *ticketCustomizedField) List(ctx context.Context, req *ListTicketCustomizedFieldReq, options ...larkcore.RequestOptionFunc) (*ListTicketCustomizedFieldResp, error) { // 发起请求 apiReq := req.apiReq @@ -1411,9 +1411,9 @@ func (t *ticketCustomizedField) List(ctx context.Context, req *ListTicketCustomi // // - 该接口用于更新自定义字段。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_ticketCustomizedField.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/helpdeskv1/patch_ticketCustomizedField.go func (t *ticketCustomizedField) Patch(ctx context.Context, req *PatchTicketCustomizedFieldReq, options ...larkcore.RequestOptionFunc) (*PatchTicketCustomizedFieldResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/helpdesk/v1/event.go b/service/helpdesk/v1/event.go index 2dbc3b5a..77c3487b 100644 --- a/service/helpdesk/v1/event.go +++ b/service/helpdesk/v1/event.go @@ -32,7 +32,7 @@ func (h *P2NotificationApproveV1Handler) Event() interface{} { return &P2NotificationApproveV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2NotificationApproveV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2NotificationApproveV1)) } @@ -52,7 +52,7 @@ func (h *P2TicketCreatedV1Handler) Event() interface{} { return &P2TicketCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2TicketCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2TicketCreatedV1)) } @@ -72,7 +72,7 @@ func (h *P2TicketUpdatedV1Handler) Event() interface{} { return &P2TicketUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2TicketUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2TicketUpdatedV1)) } @@ -92,7 +92,7 @@ func (h *P2TicketMessageCreatedV1Handler) Event() interface{} { return &P2TicketMessageCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2TicketMessageCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2TicketMessageCreatedV1)) } diff --git a/service/helpdesk/v1/model.go b/service/helpdesk/v1/model.go index 999efe0c..f4171ca4 100644 --- a/service/helpdesk/v1/model.go +++ b/service/helpdesk/v1/model.go @@ -41,27 +41,27 @@ const ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateNotificationUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateNotificationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateNotificationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateNotificationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateNotificationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateNotificationOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetNotificationUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetNotificationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetNotificationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetNotificationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetNotificationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetNotificationOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypePatchNotificationUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchNotificationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchNotificationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchNotificationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchNotificationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchNotificationOpenId = "open_id" // 以 open_id 来识别用户 ) type Agent struct { @@ -254,14 +254,14 @@ func (builder *AgentSchedulesBuilder) Build() *AgentSchedules { } type AgentSchedule struct { - Status *int `json:"status,omitempty"` // 客服状态, 1 - online客服, 2 - offline(手动)客服, 3 - off duty(下班)自动处于非服务时间段 + Status *int `json:"status,omitempty"` // 客服状态，1 - online 客服，2 - offline(手动) 客服，3 - off duty(下班) 自动处于非服务时间段 Agent *AgentUser `json:"agent,omitempty"` // 客服信息 Schedule []*WeekdaySchedule `json:"schedule,omitempty"` // 工作日程列表 AgentSkills []*AgentSkillLessInfo `json:"agent_skills,omitempty"` // 客服技能 } type AgentScheduleBuilder struct { - status int // 客服状态, 1 - online客服, 2 - offline(手动)客服, 3 - off duty(下班)自动处于非服务时间段 + status int // 客服状态，1 - online 客服，2 - offline(手动) 客服，3 - off duty(下班) 自动处于非服务时间段 statusFlag bool agent *AgentUser // 客服信息 agentFlag bool @@ -276,7 +276,7 @@ func NewAgentScheduleBuilder() *AgentScheduleBuilder { return builder } -// 客服状态, 1 - online客服, 2 - offline(手动)客服, 3 - off duty(下班)自动处于非服务时间段 +// 客服状态，1 - online 客服，2 - offline(手动) 客服，3 - off duty(下班) 自动处于非服务时间段 // // 示例值：1 func (builder *AgentScheduleBuilder) Status(status int) *AgentScheduleBuilder { @@ -331,13 +331,13 @@ func (builder *AgentScheduleBuilder) Build() *AgentSchedule { } type AgentScheduleUpdateInfo struct { - AgentId *string `json:"agent_id,omitempty"` // 客服id;;[可以以普通用户身份在服务台发起工单，从工单详情里面获取用户guest.id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) + AgentId *string `json:"agent_id,omitempty"` // 客服 id;;[可以以普通用户身份在服务台发起工单，从工单详情里面获取用户 guest.id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) Schedule []*WeekdaySchedule `json:"schedule,omitempty"` // 工作日程列表 AgentSkillIds []string `json:"agent_skill_ids,omitempty"` // 客服技能 ids } type AgentScheduleUpdateInfoBuilder struct { - agentId string // 客服id;;[可以以普通用户身份在服务台发起工单，从工单详情里面获取用户guest.id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) + agentId string // 客服 id;;[可以以普通用户身份在服务台发起工单，从工单详情里面获取用户 guest.id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) agentIdFlag bool schedule []*WeekdaySchedule // 工作日程列表 scheduleFlag bool @@ -350,7 +350,7 @@ func NewAgentScheduleUpdateInfoBuilder() *AgentScheduleUpdateInfoBuilder { return builder } -// 客服id;;[可以以普通用户身份在服务台发起工单，从工单详情里面获取用户guest.id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) +// 客服 id;;[可以以普通用户身份在服务台发起工单，从工单详情里面获取用户 guest.id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) // // 示例值：agent-id func (builder *AgentScheduleUpdateInfoBuilder) AgentId(agentId string) *AgentScheduleUpdateInfoBuilder { @@ -393,25 +393,25 @@ func (builder *AgentScheduleUpdateInfoBuilder) Build() *AgentScheduleUpdateInfo } type AgentSkill struct { - Id *string `json:"id,omitempty"` // 技能id + Id *string `json:"id,omitempty"` // 技能 id HelpdeskId *string `json:"helpdesk_id,omitempty"` // helpdesk id Name *string `json:"name,omitempty"` // 技能名 - Rules []*AgentSkillRule `json:"rules,omitempty"` // 技能rules - AgentIds []string `json:"agent_ids,omitempty"` // 具有此技能的客服ids + Rules []*AgentSkillRule `json:"rules,omitempty"` // 技能 rules + AgentIds []string `json:"agent_ids,omitempty"` // 具有此技能的客服 ids IsDefault *bool `json:"is_default,omitempty"` // 默认技能 Agents []*Agent `json:"agents,omitempty"` // 客服 info } type AgentSkillBuilder struct { - id string // 技能id + id string // 技能 id idFlag bool helpdeskId string // helpdesk id helpdeskIdFlag bool name string // 技能名 nameFlag bool - rules []*AgentSkillRule // 技能rules + rules []*AgentSkillRule // 技能 rules rulesFlag bool - agentIds []string // 具有此技能的客服ids + agentIds []string // 具有此技能的客服 ids agentIdsFlag bool isDefault bool // 默认技能 isDefaultFlag bool @@ -424,7 +424,7 @@ func NewAgentSkillBuilder() *AgentSkillBuilder { return builder } -// 技能id +// 技能 id // // 示例值：test-skill-id func (builder *AgentSkillBuilder) Id(id string) *AgentSkillBuilder { @@ -451,7 +451,7 @@ func (builder *AgentSkillBuilder) Name(name string) *AgentSkillBuilder { return builder } -// 技能rules +// 技能 rules // // 示例值： func (builder *AgentSkillBuilder) Rules(rules []*AgentSkillRule) *AgentSkillBuilder { @@ -460,7 +460,7 @@ func (builder *AgentSkillBuilder) Rules(rules []*AgentSkillRule) *AgentSkillBuil return builder } -// 具有此技能的客服ids +// 具有此技能的客服 ids // // 示例值：["ou_ea21d7f018e1155d960e40d33191f966"] func (builder *AgentSkillBuilder) AgentIds(agentIds []string) *AgentSkillBuilder { @@ -582,20 +582,20 @@ func (builder *AgentSkillLessInfoBuilder) Build() *AgentSkillLessInfo { } type AgentSkillRule struct { - Id *string `json:"id,omitempty"` // rule id, 参考[获取客服技能rules](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list) 用于获取rules options - SelectedOperator *int `json:"selected_operator,omitempty"` // 运算符比较, 参考[客服技能运算符选项](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) - OperatorOptions []int `json:"operator_options,omitempty"` // rule操作数value，[客服技能及运算符](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) + Id *string `json:"id,omitempty"` // rule id，参考 [获取客服技能 rules](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list) 用于获取 rules options + SelectedOperator *int `json:"selected_operator,omitempty"` // 运算符比较，参考 [客服技能运算符选项](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) + OperatorOptions []int `json:"operator_options,omitempty"` // rule 操作数 value，[客服技能及运算符](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) Operand *string `json:"operand,omitempty"` // rule 操作数的值 Category *int `json:"category,omitempty"` // rule 类型，1-知识库，2-工单信息，3-用户飞书信息 DisplayName *string `json:"display_name,omitempty"` // rule 名 } type AgentSkillRuleBuilder struct { - id string // rule id, 参考[获取客服技能rules](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list) 用于获取rules options + id string // rule id，参考 [获取客服技能 rules](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list) 用于获取 rules options idFlag bool - selectedOperator int // 运算符比较, 参考[客服技能运算符选项](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) + selectedOperator int // 运算符比较，参考 [客服技能运算符选项](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) selectedOperatorFlag bool - operatorOptions []int // rule操作数value，[客服技能及运算符](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) + operatorOptions []int // rule 操作数 value，[客服技能及运算符](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) operatorOptionsFlag bool operand string // rule 操作数的值 operandFlag bool @@ -610,7 +610,7 @@ func NewAgentSkillRuleBuilder() *AgentSkillRuleBuilder { return builder } -// rule id, 参考[获取客服技能rules](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list) 用于获取rules options +// rule id，参考 [获取客服技能 rules](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/agent_skill_rule/list) 用于获取 rules options // // 示例值：test-skill-id func (builder *AgentSkillRuleBuilder) Id(id string) *AgentSkillRuleBuilder { @@ -619,7 +619,7 @@ func (builder *AgentSkillRuleBuilder) Id(id string) *AgentSkillRuleBuilder { return builder } -// 运算符比较, 参考[客服技能运算符选项](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) +// 运算符比较，参考 [客服技能运算符选项](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) // // 示例值：8 func (builder *AgentSkillRuleBuilder) SelectedOperator(selectedOperator int) *AgentSkillRuleBuilder { @@ -628,7 +628,7 @@ func (builder *AgentSkillRuleBuilder) SelectedOperator(selectedOperator int) *Ag return builder } -// rule操作数value，[客服技能及运算符](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) +// rule 操作数 value，[客服技能及运算符](https://open.feishu.cn/document/ukTMukTMukTM/ucDOyYjL3gjM24yN4IjN/operator-options) // // 示例值：[3] func (builder *AgentSkillRuleBuilder) OperatorOptions(operatorOptions []int) *AgentSkillRuleBuilder { @@ -639,7 +639,7 @@ func (builder *AgentSkillRuleBuilder) OperatorOptions(operatorOptions []int) *Ag // rule 操作数的值 // -// 示例值：{; "selected_departments": [; {; "id": "部门ID",; "name": "IT"; }; ]; } +// 示例值：{; "selected_departments": [; {; "id": "部门 ID",; "name": "IT"; }; ]; } func (builder *AgentSkillRuleBuilder) Operand(operand string) *AgentSkillRuleBuilder { builder.operand = operand builder.operandFlag = true @@ -806,19 +806,19 @@ func (builder *AgentUserBuilder) Build() *AgentUser { type BotMessage struct { MsgType *string `json:"msg_type,omitempty"` // 消息类型 - Content *string `json:"content,omitempty"` // 消息内容，json格式结构序列化成string。格式说明参考: [发送消息content说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) - ReceiverId *string `json:"receiver_id,omitempty"` // 接收消息用户id - ReceiveType *string `json:"receive_type,omitempty"` // 接收消息方式，chat(服务台专属服务群)或user(服务台机器人私聊)。若选择专属服务群，用户有正在处理的工单将会发送失败。默认以chat方式发送。 + Content *string `json:"content,omitempty"` // 消息内容，json 格式结构序列化成 string。格式说明参考: [发送消息 content 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + ReceiverId *string `json:"receiver_id,omitempty"` // 接收消息用户 id + ReceiveType *string `json:"receive_type,omitempty"` // 接收消息方式，chat(服务台专属服务群) 或 user(服务台机器人私聊)。若选择专属服务群，用户有正在处理的工单将会发送失败。默认以 chat 方式发送。 } type BotMessageBuilder struct { msgType string // 消息类型 msgTypeFlag bool - content string // 消息内容，json格式结构序列化成string。格式说明参考: [发送消息content说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + content string // 消息内容，json 格式结构序列化成 string。格式说明参考: [发送消息 content 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) contentFlag bool - receiverId string // 接收消息用户id + receiverId string // 接收消息用户 id receiverIdFlag bool - receiveType string // 接收消息方式，chat(服务台专属服务群)或user(服务台机器人私聊)。若选择专属服务群，用户有正在处理的工单将会发送失败。默认以chat方式发送。 + receiveType string // 接收消息方式，chat(服务台专属服务群) 或 user(服务台机器人私聊)。若选择专属服务群，用户有正在处理的工单将会发送失败。默认以 chat 方式发送。 receiveTypeFlag bool } @@ -836,7 +836,7 @@ func (builder *BotMessageBuilder) MsgType(msgType string) *BotMessageBuilder { return builder } -// 消息内容，json格式结构序列化成string。格式说明参考: [发送消息content说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) +// 消息内容，json 格式结构序列化成 string。格式说明参考: [发送消息 content 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) // // 示例值：{\"post\":{\"zh_cn\":{\"title\":\"some title\",\"content\":[[{\"tag\":\"text\",\"text\":\"some content\"}]]}}} func (builder *BotMessageBuilder) Content(content string) *BotMessageBuilder { @@ -845,7 +845,7 @@ func (builder *BotMessageBuilder) Content(content string) *BotMessageBuilder { return builder } -// 接收消息用户id +// 接收消息用户 id // // 示例值：ou_7346484524 func (builder *BotMessageBuilder) ReceiverId(receiverId string) *BotMessageBuilder { @@ -854,7 +854,7 @@ func (builder *BotMessageBuilder) ReceiverId(receiverId string) *BotMessageBuild return builder } -// 接收消息方式，chat(服务台专属服务群)或user(服务台机器人私聊)。若选择专属服务群，用户有正在处理的工单将会发送失败。默认以chat方式发送。 +// 接收消息方式，chat(服务台专属服务群) 或 user(服务台机器人私聊)。若选择专属服务群，用户有正在处理的工单将会发送失败。默认以 chat 方式发送。 // // 示例值：chat func (builder *BotMessageBuilder) ReceiveType(receiveType string) *BotMessageBuilder { @@ -885,24 +885,24 @@ func (builder *BotMessageBuilder) Build() *BotMessage { } type Category struct { - CategoryId *string `json:"category_id,omitempty"` // 知识库分类ID - Id *string `json:"id,omitempty"` // 知识库分类ID，（旧版，请使用category_id） + CategoryId *string `json:"category_id,omitempty"` // 知识库分类 ID + Id *string `json:"id,omitempty"` // 知识库分类 ID，（旧版，请使用 category_id） Name *string `json:"name,omitempty"` // 名称 - ParentId *string `json:"parent_id,omitempty"` // 父知识库分类ID - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台ID + ParentId *string `json:"parent_id,omitempty"` // 父知识库分类 ID + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台 ID Language *string `json:"language,omitempty"` // 语言 } type CategoryBuilder struct { - categoryId string // 知识库分类ID + categoryId string // 知识库分类 ID categoryIdFlag bool - id string // 知识库分类ID，（旧版，请使用category_id） + id string // 知识库分类 ID，（旧版，请使用 category_id） idFlag bool name string // 名称 nameFlag bool - parentId string // 父知识库分类ID + parentId string // 父知识库分类 ID parentIdFlag bool - helpdeskId string // 服务台ID + helpdeskId string // 服务台 ID helpdeskIdFlag bool language string // 语言 languageFlag bool @@ -913,7 +913,7 @@ func NewCategoryBuilder() *CategoryBuilder { return builder } -// 知识库分类ID +// 知识库分类 ID // // 示例值：6948728206392295444 func (builder *CategoryBuilder) CategoryId(categoryId string) *CategoryBuilder { @@ -922,7 +922,7 @@ func (builder *CategoryBuilder) CategoryId(categoryId string) *CategoryBuilder { return builder } -// 知识库分类ID，（旧版，请使用category_id） +// 知识库分类 ID，（旧版，请使用 category_id） // // 示例值：6948728206392295444 func (builder *CategoryBuilder) Id(id string) *CategoryBuilder { @@ -940,7 +940,7 @@ func (builder *CategoryBuilder) Name(name string) *CategoryBuilder { return builder } -// 父知识库分类ID +// 父知识库分类 ID // // 示例值：0 func (builder *CategoryBuilder) ParentId(parentId string) *CategoryBuilder { @@ -949,7 +949,7 @@ func (builder *CategoryBuilder) ParentId(parentId string) *CategoryBuilder { return builder } -// 服务台ID +// 服务台 ID // // 示例值：6939771743531696147 func (builder *CategoryBuilder) HelpdeskId(helpdeskId string) *CategoryBuilder { @@ -999,10 +999,10 @@ func (builder *CategoryBuilder) Build() *Category { type Comments struct { Content *string `json:"content,omitempty"` // 备注 CreatedAt *int `json:"created_at,omitempty"` // 备注时间，单位毫秒 - Id *int `json:"id,omitempty"` // 备注ID + Id *int `json:"id,omitempty"` // 备注 ID UserAvatarUrl *string `json:"user_avatar_url,omitempty"` // 备注人头像 UserName *string `json:"user_name,omitempty"` // 备注人姓名 - UserId *int `json:"user_id,omitempty"` // 备注人ID + UserId *int `json:"user_id,omitempty"` // 备注人 ID } type CommentsBuilder struct { @@ -1010,13 +1010,13 @@ type CommentsBuilder struct { contentFlag bool createdAt int // 备注时间，单位毫秒 createdAtFlag bool - id int // 备注ID + id int // 备注 ID idFlag bool userAvatarUrl string // 备注人头像 userAvatarUrlFlag bool userName string // 备注人姓名 userNameFlag bool - userId int // 备注人ID + userId int // 备注人 ID userIdFlag bool } @@ -1043,9 +1043,9 @@ func (builder *CommentsBuilder) CreatedAt(createdAt int) *CommentsBuilder { return builder } -// 备注ID +// 备注 ID // -// 示例值：备注id +// 示例值：备注 id func (builder *CommentsBuilder) Id(id int) *CommentsBuilder { builder.id = id builder.idFlag = true @@ -1070,9 +1070,9 @@ func (builder *CommentsBuilder) UserName(userName string) *CommentsBuilder { return builder } -// 备注人ID +// 备注人 ID // -// 示例值：备注人id +// 示例值：备注人 id func (builder *CommentsBuilder) UserId(userId int) *CommentsBuilder { builder.userId = userId builder.userIdFlag = true @@ -1109,7 +1109,7 @@ func (builder *CommentsBuilder) Build() *Comments { } type CustomizedFieldDisplayItem struct { - Id *string `json:"id,omitempty"` // 自定义字段ID + Id *string `json:"id,omitempty"` // 自定义字段 ID Value *string `json:"value,omitempty"` // 自定义字段值 KeyName *string `json:"key_name,omitempty"` // 键名 DisplayName *string `json:"display_name,omitempty"` // 展示名称 @@ -1119,7 +1119,7 @@ type CustomizedFieldDisplayItem struct { } type CustomizedFieldDisplayItemBuilder struct { - id string // 自定义字段ID + id string // 自定义字段 ID idFlag bool value string // 自定义字段值 valueFlag bool @@ -1140,7 +1140,7 @@ func NewCustomizedFieldDisplayItemBuilder() *CustomizedFieldDisplayItemBuilder { return builder } -// 自定义字段ID +// 自定义字段 ID // // 示例值：123 func (builder *CustomizedFieldDisplayItemBuilder) Id(id string) *CustomizedFieldDisplayItemBuilder { @@ -1285,9 +1285,9 @@ func (builder *EventBuilder) Build() *Event { } type Faq struct { - FaqId *string `json:"faq_id,omitempty"` // 知识库ID - Id *string `json:"id,omitempty"` // 知识库旧版ID，请使用faq_id - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台ID + FaqId *string `json:"faq_id,omitempty"` // 知识库 ID + Id *string `json:"id,omitempty"` // 知识库旧版 ID，请使用 faq_id + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台 ID Question *string `json:"question,omitempty"` // 问题 Answer *string `json:"answer,omitempty"` // 答案 AnswerRichtext []*Richtext `json:"answer_richtext,omitempty"` // 富文本答案 @@ -1301,11 +1301,11 @@ type Faq struct { } type FaqBuilder struct { - faqId string // 知识库ID + faqId string // 知识库 ID faqIdFlag bool - id string // 知识库旧版ID，请使用faq_id + id string // 知识库旧版 ID，请使用 faq_id idFlag bool - helpdeskId string // 服务台ID + helpdeskId string // 服务台 ID helpdeskIdFlag bool question string // 问题 questionFlag bool @@ -1334,7 +1334,7 @@ func NewFaqBuilder() *FaqBuilder { return builder } -// 知识库ID +// 知识库 ID // // 示例值：6936004780707807231 func (builder *FaqBuilder) FaqId(faqId string) *FaqBuilder { @@ -1343,7 +1343,7 @@ func (builder *FaqBuilder) FaqId(faqId string) *FaqBuilder { return builder } -// 知识库旧版ID，请使用faq_id +// 知识库旧版 ID，请使用 faq_id // // 示例值：6936004780707807231 func (builder *FaqBuilder) Id(id string) *FaqBuilder { @@ -1352,7 +1352,7 @@ func (builder *FaqBuilder) Id(id string) *FaqBuilder { return builder } -// 服务台ID +// 服务台 ID // // 示例值：6936004780707807251 func (builder *FaqBuilder) HelpdeskId(helpdeskId string) *FaqBuilder { @@ -1504,21 +1504,21 @@ func (builder *FaqBuilder) Build() *Faq { } type FaqUpdateInfo struct { - CategoryId *string `json:"category_id,omitempty"` // 知识库分类ID + CategoryId *string `json:"category_id,omitempty"` // 知识库分类 ID Question *string `json:"question,omitempty"` // 问题 Answer *string `json:"answer,omitempty"` // 答案 - AnswerRichtext *string `json:"answer_richtext,omitempty"` // 富文本答案和答案必须有一个必填。Json Array格式，富文本结构请见[了解更多: 富文本](https://open.feishu.cn/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN) + AnswerRichtext *string `json:"answer_richtext,omitempty"` // 富文本答案和答案必须有一个必填。Json Array 格式，富文本结构请见 [了解更多：富文本](https://open.feishu.cn/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN) Tags []string `json:"tags,omitempty"` // 相似问题 } type FaqUpdateInfoBuilder struct { - categoryId string // 知识库分类ID + categoryId string // 知识库分类 ID categoryIdFlag bool question string // 问题 questionFlag bool answer string // 答案 answerFlag bool - answerRichtext string // 富文本答案和答案必须有一个必填。Json Array格式，富文本结构请见[了解更多: 富文本](https://open.feishu.cn/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN) + answerRichtext string // 富文本答案和答案必须有一个必填。Json Array 格式，富文本结构请见 [了解更多：富文本](https://open.feishu.cn/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN) answerRichtextFlag bool tags []string // 相似问题 tagsFlag bool @@ -1529,7 +1529,7 @@ func NewFaqUpdateInfoBuilder() *FaqUpdateInfoBuilder { return builder } -// 知识库分类ID +// 知识库分类 ID // // 示例值：6836004780707807251 func (builder *FaqUpdateInfoBuilder) CategoryId(categoryId string) *FaqUpdateInfoBuilder { @@ -1556,7 +1556,7 @@ func (builder *FaqUpdateInfoBuilder) Answer(answer string) *FaqUpdateInfoBuilder return builder } -// 富文本答案和答案必须有一个必填。Json Array格式，富文本结构请见[了解更多: 富文本](https://open.feishu.cn/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN) +// 富文本答案和答案必须有一个必填。Json Array 格式，富文本结构请见 [了解更多：富文本](https://open.feishu.cn/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN) // // 示例值：[{; "content": "这只是一个测试，医保问题",; "type": "text"; }] func (builder *FaqUpdateInfoBuilder) AnswerRichtext(answerRichtext string) *FaqUpdateInfoBuilder { @@ -1675,13 +1675,13 @@ type Notification struct { ReadUserCount *int `json:"read_user_count,omitempty"` // 非必填，已读用户总数 SendAt *string `json:"send_at,omitempty"` // 非必填，推送任务触发时间（毫秒时间戳） PushContent *string `json:"push_content,omitempty"` // 必填，推送内容，详见：https://open.feishu.cn/tool/cardbuilder?from=howtoguide - PushType *int `json:"push_type,omitempty"` // 必填，;0（定时推送：push_scope不能等于3） 1（新人入职推送：push_scope必须等于1或者3；new_staff_scope_type不能为空） - PushScopeType *int `json:"push_scope_type,omitempty"` // 必填，;推送范围（服务台私信） 0：组织内全部成员（user_list和department_list必须为空） 1：不推送任何成员（user_list和department_list必须为空，chat_list不可为空） 2：推送到部分成员（user_list或department_list不能为空） 3：入职新人 以上四种状态，chat_list都相对独立，只有在推送范围为1时，必须需要设置chat_list - NewStaffScopeType *int `json:"new_staff_scope_type,omitempty"` // 非必填，;新人入职范围类型（push_type为1时生效） 0：组织内所有新人 1：组织内特定的部门（new_staff_scope_department_list 字段不能为空） + PushType *int `json:"push_type,omitempty"` // 必填，;0（定时推送：push_scope 不能等于 3）1（新人入职推送：push_scope 必须等于 1 或者 3；new_staff_scope_type 不能为空） + PushScopeType *int `json:"push_scope_type,omitempty"` // 必填，;推送范围（服务台私信）0：组织内全部成员（user_list 和 department_list 必须为空）1：不推送任何成员（user_list 和 department_list 必须为空，chat_list 不可为空）2：推送到部分成员（user_list 或 department_list 不能为空）3：入职新人 以上四种状态，chat_list 都相对独立，只有在推送范围为 1 时，必须需要设置 chat_list + NewStaffScopeType *int `json:"new_staff_scope_type,omitempty"` // 非必填，;新人入职范围类型（push_type 为 1 时生效）0：组织内所有新人 1：组织内特定的部门（new_staff_scope_department_list 字段不能为空） NewStaffScopeDepartmentList []*NotificationDepartment `json:"new_staff_scope_department_list,omitempty"` // 非必填，新人入职生效部门列表 - UserList []*NotificationUser `json:"user_list,omitempty"` // 非必填，push推送到成员列表 - DepartmentList []*NotificationDepartment `json:"department_list,omitempty"` // 非必填，push推送到的部门信息列表 - ChatList []*NotificationChat `json:"chat_list,omitempty"` // 非必填，push推送到的会话列表(群) + UserList []*NotificationUser `json:"user_list,omitempty"` // 非必填，push 推送到成员列表 + DepartmentList []*NotificationDepartment `json:"department_list,omitempty"` // 非必填，push 推送到的部门信息列表 + ChatList []*NotificationChat `json:"chat_list,omitempty"` // 非必填，push 推送到的会话列表 (群) Ext *string `json:"ext,omitempty"` // 非必填，预留扩展字段 } @@ -1710,19 +1710,19 @@ type NotificationBuilder struct { sendAtFlag bool pushContent string // 必填，推送内容，详见：https://open.feishu.cn/tool/cardbuilder?from=howtoguide pushContentFlag bool - pushType int // 必填，;0（定时推送：push_scope不能等于3） 1（新人入职推送：push_scope必须等于1或者3；new_staff_scope_type不能为空） + pushType int // 必填，;0（定时推送：push_scope 不能等于 3）1（新人入职推送：push_scope 必须等于 1 或者 3；new_staff_scope_type 不能为空） pushTypeFlag bool - pushScopeType int // 必填，;推送范围（服务台私信） 0：组织内全部成员（user_list和department_list必须为空） 1：不推送任何成员（user_list和department_list必须为空，chat_list不可为空） 2：推送到部分成员（user_list或department_list不能为空） 3：入职新人 以上四种状态，chat_list都相对独立，只有在推送范围为1时，必须需要设置chat_list + pushScopeType int // 必填，;推送范围（服务台私信）0：组织内全部成员（user_list 和 department_list 必须为空）1：不推送任何成员（user_list 和 department_list 必须为空，chat_list 不可为空）2：推送到部分成员（user_list 或 department_list 不能为空）3：入职新人 以上四种状态，chat_list 都相对独立，只有在推送范围为 1 时，必须需要设置 chat_list pushScopeTypeFlag bool - newStaffScopeType int // 非必填，;新人入职范围类型（push_type为1时生效） 0：组织内所有新人 1：组织内特定的部门（new_staff_scope_department_list 字段不能为空） + newStaffScopeType int // 非必填，;新人入职范围类型（push_type 为 1 时生效）0：组织内所有新人 1：组织内特定的部门（new_staff_scope_department_list 字段不能为空） newStaffScopeTypeFlag bool newStaffScopeDepartmentList []*NotificationDepartment // 非必填，新人入职生效部门列表 newStaffScopeDepartmentListFlag bool - userList []*NotificationUser // 非必填，push推送到成员列表 + userList []*NotificationUser // 非必填，push 推送到成员列表 userListFlag bool - departmentList []*NotificationDepartment // 非必填，push推送到的部门信息列表 + departmentList []*NotificationDepartment // 非必填，push 推送到的部门信息列表 departmentListFlag bool - chatList []*NotificationChat // 非必填，push推送到的会话列表(群) + chatList []*NotificationChat // 非必填，push 推送到的会话列表 (群) chatListFlag bool ext string // 非必填，预留扩展字段 extFlag bool @@ -1834,14 +1834,14 @@ func (builder *NotificationBuilder) SendAt(sendAt string) *NotificationBuilder { // 必填，推送内容，详见：https://open.feishu.cn/tool/cardbuilder?from=howtoguide // -// 示例值：{ \"config\": { \"wide_screen_mode\": true }, \"elements\": [ { \"tag\": \"div\", \"text\": { \"tag\": \"lark_md\", \"content\": \"[飞书](https://www.feishu.cn)整合即时沟通、日历、音视频会议、云文档、云盘、工作台等功能于一体，成就组织和个人，更高效、更愉悦。\" } } ] } +// 示例值：{ \"config\": { \"wide_screen_mode\": true }, \"elements\": [ { \"tag\": \"div\", \"text\": { \"tag\": \"lark_md\", \"content\": \"[飞书](https://www.feishu.cn) 整合即时沟通、日历、音视频会议、云文档、云盘、工作台等功能于一体，成就组织和个人，更高效、更愉悦。\" } } ] } func (builder *NotificationBuilder) PushContent(pushContent string) *NotificationBuilder { builder.pushContent = pushContent builder.pushContentFlag = true return builder } -// 必填，;0（定时推送：push_scope不能等于3） 1（新人入职推送：push_scope必须等于1或者3；new_staff_scope_type不能为空） +// 必填，;0（定时推送：push_scope 不能等于 3）1（新人入职推送：push_scope 必须等于 1 或者 3；new_staff_scope_type 不能为空） // // 示例值：0 func (builder *NotificationBuilder) PushType(pushType int) *NotificationBuilder { @@ -1850,7 +1850,7 @@ func (builder *NotificationBuilder) PushType(pushType int) *NotificationBuilder return builder } -// 必填，;推送范围（服务台私信） 0：组织内全部成员（user_list和department_list必须为空） 1：不推送任何成员（user_list和department_list必须为空，chat_list不可为空） 2：推送到部分成员（user_list或department_list不能为空） 3：入职新人 以上四种状态，chat_list都相对独立，只有在推送范围为1时，必须需要设置chat_list +// 必填，;推送范围（服务台私信）0：组织内全部成员（user_list 和 department_list 必须为空）1：不推送任何成员（user_list 和 department_list 必须为空，chat_list 不可为空）2：推送到部分成员（user_list 或 department_list 不能为空）3：入职新人 以上四种状态，chat_list 都相对独立，只有在推送范围为 1 时，必须需要设置 chat_list // // 示例值：0 func (builder *NotificationBuilder) PushScopeType(pushScopeType int) *NotificationBuilder { @@ -1859,7 +1859,7 @@ func (builder *NotificationBuilder) PushScopeType(pushScopeType int) *Notificati return builder } -// 非必填，;新人入职范围类型（push_type为1时生效） 0：组织内所有新人 1：组织内特定的部门（new_staff_scope_department_list 字段不能为空） +// 非必填，;新人入职范围类型（push_type 为 1 时生效）0：组织内所有新人 1：组织内特定的部门（new_staff_scope_department_list 字段不能为空） // // 示例值：0 func (builder *NotificationBuilder) NewStaffScopeType(newStaffScopeType int) *NotificationBuilder { @@ -1877,7 +1877,7 @@ func (builder *NotificationBuilder) NewStaffScopeDepartmentList(newStaffScopeDep return builder } -// 非必填，push推送到成员列表 +// 非必填，push 推送到成员列表 // // 示例值：[{"user_id":"ou_7277fd1262bfafc363d5b2a1f9c2ac90"}] func (builder *NotificationBuilder) UserList(userList []*NotificationUser) *NotificationBuilder { @@ -1886,7 +1886,7 @@ func (builder *NotificationBuilder) UserList(userList []*NotificationUser) *Noti return builder } -// 非必填，push推送到的部门信息列表 +// 非必填，push 推送到的部门信息列表 // // 示例值：[{"department_id":"od_7c1a2815c9846b5e518b950de0e62de8"}] func (builder *NotificationBuilder) DepartmentList(departmentList []*NotificationDepartment) *NotificationBuilder { @@ -1895,7 +1895,7 @@ func (builder *NotificationBuilder) DepartmentList(departmentList []*Notificatio return builder } -// 非必填，push推送到的会话列表(群) +// 非必填，push 推送到的会话列表 (群) // // 示例值：[{"chat_id":"oc_7c1a2815c9846b5e518b950de0e62de8"}] func (builder *NotificationBuilder) ChatList(chatList []*NotificationChat) *NotificationBuilder { @@ -1993,12 +1993,12 @@ func (builder *NotificationBuilder) Build() *Notification { } type NotificationChat struct { - ChatId *string `json:"chat_id,omitempty"` // 非必填，会话ID + ChatId *string `json:"chat_id,omitempty"` // 非必填，会话 ID Name *string `json:"name,omitempty"` // 非必填，会话名称 } type NotificationChatBuilder struct { - chatId string // 非必填，会话ID + chatId string // 非必填，会话 ID chatIdFlag bool name string // 非必填，会话名称 nameFlag bool @@ -2009,7 +2009,7 @@ func NewNotificationChatBuilder() *NotificationChatBuilder { return builder } -// 非必填，会话ID +// 非必填，会话 ID // // 示例值：oc_7277fd1262bfafc363d5b2a1f9c2ac90 func (builder *NotificationChatBuilder) ChatId(chatId string) *NotificationChatBuilder { @@ -2041,12 +2041,12 @@ func (builder *NotificationChatBuilder) Build() *NotificationChat { } type NotificationDepartment struct { - DepartmentId *string `json:"department_id,omitempty"` // 部门ID + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID Name *string `json:"name,omitempty"` // 非必填，部门名称 } type NotificationDepartmentBuilder struct { - departmentId string // 部门ID + departmentId string // 部门 ID departmentIdFlag bool name string // 非必填，部门名称 nameFlag bool @@ -2057,7 +2057,7 @@ func NewNotificationDepartmentBuilder() *NotificationDepartmentBuilder { return builder } -// 部门ID +// 部门 ID // // 示例值：od_7277fd1262bfafc363d5b2a1f9c2ac90 func (builder *NotificationDepartmentBuilder) DepartmentId(departmentId string) *NotificationDepartmentBuilder { @@ -2089,13 +2089,13 @@ func (builder *NotificationDepartmentBuilder) Build() *NotificationDepartment { } type NotificationUser struct { - UserId *string `json:"user_id,omitempty"` // 非必填，用户id + UserId *string `json:"user_id,omitempty"` // 非必填，用户 id AvatarUrl *string `json:"avatar_url,omitempty"` // 非必填，头像地址 Name *string `json:"name,omitempty"` // 非必填，用户名称 } type NotificationUserBuilder struct { - userId string // 非必填，用户id + userId string // 非必填，用户 id userIdFlag bool avatarUrl string // 非必填，头像地址 avatarUrlFlag bool @@ -2108,7 +2108,7 @@ func NewNotificationUserBuilder() *NotificationUserBuilder { return builder } -// 非必填，用户id +// 非必填，用户 id // // 示例值：ou_7277fd1262bfafc363d5b2a1f9c2ac90 func (builder *NotificationUserBuilder) UserId(userId string) *NotificationUserBuilder { @@ -2201,8 +2201,8 @@ func (builder *RichtextBuilder) Build() *Richtext { } type Ticket struct { - TicketId *string `json:"ticket_id,omitempty"` // 工单ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台ID + TicketId *string `json:"ticket_id,omitempty"` // 工单 ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台 ID Guest *TicketUser `json:"guest,omitempty"` // 工单创建用户 Comments *Comments `json:"comments,omitempty"` // 备注 TicketType *int `json:"ticket_type,omitempty"` // 工单阶段：1. 机器人 2. 人工 @@ -2215,11 +2215,11 @@ type Ticket struct { Agents []*TicketUser `json:"agents,omitempty"` // 工单客服 Channel *int `json:"channel,omitempty"` // 工单渠道，描述：;9：Open API 2：二维码 14：分享 13：搜索 其他数字：其他渠道 Solve *int `json:"solve,omitempty"` // 工单是否解决 1:没解决 2:已解决 - ClosedBy *TicketUser `json:"closed_by,omitempty"` // 关单用户ID + ClosedBy *TicketUser `json:"closed_by,omitempty"` // 关单用户 ID Collaborators []*TicketUser `json:"collaborators,omitempty"` // 工单协作者 - CustomizedFields []*CustomizedFieldDisplayItem `json:"customized_fields,omitempty"` // 自定义字段列表，没有值时不设置 ;下拉菜单的value对应工单字段里面的children.display_name;[获取全部工单自定义字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list-ticket-customized-fields) + CustomizedFields []*CustomizedFieldDisplayItem `json:"customized_fields,omitempty"` // 自定义字段列表，没有值时不设置 ;下拉菜单的 value 对应工单字段里面的 children.display_name;[获取全部工单自定义字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list-ticket-customized-fields) AgentServiceDuration *float64 `json:"agent_service_duration,omitempty"` // 客服服务时长，客服最后一次回复时间距离客服进入时间间隔，单位分钟 - AgentFirstResponseDuration *int `json:"agent_first_response_duration,omitempty"` // 客服首次回复时间距离客服进入时间的间隔(秒) + AgentFirstResponseDuration *int `json:"agent_first_response_duration,omitempty"` // 客服首次回复时间距离客服进入时间的间隔 (秒) BotServiceDuration *int `json:"bot_service_duration,omitempty"` // 机器人服务时间：客服进入时间距离工单创建时间的间隔，单位秒 AgentResolutionTime *int `json:"agent_resolution_time,omitempty"` // 客服解决时长，关单时间距离客服进入时间的间隔，单位秒 ActualProcessingTime *int `json:"actual_processing_time,omitempty"` // 工单实际处理时间：从客服进入到关单，单位秒 @@ -2230,9 +2230,9 @@ type Ticket struct { } type TicketBuilder struct { - ticketId string // 工单ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) + ticketId string // 工单 ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) ticketIdFlag bool - helpdeskId string // 服务台ID + helpdeskId string // 服务台 ID helpdeskIdFlag bool guest *TicketUser // 工单创建用户 guestFlag bool @@ -2258,15 +2258,15 @@ type TicketBuilder struct { channelFlag bool solve int // 工单是否解决 1:没解决 2:已解决 solveFlag bool - closedBy *TicketUser // 关单用户ID + closedBy *TicketUser // 关单用户 ID closedByFlag bool collaborators []*TicketUser // 工单协作者 collaboratorsFlag bool - customizedFields []*CustomizedFieldDisplayItem // 自定义字段列表，没有值时不设置 ;下拉菜单的value对应工单字段里面的children.display_name;[获取全部工单自定义字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list-ticket-customized-fields) + customizedFields []*CustomizedFieldDisplayItem // 自定义字段列表，没有值时不设置 ;下拉菜单的 value 对应工单字段里面的 children.display_name;[获取全部工单自定义字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list-ticket-customized-fields) customizedFieldsFlag bool agentServiceDuration float64 // 客服服务时长，客服最后一次回复时间距离客服进入时间间隔，单位分钟 agentServiceDurationFlag bool - agentFirstResponseDuration int // 客服首次回复时间距离客服进入时间的间隔(秒) + agentFirstResponseDuration int // 客服首次回复时间距离客服进入时间的间隔 (秒) agentFirstResponseDurationFlag bool botServiceDuration int // 机器人服务时间：客服进入时间距离工单创建时间的间隔，单位秒 botServiceDurationFlag bool @@ -2289,7 +2289,7 @@ func NewTicketBuilder() *TicketBuilder { return builder } -// 工单ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) +// 工单 ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) // // 示例值：6626871355780366331 func (builder *TicketBuilder) TicketId(ticketId string) *TicketBuilder { @@ -2298,7 +2298,7 @@ func (builder *TicketBuilder) TicketId(ticketId string) *TicketBuilder { return builder } -// 服务台ID +// 服务台 ID // // 示例值：6626871355780366330 func (builder *TicketBuilder) HelpdeskId(helpdeskId string) *TicketBuilder { @@ -2415,7 +2415,7 @@ func (builder *TicketBuilder) Solve(solve int) *TicketBuilder { return builder } -// 关单用户ID +// 关单用户 ID // // 示例值： func (builder *TicketBuilder) ClosedBy(closedBy *TicketUser) *TicketBuilder { @@ -2433,7 +2433,7 @@ func (builder *TicketBuilder) Collaborators(collaborators []*TicketUser) *Ticket return builder } -// 自定义字段列表，没有值时不设置 ;下拉菜单的value对应工单字段里面的children.display_name;[获取全部工单自定义字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list-ticket-customized-fields) +// 自定义字段列表，没有值时不设置 ;下拉菜单的 value 对应工单字段里面的 children.display_name;[获取全部工单自定义字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket_customized_field/list-ticket-customized-fields) // // 示例值： func (builder *TicketBuilder) CustomizedFields(customizedFields []*CustomizedFieldDisplayItem) *TicketBuilder { @@ -2451,7 +2451,7 @@ func (builder *TicketBuilder) AgentServiceDuration(agentServiceDuration float64) return builder } -// 客服首次回复时间距离客服进入时间的间隔(秒) +// 客服首次回复时间距离客服进入时间的间隔 (秒) // // 示例值：123869 func (builder *TicketBuilder) AgentFirstResponseDuration(agentFirstResponseDuration int) *TicketBuilder { @@ -2625,20 +2625,20 @@ func (builder *TicketBuilder) Build() *Ticket { } type TicketMessage struct { - Id *string `json:"id,omitempty"` // 工单消息ID - MessageId *string `json:"message_id,omitempty"` // chat消息ID + Id *string `json:"id,omitempty"` // 工单消息 ID + MessageId *string `json:"message_id,omitempty"` // chat 消息 ID MessageType *string `json:"message_type,omitempty"` // 消息类型；text：纯文本；post：富文本 CreatedAt *int `json:"created_at,omitempty"` // 创建时间 Content *string `json:"content,omitempty"` // 内容 UserName *string `json:"user_name,omitempty"` // 用户名 - AvatarUrl *string `json:"avatar_url,omitempty"` // 用户图片url - UserId *string `json:"user_id,omitempty"` // 用户open ID + AvatarUrl *string `json:"avatar_url,omitempty"` // 用户图片 url + UserId *string `json:"user_id,omitempty"` // 用户 open ID } type TicketMessageBuilder struct { - id string // 工单消息ID + id string // 工单消息 ID idFlag bool - messageId string // chat消息ID + messageId string // chat 消息 ID messageIdFlag bool messageType string // 消息类型；text：纯文本；post：富文本 messageTypeFlag bool @@ -2648,9 +2648,9 @@ type TicketMessageBuilder struct { contentFlag bool userName string // 用户名 userNameFlag bool - avatarUrl string // 用户图片url + avatarUrl string // 用户图片 url avatarUrlFlag bool - userId string // 用户open ID + userId string // 用户 open ID userIdFlag bool } @@ -2659,7 +2659,7 @@ func NewTicketMessageBuilder() *TicketMessageBuilder { return builder } -// 工单消息ID +// 工单消息 ID // // 示例值：6948728206392295444 func (builder *TicketMessageBuilder) Id(id string) *TicketMessageBuilder { @@ -2668,7 +2668,7 @@ func (builder *TicketMessageBuilder) Id(id string) *TicketMessageBuilder { return builder } -// chat消息ID +// chat 消息 ID // // 示例值：6949088236610273307 func (builder *TicketMessageBuilder) MessageId(messageId string) *TicketMessageBuilder { @@ -2697,7 +2697,7 @@ func (builder *TicketMessageBuilder) CreatedAt(createdAt int) *TicketMessageBuil // 内容 // -// 示例值："{\"content\":\"进入人工服务。 @李宁 为你提供服务，开始聊起来吧~\",\"msg_type\":\"text\"}" +// 示例值："{\"content\":\"进入人工服务。 @李宁 为你提供服务，开始聊起来吧～\",\"msg_type\":\"text\"}" func (builder *TicketMessageBuilder) Content(content string) *TicketMessageBuilder { builder.content = content builder.contentFlag = true @@ -2713,7 +2713,7 @@ func (builder *TicketMessageBuilder) UserName(userName string) *TicketMessageBui return builder } -// 用户图片url +// 用户图片 url // // 示例值：https://internal-api-lark-file.feishu-boe.cn/static-resource/v1/3e73cdce-54b0-4c6a-8226-b131fb2825dj~?image_size=72x72&cut_type=&quality=&format=image&sticker_format=.webp func (builder *TicketMessageBuilder) AvatarUrl(avatarUrl string) *TicketMessageBuilder { @@ -2722,7 +2722,7 @@ func (builder *TicketMessageBuilder) AvatarUrl(avatarUrl string) *TicketMessageB return builder } -// 用户open ID +// 用户 open ID // // 示例值：ou_37019b7c830210acd88fdce886e25c71 func (builder *TicketMessageBuilder) UserId(userId string) *TicketMessageBuilder { @@ -2769,8 +2769,8 @@ func (builder *TicketMessageBuilder) Build() *TicketMessage { } type TicketCustomizedField struct { - TicketCustomizedFieldId *string `json:"ticket_customized_field_id,omitempty"` // 工单自定义字段ID - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台ID + TicketCustomizedFieldId *string `json:"ticket_customized_field_id,omitempty"` // 工单自定义字段 ID + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台 ID KeyName *string `json:"key_name,omitempty"` // 键名 DisplayName *string `json:"display_name,omitempty"` // 名称 Position *string `json:"position,omitempty"` // 字段在列表后台管理列表中的位置 @@ -2783,13 +2783,13 @@ type TicketCustomizedField struct { UpdatedAt *string `json:"updated_at,omitempty"` // 更新时间 CreatedBy *TicketUser `json:"created_by,omitempty"` // 创建用户 UpdatedBy *TicketUser `json:"updated_by,omitempty"` // 更新用户 - DropdownAllowMultiple *bool `json:"dropdown_allow_multiple,omitempty"` // 是否支持多选，仅在字段类型是dropdown的时候有效 + DropdownAllowMultiple *bool `json:"dropdown_allow_multiple,omitempty"` // 是否支持多选，仅在字段类型是 dropdown 的时候有效 } type TicketCustomizedFieldBuilder struct { - ticketCustomizedFieldId string // 工单自定义字段ID + ticketCustomizedFieldId string // 工单自定义字段 ID ticketCustomizedFieldIdFlag bool - helpdeskId string // 服务台ID + helpdeskId string // 服务台 ID helpdeskIdFlag bool keyName string // 键名 keyNameFlag bool @@ -2815,7 +2815,7 @@ type TicketCustomizedFieldBuilder struct { createdByFlag bool updatedBy *TicketUser // 更新用户 updatedByFlag bool - dropdownAllowMultiple bool // 是否支持多选，仅在字段类型是dropdown的时候有效 + dropdownAllowMultiple bool // 是否支持多选，仅在字段类型是 dropdown 的时候有效 dropdownAllowMultipleFlag bool } @@ -2824,7 +2824,7 @@ func NewTicketCustomizedFieldBuilder() *TicketCustomizedFieldBuilder { return builder } -// 工单自定义字段ID +// 工单自定义字段 ID // // 示例值：6834320707288072194 func (builder *TicketCustomizedFieldBuilder) TicketCustomizedFieldId(ticketCustomizedFieldId string) *TicketCustomizedFieldBuilder { @@ -2833,7 +2833,7 @@ func (builder *TicketCustomizedFieldBuilder) TicketCustomizedFieldId(ticketCusto return builder } -// 服务台ID +// 服务台 ID // // 示例值：1542164574896126 func (builder *TicketCustomizedFieldBuilder) HelpdeskId(helpdeskId string) *TicketCustomizedFieldBuilder { @@ -2950,7 +2950,7 @@ func (builder *TicketCustomizedFieldBuilder) UpdatedBy(updatedBy *TicketUser) *T return builder } -// 是否支持多选，仅在字段类型是dropdown的时候有效 +// 是否支持多选，仅在字段类型是 dropdown 的时候有效 // // 示例值：true func (builder *TicketCustomizedFieldBuilder) DropdownAllowMultiple(dropdownAllowMultiple bool) *TicketCustomizedFieldBuilder { @@ -3023,9 +3023,9 @@ func (builder *TicketCustomizedFieldBuilder) Build() *TicketCustomizedField { } type TicketEvent struct { - TicketId *string `json:"ticket_id,omitempty"` // 工单ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台id - Guest *TicketUserEvent `json:"guest,omitempty"` // 用户id + TicketId *string `json:"ticket_id,omitempty"` // 工单 ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台 id + Guest *TicketUserEvent `json:"guest,omitempty"` // 用户 id Stage *int `json:"stage,omitempty"` // 工单阶段：1. 机器人 2. 人工 Status *int `json:"status,omitempty"` // 工单状态，1：已创建 2: 处理中 3: 排队中 4：待定 5：待用户响应 50: 被机器人关闭 51: 被客服关闭 52: 用户自己关闭 Score *int `json:"score,omitempty"` // 工单评分，1：不满意，2:一般，3:满意 @@ -3042,11 +3042,11 @@ type TicketEvent struct { } type TicketEventBuilder struct { - ticketId string // 工单ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) + ticketId string // 工单 ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) ticketIdFlag bool - helpdeskId string // 服务台id + helpdeskId string // 服务台 id helpdeskIdFlag bool - guest *TicketUserEvent // 用户id + guest *TicketUserEvent // 用户 id guestFlag bool stage int // 工单阶段：1. 机器人 2. 人工 stageFlag bool @@ -3081,7 +3081,7 @@ func NewTicketEventBuilder() *TicketEventBuilder { return builder } -// 工单ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) +// 工单 ID;;[可以从工单列表里面取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list);;[也可以订阅工单创建事件获取](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/events/created) // // 示例值：6626871355780366331 func (builder *TicketEventBuilder) TicketId(ticketId string) *TicketEventBuilder { @@ -3090,7 +3090,7 @@ func (builder *TicketEventBuilder) TicketId(ticketId string) *TicketEventBuilder return builder } -// 服务台id +// 服务台 id // // 示例值：6626871355780366330 func (builder *TicketEventBuilder) HelpdeskId(helpdeskId string) *TicketEventBuilder { @@ -3099,7 +3099,7 @@ func (builder *TicketEventBuilder) HelpdeskId(helpdeskId string) *TicketEventBui return builder } -// 用户id +// 用户 id // // 示例值： func (builder *TicketEventBuilder) Guest(guest *TicketUserEvent) *TicketEventBuilder { @@ -3356,8 +3356,8 @@ func (builder *TicketEventUpdateInfoBuilder) Build() *TicketEventUpdateInfo { type TicketMessageContent struct { Content *string `json:"content,omitempty"` // 内容 MsgType *string `json:"msg_type,omitempty"` // 消息类型；text：纯文本；post：富文本；image：图片 - ImageKeys []string `json:"image_keys,omitempty"` // 图片ID - ImageKey *string `json:"image_key,omitempty"` // 图片ID + ImageKeys []string `json:"image_keys,omitempty"` // 图片 ID + ImageKey *string `json:"image_key,omitempty"` // 图片 ID } type TicketMessageContentBuilder struct { @@ -3365,9 +3365,9 @@ type TicketMessageContentBuilder struct { contentFlag bool msgType string // 消息类型；text：纯文本；post：富文本；image：图片 msgTypeFlag bool - imageKeys []string // 图片ID + imageKeys []string // 图片 ID imageKeysFlag bool - imageKey string // 图片ID + imageKey string // 图片 ID imageKeyFlag bool } @@ -3378,7 +3378,7 @@ func NewTicketMessageContentBuilder() *TicketMessageContentBuilder { // 内容 // -// 示例值：请问vpn怎么下载 +// 示例值：请问 vpn 怎么下载 func (builder *TicketMessageContentBuilder) Content(content string) *TicketMessageContentBuilder { builder.content = content builder.contentFlag = true @@ -3394,7 +3394,7 @@ func (builder *TicketMessageContentBuilder) MsgType(msgType string) *TicketMessa return builder } -// 图片ID +// 图片 ID // // 示例值： func (builder *TicketMessageContentBuilder) ImageKeys(imageKeys []string) *TicketMessageContentBuilder { @@ -3403,7 +3403,7 @@ func (builder *TicketMessageContentBuilder) ImageKeys(imageKeys []string) *Ticke return builder } -// 图片ID +// 图片 ID // // 示例值：xxx func (builder *TicketMessageContentBuilder) ImageKey(imageKey string) *TicketMessageContentBuilder { @@ -3532,7 +3532,7 @@ func (builder *TicketMessageEventBuilder) SenderType(senderType int) *TicketMess // message content // -// 示例值：请问vpn怎么下载 +// 示例值：请问 vpn 怎么下载 func (builder *TicketMessageEventBuilder) Text(text string) *TicketMessageEventBuilder { builder.text = text builder.textFlag = true @@ -3622,19 +3622,19 @@ func (builder *TicketMessageEventBuilder) Build() *TicketMessageEvent { } type TicketUser struct { - Id *string `json:"id,omitempty"` // 用户ID - AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像url + Id *string `json:"id,omitempty"` // 用户 ID + AvatarUrl *string `json:"avatar_url,omitempty"` // 用户头像 url Name *string `json:"name,omitempty"` // 用户名 Email *string `json:"email,omitempty"` // 用户邮箱 Department *string `json:"department,omitempty"` // 所在部门名称 City *string `json:"city,omitempty"` // 城市 - Country *string `json:"country,omitempty"` // 国家代号(CountryCode)，参考：http://www.mamicode.com/info-detail-2186501.html + Country *string `json:"country,omitempty"` // 国家代号 (CountryCode)，参考：http://www.mamicode.com/info-detail-2186501.html } type TicketUserBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool - avatarUrl string // 用户头像url + avatarUrl string // 用户头像 url avatarUrlFlag bool name string // 用户名 nameFlag bool @@ -3644,7 +3644,7 @@ type TicketUserBuilder struct { departmentFlag bool city string // 城市 cityFlag bool - country string // 国家代号(CountryCode)，参考：http://www.mamicode.com/info-detail-2186501.html + country string // 国家代号 (CountryCode)，参考：http://www.mamicode.com/info-detail-2186501.html countryFlag bool } @@ -3653,7 +3653,7 @@ func NewTicketUserBuilder() *TicketUserBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_37019b7c830210acd88fdce886e25c71 func (builder *TicketUserBuilder) Id(id string) *TicketUserBuilder { @@ -3662,7 +3662,7 @@ func (builder *TicketUserBuilder) Id(id string) *TicketUserBuilder { return builder } -// 用户头像url +// 用户头像 url // // 示例值：https://xxxx func (builder *TicketUserBuilder) AvatarUrl(avatarUrl string) *TicketUserBuilder { @@ -3691,7 +3691,7 @@ func (builder *TicketUserBuilder) Email(email string) *TicketUserBuilder { // 所在部门名称 // -// 示例值：用户部门名称(有权限才展示) +// 示例值：用户部门名称 (有权限才展示) func (builder *TicketUserBuilder) Department(department string) *TicketUserBuilder { builder.department = department builder.departmentFlag = true @@ -3707,7 +3707,7 @@ func (builder *TicketUserBuilder) City(city string) *TicketUserBuilder { return builder } -// 国家代号(CountryCode)，参考：http://www.mamicode.com/info-detail-2186501.html +// 国家代号 (CountryCode)，参考：http://www.mamicode.com/info-detail-2186501.html // // 示例值：国家 func (builder *TicketUserBuilder) Country(country string) *TicketUserBuilder { @@ -3829,9 +3829,9 @@ func (builder *TicketUserEventBuilder) Build() *TicketUserEvent { } type UserCustomizedField struct { - UserCustomizedFieldId *string `json:"user_customized_field_id,omitempty"` // 字段ID - Id *string `json:"id,omitempty"` // 旧字段ID，向后兼容用 - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台ID + UserCustomizedFieldId *string `json:"user_customized_field_id,omitempty"` // 字段 ID + Id *string `json:"id,omitempty"` // 旧字段 ID，向后兼容用 + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台 ID KeyName *string `json:"key_name,omitempty"` // 字段键 DisplayName *string `json:"display_name,omitempty"` // 字段展示名称 Position *string `json:"position,omitempty"` // 字段在列表中的展示位置 @@ -3845,11 +3845,11 @@ type UserCustomizedField struct { } type UserCustomizedFieldBuilder struct { - userCustomizedFieldId string // 字段ID + userCustomizedFieldId string // 字段 ID userCustomizedFieldIdFlag bool - id string // 旧字段ID，向后兼容用 + id string // 旧字段 ID，向后兼容用 idFlag bool - helpdeskId string // 服务台ID + helpdeskId string // 服务台 ID helpdeskIdFlag bool keyName string // 字段键 keyNameFlag bool @@ -3878,7 +3878,7 @@ func NewUserCustomizedFieldBuilder() *UserCustomizedFieldBuilder { return builder } -// 字段ID +// 字段 ID // // 示例值：6746384425543548981 func (builder *UserCustomizedFieldBuilder) UserCustomizedFieldId(userCustomizedFieldId string) *UserCustomizedFieldBuilder { @@ -3887,7 +3887,7 @@ func (builder *UserCustomizedFieldBuilder) UserCustomizedFieldId(userCustomizedF return builder } -// 旧字段ID，向后兼容用 +// 旧字段 ID，向后兼容用 // // 示例值：6746384425543548981 func (builder *UserCustomizedFieldBuilder) Id(id string) *UserCustomizedFieldBuilder { @@ -3896,7 +3896,7 @@ func (builder *UserCustomizedFieldBuilder) Id(id string) *UserCustomizedFieldBui return builder } -// 服务台ID +// 服务台 ID // // 示例值：1542164574896126 func (builder *UserCustomizedFieldBuilder) HelpdeskId(helpdeskId string) *UserCustomizedFieldBuilder { @@ -3943,7 +3943,7 @@ func (builder *UserCustomizedFieldBuilder) FieldType(fieldType string) *UserCust // 字段描述信息 // -// 示例值：租户ID +// 示例值：租户 ID func (builder *UserCustomizedFieldBuilder) Description(description string) *UserCustomizedFieldBuilder { builder.description = description builder.descriptionFlag = true @@ -4117,14 +4117,14 @@ func (builder *UserIdBuilder) Build() *UserId { } type UserQueryFaqInfo struct { - Id *string `json:"id,omitempty"` // faq服务台内唯一标识 - Score *float64 `json:"score,omitempty"` // faq匹配得分 + Id *string `json:"id,omitempty"` // faq 服务台内唯一标识 + Score *float64 `json:"score,omitempty"` // faq 匹配得分 } type UserQueryFaqInfoBuilder struct { - id string // faq服务台内唯一标识 + id string // faq 服务台内唯一标识 idFlag bool - score float64 // faq匹配得分 + score float64 // faq 匹配得分 scoreFlag bool } @@ -4133,7 +4133,7 @@ func NewUserQueryFaqInfoBuilder() *UserQueryFaqInfoBuilder { return builder } -// faq服务台内唯一标识 +// faq 服务台内唯一标识 // // 示例值：12345 func (builder *UserQueryFaqInfoBuilder) Id(id string) *UserQueryFaqInfoBuilder { @@ -4142,7 +4142,7 @@ func (builder *UserQueryFaqInfoBuilder) Id(id string) *UserQueryFaqInfoBuilder { return builder } -// faq匹配得分 +// faq 匹配得分 // // 示例值：0.9 func (builder *UserQueryFaqInfoBuilder) Score(score float64) *UserQueryFaqInfoBuilder { @@ -4165,17 +4165,17 @@ func (builder *UserQueryFaqInfoBuilder) Build() *UserQueryFaqInfo { } type WeekdaySchedule struct { - StartTime *string `json:"start_time,omitempty"` // 开始时间, format 00:00 - 23:59 - EndTime *string `json:"end_time,omitempty"` // 结束时间, format 00:00 - 23:59 - Weekday *int `json:"weekday,omitempty"` // 星期几, 1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday, 9 - Everday, 10 - Weekday, 11 - Weekend + StartTime *string `json:"start_time,omitempty"` // 开始时间，format 00:00 - 23:59 + EndTime *string `json:"end_time,omitempty"` // 结束时间，format 00:00 - 23:59 + Weekday *int `json:"weekday,omitempty"` // 星期几，1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday, 9 - Everday, 10 - Weekday, 11 - Weekend } type WeekdayScheduleBuilder struct { - startTime string // 开始时间, format 00:00 - 23:59 + startTime string // 开始时间，format 00:00 - 23:59 startTimeFlag bool - endTime string // 结束时间, format 00:00 - 23:59 + endTime string // 结束时间，format 00:00 - 23:59 endTimeFlag bool - weekday int // 星期几, 1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday, 9 - Everday, 10 - Weekday, 11 - Weekend + weekday int // 星期几，1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday, 9 - Everday, 10 - Weekday, 11 - Weekend weekdayFlag bool } @@ -4184,7 +4184,7 @@ func NewWeekdayScheduleBuilder() *WeekdayScheduleBuilder { return builder } -// 开始时间, format 00:00 - 23:59 +// 开始时间，format 00:00 - 23:59 // // 示例值：00:00 func (builder *WeekdayScheduleBuilder) StartTime(startTime string) *WeekdayScheduleBuilder { @@ -4193,7 +4193,7 @@ func (builder *WeekdayScheduleBuilder) StartTime(startTime string) *WeekdaySched return builder } -// 结束时间, format 00:00 - 23:59 +// 结束时间，format 00:00 - 23:59 // // 示例值：24:00 func (builder *WeekdayScheduleBuilder) EndTime(endTime string) *WeekdayScheduleBuilder { @@ -4202,7 +4202,7 @@ func (builder *WeekdayScheduleBuilder) EndTime(endTime string) *WeekdayScheduleB return builder } -// 星期几, 1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday, 9 - Everday, 10 - Weekday, 11 - Weekend +// 星期几，1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday, 9 - Everday, 10 - Weekday, 11 - Weekend // // 示例值：9 func (builder *WeekdayScheduleBuilder) Weekday(weekday int) *WeekdayScheduleBuilder { @@ -4310,7 +4310,7 @@ func NewPatchAgentReqBuilder() *PatchAgentReqBuilder { return builder } -// 客服id +// 客服 id // // 示例值：ou_14777d82ffef0f707de5a8c7ff2c5ebe func (builder *PatchAgentReqBuilder) AgentId(agentId string) *PatchAgentReqBuilder { @@ -4657,7 +4657,7 @@ func NewListAgentScheduleReqBuilder() *ListAgentScheduleReqBuilder { return builder } -// 筛选条件, 1 - online客服, 2 - offline(手动)客服, 3 - off duty(下班)客服, 4 - 移除客服 +// 筛选条件，1 - online 客服，2 - offline(手动) 客服，3 - off duty(下班) 客服，4 - 移除客服 // // 示例值：status=1&status=2 func (builder *ListAgentScheduleReqBuilder) Status(status []int) *ListAgentScheduleReqBuilder { @@ -4695,7 +4695,7 @@ func (resp *ListAgentScheduleResp) Success() bool { type CreateAgentSkillReqBodyBuilder struct { name string // 技能名 nameFlag bool - rules []*AgentSkillRule // 技能rules + rules []*AgentSkillRule // 技能 rules rulesFlag bool agentIds []string // 客服 ids agentIdsFlag bool @@ -4715,7 +4715,7 @@ func (builder *CreateAgentSkillReqBodyBuilder) Name(name string) *CreateAgentSki return builder } -// 技能rules +// 技能 rules // //示例值： func (builder *CreateAgentSkillReqBodyBuilder) Rules(rules []*AgentSkillRule) *CreateAgentSkillReqBodyBuilder { @@ -4726,7 +4726,7 @@ func (builder *CreateAgentSkillReqBodyBuilder) Rules(rules []*AgentSkillRule) *C // 客服 ids // -//示例值：["客服ID"] +//示例值：["客服 ID"] func (builder *CreateAgentSkillReqBodyBuilder) AgentIds(agentIds []string) *CreateAgentSkillReqBodyBuilder { builder.agentIds = agentIds builder.agentIdsFlag = true @@ -4750,7 +4750,7 @@ func (builder *CreateAgentSkillReqBodyBuilder) Build() *CreateAgentSkillReqBody type CreateAgentSkillPathReqBodyBuilder struct { name string // 技能名 nameFlag bool - rules []*AgentSkillRule // 技能rules + rules []*AgentSkillRule // 技能 rules rulesFlag bool agentIds []string // 客服 ids agentIdsFlag bool @@ -4770,7 +4770,7 @@ func (builder *CreateAgentSkillPathReqBodyBuilder) Name(name string) *CreateAgen return builder } -// 技能rules +// 技能 rules // // 示例值： func (builder *CreateAgentSkillPathReqBodyBuilder) Rules(rules []*AgentSkillRule) *CreateAgentSkillPathReqBodyBuilder { @@ -4781,7 +4781,7 @@ func (builder *CreateAgentSkillPathReqBodyBuilder) Rules(rules []*AgentSkillRule // 客服 ids // -// 示例值：["客服ID"] +// 示例值：["客服 ID"] func (builder *CreateAgentSkillPathReqBodyBuilder) AgentIds(agentIds []string) *CreateAgentSkillPathReqBodyBuilder { builder.agentIds = agentIds builder.agentIdsFlag = true @@ -4831,7 +4831,7 @@ func (builder *CreateAgentSkillReqBuilder) Build() *CreateAgentSkillReq { type CreateAgentSkillReqBody struct { Name *string `json:"name,omitempty"` // 技能名 - Rules []*AgentSkillRule `json:"rules,omitempty"` // 技能rules + Rules []*AgentSkillRule `json:"rules,omitempty"` // 技能 rules AgentIds []string `json:"agent_ids,omitempty"` // 客服 ids } @@ -4841,7 +4841,7 @@ type CreateAgentSkillReq struct { } type CreateAgentSkillRespData struct { - AgentSkillId *string `json:"agent_skill_id,omitempty"` // 客服技能id + AgentSkillId *string `json:"agent_skill_id,omitempty"` // 客服技能 id } type CreateAgentSkillResp struct { @@ -5064,7 +5064,7 @@ func (resp *PatchAgentSkillResp) Success() bool { } type ListAgentSkillRuleRespData struct { - Rules []*AgentSkillRule `json:"rules,omitempty"` // rules列表 + Rules []*AgentSkillRule `json:"rules,omitempty"` // rules 列表 } type ListAgentSkillRuleResp struct { @@ -5091,7 +5091,7 @@ func NewCreateBotMessageReqBuilder() *CreateBotMessageReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateBotMessageReqBuilder) UserIdType(userIdType string) *CreateBotMessageReqBuilder { @@ -5119,7 +5119,7 @@ type CreateBotMessageReq struct { } type CreateBotMessageRespData struct { - MessageId *string `json:"message_id,omitempty"` // chat消息open_id + MessageId *string `json:"message_id,omitempty"` // chat 消息 open_id } type CreateBotMessageResp struct { @@ -5191,7 +5191,7 @@ func NewDeleteCategoryReqBuilder() *DeleteCategoryReqBuilder { return builder } -// 知识库分类ID +// 知识库分类 ID // // 示例值：6948728206392295444 func (builder *DeleteCategoryReqBuilder) Id(id string) *DeleteCategoryReqBuilder { @@ -5232,7 +5232,7 @@ func NewGetCategoryReqBuilder() *GetCategoryReqBuilder { return builder } -// 知识库分类ID +// 知识库分类 ID // // 示例值：6948728206392295444 func (builder *GetCategoryReqBuilder) Id(id string) *GetCategoryReqBuilder { @@ -5737,7 +5737,7 @@ func NewFaqImageFaqReqBuilder() *FaqImageFaqReqBuilder { return builder } -// 知识库ID +// 知识库 ID // // 示例值：12345 func (builder *FaqImageFaqReqBuilder) Id(id string) *FaqImageFaqReqBuilder { @@ -5745,7 +5745,7 @@ func (builder *FaqImageFaqReqBuilder) Id(id string) *FaqImageFaqReqBuilder { return builder } -// 图像key +// 图像 key // // 示例值：img_b07ffac0-19c1-48a3-afca-599f8ea825fj func (builder *FaqImageFaqReqBuilder) ImageKey(imageKey string) *FaqImageFaqReqBuilder { @@ -5801,7 +5801,7 @@ func NewGetFaqReqBuilder() *GetFaqReqBuilder { return builder } -// 知识库ID +// 知识库 ID // // 示例值：6856395634652479491 func (builder *GetFaqReqBuilder) Id(id string) *GetFaqReqBuilder { @@ -5854,7 +5854,7 @@ func (builder *ListFaqReqBuilder) Limit(limit int) *ListFaqReqBuilder { return builder } -// 知识库分类ID +// 知识库分类 ID // // 示例值：6856395522433908739 func (builder *ListFaqReqBuilder) CategoryId(categoryId string) *ListFaqReqBuilder { @@ -5862,7 +5862,7 @@ func (builder *ListFaqReqBuilder) CategoryId(categoryId string) *ListFaqReqBuild return builder } -// 搜索条件: 知识库状态 1:在线 0:删除，可恢复 2：删除，不可恢复 +// 搜索条件：知识库状态 1:在线 0:删除，可恢复 2：删除，不可恢复 // // 示例值：1 func (builder *ListFaqReqBuilder) Status(status string) *ListFaqReqBuilder { @@ -5870,7 +5870,7 @@ func (builder *ListFaqReqBuilder) Status(status string) *ListFaqReqBuilder { return builder } -// 搜索条件: 关键词，匹配问题标题，问题关键字，用户姓名 +// 搜索条件：关键词，匹配问题标题，问题关键字，用户姓名 // // 示例值：点餐 func (builder *ListFaqReqBuilder) Search(search string) *ListFaqReqBuilder { @@ -5911,7 +5911,7 @@ type ListFaqReq struct { type ListFaqRespData struct { HasMore *bool `json:"has_more,omitempty"` // if there's next page PageToken *string `json:"page_token,omitempty"` // the next page token - PageSize *int `json:"page_size,omitempty"` // 实际返回的FAQ数量 + PageSize *int `json:"page_size,omitempty"` // 实际返回的 FAQ 数量 Total *int `json:"total,omitempty"` // 总数 Items []*Faq `json:"items,omitempty"` // 知识库列表 } @@ -5994,7 +5994,7 @@ func NewPatchFaqReqBuilder() *PatchFaqReqBuilder { return builder } -// 知识库ID +// 知识库 ID // // 示例值：6856395634652479491 func (builder *PatchFaqReqBuilder) Id(id string) *PatchFaqReqBuilder { @@ -6054,7 +6054,7 @@ func (builder *SearchFaqReqBuilder) Limit(limit int) *SearchFaqReqBuilder { return builder } -// 搜索query;，query内容如果不是英文，包含中文空格等有两种编码策略：1. url编码 2. base64编码，同时加上base64=true参数 +// 搜索 query;，query 内容如果不是英文，包含中文空格等有两种编码策略：1. url 编码 2. base64 编码，同时加上 base64=true 参数 // // 示例值：wifi func (builder *SearchFaqReqBuilder) Query(query string) *SearchFaqReqBuilder { @@ -6062,7 +6062,7 @@ func (builder *SearchFaqReqBuilder) Query(query string) *SearchFaqReqBuilder { return builder } -// 是否转换为base64,输入true表示是，不填写表示否，中文需要转换为base64 +// 是否转换为 base64，输入 true 表示是，不填写表示否，中文需要转换为 base64 // // 示例值：5bel5Y2V func (builder *SearchFaqReqBuilder) Base64(base64 string) *SearchFaqReqBuilder { @@ -6129,7 +6129,7 @@ func NewCancelApproveNotificationReqBuilder() *CancelApproveNotificationReqBuild return builder } -// 唯一ID +// 唯一 ID // // 示例值：6981801914270744596 func (builder *CancelApproveNotificationReqBuilder) NotificationId(notificationId string) *CancelApproveNotificationReqBuilder { @@ -6158,7 +6158,7 @@ func (resp *CancelApproveNotificationResp) Success() bool { } type CancelSendNotificationReqBodyBuilder struct { - isRecall bool // 是否召回已发送的消息,新人入职消息同样适用 + isRecall bool // 是否召回已发送的消息，新人入职消息同样适用 isRecallFlag bool } @@ -6167,7 +6167,7 @@ func NewCancelSendNotificationReqBodyBuilder() *CancelSendNotificationReqBodyBui return builder } -// 是否召回已发送的消息,新人入职消息同样适用 +// 是否召回已发送的消息，新人入职消息同样适用 // //示例值：true func (builder *CancelSendNotificationReqBodyBuilder) IsRecall(isRecall bool) *CancelSendNotificationReqBodyBuilder { @@ -6185,7 +6185,7 @@ func (builder *CancelSendNotificationReqBodyBuilder) Build() *CancelSendNotifica } type CancelSendNotificationPathReqBodyBuilder struct { - isRecall bool // 是否召回已发送的消息,新人入职消息同样适用 + isRecall bool // 是否召回已发送的消息，新人入职消息同样适用 isRecallFlag bool } @@ -6194,7 +6194,7 @@ func NewCancelSendNotificationPathReqBodyBuilder() *CancelSendNotificationPathRe return builder } -// 是否召回已发送的消息,新人入职消息同样适用 +// 是否召回已发送的消息，新人入职消息同样适用 // // 示例值：true func (builder *CancelSendNotificationPathReqBodyBuilder) IsRecall(isRecall bool) *CancelSendNotificationPathReqBodyBuilder { @@ -6225,7 +6225,7 @@ func NewCancelSendNotificationReqBuilder() *CancelSendNotificationReqBuilder { return builder } -// 唯一ID +// 唯一 ID // // 示例值：6981801914270744596 func (builder *CancelSendNotificationReqBuilder) NotificationId(notificationId string) *CancelSendNotificationReqBuilder { @@ -6248,7 +6248,7 @@ func (builder *CancelSendNotificationReqBuilder) Build() *CancelSendNotification } type CancelSendNotificationReqBody struct { - IsRecall *bool `json:"is_recall,omitempty"` // 是否召回已发送的消息,新人入职消息同样适用 + IsRecall *bool `json:"is_recall,omitempty"` // 是否召回已发送的消息，新人入职消息同样适用 } type CancelSendNotificationReq struct { @@ -6279,7 +6279,7 @@ func NewCreateNotificationReqBuilder() *CreateNotificationReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateNotificationReqBuilder) UserIdType(userIdType string) *CreateNotificationReqBuilder { @@ -6307,7 +6307,7 @@ type CreateNotificationReq struct { } type CreateNotificationRespData struct { - NotificationId *string `json:"notification_id,omitempty"` // 创建成功后的唯一id + NotificationId *string `json:"notification_id,omitempty"` // 创建成功后的唯一 id Status *int `json:"status,omitempty"` // 当前状态 } @@ -6322,7 +6322,7 @@ func (resp *CreateNotificationResp) Success() bool { } type ExecuteSendNotificationReqBodyBuilder struct { - sendAt string // 发送时间戳(毫秒) + sendAt string // 发送时间戳 (毫秒) sendAtFlag bool } @@ -6331,7 +6331,7 @@ func NewExecuteSendNotificationReqBodyBuilder() *ExecuteSendNotificationReqBodyB return builder } -// 发送时间戳(毫秒) +// 发送时间戳 (毫秒) // //示例值：1624326025000 func (builder *ExecuteSendNotificationReqBodyBuilder) SendAt(sendAt string) *ExecuteSendNotificationReqBodyBuilder { @@ -6349,7 +6349,7 @@ func (builder *ExecuteSendNotificationReqBodyBuilder) Build() *ExecuteSendNotifi } type ExecuteSendNotificationPathReqBodyBuilder struct { - sendAt string // 发送时间戳(毫秒) + sendAt string // 发送时间戳 (毫秒) sendAtFlag bool } @@ -6358,7 +6358,7 @@ func NewExecuteSendNotificationPathReqBodyBuilder() *ExecuteSendNotificationPath return builder } -// 发送时间戳(毫秒) +// 发送时间戳 (毫秒) // // 示例值：1624326025000 func (builder *ExecuteSendNotificationPathReqBodyBuilder) SendAt(sendAt string) *ExecuteSendNotificationPathReqBodyBuilder { @@ -6389,7 +6389,7 @@ func NewExecuteSendNotificationReqBuilder() *ExecuteSendNotificationReqBuilder { return builder } -// 创建接口返回的唯一id +// 创建接口返回的唯一 id // // 示例值：6985032626234982420 func (builder *ExecuteSendNotificationReqBuilder) NotificationId(notificationId string) *ExecuteSendNotificationReqBuilder { @@ -6412,7 +6412,7 @@ func (builder *ExecuteSendNotificationReqBuilder) Build() *ExecuteSendNotificati } type ExecuteSendNotificationReqBody struct { - SendAt *string `json:"send_at,omitempty"` // 发送时间戳(毫秒) + SendAt *string `json:"send_at,omitempty"` // 发送时间戳 (毫秒) } type ExecuteSendNotificationReq struct { @@ -6442,7 +6442,7 @@ func NewGetNotificationReqBuilder() *GetNotificationReqBuilder { return builder } -// 唯一ID +// 唯一 ID // // 示例值：1624326025000 func (builder *GetNotificationReqBuilder) NotificationId(notificationId string) *GetNotificationReqBuilder { @@ -6450,7 +6450,7 @@ func (builder *GetNotificationReqBuilder) NotificationId(notificationId string) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetNotificationReqBuilder) UserIdType(userIdType string) *GetNotificationReqBuilder { @@ -6471,7 +6471,7 @@ type GetNotificationReq struct { } type GetNotificationRespData struct { - Notification *Notification `json:"notification,omitempty"` // push任务详情 + Notification *Notification `json:"notification,omitempty"` // push 任务详情 ApprovalAppLink *string `json:"approval_app_link,omitempty"` // 审批链接 } @@ -6499,7 +6499,7 @@ func NewPatchNotificationReqBuilder() *PatchNotificationReqBuilder { return builder } -// push任务唯一id +// push 任务唯一 id // // 示例值：6985032626234982420 func (builder *PatchNotificationReqBuilder) NotificationId(notificationId string) *PatchNotificationReqBuilder { @@ -6507,7 +6507,7 @@ func (builder *PatchNotificationReqBuilder) NotificationId(notificationId string return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchNotificationReqBuilder) UserIdType(userIdType string) *PatchNotificationReqBuilder { @@ -6557,7 +6557,7 @@ func NewPreviewNotificationReqBuilder() *PreviewNotificationReqBuilder { return builder } -// 创建推送接口成功后返回的唯一id +// 创建推送接口成功后返回的唯一 id // // 示例值：6985032626234982420 func (builder *PreviewNotificationReqBuilder) NotificationId(notificationId string) *PreviewNotificationReqBuilder { @@ -6653,7 +6653,7 @@ func NewSubmitApproveNotificationReqBuilder() *SubmitApproveNotificationReqBuild return builder } -// 创建接口返回的唯一id +// 创建接口返回的唯一 id // // 示例值：6985032626234982420 func (builder *SubmitApproveNotificationReqBuilder) NotificationId(notificationId string) *SubmitApproveNotificationReqBuilder { @@ -6661,7 +6661,7 @@ func (builder *SubmitApproveNotificationReqBuilder) NotificationId(notificationI return builder } -// 正常情况下调用创建推送接口后，就可以调用提交审核接口，如果创建人是服务台owner则会自动审核通过，否则会通知服务台owner审核此推送信息 +// 正常情况下调用创建推送接口后，就可以调用提交审核接口，如果创建人是服务台 owner 则会自动审核通过，否则会通知服务台 owner 审核此推送信息 func (builder *SubmitApproveNotificationReqBuilder) Body(body *SubmitApproveNotificationReqBody) *SubmitApproveNotificationReqBuilder { builder.body = body return builder @@ -6685,7 +6685,7 @@ type SubmitApproveNotificationReq struct { } type SubmitApproveNotificationRespData struct { - HasAccess *bool `json:"has_access,omitempty"` // 是否有权限创建或者管理审批流程 （有两种情况会导致没有权限： 1：用户没有安装服务台小程序，需要在https://app.feishu.cn/app/cli_9f9f8825d53b900d 安装小程序 2：用户安装的服务台小程序版本过低） + HasAccess *bool `json:"has_access,omitempty"` // 是否有权限创建或者管理审批流程（有两种情况会导致没有权限： 1：用户没有安装服务台小程序，需要在 https://app.feishu.cn/app/cli_9f9f8825d53b900d 安装小程序 2：用户安装的服务台小程序版本过低） } type SubmitApproveNotificationResp struct { @@ -6699,9 +6699,9 @@ func (resp *SubmitApproveNotificationResp) Success() bool { } type AnswerUserQueryTicketReqBodyBuilder struct { - eventId string // 事件ID,可从订阅事件中提取 + eventId string // 事件 ID，可从订阅事件中提取 eventIdFlag bool - faqs []*UserQueryFaqInfo // faq结果列表 + faqs []*UserQueryFaqInfo // faq 结果列表 faqsFlag bool } @@ -6710,7 +6710,7 @@ func NewAnswerUserQueryTicketReqBodyBuilder() *AnswerUserQueryTicketReqBodyBuild return builder } -// 事件ID,可从订阅事件中提取 +// 事件 ID，可从订阅事件中提取 // //示例值：abcd func (builder *AnswerUserQueryTicketReqBodyBuilder) EventId(eventId string) *AnswerUserQueryTicketReqBodyBuilder { @@ -6719,7 +6719,7 @@ func (builder *AnswerUserQueryTicketReqBodyBuilder) EventId(eventId string) *Ans return builder } -// faq结果列表 +// faq 结果列表 // //示例值： func (builder *AnswerUserQueryTicketReqBodyBuilder) Faqs(faqs []*UserQueryFaqInfo) *AnswerUserQueryTicketReqBodyBuilder { @@ -6740,9 +6740,9 @@ func (builder *AnswerUserQueryTicketReqBodyBuilder) Build() *AnswerUserQueryTick } type AnswerUserQueryTicketPathReqBodyBuilder struct { - eventId string // 事件ID,可从订阅事件中提取 + eventId string // 事件 ID，可从订阅事件中提取 eventIdFlag bool - faqs []*UserQueryFaqInfo // faq结果列表 + faqs []*UserQueryFaqInfo // faq 结果列表 faqsFlag bool } @@ -6751,7 +6751,7 @@ func NewAnswerUserQueryTicketPathReqBodyBuilder() *AnswerUserQueryTicketPathReqB return builder } -// 事件ID,可从订阅事件中提取 +// 事件 ID，可从订阅事件中提取 // // 示例值：abcd func (builder *AnswerUserQueryTicketPathReqBodyBuilder) EventId(eventId string) *AnswerUserQueryTicketPathReqBodyBuilder { @@ -6760,7 +6760,7 @@ func (builder *AnswerUserQueryTicketPathReqBodyBuilder) EventId(eventId string) return builder } -// faq结果列表 +// faq 结果列表 // // 示例值： func (builder *AnswerUserQueryTicketPathReqBodyBuilder) Faqs(faqs []*UserQueryFaqInfo) *AnswerUserQueryTicketPathReqBodyBuilder { @@ -6794,7 +6794,7 @@ func NewAnswerUserQueryTicketReqBuilder() *AnswerUserQueryTicketReqBuilder { return builder } -// 工单ID +// 工单 ID // // 示例值：6945345902185807891 func (builder *AnswerUserQueryTicketReqBuilder) TicketId(ticketId string) *AnswerUserQueryTicketReqBuilder { @@ -6817,8 +6817,8 @@ func (builder *AnswerUserQueryTicketReqBuilder) Build() *AnswerUserQueryTicketRe } type AnswerUserQueryTicketReqBody struct { - EventId *string `json:"event_id,omitempty"` // 事件ID,可从订阅事件中提取 - Faqs []*UserQueryFaqInfo `json:"faqs,omitempty"` // faq结果列表 + EventId *string `json:"event_id,omitempty"` // 事件 ID，可从订阅事件中提取 + Faqs []*UserQueryFaqInfo `json:"faqs,omitempty"` // faq 结果列表 } type AnswerUserQueryTicketReq struct { @@ -6941,7 +6941,7 @@ func NewListTicketReqBuilder() *ListTicketReqBuilder { return builder } -// 搜索条件：工单ID +// 搜索条件：工单 ID // // 示例值：123456 func (builder *ListTicketReqBuilder) TicketId(ticketId string) *ListTicketReqBuilder { @@ -6949,7 +6949,7 @@ func (builder *ListTicketReqBuilder) TicketId(ticketId string) *ListTicketReqBui return builder } -// 搜索条件: 客服id +// 搜索条件：客服 id // // 示例值：ou_b5de90429xxx func (builder *ListTicketReqBuilder) AgentId(agentId string) *ListTicketReqBuilder { @@ -6957,7 +6957,7 @@ func (builder *ListTicketReqBuilder) AgentId(agentId string) *ListTicketReqBuild return builder } -// 搜索条件: 关单客服id +// 搜索条件：关单客服 id // // 示例值：ou_b5de90429xxx func (builder *ListTicketReqBuilder) ClosedById(closedById string) *ListTicketReqBuilder { @@ -6965,7 +6965,7 @@ func (builder *ListTicketReqBuilder) ClosedById(closedById string) *ListTicketRe return builder } -// 搜索条件: 工单类型 1:bot 2:人工 +// 搜索条件：工单类型 1:bot 2:人工 // // 示例值：1 func (builder *ListTicketReqBuilder) Type(type_ int) *ListTicketReqBuilder { @@ -6973,7 +6973,7 @@ func (builder *ListTicketReqBuilder) Type(type_ int) *ListTicketReqBuilder { return builder } -// 搜索条件: 工单渠道 +// 搜索条件：工单渠道 // // 示例值：0 func (builder *ListTicketReqBuilder) Channel(channel int) *ListTicketReqBuilder { @@ -6981,7 +6981,7 @@ func (builder *ListTicketReqBuilder) Channel(channel int) *ListTicketReqBuilder return builder } -// 搜索条件: 工单是否解决 1:没解决 2:已解决 +// 搜索条件：工单是否解决 1:没解决 2:已解决 // // 示例值：1 func (builder *ListTicketReqBuilder) Solved(solved int) *ListTicketReqBuilder { @@ -6989,7 +6989,7 @@ func (builder *ListTicketReqBuilder) Solved(solved int) *ListTicketReqBuilder { return builder } -// 搜索条件: 工单评分 +// 搜索条件：工单评分 // // 示例值：1 func (builder *ListTicketReqBuilder) Score(score int) *ListTicketReqBuilder { @@ -6997,7 +6997,7 @@ func (builder *ListTicketReqBuilder) Score(score int) *ListTicketReqBuilder { return builder } -// 搜索条件: 工单状态列表 +// 搜索条件：工单状态列表 // // 示例值：1 func (builder *ListTicketReqBuilder) StatusList(statusList []int) *ListTicketReqBuilder { @@ -7007,7 +7007,7 @@ func (builder *ListTicketReqBuilder) StatusList(statusList []int) *ListTicketReq return builder } -// 搜索条件: 用户名称 +// 搜索条件：用户名称 // // 示例值：abc func (builder *ListTicketReqBuilder) GuestName(guestName string) *ListTicketReqBuilder { @@ -7015,7 +7015,7 @@ func (builder *ListTicketReqBuilder) GuestName(guestName string) *ListTicketReqB return builder } -// 搜索条件: 用户id +// 搜索条件：用户 id // // 示例值：ou_b5de90429xxx func (builder *ListTicketReqBuilder) GuestId(guestId string) *ListTicketReqBuilder { @@ -7023,7 +7023,7 @@ func (builder *ListTicketReqBuilder) GuestId(guestId string) *ListTicketReqBuild return builder } -// 搜索条件: 用户标签列表 +// 搜索条件：用户标签列表 // // 示例值：备注 func (builder *ListTicketReqBuilder) Tags(tags []string) *ListTicketReqBuilder { @@ -7033,7 +7033,7 @@ func (builder *ListTicketReqBuilder) Tags(tags []string) *ListTicketReqBuilder { return builder } -// 页数, 从1开始, 默认为1 +// 页数，从 1 开始，默认为 1 // // 示例值：1 func (builder *ListTicketReqBuilder) Page(page int) *ListTicketReqBuilder { @@ -7041,7 +7041,7 @@ func (builder *ListTicketReqBuilder) Page(page int) *ListTicketReqBuilder { return builder } -// 当前页大小，最大为200， 默认为20。分页查询最多累计返回一万条数据，超过一万条请更改查询条件，推荐通过时间查询。 +// 当前页大小，最大为 200， 默认为 20。分页查询最多累计返回一万条数据，超过一万条请更改查询条件，推荐通过时间查询。 // // 示例值：20 func (builder *ListTicketReqBuilder) PageSize(pageSize int) *ListTicketReqBuilder { @@ -7049,7 +7049,7 @@ func (builder *ListTicketReqBuilder) PageSize(pageSize int) *ListTicketReqBuilde return builder } -// 搜索条件: 工单创建起始时间 ms (也需要填上create_time_end)，相当于>=create_time_start +// 搜索条件：工单创建起始时间 ms (也需要填上 create_time_end)，相当于>=create_time_start // // 示例值：1616920429000 func (builder *ListTicketReqBuilder) CreateTimeStart(createTimeStart int) *ListTicketReqBuilder { @@ -7057,7 +7057,7 @@ func (builder *ListTicketReqBuilder) CreateTimeStart(createTimeStart int) *ListT return builder } -// 搜索条件: 工单创建结束时间 ms (也需要填上create_time_start)，相当于<=create_time_end +// 搜索条件：工单创建结束时间 ms (也需要填上 create_time_start)，相当于<=create_time_end // // 示例值：1616920429000 func (builder *ListTicketReqBuilder) CreateTimeEnd(createTimeEnd int) *ListTicketReqBuilder { @@ -7065,7 +7065,7 @@ func (builder *ListTicketReqBuilder) CreateTimeEnd(createTimeEnd int) *ListTicke return builder } -// 搜索条件: 工单修改起始时间 ms (也需要填上update_time_end) +// 搜索条件：工单修改起始时间 ms (也需要填上 update_time_end) // // 示例值：1616920429000 func (builder *ListTicketReqBuilder) UpdateTimeStart(updateTimeStart int) *ListTicketReqBuilder { @@ -7073,7 +7073,7 @@ func (builder *ListTicketReqBuilder) UpdateTimeStart(updateTimeStart int) *ListT return builder } -// 搜索条件: 工单修改结束时间 ms(也需要填上update_time_start) +// 搜索条件：工单修改结束时间 ms(也需要填上 update_time_start) // // 示例值：1616920429000 func (builder *ListTicketReqBuilder) UpdateTimeEnd(updateTimeEnd int) *ListTicketReqBuilder { @@ -7093,7 +7093,7 @@ type ListTicketReq struct { } type ListTicketRespData struct { - Total *int `json:"total,omitempty"` // 工单总数 (单次请求最大为10000条) + Total *int `json:"total,omitempty"` // 工单总数 (单次请求最大为 10000 条) Tickets []*Ticket `json:"tickets,omitempty"` // 工单 } @@ -7108,13 +7108,13 @@ func (resp *ListTicketResp) Success() bool { } type StartServiceTicketReqBodyBuilder struct { - humanService bool // 是否直接进入人工(若appointed_agents填写了，该值为必填) + humanService bool // 是否直接进入人工 (若 appointed_agents 填写了，该值为必填) humanServiceFlag bool - appointedAgents []string // 客服 open ids (获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true + appointedAgents []string // 客服 open ids (获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service 需要为 true appointedAgentsFlag bool - openId string // 用户 open id,(获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) + openId string // 用户 open id,(获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) openIdFlag bool - customizedInfo string // 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 + customizedInfo string // 工单来源自定义信息，长度限制 1024 字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) 会返回此信息 customizedInfoFlag bool } @@ -7123,7 +7123,7 @@ func NewStartServiceTicketReqBodyBuilder() *StartServiceTicketReqBodyBuilder { return builder } -// 是否直接进入人工(若appointed_agents填写了，该值为必填) +// 是否直接进入人工 (若 appointed_agents 填写了，该值为必填) // //示例值：false func (builder *StartServiceTicketReqBodyBuilder) HumanService(humanService bool) *StartServiceTicketReqBodyBuilder { @@ -7132,7 +7132,7 @@ func (builder *StartServiceTicketReqBodyBuilder) HumanService(humanService bool) return builder } -// 客服 open ids (获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true +// 客服 open ids (获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service 需要为 true // //示例值：[ou_7dab8a3d3cdcc9da365777c7ad535d62] func (builder *StartServiceTicketReqBodyBuilder) AppointedAgents(appointedAgents []string) *StartServiceTicketReqBodyBuilder { @@ -7141,7 +7141,7 @@ func (builder *StartServiceTicketReqBodyBuilder) AppointedAgents(appointedAgents return builder } -// 用户 open id,(获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) +// 用户 open id,(获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) // //示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *StartServiceTicketReqBodyBuilder) OpenId(openId string) *StartServiceTicketReqBodyBuilder { @@ -7150,7 +7150,7 @@ func (builder *StartServiceTicketReqBodyBuilder) OpenId(openId string) *StartSer return builder } -// 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 +// 工单来源自定义信息，长度限制 1024 字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) 会返回此信息 // //示例值：测试自定义字段信息 func (builder *StartServiceTicketReqBodyBuilder) CustomizedInfo(customizedInfo string) *StartServiceTicketReqBodyBuilder { @@ -7177,13 +7177,13 @@ func (builder *StartServiceTicketReqBodyBuilder) Build() *StartServiceTicketReqB } type StartServiceTicketPathReqBodyBuilder struct { - humanService bool // 是否直接进入人工(若appointed_agents填写了，该值为必填) + humanService bool // 是否直接进入人工 (若 appointed_agents 填写了，该值为必填) humanServiceFlag bool - appointedAgents []string // 客服 open ids (获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true + appointedAgents []string // 客服 open ids (获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service 需要为 true appointedAgentsFlag bool - openId string // 用户 open id,(获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) + openId string // 用户 open id,(获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) openIdFlag bool - customizedInfo string // 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 + customizedInfo string // 工单来源自定义信息，长度限制 1024 字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) 会返回此信息 customizedInfoFlag bool } @@ -7192,7 +7192,7 @@ func NewStartServiceTicketPathReqBodyBuilder() *StartServiceTicketPathReqBodyBui return builder } -// 是否直接进入人工(若appointed_agents填写了，该值为必填) +// 是否直接进入人工 (若 appointed_agents 填写了，该值为必填) // // 示例值：false func (builder *StartServiceTicketPathReqBodyBuilder) HumanService(humanService bool) *StartServiceTicketPathReqBodyBuilder { @@ -7201,7 +7201,7 @@ func (builder *StartServiceTicketPathReqBodyBuilder) HumanService(humanService b return builder } -// 客服 open ids (获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true +// 客服 open ids (获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service 需要为 true // // 示例值：[ou_7dab8a3d3cdcc9da365777c7ad535d62] func (builder *StartServiceTicketPathReqBodyBuilder) AppointedAgents(appointedAgents []string) *StartServiceTicketPathReqBodyBuilder { @@ -7210,7 +7210,7 @@ func (builder *StartServiceTicketPathReqBodyBuilder) AppointedAgents(appointedAg return builder } -// 用户 open id,(获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) +// 用户 open id,(获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) // // 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 func (builder *StartServiceTicketPathReqBodyBuilder) OpenId(openId string) *StartServiceTicketPathReqBodyBuilder { @@ -7219,7 +7219,7 @@ func (builder *StartServiceTicketPathReqBodyBuilder) OpenId(openId string) *Star return builder } -// 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 +// 工单来源自定义信息，长度限制 1024 字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) 会返回此信息 // // 示例值：测试自定义字段信息 func (builder *StartServiceTicketPathReqBodyBuilder) CustomizedInfo(customizedInfo string) *StartServiceTicketPathReqBodyBuilder { @@ -7273,10 +7273,10 @@ func (builder *StartServiceTicketReqBuilder) Build() *StartServiceTicketReq { } type StartServiceTicketReqBody struct { - HumanService *bool `json:"human_service,omitempty"` // 是否直接进入人工(若appointed_agents填写了，该值为必填) - AppointedAgents []string `json:"appointed_agents,omitempty"` // 客服 open ids (获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service需要为true - OpenId *string `json:"open_id,omitempty"` // 用户 open id,(获取方式参考[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) - CustomizedInfo *string `json:"customized_info,omitempty"` // 工单来源自定义信息，长度限制1024字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get)会返回此信息 + HumanService *bool `json:"human_service,omitempty"` // 是否直接进入人工 (若 appointed_agents 填写了，该值为必填) + AppointedAgents []string `json:"appointed_agents,omitempty"` // 客服 open ids (获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get))，human_service 需要为 true + OpenId *string `json:"open_id,omitempty"` // 用户 open id,(获取方式参考 [获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)) + CustomizedInfo *string `json:"customized_info,omitempty"` // 工单来源自定义信息，长度限制 1024 字符，如设置，[获取工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/get) 会返回此信息 } type StartServiceTicketReq struct { @@ -7285,7 +7285,7 @@ type StartServiceTicketReq struct { } type StartServiceTicketRespData struct { - ChatId *string `json:"chat_id,omitempty"` // 客服群open ID + ChatId *string `json:"chat_id,omitempty"` // 客服群 open ID } type StartServiceTicketResp struct { @@ -7311,7 +7311,7 @@ func NewTicketImageTicketReqBuilder() *TicketImageTicketReqBuilder { return builder } -// 工单ID +// 工单 ID // // 示例值：12345 func (builder *TicketImageTicketReqBuilder) TicketId(ticketId string) *TicketImageTicketReqBuilder { @@ -7319,7 +7319,7 @@ func (builder *TicketImageTicketReqBuilder) TicketId(ticketId string) *TicketIma return builder } -// 消息ID;;[查询消息ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/list) +// 消息 ID;;[查询消息 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket-message/list) // // 示例值：12345 func (builder *TicketImageTicketReqBuilder) MsgId(msgId string) *TicketImageTicketReqBuilder { @@ -7327,7 +7327,7 @@ func (builder *TicketImageTicketReqBuilder) MsgId(msgId string) *TicketImageTick return builder } -// index，当消息类型为post时，需指定图片index，index从0开始。当消息类型为img时，无需index +// index，当消息类型为 post 时，需指定图片 index，index 从 0 开始。当消息类型为 img 时，无需 index // // 示例值：0 func (builder *TicketImageTicketReqBuilder) Index(index int) *TicketImageTicketReqBuilder { @@ -7371,7 +7371,7 @@ func (resp *TicketImageTicketResp) WriteFile(fileName string) error { } type UpdateTicketReqBodyBuilder struct { - status int // new status, 1: 已创建, 2: 处理中, 3: 排队中, 5: 待定, 50: 机器人关闭工单, 51: 关闭工单 + status int // new status, 1: 已创建，2: 处理中，3: 排队中，5: 待定，50: 机器人关闭工单，51: 关闭工单 statusFlag bool tagNames []string // 新标签名 tagNamesFlag bool @@ -7381,9 +7381,9 @@ type UpdateTicketReqBodyBuilder struct { customizedFieldsFlag bool ticketType int // ticket stage ticketTypeFlag bool - solved int // 工单是否解决，1: 未解决, 2: 已解决 + solved int // 工单是否解决，1: 未解决，2: 已解决 solvedFlag bool - channel int // 工单来源渠道ID + channel int // 工单来源渠道 ID channelFlag bool } @@ -7392,7 +7392,7 @@ func NewUpdateTicketReqBodyBuilder() *UpdateTicketReqBodyBuilder { return builder } -// new status, 1: 已创建, 2: 处理中, 3: 排队中, 5: 待定, 50: 机器人关闭工单, 51: 关闭工单 +// new status, 1: 已创建，2: 处理中，3: 排队中，5: 待定，50: 机器人关闭工单，51: 关闭工单 // //示例值：1 func (builder *UpdateTicketReqBodyBuilder) Status(status int) *UpdateTicketReqBodyBuilder { @@ -7437,7 +7437,7 @@ func (builder *UpdateTicketReqBodyBuilder) TicketType(ticketType int) *UpdateTic return builder } -// 工单是否解决，1: 未解决, 2: 已解决 +// 工单是否解决，1: 未解决，2: 已解决 // //示例值：1 func (builder *UpdateTicketReqBodyBuilder) Solved(solved int) *UpdateTicketReqBodyBuilder { @@ -7446,7 +7446,7 @@ func (builder *UpdateTicketReqBodyBuilder) Solved(solved int) *UpdateTicketReqBo return builder } -// 工单来源渠道ID +// 工单来源渠道 ID // //示例值：1 func (builder *UpdateTicketReqBodyBuilder) Channel(channel int) *UpdateTicketReqBodyBuilder { @@ -7482,7 +7482,7 @@ func (builder *UpdateTicketReqBodyBuilder) Build() *UpdateTicketReqBody { } type UpdateTicketPathReqBodyBuilder struct { - status int // new status, 1: 已创建, 2: 处理中, 3: 排队中, 5: 待定, 50: 机器人关闭工单, 51: 关闭工单 + status int // new status, 1: 已创建，2: 处理中，3: 排队中，5: 待定，50: 机器人关闭工单，51: 关闭工单 statusFlag bool tagNames []string // 新标签名 tagNamesFlag bool @@ -7492,9 +7492,9 @@ type UpdateTicketPathReqBodyBuilder struct { customizedFieldsFlag bool ticketType int // ticket stage ticketTypeFlag bool - solved int // 工单是否解决，1: 未解决, 2: 已解决 + solved int // 工单是否解决，1: 未解决，2: 已解决 solvedFlag bool - channel int // 工单来源渠道ID + channel int // 工单来源渠道 ID channelFlag bool } @@ -7503,7 +7503,7 @@ func NewUpdateTicketPathReqBodyBuilder() *UpdateTicketPathReqBodyBuilder { return builder } -// new status, 1: 已创建, 2: 处理中, 3: 排队中, 5: 待定, 50: 机器人关闭工单, 51: 关闭工单 +// new status, 1: 已创建，2: 处理中，3: 排队中，5: 待定，50: 机器人关闭工单，51: 关闭工单 // // 示例值：1 func (builder *UpdateTicketPathReqBodyBuilder) Status(status int) *UpdateTicketPathReqBodyBuilder { @@ -7548,7 +7548,7 @@ func (builder *UpdateTicketPathReqBodyBuilder) TicketType(ticketType int) *Updat return builder } -// 工单是否解决，1: 未解决, 2: 已解决 +// 工单是否解决，1: 未解决，2: 已解决 // // 示例值：1 func (builder *UpdateTicketPathReqBodyBuilder) Solved(solved int) *UpdateTicketPathReqBodyBuilder { @@ -7557,7 +7557,7 @@ func (builder *UpdateTicketPathReqBodyBuilder) Solved(solved int) *UpdateTicketP return builder } -// 工单来源渠道ID +// 工单来源渠道 ID // // 示例值：1 func (builder *UpdateTicketPathReqBodyBuilder) Channel(channel int) *UpdateTicketPathReqBodyBuilder { @@ -7606,7 +7606,7 @@ func NewUpdateTicketReqBuilder() *UpdateTicketReqBuilder { return builder } -// 工单ID +// 工单 ID // // 示例值：6945345902185807891 func (builder *UpdateTicketReqBuilder) TicketId(ticketId string) *UpdateTicketReqBuilder { @@ -7629,13 +7629,13 @@ func (builder *UpdateTicketReqBuilder) Build() *UpdateTicketReq { } type UpdateTicketReqBody struct { - Status *int `json:"status,omitempty"` // new status, 1: 已创建, 2: 处理中, 3: 排队中, 5: 待定, 50: 机器人关闭工单, 51: 关闭工单 + Status *int `json:"status,omitempty"` // new status, 1: 已创建，2: 处理中，3: 排队中，5: 待定，50: 机器人关闭工单，51: 关闭工单 TagNames []string `json:"tag_names,omitempty"` // 新标签名 Comment *string `json:"comment,omitempty"` // 新评论 CustomizedFields []*CustomizedFieldDisplayItem `json:"customized_fields,omitempty"` // 自定义字段 TicketType *int `json:"ticket_type,omitempty"` // ticket stage - Solved *int `json:"solved,omitempty"` // 工单是否解决，1: 未解决, 2: 已解决 - Channel *int `json:"channel,omitempty"` // 工单来源渠道ID + Solved *int `json:"solved,omitempty"` // 工单是否解决，1: 未解决，2: 已解决 + Channel *int `json:"channel,omitempty"` // 工单来源渠道 ID } type UpdateTicketReq struct { @@ -7655,7 +7655,7 @@ func (resp *UpdateTicketResp) Success() bool { type CreateTicketMessageReqBodyBuilder struct { msgType string // 消息类型；text：纯文本；post：富文本 msgTypeFlag bool - content string // - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；;- 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content + content string // - 纯文本，参考 [发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM) 中的 content；;- 富文本，参考 [发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM) 中的 content contentFlag bool } @@ -7673,7 +7673,7 @@ func (builder *CreateTicketMessageReqBodyBuilder) MsgType(msgType string) *Creat return builder } -// - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；;- 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content +// - 纯文本，参考 [发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM) 中的 content；;- 富文本，参考 [发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM) 中的 content // //示例值：{; "msg_type": "post",; "content": {; "post": {; "zh_cn": {; "title": "this is title",; "content": [; [; {; "tag": "text",; "un_escape": true,; "text": "第一行 :"; },; {; "tag": "a",; "text": "超链接",; "href": "http://www.feishu.cn"; }; ],; [; {; "tag": "text",; "text": "第二行 :"; },; {; "tag": "text",; "text": "文本测试"; }; ]; ]; }; }; };} func (builder *CreateTicketMessageReqBodyBuilder) Content(content string) *CreateTicketMessageReqBodyBuilder { @@ -7696,7 +7696,7 @@ func (builder *CreateTicketMessageReqBodyBuilder) Build() *CreateTicketMessageRe type CreateTicketMessagePathReqBodyBuilder struct { msgType string // 消息类型；text：纯文本；post：富文本 msgTypeFlag bool - content string // - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；;- 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content + content string // - 纯文本，参考 [发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM) 中的 content；;- 富文本，参考 [发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM) 中的 content contentFlag bool } @@ -7714,7 +7714,7 @@ func (builder *CreateTicketMessagePathReqBodyBuilder) MsgType(msgType string) *C return builder } -// - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；;- 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content +// - 纯文本，参考 [发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM) 中的 content；;- 富文本，参考 [发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM) 中的 content // // 示例值：{; "msg_type": "post",; "content": {; "post": {; "zh_cn": {; "title": "this is title",; "content": [; [; {; "tag": "text",; "un_escape": true,; "text": "第一行 :"; },; {; "tag": "a",; "text": "超链接",; "href": "http://www.feishu.cn"; }; ],; [; {; "tag": "text",; "text": "第二行 :"; },; {; "tag": "text",; "text": "文本测试"; }; ]; ]; }; }; };} func (builder *CreateTicketMessagePathReqBodyBuilder) Content(content string) *CreateTicketMessagePathReqBodyBuilder { @@ -7748,7 +7748,7 @@ func NewCreateTicketMessageReqBuilder() *CreateTicketMessageReqBuilder { return builder } -// 工单ID +// 工单 ID // // 示例值：6948728206392295444 func (builder *CreateTicketMessageReqBuilder) TicketId(ticketId string) *CreateTicketMessageReqBuilder { @@ -7772,7 +7772,7 @@ func (builder *CreateTicketMessageReqBuilder) Build() *CreateTicketMessageReq { type CreateTicketMessageReqBody struct { MsgType *string `json:"msg_type,omitempty"` // 消息类型；text：纯文本；post：富文本 - Content *string `json:"content,omitempty"` // - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content；;- 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content + Content *string `json:"content,omitempty"` // - 纯文本，参考 [发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM) 中的 content；;- 富文本，参考 [发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM) 中的 content } type CreateTicketMessageReq struct { @@ -7781,7 +7781,7 @@ type CreateTicketMessageReq struct { } type CreateTicketMessageRespData struct { - MessageId *string `json:"message_id,omitempty"` // chat消息open ID + MessageId *string `json:"message_id,omitempty"` // chat 消息 open ID } type CreateTicketMessageResp struct { @@ -7807,7 +7807,7 @@ func NewListTicketMessageReqBuilder() *ListTicketMessageReqBuilder { return builder } -// 工单ID +// 工单 ID // // 示例值：6948728206392295444 func (builder *ListTicketMessageReqBuilder) TicketId(ticketId string) *ListTicketMessageReqBuilder { @@ -7831,7 +7831,7 @@ func (builder *ListTicketMessageReqBuilder) TimeEnd(timeEnd int) *ListTicketMess return builder } -// 页数ID +// 页数 ID // // 示例值：1 func (builder *ListTicketMessageReqBuilder) Page(page int) *ListTicketMessageReqBuilder { @@ -7839,7 +7839,7 @@ func (builder *ListTicketMessageReqBuilder) Page(page int) *ListTicketMessageReq return builder } -// 消息数量，最大200，默认20 +// 消息数量，最大 200，默认 20 // // 示例值：10 func (builder *ListTicketMessageReqBuilder) PageSize(pageSize int) *ListTicketMessageReqBuilder { @@ -7928,7 +7928,7 @@ func NewDeleteTicketCustomizedFieldReqBuilder() *DeleteTicketCustomizedFieldReqB return builder } -// 工单自定义字段ID +// 工单自定义字段 ID // // 示例值：6948728206392295444 func (builder *DeleteTicketCustomizedFieldReqBuilder) TicketCustomizedFieldId(ticketCustomizedFieldId string) *DeleteTicketCustomizedFieldReqBuilder { @@ -7969,7 +7969,7 @@ func NewGetTicketCustomizedFieldReqBuilder() *GetTicketCustomizedFieldReqBuilder return builder } -// 工单自定义字段ID +// 工单自定义字段 ID // // 示例值：6948728206392295444 func (builder *GetTicketCustomizedFieldReqBuilder) TicketCustomizedFieldId(ticketCustomizedFieldId string) *GetTicketCustomizedFieldReqBuilder { @@ -8094,7 +8094,7 @@ func (builder *ListTicketCustomizedFieldReqBuilder) PageToken(pageToken string) // // -// 示例值：10；默认为20 +// 示例值：10；默认为 20 func (builder *ListTicketCustomizedFieldReqBuilder) PageSize(pageSize int) *ListTicketCustomizedFieldReqBuilder { builder.apiReq.QueryParams.Set("page_size", fmt.Sprint(pageSize)) return builder @@ -8153,7 +8153,7 @@ func NewPatchTicketCustomizedFieldReqBuilder() *PatchTicketCustomizedFieldReqBui return builder } -// 工单自定义字段ID +// 工单自定义字段 ID // // 示例值：6948728206392295444 func (builder *PatchTicketCustomizedFieldReqBuilder) TicketCustomizedFieldId(ticketCustomizedFieldId string) *PatchTicketCustomizedFieldReqBuilder { @@ -8190,8 +8190,8 @@ func (resp *PatchTicketCustomizedFieldResp) Success() bool { } type P2NotificationApproveV1Data struct { - NotificationId *string `json:"notification_id,omitempty"` // 推送任务唯一ID - HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台唯一ID + NotificationId *string `json:"notification_id,omitempty"` // 推送任务唯一 ID + HelpdeskId *string `json:"helpdesk_id,omitempty"` // 服务台唯一 ID ApproveStatus *string `json:"approve_status,omitempty"` // REJECTED(审核不通过);APPROVED(审核通过);CANCELED(取消审核);DELETED(删除审核) } @@ -8288,7 +8288,7 @@ func (iterator *ListFaqIterator) Next() (bool, *Faq, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -8342,7 +8342,7 @@ func (iterator *SearchFaqIterator) Next() (bool, *Faq, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/hire/v1/api.go b/service/hire/v1/api.go index c3ec9d77..9e15f2ff 100644 --- a/service/hire/v1/api.go +++ b/service/hire/v1/api.go @@ -99,9 +99,9 @@ type talent struct { // // - 根据人才 ID 和职位 ID 创建投递 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/create_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/create_application.go func (a *application) Create(ctx context.Context, req *CreateApplicationReq, options ...larkcore.RequestOptionFunc) (*CreateApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -125,9 +125,9 @@ func (a *application) Create(ctx context.Context, req *CreateApplicationReq, opt // // - 根据投递 ID 获取单个投递信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_application.go func (a *application) Get(ctx context.Context, req *GetApplicationReq, options ...larkcore.RequestOptionFunc) (*GetApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -151,9 +151,9 @@ func (a *application) Get(ctx context.Context, req *GetApplicationReq, options . // // - 根据限定条件获取投递列表信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_application.go func (a *application) List(ctx context.Context, req *ListApplicationReq, options ...larkcore.RequestOptionFunc) (*ListApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -177,9 +177,9 @@ func (a *application) List(ctx context.Context, req *ListApplicationReq, options // // - 根据投递 ID 获取 Offer 信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/offer +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/offer // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/offer_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/offer_application.go func (a *application) Offer(ctx context.Context, req *OfferApplicationReq, options ...larkcore.RequestOptionFunc) (*OfferApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -203,9 +203,9 @@ func (a *application) Offer(ctx context.Context, req *OfferApplicationReq, optio // // - 根据投递 ID 修改投递状态为「已终止」 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/terminate +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/terminate // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/terminate_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/terminate_application.go func (a *application) Terminate(ctx context.Context, req *TerminateApplicationReq, options ...larkcore.RequestOptionFunc) (*TerminateApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -229,9 +229,9 @@ func (a *application) Terminate(ctx context.Context, req *TerminateApplicationRe // // - 根据投递 ID 操作候选人入职并创建员工。投递须处于「待入职」阶段，可通过「转移阶段」接口变更投递状态 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/transfer_onboard +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/transfer_onboard // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/transferOnboard_application.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/transferOnboard_application.go func (a *application) TransferOnboard(ctx context.Context, req *TransferOnboardApplicationReq, options ...larkcore.RequestOptionFunc) (*TransferOnboardApplicationResp, error) { // 发起请求 apiReq := req.apiReq @@ -255,9 +255,9 @@ func (a *application) TransferOnboard(ctx context.Context, req *TransferOnboardA // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=hire&resource=application.interview&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=hire&resource=application.interview&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_applicationInterview.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_applicationInterview.go func (a *applicationInterview) List(ctx context.Context, req *ListApplicationInterviewReq, options ...larkcore.RequestOptionFunc) (*ListApplicationInterviewResp, error) { // 发起请求 apiReq := req.apiReq @@ -279,11 +279,11 @@ func (a *applicationInterview) List(ctx context.Context, req *ListApplicationInt // 获取附件信息 // -// - 获取招聘系统中附件的元信息，比如文件名、创建时间、文件url等 +// - 获取招聘系统中附件的元信息，比如文件名、创建时间、文件 url 等 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_attachment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_attachment.go func (a *attachment) Get(ctx context.Context, req *GetAttachmentReq, options ...larkcore.RequestOptionFunc) (*GetAttachmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -307,9 +307,9 @@ func (a *attachment) Get(ctx context.Context, req *GetAttachmentReq, options ... // // - 根据附件 ID 获取附件预览信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/preview +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/preview // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/preview_attachment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/preview_attachment.go func (a *attachment) Preview(ctx context.Context, req *PreviewAttachmentReq, options ...larkcore.RequestOptionFunc) (*PreviewAttachmentResp, error) { // 发起请求 apiReq := req.apiReq @@ -333,9 +333,9 @@ func (a *attachment) Preview(ctx context.Context, req *PreviewAttachmentReq, opt // // - 在处理完导入 e-HR 事件后，可调用该接口，更新 e-HR 导入任务结果 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/ehr_import_task/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/ehr_import_task/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/patch_ehrImportTask.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/patch_ehrImportTask.go func (e *ehrImportTask) Patch(ctx context.Context, req *PatchEhrImportTaskReq, options ...larkcore.RequestOptionFunc) (*PatchEhrImportTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -359,9 +359,9 @@ func (e *ehrImportTask) Patch(ctx context.Context, req *PatchEhrImportTaskReq, o // // - 通过员工 ID 获取入职信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_employee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_employee.go func (e *employee) Get(ctx context.Context, req *GetEmployeeReq, options ...larkcore.RequestOptionFunc) (*GetEmployeeResp, error) { // 发起请求 apiReq := req.apiReq @@ -385,9 +385,9 @@ func (e *employee) Get(ctx context.Context, req *GetEmployeeReq, options ...lark // // - 通过投递 ID 获取入职信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get_by_application +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get_by_application // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/getByApplication_employee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/getByApplication_employee.go func (e *employee) GetByApplication(ctx context.Context, req *GetByApplicationEmployeeReq, options ...larkcore.RequestOptionFunc) (*GetByApplicationEmployeeResp, error) { // 发起请求 apiReq := req.apiReq @@ -411,9 +411,9 @@ func (e *employee) GetByApplication(ctx context.Context, req *GetByApplicationEm // // - 根据员工 ID 更新员工转正、离职状态 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/patch_employee.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/patch_employee.go func (e *employee) Patch(ctx context.Context, req *PatchEmployeeReq, options ...larkcore.RequestOptionFunc) (*PatchEmployeeResp, error) { // 发起请求 apiReq := req.apiReq @@ -437,9 +437,9 @@ func (e *employee) Patch(ctx context.Context, req *PatchEmployeeReq, options ... // // - 新建职位，字段的是否必填，以系统中的「职位字段管理」中的设置为准。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/combinedCreate_job.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/combinedCreate_job.go func (j *job) CombinedCreate(ctx context.Context, req *CombinedCreateJobReq, options ...larkcore.RequestOptionFunc) (*CombinedCreateJobResp, error) { // 发起请求 apiReq := req.apiReq @@ -463,9 +463,9 @@ func (j *job) CombinedCreate(ctx context.Context, req *CombinedCreateJobReq, opt // // - 更新职位信息，该接口为全量更新，若字段没有返回值，则原有值将会被清空。字段的是否必填，将以系统中的「职位字段管理」中的设置为准。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_update +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/combinedUpdate_job.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/combinedUpdate_job.go func (j *job) CombinedUpdate(ctx context.Context, req *CombinedUpdateJobReq, options ...larkcore.RequestOptionFunc) (*CombinedUpdateJobResp, error) { // 发起请求 apiReq := req.apiReq @@ -489,9 +489,9 @@ func (j *job) CombinedUpdate(ctx context.Context, req *CombinedUpdateJobReq, opt // // - 获取职位设置 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/config +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/config // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/config_job.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/config_job.go func (j *job) Config(ctx context.Context, req *ConfigJobReq, options ...larkcore.RequestOptionFunc) (*ConfigJobResp, error) { // 发起请求 apiReq := req.apiReq @@ -515,9 +515,9 @@ func (j *job) Config(ctx context.Context, req *ConfigJobReq, options ...larkcore // // - 根据职位 ID 获取职位信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_job.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_job.go func (j *job) Get(ctx context.Context, req *GetJobReq, options ...larkcore.RequestOptionFunc) (*GetJobResp, error) { // 发起请求 apiReq := req.apiReq @@ -541,9 +541,9 @@ func (j *job) Get(ctx context.Context, req *GetJobReq, options ...larkcore.Reque // // - 更新职位设置，包括面试评价表、Offer 申请表等。接口将按照所选择的「更新选项」进行设置参数校验和更新。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/update_config +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/update_config // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/updateConfig_job.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/updateConfig_job.go func (j *job) UpdateConfig(ctx context.Context, req *UpdateConfigJobReq, options ...larkcore.RequestOptionFunc) (*UpdateConfigJobResp, error) { // 发起请求 apiReq := req.apiReq @@ -567,9 +567,9 @@ func (j *job) UpdateConfig(ctx context.Context, req *UpdateConfigJobReq, options // // - 根据职位 ID 获取职位上的招聘人员信息，如招聘负责人、用人经理 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job-manager/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job-manager/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_jobManager.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_jobManager.go func (j *jobManager) Get(ctx context.Context, req *GetJobManagerReq, options ...larkcore.RequestOptionFunc) (*GetJobManagerResp, error) { // 发起请求 apiReq := req.apiReq @@ -593,9 +593,9 @@ func (j *jobManager) Get(ctx context.Context, req *GetJobManagerReq, options ... // // - 获取全部招聘流程信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_process/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_process/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_jobProcess.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_jobProcess.go func (j *jobProcess) List(ctx context.Context, req *ListJobProcessReq, options ...larkcore.RequestOptionFunc) (*ListJobProcessResp, error) { // 发起请求 apiReq := req.apiReq @@ -619,9 +619,9 @@ func (j *jobProcess) List(ctx context.Context, req *ListJobProcessReq, options . // // - 创建备注信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/create_note.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/create_note.go func (n *note) Create(ctx context.Context, req *CreateNoteReq, options ...larkcore.RequestOptionFunc) (*CreateNoteResp, error) { // 发起请求 apiReq := req.apiReq @@ -645,9 +645,9 @@ func (n *note) Create(ctx context.Context, req *CreateNoteReq, options ...larkco // // - 根据备注 ID 获取备注信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_note.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_note.go func (n *note) Get(ctx context.Context, req *GetNoteReq, options ...larkcore.RequestOptionFunc) (*GetNoteResp, error) { // 发起请求 apiReq := req.apiReq @@ -671,9 +671,9 @@ func (n *note) Get(ctx context.Context, req *GetNoteReq, options ...larkcore.Req // // - 获取备注列表 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_note.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_note.go func (n *note) List(ctx context.Context, req *ListNoteReq, options ...larkcore.RequestOptionFunc) (*ListNoteResp, error) { // 发起请求 apiReq := req.apiReq @@ -697,9 +697,9 @@ func (n *note) List(ctx context.Context, req *ListNoteReq, options ...larkcore.R // // - 根据备注 ID 更新备注信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/note/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/patch_note.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/patch_note.go func (n *note) Patch(ctx context.Context, req *PatchNoteReq, options ...larkcore.RequestOptionFunc) (*PatchNoteResp, error) { // 发起请求 apiReq := req.apiReq @@ -723,9 +723,9 @@ func (n *note) Patch(ctx context.Context, req *PatchNoteReq, options ...larkcore // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=hire&resource=offer_schema&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=hire&resource=offer_schema&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_offerSchema.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_offerSchema.go func (o *offerSchema) Get(ctx context.Context, req *GetOfferSchemaReq, options ...larkcore.RequestOptionFunc) (*GetOfferSchemaResp, error) { // 发起请求 apiReq := req.apiReq @@ -749,9 +749,9 @@ func (o *offerSchema) Get(ctx context.Context, req *GetOfferSchemaReq, options . // // - 根据投递 ID 获取内推信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/get_by_application +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/get_by_application // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/getByApplication_referral.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/getByApplication_referral.go func (r *referral) GetByApplication(ctx context.Context, req *GetByApplicationReferralReq, options ...larkcore.RequestOptionFunc) (*GetByApplicationReferralResp, error) { // 发起请求 apiReq := req.apiReq @@ -775,9 +775,9 @@ func (r *referral) GetByApplication(ctx context.Context, req *GetByApplicationRe // // - 获取简历来源列表 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/resume_source/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/resume_source/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_resumeSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/list_resumeSource.go func (r *resumeSource) List(ctx context.Context, req *ListResumeSourceReq, options ...larkcore.RequestOptionFunc) (*ListResumeSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -809,9 +809,9 @@ func (r *resumeSource) ListByIterator(ctx context.Context, req *ListResumeSource // // - 通过人才信息获取人才 ID // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/batchGetId_talent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/batchGetId_talent.go func (t *talent) BatchGetId(ctx context.Context, req *BatchGetIdTalentReq, options ...larkcore.RequestOptionFunc) (*BatchGetIdTalentResp, error) { // 发起请求 apiReq := req.apiReq @@ -835,9 +835,9 @@ func (t *talent) BatchGetId(ctx context.Context, req *BatchGetIdTalentReq, optio // // - 根据人才 ID 获取人才信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_talent.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/hirev1/get_talent.go func (t *talent) Get(ctx context.Context, req *GetTalentReq, options ...larkcore.RequestOptionFunc) (*GetTalentResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/hire/v1/event.go b/service/hire/v1/event.go index 86d17480..c3bccd62 100644 --- a/service/hire/v1/event.go +++ b/service/hire/v1/event.go @@ -32,7 +32,7 @@ func (h *P2ApplicationStageChangedV1Handler) Event() interface{} { return &P2ApplicationStageChangedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ApplicationStageChangedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ApplicationStageChangedV1)) } diff --git a/service/hire/v1/model.go b/service/hire/v1/model.go index 207ecf4d..4797bca8 100644 --- a/service/hire/v1/model.go +++ b/service/hire/v1/model.go @@ -55,10 +55,10 @@ const ( ) const ( - UserIdTypeListApplicationInterviewUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListApplicationInterviewUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListApplicationInterviewOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeListApplicationInterviewPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeListApplicationInterviewUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListApplicationInterviewUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListApplicationInterviewOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeListApplicationInterviewPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( @@ -119,12 +119,12 @@ const ( const ( ExperienceNoLimit = 1 // 不限 ExperienceGraduate = 2 // 应届毕业生 - ExperienceUnderOneYear = 3 // 1年以下 - ExperienceOneToThreeYear = 4 // 1-3年 - ExperienceThreeToFiveYear = 5 // 3-5年 - ExperienceFiveToSevenYear = 6 // 5-7年 - ExperienceSevenToTenYear = 7 // 7-10年 - ExperienceOverTenYear = 8 // 10年以上 + ExperienceUnderOneYear = 3 // 1 年以下 + ExperienceOneToThreeYear = 4 // 1-3 年 + ExperienceThreeToFiveYear = 5 // 3-5 年 + ExperienceFiveToSevenYear = 6 // 5-7 年 + ExperienceSevenToTenYear = 7 // 7-10 年 + ExperienceOverTenYear = 8 // 10 年以上 ) @@ -167,12 +167,12 @@ const ( const ( ExperienceCombinedUpdateJobNoLimit = 1 // 不限 ExperienceCombinedUpdateJobGraduate = 2 // 应届毕业生 - ExperienceCombinedUpdateJobUnderOneYear = 3 // 1年以下 - ExperienceCombinedUpdateJobOneToThreeYear = 4 // 1-3年 - ExperienceCombinedUpdateJobThreeToFiveYear = 5 // 3-5年 - ExperienceCombinedUpdateJobFiveToSevenYear = 6 // 5-7年 - ExperienceCombinedUpdateJobSevenToTenYear = 7 // 7-10年 - ExperienceCombinedUpdateJobOverTenYear = 8 // 10年以上 + ExperienceCombinedUpdateJobUnderOneYear = 3 // 1 年以下 + ExperienceCombinedUpdateJobOneToThreeYear = 4 // 1-3 年 + ExperienceCombinedUpdateJobThreeToFiveYear = 5 // 3-5 年 + ExperienceCombinedUpdateJobFiveToSevenYear = 6 // 5-7 年 + ExperienceCombinedUpdateJobSevenToTenYear = 7 // 7-10 年 + ExperienceCombinedUpdateJobOverTenYear = 8 // 10 年以上 ) @@ -207,17 +207,17 @@ const ( ) const ( - UserIdTypeConfigJobUserId = "user_id" // 以user_id来识别用户 - UserIdTypeConfigJobUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeConfigJobOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeConfigJobPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeConfigJobUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeConfigJobUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeConfigJobOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeConfigJobPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( - UserIdTypeGetJobUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetJobUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetJobOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeGetJobPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeGetJobUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetJobUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetJobOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeGetJobPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( @@ -226,16 +226,16 @@ const ( ) const ( - UserIdTypeUpdateConfigJobUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateConfigJobUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateConfigJobOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateConfigJobUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateConfigJobUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateConfigJobOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetJobManagerUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetJobManagerUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetJobManagerOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeGetJobManagerPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeGetJobManagerUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetJobManagerUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetJobManagerOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeGetJobManagerPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( @@ -245,38 +245,38 @@ const ( ) const ( - UserIdTypeCreateNoteUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateNoteUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateNoteOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeCreateNotePeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeCreateNoteUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateNoteUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateNoteOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeCreateNotePeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( - UserIdTypeGetNoteUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetNoteUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetNoteOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeGetNotePeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeGetNoteUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetNoteUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetNoteOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeGetNotePeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( - UserIdTypeListNoteUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListNoteUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListNoteOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeListNotePeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeListNoteUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListNoteUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListNoteOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeListNotePeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( - UserIdTypePatchNoteUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchNoteUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchNoteOpenId = "open_id" // 以open_id来识别用户 - UserIdTypePatchNotePeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypePatchNoteUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchNoteUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchNoteOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypePatchNotePeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( - UserIdTypeGetByApplicationReferralUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetByApplicationReferralUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetByApplicationReferralOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeGetByApplicationReferralPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeGetByApplicationReferralUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetByApplicationReferralUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetByApplicationReferralOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeGetByApplicationReferralPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( @@ -287,17 +287,17 @@ const ( ) type Agency struct { - Id *string `json:"id,omitempty"` // 猎头供应商ID + Id *string `json:"id,omitempty"` // 猎头供应商 ID Name *string `json:"name,omitempty"` // 猎头供应商名称 - ContactorId *string `json:"contactor_id,omitempty"` // 供应商联系人ID + ContactorId *string `json:"contactor_id,omitempty"` // 供应商联系人 ID } type AgencyBuilder struct { - id string // 猎头供应商ID + id string // 猎头供应商 ID idFlag bool name string // 猎头供应商名称 nameFlag bool - contactorId string // 供应商联系人ID + contactorId string // 供应商联系人 ID contactorIdFlag bool } @@ -306,7 +306,7 @@ func NewAgencyBuilder() *AgencyBuilder { return builder } -// 猎头供应商ID +// 猎头供应商 ID // // 示例值：6898173495386147079 func (builder *AgencyBuilder) Id(id string) *AgencyBuilder { @@ -324,7 +324,7 @@ func (builder *AgencyBuilder) Name(name string) *AgencyBuilder { return builder } -// 供应商联系人ID +// 供应商联系人 ID // // 示例值：ou_f476cb099ac9227c9bae09ce46112579 func (builder *AgencyBuilder) ContactorId(contactorId string) *AgencyBuilder { @@ -501,7 +501,7 @@ type AppliOfferBasicInfoUser struct { Timezone *string `json:"timezone,omitempty"` // 时区 Phone *string `json:"phone,omitempty"` // 手机 Email *string `json:"email,omitempty"` // 邮箱 - InAppScope *bool `json:"in_app_scope,omitempty"` // 是否拥有app权限 + InAppScope *bool `json:"in_app_scope,omitempty"` // 是否拥有 app 权限 } type AppliOfferBasicInfoUserBuilder struct { @@ -521,7 +521,7 @@ type AppliOfferBasicInfoUserBuilder struct { phoneFlag bool email string // 邮箱 emailFlag bool - inAppScope bool // 是否拥有app权限 + inAppScope bool // 是否拥有 app 权限 inAppScopeFlag bool } @@ -602,7 +602,7 @@ func (builder *AppliOfferBasicInfoUserBuilder) Email(email string) *AppliOfferBa return builder } -// 是否拥有app权限 +// 是否拥有 app 权限 // // 示例值： func (builder *AppliOfferBasicInfoUserBuilder) InAppScope(inAppScope bool) *AppliOfferBasicInfoUserBuilder { @@ -657,10 +657,10 @@ type AppliOfferOnboardProfile struct { RecruitmentType *RecruitmentType `json:"recruitment_type,omitempty"` // 招聘类型 Sequence *Sequence `json:"sequence,omitempty"` // 序列 Level *Level `json:"level,omitempty"` // 职级 - OnboardAddress *AppliOfferOnboardProfileAdd `json:"onboard_address,omitempty"` // onboard地址 + OnboardAddress *AppliOfferOnboardProfileAdd `json:"onboard_address,omitempty"` // onboard 地址 WorkAddress *AppliOfferOnboardProfileAdd `json:"work_address,omitempty"` // 工作地址 Leader *AppliOfferBasicInfoUser `json:"leader,omitempty"` // 领导 - IsWorkAddressSameToOnboard *bool `json:"is_work_address_same_to_onboard,omitempty"` // 工作地址是否与onboard地址相同 + IsWorkAddressSameToOnboard *bool `json:"is_work_address_same_to_onboard,omitempty"` // 工作地址是否与 onboard 地址相同 ProbationMonth *int `json:"probation_month,omitempty"` // 试用期 ContractYear *int `json:"contract_year,omitempty"` // 合同年限 } @@ -676,13 +676,13 @@ type AppliOfferOnboardProfileBuilder struct { sequenceFlag bool level *Level // 职级 levelFlag bool - onboardAddress *AppliOfferOnboardProfileAdd // onboard地址 + onboardAddress *AppliOfferOnboardProfileAdd // onboard 地址 onboardAddressFlag bool workAddress *AppliOfferOnboardProfileAdd // 工作地址 workAddressFlag bool leader *AppliOfferBasicInfoUser // 领导 leaderFlag bool - isWorkAddressSameToOnboard bool // 工作地址是否与onboard地址相同 + isWorkAddressSameToOnboard bool // 工作地址是否与 onboard 地址相同 isWorkAddressSameToOnboardFlag bool probationMonth int // 试用期 probationMonthFlag bool @@ -740,7 +740,7 @@ func (builder *AppliOfferOnboardProfileBuilder) Level(level *Level) *AppliOfferO return builder } -// onboard地址 +// onboard 地址 // // 示例值： func (builder *AppliOfferOnboardProfileBuilder) OnboardAddress(onboardAddress *AppliOfferOnboardProfileAdd) *AppliOfferOnboardProfileBuilder { @@ -767,7 +767,7 @@ func (builder *AppliOfferOnboardProfileBuilder) Leader(leader *AppliOfferBasicIn return builder } -// 工作地址是否与onboard地址相同 +// 工作地址是否与 onboard 地址相同 // // 示例值： func (builder *AppliOfferOnboardProfileBuilder) IsWorkAddressSameToOnboard(isWorkAddressSameToOnboard bool) *AppliOfferOnboardProfileBuilder { @@ -844,7 +844,7 @@ type AppliOfferOnboardProfileAdd struct { City *AppliOfferOnboardProfileCity `json:"city,omitempty"` // 城市 State *AppliOfferOnboardProfileCity `json:"state,omitempty"` // 省 Country *AppliOfferOnboardProfileCity `json:"country,omitempty"` // 国家 - UsageIdList []string `json:"usage_id_list,omitempty"` // 使用ID列表 + UsageIdList []string `json:"usage_id_list,omitempty"` // 使用 ID 列表 ActiveStatus *int `json:"active_status,omitempty"` // 状态 } @@ -863,7 +863,7 @@ type AppliOfferOnboardProfileAddBuilder struct { stateFlag bool country *AppliOfferOnboardProfileCity // 国家 countryFlag bool - usageIdList []string // 使用ID列表 + usageIdList []string // 使用 ID 列表 usageIdListFlag bool activeStatus int // 状态 activeStatusFlag bool @@ -937,7 +937,7 @@ func (builder *AppliOfferOnboardProfileAddBuilder) Country(country *AppliOfferOn return builder } -// 使用ID列表 +// 使用 ID 列表 // // 示例值： func (builder *AppliOfferOnboardProfileAddBuilder) UsageIdList(usageIdList []string) *AppliOfferOnboardProfileAddBuilder { @@ -1072,14 +1072,14 @@ func (builder *AppliOfferOnboardProfileCityBuilder) Build() *AppliOfferOnboardPr } type AppliOfferSalaryPlanTemplate struct { - TemplateKey *string `json:"template_key,omitempty"` // 模版key + TemplateKey *string `json:"template_key,omitempty"` // 模版 key TotalAmount *string `json:"total_amount,omitempty"` // 总金额 Currency *string `json:"currency,omitempty"` // 币种 SalaryContent *string `json:"salary_content,omitempty"` // 薪酬内容 } type AppliOfferSalaryPlanTemplateBuilder struct { - templateKey string // 模版key + templateKey string // 模版 key templateKeyFlag bool totalAmount string // 总金额 totalAmountFlag bool @@ -1094,7 +1094,7 @@ func NewAppliOfferSalaryPlanTemplateBuilder() *AppliOfferSalaryPlanTemplateBuild return builder } -// 模版key +// 模版 key // // 示例值： func (builder *AppliOfferSalaryPlanTemplateBuilder) TemplateKey(templateKey string) *AppliOfferSalaryPlanTemplateBuilder { @@ -1487,7 +1487,7 @@ func (builder *AppliTalentEducationInfoBuilder) Build() *AppliTalentEducationInf } type Application struct { - Id *string `json:"id,omitempty"` // 投递id + Id *string `json:"id,omitempty"` // 投递 id JobId *string `json:"job_id,omitempty"` // 投递的职位 ID TalentId *string `json:"talent_id,omitempty"` // 候选人 ID ResumeResourceId *string `json:"resume_resource_id,omitempty"` // 简历来源 ID @@ -1501,13 +1501,13 @@ type Application struct { ModifyTime *string `json:"modify_time,omitempty"` // 修改时间 StageTimeList []*ApplicationStageTime `json:"stage_time_list,omitempty"` // 阶段变更时间列表 TerminationType *int `json:"termination_type,omitempty"` // 终止原因的类型 - TerminationReasonList []string `json:"termination_reason_list,omitempty"` // 终止的具体原因的id列表 + TerminationReasonList []string `json:"termination_reason_list,omitempty"` // 终止的具体原因的 id 列表 TerminationReasonNote *string `json:"termination_reason_note,omitempty"` // 终止备注 ApplicationPreferredCityList []*CodeNameObject `json:"application_preferred_city_list,omitempty"` // 意向投递城市列表 } type ApplicationBuilder struct { - id string // 投递id + id string // 投递 id idFlag bool jobId string // 投递的职位 ID jobIdFlag bool @@ -1535,7 +1535,7 @@ type ApplicationBuilder struct { stageTimeListFlag bool terminationType int // 终止原因的类型 terminationTypeFlag bool - terminationReasonList []string // 终止的具体原因的id列表 + terminationReasonList []string // 终止的具体原因的 id 列表 terminationReasonListFlag bool terminationReasonNote string // 终止备注 terminationReasonNoteFlag bool @@ -1548,7 +1548,7 @@ func NewApplicationBuilder() *ApplicationBuilder { return builder } -// 投递id +// 投递 id // // 示例值：6949805467799537964 func (builder *ApplicationBuilder) Id(id string) *ApplicationBuilder { @@ -1674,7 +1674,7 @@ func (builder *ApplicationBuilder) TerminationType(terminationType int) *Applica return builder } -// 终止的具体原因的id列表 +// 终止的具体原因的 id 列表 // // 示例值： func (builder *ApplicationBuilder) TerminationReasonList(terminationReasonList []string) *ApplicationBuilder { @@ -2099,7 +2099,7 @@ func (builder *ApplicationJobAddressBuilder) Build() *ApplicationJobAddress { type ApplicationOffer struct { Id *string `json:"id,omitempty"` // Offer id - ApplicationId *string `json:"application_id,omitempty"` // 投递id + ApplicationId *string `json:"application_id,omitempty"` // 投递 id BasicInfo *ApplicationOfferBasicInfo `json:"basic_info,omitempty"` // 基础信息 SalaryPlan *ApplicationOfferSalaryPlan `json:"salary_plan,omitempty"` // 薪酬计划 SchemaId *string `json:"schema_id,omitempty"` // 当前 Offer 使用的 schema @@ -2110,7 +2110,7 @@ type ApplicationOffer struct { type ApplicationOfferBuilder struct { id string // Offer id idFlag bool - applicationId string // 投递id + applicationId string // 投递 id applicationIdFlag bool basicInfo *ApplicationOfferBasicInfo // 基础信息 basicInfoFlag bool @@ -2138,7 +2138,7 @@ func (builder *ApplicationOfferBuilder) Id(id string) *ApplicationOfferBuilder { return builder } -// 投递id +// 投递 id // // 示例值：7020661401874614564 func (builder *ApplicationOfferBuilder) ApplicationId(applicationId string) *ApplicationOfferBuilder { @@ -2223,12 +2223,12 @@ func (builder *ApplicationOfferBuilder) Build() *ApplicationOffer { } type ApplicationOfferAttachment struct { - AttachmentId *string `json:"attachment_id,omitempty"` // 附件ID + AttachmentId *string `json:"attachment_id,omitempty"` // 附件 ID Name *string `json:"name,omitempty"` // 名字 } type ApplicationOfferAttachmentBuilder struct { - attachmentId string // 附件ID + attachmentId string // 附件 ID attachmentIdFlag bool name string // 名字 nameFlag bool @@ -2239,7 +2239,7 @@ func NewApplicationOfferAttachmentBuilder() *ApplicationOfferAttachmentBuilder { return builder } -// 附件ID +// 附件 ID // // 示例值： func (builder *ApplicationOfferAttachmentBuilder) AttachmentId(attachmentId string) *ApplicationOfferAttachmentBuilder { @@ -2281,8 +2281,8 @@ type ApplicationOfferBasicInfo struct { LeaderUserId *string `json:"leader_user_id,omitempty"` // 直属上级 ID OnboardDate *string `json:"onboard_date,omitempty"` // 入职日期 DepartmentId *string `json:"department_id,omitempty"` // 入职部门 - ProbationMonth *int `json:"probation_month,omitempty"` // 试用期, 比如试用期6个月 - ContractYear *int `json:"contract_year,omitempty"` // 合同期, 比如3年 + ProbationMonth *int `json:"probation_month,omitempty"` // 试用期，比如试用期 6 个月 + ContractYear *int `json:"contract_year,omitempty"` // 合同期，比如 3 年 RecruitmentType *BaseBilingualWithId `json:"recruitment_type,omitempty"` // 雇员类型 Sequence *BaseBilingualWithId `json:"sequence,omitempty"` // 序列 Level *BaseBilingualWithId `json:"level,omitempty"` // 级别 @@ -2312,9 +2312,9 @@ type ApplicationOfferBasicInfoBuilder struct { onboardDateFlag bool departmentId string // 入职部门 departmentIdFlag bool - probationMonth int // 试用期, 比如试用期6个月 + probationMonth int // 试用期，比如试用期 6 个月 probationMonthFlag bool - contractYear int // 合同期, 比如3年 + contractYear int // 合同期，比如 3 年 contractYearFlag bool recruitmentType *BaseBilingualWithId // 雇员类型 recruitmentTypeFlag bool @@ -2425,7 +2425,7 @@ func (builder *ApplicationOfferBasicInfoBuilder) DepartmentId(departmentId strin return builder } -// 试用期, 比如试用期6个月 +// 试用期，比如试用期 6 个月 // // 示例值：1 func (builder *ApplicationOfferBasicInfoBuilder) ProbationMonth(probationMonth int) *ApplicationOfferBasicInfoBuilder { @@ -2434,7 +2434,7 @@ func (builder *ApplicationOfferBasicInfoBuilder) ProbationMonth(probationMonth i return builder } -// 合同期, 比如3年 +// 合同期，比如 3 年 // // 示例值：3 func (builder *ApplicationOfferBasicInfoBuilder) ContractYear(contractYear int) *ApplicationOfferBasicInfoBuilder { @@ -2718,7 +2718,7 @@ type ApplicationOfferBasicInfoUser struct { Timezone *string `json:"timezone,omitempty"` // 时区 Phone *string `json:"phone,omitempty"` // 手机 Email *string `json:"email,omitempty"` // 邮箱 - InAppScope *bool `json:"in_app_scope,omitempty"` // 是否拥有app权限 + InAppScope *bool `json:"in_app_scope,omitempty"` // 是否拥有 app 权限 } type ApplicationOfferBasicInfoUserBuilder struct { @@ -2738,7 +2738,7 @@ type ApplicationOfferBasicInfoUserBuilder struct { phoneFlag bool email string // 邮箱 emailFlag bool - inAppScope bool // 是否拥有app权限 + inAppScope bool // 是否拥有 app 权限 inAppScopeFlag bool } @@ -2819,7 +2819,7 @@ func (builder *ApplicationOfferBasicInfoUserBuilder) Email(email string) *Applic return builder } -// 是否拥有app权限 +// 是否拥有 app 权限 // // 示例值： func (builder *ApplicationOfferBasicInfoUserBuilder) InAppScope(inAppScope bool) *ApplicationOfferBasicInfoUserBuilder { @@ -2922,10 +2922,10 @@ type ApplicationOfferOnboardProfile struct { RecruitmentType *RecruitmentType `json:"recruitment_type,omitempty"` // 招聘类型 Sequence *Sequence `json:"sequence,omitempty"` // 序列 Level *Level `json:"level,omitempty"` // 职级 - OnboardAddress *ApplicationOfferOnboardProfileAddress `json:"onboard_address,omitempty"` // onboard地址 + OnboardAddress *ApplicationOfferOnboardProfileAddress `json:"onboard_address,omitempty"` // onboard 地址 WorkAddress *ApplicationOfferOnboardProfileAddress `json:"work_address,omitempty"` // 工作地址 Leader *ApplicationOfferBasicInfoUser `json:"leader,omitempty"` // 领导 - IsWorkAddressSameToOnboard *bool `json:"is_work_address_same_to_onboard,omitempty"` // 工作地址是否与onboard地址相同 + IsWorkAddressSameToOnboard *bool `json:"is_work_address_same_to_onboard,omitempty"` // 工作地址是否与 onboard 地址相同 ProbationMonth *int `json:"probation_month,omitempty"` // 试用期 ContractYear *int `json:"contract_year,omitempty"` // 合同年限 } @@ -2941,13 +2941,13 @@ type ApplicationOfferOnboardProfileBuilder struct { sequenceFlag bool level *Level // 职级 levelFlag bool - onboardAddress *ApplicationOfferOnboardProfileAddress // onboard地址 + onboardAddress *ApplicationOfferOnboardProfileAddress // onboard 地址 onboardAddressFlag bool workAddress *ApplicationOfferOnboardProfileAddress // 工作地址 workAddressFlag bool leader *ApplicationOfferBasicInfoUser // 领导 leaderFlag bool - isWorkAddressSameToOnboard bool // 工作地址是否与onboard地址相同 + isWorkAddressSameToOnboard bool // 工作地址是否与 onboard 地址相同 isWorkAddressSameToOnboardFlag bool probationMonth int // 试用期 probationMonthFlag bool @@ -3005,7 +3005,7 @@ func (builder *ApplicationOfferOnboardProfileBuilder) Level(level *Level) *Appli return builder } -// onboard地址 +// onboard 地址 // // 示例值： func (builder *ApplicationOfferOnboardProfileBuilder) OnboardAddress(onboardAddress *ApplicationOfferOnboardProfileAddress) *ApplicationOfferOnboardProfileBuilder { @@ -3032,7 +3032,7 @@ func (builder *ApplicationOfferOnboardProfileBuilder) Leader(leader *Application return builder } -// 工作地址是否与onboard地址相同 +// 工作地址是否与 onboard 地址相同 // // 示例值： func (builder *ApplicationOfferOnboardProfileBuilder) IsWorkAddressSameToOnboard(isWorkAddressSameToOnboard bool) *ApplicationOfferOnboardProfileBuilder { @@ -3109,7 +3109,7 @@ type ApplicationOfferOnboardProfileAddress struct { City *ApplicationOfferOnboardProfileCity `json:"city,omitempty"` // 城市 State *ApplicationOfferOnboardProfileCity `json:"state,omitempty"` // 省 Country *ApplicationOfferOnboardProfileCity `json:"country,omitempty"` // 国家 - UsageIdList []string `json:"usage_id_list,omitempty"` // 使用ID列表 + UsageIdList []string `json:"usage_id_list,omitempty"` // 使用 ID 列表 ActiveStatus *int `json:"active_status,omitempty"` // 状态 } @@ -3128,7 +3128,7 @@ type ApplicationOfferOnboardProfileAddressBuilder struct { stateFlag bool country *ApplicationOfferOnboardProfileCity // 国家 countryFlag bool - usageIdList []string // 使用ID列表 + usageIdList []string // 使用 ID 列表 usageIdListFlag bool activeStatus int // 状态 activeStatusFlag bool @@ -3202,7 +3202,7 @@ func (builder *ApplicationOfferOnboardProfileAddressBuilder) Country(country *Ap return builder } -// 使用ID列表 +// 使用 ID 列表 // // 示例值： func (builder *ApplicationOfferOnboardProfileAddressBuilder) UsageIdList(usageIdList []string) *ApplicationOfferOnboardProfileAddressBuilder { @@ -3338,20 +3338,20 @@ func (builder *ApplicationOfferOnboardProfileCityBuilder) Build() *ApplicationOf type ApplicationOfferSalaryPlan struct { Currency *string `json:"currency,omitempty"` // 币种 - BasicSalary *string `json:"basic_salary,omitempty"` // 基本薪资，为JSON 格式，amount 代表基本薪资的金额，peroid 代表基本薪资的周期单位，如："{"amount":"10000","period":2}" + BasicSalary *string `json:"basic_salary,omitempty"` // 基本薪资，为 JSON 格式，amount 代表基本薪资的金额，peroid 代表基本薪资的周期单位，如："{"amount":"10000","period":2}" ProbationSalaryPercentage *string `json:"probation_salary_percentage,omitempty"` // 试用期百分比 AwardSalaryMultiple *string `json:"award_salary_multiple,omitempty"` // 年终奖月数 OptionShares *string `json:"option_shares,omitempty"` // 期权股数 QuarterlyBonus *string `json:"quarterly_bonus,omitempty"` // 季度奖金额 HalfYearBonus *string `json:"half_year_bonus,omitempty"` // 半年奖金额 - TotalAnnualCash *string `json:"total_annual_cash,omitempty"` // 年度现金总额(数量，非公式) + TotalAnnualCash *string `json:"total_annual_cash,omitempty"` // 年度现金总额 (数量，非公式) CustomizeInfoList []*ApplicationOfferCustomValue `json:"customize_info_list,omitempty"` // 自定义字段的 value 信息 } type ApplicationOfferSalaryPlanBuilder struct { currency string // 币种 currencyFlag bool - basicSalary string // 基本薪资，为JSON 格式，amount 代表基本薪资的金额，peroid 代表基本薪资的周期单位，如："{"amount":"10000","period":2}" + basicSalary string // 基本薪资，为 JSON 格式，amount 代表基本薪资的金额，peroid 代表基本薪资的周期单位，如："{"amount":"10000","period":2}" basicSalaryFlag bool probationSalaryPercentage string // 试用期百分比 probationSalaryPercentageFlag bool @@ -3363,7 +3363,7 @@ type ApplicationOfferSalaryPlanBuilder struct { quarterlyBonusFlag bool halfYearBonus string // 半年奖金额 halfYearBonusFlag bool - totalAnnualCash string // 年度现金总额(数量，非公式) + totalAnnualCash string // 年度现金总额 (数量，非公式) totalAnnualCashFlag bool customizeInfoList []*ApplicationOfferCustomValue // 自定义字段的 value 信息 customizeInfoListFlag bool @@ -3383,7 +3383,7 @@ func (builder *ApplicationOfferSalaryPlanBuilder) Currency(currency string) *App return builder } -// 基本薪资，为JSON 格式，amount 代表基本薪资的金额，peroid 代表基本薪资的周期单位，如："{"amount":"10000","period":2}" +// 基本薪资，为 JSON 格式，amount 代表基本薪资的金额，peroid 代表基本薪资的周期单位，如："{"amount":"10000","period":2}" // // 示例值：{"amount":"10000","period":2} func (builder *ApplicationOfferSalaryPlanBuilder) BasicSalary(basicSalary string) *ApplicationOfferSalaryPlanBuilder { @@ -3437,7 +3437,7 @@ func (builder *ApplicationOfferSalaryPlanBuilder) HalfYearBonus(halfYearBonus st return builder } -// 年度现金总额(数量，非公式) +// 年度现金总额 (数量，非公式) // // 示例值：11111 func (builder *ApplicationOfferSalaryPlanBuilder) TotalAnnualCash(totalAnnualCash string) *ApplicationOfferSalaryPlanBuilder { @@ -3496,14 +3496,14 @@ func (builder *ApplicationOfferSalaryPlanBuilder) Build() *ApplicationOfferSalar } type ApplicationOfferSalaryPlanSalaryTemplate struct { - TemplateKey *string `json:"template_key,omitempty"` // 模版key + TemplateKey *string `json:"template_key,omitempty"` // 模版 key TotalAmount *string `json:"total_amount,omitempty"` // 总金额 Currency *string `json:"currency,omitempty"` // 币种 SalaryContent *string `json:"salary_content,omitempty"` // 薪酬内容 } type ApplicationOfferSalaryPlanSalaryTemplateBuilder struct { - templateKey string // 模版key + templateKey string // 模版 key templateKeyFlag bool totalAmount string // 总金额 totalAmountFlag bool @@ -3518,7 +3518,7 @@ func NewApplicationOfferSalaryPlanSalaryTemplateBuilder() *ApplicationOfferSalar return builder } -// 模版key +// 模版 key // // 示例值： func (builder *ApplicationOfferSalaryPlanSalaryTemplateBuilder) TemplateKey(templateKey string) *ApplicationOfferSalaryPlanSalaryTemplateBuilder { @@ -3576,15 +3576,15 @@ func (builder *ApplicationOfferSalaryPlanSalaryTemplateBuilder) Build() *Applica } type ApplicationPrehire struct { - Id *string `json:"id,omitempty"` // 投递id + Id *string `json:"id,omitempty"` // 投递 id BasicInfo *ApplicationBasicInfo `json:"basic_info,omitempty"` // 投递基础信息 Talent *ApplicationTalent `json:"talent,omitempty"` // 人才数据 Job *ApplicationJob `json:"job,omitempty"` // 职位数据 - Offer *ApplicationPrehireOffer `json:"offer,omitempty"` // Offer数据 + Offer *ApplicationPrehireOffer `json:"offer,omitempty"` // Offer 数据 } type ApplicationPrehireBuilder struct { - id string // 投递id + id string // 投递 id idFlag bool basicInfo *ApplicationBasicInfo // 投递基础信息 basicInfoFlag bool @@ -3592,7 +3592,7 @@ type ApplicationPrehireBuilder struct { talentFlag bool job *ApplicationJob // 职位数据 jobFlag bool - offer *ApplicationPrehireOffer // Offer数据 + offer *ApplicationPrehireOffer // Offer 数据 offerFlag bool } @@ -3601,7 +3601,7 @@ func NewApplicationPrehireBuilder() *ApplicationPrehireBuilder { return builder } -// 投递id +// 投递 id // // 示例值：6949805467799537964 func (builder *ApplicationPrehireBuilder) Id(id string) *ApplicationPrehireBuilder { @@ -3637,7 +3637,7 @@ func (builder *ApplicationPrehireBuilder) Job(job *ApplicationJob) *ApplicationP return builder } -// Offer数据 +// Offer 数据 // // 示例值： func (builder *ApplicationPrehireBuilder) Offer(offer *ApplicationPrehireOffer) *ApplicationPrehireBuilder { @@ -3733,16 +3733,16 @@ func (builder *ApplicationPrehireDepartmentBuilder) Build() *ApplicationPrehireD type ApplicationPrehireOffer struct { BasicInfo *ApplicationPrehireOfferBasic `json:"basic_info,omitempty"` // 投递基础信息 - OfferOnboardProfile *AppliOfferOnboardProfile `json:"offer_onboard_profile,omitempty"` // offer入职信息 - AttachmentList []*ApplicationOfferAttachment `json:"attachment_list,omitempty"` // offer附件 + OfferOnboardProfile *AppliOfferOnboardProfile `json:"offer_onboard_profile,omitempty"` // offer 入职信息 + AttachmentList []*ApplicationOfferAttachment `json:"attachment_list,omitempty"` // offer 附件 } type ApplicationPrehireOfferBuilder struct { basicInfo *ApplicationPrehireOfferBasic // 投递基础信息 basicInfoFlag bool - offerOnboardProfile *AppliOfferOnboardProfile // offer入职信息 + offerOnboardProfile *AppliOfferOnboardProfile // offer 入职信息 offerOnboardProfileFlag bool - attachmentList []*ApplicationOfferAttachment // offer附件 + attachmentList []*ApplicationOfferAttachment // offer 附件 attachmentListFlag bool } @@ -3760,7 +3760,7 @@ func (builder *ApplicationPrehireOfferBuilder) BasicInfo(basicInfo *ApplicationP return builder } -// offer入职信息 +// offer 入职信息 // // 示例值： func (builder *ApplicationPrehireOfferBuilder) OfferOnboardProfile(offerOnboardProfile *AppliOfferOnboardProfile) *ApplicationPrehireOfferBuilder { @@ -3769,7 +3769,7 @@ func (builder *ApplicationPrehireOfferBuilder) OfferOnboardProfile(offerOnboardP return builder } -// offer附件 +// offer 附件 // // 示例值： func (builder *ApplicationPrehireOfferBuilder) AttachmentList(attachmentList []*ApplicationOfferAttachment) *ApplicationPrehireOfferBuilder { @@ -3801,8 +3801,8 @@ type ApplicationPrehireOfferBasic struct { ExpireTime *int `json:"expire_time,omitempty"` // OnboardTime *int `json:"onboard_time,omitempty"` // TimeZone *string `json:"time_zone,omitempty"` // - OfferType *int `json:"offer_type,omitempty"` // Offer类型 1=Social, 2=Campus, 3=Intern, 4=InternTransfer - OfferStatus *int `json:"offer_status,omitempty"` // Offer状态 + OfferType *int `json:"offer_type,omitempty"` // Offer 类型 1=Social, 2=Campus, 3=Intern, 4=InternTransfer + OfferStatus *int `json:"offer_status,omitempty"` // Offer 状态 Owner *AppliOfferBasicInfoUser `json:"owner,omitempty"` // OfferJobTitle *string `json:"offer_job_title,omitempty"` // } @@ -3824,9 +3824,9 @@ type ApplicationPrehireOfferBasicBuilder struct { onboardTimeFlag bool timeZone string // timeZoneFlag bool - offerType int // Offer类型 1=Social, 2=Campus, 3=Intern, 4=InternTransfer + offerType int // Offer 类型 1=Social, 2=Campus, 3=Intern, 4=InternTransfer offerTypeFlag bool - offerStatus int // Offer状态 + offerStatus int // Offer 状态 offerStatusFlag bool owner *AppliOfferBasicInfoUser // ownerFlag bool @@ -3911,7 +3911,7 @@ func (builder *ApplicationPrehireOfferBasicBuilder) TimeZone(timeZone string) *A return builder } -// Offer类型 1=Social, 2=Campus, 3=Intern, 4=InternTransfer +// Offer 类型 1=Social, 2=Campus, 3=Intern, 4=InternTransfer // // 示例值：1 func (builder *ApplicationPrehireOfferBasicBuilder) OfferType(offerType int) *ApplicationPrehireOfferBasicBuilder { @@ -3920,7 +3920,7 @@ func (builder *ApplicationPrehireOfferBasicBuilder) OfferType(offerType int) *Ap return builder } -// Offer状态 +// Offer 状态 // // 示例值：0 func (builder *ApplicationPrehireOfferBasicBuilder) OfferStatus(offerStatus int) *ApplicationPrehireOfferBasicBuilder { @@ -4003,7 +4003,7 @@ type ApplicationPrehireOptional struct { WithTalentBasic *bool `json:"with_talent_basic,omitempty"` // 是否包含基础信息 WithTalentExtend *bool `json:"with_talent_extend,omitempty"` // 是否包含扩展信息 WithJob *bool `json:"with_job,omitempty"` // 是否包含岗位信息 - WithOffer *bool `json:"with_offer,omitempty"` // 是否包含offer信息 + WithOffer *bool `json:"with_offer,omitempty"` // 是否包含 offer 信息 } type ApplicationPrehireOptionalBuilder struct { @@ -4013,7 +4013,7 @@ type ApplicationPrehireOptionalBuilder struct { withTalentExtendFlag bool withJob bool // 是否包含岗位信息 withJobFlag bool - withOffer bool // 是否包含offer信息 + withOffer bool // 是否包含 offer 信息 withOfferFlag bool } @@ -4049,7 +4049,7 @@ func (builder *ApplicationPrehireOptionalBuilder) WithJob(withJob bool) *Applica return builder } -// 是否包含offer信息 +// 是否包含 offer 信息 // // 示例值： func (builder *ApplicationPrehireOptionalBuilder) WithOffer(withOffer bool) *ApplicationPrehireOptionalBuilder { @@ -4212,7 +4212,7 @@ type ApplicationStage struct { EnName *string `json:"en_name,omitempty"` // 英文名 Type *int `json:"type,omitempty"` // 类型 Args *string `json:"args,omitempty"` // 参数 - CreatorId *string `json:"creator_id,omitempty"` // 创建者ID + CreatorId *string `json:"creator_id,omitempty"` // 创建者 ID Seq *int `json:"seq,omitempty"` // 序列 PublishName *string `json:"publish_name,omitempty"` // 发布名称 PublishEnName *string `json:"publish_en_name,omitempty"` // 发布英文名 @@ -4229,7 +4229,7 @@ type ApplicationStageBuilder struct { typeFlag bool args string // 参数 argsFlag bool - creatorId string // 创建者ID + creatorId string // 创建者 ID creatorIdFlag bool seq int // 序列 seqFlag bool @@ -4289,7 +4289,7 @@ func (builder *ApplicationStageBuilder) Args(args string) *ApplicationStageBuild return builder } -// 创建者ID +// 创建者 ID // // 示例值： func (builder *ApplicationStageBuilder) CreatorId(creatorId string) *ApplicationStageBuilder { @@ -4522,7 +4522,7 @@ type ApplicationTalent struct { CompetitionList []*AppliTalentCompetitionInfo `json:"competition_list,omitempty"` // 竞赛列表 CertificateList []*AppliTalentCertificateInfo `json:"certificate_list,omitempty"` // 证书列表 LanguageList []*ApplicationTalentLanguageInfo `json:"language_list,omitempty"` // 语言列表 - SnsList []*ApplicationTalentSnsInfo `json:"sns_list,omitempty"` // SNS列表 + SnsList []*ApplicationTalentSnsInfo `json:"sns_list,omitempty"` // SNS 列表 AttachmentResumeList []*AppliTalentAttachResumeInfo `json:"attachment_resume_list,omitempty"` // 附件简历列表 } @@ -4549,7 +4549,7 @@ type ApplicationTalentBuilder struct { certificateListFlag bool languageList []*ApplicationTalentLanguageInfo // 语言列表 languageListFlag bool - snsList []*ApplicationTalentSnsInfo // SNS列表 + snsList []*ApplicationTalentSnsInfo // SNS 列表 snsListFlag bool attachmentResumeList []*AppliTalentAttachResumeInfo // 附件简历列表 attachmentResumeListFlag bool @@ -4659,7 +4659,7 @@ func (builder *ApplicationTalentBuilder) LanguageList(languageList []*Applicatio return builder } -// SNS列表 +// SNS 列表 // // 示例值： func (builder *ApplicationTalentBuilder) SnsList(snsList []*ApplicationTalentSnsInfo) *ApplicationTalentBuilder { @@ -5695,16 +5695,16 @@ func (builder *ApplicationTalentProjectInfoBuilder) Build() *ApplicationTalentPr type ApplicationTalentSnsInfo struct { Id *string `json:"id,omitempty"` // ID - SnsType *int `json:"sns_type,omitempty"` // SNS类型 - Link *string `json:"link,omitempty"` // SNS链接 + SnsType *int `json:"sns_type,omitempty"` // SNS 类型 + Link *string `json:"link,omitempty"` // SNS 链接 } type ApplicationTalentSnsInfoBuilder struct { id string // ID idFlag bool - snsType int // SNS类型 + snsType int // SNS 类型 snsTypeFlag bool - link string // SNS链接 + link string // SNS 链接 linkFlag bool } @@ -5722,7 +5722,7 @@ func (builder *ApplicationTalentSnsInfoBuilder) Id(id string) *ApplicationTalent return builder } -// SNS类型 +// SNS 类型 // // 示例值： func (builder *ApplicationTalentSnsInfoBuilder) SnsType(snsType int) *ApplicationTalentSnsInfoBuilder { @@ -5731,7 +5731,7 @@ func (builder *ApplicationTalentSnsInfoBuilder) SnsType(snsType int) *Applicatio return builder } -// SNS链接 +// SNS 链接 // // 示例值： func (builder *ApplicationTalentSnsInfoBuilder) Link(link string) *ApplicationTalentSnsInfoBuilder { @@ -5947,23 +5947,23 @@ func (builder *ApplicationWebsiteResumeSourceBuilder) Build() *ApplicationWebsit } type Attachment struct { - Id *string `json:"id,omitempty"` // 附件id - Url *string `json:"url,omitempty"` // 附件的url + Id *string `json:"id,omitempty"` // 附件 id + Url *string `json:"url,omitempty"` // 附件的 url Name *string `json:"name,omitempty"` // 附件文件名 Mime *string `json:"mime,omitempty"` // 媒体类型/MIME - CreateTime *int `json:"create_time,omitempty"` // 附件创建时间（单位ms） + CreateTime *int `json:"create_time,omitempty"` // 附件创建时间（单位 ms） } type AttachmentBuilder struct { - id string // 附件id + id string // 附件 id idFlag bool - url string // 附件的url + url string // 附件的 url urlFlag bool name string // 附件文件名 nameFlag bool mime string // 媒体类型/MIME mimeFlag bool - createTime int // 附件创建时间（单位ms） + createTime int // 附件创建时间（单位 ms） createTimeFlag bool } @@ -5972,7 +5972,7 @@ func NewAttachmentBuilder() *AttachmentBuilder { return builder } -// 附件id +// 附件 id // // 示例值：6949805467799537964 func (builder *AttachmentBuilder) Id(id string) *AttachmentBuilder { @@ -5981,7 +5981,7 @@ func (builder *AttachmentBuilder) Id(id string) *AttachmentBuilder { return builder } -// 附件的url +// 附件的 url // // 示例值：https://hire.feishu.cn/blob/xx/ func (builder *AttachmentBuilder) Url(url string) *AttachmentBuilder { @@ -5992,7 +5992,7 @@ func (builder *AttachmentBuilder) Url(url string) *AttachmentBuilder { // 附件文件名 // -// 示例值：xx的简历.prd +// 示例值：xx 的简历.prd func (builder *AttachmentBuilder) Name(name string) *AttachmentBuilder { builder.name = name builder.nameFlag = true @@ -6008,7 +6008,7 @@ func (builder *AttachmentBuilder) Mime(mime string) *AttachmentBuilder { return builder } -// 附件创建时间（单位ms） +// 附件创建时间（单位 ms） // // 示例值：1618899376480 func (builder *AttachmentBuilder) CreateTime(createTime int) *AttachmentBuilder { @@ -6891,14 +6891,14 @@ type BasicInfo struct { Birthday *int `json:"birthday,omitempty"` // 生日 Confidentiality *int `json:"confidentiality,omitempty"` // 保密 CreatorAccountType *int `json:"creator_account_type,omitempty"` // 创建者账户类型 - CreatorId *string `json:"creator_id,omitempty"` // 创建者ID + CreatorId *string `json:"creator_id,omitempty"` // 创建者 ID CurrentCityCode *string `json:"current_city_code,omitempty"` // 现居住城市 Gender *int `json:"gender,omitempty"` // 性别 HometownCityCode *string `json:"hometown_city_code,omitempty"` // 家乡所在城市 Identification *Identification `json:"identification,omitempty"` // 证件 InitSourceId *string `json:"init_source_id,omitempty"` // 来源 NationalityId *string `json:"nationality_id,omitempty"` // 国籍编号 - ResumeAttachmentId *string `json:"resume_attachment_id,omitempty"` // 附件简历ID + ResumeAttachmentId *string `json:"resume_attachment_id,omitempty"` // 附件简历 ID SelfEvaluation *string `json:"self_evaluation,omitempty"` // 自我评价 StartWorkTime *int `json:"start_work_time,omitempty"` // 开始工作时间 } @@ -6918,7 +6918,7 @@ type BasicInfoBuilder struct { confidentialityFlag bool creatorAccountType int // 创建者账户类型 creatorAccountTypeFlag bool - creatorId string // 创建者ID + creatorId string // 创建者 ID creatorIdFlag bool currentCityCode string // 现居住城市 currentCityCodeFlag bool @@ -6932,7 +6932,7 @@ type BasicInfoBuilder struct { initSourceIdFlag bool nationalityId string // 国籍编号 nationalityIdFlag bool - resumeAttachmentId string // 附件简历ID + resumeAttachmentId string // 附件简历 ID resumeAttachmentIdFlag bool selfEvaluation string // 自我评价 selfEvaluationFlag bool @@ -7008,7 +7008,7 @@ func (builder *BasicInfoBuilder) CreatorAccountType(creatorAccountType int) *Bas return builder } -// 创建者ID +// 创建者 ID // // 示例值： func (builder *BasicInfoBuilder) CreatorId(creatorId string) *BasicInfoBuilder { @@ -7071,7 +7071,7 @@ func (builder *BasicInfoBuilder) NationalityId(nationalityId string) *BasicInfoB return builder } -// 附件简历ID +// 附件简历 ID // // 示例值： func (builder *BasicInfoBuilder) ResumeAttachmentId(resumeAttachmentId string) *BasicInfoBuilder { @@ -7532,7 +7532,7 @@ type CombinedJob struct { ProcessType *int `json:"process_type,omitempty"` // 职位流程类型 SubjectId *string `json:"subject_id,omitempty"` // 项目，枚举通过「获取项目列表」接口 JobFunctionId *string `json:"job_function_id,omitempty"` // 职能分类，通过「获取职能分类」获取 - DepartmentId *string `json:"department_id,omitempty"` // 部门 ID，须传入open_department_id，格式为"od-xxxx"。可通过「获取部门信息列表」获取 + DepartmentId *string `json:"department_id,omitempty"` // 部门 ID，须传入 open_department_id，格式为"od-xxxx"。可通过「获取部门信息列表」获取 HeadCount *int `json:"head_count,omitempty"` // 招聘数量 IsNeverExpired *bool `json:"is_never_expired,omitempty"` // 是否长期有效 MaxSalary *int `json:"max_salary,omitempty"` // 最高薪资，单位：k @@ -7546,7 +7546,7 @@ type CombinedJob struct { RequiredDegree *int `json:"required_degree,omitempty"` // 学历要求 JobCategoryId *string `json:"job_category_id,omitempty"` // 序列 AddressIdList []string `json:"address_id_list,omitempty"` // 工作地点，枚举通过接口「获取地址列表」获取，选择地点用途为「职位地址」 - JobAttribute *int `json:"job_attribute,omitempty"` // 职位属性，1是实体职位，2是虚拟职位 + JobAttribute *int `json:"job_attribute,omitempty"` // 职位属性，1 是实体职位，2 是虚拟职位 ExpiryTimestamp *string `json:"expiry_timestamp,omitempty"` // 到期日期的毫秒时间戳 } @@ -7577,7 +7577,7 @@ type CombinedJobBuilder struct { subjectIdFlag bool jobFunctionId string // 职能分类，通过「获取职能分类」获取 jobFunctionIdFlag bool - departmentId string // 部门 ID，须传入open_department_id，格式为"od-xxxx"。可通过「获取部门信息列表」获取 + departmentId string // 部门 ID，须传入 open_department_id，格式为"od-xxxx"。可通过「获取部门信息列表」获取 departmentIdFlag bool headCount int // 招聘数量 headCountFlag bool @@ -7605,7 +7605,7 @@ type CombinedJobBuilder struct { jobCategoryIdFlag bool addressIdList []string // 工作地点，枚举通过接口「获取地址列表」获取，选择地点用途为「职位地址」 addressIdListFlag bool - jobAttribute int // 职位属性，1是实体职位，2是虚拟职位 + jobAttribute int // 职位属性，1 是实体职位，2 是虚拟职位 jobAttributeFlag bool expiryTimestamp string // 到期日期的毫秒时间戳 expiryTimestampFlag bool @@ -7733,7 +7733,7 @@ func (builder *CombinedJobBuilder) JobFunctionId(jobFunctionId string) *Combined return builder } -// 部门 ID，须传入open_department_id，格式为"od-xxxx"。可通过「获取部门信息列表」获取 +// 部门 ID，须传入 open_department_id，格式为"od-xxxx"。可通过「获取部门信息列表」获取 // // 示例值：od-b2fafdce6fc5800b574ba5b0e2798b36 func (builder *CombinedJobBuilder) DepartmentId(departmentId string) *CombinedJobBuilder { @@ -7859,7 +7859,7 @@ func (builder *CombinedJobBuilder) AddressIdList(addressIdList []string) *Combin return builder } -// 职位属性，1是实体职位，2是虚拟职位 +// 职位属性，1 是实体职位，2 是虚拟职位 // // 示例值：职位类别 func (builder *CombinedJobBuilder) JobAttribute(jobAttribute int) *CombinedJobBuilder { @@ -8854,7 +8854,7 @@ func (builder *DepartmentBuilder) Id(id string) *DepartmentBuilder { // 名字 // -// 示例值：部门名A +// 示例值：部门名 A func (builder *DepartmentBuilder) Name(name string) *DepartmentBuilder { builder.name = name builder.nameFlag = true @@ -9610,7 +9610,7 @@ func (builder *EcoBackgroundCheckPackageAdditionalItemBuilder) Id(id string) *Ec // 附加调查项名称 // -// 示例值：工作履历信息验证X2 +// 示例值：工作履历信息验证 X2 func (builder *EcoBackgroundCheckPackageAdditionalItemBuilder) Name(name string) *EcoBackgroundCheckPackageAdditionalItemBuilder { builder.name = name builder.nameFlag = true @@ -9683,7 +9683,7 @@ func (builder *EcoBackgroundCheckPackageDataBuilder) Name(name string) *EcoBackg // 套餐描述 // -// 示例值：工作履历信息验证X1，工作表现鉴定评价X1，教育背景核实，公民身份信息验证，简历对比，民事诉讼调查 +// 示例值：工作履历信息验证 X1，工作表现鉴定评价 X1，教育背景核实，公民身份信息验证，简历对比，民事诉讼调查 func (builder *EcoBackgroundCheckPackageDataBuilder) Description(description string) *EcoBackgroundCheckPackageDataBuilder { builder.description = description builder.descriptionFlag = true @@ -10472,8 +10472,8 @@ func (builder *EhrImportTaskBuilder) Build() *EhrImportTask { } type Employee struct { - Id *string `json:"id,omitempty"` // 员工ID - ApplicationId *string `json:"application_id,omitempty"` // 投递ID + Id *string `json:"id,omitempty"` // 员工 ID + ApplicationId *string `json:"application_id,omitempty"` // 投递 ID OnboardStatus *int `json:"onboard_status,omitempty"` // 入职状态 ConversionStatus *int `json:"conversion_status,omitempty"` // 转正状态 OnboardTime *int `json:"onboard_time,omitempty"` // 实际入职时间 @@ -10490,9 +10490,9 @@ type Employee struct { } type EmployeeBuilder struct { - id string // 员工ID + id string // 员工 ID idFlag bool - applicationId string // 投递ID + applicationId string // 投递 ID applicationIdFlag bool onboardStatus int // 入职状态 onboardStatusFlag bool @@ -10527,7 +10527,7 @@ func NewEmployeeBuilder() *EmployeeBuilder { return builder } -// 员工ID +// 员工 ID // // 示例值：7095600054216542508 func (builder *EmployeeBuilder) Id(id string) *EmployeeBuilder { @@ -10536,7 +10536,7 @@ func (builder *EmployeeBuilder) Id(id string) *EmployeeBuilder { return builder } -// 投递ID +// 投递 ID // // 示例值：7073372582620416300 func (builder *EmployeeBuilder) ApplicationId(applicationId string) *EmployeeBuilder { @@ -10811,8 +10811,8 @@ type Evaluation struct { Id *string `json:"id,omitempty"` // 评估 ID ApplicationId *string `json:"application_id,omitempty"` // 投递 ID StageId *string `json:"stage_id,omitempty"` // 投递阶段 - CreatorId *string `json:"creator_id,omitempty"` // 创建人user_id - EvaluatorId *string `json:"evaluator_id,omitempty"` // 评估人user_id + CreatorId *string `json:"creator_id,omitempty"` // 创建人 user_id + EvaluatorId *string `json:"evaluator_id,omitempty"` // 评估人 user_id CommitStatus *int `json:"commit_status,omitempty"` // 提交状态 Conclusion *int `json:"conclusion,omitempty"` // 评估结论 Content *string `json:"content,omitempty"` // 评估详情 @@ -10827,9 +10827,9 @@ type EvaluationBuilder struct { applicationIdFlag bool stageId string // 投递阶段 stageIdFlag bool - creatorId string // 创建人user_id + creatorId string // 创建人 user_id creatorIdFlag bool - evaluatorId string // 评估人user_id + evaluatorId string // 评估人 user_id evaluatorIdFlag bool commitStatus int // 提交状态 commitStatusFlag bool @@ -10875,7 +10875,7 @@ func (builder *EvaluationBuilder) StageId(stageId string) *EvaluationBuilder { return builder } -// 创建人user_id +// 创建人 user_id // // 示例值：ou_aaf83d1b2c856ead36aa9a38784b9a5c func (builder *EvaluationBuilder) CreatorId(creatorId string) *EvaluationBuilder { @@ -10884,7 +10884,7 @@ func (builder *EvaluationBuilder) CreatorId(creatorId string) *EvaluationBuilder return builder } -// 评估人user_id +// 评估人 user_id // // 示例值：ou_aaf83d1b2c856ead36aa9a38784b9a5c func (builder *EvaluationBuilder) EvaluatorId(evaluatorId string) *EvaluationBuilder { @@ -11177,7 +11177,7 @@ func (builder *ExamMarkingTaskBuilder) Build() *ExamMarkingTask { type ExternalApplication struct { Id *string `json:"id,omitempty"` // 外部投递 ID - ExternalId *string `json:"external_id,omitempty"` // 外部系统投递主键 （仅用于幂等） + ExternalId *string `json:"external_id,omitempty"` // 外部系统投递主键（仅用于幂等） JobRecruitmentType *int `json:"job_recruitment_type,omitempty"` // 职位招聘类型 JobTitle *string `json:"job_title,omitempty"` // 职位名称 ResumeSource *string `json:"resume_source,omitempty"` // 简历来源 @@ -11192,7 +11192,7 @@ type ExternalApplication struct { type ExternalApplicationBuilder struct { id string // 外部投递 ID idFlag bool - externalId string // 外部系统投递主键 （仅用于幂等） + externalId string // 外部系统投递主键（仅用于幂等） externalIdFlag bool jobRecruitmentType int // 职位招聘类型 jobRecruitmentTypeFlag bool @@ -11228,7 +11228,7 @@ func (builder *ExternalApplicationBuilder) Id(id string) *ExternalApplicationBui return builder } -// 外部系统投递主键 （仅用于幂等） +// 外部系统投递主键（仅用于幂等） // // 示例值：123 func (builder *ExternalApplicationBuilder) ExternalId(externalId string) *ExternalApplicationBuilder { @@ -11248,7 +11248,7 @@ func (builder *ExternalApplicationBuilder) JobRecruitmentType(jobRecruitmentType // 职位名称 // -// 示例值：高级Java +// 示例值：高级 Java func (builder *ExternalApplicationBuilder) JobTitle(jobTitle string) *ExternalApplicationBuilder { builder.jobTitle = jobTitle builder.jobTitleFlag = true @@ -11369,19 +11369,19 @@ func (builder *ExternalApplicationBuilder) Build() *ExternalApplication { type ExternalBackgroundCheck struct { Id *string `json:"id,omitempty"` // 外部背调 ID - ExternalId *string `json:"external_id,omitempty"` // 外部系统背调主键 （仅用于幂等） + ExternalId *string `json:"external_id,omitempty"` // 外部系统背调主键（仅用于幂等） ExternalApplicationId *string `json:"external_application_id,omitempty"` // 外部投递 ID Date *int `json:"date,omitempty"` // 背调日期 Name *string `json:"name,omitempty"` // 背调名字 Result *string `json:"result,omitempty"` // 背调结果 - AttachmentIdList []string `json:"attachment_id_list,omitempty"` // 背调附件ID列表 + AttachmentIdList []string `json:"attachment_id_list,omitempty"` // 背调附件 ID 列表 AttachmentList []*ExternalBackgroundCheckAttachment `json:"attachment_list,omitempty"` // 背调附件 } type ExternalBackgroundCheckBuilder struct { id string // 外部背调 ID idFlag bool - externalId string // 外部系统背调主键 （仅用于幂等） + externalId string // 外部系统背调主键（仅用于幂等） externalIdFlag bool externalApplicationId string // 外部投递 ID externalApplicationIdFlag bool @@ -11391,7 +11391,7 @@ type ExternalBackgroundCheckBuilder struct { nameFlag bool result string // 背调结果 resultFlag bool - attachmentIdList []string // 背调附件ID列表 + attachmentIdList []string // 背调附件 ID 列表 attachmentIdListFlag bool attachmentList []*ExternalBackgroundCheckAttachment // 背调附件 attachmentListFlag bool @@ -11411,7 +11411,7 @@ func (builder *ExternalBackgroundCheckBuilder) Id(id string) *ExternalBackground return builder } -// 外部系统背调主键 （仅用于幂等） +// 外部系统背调主键（仅用于幂等） // // 示例值：123 func (builder *ExternalBackgroundCheckBuilder) ExternalId(externalId string) *ExternalBackgroundCheckBuilder { @@ -11456,7 +11456,7 @@ func (builder *ExternalBackgroundCheckBuilder) Result(result string) *ExternalBa return builder } -// 背调附件ID列表 +// 背调附件 ID 列表 // // 示例值：6989181065243969836 func (builder *ExternalBackgroundCheckBuilder) AttachmentIdList(attachmentIdList []string) *ExternalBackgroundCheckBuilder { @@ -11574,7 +11574,7 @@ func (builder *ExternalBackgroundCheckAttachmentBuilder) Build() *ExternalBackgr } type ExternalInterview struct { - ExternalId *string `json:"external_id,omitempty"` // 外部系统面试主键 （仅用于幂等） + ExternalId *string `json:"external_id,omitempty"` // 外部系统面试主键（仅用于幂等） ExternalApplicationId *string `json:"external_application_id,omitempty"` // 外部投递 ID Id *string `json:"id,omitempty"` // 外部面试 ID ParticipateStatus *int `json:"participate_status,omitempty"` // 参与状态 @@ -11583,7 +11583,7 @@ type ExternalInterview struct { } type ExternalInterviewBuilder struct { - externalId string // 外部系统面试主键 （仅用于幂等） + externalId string // 外部系统面试主键（仅用于幂等） externalIdFlag bool externalApplicationId string // 外部投递 ID externalApplicationIdFlag bool @@ -11602,7 +11602,7 @@ func NewExternalInterviewBuilder() *ExternalInterviewBuilder { return builder } -// 外部系统面试主键 （仅用于幂等） +// 外部系统面试主键（仅用于幂等） // // 示例值：123 func (builder *ExternalInterviewBuilder) ExternalId(externalId string) *ExternalInterviewBuilder { @@ -12449,22 +12449,22 @@ func (builder *InternshipInfoBuilder) Build() *InternshipInfo { } type Interview struct { - Id *string `json:"id,omitempty"` // 面试id + Id *string `json:"id,omitempty"` // 面试 id BeginTime *int `json:"begin_time,omitempty"` // 面试开始时间（ms） EndTime *int `json:"end_time,omitempty"` // 面试结束时间（ms） - Round *int `json:"round,omitempty"` // 面试轮次（从0开始计数） + Round *int `json:"round,omitempty"` // 面试轮次（从 0 开始计数） StageId *string `json:"stage_id,omitempty"` // 面试关联的投递阶段 InterviewRecordList []*InterviewRecord `json:"interview_record_list,omitempty"` // 面试官记录列表 } type InterviewBuilder struct { - id string // 面试id + id string // 面试 id idFlag bool beginTime int // 面试开始时间（ms） beginTimeFlag bool endTime int // 面试结束时间（ms） endTimeFlag bool - round int // 面试轮次（从0开始计数） + round int // 面试轮次（从 0 开始计数） roundFlag bool stageId string // 面试关联的投递阶段 stageIdFlag bool @@ -12477,7 +12477,7 @@ func NewInterviewBuilder() *InterviewBuilder { return builder } -// 面试id +// 面试 id // // 示例值：6949805467799537964 func (builder *InterviewBuilder) Id(id string) *InterviewBuilder { @@ -12504,7 +12504,7 @@ func (builder *InterviewBuilder) EndTime(endTime int) *InterviewBuilder { return builder } -// 面试轮次（从0开始计数） +// 面试轮次（从 0 开始计数） // // 示例值：0 func (builder *InterviewBuilder) Round(round int) *InterviewBuilder { @@ -12716,12 +12716,12 @@ func (builder *InterviewAppointmentConfigBuilder) Build() *InterviewAppointmentC type InterviewAppointmentConfigContent struct { InterviewType *int `json:"interview_type,omitempty"` // 面试类型 TalentTimezoneCode *string `json:"talent_timezone_code,omitempty"` // 时区 - ContactUserId *string `json:"contact_user_id,omitempty"` // 联系人id + ContactUserId *string `json:"contact_user_id,omitempty"` // 联系人 id ContactMobile *string `json:"contact_mobile,omitempty"` // 联系人电话 ContactEmail *string `json:"contact_email,omitempty"` // 联系人邮箱 - AddressId *string `json:"address_id,omitempty"` // 地址id - VideoType *int `json:"video_type,omitempty"` // 地址id - Cc []string `json:"cc,omitempty"` // 抄送人id lsit + AddressId *string `json:"address_id,omitempty"` // 地址 id + VideoType *int `json:"video_type,omitempty"` // 地址 id + Cc []string `json:"cc,omitempty"` // 抄送人 id lsit Remark *string `json:"remark,omitempty"` // 备注 InterviewNotificationTemplateId *string `json:"interview_notification_template_id,omitempty"` // 面试通知模板 AppointmentNotificationTemplateId *string `json:"appointment_notification_template_id,omitempty"` // 预约通知模板 @@ -12733,17 +12733,17 @@ type InterviewAppointmentConfigContentBuilder struct { interviewTypeFlag bool talentTimezoneCode string // 时区 talentTimezoneCodeFlag bool - contactUserId string // 联系人id + contactUserId string // 联系人 id contactUserIdFlag bool contactMobile string // 联系人电话 contactMobileFlag bool contactEmail string // 联系人邮箱 contactEmailFlag bool - addressId string // 地址id + addressId string // 地址 id addressIdFlag bool - videoType int // 地址id + videoType int // 地址 id videoTypeFlag bool - cc []string // 抄送人id lsit + cc []string // 抄送人 id lsit ccFlag bool remark string // 备注 remarkFlag bool @@ -12778,7 +12778,7 @@ func (builder *InterviewAppointmentConfigContentBuilder) TalentTimezoneCode(tale return builder } -// 联系人id +// 联系人 id // // 示例值：ou_c99c5f35d542efc7ee492afe11af19ef func (builder *InterviewAppointmentConfigContentBuilder) ContactUserId(contactUserId string) *InterviewAppointmentConfigContentBuilder { @@ -12805,7 +12805,7 @@ func (builder *InterviewAppointmentConfigContentBuilder) ContactEmail(contactEma return builder } -// 地址id +// 地址 id // // 示例值：6960663240925956576 func (builder *InterviewAppointmentConfigContentBuilder) AddressId(addressId string) *InterviewAppointmentConfigContentBuilder { @@ -12814,7 +12814,7 @@ func (builder *InterviewAppointmentConfigContentBuilder) AddressId(addressId str return builder } -// 地址id +// 地址 id // // 示例值：1 func (builder *InterviewAppointmentConfigContentBuilder) VideoType(videoType int) *InterviewAppointmentConfigContentBuilder { @@ -12823,7 +12823,7 @@ func (builder *InterviewAppointmentConfigContentBuilder) VideoType(videoType int return builder } -// 抄送人id lsit +// 抄送人 id lsit // // 示例值：ou_c99c5f35d542efc7ee492afe11af19ef func (builder *InterviewAppointmentConfigContentBuilder) Cc(cc []string) *InterviewAppointmentConfigContentBuilder { @@ -14530,7 +14530,7 @@ func (builder *InterviewScoreBuilder) ZhName(zhName string) *InterviewScoreBuild // 中文描述 // -// 示例值：通过, 能力达到要求, 建议录用 +// 示例值：通过，能力达到要求，建议录用 func (builder *InterviewScoreBuilder) ZhDescription(zhDescription string) *InterviewScoreBuilder { builder.zhDescription = zhDescription builder.zhDescriptionFlag = true @@ -14695,7 +14695,7 @@ type Job struct { JobCategory *JobCategory `json:"job_category,omitempty"` // 职位序列 JobType *JobType `json:"job_type,omitempty"` // 职位类别 ActiveStatus *int `json:"active_status,omitempty"` // 启用状态 - CreateUserId *string `json:"create_user_id,omitempty"` // 创建人ID，若为空则为系统或其他对接系统创建 + CreateUserId *string `json:"create_user_id,omitempty"` // 创建人 ID，若为空则为系统或其他对接系统创建 CreateTime *int `json:"create_time,omitempty"` // 创建时间 UpdateTime *int `json:"update_time,omitempty"` // 更新时间 ProcessType *int `json:"process_type,omitempty"` // 招聘流程类型 @@ -14712,7 +14712,7 @@ type Job struct { MaxSalary *int `json:"max_salary,omitempty"` // 最高薪资，单位:k RequiredDegree *int `json:"required_degree,omitempty"` // 学历要求 CityList []*CodeNameObject `json:"city_list,omitempty"` // 工作地点列表 - JobAttribute *int `json:"job_attribute,omitempty"` // 职位属性，1是实体职位，2是虚拟职位 + JobAttribute *int `json:"job_attribute,omitempty"` // 职位属性，1 是实体职位，2 是虚拟职位 CreateTimestamp *string `json:"create_timestamp,omitempty"` // 创建时间戳 UpdateTimestamp *string `json:"update_timestamp,omitempty"` // 更新时间戳 ExpiryTimestamp *string `json:"expiry_timestamp,omitempty"` // 到期时间戳 @@ -14747,7 +14747,7 @@ type JobBuilder struct { jobTypeFlag bool activeStatus int // 启用状态 activeStatusFlag bool - createUserId string // 创建人ID，若为空则为系统或其他对接系统创建 + createUserId string // 创建人 ID，若为空则为系统或其他对接系统创建 createUserIdFlag bool createTime int // 创建时间 createTimeFlag bool @@ -14781,7 +14781,7 @@ type JobBuilder struct { requiredDegreeFlag bool cityList []*CodeNameObject // 工作地点列表 cityListFlag bool - jobAttribute int // 职位属性，1是实体职位，2是虚拟职位 + jobAttribute int // 职位属性，1 是实体职位，2 是虚拟职位 jobAttributeFlag bool createTimestamp string // 创建时间戳 createTimestampFlag bool @@ -14922,7 +14922,7 @@ func (builder *JobBuilder) ActiveStatus(activeStatus int) *JobBuilder { return builder } -// 创建人ID，若为空则为系统或其他对接系统创建 +// 创建人 ID，若为空则为系统或其他对接系统创建 // // 示例值：ou-xxx func (builder *JobBuilder) CreateUserId(createUserId string) *JobBuilder { @@ -15075,7 +15075,7 @@ func (builder *JobBuilder) CityList(cityList []*CodeNameObject) *JobBuilder { return builder } -// 职位属性，1是实体职位，2是虚拟职位 +// 职位属性，1 是实体职位，2 是虚拟职位 // // 示例值：1 func (builder *JobBuilder) JobAttribute(jobAttribute int) *JobBuilder { @@ -15323,20 +15323,20 @@ func (builder *JobManagerBuilder) Build() *JobManager { } type JobRecruiter struct { - Id *string `json:"id,omitempty"` // 职位ID - RecruiterId *string `json:"recruiter_id,omitempty"` // 招聘负责人ID - HiringManagerIdList []string `json:"hiring_manager_id_list,omitempty"` // 用人经理ID列表 - AssistantIdList []string `json:"assistant_id_list,omitempty"` // 协助人ID列表 + Id *string `json:"id,omitempty"` // 职位 ID + RecruiterId *string `json:"recruiter_id,omitempty"` // 招聘负责人 ID + HiringManagerIdList []string `json:"hiring_manager_id_list,omitempty"` // 用人经理 ID 列表 + AssistantIdList []string `json:"assistant_id_list,omitempty"` // 协助人 ID 列表 } type JobRecruiterBuilder struct { - id string // 职位ID + id string // 职位 ID idFlag bool - recruiterId string // 招聘负责人ID + recruiterId string // 招聘负责人 ID recruiterIdFlag bool - hiringManagerIdList []string // 用人经理ID列表 + hiringManagerIdList []string // 用人经理 ID 列表 hiringManagerIdListFlag bool - assistantIdList []string // 协助人ID列表 + assistantIdList []string // 协助人 ID 列表 assistantIdListFlag bool } @@ -15345,7 +15345,7 @@ func NewJobRecruiterBuilder() *JobRecruiterBuilder { return builder } -// 职位ID +// 职位 ID // // 示例值： func (builder *JobRecruiterBuilder) Id(id string) *JobRecruiterBuilder { @@ -15354,7 +15354,7 @@ func (builder *JobRecruiterBuilder) Id(id string) *JobRecruiterBuilder { return builder } -// 招聘负责人ID +// 招聘负责人 ID // // 示例值： func (builder *JobRecruiterBuilder) RecruiterId(recruiterId string) *JobRecruiterBuilder { @@ -15363,7 +15363,7 @@ func (builder *JobRecruiterBuilder) RecruiterId(recruiterId string) *JobRecruite return builder } -// 用人经理ID列表 +// 用人经理 ID 列表 // // 示例值： func (builder *JobRecruiterBuilder) HiringManagerIdList(hiringManagerIdList []string) *JobRecruiterBuilder { @@ -15372,7 +15372,7 @@ func (builder *JobRecruiterBuilder) HiringManagerIdList(hiringManagerIdList []st return builder } -// 协助人ID列表 +// 协助人 ID 列表 // // 示例值： func (builder *JobRecruiterBuilder) AssistantIdList(assistantIdList []string) *JobRecruiterBuilder { @@ -15553,7 +15553,7 @@ type JobConfig struct { InterviewRoundConfList []*JobConfigInterviewRoundConf `json:"interview_round_conf_list,omitempty"` // 建议面试官列表 JrIdList []string `json:"jr_id_list,omitempty"` // 关联招聘需求，支持关联多个，枚举通过接口「获取招聘需求」获取 InterviewRoundTypeConfList []*JobConfigRoundType `json:"interview_round_type_conf_list,omitempty"` // 面试轮次类型 ID 列表 - RelatedJobIdList []string `json:"related_job_id_list,omitempty"` // 关联职位列表，如职位为实体职位则关联虚拟职位id，如职位为虚拟职位则关联实体职位id + RelatedJobIdList []string `json:"related_job_id_list,omitempty"` // 关联职位列表，如职位为实体职位则关联虚拟职位 id，如职位为虚拟职位则关联实体职位 id InterviewAppointmentConfig *InterviewAppointmentConfig `json:"interview_appointment_config,omitempty"` // 自助约面配置 } @@ -15574,7 +15574,7 @@ type JobConfigBuilder struct { jrIdListFlag bool interviewRoundTypeConfList []*JobConfigRoundType // 面试轮次类型 ID 列表 interviewRoundTypeConfListFlag bool - relatedJobIdList []string // 关联职位列表，如职位为实体职位则关联虚拟职位id，如职位为虚拟职位则关联实体职位id + relatedJobIdList []string // 关联职位列表，如职位为实体职位则关联虚拟职位 id，如职位为虚拟职位则关联实体职位 id relatedJobIdListFlag bool interviewAppointmentConfig *InterviewAppointmentConfig // 自助约面配置 interviewAppointmentConfigFlag bool @@ -15657,7 +15657,7 @@ func (builder *JobConfigBuilder) InterviewRoundTypeConfList(interviewRoundTypeCo return builder } -// 关联职位列表，如职位为实体职位则关联虚拟职位id，如职位为虚拟职位则关联实体职位id +// 关联职位列表，如职位为实体职位则关联虚拟职位 id，如职位为虚拟职位则关联实体职位 id // // 示例值：6966533137982392320 func (builder *JobConfigBuilder) RelatedJobIdList(relatedJobIdList []string) *JobConfigBuilder { @@ -15817,7 +15817,7 @@ type JobConfigResult struct { JobRequirementList []*IdNameObject `json:"job_requirement_list,omitempty"` // 招聘需求 InterviewRoundTypeList []*JobConfigRoundTypeResult `json:"interview_round_type_list,omitempty"` // 面试轮次类型列表 RelatedJobList []*IdNameObject `json:"related_job_list,omitempty"` // 关联职位列表 - JobAttribute *int `json:"job_attribute,omitempty"` // 职位属性，1是实体职位，2是虚拟职位 + JobAttribute *int `json:"job_attribute,omitempty"` // 职位属性，1 是实体职位，2 是虚拟职位 } type JobConfigResultBuilder struct { @@ -15839,7 +15839,7 @@ type JobConfigResultBuilder struct { interviewRoundTypeListFlag bool relatedJobList []*IdNameObject // 关联职位列表 relatedJobListFlag bool - jobAttribute int // 职位属性，1是实体职位，2是虚拟职位 + jobAttribute int // 职位属性，1 是实体职位，2 是虚拟职位 jobAttributeFlag bool } @@ -15929,7 +15929,7 @@ func (builder *JobConfigResultBuilder) RelatedJobList(relatedJobList []*IdNameOb return builder } -// 职位属性，1是实体职位，2是虚拟职位 +// 职位属性，1 是实体职位，2 是虚拟职位 // // 示例值：1 func (builder *JobConfigResultBuilder) JobAttribute(jobAttribute int) *JobConfigResultBuilder { @@ -16674,8 +16674,8 @@ type JobProcesses struct { Id *string `json:"id,omitempty"` // ID ZhName *string `json:"zh_name,omitempty"` // 中文名称 EnName *string `json:"en_name,omitempty"` // 英文名称 - Type *int `json:"type,omitempty"` // 类型 1=社招流程, 2=校招流程, - StageList []*JobProcessesStage `json:"stage_list,omitempty"` // 阶段列表, 内部按用户设置顺序排列 + Type *int `json:"type,omitempty"` // 类型 1=社招流程，2=校招流程， + StageList []*JobProcessesStage `json:"stage_list,omitempty"` // 阶段列表，内部按用户设置顺序排列 } type JobProcessesBuilder struct { @@ -16685,9 +16685,9 @@ type JobProcessesBuilder struct { zhNameFlag bool enName string // 英文名称 enNameFlag bool - type_ int // 类型 1=社招流程, 2=校招流程, + type_ int // 类型 1=社招流程，2=校招流程， typeFlag bool - stageList []*JobProcessesStage // 阶段列表, 内部按用户设置顺序排列 + stageList []*JobProcessesStage // 阶段列表，内部按用户设置顺序排列 stageListFlag bool } @@ -16723,7 +16723,7 @@ func (builder *JobProcessesBuilder) EnName(enName string) *JobProcessesBuilder { return builder } -// 类型 1=社招流程, 2=校招流程, +// 类型 1=社招流程，2=校招流程， // // 示例值：1 func (builder *JobProcessesBuilder) Type(type_ int) *JobProcessesBuilder { @@ -16732,7 +16732,7 @@ func (builder *JobProcessesBuilder) Type(type_ int) *JobProcessesBuilder { return builder } -// 阶段列表, 内部按用户设置顺序排列 +// 阶段列表，内部按用户设置顺序排列 // // 示例值： func (builder *JobProcessesBuilder) StageList(stageList []*JobProcessesStage) *JobProcessesBuilder { @@ -16769,7 +16769,7 @@ type JobProcessesStage struct { Id *string `json:"id,omitempty"` // ID ZhName *string `json:"zh_name,omitempty"` // 中文名称 EnName *string `json:"en_name,omitempty"` // 英文名称 - Type *int `json:"type,omitempty"` // 1=筛选型, 2=评估型, 3=笔试型, 4=面试型, 5=Offer型, 6=待入职, 7=已入职, 8=其它类型, 255=系统默认，后端模型中并没有该字段，仅用于前端显示, + Type *int `json:"type,omitempty"` // 1=筛选型，2=评估型，3=笔试型，4=面试型，5=Offer 型，6=待入职，7=已入职，8=其它类型，255=系统默认，后端模型中并没有该字段，仅用于前端显示， } type JobProcessesStageBuilder struct { @@ -16779,7 +16779,7 @@ type JobProcessesStageBuilder struct { zhNameFlag bool enName string // 英文名称 enNameFlag bool - type_ int // 1=筛选型, 2=评估型, 3=笔试型, 4=面试型, 5=Offer型, 6=待入职, 7=已入职, 8=其它类型, 255=系统默认，后端模型中并没有该字段，仅用于前端显示, + type_ int // 1=筛选型，2=评估型，3=笔试型，4=面试型，5=Offer 型，6=待入职，7=已入职，8=其它类型，255=系统默认，后端模型中并没有该字段，仅用于前端显示， typeFlag bool } @@ -16815,7 +16815,7 @@ func (builder *JobProcessesStageBuilder) EnName(enName string) *JobProcessesStag return builder } -// 1=筛选型, 2=评估型, 3=笔试型, 4=面试型, 5=Offer型, 6=待入职, 7=已入职, 8=其它类型, 255=系统默认，后端模型中并没有该字段，仅用于前端显示, +// 1=筛选型，2=评估型，3=笔试型，4=面试型，5=Offer 型，6=待入职，7=已入职，8=其它类型，255=系统默认，后端模型中并没有该字段，仅用于前端显示， // // 示例值：1 func (builder *JobProcessesStageBuilder) Type(type_ int) *JobProcessesStageBuilder { @@ -16846,20 +16846,20 @@ func (builder *JobProcessesStageBuilder) Build() *JobProcessesStage { } type JobRecruiter2 struct { - Id *string `json:"id,omitempty"` // 职位ID - RecruiterId *string `json:"recruiter_id,omitempty"` // 招聘负责人ID - HiringManagerIdList []string `json:"hiring_manager_id_list,omitempty"` // 用人经理ID列表 - AssistantIdList []string `json:"assistant_id_list,omitempty"` // 协助人ID列表 + Id *string `json:"id,omitempty"` // 职位 ID + RecruiterId *string `json:"recruiter_id,omitempty"` // 招聘负责人 ID + HiringManagerIdList []string `json:"hiring_manager_id_list,omitempty"` // 用人经理 ID 列表 + AssistantIdList []string `json:"assistant_id_list,omitempty"` // 协助人 ID 列表 } type JobRecruiter2Builder struct { - id string // 职位ID + id string // 职位 ID idFlag bool - recruiterId string // 招聘负责人ID + recruiterId string // 招聘负责人 ID recruiterIdFlag bool - hiringManagerIdList []string // 用人经理ID列表 + hiringManagerIdList []string // 用人经理 ID 列表 hiringManagerIdListFlag bool - assistantIdList []string // 协助人ID列表 + assistantIdList []string // 协助人 ID 列表 assistantIdListFlag bool } @@ -16868,7 +16868,7 @@ func NewJobRecruiter2Builder() *JobRecruiter2Builder { return builder } -// 职位ID +// 职位 ID // // 示例值： func (builder *JobRecruiter2Builder) Id(id string) *JobRecruiter2Builder { @@ -16877,7 +16877,7 @@ func (builder *JobRecruiter2Builder) Id(id string) *JobRecruiter2Builder { return builder } -// 招聘负责人ID +// 招聘负责人 ID // // 示例值： func (builder *JobRecruiter2Builder) RecruiterId(recruiterId string) *JobRecruiter2Builder { @@ -16886,7 +16886,7 @@ func (builder *JobRecruiter2Builder) RecruiterId(recruiterId string) *JobRecruit return builder } -// 用人经理ID列表 +// 用人经理 ID 列表 // // 示例值： func (builder *JobRecruiter2Builder) HiringManagerIdList(hiringManagerIdList []string) *JobRecruiter2Builder { @@ -16895,7 +16895,7 @@ func (builder *JobRecruiter2Builder) HiringManagerIdList(hiringManagerIdList []s return builder } -// 协助人ID列表 +// 协助人 ID 列表 // // 示例值： func (builder *JobRecruiter2Builder) AssistantIdList(assistantIdList []string) *JobRecruiter2Builder { @@ -17354,13 +17354,13 @@ func (builder *JobRequirementBuilder) Build() *JobRequirement { type JobRequirementCustomizedData struct { ObjectId *string `json:"object_id,omitempty"` // 自定义字段 ID - Value *string `json:"value,omitempty"` // 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"；;3. 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"；;4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳；;5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳；;6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳；;7. 若字段类型为数字，传值格式为"1"; + Value *string `json:"value,omitempty"` // 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"；;3. 若字段类型为多选，传值内容为选项的 ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"；;4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳；;5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳；;6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳；;7. 若字段类型为数字，传值格式为"1"; } type JobRequirementCustomizedDataBuilder struct { objectId string // 自定义字段 ID objectIdFlag bool - value string // 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"；;3. 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"；;4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳；;5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳；;6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳；;7. 若字段类型为数字，传值格式为"1"; + value string // 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"；;3. 若字段类型为多选，传值内容为选项的 ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"；;4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳；;5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳；;6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳；;7. 若字段类型为数字，传值格式为"1"; valueFlag bool } @@ -17378,7 +17378,7 @@ func (builder *JobRequirementCustomizedDataBuilder) ObjectId(objectId string) *J return builder } -// 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"；;3. 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"；;4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳；;5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳；;6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳；;7. 若字段类型为数字，传值格式为"1"; +// 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"；;3. 若字段类型为多选，传值内容为选项的 ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"；;4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳；;5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳；;6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳；;7. 若字段类型为数字，传值格式为"1"; // // 示例值：测试 func (builder *JobRequirementCustomizedDataBuilder) Value(value string) *JobRequirementCustomizedDataBuilder { @@ -18672,23 +18672,23 @@ func (builder *NationalityBuilder) Build() *Nationality { } type Note struct { - Id *string `json:"id,omitempty"` // 备注ID - TalentId *string `json:"talent_id,omitempty"` // 人才ID - ApplicationId *string `json:"application_id,omitempty"` // 投递ID + Id *string `json:"id,omitempty"` // 备注 ID + TalentId *string `json:"talent_id,omitempty"` // 人才 ID + ApplicationId *string `json:"application_id,omitempty"` // 投递 ID IsPrivate *bool `json:"is_private,omitempty"` // 是否私密 CreateTime *int `json:"create_time,omitempty"` // 创建时间 ModifyTime *int `json:"modify_time,omitempty"` // 更新时间 - CreatorId *string `json:"creator_id,omitempty"` // 创建人ID + CreatorId *string `json:"creator_id,omitempty"` // 创建人 ID Content *string `json:"content,omitempty"` // 内容 Privacy *int `json:"privacy,omitempty"` // 备注私密属性（默认为公开） } type NoteBuilder struct { - id string // 备注ID + id string // 备注 ID idFlag bool - talentId string // 人才ID + talentId string // 人才 ID talentIdFlag bool - applicationId string // 投递ID + applicationId string // 投递 ID applicationIdFlag bool isPrivate bool // 是否私密 isPrivateFlag bool @@ -18696,7 +18696,7 @@ type NoteBuilder struct { createTimeFlag bool modifyTime int // 更新时间 modifyTimeFlag bool - creatorId string // 创建人ID + creatorId string // 创建人 ID creatorIdFlag bool content string // 内容 contentFlag bool @@ -18709,7 +18709,7 @@ func NewNoteBuilder() *NoteBuilder { return builder } -// 备注ID +// 备注 ID // // 示例值：6949805467799537964 func (builder *NoteBuilder) Id(id string) *NoteBuilder { @@ -18718,7 +18718,7 @@ func (builder *NoteBuilder) Id(id string) *NoteBuilder { return builder } -// 人才ID +// 人才 ID // // 示例值：6916472453069883661 func (builder *NoteBuilder) TalentId(talentId string) *NoteBuilder { @@ -18727,7 +18727,7 @@ func (builder *NoteBuilder) TalentId(talentId string) *NoteBuilder { return builder } -// 投递ID +// 投递 ID // // 示例值：6891565253964859661 func (builder *NoteBuilder) ApplicationId(applicationId string) *NoteBuilder { @@ -18763,7 +18763,7 @@ func (builder *NoteBuilder) ModifyTime(modifyTime int) *NoteBuilder { return builder } -// 创建人ID +// 创建人 ID // // 示例值：ou_f476cb099ac9227c9bae09ce46112579 func (builder *NoteBuilder) CreatorId(creatorId string) *NoteBuilder { @@ -19208,15 +19208,15 @@ func (builder *OfferApplyFormFormulaExtraMapInfoBuilder) Build() *OfferApplyForm } type OfferApplyFormInfo struct { - Id *string `json:"id,omitempty"` // offer申请表 ID - Name *I18n `json:"name,omitempty"` // offer申请表名称 + Id *string `json:"id,omitempty"` // offer 申请表 ID + Name *I18n `json:"name,omitempty"` // offer 申请表名称 Schema *OfferApplyFormSchema `json:"schema,omitempty"` // schema 信息，用于描述申请表单结构的元数据定义，即对申请表内容的描述 } type OfferApplyFormInfoBuilder struct { - id string // offer申请表 ID + id string // offer 申请表 ID idFlag bool - name *I18n // offer申请表名称 + name *I18n // offer 申请表名称 nameFlag bool schema *OfferApplyFormSchema // schema 信息，用于描述申请表单结构的元数据定义，即对申请表内容的描述 schemaFlag bool @@ -19227,7 +19227,7 @@ func NewOfferApplyFormInfoBuilder() *OfferApplyFormInfoBuilder { return builder } -// offer申请表 ID +// offer 申请表 ID // // 示例值：23746823748 func (builder *OfferApplyFormInfoBuilder) Id(id string) *OfferApplyFormInfoBuilder { @@ -19236,7 +19236,7 @@ func (builder *OfferApplyFormInfoBuilder) Id(id string) *OfferApplyFormInfoBuild return builder } -// offer申请表名称 +// offer 申请表名称 // // 示例值： func (builder *OfferApplyFormInfoBuilder) Name(name *I18n) *OfferApplyFormInfoBuilder { @@ -19891,13 +19891,13 @@ type OfferBasicInfo struct { ExpectedOnboardDate *string `json:"expected_onboard_date,omitempty"` // 预计入职日期 OnboardAddressId *string `json:"onboard_address_id,omitempty"` // 入职地点 ID WorkAddressId *string `json:"work_address_id,omitempty"` // 办公地点 ID - OwnerUserId *string `json:"owner_user_id,omitempty"` // Offer负责人 ID + OwnerUserId *string `json:"owner_user_id,omitempty"` // Offer 负责人 ID RecommendedWords *string `json:"recommended_words,omitempty"` // Offer 推荐语 JobRequirementId *string `json:"job_requirement_id,omitempty"` // 招聘需求 ID JobProcessTypeId *int `json:"job_process_type_id,omitempty"` // 招聘流程类型 ID - AttachmentIdList []string `json:"attachment_id_list,omitempty"` // 附件ID列表 + AttachmentIdList []string `json:"attachment_id_list,omitempty"` // 附件 ID 列表 AttachmentDescription *string `json:"attachment_description,omitempty"` // 附件描述 - OperatorUserId *string `json:"operator_user_id,omitempty"` // Offer操作人 ID + OperatorUserId *string `json:"operator_user_id,omitempty"` // Offer 操作人 ID } type OfferBasicInfoBuilder struct { @@ -19923,7 +19923,7 @@ type OfferBasicInfoBuilder struct { onboardAddressIdFlag bool workAddressId string // 办公地点 ID workAddressIdFlag bool - ownerUserId string // Offer负责人 ID + ownerUserId string // Offer 负责人 ID ownerUserIdFlag bool recommendedWords string // Offer 推荐语 recommendedWordsFlag bool @@ -19931,11 +19931,11 @@ type OfferBasicInfoBuilder struct { jobRequirementIdFlag bool jobProcessTypeId int // 招聘流程类型 ID jobProcessTypeIdFlag bool - attachmentIdList []string // 附件ID列表 + attachmentIdList []string // 附件 ID 列表 attachmentIdListFlag bool attachmentDescription string // 附件描述 attachmentDescriptionFlag bool - operatorUserId string // Offer操作人 ID + operatorUserId string // Offer 操作人 ID operatorUserIdFlag bool } @@ -20043,7 +20043,7 @@ func (builder *OfferBasicInfoBuilder) WorkAddressId(workAddressId string) *Offer return builder } -// Offer负责人 ID +// Offer 负责人 ID // // 示例值：ou_ce613028fe74745421f5dc320bb9c709 func (builder *OfferBasicInfoBuilder) OwnerUserId(ownerUserId string) *OfferBasicInfoBuilder { @@ -20079,7 +20079,7 @@ func (builder *OfferBasicInfoBuilder) JobProcessTypeId(jobProcessTypeId int) *Of return builder } -// 附件ID列表 +// 附件 ID 列表 // // 示例值：["7081582717280831752"] func (builder *OfferBasicInfoBuilder) AttachmentIdList(attachmentIdList []string) *OfferBasicInfoBuilder { @@ -20097,7 +20097,7 @@ func (builder *OfferBasicInfoBuilder) AttachmentDescription(attachmentDescriptio return builder } -// Offer操作人 ID +// Offer 操作人 ID // // 示例值：ou_ce613028fe74745421f5dc320bb9c709 func (builder *OfferBasicInfoBuilder) OperatorUserId(operatorUserId string) *OfferBasicInfoBuilder { @@ -20357,7 +20357,7 @@ func (builder *OfferCustomizedInfoBuilder) Build() *OfferCustomizedInfo { type OfferInfo struct { OfferId *string `json:"offer_id,omitempty"` // Offer ID ApplicationId *string `json:"application_id,omitempty"` // 投递 ID - SchemaId *string `json:"schema_id,omitempty"` // Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取Offer申请表模板信息」接口中获取 + SchemaId *string `json:"schema_id,omitempty"` // Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取 Offer 申请表模板信息」接口中获取 OfferType *int `json:"offer_type,omitempty"` // Offer 类型 BasicInfo *OfferBasicInfo `json:"basic_info,omitempty"` // Offer 基本信息 SalaryInfo *OfferSalaryInfo `json:"salary_info,omitempty"` // Offer 薪资信息 @@ -20369,7 +20369,7 @@ type OfferInfoBuilder struct { offerIdFlag bool applicationId string // 投递 ID applicationIdFlag bool - schemaId string // Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取Offer申请表模板信息」接口中获取 + schemaId string // Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取 Offer 申请表模板信息」接口中获取 schemaIdFlag bool offerType int // Offer 类型 offerTypeFlag bool @@ -20404,7 +20404,7 @@ func (builder *OfferInfoBuilder) ApplicationId(applicationId string) *OfferInfoB return builder } -// Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取Offer申请表模板信息」接口中获取 +// Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取 Offer 申请表模板信息」接口中获取 // // 示例值：7013318077945596204 func (builder *OfferInfoBuilder) SchemaId(schemaId string) *OfferInfoBuilder { @@ -20782,16 +20782,16 @@ func (builder *OfferSalaryInfoBuilder) Build() *OfferSalaryInfo { } type OfferSchema struct { - Id *string `json:"id,omitempty"` // offer申请表ID - Scenario *int `json:"scenario,omitempty"` // offer申请表使用场景 + Id *string `json:"id,omitempty"` // offer 申请表 ID + Scenario *int `json:"scenario,omitempty"` // offer 申请表使用场景 Version *int `json:"version,omitempty"` // 申请表版本 ObjectList []*OfferSchemaDetail `json:"object_list,omitempty"` // 字段对象信息 } type OfferSchemaBuilder struct { - id string // offer申请表ID + id string // offer 申请表 ID idFlag bool - scenario int // offer申请表使用场景 + scenario int // offer 申请表使用场景 scenarioFlag bool version int // 申请表版本 versionFlag bool @@ -20804,7 +20804,7 @@ func NewOfferSchemaBuilder() *OfferSchemaBuilder { return builder } -// offer申请表ID +// offer 申请表 ID // // 示例值：1213213123123 func (builder *OfferSchemaBuilder) Id(id string) *OfferSchemaBuilder { @@ -20813,7 +20813,7 @@ func (builder *OfferSchemaBuilder) Id(id string) *OfferSchemaBuilder { return builder } -// offer申请表使用场景 +// offer 申请表使用场景 // // 示例值：1 func (builder *OfferSchemaBuilder) Scenario(scenario int) *OfferSchemaBuilder { @@ -20861,16 +20861,16 @@ func (builder *OfferSchemaBuilder) Build() *OfferSchema { } type OfferSchemaChild struct { - Id *string `json:"id,omitempty"` // offer申请表ID - Scenario *int `json:"scenario,omitempty"` // offer申请表使用场景 + Id *string `json:"id,omitempty"` // offer 申请表 ID + Scenario *int `json:"scenario,omitempty"` // offer 申请表使用场景 Version *int `json:"version,omitempty"` // 申请表版本 ObjectList []*OfferSchemaDetail `json:"object_list,omitempty"` // 字段对象信息 } type OfferSchemaChildBuilder struct { - id string // offer申请表ID + id string // offer 申请表 ID idFlag bool - scenario int // offer申请表使用场景 + scenario int // offer 申请表使用场景 scenarioFlag bool version int // 申请表版本 versionFlag bool @@ -20883,7 +20883,7 @@ func NewOfferSchemaChildBuilder() *OfferSchemaChildBuilder { return builder } -// offer申请表ID +// offer 申请表 ID // // 示例值：1213213123123 func (builder *OfferSchemaChildBuilder) Id(id string) *OfferSchemaChildBuilder { @@ -20892,7 +20892,7 @@ func (builder *OfferSchemaChildBuilder) Id(id string) *OfferSchemaChildBuilder { return builder } -// offer申请表使用场景 +// offer 申请表使用场景 // // 示例值：1 func (builder *OfferSchemaChildBuilder) Scenario(scenario int) *OfferSchemaChildBuilder { @@ -20940,19 +20940,19 @@ func (builder *OfferSchemaChildBuilder) Build() *OfferSchemaChild { } type OfferSchemaDetail struct { - Id *string `json:"id,omitempty"` // 字段ID + Id *string `json:"id,omitempty"` // 字段 ID Name *OfferSchemaName `json:"name,omitempty"` // 字段名称 - Type *string `json:"type,omitempty"` // 字段类型, text=单行文本, long_text=多行文本, select=单选, multi_select=多选, date_select=日期, number=数字 + Type *string `json:"type,omitempty"` // 字段类型，text=单行文本，long_text=多行文本，select=单选，multi_select=多选，date_select=日期，number=数字 IsCustomized *bool `json:"is_customized,omitempty"` // 字段是否为自定义 OptionList []*OfferSchemaDetailOption `json:"option_list,omitempty"` // 单选/多选可选择字段的选项值 } type OfferSchemaDetailBuilder struct { - id string // 字段ID + id string // 字段 ID idFlag bool name *OfferSchemaName // 字段名称 nameFlag bool - type_ string // 字段类型, text=单行文本, long_text=多行文本, select=单选, multi_select=多选, date_select=日期, number=数字 + type_ string // 字段类型，text=单行文本，long_text=多行文本，select=单选，multi_select=多选，date_select=日期，number=数字 typeFlag bool isCustomized bool // 字段是否为自定义 isCustomizedFlag bool @@ -20965,7 +20965,7 @@ func NewOfferSchemaDetailBuilder() *OfferSchemaDetailBuilder { return builder } -// 字段ID +// 字段 ID // // 示例值：1213213123123 func (builder *OfferSchemaDetailBuilder) Id(id string) *OfferSchemaDetailBuilder { @@ -20983,7 +20983,7 @@ func (builder *OfferSchemaDetailBuilder) Name(name *OfferSchemaName) *OfferSchem return builder } -// 字段类型, text=单行文本, long_text=多行文本, select=单选, multi_select=多选, date_select=日期, number=数字 +// 字段类型，text=单行文本，long_text=多行文本，select=单选，multi_select=多选，date_select=日期，number=数字 // // 示例值：number func (builder *OfferSchemaDetailBuilder) Type(type_ string) *OfferSchemaDetailBuilder { @@ -21097,11 +21097,11 @@ func (builder *OfferSchemaDetailOptionBuilder) Build() *OfferSchemaDetailOption } type OfferSchemaListInfo struct { - SchemaList []*OfferSchemaChild `json:"schema_list,omitempty"` // offer申请表列表 + SchemaList []*OfferSchemaChild `json:"schema_list,omitempty"` // offer 申请表列表 } type OfferSchemaListInfoBuilder struct { - schemaList []*OfferSchemaChild // offer申请表列表 + schemaList []*OfferSchemaChild // offer 申请表列表 schemaListFlag bool } @@ -21110,7 +21110,7 @@ func NewOfferSchemaListInfoBuilder() *OfferSchemaListInfoBuilder { return builder } -// offer申请表列表 +// offer 申请表列表 // // 示例值： func (builder *OfferSchemaListInfoBuilder) SchemaList(schemaList []*OfferSchemaChild) *OfferSchemaListInfoBuilder { @@ -21234,8 +21234,8 @@ type PortalJobPost struct { JobDepartment *IdNameObject `json:"job_department,omitempty"` // 职位部门 JobType *IdNameObject `json:"job_type,omitempty"` // 职位类型 Address *CommonAddress `json:"address,omitempty"` // 职位地址 - MinSalary *string `json:"min_salary,omitempty"` // 月薪范围-最低薪资 - MaxSalary *string `json:"max_salary,omitempty"` // 月薪范围-最高薪资 + MinSalary *string `json:"min_salary,omitempty"` // 月薪范围 - 最低薪资 + MaxSalary *string `json:"max_salary,omitempty"` // 月薪范围 - 最高薪资 RequiredDegree *int `json:"required_degree,omitempty"` // 学历要求 Experience *int `json:"experience,omitempty"` // 经验 Headcount *int `json:"headcount,omitempty"` // 数量 @@ -21274,9 +21274,9 @@ type PortalJobPostBuilder struct { jobTypeFlag bool address *CommonAddress // 职位地址 addressFlag bool - minSalary string // 月薪范围-最低薪资 + minSalary string // 月薪范围 - 最低薪资 minSalaryFlag bool - maxSalary string // 月薪范围-最高薪资 + maxSalary string // 月薪范围 - 最高薪资 maxSalaryFlag bool requiredDegree int // 学历要求 requiredDegreeFlag bool @@ -21410,7 +21410,7 @@ func (builder *PortalJobPostBuilder) Address(address *CommonAddress) *PortalJobP return builder } -// 月薪范围-最低薪资 +// 月薪范围 - 最低薪资 // // 示例值：5000 func (builder *PortalJobPostBuilder) MinSalary(minSalary string) *PortalJobPostBuilder { @@ -21419,7 +21419,7 @@ func (builder *PortalJobPostBuilder) MinSalary(minSalary string) *PortalJobPostB return builder } -// 月薪范围-最高薪资 +// 月薪范围 - 最高薪资 // // 示例值：10000 func (builder *PortalJobPostBuilder) MaxSalary(maxSalary string) *PortalJobPostBuilder { @@ -22650,12 +22650,12 @@ func (builder *SequenceBuilder) Build() *Sequence { } type Site struct { - Id *string `json:"id,omitempty"` // 官网id + Id *string `json:"id,omitempty"` // 官网 id Name *SiteName `json:"name,omitempty"` // 官网名称 } type SiteBuilder struct { - id string // 官网id + id string // 官网 id idFlag bool name *SiteName // 官网名称 nameFlag bool @@ -22666,7 +22666,7 @@ func NewSiteBuilder() *SiteBuilder { return builder } -// 官网id +// 官网 id // // 示例值： func (builder *SiteBuilder) Id(id string) *SiteBuilder { @@ -22697,16 +22697,16 @@ func (builder *SiteBuilder) Build() *Site { } type SiteApplication struct { - ExternalId *string `json:"external_id,omitempty"` // 外部id，用于转换内部id - JobPostId *string `json:"job_post_id,omitempty"` // 职位id + ExternalId *string `json:"external_id,omitempty"` // 外部 id，用于转换内部 id + JobPostId *string `json:"job_post_id,omitempty"` // 职位 id Resume *SiteApplicationResume `json:"resume,omitempty"` // 简历信息 Status *string `json:"status,omitempty"` // 投递状态 } type SiteApplicationBuilder struct { - externalId string // 外部id，用于转换内部id + externalId string // 外部 id，用于转换内部 id externalIdFlag bool - jobPostId string // 职位id + jobPostId string // 职位 id jobPostIdFlag bool resume *SiteApplicationResume // 简历信息 resumeFlag bool @@ -22719,7 +22719,7 @@ func NewSiteApplicationBuilder() *SiteApplicationBuilder { return builder } -// 外部id，用于转换内部id +// 外部 id，用于转换内部 id // // 示例值： func (builder *SiteApplicationBuilder) ExternalId(externalId string) *SiteApplicationBuilder { @@ -22728,7 +22728,7 @@ func (builder *SiteApplicationBuilder) ExternalId(externalId string) *SiteApplic return builder } -// 职位id +// 职位 id // // 示例值： func (builder *SiteApplicationBuilder) JobPostId(jobPostId string) *SiteApplicationBuilder { @@ -22776,12 +22776,12 @@ func (builder *SiteApplicationBuilder) Build() *SiteApplication { } type SiteJobCity struct { - CityCode *string `json:"city_code,omitempty"` // 地址code + CityCode *string `json:"city_code,omitempty"` // 地址 code Name *SiteName `json:"name,omitempty"` // 地址名称 } type SiteJobCityBuilder struct { - cityCode string // 地址code + cityCode string // 地址 code cityCodeFlag bool name *SiteName // 地址名称 nameFlag bool @@ -22792,7 +22792,7 @@ func NewSiteJobCityBuilder() *SiteJobCityBuilder { return builder } -// 地址code +// 地址 code // // 示例值： func (builder *SiteJobCityBuilder) CityCode(cityCode string) *SiteJobCityBuilder { @@ -22823,7 +22823,7 @@ func (builder *SiteJobCityBuilder) Build() *SiteJobCity { } type SiteJobPost struct { - Id *string `json:"id,omitempty"` // 职位id + Id *string `json:"id,omitempty"` // 职位 id Title *string `json:"title,omitempty"` // 职位名称 Description *string `json:"description,omitempty"` // 职位描述 Requirement *string `json:"requirement,omitempty"` // 职位要求 @@ -22834,7 +22834,7 @@ type SiteJobPost struct { } type SiteJobPostBuilder struct { - id string // 职位id + id string // 职位 id idFlag bool title string // 职位名称 titleFlag bool @@ -22857,7 +22857,7 @@ func NewSiteJobPostBuilder() *SiteJobPostBuilder { return builder } -// 职位id +// 职位 id // // 示例值： func (builder *SiteJobPostBuilder) Id(id string) *SiteJobPostBuilder { @@ -22964,12 +22964,12 @@ func (builder *SiteJobPostBuilder) Build() *SiteJobPost { } type SiteJobType struct { - Id *string `json:"id,omitempty"` // 职能id + Id *string `json:"id,omitempty"` // 职能 id Name *SiteName `json:"name,omitempty"` // 职位职能名称 } type SiteJobTypeBuilder struct { - id string // 职能id + id string // 职能 id idFlag bool name *SiteName // 职位职能名称 nameFlag bool @@ -22980,7 +22980,7 @@ func NewSiteJobTypeBuilder() *SiteJobTypeBuilder { return builder } -// 职能id +// 职能 id // // 示例值： func (builder *SiteJobTypeBuilder) Id(id string) *SiteJobTypeBuilder { @@ -23015,7 +23015,7 @@ type SiteApplicationResume struct { MobileNumber *string `json:"mobile_number,omitempty"` // 手机号 MoblieCode *string `json:"moblie_code,omitempty"` // 手机区号 Email *string `json:"email,omitempty"` // 邮箱 - SiteAttachmentId *string `json:"site_attachment_id,omitempty"` // 简历附件id + SiteAttachmentId *string `json:"site_attachment_id,omitempty"` // 简历附件 id SelfEvaluation *string `json:"self_evaluation,omitempty"` // 自我评价 Age *string `json:"age,omitempty"` // 年龄 WorkingYear *string `json:"working_year,omitempty"` // 工作年限 @@ -23041,7 +23041,7 @@ type SiteApplicationResumeBuilder struct { moblieCodeFlag bool email string // 邮箱 emailFlag bool - siteAttachmentId string // 简历附件id + siteAttachmentId string // 简历附件 id siteAttachmentIdFlag bool selfEvaluation string // 自我评价 selfEvaluationFlag bool @@ -23114,7 +23114,7 @@ func (builder *SiteApplicationResumeBuilder) Email(email string) *SiteApplicatio return builder } -// 简历附件id +// 简历附件 id // // 示例值： func (builder *SiteApplicationResumeBuilder) SiteAttachmentId(siteAttachmentId string) *SiteApplicationResumeBuilder { @@ -23368,25 +23368,25 @@ func (builder *SiteJobPostSearchInfoBuilder) Build() *SiteJobPostSearchInfo { type SiteJobPostSearchRequest struct { Keyword *string `json:"keyword,omitempty"` // 搜索关键字 - Offset *int `json:"offset,omitempty"` // 分页用的偏移量，默认0 - Limit *int `json:"limit,omitempty"` // 分页用的分页条数，最大100 - JobTypeIdList []string `json:"job_type_id_list,omitempty"` // 职能列表返回的id - CityCodeList []string `json:"city_code_list,omitempty"` // 地址列表返回的code - SiteId *string `json:"site_id,omitempty"` // 官网id，不传则查询默认官网 + Offset *int `json:"offset,omitempty"` // 分页用的偏移量，默认 0 + Limit *int `json:"limit,omitempty"` // 分页用的分页条数，最大 100 + JobTypeIdList []string `json:"job_type_id_list,omitempty"` // 职能列表返回的 id + CityCodeList []string `json:"city_code_list,omitempty"` // 地址列表返回的 code + SiteId *string `json:"site_id,omitempty"` // 官网 id，不传则查询默认官网 } type SiteJobPostSearchRequestBuilder struct { keyword string // 搜索关键字 keywordFlag bool - offset int // 分页用的偏移量，默认0 + offset int // 分页用的偏移量，默认 0 offsetFlag bool - limit int // 分页用的分页条数，最大100 + limit int // 分页用的分页条数，最大 100 limitFlag bool - jobTypeIdList []string // 职能列表返回的id + jobTypeIdList []string // 职能列表返回的 id jobTypeIdListFlag bool - cityCodeList []string // 地址列表返回的code + cityCodeList []string // 地址列表返回的 code cityCodeListFlag bool - siteId string // 官网id，不传则查询默认官网 + siteId string // 官网 id，不传则查询默认官网 siteIdFlag bool } @@ -23404,7 +23404,7 @@ func (builder *SiteJobPostSearchRequestBuilder) Keyword(keyword string) *SiteJob return builder } -// 分页用的偏移量，默认0 +// 分页用的偏移量，默认 0 // // 示例值： func (builder *SiteJobPostSearchRequestBuilder) Offset(offset int) *SiteJobPostSearchRequestBuilder { @@ -23413,7 +23413,7 @@ func (builder *SiteJobPostSearchRequestBuilder) Offset(offset int) *SiteJobPostS return builder } -// 分页用的分页条数，最大100 +// 分页用的分页条数，最大 100 // // 示例值： func (builder *SiteJobPostSearchRequestBuilder) Limit(limit int) *SiteJobPostSearchRequestBuilder { @@ -23422,7 +23422,7 @@ func (builder *SiteJobPostSearchRequestBuilder) Limit(limit int) *SiteJobPostSea return builder } -// 职能列表返回的id +// 职能列表返回的 id // // 示例值： func (builder *SiteJobPostSearchRequestBuilder) JobTypeIdList(jobTypeIdList []string) *SiteJobPostSearchRequestBuilder { @@ -23431,7 +23431,7 @@ func (builder *SiteJobPostSearchRequestBuilder) JobTypeIdList(jobTypeIdList []st return builder } -// 地址列表返回的code +// 地址列表返回的 code // // 示例值： func (builder *SiteJobPostSearchRequestBuilder) CityCodeList(cityCodeList []string) *SiteJobPostSearchRequestBuilder { @@ -23440,7 +23440,7 @@ func (builder *SiteJobPostSearchRequestBuilder) CityCodeList(cityCodeList []stri return builder } -// 官网id，不传则查询默认官网 +// 官网 id，不传则查询默认官网 // // 示例值： func (builder *SiteJobPostSearchRequestBuilder) SiteId(siteId string) *SiteJobPostSearchRequestBuilder { @@ -23477,12 +23477,12 @@ func (builder *SiteJobPostSearchRequestBuilder) Build() *SiteJobPostSearchReques } type SiteJobRecruitmentType struct { - Id *string `json:"id,omitempty"` // 雇佣类型id + Id *string `json:"id,omitempty"` // 雇佣类型 id Name *SiteName `json:"name,omitempty"` // 雇佣类型名称 } type SiteJobRecruitmentTypeBuilder struct { - id string // 雇佣类型id + id string // 雇佣类型 id idFlag bool name *SiteName // 雇佣类型名称 nameFlag bool @@ -23493,7 +23493,7 @@ func NewSiteJobRecruitmentTypeBuilder() *SiteJobRecruitmentTypeBuilder { return builder } -// 雇佣类型id +// 雇佣类型 id // // 示例值： func (builder *SiteJobRecruitmentTypeBuilder) Id(id string) *SiteJobRecruitmentTypeBuilder { @@ -24310,7 +24310,7 @@ func (builder *SiteResumeSnsBuilder) Build() *SiteResumeSns { type SiteResumeWork struct { Link *string `json:"link,omitempty"` // 作品链接 Description *string `json:"description,omitempty"` // 描述 - SiteAttachmentId *string `json:"site_attachment_id,omitempty"` // 作品附件id + SiteAttachmentId *string `json:"site_attachment_id,omitempty"` // 作品附件 id } type SiteResumeWorkBuilder struct { @@ -24318,7 +24318,7 @@ type SiteResumeWorkBuilder struct { linkFlag bool description string // 描述 descriptionFlag bool - siteAttachmentId string // 作品附件id + siteAttachmentId string // 作品附件 id siteAttachmentIdFlag bool } @@ -24345,7 +24345,7 @@ func (builder *SiteResumeWorkBuilder) Description(description string) *SiteResum return builder } -// 作品附件id +// 作品附件 id // // 示例值： func (builder *SiteResumeWorkBuilder) SiteAttachmentId(siteAttachmentId string) *SiteResumeWorkBuilder { @@ -24372,14 +24372,14 @@ func (builder *SiteResumeWorkBuilder) Build() *SiteResumeWork { } type SnsInfo struct { - Link *string `json:"link,omitempty"` // SNS链接 - SnsType *int `json:"sns_type,omitempty"` // SNS类型 + Link *string `json:"link,omitempty"` // SNS 链接 + SnsType *int `json:"sns_type,omitempty"` // SNS 类型 } type SnsInfoBuilder struct { - link string // SNS链接 + link string // SNS 链接 linkFlag bool - snsType int // SNS类型 + snsType int // SNS 类型 snsTypeFlag bool } @@ -24388,7 +24388,7 @@ func NewSnsInfoBuilder() *SnsInfoBuilder { return builder } -// SNS链接 +// SNS 链接 // // 示例值： func (builder *SnsInfoBuilder) Link(link string) *SnsInfoBuilder { @@ -24397,7 +24397,7 @@ func (builder *SnsInfoBuilder) Link(link string) *SnsInfoBuilder { return builder } -// SNS类型 +// SNS 类型 // // 示例值： func (builder *SnsInfoBuilder) SnsType(snsType int) *SnsInfoBuilder { @@ -24530,7 +24530,7 @@ func (builder *SubjectBuilder) Build() *Subject { } type Talent struct { - Id *string `json:"id,omitempty"` // 人才ID + Id *string `json:"id,omitempty"` // 人才 ID IsInAgencyPeriod *bool `json:"is_in_agency_period,omitempty"` // 是否在猎头保护期 IsOnboarded *bool `json:"is_onboarded,omitempty"` // 是否已入职 BasicInfo *TalentBasicInfo `json:"basic_info,omitempty"` // 基础信息 @@ -24543,13 +24543,13 @@ type Talent struct { SnsList []*TalentSnsInfo `json:"sns_list,omitempty"` // 社交账号 ResumeSourceList []*TalentResumeSource `json:"resume_source_list,omitempty"` // 简历来源 InterviewRegistrationList []*TalentInterviewRegistrationSimple `json:"interview_registration_list,omitempty"` // 面试登记表 - ResumeAttachmentIdList []string `json:"resume_attachment_id_list,omitempty"` // 简历附件id列表（按照简历创建时间降序） + ResumeAttachmentIdList []string `json:"resume_attachment_id_list,omitempty"` // 简历附件 id 列表（按照简历创建时间降序） CustomizedDataList []*TalentCustomizedData `json:"customized_data_list,omitempty"` // 自定义模块 TopDegree *int `json:"top_degree,omitempty"` // 最高学历 } type TalentBuilder struct { - id string // 人才ID + id string // 人才 ID idFlag bool isInAgencyPeriod bool // 是否在猎头保护期 isInAgencyPeriodFlag bool @@ -24575,7 +24575,7 @@ type TalentBuilder struct { resumeSourceListFlag bool interviewRegistrationList []*TalentInterviewRegistrationSimple // 面试登记表 interviewRegistrationListFlag bool - resumeAttachmentIdList []string // 简历附件id列表（按照简历创建时间降序） + resumeAttachmentIdList []string // 简历附件 id 列表（按照简历创建时间降序） resumeAttachmentIdListFlag bool customizedDataList []*TalentCustomizedData // 自定义模块 customizedDataListFlag bool @@ -24588,7 +24588,7 @@ func NewTalentBuilder() *TalentBuilder { return builder } -// 人才ID +// 人才 ID // // 示例值：6891560630172518670 func (builder *TalentBuilder) Id(id string) *TalentBuilder { @@ -24705,7 +24705,7 @@ func (builder *TalentBuilder) InterviewRegistrationList(interviewRegistrationLis return builder } -// 简历附件id列表（按照简历创建时间降序） +// 简历附件 id 列表（按照简历创建时间降序） // // 示例值： func (builder *TalentBuilder) ResumeAttachmentIdList(resumeAttachmentIdList []string) *TalentBuilder { @@ -25125,7 +25125,7 @@ func (builder *TalentBasicInfoBuilder) MaritalStatus(maritalStatus int) *TalentB // 家庭住址 // -// 示例值：南京路1号 +// 示例值：南京路 1 号 func (builder *TalentBasicInfoBuilder) CurrentHomeAddress(currentHomeAddress string) *TalentBasicInfoBuilder { builder.currentHomeAddress = currentHomeAddress builder.currentHomeAddressFlag = true @@ -26505,7 +26505,7 @@ func (builder *TalentCombinedProjectInfoBuilder) Build() *TalentCombinedProjectI type TalentCombinedSnsInfo struct { Id *string `json:"id,omitempty"` // ID - SnsType *int `json:"sns_type,omitempty"` // SNS名称 + SnsType *int `json:"sns_type,omitempty"` // SNS 名称 Link *string `json:"link,omitempty"` // URL/ID CustomizedData []*TalentCustomizedDataObjectValue `json:"customized_data,omitempty"` // 自定义字段 } @@ -26513,7 +26513,7 @@ type TalentCombinedSnsInfo struct { type TalentCombinedSnsInfoBuilder struct { id string // ID idFlag bool - snsType int // SNS名称 + snsType int // SNS 名称 snsTypeFlag bool link string // URL/ID linkFlag bool @@ -26535,7 +26535,7 @@ func (builder *TalentCombinedSnsInfoBuilder) Id(id string) *TalentCombinedSnsInf return builder } -// SNS名称 +// SNS 名称 // // 示例值：1 func (builder *TalentCombinedSnsInfoBuilder) SnsType(snsType int) *TalentCombinedSnsInfoBuilder { @@ -26720,7 +26720,7 @@ func (builder *TalentCompetitionInfoBuilder) Name(name string) *TalentCompetitio // 竞赛描述 // -// 示例值：C++竞赛 +// 示例值：C++ 竞赛 func (builder *TalentCompetitionInfoBuilder) Desc(desc string) *TalentCompetitionInfoBuilder { builder.desc = desc builder.descFlag = true @@ -26790,7 +26790,7 @@ func (builder *TalentCustomizedAttachmentBuilder) FileId(fileId string) *TalentC // 附件名称 // -// 示例值：1.13测试1的面试记录.pdf +// 示例值：1.13 测试 1 的面试记录.pdf func (builder *TalentCustomizedAttachmentBuilder) FileName(fileName string) *TalentCustomizedAttachmentBuilder { builder.fileName = fileName builder.fileNameFlag = true @@ -27529,26 +27529,26 @@ func (builder *TalentExternalInfoBuilder) Build() *TalentExternalInfo { } type TalentFolder struct { - ExternalId *string `json:"external_id,omitempty"` // 外部ID + ExternalId *string `json:"external_id,omitempty"` // 外部 ID Name *string `json:"name,omitempty"` // 名字 - ParentId *string `json:"parent_id,omitempty"` // 父ID + ParentId *string `json:"parent_id,omitempty"` // 父 ID CreatorId *string `json:"creator_id,omitempty"` // 创建人 ID - FolderId *string `json:"folder_id,omitempty"` // 文件夹ID - OwnerId *string `json:"owner_id,omitempty"` // 所有者ID + FolderId *string `json:"folder_id,omitempty"` // 文件夹 ID + OwnerId *string `json:"owner_id,omitempty"` // 所有者 ID } type TalentFolderBuilder struct { - externalId string // 外部ID + externalId string // 外部 ID externalIdFlag bool name string // 名字 nameFlag bool - parentId string // 父ID + parentId string // 父 ID parentIdFlag bool creatorId string // 创建人 ID creatorIdFlag bool - folderId string // 文件夹ID + folderId string // 文件夹 ID folderIdFlag bool - ownerId string // 所有者ID + ownerId string // 所有者 ID ownerIdFlag bool } @@ -27557,7 +27557,7 @@ func NewTalentFolderBuilder() *TalentFolderBuilder { return builder } -// 外部ID +// 外部 ID // // 示例值： func (builder *TalentFolderBuilder) ExternalId(externalId string) *TalentFolderBuilder { @@ -27568,14 +27568,14 @@ func (builder *TalentFolderBuilder) ExternalId(externalId string) *TalentFolderB // 名字 // -// 示例值：人才文件夹A1 +// 示例值：人才文件夹 A1 func (builder *TalentFolderBuilder) Name(name string) *TalentFolderBuilder { builder.name = name builder.nameFlag = true return builder } -// 父ID +// 父 ID // // 示例值： func (builder *TalentFolderBuilder) ParentId(parentId string) *TalentFolderBuilder { @@ -27593,7 +27593,7 @@ func (builder *TalentFolderBuilder) CreatorId(creatorId string) *TalentFolderBui return builder } -// 文件夹ID +// 文件夹 ID // // 示例值：7041806543797995820 func (builder *TalentFolderBuilder) FolderId(folderId string) *TalentFolderBuilder { @@ -27602,7 +27602,7 @@ func (builder *TalentFolderBuilder) FolderId(folderId string) *TalentFolderBuild return builder } -// 所有者ID +// 所有者 ID // // 示例值：ou_85bb308c57f597471cd2bb5b4f580245 func (builder *TalentFolderBuilder) OwnerId(ownerId string) *TalentFolderBuilder { @@ -27695,7 +27695,7 @@ type TalentInternshipInfo struct { EndTime *int `json:"end_time,omitempty"` // 结束时间 StartTime *int `json:"start_time,omitempty"` // 开始时间 Title *string `json:"title,omitempty"` // 职称 - TagList []int `json:"tag_list,omitempty"` // 标记, 只会出现学校部分 + TagList []int `json:"tag_list,omitempty"` // 标记，只会出现学校部分 } type TalentInternshipInfoBuilder struct { @@ -27711,7 +27711,7 @@ type TalentInternshipInfoBuilder struct { startTimeFlag bool title string // 职称 titleFlag bool - tagList []int // 标记, 只会出现学校部分 + tagList []int // 标记，只会出现学校部分 tagListFlag bool } @@ -27774,7 +27774,7 @@ func (builder *TalentInternshipInfoBuilder) Title(title string) *TalentInternshi return builder } -// 标记, 只会出现学校部分 +// 标记，只会出现学校部分 // // 示例值： func (builder *TalentInternshipInfoBuilder) TagList(tagList []int) *TalentInternshipInfoBuilder { @@ -28721,7 +28721,7 @@ func (builder *TalentSelfEvaluationBuilder) Build() *TalentSelfEvaluation { type TalentSnsInfo struct { Id *string `json:"id,omitempty"` // ID - SnsType *int `json:"sns_type,omitempty"` // SNS名称 + SnsType *int `json:"sns_type,omitempty"` // SNS 名称 Link *string `json:"link,omitempty"` // URL/ID CustomizedDataList []*TalentCustomizedDataChild `json:"customized_data_list,omitempty"` // 自定义字段 } @@ -28729,7 +28729,7 @@ type TalentSnsInfo struct { type TalentSnsInfoBuilder struct { id string // ID idFlag bool - snsType int // SNS名称 + snsType int // SNS 名称 snsTypeFlag bool link string // URL/ID linkFlag bool @@ -28751,7 +28751,7 @@ func (builder *TalentSnsInfoBuilder) Id(id string) *TalentSnsInfoBuilder { return builder } -// SNS名称 +// SNS 名称 // // 示例值：1 func (builder *TalentSnsInfoBuilder) SnsType(snsType int) *TalentSnsInfoBuilder { @@ -28853,7 +28853,7 @@ func (builder *TalentWorksInfoBuilder) Desc(desc string) *TalentWorksInfoBuilder // 作品附件名称，若需获取作品附件预览信息可调用「获取附件预览信息」接口 // -// 示例值：XX项目 +// 示例值：XX 项目 func (builder *TalentWorksInfoBuilder) Name(name string) *TalentWorksInfoBuilder { builder.name = name builder.nameFlag = true @@ -29607,7 +29607,7 @@ type Website struct { Id *string `json:"id,omitempty"` // ID Name *I18n `json:"name,omitempty"` // 名称 ProcessTypeList []string `json:"process_type_list,omitempty"` // 流程类型，1-社招，2-校招 - JobChannelId *string `json:"job_channel_id,omitempty"` // 职位渠道ID + JobChannelId *string `json:"job_channel_id,omitempty"` // 职位渠道 ID } type WebsiteBuilder struct { @@ -29617,7 +29617,7 @@ type WebsiteBuilder struct { nameFlag bool processTypeList []string // 流程类型，1-社招，2-校招 processTypeListFlag bool - jobChannelId string // 职位渠道ID + jobChannelId string // 职位渠道 ID jobChannelIdFlag bool } @@ -29653,7 +29653,7 @@ func (builder *WebsiteBuilder) ProcessTypeList(processTypeList []string) *Websit return builder } -// 职位渠道ID +// 职位渠道 ID // // 示例值：1213213123123 func (builder *WebsiteBuilder) JobChannelId(jobChannelId string) *WebsiteBuilder { @@ -30095,7 +30095,7 @@ func (builder *WebsiteDeliveryAwardBuilder) CustomizedData(customizedData []*Web // 描述 // -// 示例值：ACM国际大学生程序设计竞赛 +// 示例值：ACM 国际大学生程序设计竞赛 func (builder *WebsiteDeliveryAwardBuilder) Desc(desc string) *WebsiteDeliveryAwardBuilder { builder.desc = desc builder.descFlag = true @@ -30443,7 +30443,7 @@ func (builder *WebsiteDeliveryBasicInfoBuilder) Build() *WebsiteDeliveryBasicInf type WebsiteDeliveryCareer struct { Desc *string `json:"desc,omitempty"` // 描述 - EndTime *int `json:"end_time,omitempty"` // 结束时间, 如果是至今传值 -1 + EndTime *int `json:"end_time,omitempty"` // 结束时间，如果是至今传值 -1 StartTime *int `json:"start_time,omitempty"` // 开始时间 Title *string `json:"title,omitempty"` // 职位名称 Company *string `json:"company,omitempty"` // 公司 @@ -30453,7 +30453,7 @@ type WebsiteDeliveryCareer struct { type WebsiteDeliveryCareerBuilder struct { desc string // 描述 descFlag bool - endTime int // 结束时间, 如果是至今传值 -1 + endTime int // 结束时间，如果是至今传值 -1 endTimeFlag bool startTime int // 开始时间 startTimeFlag bool @@ -30479,7 +30479,7 @@ func (builder *WebsiteDeliveryCareerBuilder) Desc(desc string) *WebsiteDeliveryC return builder } -// 结束时间, 如果是至今传值 -1 +// 结束时间，如果是至今传值 -1 // // 示例值：1618500278667 func (builder *WebsiteDeliveryCareerBuilder) EndTime(endTime int) *WebsiteDeliveryCareerBuilder { @@ -30903,7 +30903,7 @@ func (builder *WebsiteDeliveryDtoBuilder) Build() *WebsiteDeliveryDto { type WebsiteDeliveryEducation struct { EducationType *int `json:"education_type,omitempty"` // 学历类型 - EndTime *int `json:"end_time,omitempty"` // 结束时间 ,如果是至今传值 -1 + EndTime *int `json:"end_time,omitempty"` // 结束时间 ，如果是至今传值 -1 FieldOfStudy *string `json:"field_of_study,omitempty"` // 专业 School *string `json:"school,omitempty"` // 学校 StartTime *int `json:"start_time,omitempty"` // 开始时间 @@ -30915,7 +30915,7 @@ type WebsiteDeliveryEducation struct { type WebsiteDeliveryEducationBuilder struct { educationType int // 学历类型 educationTypeFlag bool - endTime int // 结束时间 ,如果是至今传值 -1 + endTime int // 结束时间 ，如果是至今传值 -1 endTimeFlag bool fieldOfStudy string // 专业 fieldOfStudyFlag bool @@ -30945,7 +30945,7 @@ func (builder *WebsiteDeliveryEducationBuilder) EducationType(educationType int) return builder } -// 结束时间 ,如果是至今传值 -1 +// 结束时间 ，如果是至今传值 -1 // // 示例值：1618500278663 func (builder *WebsiteDeliveryEducationBuilder) EndTime(endTime int) *WebsiteDeliveryEducationBuilder { @@ -31094,7 +31094,7 @@ func (builder *WebsiteDeliveryIdentificationBuilder) Build() *WebsiteDeliveryIde type WebsiteDeliveryInternship struct { Desc *string `json:"desc,omitempty"` // 描述 - EndTime *int `json:"end_time,omitempty"` // 结束时间, 如果是至今传值 -1 + EndTime *int `json:"end_time,omitempty"` // 结束时间，如果是至今传值 -1 StartTime *int `json:"start_time,omitempty"` // 开始时间 Title *string `json:"title,omitempty"` // 职位名称 Company *string `json:"company,omitempty"` // 公司 @@ -31104,7 +31104,7 @@ type WebsiteDeliveryInternship struct { type WebsiteDeliveryInternshipBuilder struct { desc string // 描述 descFlag bool - endTime int // 结束时间, 如果是至今传值 -1 + endTime int // 结束时间，如果是至今传值 -1 endTimeFlag bool startTime int // 开始时间 startTimeFlag bool @@ -31130,7 +31130,7 @@ func (builder *WebsiteDeliveryInternshipBuilder) Desc(desc string) *WebsiteDeliv return builder } -// 结束时间, 如果是至今传值 -1 +// 结束时间，如果是至今传值 -1 // // 示例值：1618500278667 func (builder *WebsiteDeliveryInternshipBuilder) EndTime(endTime int) *WebsiteDeliveryInternshipBuilder { @@ -31269,7 +31269,7 @@ func (builder *WebsiteDeliveryLanguageBuilder) Build() *WebsiteDeliveryLanguage type WebsiteDeliveryProject struct { CustomizedData []*WebsiteDeliveryCustomizedData `json:"customized_data,omitempty"` // 自定义字段 Desc *string `json:"desc,omitempty"` // 描述 - EndTime *int `json:"end_time,omitempty"` // 结束时间, 如果是至今传值-1 + EndTime *int `json:"end_time,omitempty"` // 结束时间，如果是至今传值-1 Link *string `json:"link,omitempty"` // 项目链接 Name *string `json:"name,omitempty"` // 项目名称 Role *string `json:"role,omitempty"` // 角色 @@ -31281,7 +31281,7 @@ type WebsiteDeliveryProjectBuilder struct { customizedDataFlag bool desc string // 描述 descFlag bool - endTime int // 结束时间, 如果是至今传值-1 + endTime int // 结束时间，如果是至今传值-1 endTimeFlag bool link string // 项目链接 linkFlag bool @@ -31316,7 +31316,7 @@ func (builder *WebsiteDeliveryProjectBuilder) Desc(desc string) *WebsiteDelivery return builder } -// 结束时间, 如果是至今传值-1 +// 结束时间，如果是至今传值-1 // // 示例值：1618500278669 func (builder *WebsiteDeliveryProjectBuilder) EndTime(endTime int) *WebsiteDeliveryProjectBuilder { @@ -31336,7 +31336,7 @@ func (builder *WebsiteDeliveryProjectBuilder) Link(link string) *WebsiteDelivery // 项目名称 // -// 示例值：XXX项目重构 +// 示例值：XXX 项目重构 func (builder *WebsiteDeliveryProjectBuilder) Name(name string) *WebsiteDeliveryProjectBuilder { builder.name = name builder.nameFlag = true @@ -31400,7 +31400,7 @@ type WebsiteDeliveryResume struct { SelfEvaluation *WebsiteDeliverySelfEvaluation `json:"self_evaluation,omitempty"` // 自我评价 CareerList []*WebsiteDeliveryCareer `json:"career_list,omitempty"` // 工作经历 CustomizedData []*WebsiteDeliveryCustomizedDataParent `json:"customized_data,omitempty"` // 自定义模块 - ResumeAttachmentId *string `json:"resume_attachment_id,omitempty"` // 简历附件ID，使用「创建附件」生成 + ResumeAttachmentId *string `json:"resume_attachment_id,omitempty"` // 简历附件 ID，使用「创建附件」生成 SnsList []*WebsiteDeliverySns `json:"sns_list,omitempty"` // 社交账号 WorksList []*WebsiteDeliveryWorks `json:"works_list,omitempty"` // 作品 AwardList []*WebsiteDeliveryAward `json:"award_list,omitempty"` // 获奖记录 @@ -31421,7 +31421,7 @@ type WebsiteDeliveryResumeBuilder struct { careerListFlag bool customizedData []*WebsiteDeliveryCustomizedDataParent // 自定义模块 customizedDataFlag bool - resumeAttachmentId string // 简历附件ID，使用「创建附件」生成 + resumeAttachmentId string // 简历附件 ID，使用「创建附件」生成 resumeAttachmentIdFlag bool snsList []*WebsiteDeliverySns // 社交账号 snsListFlag bool @@ -31494,7 +31494,7 @@ func (builder *WebsiteDeliveryResumeBuilder) CustomizedData(customizedData []*We return builder } -// 简历附件ID，使用「创建附件」生成 +// 简历附件 ID，使用「创建附件」生成 // // 示例值：6960663240925956654 func (builder *WebsiteDeliveryResumeBuilder) ResumeAttachmentId(resumeAttachmentId string) *WebsiteDeliveryResumeBuilder { @@ -31779,11 +31779,11 @@ func (builder *WebsiteDeliveryWorksBuilder) Build() *WebsiteDeliveryWorks { } type WebsiteDeliveryWorksAttachment struct { - FileId *string `json:"file_id,omitempty"` // 文件ID，使用「创建附件」生成 + FileId *string `json:"file_id,omitempty"` // 文件 ID，使用「创建附件」生成 } type WebsiteDeliveryWorksAttachmentBuilder struct { - fileId string // 文件ID，使用「创建附件」生成 + fileId string // 文件 ID，使用「创建附件」生成 fileIdFlag bool } @@ -31792,7 +31792,7 @@ func NewWebsiteDeliveryWorksAttachmentBuilder() *WebsiteDeliveryWorksAttachmentB return builder } -// 文件ID，使用「创建附件」生成 +// 文件 ID，使用「创建附件」生成 // // 示例值：6982104077248219436 func (builder *WebsiteDeliveryWorksAttachmentBuilder) FileId(fileId string) *WebsiteDeliveryWorksAttachmentBuilder { @@ -31822,8 +31822,8 @@ type WebsiteJobPost struct { JobDepartment *IdNameObject `json:"job_department,omitempty"` // 职位部门 JobType *IdNameObject `json:"job_type,omitempty"` // 职位类型 Address *CommonAddress `json:"address,omitempty"` // 职位地址 - MinSalary *string `json:"min_salary,omitempty"` // 月薪范围-最低薪资 - MaxSalary *string `json:"max_salary,omitempty"` // 月薪范围-最高薪资 + MinSalary *string `json:"min_salary,omitempty"` // 月薪范围 - 最低薪资 + MaxSalary *string `json:"max_salary,omitempty"` // 月薪范围 - 最高薪资 RequiredDegree *int `json:"required_degree,omitempty"` // 学历要求 Experience *int `json:"experience,omitempty"` // 经验 Headcount *int `json:"headcount,omitempty"` // 数量 @@ -31863,9 +31863,9 @@ type WebsiteJobPostBuilder struct { jobTypeFlag bool address *CommonAddress // 职位地址 addressFlag bool - minSalary string // 月薪范围-最低薪资 + minSalary string // 月薪范围 - 最低薪资 minSalaryFlag bool - maxSalary string // 月薪范围-最高薪资 + maxSalary string // 月薪范围 - 最高薪资 maxSalaryFlag bool requiredDegree int // 学历要求 requiredDegreeFlag bool @@ -32001,7 +32001,7 @@ func (builder *WebsiteJobPostBuilder) Address(address *CommonAddress) *WebsiteJo return builder } -// 月薪范围-最低薪资 +// 月薪范围 - 最低薪资 // // 示例值：5000 func (builder *WebsiteJobPostBuilder) MinSalary(minSalary string) *WebsiteJobPostBuilder { @@ -32010,7 +32010,7 @@ func (builder *WebsiteJobPostBuilder) MinSalary(minSalary string) *WebsiteJobPos return builder } -// 月薪范围-最高薪资 +// 月薪范围 - 最高薪资 // // 示例值：10000 func (builder *WebsiteJobPostBuilder) MaxSalary(maxSalary string) *WebsiteJobPostBuilder { @@ -32643,13 +32643,13 @@ func (builder *WebsiteUserBuilder) Build() *WebsiteUser { } type WorksInfo struct { - AttachmentId *string `json:"attachment_id,omitempty"` // 作品集附件ID + AttachmentId *string `json:"attachment_id,omitempty"` // 作品集附件 ID Desc *string `json:"desc,omitempty"` // 作品描述 Link *string `json:"link,omitempty"` // 作品链接 } type WorksInfoBuilder struct { - attachmentId string // 作品集附件ID + attachmentId string // 作品集附件 ID attachmentIdFlag bool desc string // 作品描述 descFlag bool @@ -32662,7 +32662,7 @@ func NewWorksInfoBuilder() *WorksInfoBuilder { return builder } -// 作品集附件ID +// 作品集附件 ID // // 示例值： func (builder *WorksInfoBuilder) AttachmentId(attachmentId string) *WorksInfoBuilder { @@ -32707,9 +32707,9 @@ func (builder *WorksInfoBuilder) Build() *WorksInfo { } type CreateApplicationReqBodyBuilder struct { - talentId string // 人才ID + talentId string // 人才 ID talentIdFlag bool - jobId string // 职位ID + jobId string // 职位 ID jobIdFlag bool resumeSourceId string // 简历来源 ID，可通过「获取简历来源」接口查询。若简历来源类型属于「员工转岗」或「实习生转正」，人才需处于已入职状态。 resumeSourceIdFlag bool @@ -32722,7 +32722,7 @@ func NewCreateApplicationReqBodyBuilder() *CreateApplicationReqBodyBuilder { return builder } -// 人才ID +// 人才 ID // //示例值：12312312312 func (builder *CreateApplicationReqBodyBuilder) TalentId(talentId string) *CreateApplicationReqBodyBuilder { @@ -32731,7 +32731,7 @@ func (builder *CreateApplicationReqBodyBuilder) TalentId(talentId string) *Creat return builder } -// 职位ID +// 职位 ID // //示例值：12312312312 func (builder *CreateApplicationReqBodyBuilder) JobId(jobId string) *CreateApplicationReqBodyBuilder { @@ -32776,9 +32776,9 @@ func (builder *CreateApplicationReqBodyBuilder) Build() *CreateApplicationReqBod } type CreateApplicationPathReqBodyBuilder struct { - talentId string // 人才ID + talentId string // 人才 ID talentIdFlag bool - jobId string // 职位ID + jobId string // 职位 ID jobIdFlag bool resumeSourceId string // 简历来源 ID，可通过「获取简历来源」接口查询。若简历来源类型属于「员工转岗」或「实习生转正」，人才需处于已入职状态。 resumeSourceIdFlag bool @@ -32791,7 +32791,7 @@ func NewCreateApplicationPathReqBodyBuilder() *CreateApplicationPathReqBodyBuild return builder } -// 人才ID +// 人才 ID // // 示例值：12312312312 func (builder *CreateApplicationPathReqBodyBuilder) TalentId(talentId string) *CreateApplicationPathReqBodyBuilder { @@ -32800,7 +32800,7 @@ func (builder *CreateApplicationPathReqBodyBuilder) TalentId(talentId string) *C return builder } -// 职位ID +// 职位 ID // // 示例值：12312312312 func (builder *CreateApplicationPathReqBodyBuilder) JobId(jobId string) *CreateApplicationPathReqBodyBuilder { @@ -32872,8 +32872,8 @@ func (builder *CreateApplicationReqBuilder) Build() *CreateApplicationReq { } type CreateApplicationReqBody struct { - TalentId *string `json:"talent_id,omitempty"` // 人才ID - JobId *string `json:"job_id,omitempty"` // 职位ID + TalentId *string `json:"talent_id,omitempty"` // 人才 ID + JobId *string `json:"job_id,omitempty"` // 职位 ID ResumeSourceId *string `json:"resume_source_id,omitempty"` // 简历来源 ID，可通过「获取简历来源」接口查询。若简历来源类型属于「员工转岗」或「实习生转正」，人才需处于已入职状态。 ApplicationPreferredCityCodeList []string `json:"application_preferred_city_code_list,omitempty"` // 意向投递城市列表，可从「获取职位信息」返回的工作地点列表获取 } @@ -32884,7 +32884,7 @@ type CreateApplicationReq struct { } type CreateApplicationRespData struct { - Id *string `json:"id,omitempty"` // 投递ID + Id *string `json:"id,omitempty"` // 投递 ID } type CreateApplicationResp struct { @@ -32980,7 +32980,7 @@ func (builder *ListApplicationReqBuilder) TalentId(talentId string) *ListApplica return builder } -// 按活跃状态筛选 1=活跃投递, 2=非活跃投递, 3=全部 +// 按活跃状态筛选 1=活跃投递，2=非活跃投递，3=全部 // // 示例值：1 func (builder *ListApplicationReqBuilder) ActiveStatus(activeStatus string) *ListApplicationReqBuilder { @@ -32996,7 +32996,7 @@ func (builder *ListApplicationReqBuilder) JobId(jobId string) *ListApplicationRe return builder } -// 查询游标, 由上一页结果返回, 第一页不传 +// 查询游标，由上一页结果返回，第一页不传 // // 示例值：1 func (builder *ListApplicationReqBuilder) PageToken(pageToken string) *ListApplicationReqBuilder { @@ -33004,7 +33004,7 @@ func (builder *ListApplicationReqBuilder) PageToken(pageToken string) *ListAppli return builder } -// 每页限制, 每页最大不超过100 +// 每页限制，每页最大不超过 100 // // 示例值：100 func (builder *ListApplicationReqBuilder) PageSize(pageSize int) *ListApplicationReqBuilder { @@ -33041,7 +33041,7 @@ type ListApplicationReq struct { type ListApplicationRespData struct { Items []string `json:"items,omitempty"` // 投递数据列表 - PageToken *string `json:"page_token,omitempty"` // 游标, 翻下一页数据时使用 + PageToken *string `json:"page_token,omitempty"` // 游标，翻下一页数据时使用 HasMore *bool `json:"has_more,omitempty"` // 是否还有下一页数据 } @@ -33068,7 +33068,7 @@ func NewOfferApplicationReqBuilder() *OfferApplicationReqBuilder { return builder } -// 投递ID +// 投递 ID // // 示例值：6949805467799537964 func (builder *OfferApplicationReqBuilder) ApplicationId(applicationId string) *OfferApplicationReqBuilder { @@ -33105,7 +33105,7 @@ type OfferApplicationReq struct { } type OfferApplicationRespData struct { - Offer *ApplicationOffer `json:"offer,omitempty"` // Offer数据 + Offer *ApplicationOffer `json:"offer,omitempty"` // Offer 数据 } type OfferApplicationResp struct { @@ -33121,7 +33121,7 @@ func (resp *OfferApplicationResp) Success() bool { type TerminateApplicationReqBodyBuilder struct { terminationType int // 终止原因的类型 terminationTypeFlag bool - terminationReasonList []string // 终止的具体原因的id列表 + terminationReasonList []string // 终止的具体原因的 id 列表 terminationReasonListFlag bool terminationReasonNote string // 终止备注 terminationReasonNoteFlag bool @@ -33141,7 +33141,7 @@ func (builder *TerminateApplicationReqBodyBuilder) TerminationType(terminationTy return builder } -// 终止的具体原因的id列表 +// 终止的具体原因的 id 列表 // //示例值：["6891560630172518670"] func (builder *TerminateApplicationReqBodyBuilder) TerminationReasonList(terminationReasonList []string) *TerminateApplicationReqBodyBuilder { @@ -33176,7 +33176,7 @@ func (builder *TerminateApplicationReqBodyBuilder) Build() *TerminateApplication type TerminateApplicationPathReqBodyBuilder struct { terminationType int // 终止原因的类型 terminationTypeFlag bool - terminationReasonList []string // 终止的具体原因的id列表 + terminationReasonList []string // 终止的具体原因的 id 列表 terminationReasonListFlag bool terminationReasonNote string // 终止备注 terminationReasonNoteFlag bool @@ -33196,7 +33196,7 @@ func (builder *TerminateApplicationPathReqBodyBuilder) TerminationType(terminati return builder } -// 终止的具体原因的id列表 +// 终止的具体原因的 id 列表 // // 示例值：["6891560630172518670"] func (builder *TerminateApplicationPathReqBodyBuilder) TerminationReasonList(terminationReasonList []string) *TerminateApplicationPathReqBodyBuilder { @@ -33242,7 +33242,7 @@ func NewTerminateApplicationReqBuilder() *TerminateApplicationReqBuilder { return builder } -// 投递ID +// 投递 ID // // 示例值：12312312312 func (builder *TerminateApplicationReqBuilder) ApplicationId(applicationId string) *TerminateApplicationReqBuilder { @@ -33266,7 +33266,7 @@ func (builder *TerminateApplicationReqBuilder) Build() *TerminateApplicationReq type TerminateApplicationReqBody struct { TerminationType *int `json:"termination_type,omitempty"` // 终止原因的类型 - TerminationReasonList []string `json:"termination_reason_list,omitempty"` // 终止的具体原因的id列表 + TerminationReasonList []string `json:"termination_reason_list,omitempty"` // 终止的具体原因的 id 列表 TerminationReasonNote *string `json:"termination_reason_note,omitempty"` // 终止备注 } @@ -33604,7 +33604,7 @@ func NewTransferOnboardApplicationReqBuilder() *TransferOnboardApplicationReqBui return builder } -// 投递ID +// 投递 ID // // 示例值：7073372582620416300 func (builder *TransferOnboardApplicationReqBuilder) ApplicationId(applicationId string) *TransferOnboardApplicationReqBuilder { @@ -33712,7 +33712,7 @@ func (builder *ListApplicationInterviewReqBuilder) PageToken(pageToken string) * return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：open_id func (builder *ListApplicationInterviewReqBuilder) UserIdType(userIdType string) *ListApplicationInterviewReqBuilder { @@ -33761,7 +33761,7 @@ func NewGetAttachmentReqBuilder() *GetAttachmentReqBuilder { return builder } -// 附件id +// 附件 id // // 示例值：6435242341238 func (builder *GetAttachmentReqBuilder) AttachmentId(attachmentId string) *GetAttachmentReqBuilder { @@ -33816,7 +33816,7 @@ func NewPreviewAttachmentReqBuilder() *PreviewAttachmentReqBuilder { return builder } -// 附件id +// 附件 id // // 示例值：11111 func (builder *PreviewAttachmentReqBuilder) AttachmentId(attachmentId string) *PreviewAttachmentReqBuilder { @@ -33912,7 +33912,7 @@ func NewGetEmployeeReqBuilder() *GetEmployeeReqBuilder { return builder } -// 员工ID +// 员工 ID // // 示例值：123 func (builder *GetEmployeeReqBuilder) EmployeeId(employeeId string) *GetEmployeeReqBuilder { @@ -33975,7 +33975,7 @@ func NewGetByApplicationEmployeeReqBuilder() *GetByApplicationEmployeeReqBuilder return builder } -// 投递ID +// 投递 ID // // 示例值：123 func (builder *GetByApplicationEmployeeReqBuilder) ApplicationId(applicationId string) *GetByApplicationEmployeeReqBuilder { @@ -34038,7 +34038,7 @@ func NewPatchEmployeeReqBuilder() *PatchEmployeeReqBuilder { return builder } -// 员工ID +// 员工 ID // // 示例值：123 func (builder *PatchEmployeeReqBuilder) EmployeeId(employeeId string) *PatchEmployeeReqBuilder { @@ -34256,7 +34256,7 @@ func (builder *ConfigJobReqBuilder) JobId(jobId string) *ConfigJobReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ConfigJobReqBuilder) UserIdType(userIdType string) *ConfigJobReqBuilder { @@ -34303,7 +34303,7 @@ func NewGetJobReqBuilder() *GetJobReqBuilder { return builder } -// 职位 ID，请求Path中 +// 职位 ID，请求 Path 中 // // 示例值：6001 func (builder *GetJobReqBuilder) JobId(jobId string) *GetJobReqBuilder { @@ -34311,7 +34311,7 @@ func (builder *GetJobReqBuilder) JobId(jobId string) *GetJobReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetJobReqBuilder) UserIdType(userIdType string) *GetJobReqBuilder { @@ -34375,7 +34375,7 @@ func (builder *UpdateConfigJobReqBuilder) JobId(jobId string) *UpdateConfigJobRe return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateConfigJobReqBuilder) UserIdType(userIdType string) *UpdateConfigJobReqBuilder { @@ -34446,7 +34446,7 @@ func (builder *GetJobManagerReqBuilder) ManagerId(managerId string) *GetJobManag return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetJobManagerReqBuilder) UserIdType(userIdType string) *GetJobManagerReqBuilder { @@ -34493,7 +34493,7 @@ func NewListJobProcessReqBuilder() *ListJobProcessReqBuilder { return builder } -// 分页大小, 不能超过 100 +// 分页大小，不能超过 100 // // 示例值：10 func (builder *ListJobProcessReqBuilder) PageSize(pageSize int) *ListJobProcessReqBuilder { @@ -34550,7 +34550,7 @@ func NewCreateNoteReqBuilder() *CreateNoteReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateNoteReqBuilder) UserIdType(userIdType string) *CreateNoteReqBuilder { @@ -34604,7 +34604,7 @@ func NewGetNoteReqBuilder() *GetNoteReqBuilder { return builder } -// 备注ID +// 备注 ID // // 示例值：6949805467799537964 func (builder *GetNoteReqBuilder) NoteId(noteId string) *GetNoteReqBuilder { @@ -34612,7 +34612,7 @@ func (builder *GetNoteReqBuilder) NoteId(noteId string) *GetNoteReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetNoteReqBuilder) UserIdType(userIdType string) *GetNoteReqBuilder { @@ -34659,7 +34659,7 @@ func NewListNoteReqBuilder() *ListNoteReqBuilder { return builder } -// 每页限制, 每页最大不超过100 +// 每页限制，每页最大不超过 100 // // 示例值：10 func (builder *ListNoteReqBuilder) PageSize(pageSize int) *ListNoteReqBuilder { @@ -34667,7 +34667,7 @@ func (builder *ListNoteReqBuilder) PageSize(pageSize int) *ListNoteReqBuilder { return builder } -// 查询游标, 由上一页结果返回, 第一页不传 +// 查询游标，由上一页结果返回，第一页不传 // // 示例值：1 func (builder *ListNoteReqBuilder) PageToken(pageToken string) *ListNoteReqBuilder { @@ -34675,7 +34675,7 @@ func (builder *ListNoteReqBuilder) PageToken(pageToken string) *ListNoteReqBuild return builder } -// 人才ID +// 人才 ID // // 示例值：6916472453069883661 func (builder *ListNoteReqBuilder) TalentId(talentId string) *ListNoteReqBuilder { @@ -34683,7 +34683,7 @@ func (builder *ListNoteReqBuilder) TalentId(talentId string) *ListNoteReqBuilder return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListNoteReqBuilder) UserIdType(userIdType string) *ListNoteReqBuilder { @@ -34705,7 +34705,7 @@ type ListNoteReq struct { type ListNoteRespData struct { Items []*Note `json:"items,omitempty"` // 备注数据列表 HasMore *bool `json:"has_more,omitempty"` // 是否还有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 游标, 翻下一页数据时使用 + PageToken *string `json:"page_token,omitempty"` // 游标，翻下一页数据时使用 } type ListNoteResp struct { @@ -34794,7 +34794,7 @@ func (builder *PatchNoteReqBuilder) NoteId(noteId string) *PatchNoteReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchNoteReqBuilder) UserIdType(userIdType string) *PatchNoteReqBuilder { @@ -34853,7 +34853,7 @@ func NewGetOfferSchemaReqBuilder() *GetOfferSchemaReqBuilder { return builder } -// offer申请表的ID *必需属性 +// offer 申请表的 ID * 必需属性 // // 示例值：1231231231231 func (builder *GetOfferSchemaReqBuilder) OfferSchemaId(offerSchemaId string) *GetOfferSchemaReqBuilder { @@ -34873,8 +34873,8 @@ type GetOfferSchemaReq struct { } type GetOfferSchemaRespData struct { - Id *string `json:"id,omitempty"` // offer申请表ID - Scenario *int `json:"scenario,omitempty"` // offer申请表使用场景 + Id *string `json:"id,omitempty"` // offer 申请表 ID + Scenario *int `json:"scenario,omitempty"` // offer 申请表使用场景 Version *int `json:"version,omitempty"` // 申请表版本 ObjectList []*OfferSchemaDetail `json:"object_list,omitempty"` // 字段对象信息 } @@ -34910,7 +34910,7 @@ func (builder *GetByApplicationReferralReqBuilder) ApplicationId(applicationId s return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：open_id func (builder *GetByApplicationReferralReqBuilder) UserIdType(userIdType string) *GetByApplicationReferralReqBuilder { @@ -35242,7 +35242,7 @@ func NewGetTalentReqBuilder() *GetTalentReqBuilder { return builder } -// 人才ID +// 人才 ID // // 示例值：6891560630172518670 func (builder *GetTalentReqBuilder) TalentId(talentId string) *GetTalentReqBuilder { @@ -35319,7 +35319,7 @@ func (iterator *ListResumeSourceIterator) Next() (bool, *ResumeSource, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/human_authentication/v1/api.go b/service/human_authentication/v1/api.go index 1c5f1b13..a28c8f9d 100644 --- a/service/human_authentication/v1/api.go +++ b/service/human_authentication/v1/api.go @@ -39,11 +39,11 @@ type identity struct { // // - 该接口用于录入实名认证的身份信息，在唤起有源活体认证前，需要使用该接口进行实名认证。 // -// - 实名认证接口会有计费管理，接入前请联系飞书开放平台工作人员，邮箱：openplatform@bytedance.com。;;仅通过计费申请的应用，才能在[开发者后台](https://open.feishu.cn/app)查找并申请该接口的权限。 +// - 实名认证接口会有计费管理，接入前请联系飞书开放平台工作人员，邮箱：openplatform@bytedance.com。;;仅通过计费申请的应用，才能在 [开发者后台](https://open.feishu.cn/app) 查找并申请该接口的权限。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/human_authentication-v1/identity/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/human_authentication-v1/identity/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/human_authenticationv1/create_identity.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/human_authenticationv1/create_identity.go func (i *identity) Create(ctx context.Context, req *CreateIdentityReq, options ...larkcore.RequestOptionFunc) (*CreateIdentityResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/human_authentication/v1/model.go b/service/human_authentication/v1/model.go index 9b840c73..fa2e9a10 100644 --- a/service/human_authentication/v1/model.go +++ b/service/human_authentication/v1/model.go @@ -20,9 +20,9 @@ import ( ) const ( - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 ) type Identity struct { @@ -213,7 +213,7 @@ func NewCreateIdentityReqBuilder() *CreateIdentityReqBuilder { return builder } -// 用户的唯一标识（使用的ID类型见下一参数描述，不同ID类型的区别和获取，参考文档：[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)） +// 用户的唯一标识（使用的 ID 类型见下一参数描述，不同 ID 类型的区别和获取，参考文档：[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)） // // 示例值：ou_2eb5483cb377daa5054bc6f86e2089a5 func (builder *CreateIdentityReqBuilder) UserId(userId string) *CreateIdentityReqBuilder { @@ -221,7 +221,7 @@ func (builder *CreateIdentityReqBuilder) UserId(userId string) *CreateIdentityRe return builder } -// 用户ID类型 open_id/user_id/union_id +// 用户 ID 类型 open_id/user_id/union_id // // 示例值： func (builder *CreateIdentityReqBuilder) UserIdType(userIdType string) *CreateIdentityReqBuilder { @@ -255,7 +255,7 @@ type CreateIdentityReq struct { } type CreateIdentityRespData struct { - VerifyUid *string `json:"verify_uid,omitempty"` // 用户绑定实名身份的uid + VerifyUid *string `json:"verify_uid,omitempty"` // 用户绑定实名身份的 uid } type CreateIdentityResp struct { diff --git a/service/im/v1/api.go b/service/im/v1/api.go index 56c9f822..c525a24d 100644 --- a/service/im/v1/api.go +++ b/service/im/v1/api.go @@ -123,13 +123,13 @@ type pin struct { // 批量撤回消息 // -// - 批量撤回通过[批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口发送的消息。 +// - 批量撤回通过 [批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM) 接口发送的消息。 // -// - 注意事项：;- 应用需要启用[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 撤回单条发送的消息请使用[撤回消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/delete)接口;- 不支持撤回发出时间超过1天的消息;- 一次调用涉及大量消息，所以为异步接口，会有一定延迟。 +// - 注意事项：;- 应用需要启用 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 撤回单条发送的消息请使用 [撤回消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/delete) 接口;- 不支持撤回发出时间超过 1 天的消息;- 一次调用涉及大量消息，所以为异步接口，会有一定延迟。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_batchMessage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_batchMessage.go func (b *batchMessage) Delete(ctx context.Context, req *DeleteBatchMessageReq, options ...larkcore.RequestOptionFunc) (*DeleteBatchMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -151,13 +151,13 @@ func (b *batchMessage) Delete(ctx context.Context, req *DeleteBatchMessageReq, o // 查询批量消息整体进度 // -// - 该接口在[查询批量消息推送和阅读人数](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/read_user)查询结果的基础上，增加了批量请求中有效的userid数量以及消息撤回进度数据。 +// - 该接口在 [查询批量消息推送和阅读人数](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/read_user) 查询结果的基础上，增加了批量请求中有效的 userid 数量以及消息撤回进度数据。 // // - 注意事项:;* 该接口返回的数据为查询时刻的快照数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/get_progress +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/get_progress // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/getProgress_batchMessage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/getProgress_batchMessage.go func (b *batchMessage) GetProgress(ctx context.Context, req *GetProgressBatchMessageReq, options ...larkcore.RequestOptionFunc) (*GetProgressBatchMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -181,11 +181,11 @@ func (b *batchMessage) GetProgress(ctx context.Context, req *GetProgressBatchMes // // - 批量发送消息后，可以通过该接口查询批量消息推送的总人数和阅读人数。 // -// - 注意事项：;- 只能查询通过[批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口产生的消息;- 该接口返回的数据为查询时刻的快照数据 +// - 注意事项：;- 只能查询通过 [批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM) 接口产生的消息;- 该接口返回的数据为查询时刻的快照数据 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/read_user +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/batch_message/read_user // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/readUser_batchMessage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/readUser_batchMessage.go func (b *batchMessage) ReadUser(ctx context.Context, req *ReadUserBatchMessageReq, options ...larkcore.RequestOptionFunc) (*ReadUserBatchMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -209,11 +209,11 @@ func (b *batchMessage) ReadUser(ctx context.Context, req *ReadUserBatchMessageRe // // - 创建群并设置群头像、群名、群描述等。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 本接口支持在创建群的同时拉用户或机器人进群；如果仅需要拉用户或者机器人入群参考 [将用户或机器人拉入群聊](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/create)接口 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 本接口支持在创建群的同时拉用户或机器人进群；如果仅需要拉用户或者机器人入群参考 [将用户或机器人拉入群聊](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/create) 接口 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chat.go func (c *chat) Create(ctx context.Context, req *CreateChatReq, options ...larkcore.RequestOptionFunc) (*CreateChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -237,11 +237,11 @@ func (c *chat) Create(ctx context.Context, req *CreateChatReq, options ...larkco // // - 解散群组。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 如果使用tenant_access_token，需要机器人符合以下任一情况才可解散群：; - 机器人是群主; - 机器人是群的创建者且具备==更新应用所创建群的群信息==权限;- 如果使用user_access_token，需要对应的用户是群主才可解散群 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 如果使用 tenant_access_token，需要机器人符合以下任一情况才可解散群：; - 机器人是群主; - 机器人是群的创建者且具备==更新应用所创建群的群信息==权限;- 如果使用 user_access_token，需要对应的用户是群主才可解散群 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_chat.go func (c *chat) Delete(ctx context.Context, req *DeleteChatReq, options ...larkcore.RequestOptionFunc) (*DeleteChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -265,11 +265,11 @@ func (c *chat) Delete(ctx context.Context, req *DeleteChatReq, options ...larkco // // - 获取群名称、群描述、群头像、群主 ID 等群基本信息。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群里（否则只会返回群名称、群头像等基本信息）;- 获取内部群信息时，操作者须与群组在同一租户下 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群里（否则只会返回群名称、群头像等基本信息）;- 获取内部群信息时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chat.go func (c *chat) Get(ctx context.Context, req *GetChatReq, options ...larkcore.RequestOptionFunc) (*GetChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -293,11 +293,11 @@ func (c *chat) Get(ctx context.Context, req *GetChatReq, options ...larkcore.Req // // - 获取指定群的分享链接。 // -// - 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - access_token所对应的 **机器人** 或 **授权用户** 必须在`chat_id`参数指定的群组中;- 单聊、密聊、团队群不支持分享群链接;- 当Bot被停用或Bot退出群组时，Bot生成的群链接也将停用;- 当群聊开启了 ==仅群主和群管理员可添加群成员/分享群== 设置时，仅**群主**和**群管理员**可以获取群分享链接;- 获取内部群分享链接时，操作者须与群组在同一租户下 +// - 注意事项:;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - access_token 所对应的 ** 机器人 ** 或 ** 授权用户 ** 必须在`chat_id`参数指定的群组中;- 单聊、密聊、团队群不支持分享群链接;- 当 Bot 被停用或 Bot 退出群组时，Bot 生成的群链接也将停用;- 当群聊开启了 ==仅群主和群管理员可添加群成员/分享群== 设置时，仅 ** 群主 ** 和 ** 群管理员 ** 可以获取群分享链接;- 获取内部群分享链接时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/link +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/link // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/link_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/link_chat.go func (c *chat) Link(ctx context.Context, req *LinkChatReq, options ...larkcore.RequestOptionFunc) (*LinkChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -321,11 +321,11 @@ func (c *chat) Link(ctx context.Context, req *LinkChatReq, options ...larkcore.R // // - 获取用户或者机器人所在群列表。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 请注意区分本接口和[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)的请求 URL;- 获取的群列表不包含P2P单聊 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 请注意区分本接口和 [获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get) 的请求 URL;- 获取的群列表不包含 P2P 单聊 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_chat.go func (c *chat) List(ctx context.Context, req *ListChatReq, options ...larkcore.RequestOptionFunc) (*ListChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -355,13 +355,13 @@ func (c *chat) ListByIterator(ctx context.Context, req *ListChatReq, options ... // 搜索对用户或机器人可见的群列表 // -// - 搜索对用户或机器人可见的群列表，包括：用户或机器人所在的群、对用户或机器人公开的群。;搜索可获得的群信息包括：群ID（chat_id）、群名称、群描述等。 +// - 搜索对用户或机器人可见的群列表，包括：用户或机器人所在的群、对用户或机器人公开的群。;搜索可获得的群信息包括：群 ID（chat_id）、群名称、群描述等。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/search_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/search_chat.go func (c *chat) Search(ctx context.Context, req *SearchChatReq, options ...larkcore.RequestOptionFunc) (*SearchChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -393,11 +393,11 @@ func (c *chat) SearchByIterator(ctx context.Context, req *SearchChatReq, options // // - 更新群头像、群名称、群描述、群配置、转让群主等。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 对于群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人，可更新所有信息;- 对于不满足上述权限条件的群成员或机器人：; - 若未开启 ==仅群主和群管理员可编辑群信息== 配置，仅可更新群头像、群名称、群描述、群国际化名称信息; - 若开启了 ==仅群主和群管理员可编辑群信息== 配置，任何群信息都不能修改;- 如果同时更新 ==邀请用户或机器人入群权限== 和 ==群分享权限== 这两项设置需要满足以下条件：; - 若未开启 ==仅群主和管理员可以邀请用户或机器人入群==，需要设置 ==群分享权限== 为 ==允许分享==; - 若开启了 ==仅群主和管理员可以邀请用户或机器人入群==，需要设置 ==群分享权限== 为 ==不允许分享== +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 对于群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人，可更新所有信息;- 对于不满足上述权限条件的群成员或机器人：; - 若未开启 ==仅群主和群管理员可编辑群信息== 配置，仅可更新群头像、群名称、群描述、群国际化名称信息; - 若开启了 ==仅群主和群管理员可编辑群信息== 配置，任何群信息都不能修改;- 如果同时更新 ==邀请用户或机器人入群权限== 和 ==群分享权限== 这两项设置需要满足以下条件：; - 若未开启 ==仅群主和管理员可以邀请用户或机器人入群==，需要设置 ==群分享权限== 为 ==允许分享==; - 若开启了 ==仅群主和管理员可以邀请用户或机器人入群==，需要设置 ==群分享权限== 为 ==不允许分享== // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/update_chat.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/update_chat.go func (c *chat) Update(ctx context.Context, req *UpdateChatReq, options ...larkcore.RequestOptionFunc) (*UpdateChatResp, error) { // 发起请求 apiReq := req.apiReq @@ -419,13 +419,13 @@ func (c *chat) Update(ctx context.Context, req *UpdateChatReq, options ...larkco // 获取群公告信息 // -// - 获取会话中的群公告信息，公告信息格式与[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。 +// - 获取会话中的群公告信息，公告信息格式与 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN) 格式相同。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 获取内部群信息时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 获取内部群信息时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatAnnouncement.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatAnnouncement.go func (c *chatAnnouncement) Get(ctx context.Context, req *GetChatAnnouncementReq, options ...larkcore.RequestOptionFunc) (*GetChatAnnouncementResp, error) { // 发起请求 apiReq := req.apiReq @@ -447,13 +447,13 @@ func (c *chatAnnouncement) Get(ctx context.Context, req *GetChatAnnouncementReq, // 更新群公告信息 // -// - 更新会话中的群公告信息，更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。 +// - 更新会话中的群公告信息，更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN) 格式相同。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 操作者需要拥有群公告文档的阅读权限;- 获取内部群信息时，操作者须与群组在同一租户下;- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置，群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人，可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置，所有成员可以更新群公告 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 操作者需要拥有群公告文档的阅读权限;- 获取内部群信息时，操作者须与群组在同一租户下;- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置，群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人，可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置，所有成员可以更新群公告 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/patch_chatAnnouncement.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/patch_chatAnnouncement.go func (c *chatAnnouncement) Patch(ctx context.Context, req *PatchChatAnnouncementReq, options ...larkcore.RequestOptionFunc) (*PatchChatAnnouncementResp, error) { // 发起请求 apiReq := req.apiReq @@ -477,11 +477,11 @@ func (c *chatAnnouncement) Patch(ctx context.Context, req *PatchChatAnnouncement // // - 将用户或机器人指定为群管理员。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 仅有群主可以指定群管理员 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 仅有群主可以指定群管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-managers/add_managers +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-managers/add_managers // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/addManagers_chatManagers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/addManagers_chatManagers.go func (c *chatManagers) AddManagers(ctx context.Context, req *AddManagersChatManagersReq, options ...larkcore.RequestOptionFunc) (*AddManagersChatManagersResp, error) { // 发起请求 apiReq := req.apiReq @@ -505,11 +505,11 @@ func (c *chatManagers) AddManagers(ctx context.Context, req *AddManagersChatMana // // - 删除指定的群管理员（用户或机器人）。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 仅有群主可以删除群管理员 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 仅有群主可以删除群管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-managers/delete_managers +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-managers/delete_managers // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/deleteManagers_chatManagers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/deleteManagers_chatManagers.go func (c *chatManagers) DeleteManagers(ctx context.Context, req *DeleteManagersChatManagersReq, options ...larkcore.RequestOptionFunc) (*DeleteManagersChatManagersResp, error) { // 发起请求 apiReq := req.apiReq @@ -533,11 +533,11 @@ func (c *chatManagers) DeleteManagers(ctx context.Context, req *DeleteManagersCh // // - 将用户或机器人拉入群聊。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 如需拉用户进群，需要机器人对用户有[可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability); - 机器人或授权用户必须在群组中;- 外部租户不能被加入到内部群中;- 操作内部群时，操作者须与群组在同一租户下; - 在开启 ==仅群主和群管理员可添加群成员== 的设置时，仅有群主/管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人，可以拉用户或者机器人进群; - 在未开启 ==仅群主和群管理员可添加群成员== 的设置时，所有群成员都可以拉用户或机器人进群 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 如需拉用户进群，需要机器人对用户有 [可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability); - 机器人或授权用户必须在群组中;- 外部租户不能被加入到内部群中;- 操作内部群时，操作者须与群组在同一租户下; - 在开启 ==仅群主和群管理员可添加群成员== 的设置时，仅有群主/管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人，可以拉用户或者机器人进群; - 在未开启 ==仅群主和群管理员可添加群成员== 的设置时，所有群成员都可以拉用户或机器人进群 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chatMembers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chatMembers.go func (c *chatMembers) Create(ctx context.Context, req *CreateChatMembersReq, options ...larkcore.RequestOptionFunc) (*CreateChatMembersResp, error) { // 发起请求 apiReq := req.apiReq @@ -561,11 +561,11 @@ func (c *chatMembers) Create(ctx context.Context, req *CreateChatMembersReq, opt // // - 将用户或机器人移出群聊。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 用户或机器人在任何条件下均可移除自己出群（即主动退群）;- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人，可以移除其他用户或者机器人;- 每次请求，最多移除50个用户或者5个机器人;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 用户或机器人在任何条件下均可移除自己出群（即主动退群）;- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人，可以移除其他用户或者机器人;- 每次请求，最多移除 50 个用户或者 5 个机器人;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_chatMembers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_chatMembers.go func (c *chatMembers) Delete(ctx context.Context, req *DeleteChatMembersReq, options ...larkcore.RequestOptionFunc) (*DeleteChatMembersResp, error) { // 发起请求 apiReq := req.apiReq @@ -589,11 +589,11 @@ func (c *chatMembers) Delete(ctx context.Context, req *DeleteChatMembersReq, opt // // - 获取用户/机器人所在群的群成员列表。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群组中; - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员，因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员，会一次性返回，这会导致返回的群成员个数可能会大于指定的page_size;- 获取内部群信息时，操作者须与群组在同一租户下 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群组中; - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员，因此返回的群成员个数可能会小于指定的 page_size; - 如果有同一时间加入群的群成员，会一次性返回，这会导致返回的群成员个数可能会大于指定的 page_size;- 获取内部群信息时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatMembers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatMembers.go func (c *chatMembers) Get(ctx context.Context, req *GetChatMembersReq, options ...larkcore.RequestOptionFunc) (*GetChatMembersResp, error) { // 发起请求 apiReq := req.apiReq @@ -623,13 +623,13 @@ func (c *chatMembers) GetByIterator(ctx context.Context, req *GetChatMembersReq, // 判断用户或机器人是否在群里 // -// - 根据使用的access_token判断对应的用户或者机器人是否在群里。 +// - 根据使用的 access_token 判断对应的用户或者机器人是否在群里。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 获取内部群信息时，操作者须与群组在同一租户下 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 获取内部群信息时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/is_in_chat +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/is_in_chat // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/isInChat_chatMembers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/isInChat_chatMembers.go func (c *chatMembers) IsInChat(ctx context.Context, req *IsInChatChatMembersReq, options ...larkcore.RequestOptionFunc) (*IsInChatChatMembersResp, error) { // 发起请求 apiReq := req.apiReq @@ -653,11 +653,11 @@ func (c *chatMembers) IsInChat(ctx context.Context, req *IsInChatChatMembersReq, // // - 用户或机器人主动加入群聊。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 目前仅支持加入公开群;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 目前仅支持加入公开群;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/me_join +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/me_join // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/meJoin_chatMembers.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/meJoin_chatMembers.go func (c *chatMembers) MeJoin(ctx context.Context, req *MeJoinChatMembersReq, options ...larkcore.RequestOptionFunc) (*MeJoinChatMembersResp, error) { // 发起请求 apiReq := req.apiReq @@ -681,11 +681,11 @@ func (c *chatMembers) MeJoin(ctx context.Context, req *MeJoinChatMembersReq, opt // // - 修改某个一级菜单或者二级菜单的元信息。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_item/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_item/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/patch_chatMenuItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/patch_chatMenuItem.go func (c *chatMenuItem) Patch(ctx context.Context, req *PatchChatMenuItemReq, options ...larkcore.RequestOptionFunc) (*PatchChatMenuItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -709,11 +709,11 @@ func (c *chatMenuItem) Patch(ctx context.Context, req *PatchChatMenuItemReq, opt // // - 向群内添加群菜单。 // -// - 注意事项：;- 该API是向群内追加菜单，群内原来存在的菜单并不会被覆盖。操作API后，将返回群内所有菜单。;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。;- 一个群内，一级菜单最多有3个，每个一级菜单最多有5个二级菜单。 +// - 注意事项：;- 该 API 是向群内追加菜单，群内原来存在的菜单并不会被覆盖。操作 API 后，将返回群内所有菜单。;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。;- 一个群内，一级菜单最多有 3 个，每个一级菜单最多有 5 个二级菜单。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chatMenuTree.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chatMenuTree.go func (c *chatMenuTree) Create(ctx context.Context, req *CreateChatMenuTreeReq, options ...larkcore.RequestOptionFunc) (*CreateChatMenuTreeResp, error) { // 发起请求 apiReq := req.apiReq @@ -737,11 +737,11 @@ func (c *chatMenuTree) Create(ctx context.Context, req *CreateChatMenuTreeReq, o // // - 删除群内菜单。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。;- 操作API后，将返回群内所有菜单。 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。;- 操作 API 后，将返回群内所有菜单。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_chatMenuTree.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_chatMenuTree.go func (c *chatMenuTree) Delete(ctx context.Context, req *DeleteChatMenuTreeReq, options ...larkcore.RequestOptionFunc) (*DeleteChatMenuTreeResp, error) { // 发起请求 apiReq := req.apiReq @@ -763,13 +763,13 @@ func (c *chatMenuTree) Delete(ctx context.Context, req *DeleteChatMenuTreeReq, o // 获取群内菜单 // -// - 通过群ID获取群内菜单。 +// - 通过群 ID 获取群内菜单。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatMenuTree.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatMenuTree.go func (c *chatMenuTree) Get(ctx context.Context, req *GetChatMenuTreeReq, options ...larkcore.RequestOptionFunc) (*GetChatMenuTreeResp, error) { // 发起请求 apiReq := req.apiReq @@ -793,11 +793,11 @@ func (c *chatMenuTree) Get(ctx context.Context, req *GetChatMenuTreeReq, options // // - 给一个群内的一级菜单排序。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。;- 操作API后，将返回群内所有菜单。 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 机器人必须在群里。;- 操作 API 后，将返回群内所有菜单。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/sort +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/sort // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/sort_chatMenuTree.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/sort_chatMenuTree.go func (c *chatMenuTree) Sort(ctx context.Context, req *SortChatMenuTreeReq, options ...larkcore.RequestOptionFunc) (*SortChatMenuTreeResp, error) { // 发起请求 apiReq := req.apiReq @@ -821,11 +821,11 @@ func (c *chatMenuTree) Sort(ctx context.Context, req *SortChatMenuTreeReq, optio // // - 获取群发言模式、可发言用户名单等 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人 或 授权用户 必须在群里 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人 或 授权用户 必须在群里 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-moderation/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-moderation/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatModeration.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_chatModeration.go func (c *chatModeration) Get(ctx context.Context, req *GetChatModerationReq, options ...larkcore.RequestOptionFunc) (*GetChatModerationResp, error) { // 发起请求 apiReq := req.apiReq @@ -857,11 +857,11 @@ func (c *chatModeration) GetByIterator(ctx context.Context, req *GetChatModerati // // - 更新群组的发言权限设置，可设置为全员可发言、仅管理员可发言 或 指定用户可发言。 // -// - 注意事项：; - 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 若以用户授权调用接口，**当授权用户是群主**时，可更新群发言权限;- 若以租户授权调用接口(即以机器人身份调用接口)，当**机器人是群主** 或者 **机器人是群组创建者、具备==更新应用所创建群的群信息==权限且仍在群内**时，可更新群发言权限 +// - 注意事项：; - 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 若以用户授权调用接口，** 当授权用户是群主 ** 时，可更新群发言权限;- 若以租户授权调用接口 (即以机器人身份调用接口)，当 ** 机器人是群主 ** 或者 ** 机器人是群组创建者、具备==更新应用所创建群的群信息==权限且仍在群内 ** 时，可更新群发言权限 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-moderation/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-moderation/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/update_chatModeration.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/update_chatModeration.go func (c *chatModeration) Update(ctx context.Context, req *UpdateChatModerationReq, options ...larkcore.RequestOptionFunc) (*UpdateChatModerationResp, error) { // 发起请求 apiReq := req.apiReq @@ -885,11 +885,11 @@ func (c *chatModeration) Update(ctx context.Context, req *UpdateChatModerationRe // // - 添加自定义会话标签页。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 只允许添加类型为`doc`和`url`的会话标签页;- 添加doc类型时，操作者（access token对应的身份）需要拥有对应文档的权限;- tab_config字段当前只对`url`类型的会话标签页生效;- 在开启 ==仅群主和管理员可管理标签页== 的设置时，仅群主和群管理员可以添加会话标签页;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 只允许添加类型为`doc`和`url`的会话标签页;- 添加 doc 类型时，操作者（access token 对应的身份）需要拥有对应文档的权限;- tab_config 字段当前只对`url`类型的会话标签页生效;- 在开启 ==仅群主和管理员可管理标签页== 的设置时，仅群主和群管理员可以添加会话标签页;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chatTab.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_chatTab.go func (c *chatTab) Create(ctx context.Context, req *CreateChatTabReq, options ...larkcore.RequestOptionFunc) (*CreateChatTabResp, error) { // 发起请求 apiReq := req.apiReq @@ -913,11 +913,11 @@ func (c *chatTab) Create(ctx context.Context, req *CreateChatTabReq, options ... // // - 删除会话标签页。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 只允许删除类型为`doc`和`url`的会话标签页;- 在开启 ==仅群主和管理员可管理标签页== 的设置时，仅群主和群管理员可以删除会话标签页;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 只允许删除类型为`doc`和`url`的会话标签页;- 在开启 ==仅群主和管理员可管理标签页== 的设置时，仅群主和群管理员可以删除会话标签页;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/delete_tabs +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/delete_tabs // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/deleteTabs_chatTab.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/deleteTabs_chatTab.go func (c *chatTab) DeleteTabs(ctx context.Context, req *DeleteTabsChatTabReq, options ...larkcore.RequestOptionFunc) (*DeleteTabsChatTabResp, error) { // 发起请求 apiReq := req.apiReq @@ -941,11 +941,11 @@ func (c *chatTab) DeleteTabs(ctx context.Context, req *DeleteTabsChatTabReq, opt // // - 拉取会话标签页。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/listTabs_chatTab.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/listTabs_chatTab.go func (c *chatTab) ListTabs(ctx context.Context, req *ListTabsChatTabReq, options ...larkcore.RequestOptionFunc) (*ListTabsChatTabResp, error) { // 发起请求 apiReq := req.apiReq @@ -969,11 +969,11 @@ func (c *chatTab) ListTabs(ctx context.Context, req *ListTabsChatTabReq, options // // - 会话标签页排序。 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 消息标签页强制固定为第一顺位，不参与排序，但是请求体中必须包含该标签页的Tab ID;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 消息标签页强制固定为第一顺位，不参与排序，但是请求体中必须包含该标签页的 Tab ID;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/sort_tabs +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/sort_tabs // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/sortTabs_chatTab.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/sortTabs_chatTab.go func (c *chatTab) SortTabs(ctx context.Context, req *SortTabsChatTabReq, options ...larkcore.RequestOptionFunc) (*SortTabsChatTabResp, error) { // 发起请求 apiReq := req.apiReq @@ -997,11 +997,11 @@ func (c *chatTab) SortTabs(ctx context.Context, req *SortTabsChatTabReq, options // // - 更新会话标签页 // -// - 注意事项：;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 只允许更新类型为`doc`和`url`的会话标签页;- 更新doc类型时，操作者（access token对应的身份）需要拥有对应文档的权限;- 在开启 ==仅群主和管理员可管理标签页== 的设置时，仅群主和群管理员可以更新会话标签页;- 操作内部群时，操作者须与群组在同一租户下 +// - 注意事项：;- 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人或授权用户必须在群里;- 只允许更新类型为`doc`和`url`的会话标签页;- 更新 doc 类型时，操作者（access token 对应的身份）需要拥有对应文档的权限;- 在开启 ==仅群主和管理员可管理标签页== 的设置时，仅群主和群管理员可以更新会话标签页;- 操作内部群时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/update_tabs +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/update_tabs // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/updateTabs_chatTab.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/updateTabs_chatTab.go func (c *chatTab) UpdateTabs(ctx context.Context, req *UpdateTabsChatTabReq, options ...larkcore.RequestOptionFunc) (*UpdateTabsChatTabResp, error) { // 发起请求 apiReq := req.apiReq @@ -1025,11 +1025,11 @@ func (c *chatTab) UpdateTabs(ctx context.Context, req *UpdateTabsChatTabReq, opt // // - 撤销会话中的置顶。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群组中;- 撤销内部群置顶时，操作者须与群组在同一租户下 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群组中;- 撤销内部群置顶时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-top_notice/delete_top_notice +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-top_notice/delete_top_notice // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/deleteTopNotice_chatTopNotice.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/deleteTopNotice_chatTopNotice.go func (c *chatTopNotice) DeleteTopNotice(ctx context.Context, req *DeleteTopNoticeChatTopNoticeReq, options ...larkcore.RequestOptionFunc) (*DeleteTopNoticeChatTopNoticeResp, error) { // 发起请求 apiReq := req.apiReq @@ -1053,11 +1053,11 @@ func (c *chatTopNotice) DeleteTopNotice(ctx context.Context, req *DeleteTopNotic // // - 更新会话中的群置顶信息，可以将群中的某一条消息，或者群公告置顶显示。 // -// - 注意事项：; - 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群组中;- 更新内部群置顶时，操作者须与群组在同一租户下 +// - 注意事项：; - 应用需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability); - 机器人或授权用户必须在群组中;- 更新内部群置顶时，操作者须与群组在同一租户下 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-top_notice/put_top_notice +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-top_notice/put_top_notice // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/putTopNotice_chatTopNotice.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/putTopNotice_chatTopNotice.go func (c *chatTopNotice) PutTopNotice(ctx context.Context, req *PutTopNoticeChatTopNoticeReq, options ...larkcore.RequestOptionFunc) (*PutTopNoticeChatTopNoticeResp, error) { // 发起请求 apiReq := req.apiReq @@ -1081,11 +1081,11 @@ func (c *chatTopNotice) PutTopNotice(ctx context.Context, req *PutTopNoticeChatT // // - 上传文件，可以上传视频，音频和常见的文件类型。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 文件大小不得超过30M，且不允许上传空文件 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 文件大小不得超过 30M，且不允许上传空文件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_file.go func (f *file) Create(ctx context.Context, req *CreateFileReq, options ...larkcore.RequestOptionFunc) (*CreateFileResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -1110,11 +1110,11 @@ func (f *file) Create(ctx context.Context, req *CreateFileReq, options ...larkco // // - 下载文件接口，只能下载应用自己上传的文件。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 只能下载机器人自己上传的文件;- 下载用户发送的资源，请使用[获取消息中的资源文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-resource/get)接口;- 下载的资源大小不能超过100M;- 如果需要Content-Disposition header，发起请求的时候需要在header中设置Content-Type为application/json +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 只能下载机器人自己上传的文件;- 下载用户发送的资源，请使用 [获取消息中的资源文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-resource/get) 接口;- 下载的资源大小不能超过 100M;- 如果需要 Content-Disposition header，发起请求的时候需要在 header 中设置 Content-Type 为 application/json // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_file.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_file.go func (f *file) Get(ctx context.Context, req *GetFileReq, options ...larkcore.RequestOptionFunc) (*GetFileResp, error) { // 发起请求 apiReq := req.apiReq @@ -1142,13 +1142,13 @@ func (f *file) Get(ctx context.Context, req *GetFileReq, options ...larkcore.Req // 上传图片 // -// - 上传图片接口，支持上传 JPEG、PNG、WEBP、GIF、TIFF、BMP、ICO格式图片。 +// - 上传图片接口，支持上传 JPEG、PNG、WEBP、GIF、TIFF、BMP、ICO 格式图片。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 图片大小不得超过10M，且不支持上传大小为0的图片 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 图片大小不得超过 10M，且不支持上传大小为 0 的图片 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_image.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_image.go func (i *image) Create(ctx context.Context, req *CreateImageReq, options ...larkcore.RequestOptionFunc) (*CreateImageResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -1171,13 +1171,13 @@ func (i *image) Create(ctx context.Context, req *CreateImageReq, options ...lark // 下载图片 // -// - 下载图片资源，只能下载当前应用所上传且图片类型为message的图片。 +// - 下载图片资源，只能下载当前应用所上传且图片类型为 message 的图片。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 只能下载机器人自己上传且图片类型为message的图片，avatar类型暂不支持下载;- 下载用户发送的资源，请使用[获取消息中的资源文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-resource/get)接口 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 只能下载机器人自己上传且图片类型为 message 的图片，avatar 类型暂不支持下载;- 下载用户发送的资源，请使用 [获取消息中的资源文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-resource/get) 接口 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_image.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_image.go func (i *image) Get(ctx context.Context, req *GetImageReq, options ...larkcore.RequestOptionFunc) (*GetImageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1205,13 +1205,13 @@ func (i *image) Get(ctx context.Context, req *GetImageReq, options ...larkcore.R // 发送消息 // -// - 给指定用户或者会话发送消息，支持文本、富文本、可交互的[消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)、群名片、个人名片、图片、视频、音频、文件、表情包。 +// - 给指定用户或者会话发送消息，支持文本、富文本、可交互的 [消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)、群名片、个人名片、图片、视频、音频、文件、表情包。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 给用户发送消息，需要机器人对用户有[可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability);- 给群组发送消息，需要机器人在群组中 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 给用户发送消息，需要机器人对用户有 [可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability);- 给群组发送消息，需要机器人在群组中 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_message.go func (m *message) Create(ctx context.Context, req *CreateMessageReq, options ...larkcore.RequestOptionFunc) (*CreateMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1235,11 +1235,11 @@ func (m *message) Create(ctx context.Context, req *CreateMessageReq, options ... // // - 机器人撤回机器人自己发送的消息或群主撤回群内消息。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ，撤回消息时机器人仍需要在会话内;- 机器人可以撤回单聊和群组内，自己发送 且 发送时间不超过1天(24小时)的消息;- 若机器人要撤回群内他人发送的消息，则机器人必须是该群的群主、管理员 或者 创建者，且消息发送时间不超过1年;- 无法撤回通过「[批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)」接口发送的消息 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ，撤回消息时机器人仍需要在会话内;- 机器人可以撤回单聊和群组内，自己发送 且 发送时间不超过 1 天 (24 小时) 的消息;- 若机器人要撤回群内他人发送的消息，则机器人必须是该群的群主、管理员 或者 创建者，且消息发送时间不超过 1 年;- 无法撤回通过「[批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)」接口发送的消息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_message.go func (m *message) Delete(ctx context.Context, req *DeleteMessageReq, options ...larkcore.RequestOptionFunc) (*DeleteMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1263,11 +1263,11 @@ func (m *message) Delete(ctx context.Context, req *DeleteMessageReq, options ... // // - 通过 message_id 查询消息内容。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 机器人必须在群组中 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 机器人必须在群组中 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_message.go func (m *message) Get(ctx context.Context, req *GetMessageReq, options ...larkcore.RequestOptionFunc) (*GetMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1293,11 +1293,11 @@ func (m *message) Get(ctx context.Context, req *GetMessageReq, options ...larkco // // - 接口级别权限默认只能获取单聊（p2p）消息，如果需要获取群组（group）消息，应用还必须拥有 **==获取群组中所有消息==** 权限 // -// - - 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 获取消息时，机器人必须在群组中 +// - - 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 获取消息时，机器人必须在群组中 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_message.go func (m *message) List(ctx context.Context, req *ListMessageReq, options ...larkcore.RequestOptionFunc) (*ListMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1329,11 +1329,11 @@ func (m *message) ListByIterator(ctx context.Context, req *ListMessageReq, optio // // - 更新应用已发送的消息卡片内容。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 若以user_access_token更新消息，该操作用户必须是卡片消息的发送者;- 仅支持对所有人更新**未撤回**的[「共享卡片」](ukTMukTMukTM/uAjNwUjLwYDM14CM2ATN)消息，需在卡片的config属性中，显式声明 =="update_multi":true==。 ;- **不支持更新批量消息**;- 文本消息请求体最大不能超过150KB；卡片及富文本消息请求体最大不能超过30KB;- 仅支持修改14天内发送的消息;- 单条消息更新频控为**5QPS** +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 若以 user_access_token 更新消息，该操作用户必须是卡片消息的发送者;- 仅支持对所有人更新 ** 未撤回 ** 的 [「共享卡片」](ukTMukTMukTM/uAjNwUjLwYDM14CM2ATN) 消息，需在卡片的 config 属性中，显式声明 =="update_multi":true==。 ;- ** 不支持更新批量消息 **;- 文本消息请求体最大不能超过 150KB；卡片及富文本消息请求体最大不能超过 30KB;- 仅支持修改 14 天内发送的消息;- 单条消息更新频控为 **5QPS** // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/patch_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/patch_message.go func (m *message) Patch(ctx context.Context, req *PatchMessageReq, options ...larkcore.RequestOptionFunc) (*PatchMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1357,11 +1357,11 @@ func (m *message) Patch(ctx context.Context, req *PatchMessageReq, options ...la // // - 查询消息的已读信息。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能查询机器人自己发送，且发送时间不超过7天的消息;- 查询消息已读信息时机器人仍需要在会话内;- 本接口不支持查询批量消息 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能查询机器人自己发送，且发送时间不超过 7 天的消息;- 查询消息已读信息时机器人仍需要在会话内;- 本接口不支持查询批量消息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/read_users +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/read_users // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/readUsers_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/readUsers_message.go func (m *message) ReadUsers(ctx context.Context, req *ReadUsersMessageReq, options ...larkcore.RequestOptionFunc) (*ReadUsersMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1385,11 +1385,11 @@ func (m *message) ReadUsers(ctx context.Context, req *ReadUsersMessageReq, optio // // - 回复指定消息，支持文本、富文本、卡片、群名片、个人名片、图片、视频、文件等多种消息类型。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 回复私聊消息，需要机器人对用户有[可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability);- 回复群组消息，需要机器人在群中 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 回复私聊消息，需要机器人对用户有 [可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability);- 回复群组消息，需要机器人在群中 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/reply +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/reply // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/reply_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/reply_message.go func (m *message) Reply(ctx context.Context, req *ReplyMessageReq, options ...larkcore.RequestOptionFunc) (*ReplyMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1413,13 +1413,13 @@ func (m *message) Reply(ctx context.Context, req *ReplyMessageReq, options ...la // // - 对指定消息进行应用内加急。 // -// - 特别说明：;- 默认接口限流为50 QPS，请谨慎调用 +// - 特别说明：;- 默认接口限流为 50 QPS，请谨慎调用 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 不支持加急批量消息;- 只能加急机器人自己发送的消息;- 加急时机器人需要在加急消息所在的群中;- 调用本接口需要用户已阅读加急的消息才可以继续加急（用户未读的加急上限为200条） +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 不支持加急批量消息;- 只能加急机器人自己发送的消息;- 加急时机器人需要在加急消息所在的群中;- 调用本接口需要用户已阅读加急的消息才可以继续加急（用户未读的加急上限为 200 条） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_app +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_app // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/urgentApp_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/urgentApp_message.go func (m *message) UrgentApp(ctx context.Context, req *UrgentAppMessageReq, options ...larkcore.RequestOptionFunc) (*UrgentAppMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1443,13 +1443,13 @@ func (m *message) UrgentApp(ctx context.Context, req *UrgentAppMessageReq, optio // // - 对指定消息进行应用内加急与电话加急。 // -// - 特别说明：;- 通过接口产生的电话加急将消耗企业的加急额度，请慎重调用;- 通过[租户管理后台](https://admin.feishu.cn/)-费用中心-短信/电话加急 可以查看当前额度;- 默认接口限流为50 QPS，请谨慎调用 +// - 特别说明：;- 通过接口产生的电话加急将消耗企业的加急额度，请慎重调用;- 通过 [租户管理后台](https://admin.feishu.cn/)-费用中心 - 短信/电话加急 可以查看当前额度;- 默认接口限流为 50 QPS，请谨慎调用 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能加急机器人自己发送的消息;- 加急时机器人需要在加急消息所在的群组中;- 需要用户阅读已加急的消息才可以继续加急（用户未读的加急上限为200条） +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能加急机器人自己发送的消息;- 加急时机器人需要在加急消息所在的群组中;- 需要用户阅读已加急的消息才可以继续加急（用户未读的加急上限为 200 条） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_phone +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_phone // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/urgentPhone_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/urgentPhone_message.go func (m *message) UrgentPhone(ctx context.Context, req *UrgentPhoneMessageReq, options ...larkcore.RequestOptionFunc) (*UrgentPhoneMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1473,13 +1473,13 @@ func (m *message) UrgentPhone(ctx context.Context, req *UrgentPhoneMessageReq, o // // - 对指定消息进行应用内加急与短信加急。 // -// - 特别说明：;- 通过接口产生的短信加急将消耗企业的加急额度，请慎重调用;- 通过[租户管理后台](https://admin.feishu.cn/)-费用中心-短信/电话加急 可以查看当前额度;- 默认接口限流为50 QPS，请谨慎调用 +// - 特别说明：;- 通过接口产生的短信加急将消耗企业的加急额度，请慎重调用;- 通过 [租户管理后台](https://admin.feishu.cn/)-费用中心 - 短信/电话加急 可以查看当前额度;- 默认接口限流为 50 QPS，请谨慎调用 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能加急机器人自己发送的消息;- 加急时机器人仍需要在加急消息所在的群组中;- 调用本接口需要用户已阅读加急的消息才可以继续加急（用户未读的加急上限为200条） +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能加急机器人自己发送的消息;- 加急时机器人仍需要在加急消息所在的群组中;- 调用本接口需要用户已阅读加急的消息才可以继续加急（用户未读的加急上限为 200 条） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_sms +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/urgent_sms // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/urgentSms_message.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/urgentSms_message.go func (m *message) UrgentSms(ctx context.Context, req *UrgentSmsMessageReq, options ...larkcore.RequestOptionFunc) (*UrgentSmsMessageResp, error) { // 发起请求 apiReq := req.apiReq @@ -1501,13 +1501,13 @@ func (m *message) UrgentSms(ctx context.Context, req *UrgentSmsMessageReq, optio // 添加消息表情回复 // -// - 给指定消息添加指定类型的表情回复（reaction即表情回复，本文档统一用“reaction”代称）。 +// - 给指定消息添加指定类型的表情回复（reaction 即表情回复，本文档统一用 “reaction” 代称）。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 待添加reaction的消息要真实存在，不能被撤回;- 给消息添加reaction，需要reaction的发送方（机器人或者用户）在消息所在的会话内 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 待添加 reaction 的消息要真实存在，不能被撤回;- 给消息添加 reaction，需要 reaction 的发送方（机器人或者用户）在消息所在的会话内 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_messageReaction.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_messageReaction.go func (m *messageReaction) Create(ctx context.Context, req *CreateMessageReactionReq, options ...larkcore.RequestOptionFunc) (*CreateMessageReactionResp, error) { // 发起请求 apiReq := req.apiReq @@ -1529,13 +1529,13 @@ func (m *messageReaction) Create(ctx context.Context, req *CreateMessageReaction // 删除消息表情回复 // -// - 删除指定消息的表情回复（reaction即表情回复，本文档统一用“reaction”代称）。 +// - 删除指定消息的表情回复（reaction 即表情回复，本文档统一用 “reaction” 代称）。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能删除真实存在的reaction，并且删除reaction请求的操作者必须是reaction的原始添加者 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 只能删除真实存在的 reaction，并且删除 reaction 请求的操作者必须是 reaction 的原始添加者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_messageReaction.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_messageReaction.go func (m *messageReaction) Delete(ctx context.Context, req *DeleteMessageReactionReq, options ...larkcore.RequestOptionFunc) (*DeleteMessageReactionResp, error) { // 发起请求 apiReq := req.apiReq @@ -1557,13 +1557,13 @@ func (m *messageReaction) Delete(ctx context.Context, req *DeleteMessageReaction // 获取消息表情回复 // -// - 获取指定消息的特定类型表情回复列表（reaction即表情回复，本文档统一用“reaction”代称）。 +// - 获取指定消息的特定类型表情回复列表（reaction 即表情回复，本文档统一用 “reaction” 代称）。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 待获取reaction信息的消息要真实存在，不能被撤回;- 获取消息的reaction，需要request的授权主体（机器人或者用户）在消息所在的会话内 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 待获取 reaction 信息的消息要真实存在，不能被撤回;- 获取消息的 reaction，需要 request 的授权主体（机器人或者用户）在消息所在的会话内 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_messageReaction.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_messageReaction.go func (m *messageReaction) List(ctx context.Context, req *ListMessageReactionReq, options ...larkcore.RequestOptionFunc) (*ListMessageReactionResp, error) { // 发起请求 apiReq := req.apiReq @@ -1593,13 +1593,13 @@ func (m *messageReaction) ListByIterator(ctx context.Context, req *ListMessageRe // 获取消息中的资源文件 // -// - 获取消息中的资源文件，包括音频，视频，图片和文件，**暂不支持表情包资源下载**。当前仅支持 100M 以内的资源文件的下载。 +// - 获取消息中的资源文件，包括音频，视频，图片和文件，** 暂不支持表情包资源下载 **。当前仅支持 100M 以内的资源文件的下载。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人和消息需要在同一会话中;- 暂不支持获取合并转发消息中的子消息的资源文件 +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability);- 机器人和消息需要在同一会话中;- 暂不支持获取合并转发消息中的子消息的资源文件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-resource/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-resource/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_messageResource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/get_messageResource.go func (m *messageResource) Get(ctx context.Context, req *GetMessageResourceReq, options ...larkcore.RequestOptionFunc) (*GetMessageResourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -1625,15 +1625,15 @@ func (m *messageResource) Get(ctx context.Context, req *GetMessageResourceReq, o return resp, err } -// Pin消息 +// Pin 消息 // -// - Pin一条指定的消息。 +// - Pin 一条指定的消息。 // -// - 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- Pin消息时，机器人必须在对应的群组中;- 若消息已经被Pin，返回该Pin的操作信息;- 不能Pin一条对操作者不可见的消息;- 对同一条消息的Pin操作不能超过==5 QPS== +// - 注意事项:;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- Pin 消息时，机器人必须在对应的群组中;- 若消息已经被 Pin，返回该 Pin 的操作信息;- 不能 Pin 一条对操作者不可见的消息;- 对同一条消息的 Pin 操作不能超过==5 QPS== // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/pin/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/pin/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_pin.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/create_pin.go func (p *pin) Create(ctx context.Context, req *CreatePinReq, options ...larkcore.RequestOptionFunc) (*CreatePinResp, error) { // 发起请求 apiReq := req.apiReq @@ -1653,15 +1653,15 @@ func (p *pin) Create(ctx context.Context, req *CreatePinReq, options ...larkcore return resp, err } -// 移除Pin消息 +// 移除 Pin 消息 // -// - 移除一条指定消息的Pin。 +// - 移除一条指定消息的 Pin。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 移除Pin消息时，机器人必须在对应的群组中;- 若消息未被Pin或已被撤回，返回成功信息;- 不能移除一条对操作者不可见的Pin消息;- 对同一条消息移除Pin的操作不能超过==5 QPS== +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 移除 Pin 消息时，机器人必须在对应的群组中;- 若消息未被 Pin 或已被撤回，返回成功信息;- 不能移除一条对操作者不可见的 Pin 消息;- 对同一条消息移除 Pin 的操作不能超过==5 QPS== // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/pin/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/pin/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_pin.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/delete_pin.go func (p *pin) Delete(ctx context.Context, req *DeletePinReq, options ...larkcore.RequestOptionFunc) (*DeletePinResp, error) { // 发起请求 apiReq := req.apiReq @@ -1681,15 +1681,15 @@ func (p *pin) Delete(ctx context.Context, req *DeletePinReq, options ...larkcore return resp, err } -// 获取群内Pin消息 +// 获取群内 Pin 消息 // -// - 获取所在群内指定时间范围内的所有Pin消息。 +// - 获取所在群内指定时间范围内的所有 Pin 消息。 // -// - 注意事项：;- 需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 获取Pin消息时，机器人必须在群组中;- 获取的Pin消息按Pin的创建时间降序排列;- 接口默认限流为==50 QPS== +// - 注意事项：;- 需要开启 [机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability) ;- 获取 Pin 消息时，机器人必须在群组中;- 获取的 Pin 消息按 Pin 的创建时间降序排列;- 接口默认限流为==50 QPS== // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/pin/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/pin/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_pin.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/imv1/list_pin.go func (p *pin) List(ctx context.Context, req *ListPinReq, options ...larkcore.RequestOptionFunc) (*ListPinResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/im/v1/event.go b/service/im/v1/event.go index 751b07bf..07a31b4c 100644 --- a/service/im/v1/event.go +++ b/service/im/v1/event.go @@ -32,7 +32,7 @@ func (h *P2ChatDisbandedV1Handler) Event() interface{} { return &P2ChatDisbandedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatDisbandedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatDisbandedV1)) } @@ -52,7 +52,7 @@ func (h *P2ChatUpdatedV1Handler) Event() interface{} { return &P2ChatUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatUpdatedV1)) } @@ -72,7 +72,7 @@ func (h *P2ChatMemberBotAddedV1Handler) Event() interface{} { return &P2ChatMemberBotAddedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatMemberBotAddedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatMemberBotAddedV1)) } @@ -92,7 +92,7 @@ func (h *P2ChatMemberBotDeletedV1Handler) Event() interface{} { return &P2ChatMemberBotDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatMemberBotDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatMemberBotDeletedV1)) } @@ -112,7 +112,7 @@ func (h *P2ChatMemberUserAddedV1Handler) Event() interface{} { return &P2ChatMemberUserAddedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatMemberUserAddedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatMemberUserAddedV1)) } @@ -132,7 +132,7 @@ func (h *P2ChatMemberUserDeletedV1Handler) Event() interface{} { return &P2ChatMemberUserDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatMemberUserDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatMemberUserDeletedV1)) } @@ -152,7 +152,7 @@ func (h *P2ChatMemberUserWithdrawnV1Handler) Event() interface{} { return &P2ChatMemberUserWithdrawnV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ChatMemberUserWithdrawnV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ChatMemberUserWithdrawnV1)) } @@ -172,7 +172,7 @@ func (h *P2MessageReadV1Handler) Event() interface{} { return &P2MessageReadV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MessageReadV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MessageReadV1)) } @@ -192,7 +192,7 @@ func (h *P2MessageRecalledV1Handler) Event() interface{} { return &P2MessageRecalledV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MessageRecalledV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MessageRecalledV1)) } @@ -212,7 +212,7 @@ func (h *P2MessageReceiveV1Handler) Event() interface{} { return &P2MessageReceiveV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MessageReceiveV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MessageReceiveV1)) } @@ -232,7 +232,7 @@ func (h *P2MessageReactionCreatedV1Handler) Event() interface{} { return &P2MessageReactionCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MessageReactionCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MessageReactionCreatedV1)) } @@ -252,7 +252,7 @@ func (h *P2MessageReactionDeletedV1Handler) Event() interface{} { return &P2MessageReactionDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MessageReactionDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MessageReactionDeletedV1)) } diff --git a/service/im/v1/ext_model.go b/service/im/v1/ext_model.go index 8af0d547..2c2ad120 100644 --- a/service/im/v1/ext_model.go +++ b/service/im/v1/ext_model.go @@ -31,13 +31,13 @@ type P1AddBotV1Data struct { AppID string `json:"app_id,omitempty"` // 应用 ID ChatI18nNames *ChatI18nNames `json:"chat_i18n_names,omitempty"` // 群名称国际化字段 ChatName string `json:"chat_name,omitempty"` // 群名称 - ChatOwnerEmployeeID string `json:"chat_owner_employee_id,omitempty"` // 群主的employee_id（即“用户ID”。如果群主是机器人则没有这个字段，仅企业自建应用返回） + ChatOwnerEmployeeID string `json:"chat_owner_employee_id,omitempty"` // 群主的 employee_id（即 “用户 ID”。如果群主是机器人则没有这个字段，仅企业自建应用返回） ChatOwnerName string `json:"chat_owner_name,omitempty"` // 群主姓名 - ChatOwnerOpenID string `json:"chat_owner_open_id,omitempty"` // 群主的open_id - OpenChatID string `json:"open_chat_id,omitempty"` // 群聊的id - OperatorEmployeeID string `json:"operator_employee_id,omitempty"` // 操作者的emplolyee_id ，仅企业自建应用返回 + ChatOwnerOpenID string `json:"chat_owner_open_id,omitempty"` // 群主的 open_id + OpenChatID string `json:"open_chat_id,omitempty"` // 群聊的 id + OperatorEmployeeID string `json:"operator_employee_id,omitempty"` // 操作者的 emplolyee_id，仅企业自建应用返回 OperatorName string `json:"operator_name,omitempty"` // 操作者姓名 - OperatorOpenID string `json:"operator_open_id,omitempty"` //操作者的open_id + OperatorOpenID string `json:"operator_open_id,omitempty"` //操作者的 open_id OwnerIsBot bool `json:"owner_is_bot,omitempty"` //群主是否是机器人 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 } @@ -57,13 +57,13 @@ type P1RemoveBotV1Data struct { AppID string `json:"app_id,omitempty"` // 应用 ID ChatI18nNames *ChatI18nNames `json:"chat_i18n_names,omitempty"` // 群名称国际化字段 ChatName string `json:"chat_name,omitempty"` // 群名称 - ChatOwnerEmployeeID string `json:"chat_owner_employee_id,omitempty"` // 群主的employee_id（即“用户ID”。如果群主是机器人则没有这个字段，仅企业自建应用返回） + ChatOwnerEmployeeID string `json:"chat_owner_employee_id,omitempty"` // 群主的 employee_id（即 “用户 ID”。如果群主是机器人则没有这个字段，仅企业自建应用返回） ChatOwnerName string `json:"chat_owner_name,omitempty"` // 群主姓名 - ChatOwnerOpenID string `json:"chat_owner_open_id,omitempty"` // 群主的open_id - OpenChatID string `json:"open_chat_id,omitempty"` // 群聊的id + ChatOwnerOpenID string `json:"chat_owner_open_id,omitempty"` // 群主的 open_id + OpenChatID string `json:"open_chat_id,omitempty"` // 群聊的 id OperatorEmployeeID string `json:"operator_employee_id,omitempty"` // 操作者姓名 - OperatorName string `json:"operator_name,omitempty"` // 操作者的emplolyee_id ，仅企业自建应用返回 - OperatorOpenID string `json:"operator_open_id,omitempty"` //操作者的open_id + OperatorName string `json:"operator_name,omitempty"` // 操作者的 emplolyee_id，仅企业自建应用返回 + OperatorOpenID string `json:"operator_open_id,omitempty"` //操作者的 open_id OwnerIsBot bool `json:"owner_is_bot,omitempty"` //群主是否是机器人 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 } @@ -86,7 +86,7 @@ type P1P2PChatCreatedV1 struct { type P1P2PChatCreatedV1Data struct { AppID string `json:"app_id,omitempty"` // APP ID - ChatID string `json:"chat_id,omitempty"` //机器人和用户的会话id + ChatID string `json:"chat_id,omitempty"` //机器人和用户的会话 id Operator *P1OperatorV1 `json:"operator,omitempty"` // 会话的发起人。可能是用户，也可能是机器人。 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 Type string `json:"type,omitempty"` // 事件类型 @@ -98,21 +98,21 @@ func (m *P1P2PChatCreatedV1) RawReq(req *larkevent.EventReq) { } type P1OperatorV1 struct { - OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 - UserId string `json:"user_id,omitempty"` // 即“用户ID”，仅企业自建应用会返回 + OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 + UserId string `json:"user_id,omitempty"` // 即 “用户 ID”，仅企业自建应用会返回 } type P1UserV1 struct { - OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 - UserId string `json:"user_id,omitempty"` // 即“用户ID”，仅企业自建应用会返回 + OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 + UserId string `json:"user_id,omitempty"` // 即 “用户 ID”，仅企业自建应用会返回 Name string `json:"name,omitempty"` // 姓名 } type P1UserInOutChatV1Data struct { Type string `json:"type,omitempty"` // 事件类型，add_user_to_chat/remove_user_from_chat/revoke_add_user_from_chat AppID string `json:"app_id,omitempty"` // APP ID - ChatId string `json:"chat_id,omitempty"` // 群聊的id - Operator *P1OperatorV1 `json:"operator,omitempty"` // 用户进出群的操作人。用户主动退群的话，operator 就是user自己 + ChatId string `json:"chat_id,omitempty"` // 群聊的 id + Operator *P1OperatorV1 `json:"operator,omitempty"` // 用户进出群的操作人。用户主动退群的话，operator 就是 user 自己 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 Users []*P1UserV1 `json:"users,omitempty"` } @@ -130,7 +130,7 @@ func (m *P1UserInOutChatV1) RawReq(req *larkevent.EventReq) { type P1ChatDisbandV1Data struct { Type string `json:"type,omitempty"` // 事件类型 AppID string `json:"app_id,omitempty"` // APP ID - ChatId string `json:"chat_id,omitempty"` // 群聊的id + ChatId string `json:"chat_id,omitempty"` // 群聊的 id Operator *P1OperatorV1 `json:"operator,omitempty"` // 解散群的人 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 } @@ -146,16 +146,16 @@ func (m *P1ChatDisbandV1) RawReq(req *larkevent.EventReq) { } type P1GroupSettingChangeV1 struct { - OwnerOpenId string `json:"owner_open_id,omitempty"` // 当群主发生变化时会有下面2个字段。若群主未发生变化，则不会有这2个字段。 - OwnerUserId string `json:"owner_user_id,omitempty"` // 当群主发生变化时会有下面2个字段。若群主未发生变化，则不会有这2个字段。 - AddMemberPermission string `json:"add_member_permission,omitempty"` // 当“仅群主可添加群成员”配置变化时有下面的字段。 - MessageNotification bool `json:"message_notification,omitempty"` // 当“消息提醒”配置变化时有下面的字段。 + OwnerOpenId string `json:"owner_open_id,omitempty"` // 当群主发生变化时会有下面 2 个字段。若群主未发生变化，则不会有这 2 个字段。 + OwnerUserId string `json:"owner_user_id,omitempty"` // 当群主发生变化时会有下面 2 个字段。若群主未发生变化，则不会有这 2 个字段。 + AddMemberPermission string `json:"add_member_permission,omitempty"` // 当 “仅群主可添加群成员” 配置变化时有下面的字段。 + MessageNotification bool `json:"message_notification,omitempty"` // 当 “消息提醒” 配置变化时有下面的字段。 } type P1GroupSettingUpdatedV1Data struct { Type string `json:"type,omitempty"` // 事件类型 - AppID string `json:"app_id,omitempty"` // 应用ID - ChatId string `json:"chat_id,omitempty"` // 群聊ID + AppID string `json:"app_id,omitempty"` // 应用 ID + ChatId string `json:"chat_id,omitempty"` // 群聊 ID Operator *P1OperatorV1 `json:"operator,omitempty"` // 配置变化的操作者 TenantKey string `json:"tenant_key,omitempty"` // 企业标识 BeforeChange *P1GroupSettingChangeV1 `json:"before_change,omitempty"` @@ -172,10 +172,10 @@ func (m *P1GroupSettingUpdatedV1) RawReq(req *larkevent.EventReq) { m.EventReq = req } -// protocol v1的 Message_Read +// protocol v1 的 Message_Read type P1MessageReadV1Data struct { MessageIdList []string `json:"message_id_list,omitempty"` // 已读消息列表 - AppID string `json:"app_id"` // 应用ID + AppID string `json:"app_id"` // 应用 ID OpenAppID string `json:"open_chat_id"` OpenID string `json:"open_id"` TenantKey string `json:"tenant_key"` // 企业标识 @@ -192,7 +192,7 @@ func (m *P1MessageReadV1) RawReq(req *larkevent.EventReq) { m.EventReq = req } -// protocol v1的 message +// protocol v1 的 message type P1MessageReceiveV1 struct { *larkevent.EventBase *larkevent.EventReq @@ -205,28 +205,28 @@ func (m *P1MessageReceiveV1) RawReq(req *larkevent.EventReq) { type P1MessageReceiveV1Data struct { Type string `json:"type,omitempty"` // 事件类型 - AppID string `json:"app_id,omitempty"` // 应用ID + AppID string `json:"app_id,omitempty"` // 应用 ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 RootID string `json:"root_id,omitempty"` ParentID string `json:"parent_id,omitempty"` - OpenChatID string `json:"open_chat_id,omitempty"` //发消息的open_chat_id - ChatType string `json:"chat_type,omitempty"` //私聊private，群聊group + OpenChatID string `json:"open_chat_id,omitempty"` //发消息的 open_chat_id + ChatType string `json:"chat_type,omitempty"` //私聊 private，群聊 group MsgType string `json:"msg_type,omitempty"` //消息类型 - OpenID string `json:"open_id,omitempty"` //发消息的用户open_id - EmployeeID string `json:"employee_id,omitempty"` // 即“用户ID”，仅企业自建应用会返回 - UnionID string `json:"union_id,omitempty"` //发消息的用户union_id - OpenMessageID string `json:"open_message_id,omitempty"` //消息id + OpenID string `json:"open_id,omitempty"` //发消息的用户 open_id + EmployeeID string `json:"employee_id,omitempty"` // 即 “用户 ID”，仅企业自建应用会返回 + UnionID string `json:"union_id,omitempty"` //发消息的用户 union_id + OpenMessageID string `json:"open_message_id,omitempty"` //消息 id IsMention bool `json:"is_mention,omitempty"` - Text string `json:"text,omitempty"` // 消息文本，可能包含被@的人/机器人。 - TextWithoutAtBot string `json:"text_without_at_bot,omitempty"` //消息内容，会过滤掉at你的机器人的内容，当内容只有at机器人，该字段会被过滤。 + Text string `json:"text,omitempty"` // 消息文本，可能包含被 @的人/机器人。 + TextWithoutAtBot string `json:"text_without_at_bot,omitempty"` //消息内容，会过滤掉 at 你的机器人的内容，当内容只有 at 机器人，该字段会被过滤。 Title string `json:"title,omitempty"` //消息标题 - ImageKeys []string `json:"image_keys,omitempty"` //富文本里面的图片的keys + ImageKeys []string `json:"image_keys,omitempty"` //富文本里面的图片的 keys ImageKey string `json:"image_key,omitempty"` // image_key，获取图片内容请查/ssl:ttdoc/ukTMukTMukTM/uYzN5QjL2cTO04iN3kDN FileKey string `json:"file_key,omitempty"` } /** -text类型消息结构化 +text 类型消息结构化 */ type MessageText struct { builder strings.Builder @@ -267,7 +267,6 @@ func (t *MessageText) AtUser(userId, name string) *MessageText { t.builder.WriteString(name) t.builder.WriteString("") return t - return t } func (t *MessageText) AtAll() *MessageText { @@ -282,7 +281,7 @@ func (t *MessageText) Build() string { } /** - post类型消息结构化 + post 类型消息结构化 **/ func NewMessagePost() *MessagePost { @@ -441,7 +440,7 @@ func (m *MessagePostMedia) MarshalJSON() ([]byte, error) { } /** - image类型消息结构化 + image 类型消息结构化 **/ type MessageImage struct { ImageKey string `json:"image_key,omitempty"` @@ -471,7 +470,7 @@ func (m *MessageFile) String() (string, error) { } /** -audio类型消息结构化 +audio 类型消息结构化 **/ type MessageAudio struct { FileKey string `json:"file_key,omitempty"` @@ -486,7 +485,7 @@ func (m *MessageAudio) String() (string, error) { } /** -media类型消息结构化 +media 类型消息结构化 **/ type MessageMedia struct { FileKey string `json:"file_key,omitempty"` diff --git a/service/im/v1/model.go b/service/im/v1/model.go index 99679482..8822b1ad 100644 --- a/service/im/v1/model.go +++ b/service/im/v1/model.go @@ -31,66 +31,66 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetChatUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetChatUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetChatOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetChatUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetChatUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetChatOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - ValidityPeriodOneWeek = "week" // 有效期7天 - ValidityPeriodOneYear = "year" // 有效期1年 + ValidityPeriodOneWeek = "week" // 有效期 7 天 + ValidityPeriodOneYear = "year" // 有效期 1 年 ValidityPeriodPermanently = "permanently" // 永久有效 ) const ( - UserIdTypeListChatUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListChatUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListChatOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListChatUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListChatUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListChatOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeSearchChatUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSearchChatUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSearchChatOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeSearchChatUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSearchChatUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSearchChatOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateChatUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateChatUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateChatOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateChatUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateChatUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateChatOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetChatAnnouncementUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetChatAnnouncementUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetChatAnnouncementOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetChatAnnouncementUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetChatAnnouncementUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetChatAnnouncementOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - MemberIdTypeUserId = "user_id" // 以user_id来识别成员 - MemberIdTypeUnionId = "union_id" // 以union_id来识别成员 - MemberIdTypeOpenId = "open_id" // 以open_id来识别成员 - MemberIdTypeAppId = "app_id" // 以app_id来识别成员 + MemberIdTypeUserId = "user_id" // 以 user_id 来识别成员 + MemberIdTypeUnionId = "union_id" // 以 union_id 来识别成员 + MemberIdTypeOpenId = "open_id" // 以 open_id 来识别成员 + MemberIdTypeAppId = "app_id" // 以 app_id 来识别成员 ) const ( - MemberIdTypeDeleteManagersChatManagersUserId = "user_id" // 以user_id来识别成员 - MemberIdTypeDeleteManagersChatManagersUnionId = "union_id" // 以union_id来识别成员 - MemberIdTypeDeleteManagersChatManagersOpenId = "open_id" // 以open_id来识别成员 - MemberIdTypeDeleteManagersChatManagersAppId = "app_id" // 以app_id来识别成员 + MemberIdTypeDeleteManagersChatManagersUserId = "user_id" // 以 user_id 来识别成员 + MemberIdTypeDeleteManagersChatManagersUnionId = "union_id" // 以 union_id 来识别成员 + MemberIdTypeDeleteManagersChatManagersOpenId = "open_id" // 以 open_id 来识别成员 + MemberIdTypeDeleteManagersChatManagersAppId = "app_id" // 以 app_id 来识别成员 ) const ( - MemberIdTypeCreateChatMembersUserId = "user_id" // 以user_id来识别成员 - MemberIdTypeCreateChatMembersUnionId = "union_id" // 以union_id来识别成员 - MemberIdTypeCreateChatMembersOpenId = "open_id" // 以open_id来识别成员 - MemberIdTypeCreateChatMembersAppId = "app_id" // 以app_id来识别成员 + MemberIdTypeCreateChatMembersUserId = "user_id" // 以 user_id 来识别成员 + MemberIdTypeCreateChatMembersUnionId = "union_id" // 以 union_id 来识别成员 + MemberIdTypeCreateChatMembersOpenId = "open_id" // 以 open_id 来识别成员 + MemberIdTypeCreateChatMembersAppId = "app_id" // 以 app_id 来识别成员 ) const ( @@ -101,38 +101,38 @@ const ( ) const ( - MemberIdTypeDeleteChatMembersUserId = "user_id" // 以user_id来识别成员 - MemberIdTypeDeleteChatMembersUnionId = "union_id" // 以union_id来识别成员 - MemberIdTypeDeleteChatMembersOpenId = "open_id" // 以open_id来识别成员 - MemberIdTypeDeleteChatMembersAppId = "app_id" // 以app_id来识别成员 + MemberIdTypeDeleteChatMembersUserId = "user_id" // 以 user_id 来识别成员 + MemberIdTypeDeleteChatMembersUnionId = "union_id" // 以 union_id 来识别成员 + MemberIdTypeDeleteChatMembersOpenId = "open_id" // 以 open_id 来识别成员 + MemberIdTypeDeleteChatMembersAppId = "app_id" // 以 app_id 来识别成员 ) const ( - MemberIdTypeGetChatMembersUserId = "user_id" // 以user_id来识别成员 - MemberIdTypeGetChatMembersUnionId = "union_id" // 以union_id来识别成员 - MemberIdTypeGetChatMembersOpenId = "open_id" // 以open_id来识别成员 + MemberIdTypeGetChatMembersUserId = "user_id" // 以 user_id 来识别成员 + MemberIdTypeGetChatMembersUnionId = "union_id" // 以 union_id 来识别成员 + MemberIdTypeGetChatMembersOpenId = "open_id" // 以 open_id 来识别成员 ) const ( - UserIdTypeGetChatModerationUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetChatModerationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetChatModerationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetChatModerationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetChatModerationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetChatModerationOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateChatModerationUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateChatModerationUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateChatModerationOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateChatModerationUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateChatModerationUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateChatModerationOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - FileTypeOpus = "opus" // 上传opus音频文件 - FileTypeMp4 = "mp4" // 上传mp4视频文件 - FileTypePdf = "pdf" // 上传pdf格式文件 - FileTypeDoc = "doc" // 上传doc格式文件 - FileTypeXls = "xls" // 上传xls格式文件 - FileTypePpt = "ppt" // 上传ppt格式文件 - FileTypeStream = "stream" // 上传stream格式文件 + FileTypeOpus = "opus" // 上传 opus 音频文件 + FileTypeMp4 = "mp4" // 上传 mp4 视频文件 + FileTypePdf = "pdf" // 上传 pdf 格式文件 + FileTypeDoc = "doc" // 上传 doc 格式文件 + FileTypeXls = "xls" // 上传 xls 格式文件 + FileTypePpt = "ppt" // 上传 ppt 格式文件 + FileTypeStream = "stream" // 上传 stream 格式文件 ) const ( @@ -141,35 +141,35 @@ const ( ) const ( - ReceiveIdTypeOpenId = "open_id" // 以open_id来识别用户 - ReceiveIdTypeUserId = "user_id" // 以user_id来识别用户 - ReceiveIdTypeUnionId = "union_id" // 以union_id来识别用户 - ReceiveIdTypeEmail = "email" // 以email来识别用户 - ReceiveIdTypeChatId = "chat_id" // 以chat_id来识别群聊 + ReceiveIdTypeOpenId = "open_id" // 以 open_id 来识别用户 + ReceiveIdTypeUserId = "user_id" // 以 user_id 来识别用户 + ReceiveIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + ReceiveIdTypeEmail = "email" // 以 email 来识别用户 + ReceiveIdTypeChatId = "chat_id" // 以 chat_id 来识别群聊 ) const ( - UserIdTypeReadUsersMessageUserId = "user_id" // 以user_id来识别用户 - UserIdTypeReadUsersMessageUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeReadUsersMessageOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeReadUsersMessageUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeReadUsersMessageUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeReadUsersMessageOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUrgentAppMessageUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUrgentAppMessageUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUrgentAppMessageOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUrgentAppMessageUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUrgentAppMessageUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUrgentAppMessageOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUrgentPhoneMessageUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUrgentPhoneMessageUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUrgentPhoneMessageOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUrgentPhoneMessageUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUrgentPhoneMessageUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUrgentPhoneMessageOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUrgentSmsMessageUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUrgentSmsMessageUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUrgentSmsMessageOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUrgentSmsMessageUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUrgentSmsMessageUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUrgentSmsMessageOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -209,7 +209,7 @@ func (builder *BatchMessageBuilder) BatchMessageId(batchMessageId string) *Batch // 发送进度 // -// 示例值：json结构 +// 示例值：json 结构 func (builder *BatchMessageBuilder) BatchSendProgress(batchSendProgress *BatchSendProgress) *BatchMessageBuilder { builder.batchSendProgress = batchSendProgress builder.batchSendProgressFlag = true @@ -218,7 +218,7 @@ func (builder *BatchMessageBuilder) BatchSendProgress(batchSendProgress *BatchSe // 撤回进度 // -// 示例值：json结构 +// 示例值：json 结构 func (builder *BatchMessageBuilder) BatchRecallProgress(batchRecallProgress *BatchRecallProgress) *BatchMessageBuilder { builder.batchRecallProgress = batchRecallProgress builder.batchRecallProgressFlag = true @@ -337,15 +337,15 @@ func (builder *BatchMessageRecallProgressBuilder) Build() *BatchMessageRecallPro } type BatchMessageSendProgress struct { - ValidUserIdsCount *int `json:"valid_user_ids_count,omitempty"` // 批量请求中有效的userid数量(包含机器人不可见用户);;;;**注意**： ;当valid_user_ids_count为0有两种情况：;* 批量任务还没有开始被调度（请等待一会再调用该接口）;* 批量发送消息时传入的所有openIDs、employeID、departmentiIDs都不包含有效的用户 - SuccessUserIdsCount *int `json:"success_user_ids_count,omitempty"` // 已经成功给用户发送成功的消息数量;;;;**注意**：最终success_user_ids_count不一定等于valid_user_ids_count, 因为valid_user_ids_count包含了对机器人不可见的用户 + ValidUserIdsCount *int `json:"valid_user_ids_count,omitempty"` // 批量请求中有效的 userid 数量 (包含机器人不可见用户);;;;** 注意 **： ;当 valid_user_ids_count 为 0 有两种情况：;* 批量任务还没有开始被调度（请等待一会再调用该接口）;* 批量发送消息时传入的所有 openIDs、employeID、departmentiIDs 都不包含有效的用户 + SuccessUserIdsCount *int `json:"success_user_ids_count,omitempty"` // 已经成功给用户发送成功的消息数量;;;;** 注意 **：最终 success_user_ids_count 不一定等于 valid_user_ids_count，因为 valid_user_ids_count 包含了对机器人不可见的用户 ReadUserIdsCount *int `json:"read_user_ids_count,omitempty"` // 已读信息用户数量 } type BatchMessageSendProgressBuilder struct { - validUserIdsCount int // 批量请求中有效的userid数量(包含机器人不可见用户);;;;**注意**： ;当valid_user_ids_count为0有两种情况：;* 批量任务还没有开始被调度（请等待一会再调用该接口）;* 批量发送消息时传入的所有openIDs、employeID、departmentiIDs都不包含有效的用户 + validUserIdsCount int // 批量请求中有效的 userid 数量 (包含机器人不可见用户);;;;** 注意 **： ;当 valid_user_ids_count 为 0 有两种情况：;* 批量任务还没有开始被调度（请等待一会再调用该接口）;* 批量发送消息时传入的所有 openIDs、employeID、departmentiIDs 都不包含有效的用户 validUserIdsCountFlag bool - successUserIdsCount int // 已经成功给用户发送成功的消息数量;;;;**注意**：最终success_user_ids_count不一定等于valid_user_ids_count, 因为valid_user_ids_count包含了对机器人不可见的用户 + successUserIdsCount int // 已经成功给用户发送成功的消息数量;;;;** 注意 **：最终 success_user_ids_count 不一定等于 valid_user_ids_count，因为 valid_user_ids_count 包含了对机器人不可见的用户 successUserIdsCountFlag bool readUserIdsCount int // 已读信息用户数量 readUserIdsCountFlag bool @@ -356,7 +356,7 @@ func NewBatchMessageSendProgressBuilder() *BatchMessageSendProgressBuilder { return builder } -// 批量请求中有效的userid数量(包含机器人不可见用户);;;;**注意**： ;当valid_user_ids_count为0有两种情况：;* 批量任务还没有开始被调度（请等待一会再调用该接口）;* 批量发送消息时传入的所有openIDs、employeID、departmentiIDs都不包含有效的用户 +// 批量请求中有效的 userid 数量 (包含机器人不可见用户);;;;** 注意 **： ;当 valid_user_ids_count 为 0 有两种情况：;* 批量任务还没有开始被调度（请等待一会再调用该接口）;* 批量发送消息时传入的所有 openIDs、employeID、departmentiIDs 都不包含有效的用户 // // 示例值：204 func (builder *BatchMessageSendProgressBuilder) ValidUserIdsCount(validUserIdsCount int) *BatchMessageSendProgressBuilder { @@ -365,7 +365,7 @@ func (builder *BatchMessageSendProgressBuilder) ValidUserIdsCount(validUserIdsCo return builder } -// 已经成功给用户发送成功的消息数量;;;;**注意**：最终success_user_ids_count不一定等于valid_user_ids_count, 因为valid_user_ids_count包含了对机器人不可见的用户 +// 已经成功给用户发送成功的消息数量;;;;** 注意 **：最终 success_user_ids_count 不一定等于 valid_user_ids_count，因为 valid_user_ids_count 包含了对机器人不可见的用户 // // 示例值：200 func (builder *BatchMessageSendProgressBuilder) SuccessUserIdsCount(successUserIdsCount int) *BatchMessageSendProgressBuilder { @@ -693,11 +693,11 @@ type ChatAnnouncement struct { } type ChatManagers struct { - ManagerId *string `json:"manager_id,omitempty"` // 群管理员ID + ManagerId *string `json:"manager_id,omitempty"` // 群管理员 ID } type ChatManagersBuilder struct { - managerId string // 群管理员ID + managerId string // 群管理员 ID managerIdFlag bool } @@ -706,7 +706,7 @@ func NewChatManagersBuilder() *ChatManagersBuilder { return builder } -// 群管理员ID +// 群管理员 ID // // 示例值： func (builder *ChatManagersBuilder) ManagerId(managerId string) *ChatManagersBuilder { @@ -790,14 +790,14 @@ func (builder *ChatMemberBotBuilder) Build() *ChatMemberBot { type ChatMemberUser struct { Name *string `json:"name,omitempty"` // 用户名字 - TenantKey *string `json:"tenant_key,omitempty"` // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 UserId *UserId `json:"user_id,omitempty"` // 用户 ID } type ChatMemberUserBuilder struct { name string // 用户名字 nameFlag bool - tenantKey string // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + tenantKey string // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 tenantKeyFlag bool userId *UserId // 用户 ID userIdFlag bool @@ -817,7 +817,7 @@ func (builder *ChatMemberUserBuilder) Name(name string) *ChatMemberUserBuilder { return builder } -// 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 +// 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 // // 示例值：3774yuu3743 func (builder *ChatMemberUserBuilder) TenantKey(tenantKey string) *ChatMemberUserBuilder { @@ -916,22 +916,22 @@ func (builder *ChatMenuTreeBuilder) Build() *ChatMenuTree { type ChatTab struct { TabId *string `json:"tab_id,omitempty"` // Tab ID - TabName *string `json:"tab_name,omitempty"` // Tab名称;;**注意**：会话标签页的名称不能超过30个字符 - TabType *string `json:"tab_type,omitempty"` // Tab类型 - TabContent *ChatTabContent `json:"tab_content,omitempty"` // Tab内容 - TabConfig *ChatTabConfig `json:"tab_config,omitempty"` // Tab的配置 + TabName *string `json:"tab_name,omitempty"` // Tab 名称;;** 注意 **：会话标签页的名称不能超过 30 个字符 + TabType *string `json:"tab_type,omitempty"` // Tab 类型 + TabContent *ChatTabContent `json:"tab_content,omitempty"` // Tab 内容 + TabConfig *ChatTabConfig `json:"tab_config,omitempty"` // Tab 的配置 } type ChatTabBuilder struct { tabId string // Tab ID tabIdFlag bool - tabName string // Tab名称;;**注意**：会话标签页的名称不能超过30个字符 + tabName string // Tab 名称;;** 注意 **：会话标签页的名称不能超过 30 个字符 tabNameFlag bool - tabType string // Tab类型 + tabType string // Tab 类型 tabTypeFlag bool - tabContent *ChatTabContent // Tab内容 + tabContent *ChatTabContent // Tab 内容 tabContentFlag bool - tabConfig *ChatTabConfig // Tab的配置 + tabConfig *ChatTabConfig // Tab 的配置 tabConfigFlag bool } @@ -949,7 +949,7 @@ func (builder *ChatTabBuilder) TabId(tabId string) *ChatTabBuilder { return builder } -// Tab名称;;**注意**：会话标签页的名称不能超过30个字符 +// Tab 名称;;** 注意 **：会话标签页的名称不能超过 30 个字符 // // 示例值：文档 func (builder *ChatTabBuilder) TabName(tabName string) *ChatTabBuilder { @@ -958,7 +958,7 @@ func (builder *ChatTabBuilder) TabName(tabName string) *ChatTabBuilder { return builder } -// Tab类型 +// Tab 类型 // // 示例值：doc func (builder *ChatTabBuilder) TabType(tabType string) *ChatTabBuilder { @@ -967,7 +967,7 @@ func (builder *ChatTabBuilder) TabType(tabType string) *ChatTabBuilder { return builder } -// Tab内容 +// Tab 内容 // // 示例值： func (builder *ChatTabBuilder) TabContent(tabContent *ChatTabContent) *ChatTabBuilder { @@ -976,7 +976,7 @@ func (builder *ChatTabBuilder) TabContent(tabContent *ChatTabContent) *ChatTabBu return builder } -// Tab的配置 +// Tab 的配置 // // 示例值： func (builder *ChatTabBuilder) TabConfig(tabConfig *ChatTabConfig) *ChatTabBuilder { @@ -1009,14 +1009,14 @@ func (builder *ChatTabBuilder) Build() *ChatTab { } type ChatTopNotice struct { - ActionType *string `json:"action_type,omitempty"` // 置顶的类型;;**注意**：;- 选择 ==消息类型== 时必须填写`message_id`字段;- 选择 ==群公告类型== 时填写的`message_id`将被忽略 - MessageId *string `json:"message_id,omitempty"` // 消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + ActionType *string `json:"action_type,omitempty"` // 置顶的类型;;** 注意 **：;- 选择 ==消息类型== 时必须填写`message_id`字段;- 选择 ==群公告类型== 时填写的`message_id`将被忽略 + MessageId *string `json:"message_id,omitempty"` // 消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) } type ChatTopNoticeBuilder struct { - actionType string // 置顶的类型;;**注意**：;- 选择 ==消息类型== 时必须填写`message_id`字段;- 选择 ==群公告类型== 时填写的`message_id`将被忽略 + actionType string // 置顶的类型;;** 注意 **：;- 选择 ==消息类型== 时必须填写`message_id`字段;- 选择 ==群公告类型== 时填写的`message_id`将被忽略 actionTypeFlag bool - messageId string // 消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + messageId string // 消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) messageIdFlag bool } @@ -1025,7 +1025,7 @@ func NewChatTopNoticeBuilder() *ChatTopNoticeBuilder { return builder } -// 置顶的类型;;**注意**：;- 选择 ==消息类型== 时必须填写`message_id`字段;- 选择 ==群公告类型== 时填写的`message_id`将被忽略 +// 置顶的类型;;** 注意 **：;- 选择 ==消息类型== 时必须填写`message_id`字段;- 选择 ==群公告类型== 时填写的`message_id`将被忽略 // // 示例值：2 func (builder *ChatTopNoticeBuilder) ActionType(actionType string) *ChatTopNoticeBuilder { @@ -1034,7 +1034,7 @@ func (builder *ChatTopNoticeBuilder) ActionType(actionType string) *ChatTopNotic return builder } -// 消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *ChatTopNoticeBuilder) MessageId(messageId string) *ChatTopNoticeBuilder { @@ -1061,14 +1061,14 @@ type ChatChange struct { Name *string `json:"name,omitempty"` // 群名称 Description *string `json:"description,omitempty"` // 群描述 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 - AddMemberPermission *string `json:"add_member_permission,omitempty"` // 加人入群权限(all_members/only_owner/unknown) - ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限(allowed/not_allowed/unknown) - AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限(all_members/only_owner/unknown) - EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限(all_members/only_owner/unknown) - MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批(no_approval_required/approval_required) - JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性(only_owner/all_members/not_anyone) - LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性(only_owner/all_members/not_anyone) - ModerationPermission *string `json:"moderation_permission,omitempty"` // 发言权限(all_members/only_owner) + AddMemberPermission *string `json:"add_member_permission,omitempty"` // 加人入群权限 (all_members/only_owner/unknown) + ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限 (allowed/not_allowed/unknown) + AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限 (all_members/only_owner/unknown) + EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限 (all_members/only_owner/unknown) + MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批 (no_approval_required/approval_required) + JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性 (only_owner/all_members/not_anyone) + LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性 (only_owner/all_members/not_anyone) + ModerationPermission *string `json:"moderation_permission,omitempty"` // 发言权限 (all_members/only_owner) OwnerId *UserId `json:"owner_id,omitempty"` // 用户 ID } @@ -1082,21 +1082,21 @@ type ChatChangeBuilder struct { descriptionFlag bool i18nNames *I18nNames // 群国际化名称 i18nNamesFlag bool - addMemberPermission string // 加人入群权限(all_members/only_owner/unknown) + addMemberPermission string // 加人入群权限 (all_members/only_owner/unknown) addMemberPermissionFlag bool - shareCardPermission string // 群分享权限(allowed/not_allowed/unknown) + shareCardPermission string // 群分享权限 (allowed/not_allowed/unknown) shareCardPermissionFlag bool - atAllPermission string // at 所有人权限(all_members/only_owner/unknown) + atAllPermission string // at 所有人权限 (all_members/only_owner/unknown) atAllPermissionFlag bool - editPermission string // 群编辑权限(all_members/only_owner/unknown) + editPermission string // 群编辑权限 (all_members/only_owner/unknown) editPermissionFlag bool - membershipApproval string // 加群审批(no_approval_required/approval_required) + membershipApproval string // 加群审批 (no_approval_required/approval_required) membershipApprovalFlag bool - joinMessageVisibility string // 入群消息可见性(only_owner/all_members/not_anyone) + joinMessageVisibility string // 入群消息可见性 (only_owner/all_members/not_anyone) joinMessageVisibilityFlag bool - leaveMessageVisibility string // 出群消息可见性(only_owner/all_members/not_anyone) + leaveMessageVisibility string // 出群消息可见性 (only_owner/all_members/not_anyone) leaveMessageVisibilityFlag bool - moderationPermission string // 发言权限(all_members/only_owner) + moderationPermission string // 发言权限 (all_members/only_owner) moderationPermissionFlag bool ownerId *UserId // 用户 ID ownerIdFlag bool @@ -1143,7 +1143,7 @@ func (builder *ChatChangeBuilder) I18nNames(i18nNames *I18nNames) *ChatChangeBui return builder } -// 加人入群权限(all_members/only_owner/unknown) +// 加人入群权限 (all_members/only_owner/unknown) // // 示例值：all_members func (builder *ChatChangeBuilder) AddMemberPermission(addMemberPermission string) *ChatChangeBuilder { @@ -1152,7 +1152,7 @@ func (builder *ChatChangeBuilder) AddMemberPermission(addMemberPermission string return builder } -// 群分享权限(allowed/not_allowed/unknown) +// 群分享权限 (allowed/not_allowed/unknown) // // 示例值：allowed func (builder *ChatChangeBuilder) ShareCardPermission(shareCardPermission string) *ChatChangeBuilder { @@ -1161,7 +1161,7 @@ func (builder *ChatChangeBuilder) ShareCardPermission(shareCardPermission string return builder } -// at 所有人权限(all_members/only_owner/unknown) +// at 所有人权限 (all_members/only_owner/unknown) // // 示例值：only_owner func (builder *ChatChangeBuilder) AtAllPermission(atAllPermission string) *ChatChangeBuilder { @@ -1170,7 +1170,7 @@ func (builder *ChatChangeBuilder) AtAllPermission(atAllPermission string) *ChatC return builder } -// 群编辑权限(all_members/only_owner/unknown) +// 群编辑权限 (all_members/only_owner/unknown) // // 示例值：all_members func (builder *ChatChangeBuilder) EditPermission(editPermission string) *ChatChangeBuilder { @@ -1179,7 +1179,7 @@ func (builder *ChatChangeBuilder) EditPermission(editPermission string) *ChatCha return builder } -// 加群审批(no_approval_required/approval_required) +// 加群审批 (no_approval_required/approval_required) // // 示例值：approval_required func (builder *ChatChangeBuilder) MembershipApproval(membershipApproval string) *ChatChangeBuilder { @@ -1188,7 +1188,7 @@ func (builder *ChatChangeBuilder) MembershipApproval(membershipApproval string) return builder } -// 入群消息可见性(only_owner/all_members/not_anyone) +// 入群消息可见性 (only_owner/all_members/not_anyone) // // 示例值：all_members func (builder *ChatChangeBuilder) JoinMessageVisibility(joinMessageVisibility string) *ChatChangeBuilder { @@ -1197,7 +1197,7 @@ func (builder *ChatChangeBuilder) JoinMessageVisibility(joinMessageVisibility st return builder } -// 出群消息可见性(only_owner/all_members/not_anyone) +// 出群消息可见性 (only_owner/all_members/not_anyone) // // 示例值：all_members func (builder *ChatChangeBuilder) LeaveMessageVisibility(leaveMessageVisibility string) *ChatChangeBuilder { @@ -1206,7 +1206,7 @@ func (builder *ChatChangeBuilder) LeaveMessageVisibility(leaveMessageVisibility return builder } -// 发言权限(all_members/only_owner) +// 发言权限 (all_members/only_owner) // // 示例值：all_members func (builder *ChatChangeBuilder) ModerationPermission(moderationPermission string) *ChatChangeBuilder { @@ -1283,9 +1283,9 @@ func (builder *ChatChangeBuilder) Build() *ChatChange { type ChatMenuItem struct { ActionType *string `json:"action_type,omitempty"` // 菜单类型 RedirectLink *ChatMenuItemRedirectLink `json:"redirect_link,omitempty"` // 跳转链接 - ImageKey *string `json:"image_key,omitempty"` // image_key，通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传message类型图片获取image_key - Name *string `json:"name,omitempty"` // 名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内;;;**注意：** ;- 1中文=2英文=2其他语言字符=2字符 - I18nNames *I18nNames `json:"i18n_names,omitempty"` // 国际化名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内;;**注意：**;- 1中文=2英文=2其他语言字符=2字符 + ImageKey *string `json:"image_key,omitempty"` // image_key，通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传 message 类型图片获取 image_key + Name *string `json:"name,omitempty"` // 名称，一级菜单名称字符数要在 1 到 8 范围内，二级菜单名称字符数要在 1 到 24 范围内;;;** 注意：** ;- 1 中文=2 英文=2 其他语言字符=2 字符 + I18nNames *I18nNames `json:"i18n_names,omitempty"` // 国际化名称，一级菜单名称字符数要在 1 到 8 范围内，二级菜单名称字符数要在 1 到 24 范围内;;** 注意：**;- 1 中文=2 英文=2 其他语言字符=2 字符 } type ChatMenuItemBuilder struct { @@ -1293,11 +1293,11 @@ type ChatMenuItemBuilder struct { actionTypeFlag bool redirectLink *ChatMenuItemRedirectLink // 跳转链接 redirectLinkFlag bool - imageKey string // image_key，通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传message类型图片获取image_key + imageKey string // image_key，通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传 message 类型图片获取 image_key imageKeyFlag bool - name string // 名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内;;;**注意：** ;- 1中文=2英文=2其他语言字符=2字符 + name string // 名称，一级菜单名称字符数要在 1 到 8 范围内，二级菜单名称字符数要在 1 到 24 范围内;;;** 注意：** ;- 1 中文=2 英文=2 其他语言字符=2 字符 nameFlag bool - i18nNames *I18nNames // 国际化名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内;;**注意：**;- 1中文=2英文=2其他语言字符=2字符 + i18nNames *I18nNames // 国际化名称，一级菜单名称字符数要在 1 到 8 范围内，二级菜单名称字符数要在 1 到 24 范围内;;** 注意：**;- 1 中文=2 英文=2 其他语言字符=2 字符 i18nNamesFlag bool } @@ -1324,7 +1324,7 @@ func (builder *ChatMenuItemBuilder) RedirectLink(redirectLink *ChatMenuItemRedir return builder } -// image_key，通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传message类型图片获取image_key +// image_key，通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传 message 类型图片获取 image_key // // 示例值：img_v2_b0fbe905-7988-4282-b882-82edd010336j func (builder *ChatMenuItemBuilder) ImageKey(imageKey string) *ChatMenuItemBuilder { @@ -1333,7 +1333,7 @@ func (builder *ChatMenuItemBuilder) ImageKey(imageKey string) *ChatMenuItemBuild return builder } -// 名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内;;;**注意：** ;- 1中文=2英文=2其他语言字符=2字符 +// 名称，一级菜单名称字符数要在 1 到 8 范围内，二级菜单名称字符数要在 1 到 24 范围内;;;** 注意：** ;- 1 中文=2 英文=2 其他语言字符=2 字符 // // 示例值：群聊 func (builder *ChatMenuItemBuilder) Name(name string) *ChatMenuItemBuilder { @@ -1342,7 +1342,7 @@ func (builder *ChatMenuItemBuilder) Name(name string) *ChatMenuItemBuilder { return builder } -// 国际化名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内;;**注意：**;- 1中文=2英文=2其他语言字符=2字符 +// 国际化名称，一级菜单名称字符数要在 1 到 8 范围内，二级菜单名称字符数要在 1 到 24 范围内;;** 注意：**;- 1 中文=2 英文=2 其他语言字符=2 字符 // // 示例值： func (builder *ChatMenuItemBuilder) I18nNames(i18nNames *I18nNames) *ChatMenuItemBuilder { @@ -1375,23 +1375,23 @@ func (builder *ChatMenuItemBuilder) Build() *ChatMenuItem { } type ChatMenuItemRedirectLink struct { - CommonUrl *string `json:"common_url,omitempty"` // 公用跳转链接，必须以http开头。 - IosUrl *string `json:"ios_url,omitempty"` // IOS端跳转链接，当该字段不设置时，IOS端会使用common_url。必须以http开头。 - AndroidUrl *string `json:"android_url,omitempty"` // Android端跳转链接，当该字段不设置时，Android端会使用common_url。必须以http开头。 - PcUrl *string `json:"pc_url,omitempty"` // PC端跳转链接，当该字段不设置时，PC端会使用common_url。必须以http开头。 - WebUrl *string `json:"web_url,omitempty"` // Web端跳转链接，当该字段不设置时，Web端会使用common_url。必须以http开头。 + CommonUrl *string `json:"common_url,omitempty"` // 公用跳转链接，必须以 http 开头。 + IosUrl *string `json:"ios_url,omitempty"` // IOS 端跳转链接，当该字段不设置时，IOS 端会使用 common_url。必须以 http 开头。 + AndroidUrl *string `json:"android_url,omitempty"` // Android 端跳转链接，当该字段不设置时，Android 端会使用 common_url。必须以 http 开头。 + PcUrl *string `json:"pc_url,omitempty"` // PC 端跳转链接，当该字段不设置时，PC 端会使用 common_url。必须以 http 开头。 + WebUrl *string `json:"web_url,omitempty"` // Web 端跳转链接，当该字段不设置时，Web 端会使用 common_url。必须以 http 开头。 } type ChatMenuItemRedirectLinkBuilder struct { - commonUrl string // 公用跳转链接，必须以http开头。 + commonUrl string // 公用跳转链接，必须以 http 开头。 commonUrlFlag bool - iosUrl string // IOS端跳转链接，当该字段不设置时，IOS端会使用common_url。必须以http开头。 + iosUrl string // IOS 端跳转链接，当该字段不设置时，IOS 端会使用 common_url。必须以 http 开头。 iosUrlFlag bool - androidUrl string // Android端跳转链接，当该字段不设置时，Android端会使用common_url。必须以http开头。 + androidUrl string // Android 端跳转链接，当该字段不设置时，Android 端会使用 common_url。必须以 http 开头。 androidUrlFlag bool - pcUrl string // PC端跳转链接，当该字段不设置时，PC端会使用common_url。必须以http开头。 + pcUrl string // PC 端跳转链接，当该字段不设置时，PC 端会使用 common_url。必须以 http 开头。 pcUrlFlag bool - webUrl string // Web端跳转链接，当该字段不设置时，Web端会使用common_url。必须以http开头。 + webUrl string // Web 端跳转链接，当该字段不设置时，Web 端会使用 common_url。必须以 http 开头。 webUrlFlag bool } @@ -1400,7 +1400,7 @@ func NewChatMenuItemRedirectLinkBuilder() *ChatMenuItemRedirectLinkBuilder { return builder } -// 公用跳转链接，必须以http开头。 +// 公用跳转链接，必须以 http 开头。 // // 示例值：https://open.feishu.cn/ func (builder *ChatMenuItemRedirectLinkBuilder) CommonUrl(commonUrl string) *ChatMenuItemRedirectLinkBuilder { @@ -1409,7 +1409,7 @@ func (builder *ChatMenuItemRedirectLinkBuilder) CommonUrl(commonUrl string) *Cha return builder } -// IOS端跳转链接，当该字段不设置时，IOS端会使用common_url。必须以http开头。 +// IOS 端跳转链接，当该字段不设置时，IOS 端会使用 common_url。必须以 http 开头。 // // 示例值：https://open.feishu.cn/ func (builder *ChatMenuItemRedirectLinkBuilder) IosUrl(iosUrl string) *ChatMenuItemRedirectLinkBuilder { @@ -1418,7 +1418,7 @@ func (builder *ChatMenuItemRedirectLinkBuilder) IosUrl(iosUrl string) *ChatMenuI return builder } -// Android端跳转链接，当该字段不设置时，Android端会使用common_url。必须以http开头。 +// Android 端跳转链接，当该字段不设置时，Android 端会使用 common_url。必须以 http 开头。 // // 示例值：https://open.feishu.cn/ func (builder *ChatMenuItemRedirectLinkBuilder) AndroidUrl(androidUrl string) *ChatMenuItemRedirectLinkBuilder { @@ -1427,7 +1427,7 @@ func (builder *ChatMenuItemRedirectLinkBuilder) AndroidUrl(androidUrl string) *C return builder } -// PC端跳转链接，当该字段不设置时，PC端会使用common_url。必须以http开头。 +// PC 端跳转链接，当该字段不设置时，PC 端会使用 common_url。必须以 http 开头。 // // 示例值：https://open.feishu.cn/ func (builder *ChatMenuItemRedirectLinkBuilder) PcUrl(pcUrl string) *ChatMenuItemRedirectLinkBuilder { @@ -1436,7 +1436,7 @@ func (builder *ChatMenuItemRedirectLinkBuilder) PcUrl(pcUrl string) *ChatMenuIte return builder } -// Web端跳转链接，当该字段不设置时，Web端会使用common_url。必须以http开头。 +// Web 端跳转链接，当该字段不设置时，Web 端会使用 common_url。必须以 http 开头。 // // 示例值：https://open.feishu.cn/ func (builder *ChatMenuItemRedirectLinkBuilder) WebUrl(webUrl string) *ChatMenuItemRedirectLinkBuilder { @@ -1471,12 +1471,12 @@ func (builder *ChatMenuItemRedirectLinkBuilder) Build() *ChatMenuItemRedirectLin } type ChatMenuSecondLevel struct { - ChatMenuSecondLevelId *string `json:"chat_menu_second_level_id,omitempty"` // 二级菜单ID + ChatMenuSecondLevelId *string `json:"chat_menu_second_level_id,omitempty"` // 二级菜单 ID ChatMenuItem *ChatMenuItem `json:"chat_menu_item,omitempty"` // 二级菜单信息 } type ChatMenuSecondLevelBuilder struct { - chatMenuSecondLevelId string // 二级菜单ID + chatMenuSecondLevelId string // 二级菜单 ID chatMenuSecondLevelIdFlag bool chatMenuItem *ChatMenuItem // 二级菜单信息 chatMenuItemFlag bool @@ -1487,7 +1487,7 @@ func NewChatMenuSecondLevelBuilder() *ChatMenuSecondLevelBuilder { return builder } -// 二级菜单ID +// 二级菜单 ID // // 示例值：7039638308221468675 func (builder *ChatMenuSecondLevelBuilder) ChatMenuSecondLevelId(chatMenuSecondLevelId string) *ChatMenuSecondLevelBuilder { @@ -1518,13 +1518,13 @@ func (builder *ChatMenuSecondLevelBuilder) Build() *ChatMenuSecondLevel { } type ChatMenuTopLevel struct { - ChatMenuTopLevelId *string `json:"chat_menu_top_level_id,omitempty"` // 一级菜单ID + ChatMenuTopLevelId *string `json:"chat_menu_top_level_id,omitempty"` // 一级菜单 ID ChatMenuItem *ChatMenuItem `json:"chat_menu_item,omitempty"` // 一级菜单信息 Children []*ChatMenuSecondLevel `json:"children,omitempty"` // 二级菜单列表 } type ChatMenuTopLevelBuilder struct { - chatMenuTopLevelId string // 一级菜单ID + chatMenuTopLevelId string // 一级菜单 ID chatMenuTopLevelIdFlag bool chatMenuItem *ChatMenuItem // 一级菜单信息 chatMenuItemFlag bool @@ -1537,7 +1537,7 @@ func NewChatMenuTopLevelBuilder() *ChatMenuTopLevelBuilder { return builder } -// 一级菜单ID +// 一级菜单 ID // // 示例值：7117116451961487361 func (builder *ChatMenuTopLevelBuilder) ChatMenuTopLevelId(chatMenuTopLevelId string) *ChatMenuTopLevelBuilder { @@ -1580,14 +1580,14 @@ func (builder *ChatMenuTopLevelBuilder) Build() *ChatMenuTopLevel { } type ChatTabConfig struct { - IconKey *string `json:"icon_key,omitempty"` // 群Tab图标 - IsBuiltIn *bool `json:"is_built_in,omitempty"` // 群tab是否App内嵌打开 + IconKey *string `json:"icon_key,omitempty"` // 群 Tab 图标 + IsBuiltIn *bool `json:"is_built_in,omitempty"` // 群 tab 是否 App 内嵌打开 } type ChatTabConfigBuilder struct { - iconKey string // 群Tab图标 + iconKey string // 群 Tab 图标 iconKeyFlag bool - isBuiltIn bool // 群tab是否App内嵌打开 + isBuiltIn bool // 群 tab 是否 App 内嵌打开 isBuiltInFlag bool } @@ -1596,7 +1596,7 @@ func NewChatTabConfigBuilder() *ChatTabConfigBuilder { return builder } -// 群Tab图标 +// 群 Tab 图标 // // 示例值：img_v2_b99741-7628-4abd-aad0-b881e4db83ig func (builder *ChatTabConfigBuilder) IconKey(iconKey string) *ChatTabConfigBuilder { @@ -1605,7 +1605,7 @@ func (builder *ChatTabConfigBuilder) IconKey(iconKey string) *ChatTabConfigBuild return builder } -// 群tab是否App内嵌打开 +// 群 tab 是否 App 内嵌打开 // // 示例值：false func (builder *ChatTabConfigBuilder) IsBuiltIn(isBuiltIn bool) *ChatTabConfigBuilder { @@ -1628,15 +1628,15 @@ func (builder *ChatTabConfigBuilder) Build() *ChatTabConfig { } type ChatTabContent struct { - Url *string `json:"url,omitempty"` // URL类型 - Doc *string `json:"doc,omitempty"` // Doc链接 + Url *string `json:"url,omitempty"` // URL 类型 + Doc *string `json:"doc,omitempty"` // Doc 链接 MeetingMinute *string `json:"meeting_minute,omitempty"` // 会议纪要 } type ChatTabContentBuilder struct { - url string // URL类型 + url string // URL 类型 urlFlag bool - doc string // Doc链接 + doc string // Doc 链接 docFlag bool meetingMinute string // 会议纪要 meetingMinuteFlag bool @@ -1647,7 +1647,7 @@ func NewChatTabContentBuilder() *ChatTabContentBuilder { return builder } -// URL类型 +// URL 类型 // // 示例值：https://www.feishu.cn func (builder *ChatTabContentBuilder) Url(url string) *ChatTabContentBuilder { @@ -1656,7 +1656,7 @@ func (builder *ChatTabContentBuilder) Url(url string) *ChatTabContentBuilder { return builder } -// Doc链接 +// Doc 链接 // // 示例值：https://bytedance.feishu.cn/wiki/wikcnPIcqWjJQwkwDzrB9t40123xz func (builder *ChatTabContentBuilder) Doc(doc string) *ChatTabContentBuilder { @@ -1692,14 +1692,14 @@ func (builder *ChatTabContentBuilder) Build() *ChatTabContent { } type Crc32Item struct { - PartId *string `json:"part_id,omitempty"` // 分片编号（1开始） - Crc32 *string `json:"crc32,omitempty"` // crc32校验 + PartId *string `json:"part_id,omitempty"` // 分片编号（1 开始） + Crc32 *string `json:"crc32,omitempty"` // crc32 校验 } type Crc32ItemBuilder struct { - partId string // 分片编号（1开始） + partId string // 分片编号（1 开始） partIdFlag bool - crc32 string // crc32校验 + crc32 string // crc32 校验 crc32Flag bool } @@ -1708,7 +1708,7 @@ func NewCrc32ItemBuilder() *Crc32ItemBuilder { return builder } -// 分片编号（1开始） +// 分片编号（1 开始） // // 示例值：1 func (builder *Crc32ItemBuilder) PartId(partId string) *Crc32ItemBuilder { @@ -1717,7 +1717,7 @@ func (builder *Crc32ItemBuilder) PartId(partId string) *Crc32ItemBuilder { return builder } -// crc32校验 +// crc32 校验 // // 示例值：12342388237783212356 func (builder *Crc32ItemBuilder) Crc32(crc32 string) *Crc32ItemBuilder { @@ -1740,11 +1740,11 @@ func (builder *Crc32ItemBuilder) Build() *Crc32Item { } type Emoji struct { - EmojiType *string `json:"emoji_type,omitempty"` // emoji类型 [emoji类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce) + EmojiType *string `json:"emoji_type,omitempty"` // emoji 类型 [emoji 类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce) } type EmojiBuilder struct { - emojiType string // emoji类型 [emoji类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce) + emojiType string // emoji 类型 [emoji 类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce) emojiTypeFlag bool } @@ -1753,7 +1753,7 @@ func NewEmojiBuilder() *EmojiBuilder { return builder } -// emoji类型 [emoji类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce) +// emoji 类型 [emoji 类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce) // // 示例值：SMILE func (builder *EmojiBuilder) EmojiType(emojiType string) *EmojiBuilder { @@ -1772,33 +1772,33 @@ func (builder *EmojiBuilder) Build() *Emoji { } type EventMessage struct { - MessageId *string `json:"message_id,omitempty"` // 消息的open_message_id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) - RootId *string `json:"root_id,omitempty"` // 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) - ParentId *string `json:"parent_id,omitempty"` // 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + MessageId *string `json:"message_id,omitempty"` // 消息的 open_message_id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + RootId *string `json:"root_id,omitempty"` // 根消息 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + ParentId *string `json:"parent_id,omitempty"` // 父消息的 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) CreateTime *string `json:"create_time,omitempty"` // 消息发送时间（毫秒） ChatId *string `json:"chat_id,omitempty"` // 消息所在的群组 ID - ChatType *string `json:"chat_type,omitempty"` // 消息所在的群组类型;;**可选值有**：;- `p2p`：单聊;- `group`： 群组;- `topic_group`：话题群 + ChatType *string `json:"chat_type,omitempty"` // 消息所在的群组类型;;** 可选值有 **：;- `p2p`：单聊;- `group`： 群组;- `topic_group`：话题群 MessageType *string `json:"message_type,omitempty"` // 消息类型 - Content *string `json:"content,omitempty"` // 消息内容, json 格式 ;[各类型消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) + Content *string `json:"content,omitempty"` // 消息内容，json 格式 ;[各类型消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) Mentions []*MentionEvent `json:"mentions,omitempty"` // 被提及用户的信息 } type EventMessageBuilder struct { - messageId string // 消息的open_message_id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + messageId string // 消息的 open_message_id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) messageIdFlag bool - rootId string // 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + rootId string // 根消息 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) rootIdFlag bool - parentId string // 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + parentId string // 父消息的 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) parentIdFlag bool createTime string // 消息发送时间（毫秒） createTimeFlag bool chatId string // 消息所在的群组 ID chatIdFlag bool - chatType string // 消息所在的群组类型;;**可选值有**：;- `p2p`：单聊;- `group`： 群组;- `topic_group`：话题群 + chatType string // 消息所在的群组类型;;** 可选值有 **：;- `p2p`：单聊;- `group`： 群组;- `topic_group`：话题群 chatTypeFlag bool messageType string // 消息类型 messageTypeFlag bool - content string // 消息内容, json 格式 ;[各类型消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) + content string // 消息内容，json 格式 ;[各类型消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) contentFlag bool mentions []*MentionEvent // 被提及用户的信息 mentionsFlag bool @@ -1809,7 +1809,7 @@ func NewEventMessageBuilder() *EventMessageBuilder { return builder } -// 消息的open_message_id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 消息的 open_message_id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_5ce6d572455d361153b7cb51da133945 func (builder *EventMessageBuilder) MessageId(messageId string) *EventMessageBuilder { @@ -1818,7 +1818,7 @@ func (builder *EventMessageBuilder) MessageId(messageId string) *EventMessageBui return builder } -// 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 根消息 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_5ce6d572455d361153b7cb5xxfsdfsdfdsf func (builder *EventMessageBuilder) RootId(rootId string) *EventMessageBuilder { @@ -1827,7 +1827,7 @@ func (builder *EventMessageBuilder) RootId(rootId string) *EventMessageBuilder { return builder } -// 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 父消息的 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_5ce6d572455d361153b7cb5xxfsdfsdfdsf func (builder *EventMessageBuilder) ParentId(parentId string) *EventMessageBuilder { @@ -1854,7 +1854,7 @@ func (builder *EventMessageBuilder) ChatId(chatId string) *EventMessageBuilder { return builder } -// 消息所在的群组类型;;**可选值有**：;- `p2p`：单聊;- `group`： 群组;- `topic_group`：话题群 +// 消息所在的群组类型;;** 可选值有 **：;- `p2p`：单聊;- `group`： 群组;- `topic_group`：话题群 // // 示例值：group func (builder *EventMessageBuilder) ChatType(chatType string) *EventMessageBuilder { @@ -1872,7 +1872,7 @@ func (builder *EventMessageBuilder) MessageType(messageType string) *EventMessag return builder } -// 消息内容, json 格式 ;[各类型消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) +// 消息内容，json 格式 ;[各类型消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) // // 示例值：{\"text\":\"@_user_1 hello\"} func (builder *EventMessageBuilder) Content(content string) *EventMessageBuilder { @@ -1933,7 +1933,7 @@ func (builder *EventMessageBuilder) Build() *EventMessage { type EventMessageReader struct { ReaderId *UserId `json:"reader_id,omitempty"` // 用户 ID ReadTime *string `json:"read_time,omitempty"` // 阅读时间 - TenantKey *string `json:"tenant_key,omitempty"` // 租户key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // 租户 key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 } type EventMessageReaderBuilder struct { @@ -1941,7 +1941,7 @@ type EventMessageReaderBuilder struct { readerIdFlag bool readTime string // 阅读时间 readTimeFlag bool - tenantKey string // 租户key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + tenantKey string // 租户 key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 tenantKeyFlag bool } @@ -1968,7 +1968,7 @@ func (builder *EventMessageReaderBuilder) ReadTime(readTime string) *EventMessag return builder } -// 租户key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 +// 租户 key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 // // 示例值：736588c9260f175e func (builder *EventMessageReaderBuilder) TenantKey(tenantKey string) *EventMessageReaderBuilder { @@ -1995,16 +1995,16 @@ func (builder *EventMessageReaderBuilder) Build() *EventMessageReader { type EventSender struct { SenderId *UserId `json:"sender_id,omitempty"` // 用户 ID - SenderType *string `json:"sender_type,omitempty"` // 消息发送者类型。目前只支持用户(user)发送的消息。 - TenantKey *string `json:"tenant_key,omitempty"` // tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + SenderType *string `json:"sender_type,omitempty"` // 消息发送者类型。目前只支持用户 (user) 发送的消息。 + TenantKey *string `json:"tenant_key,omitempty"` // tenant key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 } type EventSenderBuilder struct { senderId *UserId // 用户 ID senderIdFlag bool - senderType string // 消息发送者类型。目前只支持用户(user)发送的消息。 + senderType string // 消息发送者类型。目前只支持用户 (user) 发送的消息。 senderTypeFlag bool - tenantKey string // tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + tenantKey string // tenant key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 tenantKeyFlag bool } @@ -2022,7 +2022,7 @@ func (builder *EventSenderBuilder) SenderId(senderId *UserId) *EventSenderBuilde return builder } -// 消息发送者类型。目前只支持用户(user)发送的消息。 +// 消息发送者类型。目前只支持用户 (user) 发送的消息。 // // 示例值：user func (builder *EventSenderBuilder) SenderType(senderType string) *EventSenderBuilder { @@ -2031,7 +2031,7 @@ func (builder *EventSenderBuilder) SenderType(senderType string) *EventSenderBui return builder } -// tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 +// tenant key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 // // 示例值：736588c9260f175e func (builder *EventSenderBuilder) TenantKey(tenantKey string) *EventSenderBuilder { @@ -2125,7 +2125,7 @@ func (builder *I18nNamesBuilder) Build() *I18nNames { type ImDepthData struct { PDate *string `json:"p_date,omitempty"` // 分区日期 - DepartmentId *string `json:"department_id,omitempty"` // 部门id + DepartmentId *string `json:"department_id,omitempty"` // 部门 id DepartmentPath *string `json:"department_path,omitempty"` // 部门路径 SendMsgRate *float64 `json:"send_msg_rate,omitempty"` // 发消息用户渗透率 AvgSendMsgCnt *float64 `json:"avg_send_msg_cnt,omitempty"` // 人均发消息数量 @@ -2150,7 +2150,7 @@ type ImDepthData struct { type ImDepthDataBuilder struct { pDate string // 分区日期 pDateFlag bool - departmentId string // 部门id + departmentId string // 部门 id departmentIdFlag bool departmentPath string // 部门路径 departmentPathFlag bool @@ -2206,7 +2206,7 @@ func (builder *ImDepthDataBuilder) PDate(pDate string) *ImDepthDataBuilder { return builder } -// 部门id +// 部门 id // // 示例值：123456 func (builder *ImDepthDataBuilder) DepartmentId(departmentId string) *ImDepthDataBuilder { @@ -2479,19 +2479,19 @@ type Image struct { } type ListChat struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) Avatar *string `json:"avatar,omitempty"` // 群头像 URL Name *string `json:"name,omitempty"` // 群名称 Description *string `json:"description,omitempty"` // 群描述 OwnerId *string `json:"owner_id,omitempty"` // 群主 ID OwnerIdType *string `json:"owner_id_type,omitempty"` // 群主 ID 类型 External *bool `json:"external,omitempty"` // 是否是外部群 - TenantKey *string `json:"tenant_key,omitempty"` // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 } type ListChatBuilder struct { - chatId string // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + chatId string // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) chatIdFlag bool avatar string // 群头像 URL avatarFlag bool @@ -2505,7 +2505,7 @@ type ListChatBuilder struct { ownerIdTypeFlag bool external bool // 是否是外部群 externalFlag bool - tenantKey string // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + tenantKey string // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 tenantKeyFlag bool } @@ -2514,7 +2514,7 @@ func NewListChatBuilder() *ListChatBuilder { return builder } -// 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *ListChatBuilder) ChatId(chatId string) *ListChatBuilder { @@ -2577,7 +2577,7 @@ func (builder *ListChatBuilder) External(external bool) *ListChatBuilder { return builder } -// 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 +// 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 // // 示例值：736588c9260f175e func (builder *ListChatBuilder) TenantKey(tenantKey string) *ListChatBuilder { @@ -2673,19 +2673,19 @@ func (builder *ListEventModeratorBuilder) Build() *ListEventModerator { type ListMember struct { MemberIdType *string `json:"member_id_type,omitempty"` // 成员的用户 ID 类型，与查询参数中的 member_id_type 相同。取值为：`open_id`、`user_id`、`union_id`其中之一。 - MemberId *string `json:"member_id,omitempty"` // 成员的用户ID，ID值与查询参数中的 member_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + MemberId *string `json:"member_id,omitempty"` // 成员的用户 ID，ID 值与查询参数中的 member_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) Name *string `json:"name,omitempty"` // 名字 - TenantKey *string `json:"tenant_key,omitempty"` // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 } type ListMemberBuilder struct { memberIdType string // 成员的用户 ID 类型，与查询参数中的 member_id_type 相同。取值为：`open_id`、`user_id`、`union_id`其中之一。 memberIdTypeFlag bool - memberId string // 成员的用户ID，ID值与查询参数中的 member_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) + memberId string // 成员的用户 ID，ID 值与查询参数中的 member_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) memberIdFlag bool name string // 名字 nameFlag bool - tenantKey string // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + tenantKey string // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 tenantKeyFlag bool } @@ -2703,7 +2703,7 @@ func (builder *ListMemberBuilder) MemberIdType(memberIdType string) *ListMemberB return builder } -// 成员的用户ID，ID值与查询参数中的 member_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) +// 成员的用户 ID，ID 值与查询参数中的 member_id_type 对应。;;不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) // // 示例值：4d7a3c6g func (builder *ListMemberBuilder) MemberId(memberId string) *ListMemberBuilder { @@ -2721,7 +2721,7 @@ func (builder *ListMemberBuilder) Name(name string) *ListMemberBuilder { return builder } -// 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 +// 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 // // 示例值： func (builder *ListMemberBuilder) TenantKey(tenantKey string) *ListMemberBuilder { @@ -2754,7 +2754,7 @@ func (builder *ListMemberBuilder) Build() *ListMember { type ListModerator struct { UserIdType *string `json:"user_id_type,omitempty"` // 可发言用户 ID 类型 UserId *string `json:"user_id,omitempty"` // 可发言用户 ID - TenantKey *string `json:"tenant_key,omitempty"` // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 } type ListModeratorBuilder struct { @@ -2762,7 +2762,7 @@ type ListModeratorBuilder struct { userIdTypeFlag bool userId string // 可发言用户 ID userIdFlag bool - tenantKey string // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + tenantKey string // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 tenantKeyFlag bool } @@ -2789,7 +2789,7 @@ func (builder *ListModeratorBuilder) UserId(userId string) *ListModeratorBuilder return builder } -// 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 +// 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 // // 示例值： func (builder *ListModeratorBuilder) TenantKey(tenantKey string) *ListModeratorBuilder { @@ -2816,12 +2816,12 @@ func (builder *ListModeratorBuilder) Build() *ListModerator { } type ListNotifyStatus struct { - UserId *UserId `json:"user_id,omitempty"` // 用户id + UserId *UserId `json:"user_id,omitempty"` // 用户 id NotifyStatusType *string `json:"notify_status_type,omitempty"` // 加急状态类型 } type ListNotifyStatusBuilder struct { - userId *UserId // 用户id + userId *UserId // 用户 id userIdFlag bool notifyStatusType string // 加急状态类型 notifyStatusTypeFlag bool @@ -2832,7 +2832,7 @@ func NewListNotifyStatusBuilder() *ListNotifyStatusBuilder { return builder } -// 用户id +// 用户 id // // 示例值： func (builder *ListNotifyStatusBuilder) UserId(userId *UserId) *ListNotifyStatusBuilder { @@ -2863,23 +2863,23 @@ func (builder *ListNotifyStatusBuilder) Build() *ListNotifyStatus { } type Mention struct { - Key *string `json:"key,omitempty"` // 被@的用户或机器人的序号。例如，第3个被@到的成员，值为“@_user_3” - Id *string `json:"id,omitempty"` // 被@的用户或者机器人的open_id - IdType *string `json:"id_type,omitempty"` // 被@的用户或机器人 id 类型，目前仅支持 `open_id` ([什么是 Open ID？](https://open.feishu.cn/document/home/user-identity-introduction/open-id)) - Name *string `json:"name,omitempty"` // 被@的用户或机器人的姓名 - TenantKey *string `json:"tenant_key,omitempty"` // 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + Key *string `json:"key,omitempty"` // 被 @的用户或机器人的序号。例如，第 3 个被 @到的成员，值为 “@_user_3” + Id *string `json:"id,omitempty"` // 被 @的用户或者机器人的 open_id + IdType *string `json:"id_type,omitempty"` // 被 @的用户或机器人 id 类型，目前仅支持 `open_id` ([什么是 Open ID？](https://open.feishu.cn/document/home/user-identity-introduction/open-id)) + Name *string `json:"name,omitempty"` // 被 @的用户或机器人的姓名 + TenantKey *string `json:"tenant_key,omitempty"` // 为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 } type MentionBuilder struct { - key string // 被@的用户或机器人的序号。例如，第3个被@到的成员，值为“@_user_3” + key string // 被 @的用户或机器人的序号。例如，第 3 个被 @到的成员，值为 “@_user_3” keyFlag bool - id string // 被@的用户或者机器人的open_id + id string // 被 @的用户或者机器人的 open_id idFlag bool - idType string // 被@的用户或机器人 id 类型，目前仅支持 `open_id` ([什么是 Open ID？](https://open.feishu.cn/document/home/user-identity-introduction/open-id)) + idType string // 被 @的用户或机器人 id 类型，目前仅支持 `open_id` ([什么是 Open ID？](https://open.feishu.cn/document/home/user-identity-introduction/open-id)) idTypeFlag bool - name string // 被@的用户或机器人的姓名 + name string // 被 @的用户或机器人的姓名 nameFlag bool - tenantKey string // 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + tenantKey string // 为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 tenantKeyFlag bool } @@ -2888,7 +2888,7 @@ func NewMentionBuilder() *MentionBuilder { return builder } -// 被@的用户或机器人的序号。例如，第3个被@到的成员，值为“@_user_3” +// 被 @的用户或机器人的序号。例如，第 3 个被 @到的成员，值为 “@_user_3” // // 示例值：@_user_1 func (builder *MentionBuilder) Key(key string) *MentionBuilder { @@ -2897,7 +2897,7 @@ func (builder *MentionBuilder) Key(key string) *MentionBuilder { return builder } -// 被@的用户或者机器人的open_id +// 被 @的用户或者机器人的 open_id // // 示例值：ou_155184d1e73cbfb8973e5a9e698e74f2 func (builder *MentionBuilder) Id(id string) *MentionBuilder { @@ -2906,7 +2906,7 @@ func (builder *MentionBuilder) Id(id string) *MentionBuilder { return builder } -// 被@的用户或机器人 id 类型，目前仅支持 `open_id` ([什么是 Open ID？](https://open.feishu.cn/document/home/user-identity-introduction/open-id)) +// 被 @的用户或机器人 id 类型，目前仅支持 `open_id` ([什么是 Open ID？](https://open.feishu.cn/document/home/user-identity-introduction/open-id)) // // 示例值：open_id func (builder *MentionBuilder) IdType(idType string) *MentionBuilder { @@ -2915,7 +2915,7 @@ func (builder *MentionBuilder) IdType(idType string) *MentionBuilder { return builder } -// 被@的用户或机器人的姓名 +// 被 @的用户或机器人的姓名 // // 示例值：Tom func (builder *MentionBuilder) Name(name string) *MentionBuilder { @@ -2924,7 +2924,7 @@ func (builder *MentionBuilder) Name(name string) *MentionBuilder { return builder } -// 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 +// 为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 // // 示例值：736588c9260f175e func (builder *MentionBuilder) TenantKey(tenantKey string) *MentionBuilder { @@ -2962,7 +2962,7 @@ type MentionEvent struct { Key *string `json:"key,omitempty"` // mention key Id *UserId `json:"id,omitempty"` // 用户 ID Name *string `json:"name,omitempty"` // 用户姓名 - TenantKey *string `json:"tenant_key,omitempty"` // tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // tenant key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 } type MentionEventBuilder struct { @@ -2972,7 +2972,7 @@ type MentionEventBuilder struct { idFlag bool name string // 用户姓名 nameFlag bool - tenantKey string // tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + tenantKey string // tenant key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 tenantKeyFlag bool } @@ -3008,7 +3008,7 @@ func (builder *MentionEventBuilder) Name(name string) *MentionEventBuilder { return builder } -// tenant key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 +// tenant key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 // // 示例值：736588c9260f175e func (builder *MentionEventBuilder) TenantKey(tenantKey string) *MentionEventBuilder { @@ -3038,10 +3038,10 @@ func (builder *MentionEventBuilder) Build() *MentionEvent { } type Message struct { - MessageId *string `json:"message_id,omitempty"` // 消息id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) - RootId *string `json:"root_id,omitempty"` // 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) - ParentId *string `json:"parent_id,omitempty"` // 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) - MsgType *string `json:"msg_type,omitempty"` // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[接收消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) + MessageId *string `json:"message_id,omitempty"` // 消息 id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + RootId *string `json:"root_id,omitempty"` // 根消息 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + ParentId *string `json:"parent_id,omitempty"` // 父消息的 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + MsgType *string `json:"msg_type,omitempty"` // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [接收消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) CreateTime *string `json:"create_time,omitempty"` // 消息生成的时间戳（毫秒） UpdateTime *string `json:"update_time,omitempty"` // 消息更新的时间戳（毫秒） Deleted *bool `json:"deleted,omitempty"` // 消息是否被撤回 @@ -3049,18 +3049,18 @@ type Message struct { ChatId *string `json:"chat_id,omitempty"` // 所属的群 Sender *Sender `json:"sender,omitempty"` // 发送者，可以是用户或应用 Body *MessageBody `json:"body,omitempty"` // 消息内容 - Mentions []*Mention `json:"mentions,omitempty"` // 被@的用户或机器人的id列表 - UpperMessageId *string `json:"upper_message_id,omitempty"` // 合并转发消息中，上一层级的消息id message_id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + Mentions []*Mention `json:"mentions,omitempty"` // 被 @的用户或机器人的 id 列表 + UpperMessageId *string `json:"upper_message_id,omitempty"` // 合并转发消息中，上一层级的消息 id message_id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) } type MessageBuilder struct { - messageId string // 消息id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + messageId string // 消息 id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) messageIdFlag bool - rootId string // 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + rootId string // 根消息 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) rootIdFlag bool - parentId string // 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + parentId string // 父消息的 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) parentIdFlag bool - msgType string // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[接收消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) + msgType string // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [接收消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) msgTypeFlag bool createTime string // 消息生成的时间戳（毫秒） createTimeFlag bool @@ -3076,9 +3076,9 @@ type MessageBuilder struct { senderFlag bool body *MessageBody // 消息内容 bodyFlag bool - mentions []*Mention // 被@的用户或机器人的id列表 + mentions []*Mention // 被 @的用户或机器人的 id 列表 mentionsFlag bool - upperMessageId string // 合并转发消息中，上一层级的消息id message_id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + upperMessageId string // 合并转发消息中，上一层级的消息 id message_id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) upperMessageIdFlag bool } @@ -3087,7 +3087,7 @@ func NewMessageBuilder() *MessageBuilder { return builder } -// 消息id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 消息 id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *MessageBuilder) MessageId(messageId string) *MessageBuilder { @@ -3096,7 +3096,7 @@ func (builder *MessageBuilder) MessageId(messageId string) *MessageBuilder { return builder } -// 根消息id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 根消息 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_40eb06e7b84dc71c03e009ad3c754195 func (builder *MessageBuilder) RootId(rootId string) *MessageBuilder { @@ -3105,7 +3105,7 @@ func (builder *MessageBuilder) RootId(rootId string) *MessageBuilder { return builder } -// 父消息的id，用于回复消息场景，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 父消息的 id，用于回复消息场景，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_d4be107c616aed9c1da8ed8068570a9f func (builder *MessageBuilder) ParentId(parentId string) *MessageBuilder { @@ -3114,7 +3114,7 @@ func (builder *MessageBuilder) ParentId(parentId string) *MessageBuilder { return builder } -// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[接收消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) +// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [接收消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/events/message_content) // // 示例值：card func (builder *MessageBuilder) MsgType(msgType string) *MessageBuilder { @@ -3179,14 +3179,14 @@ func (builder *MessageBuilder) Sender(sender *Sender) *MessageBuilder { // 消息内容 // -// 示例值：json结构 +// 示例值：json 结构 func (builder *MessageBuilder) Body(body *MessageBody) *MessageBuilder { builder.body = body builder.bodyFlag = true return builder } -// 被@的用户或机器人的id列表 +// 被 @的用户或机器人的 id 列表 // // 示例值： func (builder *MessageBuilder) Mentions(mentions []*Mention) *MessageBuilder { @@ -3195,7 +3195,7 @@ func (builder *MessageBuilder) Mentions(mentions []*Mention) *MessageBuilder { return builder } -// 合并转发消息中，上一层级的消息id message_id，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 合并转发消息中，上一层级的消息 id message_id，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_40eb06e7b84dc71c03e009ad3c754195 func (builder *MessageBuilder) UpperMessageId(upperMessageId string) *MessageBuilder { @@ -3259,20 +3259,20 @@ func (builder *MessageBuilder) Build() *Message { } type MessageReaction struct { - ReactionId *string `json:"reaction_id,omitempty"` // reaction资源ID - Operator *Operator `json:"operator,omitempty"` // 添加reaction的操作人 - ActionTime *string `json:"action_time,omitempty"` // reaction动作的的unix timestamp(单位:ms) - ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction资源类型 + ReactionId *string `json:"reaction_id,omitempty"` // reaction 资源 ID + Operator *Operator `json:"operator,omitempty"` // 添加 reaction 的操作人 + ActionTime *string `json:"action_time,omitempty"` // reaction 动作的的 unix timestamp(单位:ms) + ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction 资源类型 } type MessageReactionBuilder struct { - reactionId string // reaction资源ID + reactionId string // reaction 资源 ID reactionIdFlag bool - operator *Operator // 添加reaction的操作人 + operator *Operator // 添加 reaction 的操作人 operatorFlag bool - actionTime string // reaction动作的的unix timestamp(单位:ms) + actionTime string // reaction 动作的的 unix timestamp(单位:ms) actionTimeFlag bool - reactionType *Emoji // reaction资源类型 + reactionType *Emoji // reaction 资源类型 reactionTypeFlag bool } @@ -3281,7 +3281,7 @@ func NewMessageReactionBuilder() *MessageReactionBuilder { return builder } -// reaction资源ID +// reaction 资源 ID // // 示例值： func (builder *MessageReactionBuilder) ReactionId(reactionId string) *MessageReactionBuilder { @@ -3290,7 +3290,7 @@ func (builder *MessageReactionBuilder) ReactionId(reactionId string) *MessageRea return builder } -// 添加reaction的操作人 +// 添加 reaction 的操作人 // // 示例值： func (builder *MessageReactionBuilder) Operator(operator *Operator) *MessageReactionBuilder { @@ -3299,7 +3299,7 @@ func (builder *MessageReactionBuilder) Operator(operator *Operator) *MessageReac return builder } -// reaction动作的的unix timestamp(单位:ms) +// reaction 动作的的 unix timestamp(单位:ms) // // 示例值： func (builder *MessageReactionBuilder) ActionTime(actionTime string) *MessageReactionBuilder { @@ -3308,7 +3308,7 @@ func (builder *MessageReactionBuilder) ActionTime(actionTime string) *MessageRea return builder } -// reaction资源类型 +// reaction 资源类型 // // 示例值： func (builder *MessageReactionBuilder) ReactionType(reactionType *Emoji) *MessageReactionBuilder { @@ -3340,11 +3340,11 @@ type MessageResource struct { } type MessageBody struct { - Content *string `json:"content,omitempty"` // 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + Content *string `json:"content,omitempty"` // 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) } type MessageBodyBuilder struct { - content string // 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + content string // 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) contentFlag bool } @@ -3353,7 +3353,7 @@ func NewMessageBodyBuilder() *MessageBodyBuilder { return builder } -// 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) +// 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) // // 示例值：text:测试消息 func (builder *MessageBodyBuilder) Content(content string) *MessageBodyBuilder { @@ -3372,12 +3372,12 @@ func (builder *MessageBodyBuilder) Build() *MessageBody { } type ModeratorList struct { - AddedMemberList []*ListEventModerator `json:"added_member_list,omitempty"` // 被添加进可发言名单的用户列表（列表中一定会有owner） + AddedMemberList []*ListEventModerator `json:"added_member_list,omitempty"` // 被添加进可发言名单的用户列表（列表中一定会有 owner） RemovedMemberList []*ListEventModerator `json:"removed_member_list,omitempty"` // 被移除出可发言名单的用户列表 } type ModeratorListBuilder struct { - addedMemberList []*ListEventModerator // 被添加进可发言名单的用户列表（列表中一定会有owner） + addedMemberList []*ListEventModerator // 被添加进可发言名单的用户列表（列表中一定会有 owner） addedMemberListFlag bool removedMemberList []*ListEventModerator // 被移除出可发言名单的用户列表 removedMemberListFlag bool @@ -3388,7 +3388,7 @@ func NewModeratorListBuilder() *ModeratorListBuilder { return builder } -// 被添加进可发言名单的用户列表（列表中一定会有owner） +// 被添加进可发言名单的用户列表（列表中一定会有 owner） // // 示例值： func (builder *ModeratorListBuilder) AddedMemberList(addedMemberList []*ListEventModerator) *ModeratorListBuilder { @@ -3419,7 +3419,7 @@ func (builder *ModeratorListBuilder) Build() *ModeratorList { type MsgProcessData struct { PDate *string `json:"p_date,omitempty"` // 分区日期 - DepartmentId *string `json:"department_id,omitempty"` // 部门id + DepartmentId *string `json:"department_id,omitempty"` // 部门 id DepartmentPath *string `json:"department_path,omitempty"` // 部门路径 AvgImpMsgReadRate12h *float64 `json:"avg_imp_msg_read_rate_12h,omitempty"` // 人均重要消息 12 小时阅读率 MsgReadRate12h *float64 `json:"msg_read_rate_12h,omitempty"` // 人均 12 小时阅读率 @@ -3428,7 +3428,7 @@ type MsgProcessData struct { AvgImpReadMsgCnt *float64 `json:"avg_imp_read_msg_cnt,omitempty"` // 人均重要消息阅读数 AvgImpReceiveMsgCnt *float64 `json:"avg_imp_receive_msg_cnt,omitempty"` // 人均重要消息接收数 HighLoadRate *float64 `json:"high_load_rate,omitempty"` // 信息高负载员工占比 - BigGroupMsgRate *float64 `json:"big_group_msg_rate,omitempty"` // 大群（100人以上）消息占比 + BigGroupMsgRate *float64 `json:"big_group_msg_rate,omitempty"` // 大群（100 人以上）消息占比 BigGroupTopicMsgRate *float64 `json:"big_group_topic_msg_rate,omitempty"` // 大群消息中话题消息占比 AvgReceiveBotMsgCnt *float64 `json:"avg_receive_bot_msg_cnt,omitempty"` // 人均接收 bot 消息数 AvgBotImpMsgReadRate12h *float64 `json:"avg_bot_imp_msg_read_rate_12h,omitempty"` // 重要 bot 消息 12 小时阅读率 @@ -3442,7 +3442,7 @@ type MsgProcessData struct { type MsgProcessDataBuilder struct { pDate string // 分区日期 pDateFlag bool - departmentId string // 部门id + departmentId string // 部门 id departmentIdFlag bool departmentPath string // 部门路径 departmentPathFlag bool @@ -3460,7 +3460,7 @@ type MsgProcessDataBuilder struct { avgImpReceiveMsgCntFlag bool highLoadRate float64 // 信息高负载员工占比 highLoadRateFlag bool - bigGroupMsgRate float64 // 大群（100人以上）消息占比 + bigGroupMsgRate float64 // 大群（100 人以上）消息占比 bigGroupMsgRateFlag bool bigGroupTopicMsgRate float64 // 大群消息中话题消息占比 bigGroupTopicMsgRateFlag bool @@ -3494,7 +3494,7 @@ func (builder *MsgProcessDataBuilder) PDate(pDate string) *MsgProcessDataBuilder return builder } -// 部门id +// 部门 id // // 示例值：123456 func (builder *MsgProcessDataBuilder) DepartmentId(departmentId string) *MsgProcessDataBuilder { @@ -3575,7 +3575,7 @@ func (builder *MsgProcessDataBuilder) HighLoadRate(highLoadRate float64) *MsgPro return builder } -// 大群（100人以上）消息占比 +// 大群（100 人以上）消息占比 // // 示例值：0.50 func (builder *MsgProcessDataBuilder) BigGroupMsgRate(bigGroupMsgRate float64) *MsgProcessDataBuilder { @@ -3738,12 +3738,12 @@ func (builder *MsgProcessDataBuilder) Build() *MsgProcessData { } type Operator struct { - OperatorId *string `json:"operator_id,omitempty"` // 操作人ID + OperatorId *string `json:"operator_id,omitempty"` // 操作人 ID OperatorType *string `json:"operator_type,omitempty"` // 操作人身份，用户或应用 } type OperatorBuilder struct { - operatorId string // 操作人ID + operatorId string // 操作人 ID operatorIdFlag bool operatorType string // 操作人身份，用户或应用 operatorTypeFlag bool @@ -3754,7 +3754,7 @@ func NewOperatorBuilder() *OperatorBuilder { return builder } -// 操作人ID +// 操作人 ID // // 示例值：ou_ff0b7ba35fb********67dfc8b885136 func (builder *OperatorBuilder) OperatorId(operatorId string) *OperatorBuilder { @@ -3786,23 +3786,23 @@ func (builder *OperatorBuilder) Build() *Operator { } type Pin struct { - MessageId *string `json:"message_id,omitempty"` // Pin的消息ID - ChatId *string `json:"chat_id,omitempty"` // Pin消息所在的群聊ID - OperatorId *string `json:"operator_id,omitempty"` // Pin的操作人ID - OperatorIdType *string `json:"operator_id_type,omitempty"` // Pin的操作人ID类型。当Pin的操作人为用户时，为==open_id==；当Pin的操作人为机器人时，为==app_id== - CreateTime *string `json:"create_time,omitempty"` // Pin的创建时间（毫秒级时间戳） + MessageId *string `json:"message_id,omitempty"` // Pin 的消息 ID + ChatId *string `json:"chat_id,omitempty"` // Pin 消息所在的群聊 ID + OperatorId *string `json:"operator_id,omitempty"` // Pin 的操作人 ID + OperatorIdType *string `json:"operator_id_type,omitempty"` // Pin 的操作人 ID 类型。当 Pin 的操作人为用户时，为==open_id==；当 Pin 的操作人为机器人时，为==app_id== + CreateTime *string `json:"create_time,omitempty"` // Pin 的创建时间（毫秒级时间戳） } type PinBuilder struct { - messageId string // Pin的消息ID + messageId string // Pin 的消息 ID messageIdFlag bool - chatId string // Pin消息所在的群聊ID + chatId string // Pin 消息所在的群聊 ID chatIdFlag bool - operatorId string // Pin的操作人ID + operatorId string // Pin 的操作人 ID operatorIdFlag bool - operatorIdType string // Pin的操作人ID类型。当Pin的操作人为用户时，为==open_id==；当Pin的操作人为机器人时，为==app_id== + operatorIdType string // Pin 的操作人 ID 类型。当 Pin 的操作人为用户时，为==open_id==；当 Pin 的操作人为机器人时，为==app_id== operatorIdTypeFlag bool - createTime string // Pin的创建时间（毫秒级时间戳） + createTime string // Pin 的创建时间（毫秒级时间戳） createTimeFlag bool } @@ -3811,7 +3811,7 @@ func NewPinBuilder() *PinBuilder { return builder } -// Pin的消息ID +// Pin 的消息 ID // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *PinBuilder) MessageId(messageId string) *PinBuilder { @@ -3820,7 +3820,7 @@ func (builder *PinBuilder) MessageId(messageId string) *PinBuilder { return builder } -// Pin消息所在的群聊ID +// Pin 消息所在的群聊 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *PinBuilder) ChatId(chatId string) *PinBuilder { @@ -3829,7 +3829,7 @@ func (builder *PinBuilder) ChatId(chatId string) *PinBuilder { return builder } -// Pin的操作人ID +// Pin 的操作人 ID // // 示例值：ou_7d8a6e6df7621556ce0d21922b676706ccs func (builder *PinBuilder) OperatorId(operatorId string) *PinBuilder { @@ -3838,7 +3838,7 @@ func (builder *PinBuilder) OperatorId(operatorId string) *PinBuilder { return builder } -// Pin的操作人ID类型。当Pin的操作人为用户时，为==open_id==；当Pin的操作人为机器人时，为==app_id== +// Pin 的操作人 ID 类型。当 Pin 的操作人为用户时，为==open_id==；当 Pin 的操作人为机器人时，为==app_id== // // 示例值：open_id func (builder *PinBuilder) OperatorIdType(operatorIdType string) *PinBuilder { @@ -3847,7 +3847,7 @@ func (builder *PinBuilder) OperatorIdType(operatorIdType string) *PinBuilder { return builder } -// Pin的创建时间（毫秒级时间戳） +// Pin 的创建时间（毫秒级时间戳） // // 示例值：1615380573211 func (builder *PinBuilder) CreateTime(createTime string) *PinBuilder { @@ -3882,14 +3882,14 @@ func (builder *PinBuilder) Build() *Pin { } type PinedMessage struct { - Pin *Pin `json:"pin,omitempty"` // Pin的操作信息 - Message *Message `json:"message,omitempty"` // 被Pin的消息实体 + Pin *Pin `json:"pin,omitempty"` // Pin 的操作信息 + Message *Message `json:"message,omitempty"` // 被 Pin 的消息实体 } type PinedMessageBuilder struct { - pin *Pin // Pin的操作信息 + pin *Pin // Pin 的操作信息 pinFlag bool - message *Message // 被Pin的消息实体 + message *Message // 被 Pin 的消息实体 messageFlag bool } @@ -3898,7 +3898,7 @@ func NewPinedMessageBuilder() *PinedMessageBuilder { return builder } -// Pin的操作信息 +// Pin 的操作信息 // // 示例值： func (builder *PinedMessageBuilder) Pin(pin *Pin) *PinedMessageBuilder { @@ -3907,7 +3907,7 @@ func (builder *PinedMessageBuilder) Pin(pin *Pin) *PinedMessageBuilder { return builder } -// 被Pin的消息实体 +// 被 Pin 的消息实体 // // 示例值： func (builder *PinedMessageBuilder) Message(message *Message) *PinedMessageBuilder { @@ -3928,16 +3928,16 @@ func (builder *PinedMessageBuilder) Build() *PinedMessage { } type ReadUser struct { - UserIdType *string `json:"user_id_type,omitempty"` // 用户id类型 - UserId *string `json:"user_id,omitempty"` // 用户id + UserIdType *string `json:"user_id_type,omitempty"` // 用户 id 类型 + UserId *string `json:"user_id,omitempty"` // 用户 id Timestamp *string `json:"timestamp,omitempty"` // 阅读时间 TenantKey *string `json:"tenant_key,omitempty"` // tenant key } type ReadUserBuilder struct { - userIdType string // 用户id类型 + userIdType string // 用户 id 类型 userIdTypeFlag bool - userId string // 用户id + userId string // 用户 id userIdFlag bool timestamp string // 阅读时间 timestampFlag bool @@ -3950,7 +3950,7 @@ func NewReadUserBuilder() *ReadUserBuilder { return builder } -// 用户id类型 +// 用户 id 类型 // // 示例值：open_id func (builder *ReadUserBuilder) UserIdType(userIdType string) *ReadUserBuilder { @@ -3959,7 +3959,7 @@ func (builder *ReadUserBuilder) UserIdType(userIdType string) *ReadUserBuilder { return builder } -// 用户id +// 用户 id // // 示例值：ou_9b851f7b51a9d58d109982337c46f3de func (builder *ReadUserBuilder) UserId(userId string) *ReadUserBuilder { @@ -4008,20 +4008,20 @@ func (builder *ReadUserBuilder) Build() *ReadUser { } type Sender struct { - Id *string `json:"id,omitempty"` // 该字段标识发送者的id - IdType *string `json:"id_type,omitempty"` // 该字段标识发送者的id类型;;**可选值有：**;- `open_id`;- `app_id` - SenderType *string `json:"sender_type,omitempty"` // 该字段标识发送者的类型;;**可选值有：**;- `user`: 用户;- `app`: 应用;- `anonymous`: 匿名;- `unknown`: 未知 - TenantKey *string `json:"tenant_key,omitempty"` // 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + Id *string `json:"id,omitempty"` // 该字段标识发送者的 id + IdType *string `json:"id_type,omitempty"` // 该字段标识发送者的 id 类型;;** 可选值有：**;- `open_id`;- `app_id` + SenderType *string `json:"sender_type,omitempty"` // 该字段标识发送者的类型;;** 可选值有：**;- `user`: 用户;- `app`: 应用;- `anonymous`: 匿名;- `unknown`: 未知 + TenantKey *string `json:"tenant_key,omitempty"` // 为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 } type SenderBuilder struct { - id string // 该字段标识发送者的id + id string // 该字段标识发送者的 id idFlag bool - idType string // 该字段标识发送者的id类型;;**可选值有：**;- `open_id`;- `app_id` + idType string // 该字段标识发送者的 id 类型;;** 可选值有：**;- `open_id`;- `app_id` idTypeFlag bool - senderType string // 该字段标识发送者的类型;;**可选值有：**;- `user`: 用户;- `app`: 应用;- `anonymous`: 匿名;- `unknown`: 未知 + senderType string // 该字段标识发送者的类型;;** 可选值有：**;- `user`: 用户;- `app`: 应用;- `anonymous`: 匿名;- `unknown`: 未知 senderTypeFlag bool - tenantKey string // 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 + tenantKey string // 为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 tenantKeyFlag bool } @@ -4030,7 +4030,7 @@ func NewSenderBuilder() *SenderBuilder { return builder } -// 该字段标识发送者的id +// 该字段标识发送者的 id // // 示例值：cli_9f427eec54ae901b func (builder *SenderBuilder) Id(id string) *SenderBuilder { @@ -4039,7 +4039,7 @@ func (builder *SenderBuilder) Id(id string) *SenderBuilder { return builder } -// 该字段标识发送者的id类型;;**可选值有：**;- `open_id`;- `app_id` +// 该字段标识发送者的 id 类型;;** 可选值有：**;- `open_id`;- `app_id` // // 示例值：app_id func (builder *SenderBuilder) IdType(idType string) *SenderBuilder { @@ -4048,7 +4048,7 @@ func (builder *SenderBuilder) IdType(idType string) *SenderBuilder { return builder } -// 该字段标识发送者的类型;;**可选值有：**;- `user`: 用户;- `app`: 应用;- `anonymous`: 匿名;- `unknown`: 未知 +// 该字段标识发送者的类型;;** 可选值有：**;- `user`: 用户;- `app`: 应用;- `anonymous`: 匿名;- `unknown`: 未知 // // 示例值：app func (builder *SenderBuilder) SenderType(senderType string) *SenderBuilder { @@ -4057,7 +4057,7 @@ func (builder *SenderBuilder) SenderType(senderType string) *SenderBuilder { return builder } -// 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 +// 为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 // // 示例值：736588c9260f175e func (builder *SenderBuilder) TenantKey(tenantKey string) *SenderBuilder { @@ -4088,14 +4088,14 @@ func (builder *SenderBuilder) Build() *Sender { } type SpecialFocus struct { - Id *string `json:"id,omitempty"` // 成员ID - IdType *string `json:"id_type,omitempty"` // 成员ID类型。根据member_id_type参数返回`open_id`、`user_id`或`union_id`类型的用户ID；机器人返回`app_id` + Id *string `json:"id,omitempty"` // 成员 ID + IdType *string `json:"id_type,omitempty"` // 成员 ID 类型。根据 member_id_type 参数返回`open_id`、`user_id`或`union_id`类型的用户 ID；机器人返回`app_id` } type SpecialFocusBuilder struct { - id string // 成员ID + id string // 成员 ID idFlag bool - idType string // 成员ID类型。根据member_id_type参数返回`open_id`、`user_id`或`union_id`类型的用户ID；机器人返回`app_id` + idType string // 成员 ID 类型。根据 member_id_type 参数返回`open_id`、`user_id`或`union_id`类型的用户 ID；机器人返回`app_id` idTypeFlag bool } @@ -4104,7 +4104,7 @@ func NewSpecialFocusBuilder() *SpecialFocusBuilder { return builder } -// 成员ID +// 成员 ID // // 示例值：ou_155184d1e73cbfb8973e5a9e698e74f2 func (builder *SpecialFocusBuilder) Id(id string) *SpecialFocusBuilder { @@ -4113,7 +4113,7 @@ func (builder *SpecialFocusBuilder) Id(id string) *SpecialFocusBuilder { return builder } -// 成员ID类型。根据member_id_type参数返回`open_id`、`user_id`或`union_id`类型的用户ID；机器人返回`app_id` +// 成员 ID 类型。根据 member_id_type 参数返回`open_id`、`user_id`或`union_id`类型的用户 ID；机器人返回`app_id` // // 示例值： func (builder *SpecialFocusBuilder) IdType(idType string) *SpecialFocusBuilder { @@ -4136,15 +4136,15 @@ func (builder *SpecialFocusBuilder) Build() *SpecialFocus { } type SpecialFocusUnread struct { - Id *string `json:"id,omitempty"` // 成员ID - IdType *string `json:"id_type,omitempty"` // 成员ID类型。根据 ==member_id_type== 参数返回`open_id`、`user_id`或`union_id`类型的用户ID；机器人返回`app_id` + Id *string `json:"id,omitempty"` // 成员 ID + IdType *string `json:"id_type,omitempty"` // 成员 ID 类型。根据 ==member_id_type== 参数返回`open_id`、`user_id`或`union_id`类型的用户 ID；机器人返回`app_id` UnreadCount *string `json:"unread_count,omitempty"` // 未读数 } type SpecialFocusUnreadBuilder struct { - id string // 成员ID + id string // 成员 ID idFlag bool - idType string // 成员ID类型。根据 ==member_id_type== 参数返回`open_id`、`user_id`或`union_id`类型的用户ID；机器人返回`app_id` + idType string // 成员 ID 类型。根据 ==member_id_type== 参数返回`open_id`、`user_id`或`union_id`类型的用户 ID；机器人返回`app_id` idTypeFlag bool unreadCount string // 未读数 unreadCountFlag bool @@ -4155,7 +4155,7 @@ func NewSpecialFocusUnreadBuilder() *SpecialFocusUnreadBuilder { return builder } -// 成员ID +// 成员 ID // // 示例值： func (builder *SpecialFocusUnreadBuilder) Id(id string) *SpecialFocusUnreadBuilder { @@ -4164,7 +4164,7 @@ func (builder *SpecialFocusUnreadBuilder) Id(id string) *SpecialFocusUnreadBuild return builder } -// 成员ID类型。根据 ==member_id_type== 参数返回`open_id`、`user_id`或`union_id`类型的用户ID；机器人返回`app_id` +// 成员 ID 类型。根据 ==member_id_type== 参数返回`open_id`、`user_id`或`union_id`类型的用户 ID；机器人返回`app_id` // // 示例值： func (builder *SpecialFocusUnreadBuilder) IdType(idType string) *SpecialFocusUnreadBuilder { @@ -4200,8 +4200,8 @@ func (builder *SpecialFocusUnreadBuilder) Build() *SpecialFocusUnread { } type Toolkit struct { - ToolkitId *string `json:"toolkit_id,omitempty"` // 快捷组件ID - ImageKey *string `json:"image_key,omitempty"` // 快捷组件小图标 ;;上传message类型的图片[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) + ToolkitId *string `json:"toolkit_id,omitempty"` // 快捷组件 ID + ImageKey *string `json:"image_key,omitempty"` // 快捷组件小图标 ;;上传 message 类型的图片 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) ToolkitName *string `json:"toolkit_name,omitempty"` // 快捷组件名称 I18nName *I18nNames `json:"i18n_name,omitempty"` // 国际化名称 ToolkitType *string `json:"toolkit_type,omitempty"` // 快捷组件类型 @@ -4210,9 +4210,9 @@ type Toolkit struct { } type ToolkitBuilder struct { - toolkitId string // 快捷组件ID + toolkitId string // 快捷组件 ID toolkitIdFlag bool - imageKey string // 快捷组件小图标 ;;上传message类型的图片[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) + imageKey string // 快捷组件小图标 ;;上传 message 类型的图片 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) imageKeyFlag bool toolkitName string // 快捷组件名称 toolkitNameFlag bool @@ -4231,7 +4231,7 @@ func NewToolkitBuilder() *ToolkitBuilder { return builder } -// 快捷组件ID +// 快捷组件 ID // // 示例值：7101214603622940671 func (builder *ToolkitBuilder) ToolkitId(toolkitId string) *ToolkitBuilder { @@ -4240,7 +4240,7 @@ func (builder *ToolkitBuilder) ToolkitId(toolkitId string) *ToolkitBuilder { return builder } -// 快捷组件小图标 ;;上传message类型的图片[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) +// 快捷组件小图标 ;;上传 message 类型的图片 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) // // 示例值：img_v2_2995edd9-a22c-44ca-9559-71bbc1e661bg func (builder *ToolkitBuilder) ImageKey(imageKey string) *ToolkitBuilder { @@ -4326,13 +4326,13 @@ func (builder *ToolkitBuilder) Build() *Toolkit { type ToolkitCallback struct { Webhook *string `json:"webhook,omitempty"` // 回调地址 - ActionKey *string `json:"action_key,omitempty"` // 开发者自己识别的action_key，标识快捷组件的作用，回调时会把该字段带到回调地址 + ActionKey *string `json:"action_key,omitempty"` // 开发者自己识别的 action_key，标识快捷组件的作用，回调时会把该字段带到回调地址 } type ToolkitCallbackBuilder struct { webhook string // 回调地址 webhookFlag bool - actionKey string // 开发者自己识别的action_key，标识快捷组件的作用，回调时会把该字段带到回调地址 + actionKey string // 开发者自己识别的 action_key，标识快捷组件的作用，回调时会把该字段带到回调地址 actionKeyFlag bool } @@ -4350,7 +4350,7 @@ func (builder *ToolkitCallbackBuilder) Webhook(webhook string) *ToolkitCallbackB return builder } -// 开发者自己识别的action_key，标识快捷组件的作用，回调时会把该字段带到回调地址 +// 开发者自己识别的 action_key，标识快捷组件的作用，回调时会把该字段带到回调地址 // // 示例值：SendMessage func (builder *ToolkitCallbackBuilder) ActionKey(actionKey string) *ToolkitCallbackBuilder { @@ -4373,11 +4373,11 @@ func (builder *ToolkitCallbackBuilder) Build() *ToolkitCallback { } type ToolkitRedirectLink struct { - Url *string `json:"url,omitempty"` // 跳转url + Url *string `json:"url,omitempty"` // 跳转 url } type ToolkitRedirectLinkBuilder struct { - url string // 跳转url + url string // 跳转 url urlFlag bool } @@ -4386,7 +4386,7 @@ func NewToolkitRedirectLinkBuilder() *ToolkitRedirectLinkBuilder { return builder } -// 跳转url +// 跳转 url // // 示例值：https://applink.feishu.cn/client/calendar/open func (builder *ToolkitRedirectLinkBuilder) Url(url string) *ToolkitRedirectLinkBuilder { @@ -4405,11 +4405,11 @@ func (builder *ToolkitRedirectLinkBuilder) Build() *ToolkitRedirectLink { } type UrgentReceivers struct { - UserIdList []string `json:"user_id_list,omitempty"` // 目标用户的ID，列表不可为空;;**注意**：;请确保所填的用户ID正确，并且用户在加急消息所在的群组中 + UserIdList []string `json:"user_id_list,omitempty"` // 目标用户的 ID，列表不可为空;;** 注意 **：;请确保所填的用户 ID 正确，并且用户在加急消息所在的群组中 } type UrgentReceiversBuilder struct { - userIdList []string // 目标用户的ID，列表不可为空;;**注意**：;请确保所填的用户ID正确，并且用户在加急消息所在的群组中 + userIdList []string // 目标用户的 ID，列表不可为空;;** 注意 **：;请确保所填的用户 ID 正确，并且用户在加急消息所在的群组中 userIdListFlag bool } @@ -4418,7 +4418,7 @@ func NewUrgentReceiversBuilder() *UrgentReceiversBuilder { return builder } -// 目标用户的ID，列表不可为空;;**注意**：;请确保所填的用户ID正确，并且用户在加急消息所在的群组中 +// 目标用户的 ID，列表不可为空;;** 注意 **：;请确保所填的用户 ID 正确，并且用户在加急消息所在的群组中 // // 示例值：["ou_6yf8af6bgb9100449565764t3382b168"] func (builder *UrgentReceiversBuilder) UserIdList(userIdList []string) *UrgentReceiversBuilder { @@ -4500,17 +4500,17 @@ func (builder *UserIdBuilder) Build() *UserId { } type Widget struct { - WidgetId *string `json:"widget_id,omitempty"` // 小组件ID + WidgetId *string `json:"widget_id,omitempty"` // 小组件 ID WidgetType *string `json:"widget_type,omitempty"` // 小组件类型 - WidgetUrl *WidgetUrl `json:"widget_url,omitempty"` // 小组件链接，必须以http开头 + WidgetUrl *WidgetUrl `json:"widget_url,omitempty"` // 小组件链接，必须以 http 开头 } type WidgetBuilder struct { - widgetId string // 小组件ID + widgetId string // 小组件 ID widgetIdFlag bool widgetType string // 小组件类型 widgetTypeFlag bool - widgetUrl *WidgetUrl // 小组件链接，必须以http开头 + widgetUrl *WidgetUrl // 小组件链接，必须以 http 开头 widgetUrlFlag bool } @@ -4519,7 +4519,7 @@ func NewWidgetBuilder() *WidgetBuilder { return builder } -// 小组件ID +// 小组件 ID // // 示例值：7117116451961487361 func (builder *WidgetBuilder) WidgetId(widgetId string) *WidgetBuilder { @@ -4537,7 +4537,7 @@ func (builder *WidgetBuilder) WidgetType(widgetType string) *WidgetBuilder { return builder } -// 小组件链接，必须以http开头 +// 小组件链接，必须以 http 开头 // // 示例值： func (builder *WidgetBuilder) WidgetUrl(widgetUrl *WidgetUrl) *WidgetBuilder { @@ -4563,11 +4563,11 @@ func (builder *WidgetBuilder) Build() *Widget { } type WidgetUrl struct { - Url *string `json:"url,omitempty"` // 小组件的url + Url *string `json:"url,omitempty"` // 小组件的 url } type WidgetUrlBuilder struct { - url string // 小组件的url + url string // 小组件的 url urlFlag bool } @@ -4576,7 +4576,7 @@ func NewWidgetUrlBuilder() *WidgetUrlBuilder { return builder } -// 小组件的url +// 小组件的 url // // 示例值：https://open.feishu.cn/document/home/index func (builder *WidgetUrlBuilder) Url(url string) *WidgetUrlBuilder { @@ -4607,7 +4607,7 @@ func NewDeleteBatchMessageReqBuilder() *DeleteBatchMessageReqBuilder { return builder } -// 待撤回的批量消息的ID，为[批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)接口返回值中的`message_id`字段，用于标识一次批量发送消息请求。 +// 待撤回的批量消息的 ID，为 [批量发送消息](https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM) 接口返回值中的`message_id`字段，用于标识一次批量发送消息请求。 // // 示例值：bm-dc13264520392913993dd051dba21dcf func (builder *DeleteBatchMessageReqBuilder) BatchMessageId(batchMessageId string) *DeleteBatchMessageReqBuilder { @@ -4648,7 +4648,7 @@ func NewGetProgressBatchMessageReqBuilder() *GetProgressBatchMessageReqBuilder { return builder } -// 待查询的批量消息的ID，通过调用[批量发送消息接口]( https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)的返回值中得到 +// 待查询的批量消息的 ID，通过调用 [批量发送消息接口]( https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM) 的返回值中得到 // // 示例值：bm-0b3d5d1b2df7c6d5dbd1abe2c91e2217 func (builder *GetProgressBatchMessageReqBuilder) BatchMessageId(batchMessageId string) *GetProgressBatchMessageReqBuilder { @@ -4695,7 +4695,7 @@ func NewReadUserBatchMessageReqBuilder() *ReadUserBatchMessageReqBuilder { return builder } -// 待查询的批量消息的ID，通过调用[批量发送消息接口]( https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM)的返回值中得到 +// 待查询的批量消息的 ID，通过调用 [批量发送消息接口]( https://open.feishu.cn/document/ukTMukTMukTM/ucDO1EjL3gTNx4yN4UTM) 的返回值中得到 // // 示例值：bm_dc13264520392913993dd051dba21dcf func (builder *ReadUserBatchMessageReqBuilder) BatchMessageId(batchMessageId string) *ReadUserBatchMessageReqBuilder { @@ -4729,31 +4729,31 @@ func (resp *ReadUserBatchMessageResp) Success() bool { } type CreateChatReqBodyBuilder struct { - avatar string // 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） + avatar string // 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） avatarFlag bool - name string // 群名称;; **注意：** ;- 公开群名称的长度不得少于2个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ + name string // 群名称;; ** 注意：** ;- 公开群名称的长度不得少于 2 个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ nameFlag bool description string // 群描述 descriptionFlag bool i18nNames *I18nNames // 群国际化名称 i18nNamesFlag bool - ownerId string // 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID值应与查询参数中的 ==user_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID + ownerId string // 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID 值应与查询参数中的 ==user_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID ownerIdFlag bool - userIdList []string // 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID;;**注意**：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身ID + userIdList []string // 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID;;** 注意 **：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身 ID userIdListFlag bool - botIdList []string // 创建群时邀请的群机器人；可参考[如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id)来获取应用的App ID; ;**注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请5个机器人，并且群组最多容纳 15 个机器人 + botIdList []string // 创建群时邀请的群机器人；可参考 [如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id) 来获取应用的 App ID; ;** 注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请 5 个机器人，并且群组最多容纳 15 个机器人 botIdListFlag bool - chatMode string // 群模式;;**可选值有**：;- `group`：群组 + chatMode string // 群模式;;** 可选值有 **：;- `group`：群组 chatModeFlag bool - chatType string // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 + chatType string // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 chatTypeFlag bool external bool // 是否是外部群；若群组需要邀请不同租户的用户或机器人，请指定为外部群； externalFlag bool - joinMessageVisibility string // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + joinMessageVisibility string // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 joinMessageVisibilityFlag bool - leaveMessageVisibility string // 退群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + leaveMessageVisibility string // 退群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 leaveMessageVisibilityFlag bool - membershipApproval string // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + membershipApproval string // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 membershipApprovalFlag bool } @@ -4762,7 +4762,7 @@ func NewCreateChatReqBodyBuilder() *CreateChatReqBodyBuilder { return builder } -// 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） +// 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） // //示例值：default-avatar_44ae0ca3-e140-494b-956f-78091e348435 func (builder *CreateChatReqBodyBuilder) Avatar(avatar string) *CreateChatReqBodyBuilder { @@ -4771,7 +4771,7 @@ func (builder *CreateChatReqBodyBuilder) Avatar(avatar string) *CreateChatReqBod return builder } -// 群名称;; **注意：** ;- 公开群名称的长度不得少于2个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ +// 群名称;; ** 注意：** ;- 公开群名称的长度不得少于 2 个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ // //示例值：测试群名称 func (builder *CreateChatReqBodyBuilder) Name(name string) *CreateChatReqBodyBuilder { @@ -4798,7 +4798,7 @@ func (builder *CreateChatReqBodyBuilder) I18nNames(i18nNames *I18nNames) *Create return builder } -// 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID值应与查询参数中的 ==user_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID +// 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID 值应与查询参数中的 ==user_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID // //示例值：4d7a3c6g func (builder *CreateChatReqBodyBuilder) OwnerId(ownerId string) *CreateChatReqBodyBuilder { @@ -4807,7 +4807,7 @@ func (builder *CreateChatReqBodyBuilder) OwnerId(ownerId string) *CreateChatReqB return builder } -// 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID;;**注意**：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身ID +// 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID;;** 注意 **：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身 ID // //示例值：["4d7a3c6g"] func (builder *CreateChatReqBodyBuilder) UserIdList(userIdList []string) *CreateChatReqBodyBuilder { @@ -4816,7 +4816,7 @@ func (builder *CreateChatReqBodyBuilder) UserIdList(userIdList []string) *Create return builder } -// 创建群时邀请的群机器人；可参考[如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id)来获取应用的App ID; ;**注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请5个机器人，并且群组最多容纳 15 个机器人 +// 创建群时邀请的群机器人；可参考 [如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id) 来获取应用的 App ID; ;** 注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请 5 个机器人，并且群组最多容纳 15 个机器人 // //示例值：["cli_a10fbf7e94b8d01d"] func (builder *CreateChatReqBodyBuilder) BotIdList(botIdList []string) *CreateChatReqBodyBuilder { @@ -4825,7 +4825,7 @@ func (builder *CreateChatReqBodyBuilder) BotIdList(botIdList []string) *CreateCh return builder } -// 群模式;;**可选值有**：;- `group`：群组 +// 群模式;;** 可选值有 **：;- `group`：群组 // //示例值：group func (builder *CreateChatReqBodyBuilder) ChatMode(chatMode string) *CreateChatReqBodyBuilder { @@ -4834,7 +4834,7 @@ func (builder *CreateChatReqBodyBuilder) ChatMode(chatMode string) *CreateChatRe return builder } -// 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 +// 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 // //示例值：private func (builder *CreateChatReqBodyBuilder) ChatType(chatType string) *CreateChatReqBodyBuilder { @@ -4852,7 +4852,7 @@ func (builder *CreateChatReqBodyBuilder) External(external bool) *CreateChatReqB return builder } -// 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // //示例值：all_members func (builder *CreateChatReqBodyBuilder) JoinMessageVisibility(joinMessageVisibility string) *CreateChatReqBodyBuilder { @@ -4861,7 +4861,7 @@ func (builder *CreateChatReqBodyBuilder) JoinMessageVisibility(joinMessageVisibi return builder } -// 退群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 退群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // //示例值：all_members func (builder *CreateChatReqBodyBuilder) LeaveMessageVisibility(leaveMessageVisibility string) *CreateChatReqBodyBuilder { @@ -4870,7 +4870,7 @@ func (builder *CreateChatReqBodyBuilder) LeaveMessageVisibility(leaveMessageVisi return builder } -// 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 +// 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 // //示例值：no_approval_required func (builder *CreateChatReqBodyBuilder) MembershipApproval(membershipApproval string) *CreateChatReqBodyBuilder { @@ -4924,31 +4924,31 @@ func (builder *CreateChatReqBodyBuilder) Build() *CreateChatReqBody { } type CreateChatPathReqBodyBuilder struct { - avatar string // 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） + avatar string // 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） avatarFlag bool - name string // 群名称;; **注意：** ;- 公开群名称的长度不得少于2个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ + name string // 群名称;; ** 注意：** ;- 公开群名称的长度不得少于 2 个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ nameFlag bool description string // 群描述 descriptionFlag bool i18nNames *I18nNames // 群国际化名称 i18nNamesFlag bool - ownerId string // 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID值应与查询参数中的 ==user_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID + ownerId string // 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID 值应与查询参数中的 ==user_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID ownerIdFlag bool - userIdList []string // 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID;;**注意**：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身ID + userIdList []string // 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID;;** 注意 **：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身 ID userIdListFlag bool - botIdList []string // 创建群时邀请的群机器人；可参考[如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id)来获取应用的App ID; ;**注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请5个机器人，并且群组最多容纳 15 个机器人 + botIdList []string // 创建群时邀请的群机器人；可参考 [如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id) 来获取应用的 App ID; ;** 注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请 5 个机器人，并且群组最多容纳 15 个机器人 botIdListFlag bool - chatMode string // 群模式;;**可选值有**：;- `group`：群组 + chatMode string // 群模式;;** 可选值有 **：;- `group`：群组 chatModeFlag bool - chatType string // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 + chatType string // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 chatTypeFlag bool external bool // 是否是外部群；若群组需要邀请不同租户的用户或机器人，请指定为外部群； externalFlag bool - joinMessageVisibility string // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + joinMessageVisibility string // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 joinMessageVisibilityFlag bool - leaveMessageVisibility string // 退群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + leaveMessageVisibility string // 退群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 leaveMessageVisibilityFlag bool - membershipApproval string // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + membershipApproval string // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 membershipApprovalFlag bool labels []string // 群标签 labelsFlag bool @@ -4961,7 +4961,7 @@ func NewCreateChatPathReqBodyBuilder() *CreateChatPathReqBodyBuilder { return builder } -// 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） +// 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） // // 示例值：default-avatar_44ae0ca3-e140-494b-956f-78091e348435 func (builder *CreateChatPathReqBodyBuilder) Avatar(avatar string) *CreateChatPathReqBodyBuilder { @@ -4970,7 +4970,7 @@ func (builder *CreateChatPathReqBodyBuilder) Avatar(avatar string) *CreateChatPa return builder } -// 群名称;; **注意：** ;- 公开群名称的长度不得少于2个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ +// 群名称;; ** 注意：** ;- 公开群名称的长度不得少于 2 个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ // // 示例值：测试群名称 func (builder *CreateChatPathReqBodyBuilder) Name(name string) *CreateChatPathReqBodyBuilder { @@ -4997,7 +4997,7 @@ func (builder *CreateChatPathReqBodyBuilder) I18nNames(i18nNames *I18nNames) *Cr return builder } -// 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID值应与查询参数中的 ==user_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID +// 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID 值应与查询参数中的 ==user_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID // // 示例值：4d7a3c6g func (builder *CreateChatPathReqBodyBuilder) OwnerId(ownerId string) *CreateChatPathReqBodyBuilder { @@ -5006,7 +5006,7 @@ func (builder *CreateChatPathReqBodyBuilder) OwnerId(ownerId string) *CreateChat return builder } -// 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID;;**注意**：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身ID +// 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID;;** 注意 **：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身 ID // // 示例值：["4d7a3c6g"] func (builder *CreateChatPathReqBodyBuilder) UserIdList(userIdList []string) *CreateChatPathReqBodyBuilder { @@ -5015,7 +5015,7 @@ func (builder *CreateChatPathReqBodyBuilder) UserIdList(userIdList []string) *Cr return builder } -// 创建群时邀请的群机器人；可参考[如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id)来获取应用的App ID; ;**注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请5个机器人，并且群组最多容纳 15 个机器人 +// 创建群时邀请的群机器人；可参考 [如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id) 来获取应用的 App ID; ;** 注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请 5 个机器人，并且群组最多容纳 15 个机器人 // // 示例值：["cli_a10fbf7e94b8d01d"] func (builder *CreateChatPathReqBodyBuilder) BotIdList(botIdList []string) *CreateChatPathReqBodyBuilder { @@ -5024,7 +5024,7 @@ func (builder *CreateChatPathReqBodyBuilder) BotIdList(botIdList []string) *Crea return builder } -// 群模式;;**可选值有**：;- `group`：群组 +// 群模式;;** 可选值有 **：;- `group`：群组 // // 示例值：group func (builder *CreateChatPathReqBodyBuilder) ChatMode(chatMode string) *CreateChatPathReqBodyBuilder { @@ -5033,7 +5033,7 @@ func (builder *CreateChatPathReqBodyBuilder) ChatMode(chatMode string) *CreateCh return builder } -// 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 +// 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 // // 示例值：private func (builder *CreateChatPathReqBodyBuilder) ChatType(chatType string) *CreateChatPathReqBodyBuilder { @@ -5051,7 +5051,7 @@ func (builder *CreateChatPathReqBodyBuilder) External(external bool) *CreateChat return builder } -// 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // // 示例值：all_members func (builder *CreateChatPathReqBodyBuilder) JoinMessageVisibility(joinMessageVisibility string) *CreateChatPathReqBodyBuilder { @@ -5060,7 +5060,7 @@ func (builder *CreateChatPathReqBodyBuilder) JoinMessageVisibility(joinMessageVi return builder } -// 退群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 退群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // // 示例值：all_members func (builder *CreateChatPathReqBodyBuilder) LeaveMessageVisibility(leaveMessageVisibility string) *CreateChatPathReqBodyBuilder { @@ -5069,7 +5069,7 @@ func (builder *CreateChatPathReqBodyBuilder) LeaveMessageVisibility(leaveMessage return builder } -// 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 +// 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 // // 示例值：no_approval_required func (builder *CreateChatPathReqBodyBuilder) MembershipApproval(membershipApproval string) *CreateChatPathReqBodyBuilder { @@ -5136,7 +5136,7 @@ func NewCreateChatReqBuilder() *CreateChatReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：open_id func (builder *CreateChatReqBuilder) UserIdType(userIdType string) *CreateChatReqBuilder { @@ -5152,7 +5152,7 @@ func (builder *CreateChatReqBuilder) SetBotManager(setBotManager bool) *CreateCh return builder } -// 由开发者生成的唯一字符串序列，用于创建群组请求去重；持有相同uuid的请求10小时内只可成功创建1个群聊 +// 由开发者生成的唯一字符串序列，用于创建群组请求去重；持有相同 uuid 的请求 10 小时内只可成功创建 1 个群聊 // // 示例值：b13g2t38-1jd2-458b-8djf-dtbca5104204 func (builder *CreateChatReqBuilder) Uuid(uuid string) *CreateChatReqBuilder { @@ -5175,19 +5175,19 @@ func (builder *CreateChatReqBuilder) Build() *CreateChatReq { } type CreateChatReqBody struct { - Avatar *string `json:"avatar,omitempty"` // 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） - Name *string `json:"name,omitempty"` // 群名称;; **注意：** ;- 公开群名称的长度不得少于2个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ + Avatar *string `json:"avatar,omitempty"` // 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） + Name *string `json:"name,omitempty"` // 群名称;; ** 注意：** ;- 公开群名称的长度不得少于 2 个字符;- 私有群若未填写群名称，群名称默认设置为 ”`(无主题)`“ Description *string `json:"description,omitempty"` // 群描述 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 - OwnerId *string `json:"owner_id,omitempty"` // 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID值应与查询参数中的 ==user_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID - UserIdList []string `json:"user_id_list,omitempty"` // 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取用户的Open ID;;**注意**：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身ID - BotIdList []string `json:"bot_id_list,omitempty"` // 创建群时邀请的群机器人；可参考[如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id)来获取应用的App ID; ;**注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请5个机器人，并且群组最多容纳 15 个机器人 - ChatMode *string `json:"chat_mode,omitempty"` // 群模式;;**可选值有**：;- `group`：群组 - ChatType *string `json:"chat_type,omitempty"` // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 + OwnerId *string `json:"owner_id,omitempty"` // 创建群时指定的群主，不填时指定建群的机器人为群主。群主 ID 值应与查询参数中的 ==user_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID + UserIdList []string `json:"user_id_list,omitempty"` // 创建群时邀请的群成员，ID 类型在查询参数 ==user_id_type== 中指定；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取用户的 Open ID;;** 注意 **：;- 最多同时邀请 50 个用户;- 为便于在客户端查看效果，建议调试接口时加入开发者自身 ID + BotIdList []string `json:"bot_id_list,omitempty"` // 创建群时邀请的群机器人；可参考 [如何获取应用的 App ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-app-id) 来获取应用的 App ID; ;** 注意：** ;- 拉机器人入群请使用`app_id`;- 最多同时邀请 5 个机器人，并且群组最多容纳 15 个机器人 + ChatMode *string `json:"chat_mode,omitempty"` // 群模式;;** 可选值有 **：;- `group`：群组 + ChatType *string `json:"chat_type,omitempty"` // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 External *bool `json:"external,omitempty"` // 是否是外部群；若群组需要邀请不同租户的用户或机器人，请指定为外部群； - JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 - LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 退群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 - MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 退群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 } @@ -5197,26 +5197,26 @@ type CreateChatReq struct { } type CreateChatRespData struct { - ChatId *string `json:"chat_id,omitempty"` // 群 ID，详情参见：[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群 ID，详情参见：[群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) Avatar *string `json:"avatar,omitempty"` // 群头像 URL Name *string `json:"name,omitempty"` // 群名称 Description *string `json:"description,omitempty"` // 群描述 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 - OwnerId *string `json:"owner_id,omitempty"` // 群主 ID，ID值与查询参数中的 ==user_id_type== 对应；不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;**注意**：当群主是机器人时，该字段不返回 - OwnerIdType *string `json:"owner_id_type,omitempty"` // 群主 ID 对应的ID类型，与查询参数中的 ==user_id_type== 相同。取值为：`open_id`、`user_id`、`union_id`其中之一;;**注意**：当群主是机器人时，该字段不返回 - AddMemberPermission *string `json:"add_member_permission,omitempty"` // 拉 用户或机器人 入群权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 - ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许 - AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 - EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 - ChatMode *string `json:"chat_mode,omitempty"` // 群模式;;**可选值有**：;- `group`：群组 - ChatType *string `json:"chat_type,omitempty"` // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 - ChatTag *string `json:"chat_tag,omitempty"` // 群标签，如有多个，则按照下列顺序返回第一个;;**可选值有**：;- `inner`：内部群;- `tenant`：公司群;- `department`：部门群;- `edu`：教育群;- `meeting`：会议群;- `customer_service`：客服群 + OwnerId *string `json:"owner_id,omitempty"` // 群主 ID，ID 值与查询参数中的 ==user_id_type== 对应；不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;** 注意 **：当群主是机器人时，该字段不返回 + OwnerIdType *string `json:"owner_id_type,omitempty"` // 群主 ID 对应的 ID 类型，与查询参数中的 ==user_id_type== 相同。取值为：`open_id`、`user_id`、`union_id`其中之一;;** 注意 **：当群主是机器人时，该字段不返回 + AddMemberPermission *string `json:"add_member_permission,omitempty"` // 拉 用户或机器人 入群权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许 + AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + ChatMode *string `json:"chat_mode,omitempty"` // 群模式;;** 可选值有 **：;- `group`：群组 + ChatType *string `json:"chat_type,omitempty"` // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 + ChatTag *string `json:"chat_tag,omitempty"` // 群标签，如有多个，则按照下列顺序返回第一个;;** 可选值有 **：;- `inner`：内部群;- `tenant`：公司群;- `department`：部门群;- `edu`：教育群;- `meeting`：会议群;- `customer_service`：客服群 External *bool `json:"external,omitempty"` // 是否是外部群 - TenantKey *string `json:"tenant_key,omitempty"` // 租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识 - JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 - LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 - MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 - ModerationPermission *string `json:"moderation_permission,omitempty"` // 发言权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;- `moderator_list`：指定群成员 + TenantKey *string `json:"tenant_key,omitempty"` // 租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识 + JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + ModerationPermission *string `json:"moderation_permission,omitempty"` // 发言权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;- `moderator_list`：指定群成员 } @@ -5243,7 +5243,7 @@ func NewDeleteChatReqBuilder() *DeleteChatReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群组ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群组 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *DeleteChatReqBuilder) ChatId(chatId string) *DeleteChatReqBuilder { @@ -5284,7 +5284,7 @@ func NewGetChatReqBuilder() *GetChatReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *GetChatReqBuilder) ChatId(chatId string) *GetChatReqBuilder { @@ -5292,7 +5292,7 @@ func (builder *GetChatReqBuilder) ChatId(chatId string) *GetChatReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetChatReqBuilder) UserIdType(userIdType string) *GetChatReqBuilder { @@ -5317,21 +5317,21 @@ type GetChatRespData struct { Name *string `json:"name,omitempty"` // 群名称 Description *string `json:"description,omitempty"` // 群描述 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 - AddMemberPermission *string `json:"add_member_permission,omitempty"` // 群成员添加权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;;**注意**：单聊不返回该字段 - ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许;;**注意**：单聊不返回该字段 - AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;;**注意**：单聊不返回该字段 - EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 - OwnerIdType *string `json:"owner_id_type,omitempty"` // 群主 ID 对应的ID类型，与查询参数中的 ==user_id_type== 相同。取值为：`open_id`、`user_id`、`union_id`其中之一;;**注意**：;- 当群主是机器人时不返回该字段;- 单聊不返回该字段 - OwnerId *string `json:"owner_id,omitempty"` // 群主 ID，ID值与查询参数中的 ==user_id_type== 对应；不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;**注意**：;- 当群主是机器人时不返回该字段;- 单聊不返回该字段 - ChatMode *string `json:"chat_mode,omitempty"` // 群模式;;**可选值有**：;- `group`：群组;- `topic`: 话题;- `p2p`: 单聊 - ChatType *string `json:"chat_type,omitempty"` // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群;;**注意**：单聊不返回该字段 - ChatTag *string `json:"chat_tag,omitempty"` // 群标签，如有多个，则按照下列顺序返回第一个;;**可选值有**：;- `inner`：内部群;- `tenant`：公司群;- `department`：部门群;- `edu`：教育群;- `meeting`：会议群;- `customer_service`：客服群;;**注意**：单聊不返回该字段 - JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见;;**注意**：单聊不返回该字段 - LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见;;**注意**：单聊不返回该字段 - MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批;;**注意**：单聊不返回该字段 - ModerationPermission *string `json:"moderation_permission,omitempty"` // 发言权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;- `moderator_list`：指定群成员 + AddMemberPermission *string `json:"add_member_permission,omitempty"` // 群成员添加权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;;** 注意 **：单聊不返回该字段 + ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许;;** 注意 **：单聊不返回该字段 + AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;;** 注意 **：单聊不返回该字段 + EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + OwnerIdType *string `json:"owner_id_type,omitempty"` // 群主 ID 对应的 ID 类型，与查询参数中的 ==user_id_type== 相同。取值为：`open_id`、`user_id`、`union_id`其中之一;;** 注意 **：;- 当群主是机器人时不返回该字段;- 单聊不返回该字段 + OwnerId *string `json:"owner_id,omitempty"` // 群主 ID，ID 值与查询参数中的 ==user_id_type== 对应；不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);;** 注意 **：;- 当群主是机器人时不返回该字段;- 单聊不返回该字段 + ChatMode *string `json:"chat_mode,omitempty"` // 群模式;;** 可选值有 **：;- `group`：群组;- `topic`: 话题;- `p2p`: 单聊 + ChatType *string `json:"chat_type,omitempty"` // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群;;** 注意 **：单聊不返回该字段 + ChatTag *string `json:"chat_tag,omitempty"` // 群标签，如有多个，则按照下列顺序返回第一个;;** 可选值有 **：;- `inner`：内部群;- `tenant`：公司群;- `department`：部门群;- `edu`：教育群;- `meeting`：会议群;- `customer_service`：客服群;;** 注意 **：单聊不返回该字段 + JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见;;** 注意 **：单聊不返回该字段 + LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见;;** 注意 **：单聊不返回该字段 + MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批;;** 注意 **：单聊不返回该字段 + ModerationPermission *string `json:"moderation_permission,omitempty"` // 发言权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员;- `moderator_list`：指定群成员 External *bool `json:"external,omitempty"` // 是否是外部群 - TenantKey *string `json:"tenant_key,omitempty"` // 租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + TenantKey *string `json:"tenant_key,omitempty"` // 租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 UserCount *string `json:"user_count,omitempty"` // 群成员人数 BotCount *string `json:"bot_count,omitempty"` // 群机器人数 @@ -5348,7 +5348,7 @@ func (resp *GetChatResp) Success() bool { } type LinkChatReqBodyBuilder struct { - validityPeriod string // 群分享链接有效时长，可选值week、year、permanently，分别表示7天、1年以及永久有效 + validityPeriod string // 群分享链接有效时长，可选值 week、year、permanently，分别表示 7 天、1 年以及永久有效 validityPeriodFlag bool } @@ -5357,7 +5357,7 @@ func NewLinkChatReqBodyBuilder() *LinkChatReqBodyBuilder { return builder } -// 群分享链接有效时长，可选值week、year、permanently，分别表示7天、1年以及永久有效 +// 群分享链接有效时长，可选值 week、year、permanently，分别表示 7 天、1 年以及永久有效 // //示例值：week func (builder *LinkChatReqBodyBuilder) ValidityPeriod(validityPeriod string) *LinkChatReqBodyBuilder { @@ -5375,7 +5375,7 @@ func (builder *LinkChatReqBodyBuilder) Build() *LinkChatReqBody { } type LinkChatPathReqBodyBuilder struct { - validityPeriod string // 群分享链接有效时长，可选值week、year、permanently，分别表示7天、1年以及永久有效 + validityPeriod string // 群分享链接有效时长，可选值 week、year、permanently，分别表示 7 天、1 年以及永久有效 validityPeriodFlag bool } @@ -5384,7 +5384,7 @@ func NewLinkChatPathReqBodyBuilder() *LinkChatPathReqBodyBuilder { return builder } -// 群分享链接有效时长，可选值week、year、permanently，分别表示7天、1年以及永久有效 +// 群分享链接有效时长，可选值 week、year、permanently，分别表示 7 天、1 年以及永久有效 // // 示例值：week func (builder *LinkChatPathReqBodyBuilder) ValidityPeriod(validityPeriod string) *LinkChatPathReqBodyBuilder { @@ -5415,7 +5415,7 @@ func NewLinkChatReqBuilder() *LinkChatReqBuilder { return builder } -// 待获取分享链接的群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：单聊、密聊、团队群不支持分享群链接 +// 待获取分享链接的群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：单聊、密聊、团队群不支持分享群链接 // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *LinkChatReqBuilder) ChatId(chatId string) *LinkChatReqBuilder { @@ -5438,7 +5438,7 @@ func (builder *LinkChatReqBuilder) Build() *LinkChatReq { } type LinkChatReqBody struct { - ValidityPeriod *string `json:"validity_period,omitempty"` // 群分享链接有效时长，可选值week、year、permanently，分别表示7天、1年以及永久有效 + ValidityPeriod *string `json:"validity_period,omitempty"` // 群分享链接有效时长，可选值 week、year、permanently，分别表示 7 天、1 年以及永久有效 } type LinkChatReq struct { @@ -5482,7 +5482,7 @@ func (builder *ListChatReqBuilder) Limit(limit int) *ListChatReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListChatReqBuilder) UserIdType(userIdType string) *ListChatReqBuilder { @@ -5556,7 +5556,7 @@ func (builder *SearchChatReqBuilder) Limit(limit int) *SearchChatReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *SearchChatReqBuilder) UserIdType(userIdType string) *SearchChatReqBuilder { @@ -5564,7 +5564,7 @@ func (builder *SearchChatReqBuilder) UserIdType(userIdType string) *SearchChatRe return builder } -// 关键词;;**注意事项**：;- 关键词支持匹配群国际化名称、群成员名称;- 支持使用多语种搜索;- 支持拼音、前缀等模糊搜索;- 关键词为空值或长度超过`64`个字符时将返回空的结果 +// 关键词;;** 注意事项 **：;- 关键词支持匹配群国际化名称、群成员名称;- 支持使用多语种搜索;- 支持拼音、前缀等模糊搜索;- 关键词为空值或长度超过`64`个字符时将返回空的结果 // // 示例值：abc func (builder *SearchChatReqBuilder) Query(query string) *SearchChatReqBuilder { @@ -5619,7 +5619,7 @@ func (resp *SearchChatResp) Success() bool { } type UpdateChatReqBodyBuilder struct { - avatar string // 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） + avatar string // 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） avatarFlag bool name string // 群名称 nameFlag bool @@ -5627,24 +5627,24 @@ type UpdateChatReqBodyBuilder struct { descriptionFlag bool i18nNames *I18nNames // 群国际化名称 i18nNamesFlag bool - addMemberPermission string // 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则share_card_permission只能设置为`not_allowed`;- 若值设置为`all_members`，则share_card_permission只能设置为`allowed`;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + addMemberPermission string // 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则 share_card_permission 只能设置为`not_allowed`;- 若值设置为`all_members`，则 share_card_permission 只能设置为`allowed`;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 addMemberPermissionFlag bool - shareCardPermission string // 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许 + shareCardPermission string // 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许 shareCardPermissionFlag bool - atAllPermission string // at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + atAllPermission string // at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 atAllPermissionFlag bool - editPermission string // 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + editPermission string // 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 editPermissionFlag bool ownerId string // 新群主 ID ownerIdFlag bool - joinMessageVisibility string // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + joinMessageVisibility string // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 joinMessageVisibilityFlag bool - leaveMessageVisibility string // 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + leaveMessageVisibility string // 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 leaveMessageVisibilityFlag bool - membershipApproval string // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + membershipApproval string // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 membershipApprovalFlag bool - chatType string // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 + chatType string // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 chatTypeFlag bool } @@ -5653,7 +5653,7 @@ func NewUpdateChatReqBodyBuilder() *UpdateChatReqBodyBuilder { return builder } -// 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） +// 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） // //示例值：default-avatar_44ae0ca3-e140-494b-956f-78091e348435 func (builder *UpdateChatReqBodyBuilder) Avatar(avatar string) *UpdateChatReqBodyBuilder { @@ -5689,7 +5689,7 @@ func (builder *UpdateChatReqBodyBuilder) I18nNames(i18nNames *I18nNames) *Update return builder } -// 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则share_card_permission只能设置为`not_allowed`;- 若值设置为`all_members`，则share_card_permission只能设置为`allowed`;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 +// 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则 share_card_permission 只能设置为`not_allowed`;- 若值设置为`all_members`，则 share_card_permission 只能设置为`allowed`;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 // //示例值：all_members func (builder *UpdateChatReqBodyBuilder) AddMemberPermission(addMemberPermission string) *UpdateChatReqBodyBuilder { @@ -5698,7 +5698,7 @@ func (builder *UpdateChatReqBodyBuilder) AddMemberPermission(addMemberPermission return builder } -// 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许 +// 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许 // //示例值：allowed func (builder *UpdateChatReqBodyBuilder) ShareCardPermission(shareCardPermission string) *UpdateChatReqBodyBuilder { @@ -5707,7 +5707,7 @@ func (builder *UpdateChatReqBodyBuilder) ShareCardPermission(shareCardPermission return builder } -// at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 +// at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 // //示例值：all_members func (builder *UpdateChatReqBodyBuilder) AtAllPermission(atAllPermission string) *UpdateChatReqBodyBuilder { @@ -5716,7 +5716,7 @@ func (builder *UpdateChatReqBodyBuilder) AtAllPermission(atAllPermission string) return builder } -// 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 +// 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 // //示例值：all_members func (builder *UpdateChatReqBodyBuilder) EditPermission(editPermission string) *UpdateChatReqBodyBuilder { @@ -5734,7 +5734,7 @@ func (builder *UpdateChatReqBodyBuilder) OwnerId(ownerId string) *UpdateChatReqB return builder } -// 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // //示例值：only_owner func (builder *UpdateChatReqBodyBuilder) JoinMessageVisibility(joinMessageVisibility string) *UpdateChatReqBodyBuilder { @@ -5743,7 +5743,7 @@ func (builder *UpdateChatReqBodyBuilder) JoinMessageVisibility(joinMessageVisibi return builder } -// 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // //示例值：only_owner func (builder *UpdateChatReqBodyBuilder) LeaveMessageVisibility(leaveMessageVisibility string) *UpdateChatReqBodyBuilder { @@ -5752,7 +5752,7 @@ func (builder *UpdateChatReqBodyBuilder) LeaveMessageVisibility(leaveMessageVisi return builder } -// 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 +// 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 // //示例值：no_approval_required func (builder *UpdateChatReqBodyBuilder) MembershipApproval(membershipApproval string) *UpdateChatReqBodyBuilder { @@ -5761,7 +5761,7 @@ func (builder *UpdateChatReqBodyBuilder) MembershipApproval(membershipApproval s return builder } -// 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 +// 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 // //示例值：private func (builder *UpdateChatReqBodyBuilder) ChatType(chatType string) *UpdateChatReqBodyBuilder { @@ -5815,7 +5815,7 @@ func (builder *UpdateChatReqBodyBuilder) Build() *UpdateChatReqBody { } type UpdateChatPathReqBodyBuilder struct { - avatar string // 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） + avatar string // 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） avatarFlag bool name string // 群名称 nameFlag bool @@ -5823,27 +5823,27 @@ type UpdateChatPathReqBodyBuilder struct { descriptionFlag bool i18nNames *I18nNames // 群国际化名称 i18nNamesFlag bool - addMemberPermission string // 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则share_card_permission只能设置为`not_allowed`;- 若值设置为`all_members`，则share_card_permission只能设置为`allowed`;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + addMemberPermission string // 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则 share_card_permission 只能设置为`not_allowed`;- 若值设置为`all_members`，则 share_card_permission 只能设置为`allowed`;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 addMemberPermissionFlag bool - shareCardPermission string // 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许 + shareCardPermission string // 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许 shareCardPermissionFlag bool - atAllPermission string // at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + atAllPermission string // at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 atAllPermissionFlag bool - editPermission string // 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + editPermission string // 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 editPermissionFlag bool ownerId string // 新群主 ID ownerIdFlag bool - joinMessageVisibility string // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + joinMessageVisibility string // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 joinMessageVisibilityFlag bool - leaveMessageVisibility string // 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + leaveMessageVisibility string // 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 leaveMessageVisibilityFlag bool - membershipApproval string // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + membershipApproval string // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 membershipApprovalFlag bool labels []string // 群标签 labelsFlag bool toolkitIds []string // 群快捷组件列表 toolkitIdsFlag bool - chatType string // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 + chatType string // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 chatTypeFlag bool } @@ -5852,7 +5852,7 @@ func NewUpdateChatPathReqBodyBuilder() *UpdateChatPathReqBodyBuilder { return builder } -// 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） +// 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） // // 示例值：default-avatar_44ae0ca3-e140-494b-956f-78091e348435 func (builder *UpdateChatPathReqBodyBuilder) Avatar(avatar string) *UpdateChatPathReqBodyBuilder { @@ -5888,7 +5888,7 @@ func (builder *UpdateChatPathReqBodyBuilder) I18nNames(i18nNames *I18nNames) *Up return builder } -// 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则share_card_permission只能设置为`not_allowed`;- 若值设置为`all_members`，则share_card_permission只能设置为`allowed`;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 +// 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则 share_card_permission 只能设置为`not_allowed`;- 若值设置为`all_members`，则 share_card_permission 只能设置为`allowed`;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 // // 示例值：all_members func (builder *UpdateChatPathReqBodyBuilder) AddMemberPermission(addMemberPermission string) *UpdateChatPathReqBodyBuilder { @@ -5897,7 +5897,7 @@ func (builder *UpdateChatPathReqBodyBuilder) AddMemberPermission(addMemberPermis return builder } -// 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许 +// 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许 // // 示例值：allowed func (builder *UpdateChatPathReqBodyBuilder) ShareCardPermission(shareCardPermission string) *UpdateChatPathReqBodyBuilder { @@ -5906,7 +5906,7 @@ func (builder *UpdateChatPathReqBodyBuilder) ShareCardPermission(shareCardPermis return builder } -// at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 +// at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 // // 示例值：all_members func (builder *UpdateChatPathReqBodyBuilder) AtAllPermission(atAllPermission string) *UpdateChatPathReqBodyBuilder { @@ -5915,7 +5915,7 @@ func (builder *UpdateChatPathReqBodyBuilder) AtAllPermission(atAllPermission str return builder } -// 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 +// 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 // // 示例值：all_members func (builder *UpdateChatPathReqBodyBuilder) EditPermission(editPermission string) *UpdateChatPathReqBodyBuilder { @@ -5933,7 +5933,7 @@ func (builder *UpdateChatPathReqBodyBuilder) OwnerId(ownerId string) *UpdateChat return builder } -// 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // // 示例值：only_owner func (builder *UpdateChatPathReqBodyBuilder) JoinMessageVisibility(joinMessageVisibility string) *UpdateChatPathReqBodyBuilder { @@ -5942,7 +5942,7 @@ func (builder *UpdateChatPathReqBodyBuilder) JoinMessageVisibility(joinMessageVi return builder } -// 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 +// 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 // // 示例值：only_owner func (builder *UpdateChatPathReqBodyBuilder) LeaveMessageVisibility(leaveMessageVisibility string) *UpdateChatPathReqBodyBuilder { @@ -5951,7 +5951,7 @@ func (builder *UpdateChatPathReqBodyBuilder) LeaveMessageVisibility(leaveMessage return builder } -// 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 +// 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 // // 示例值：no_approval_required func (builder *UpdateChatPathReqBodyBuilder) MembershipApproval(membershipApproval string) *UpdateChatPathReqBodyBuilder { @@ -5960,7 +5960,7 @@ func (builder *UpdateChatPathReqBodyBuilder) MembershipApproval(membershipApprov return builder } -// 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 +// 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 // // 示例值：private func (builder *UpdateChatPathReqBodyBuilder) ChatType(chatType string) *UpdateChatPathReqBodyBuilder { @@ -6027,7 +6027,7 @@ func NewUpdateChatReqBuilder() *UpdateChatReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群组ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群组 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *UpdateChatReqBuilder) ChatId(chatId string) *UpdateChatReqBuilder { @@ -6035,7 +6035,7 @@ func (builder *UpdateChatReqBuilder) ChatId(chatId string) *UpdateChatReqBuilder return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateChatReqBuilder) UserIdType(userIdType string) *UpdateChatReqBuilder { @@ -6059,20 +6059,20 @@ func (builder *UpdateChatReqBuilder) Build() *UpdateChatReq { } type UpdateChatReqBody struct { - Avatar *string `json:"avatar,omitempty"` // 群头像对应的 Image Key，可通过[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） + Avatar *string `json:"avatar,omitempty"` // 群头像对应的 Image Key，可通过 [上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 获取（注意：上传图片的 ==image_type== 需要指定为 ==avatar==） Name *string `json:"name,omitempty"` // 群名称 Description *string `json:"description,omitempty"` // 群描述 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 - AddMemberPermission *string `json:"add_member_permission,omitempty"` // 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则share_card_permission只能设置为`not_allowed`;- 若值设置为`all_members`，则share_card_permission只能设置为`allowed`;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 - ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限;;**可选值有**：;- `allowed`：允许;- `not_allowed`：不允许 - AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 - EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限;;**可选值有**：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + AddMemberPermission *string `json:"add_member_permission,omitempty"` // 邀请用户或机器人入群权限;;注意：;- 若值设置为`only_owner`，则 share_card_permission 只能设置为`not_allowed`;- 若值设置为`all_members`，则 share_card_permission 只能设置为`allowed`;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + ShareCardPermission *string `json:"share_card_permission,omitempty"` // 群分享权限;;** 可选值有 **：;- `allowed`：允许;- `not_allowed`：不允许 + AtAllPermission *string `json:"at_all_permission,omitempty"` // at 所有人权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 + EditPermission *string `json:"edit_permission,omitempty"` // 群编辑权限;;** 可选值有 **：;- `only_owner`：仅群主和管理员;- `all_members`：所有成员 OwnerId *string `json:"owner_id,omitempty"` // 新群主 ID - JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 - LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性;;**可选值有**：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 - MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;**可选值有**：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 + JoinMessageVisibility *string `json:"join_message_visibility,omitempty"` // 入群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + LeaveMessageVisibility *string `json:"leave_message_visibility,omitempty"` // 出群消息可见性;;** 可选值有 **：;- `only_owner`：仅群主和管理员可见;- `all_members`：所有成员可见;- `not_anyone`：任何人均不可见 + MembershipApproval *string `json:"membership_approval,omitempty"` // 加群审批;;** 可选值有 **：;- `no_approval_required`：无需审批;- `approval_required`：需要审批 - ChatType *string `json:"chat_type,omitempty"` // 群类型;;**可选值有**：;- `private`：私有群;- `public`：公开群 + ChatType *string `json:"chat_type,omitempty"` // 群类型;;** 可选值有 **：;- `private`：私有群;- `public`：公开群 } type UpdateChatReq struct { @@ -6102,7 +6102,7 @@ func NewGetChatAnnouncementReqBuilder() *GetChatAnnouncementReqBuilder { return builder } -// 待获取公告的群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：不支持P2P单聊 +// 待获取公告的群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：不支持 P2P 单聊 // // 示例值：oc_5ad11d72b830411d72b836c20 func (builder *GetChatAnnouncementReqBuilder) ChatId(chatId string) *GetChatAnnouncementReqBuilder { @@ -6110,7 +6110,7 @@ func (builder *GetChatAnnouncementReqBuilder) ChatId(chatId string) *GetChatAnno return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：open_id func (builder *GetChatAnnouncementReqBuilder) UserIdType(userIdType string) *GetChatAnnouncementReqBuilder { @@ -6135,10 +6135,10 @@ type GetChatAnnouncementRespData struct { Revision *string `json:"revision,omitempty"` // 文档当前版本号 纯数字 CreateTime *string `json:"create_time,omitempty"` // 文档生成的时间戳（秒） UpdateTime *string `json:"update_time,omitempty"` // 文档更新的时间戳（秒） - OwnerIdType *string `json:"owner_id_type,omitempty"` // 文档所有者的 ID 类型;;- 如果所有者是用户，则与查询参数中的user_id_type 相同；取值为`open_id` `user_id` `union_id` 其中之一，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);- 如果所有者是机器人，为机器人应用的 `app_id`，详情参见 [获取应用身份访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/g) - OwnerId *string `json:"owner_id,omitempty"` // 文档所有者 ID，ID 值与owner_id_type 中的ID类型对应 - ModifierIdType *string `json:"modifier_id_type,omitempty"` // 文档最新修改者 id 类型;; - 如果修改者是用户，则与查询参数中的user_id_type 相同；取值为`open_id` `user_id` `union_id` 其中之一，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);- 如果修改者是机器人，为机器人应用的 `app_id`，详情参见 [获取应用身份访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/g) - ModifierId *string `json:"modifier_id,omitempty"` // 文档最新修改者 ID，ID 值与modifier_id_type 中的ID类型对应 + OwnerIdType *string `json:"owner_id_type,omitempty"` // 文档所有者的 ID 类型;;- 如果所有者是用户，则与查询参数中的 user_id_type 相同；取值为`open_id` `user_id` `union_id` 其中之一，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);- 如果所有者是机器人，为机器人应用的 `app_id`，详情参见 [获取应用身份访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/g) + OwnerId *string `json:"owner_id,omitempty"` // 文档所有者 ID，ID 值与 owner_id_type 中的 ID 类型对应 + ModifierIdType *string `json:"modifier_id_type,omitempty"` // 文档最新修改者 id 类型;; - 如果修改者是用户，则与查询参数中的 user_id_type 相同；取值为`open_id` `user_id` `union_id` 其中之一，不同 ID 的说明参见 [用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction);- 如果修改者是机器人，为机器人应用的 `app_id`，详情参见 [获取应用身份访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/g) + ModifierId *string `json:"modifier_id,omitempty"` // 文档最新修改者 ID，ID 值与 modifier_id_type 中的 ID 类型对应 } type GetChatAnnouncementResp struct { @@ -6152,9 +6152,9 @@ func (resp *GetChatAnnouncementResp) Success() bool { } type PatchChatAnnouncementReqBodyBuilder struct { - revision string // 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get)接口会返回 + revision string // 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get) 接口会返回 revisionFlag bool - requests []string // 修改文档请求的序列化字段;;更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN)格式相同 + requests []string // 修改文档请求的序列化字段;;更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN) 格式相同 requestsFlag bool } @@ -6163,7 +6163,7 @@ func NewPatchChatAnnouncementReqBodyBuilder() *PatchChatAnnouncementReqBodyBuild return builder } -// 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get)接口会返回 +// 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get) 接口会返回 // //示例值：12 func (builder *PatchChatAnnouncementReqBodyBuilder) Revision(revision string) *PatchChatAnnouncementReqBodyBuilder { @@ -6172,7 +6172,7 @@ func (builder *PatchChatAnnouncementReqBodyBuilder) Revision(revision string) *P return builder } -// 修改文档请求的序列化字段;;更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN)格式相同 +// 修改文档请求的序列化字段;;更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN) 格式相同 // //示例值：{\"requestType\":\"InsertBlocksRequestType\",\"insertBlocksRequest\":{\"payload\":\"{\\\"blocks\\\":[{\\\"type\\\":\\\"paragraph\\\",\\\"paragraph\\\":{\\\"elements\\\":[{\\\"type\\\":\\\"textRun\\\",\\\"textRun\\\":{\\\"text\\\":\\\"ylyyyyyDocs API Sample Content\\\",\\\"style\\\":{}}}],\\\"style\\\":{}}}]}\",\"location\":{\"zoneId\":\"0\",\"index\":0, \"endOfZone\": true}}} func (builder *PatchChatAnnouncementReqBodyBuilder) Requests(requests []string) *PatchChatAnnouncementReqBodyBuilder { @@ -6193,9 +6193,9 @@ func (builder *PatchChatAnnouncementReqBodyBuilder) Build() *PatchChatAnnounceme } type PatchChatAnnouncementPathReqBodyBuilder struct { - revision string // 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get)接口会返回 + revision string // 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get) 接口会返回 revisionFlag bool - requests []string // 修改文档请求的序列化字段;;更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN)格式相同 + requests []string // 修改文档请求的序列化字段;;更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN) 格式相同 requestsFlag bool } @@ -6204,7 +6204,7 @@ func NewPatchChatAnnouncementPathReqBodyBuilder() *PatchChatAnnouncementPathReqB return builder } -// 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get)接口会返回 +// 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get) 接口会返回 // // 示例值：12 func (builder *PatchChatAnnouncementPathReqBodyBuilder) Revision(revision string) *PatchChatAnnouncementPathReqBodyBuilder { @@ -6213,7 +6213,7 @@ func (builder *PatchChatAnnouncementPathReqBodyBuilder) Revision(revision string return builder } -// 修改文档请求的序列化字段;;更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN)格式相同 +// 修改文档请求的序列化字段;;更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN) 格式相同 // // 示例值：{\"requestType\":\"InsertBlocksRequestType\",\"insertBlocksRequest\":{\"payload\":\"{\\\"blocks\\\":[{\\\"type\\\":\\\"paragraph\\\",\\\"paragraph\\\":{\\\"elements\\\":[{\\\"type\\\":\\\"textRun\\\",\\\"textRun\\\":{\\\"text\\\":\\\"ylyyyyyDocs API Sample Content\\\",\\\"style\\\":{}}}],\\\"style\\\":{}}}]}\",\"location\":{\"zoneId\":\"0\",\"index\":0, \"endOfZone\": true}}} func (builder *PatchChatAnnouncementPathReqBodyBuilder) Requests(requests []string) *PatchChatAnnouncementPathReqBodyBuilder { @@ -6247,7 +6247,7 @@ func NewPatchChatAnnouncementReqBuilder() *PatchChatAnnouncementReqBuilder { return builder } -// 待修改公告的群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：不支持P2P单聊 +// 待修改公告的群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：不支持 P2P 单聊 // // 示例值：oc_5ad11d72b830411d72b836c20 func (builder *PatchChatAnnouncementReqBuilder) ChatId(chatId string) *PatchChatAnnouncementReqBuilder { @@ -6255,7 +6255,7 @@ func (builder *PatchChatAnnouncementReqBuilder) ChatId(chatId string) *PatchChat return builder } -// 更新会话中的群公告信息，更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。 +// 更新会话中的群公告信息，更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN) 格式相同。 func (builder *PatchChatAnnouncementReqBuilder) Body(body *PatchChatAnnouncementReqBody) *PatchChatAnnouncementReqBuilder { builder.body = body return builder @@ -6270,8 +6270,8 @@ func (builder *PatchChatAnnouncementReqBuilder) Build() *PatchChatAnnouncementRe } type PatchChatAnnouncementReqBody struct { - Revision *string `json:"revision,omitempty"` // 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get)接口会返回 - Requests []string `json:"requests,omitempty"` // 修改文档请求的序列化字段;;更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN)格式相同 + Revision *string `json:"revision,omitempty"` // 文档当前版本号 int64 类型，[获取群公告信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-announcement/get) 接口会返回 + Requests []string `json:"requests,omitempty"` // 修改文档请求的序列化字段;;更新公告信息的格式和更新 [云文档](https://open.feishu.cn/document/ukTMukTMukTM/uYDM2YjL2AjN24iNwYjN) 格式相同 } type PatchChatAnnouncementReq struct { @@ -6289,7 +6289,7 @@ func (resp *PatchChatAnnouncementResp) Success() bool { } type AddManagersChatManagersReqBodyBuilder struct { - managerIds []string // 要增加的 manager_id;;**注意**：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 + managerIds []string // 要增加的 manager_id;;** 注意 **：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 managerIdsFlag bool } @@ -6298,7 +6298,7 @@ func NewAddManagersChatManagersReqBodyBuilder() *AddManagersChatManagersReqBodyB return builder } -// 要增加的 manager_id;;**注意**：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 +// 要增加的 manager_id;;** 注意 **：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 // //示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *AddManagersChatManagersReqBodyBuilder) ManagerIds(managerIds []string) *AddManagersChatManagersReqBodyBuilder { @@ -6316,7 +6316,7 @@ func (builder *AddManagersChatManagersReqBodyBuilder) Build() *AddManagersChatMa } type AddManagersChatManagersPathReqBodyBuilder struct { - managerIds []string // 要增加的 manager_id;;**注意**：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 + managerIds []string // 要增加的 manager_id;;** 注意 **：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 managerIdsFlag bool } @@ -6325,7 +6325,7 @@ func NewAddManagersChatManagersPathReqBodyBuilder() *AddManagersChatManagersPath return builder } -// 要增加的 manager_id;;**注意**：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 +// 要增加的 manager_id;;** 注意 **：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 // // 示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *AddManagersChatManagersPathReqBodyBuilder) ManagerIds(managerIds []string) *AddManagersChatManagersPathReqBodyBuilder { @@ -6356,7 +6356,7 @@ func NewAddManagersChatManagersReqBuilder() *AddManagersChatManagersReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`、`topic`的群组ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`、`topic`的群组 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *AddManagersChatManagersReqBuilder) ChatId(chatId string) *AddManagersChatManagersReqBuilder { @@ -6364,7 +6364,7 @@ func (builder *AddManagersChatManagersReqBuilder) ChatId(chatId string) *AddMana return builder } -// 群成员 ID 类型 open_id/user_id/union_id/app_id;;**注意**： 指定机器人类型的管理员请使用 ==app_id== +// 群成员 ID 类型 open_id/user_id/union_id/app_id;;** 注意 **： 指定机器人类型的管理员请使用 ==app_id== // // 示例值：open_id func (builder *AddManagersChatManagersReqBuilder) MemberIdType(memberIdType string) *AddManagersChatManagersReqBuilder { @@ -6388,7 +6388,7 @@ func (builder *AddManagersChatManagersReqBuilder) Build() *AddManagersChatManage } type AddManagersChatManagersReqBody struct { - ManagerIds []string `json:"manager_ids,omitempty"` // 要增加的 manager_id;;**注意**：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 + ManagerIds []string `json:"manager_ids,omitempty"` // 要增加的 manager_id;;** 注意 **：;- 对于普通群，最多指定 10 个管理员;- 对于超大群，最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人 } type AddManagersChatManagersReq struct { @@ -6412,7 +6412,7 @@ func (resp *AddManagersChatManagersResp) Success() bool { } type DeleteManagersChatManagersReqBodyBuilder struct { - managerIds []string // 要删除的 manager_id;;**注意**：每次请求最多指定 50 个用户或者 5 个机器人 + managerIds []string // 要删除的 manager_id;;** 注意 **：每次请求最多指定 50 个用户或者 5 个机器人 managerIdsFlag bool } @@ -6421,7 +6421,7 @@ func NewDeleteManagersChatManagersReqBodyBuilder() *DeleteManagersChatManagersRe return builder } -// 要删除的 manager_id;;**注意**：每次请求最多指定 50 个用户或者 5 个机器人 +// 要删除的 manager_id;;** 注意 **：每次请求最多指定 50 个用户或者 5 个机器人 // //示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *DeleteManagersChatManagersReqBodyBuilder) ManagerIds(managerIds []string) *DeleteManagersChatManagersReqBodyBuilder { @@ -6439,7 +6439,7 @@ func (builder *DeleteManagersChatManagersReqBodyBuilder) Build() *DeleteManagers } type DeleteManagersChatManagersPathReqBodyBuilder struct { - managerIds []string // 要删除的 manager_id;;**注意**：每次请求最多指定 50 个用户或者 5 个机器人 + managerIds []string // 要删除的 manager_id;;** 注意 **：每次请求最多指定 50 个用户或者 5 个机器人 managerIdsFlag bool } @@ -6448,7 +6448,7 @@ func NewDeleteManagersChatManagersPathReqBodyBuilder() *DeleteManagersChatManage return builder } -// 要删除的 manager_id;;**注意**：每次请求最多指定 50 个用户或者 5 个机器人 +// 要删除的 manager_id;;** 注意 **：每次请求最多指定 50 个用户或者 5 个机器人 // // 示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *DeleteManagersChatManagersPathReqBodyBuilder) ManagerIds(managerIds []string) *DeleteManagersChatManagersPathReqBodyBuilder { @@ -6479,7 +6479,7 @@ func NewDeleteManagersChatManagersReqBuilder() *DeleteManagersChatManagersReqBui return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`、`topic`的群组ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`、`topic`的群组 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *DeleteManagersChatManagersReqBuilder) ChatId(chatId string) *DeleteManagersChatManagersReqBuilder { @@ -6487,7 +6487,7 @@ func (builder *DeleteManagersChatManagersReqBuilder) ChatId(chatId string) *Dele return builder } -// 群成员 id 类型 open_id/user_id/union_id/app_id;;**注意**：删除机器人类型的管理员请使用 ==app_id== +// 群成员 id 类型 open_id/user_id/union_id/app_id;;** 注意 **：删除机器人类型的管理员请使用 ==app_id== // // 示例值：open_id func (builder *DeleteManagersChatManagersReqBuilder) MemberIdType(memberIdType string) *DeleteManagersChatManagersReqBuilder { @@ -6511,7 +6511,7 @@ func (builder *DeleteManagersChatManagersReqBuilder) Build() *DeleteManagersChat } type DeleteManagersChatManagersReqBody struct { - ManagerIds []string `json:"manager_ids,omitempty"` // 要删除的 manager_id;;**注意**：每次请求最多指定 50 个用户或者 5 个机器人 + ManagerIds []string `json:"manager_ids,omitempty"` // 要删除的 manager_id;;** 注意 **：每次请求最多指定 50 个用户或者 5 个机器人 } type DeleteManagersChatManagersReq struct { @@ -6535,7 +6535,7 @@ func (resp *DeleteManagersChatManagersResp) Success() bool { } type CreateChatMembersReqBodyBuilder struct { - idList []string // 成员ID列表，获取ID请参见[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;**注意**：;- 成员列表不可为空;- 每次请求最多拉50个用户或者5个机器人，并且群组最多容纳15个机器人;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群5000人，会议群3000人，话题群5000人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 + idList []string // 成员 ID 列表，获取 ID 请参见 [如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;** 注意 **：;- 成员列表不可为空;- 每次请求最多拉 50 个用户或者 5 个机器人，并且群组最多容纳 15 个机器人;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群 5000 人，会议群 3000 人，话题群 5000 人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 idListFlag bool } @@ -6544,7 +6544,7 @@ func NewCreateChatMembersReqBodyBuilder() *CreateChatMembersReqBodyBuilder { return builder } -// 成员ID列表，获取ID请参见[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;**注意**：;- 成员列表不可为空;- 每次请求最多拉50个用户或者5个机器人，并且群组最多容纳15个机器人;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群5000人，会议群3000人，话题群5000人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 +// 成员 ID 列表，获取 ID 请参见 [如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;** 注意 **：;- 成员列表不可为空;- 每次请求最多拉 50 个用户或者 5 个机器人，并且群组最多容纳 15 个机器人;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群 5000 人，会议群 3000 人，话题群 5000 人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 // //示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *CreateChatMembersReqBodyBuilder) IdList(idList []string) *CreateChatMembersReqBodyBuilder { @@ -6562,7 +6562,7 @@ func (builder *CreateChatMembersReqBodyBuilder) Build() *CreateChatMembersReqBod } type CreateChatMembersPathReqBodyBuilder struct { - idList []string // 成员ID列表，获取ID请参见[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;**注意**：;- 成员列表不可为空;- 每次请求最多拉50个用户或者5个机器人，并且群组最多容纳15个机器人;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群5000人，会议群3000人，话题群5000人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 + idList []string // 成员 ID 列表，获取 ID 请参见 [如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;** 注意 **：;- 成员列表不可为空;- 每次请求最多拉 50 个用户或者 5 个机器人，并且群组最多容纳 15 个机器人;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群 5000 人，会议群 3000 人，话题群 5000 人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 idListFlag bool } @@ -6571,7 +6571,7 @@ func NewCreateChatMembersPathReqBodyBuilder() *CreateChatMembersPathReqBodyBuild return builder } -// 成员ID列表，获取ID请参见[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;**注意**：;- 成员列表不可为空;- 每次请求最多拉50个用户或者5个机器人，并且群组最多容纳15个机器人;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群5000人，会议群3000人，话题群5000人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 +// 成员 ID 列表，获取 ID 请参见 [如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;** 注意 **：;- 成员列表不可为空;- 每次请求最多拉 50 个用户或者 5 个机器人，并且群组最多容纳 15 个机器人;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群 5000 人，会议群 3000 人，话题群 5000 人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 // // 示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *CreateChatMembersPathReqBodyBuilder) IdList(idList []string) *CreateChatMembersPathReqBodyBuilder { @@ -6602,7 +6602,7 @@ func NewCreateChatMembersReqBuilder() *CreateChatMembersReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`、`topic`的群组ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`、`topic`的群组 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *CreateChatMembersReqBuilder) ChatId(chatId string) *CreateChatMembersReqBuilder { @@ -6610,7 +6610,7 @@ func (builder *CreateChatMembersReqBuilder) ChatId(chatId string) *CreateChatMem return builder } -// 进群成员 ID 类型 open_id/user_id/union_id/app_id;;**注意**：拉机器人入群请使用 ==app_id== +// 进群成员 ID 类型 open_id/user_id/union_id/app_id;;** 注意 **：拉机器人入群请使用 ==app_id== // // 示例值：open_id func (builder *CreateChatMembersReqBuilder) MemberIdType(memberIdType string) *CreateChatMembersReqBuilder { @@ -6618,7 +6618,7 @@ func (builder *CreateChatMembersReqBuilder) MemberIdType(memberIdType string) *C return builder } -// 出现不可用ID后的处理方式 0/1/2 +// 出现不可用 ID 后的处理方式 0/1/2 // // 示例值：0 func (builder *CreateChatMembersReqBuilder) SucceedType(succeedType int) *CreateChatMembersReqBuilder { @@ -6642,7 +6642,7 @@ func (builder *CreateChatMembersReqBuilder) Build() *CreateChatMembersReq { } type CreateChatMembersReqBody struct { - IdList []string `json:"id_list,omitempty"` // 成员ID列表，获取ID请参见[如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;**注意**：;- 成员列表不可为空;- 每次请求最多拉50个用户或者5个机器人，并且群组最多容纳15个机器人;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群5000人，会议群3000人，话题群5000人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 + IdList []string `json:"id_list,omitempty"` // 成员 ID 列表，获取 ID 请参见 [如何获得 User ID、Open ID 和 Union ID？](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get);;** 注意 **：;- 成员列表不可为空;- 每次请求最多拉 50 个用户或者 5 个机器人，并且群组最多容纳 15 个机器人;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应;- 对于已认证企业的飞书的群人数默认上限：普通群 5000 人，会议群 3000 人，话题群 5000 人。若租户管理员配置了群人数上限，则群人数上限为该人数上限。 } type CreateChatMembersReq struct { @@ -6651,9 +6651,9 @@ type CreateChatMembersReq struct { } type CreateChatMembersRespData struct { - InvalidIdList []string `json:"invalid_id_list,omitempty"` // 无效成员列表;;**注意**：;- 当`success_type=0`时，`invalid_id_list`只包含已离职的用户ID;- 当`success_type=1`时，`invalid_id_list`中包含已离职的、不可见的、应用未激活的ID - NotExistedIdList []string `json:"not_existed_id_list,omitempty"` // ID不存在的成员列表 - PendingApprovalIdList []string `json:"pending_approval_id_list,omitempty"` // 等待群主或管理员审批的成员ID列表 + InvalidIdList []string `json:"invalid_id_list,omitempty"` // 无效成员列表;;** 注意 **：;- 当`success_type=0`时，`invalid_id_list`只包含已离职的用户 ID;- 当`success_type=1`时，`invalid_id_list`中包含已离职的、不可见的、应用未激活的 ID + NotExistedIdList []string `json:"not_existed_id_list,omitempty"` // ID 不存在的成员列表 + PendingApprovalIdList []string `json:"pending_approval_id_list,omitempty"` // 等待群主或管理员审批的成员 ID 列表 } type CreateChatMembersResp struct { @@ -6667,7 +6667,7 @@ func (resp *CreateChatMembersResp) Success() bool { } type DeleteChatMembersReqBodyBuilder struct { - idList []string // 成员列表;;**注意**：;- 成员列表不可为空;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应 + idList []string // 成员列表;;** 注意 **：;- 成员列表不可为空;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应 idListFlag bool } @@ -6676,7 +6676,7 @@ func NewDeleteChatMembersReqBodyBuilder() *DeleteChatMembersReqBodyBuilder { return builder } -// 成员列表;;**注意**：;- 成员列表不可为空;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应 +// 成员列表;;** 注意 **：;- 成员列表不可为空;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应 // //示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *DeleteChatMembersReqBodyBuilder) IdList(idList []string) *DeleteChatMembersReqBodyBuilder { @@ -6694,7 +6694,7 @@ func (builder *DeleteChatMembersReqBodyBuilder) Build() *DeleteChatMembersReqBod } type DeleteChatMembersPathReqBodyBuilder struct { - idList []string // 成员列表;;**注意**：;- 成员列表不可为空;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应 + idList []string // 成员列表;;** 注意 **：;- 成员列表不可为空;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应 idListFlag bool } @@ -6703,7 +6703,7 @@ func NewDeleteChatMembersPathReqBodyBuilder() *DeleteChatMembersPathReqBodyBuild return builder } -// 成员列表;;**注意**：;- 成员列表不可为空;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应 +// 成员列表;;** 注意 **：;- 成员列表不可为空;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应 // // 示例值：["ou_9204a37300b3700d61effaa439f34295"] func (builder *DeleteChatMembersPathReqBodyBuilder) IdList(idList []string) *DeleteChatMembersPathReqBodyBuilder { @@ -6734,7 +6734,7 @@ func NewDeleteChatMembersReqBuilder() *DeleteChatMembersReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`、`topic`的群组ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`、`topic`的群组 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *DeleteChatMembersReqBuilder) ChatId(chatId string) *DeleteChatMembersReqBuilder { @@ -6742,7 +6742,7 @@ func (builder *DeleteChatMembersReqBuilder) ChatId(chatId string) *DeleteChatMem return builder } -// 出群成员ID类型;;**注意**：移除机器人请使用 ==app_id== +// 出群成员 ID 类型;;** 注意 **：移除机器人请使用 ==app_id== // // 示例值：open_id func (builder *DeleteChatMembersReqBuilder) MemberIdType(memberIdType string) *DeleteChatMembersReqBuilder { @@ -6766,7 +6766,7 @@ func (builder *DeleteChatMembersReqBuilder) Build() *DeleteChatMembersReq { } type DeleteChatMembersReqBody struct { - IdList []string `json:"id_list,omitempty"` // 成员列表;;**注意**：;- 成员列表不可为空;- 列表中填写的成员ID类型应与 ==member_id_type== 参数中选择的类型相对应 + IdList []string `json:"id_list,omitempty"` // 成员列表;;** 注意 **：;- 成员列表不可为空;- 列表中填写的成员 ID 类型应与 ==member_id_type== 参数中选择的类型相对应 } type DeleteChatMembersReq struct { @@ -6808,7 +6808,7 @@ func (builder *GetChatMembersReqBuilder) Limit(limit int) *GetChatMembersReqBuil return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *GetChatMembersReqBuilder) ChatId(chatId string) *GetChatMembersReqBuilder { @@ -6885,7 +6885,7 @@ func NewIsInChatChatMembersReqBuilder() *IsInChatChatMembersReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *IsInChatChatMembersReqBuilder) ChatId(chatId string) *IsInChatChatMembersReqBuilder { @@ -6931,7 +6931,7 @@ func NewMeJoinChatMembersReqBuilder() *MeJoinChatMembersReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：;- 仅支持公开（Public）群类型;- 对于已认证企业的飞书的群人数默认上限：普通群5000人，会议群3000人，话题群5000人 +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：;- 仅支持公开（Public）群类型;- 对于已认证企业的飞书的群人数默认上限：普通群 5000 人，会议群 3000 人，话题群 5000 人 // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *MeJoinChatMembersReqBuilder) ChatId(chatId string) *MeJoinChatMembersReqBuilder { @@ -7055,7 +7055,7 @@ func NewPatchChatMenuItemReqBuilder() *PatchChatMenuItemReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *PatchChatMenuItemReqBuilder) ChatId(chatId string) *PatchChatMenuItemReqBuilder { @@ -7063,7 +7063,7 @@ func (builder *PatchChatMenuItemReqBuilder) ChatId(chatId string) *PatchChatMenu return builder } -// 一级或二级菜单ID，通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口通过群ID获取菜单ID。 +// 一级或二级菜单 ID，通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口通过群 ID 获取菜单 ID。 // // 示例值：7156553273518882844 func (builder *PatchChatMenuItemReqBuilder) MenuItemId(menuItemId string) *PatchChatMenuItemReqBuilder { @@ -7177,7 +7177,7 @@ func NewCreateChatMenuTreeReqBuilder() *CreateChatMenuTreeReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *CreateChatMenuTreeReqBuilder) ChatId(chatId string) *CreateChatMenuTreeReqBuilder { @@ -7223,7 +7223,7 @@ func (resp *CreateChatMenuTreeResp) Success() bool { } type DeleteChatMenuTreeReqBodyBuilder struct { - chatMenuTopLevelIds []string // 群内要删除的一级菜单ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 + chatMenuTopLevelIds []string // 群内要删除的一级菜单 ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 chatMenuTopLevelIdsFlag bool } @@ -7232,7 +7232,7 @@ func NewDeleteChatMenuTreeReqBodyBuilder() *DeleteChatMenuTreeReqBodyBuilder { return builder } -// 群内要删除的一级菜单ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 +// 群内要删除的一级菜单 ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 // //示例值：7156553273518882844 func (builder *DeleteChatMenuTreeReqBodyBuilder) ChatMenuTopLevelIds(chatMenuTopLevelIds []string) *DeleteChatMenuTreeReqBodyBuilder { @@ -7250,7 +7250,7 @@ func (builder *DeleteChatMenuTreeReqBodyBuilder) Build() *DeleteChatMenuTreeReqB } type DeleteChatMenuTreePathReqBodyBuilder struct { - chatMenuTopLevelIds []string // 群内要删除的一级菜单ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 + chatMenuTopLevelIds []string // 群内要删除的一级菜单 ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 chatMenuTopLevelIdsFlag bool } @@ -7259,7 +7259,7 @@ func NewDeleteChatMenuTreePathReqBodyBuilder() *DeleteChatMenuTreePathReqBodyBui return builder } -// 群内要删除的一级菜单ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 +// 群内要删除的一级菜单 ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 // // 示例值：7156553273518882844 func (builder *DeleteChatMenuTreePathReqBodyBuilder) ChatMenuTopLevelIds(chatMenuTopLevelIds []string) *DeleteChatMenuTreePathReqBodyBuilder { @@ -7290,7 +7290,7 @@ func NewDeleteChatMenuTreeReqBuilder() *DeleteChatMenuTreeReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *DeleteChatMenuTreeReqBuilder) ChatId(chatId string) *DeleteChatMenuTreeReqBuilder { @@ -7313,7 +7313,7 @@ func (builder *DeleteChatMenuTreeReqBuilder) Build() *DeleteChatMenuTreeReq { } type DeleteChatMenuTreeReqBody struct { - ChatMenuTopLevelIds []string `json:"chat_menu_top_level_ids,omitempty"` // 群内要删除的一级菜单ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 + ChatMenuTopLevelIds []string `json:"chat_menu_top_level_ids,omitempty"` // 群内要删除的一级菜单 ID。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 } type DeleteChatMenuTreeReq struct { @@ -7348,7 +7348,7 @@ func NewGetChatMenuTreeReqBuilder() *GetChatMenuTreeReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *GetChatMenuTreeReqBuilder) ChatId(chatId string) *GetChatMenuTreeReqBuilder { @@ -7382,7 +7382,7 @@ func (resp *GetChatMenuTreeResp) Success() bool { } type SortChatMenuTreeReqBodyBuilder struct { - chatMenuTopLevelIds []string // 新的一级菜单的顺序，进行排序ID列表需要跟群内目前存在的一级菜单ID列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 + chatMenuTopLevelIds []string // 新的一级菜单的顺序，进行排序 ID 列表需要跟群内目前存在的一级菜单 ID 列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 chatMenuTopLevelIdsFlag bool } @@ -7391,7 +7391,7 @@ func NewSortChatMenuTreeReqBodyBuilder() *SortChatMenuTreeReqBodyBuilder { return builder } -// 新的一级菜单的顺序，进行排序ID列表需要跟群内目前存在的一级菜单ID列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 +// 新的一级菜单的顺序，进行排序 ID 列表需要跟群内目前存在的一级菜单 ID 列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 // //示例值：7156553273518882844 func (builder *SortChatMenuTreeReqBodyBuilder) ChatMenuTopLevelIds(chatMenuTopLevelIds []string) *SortChatMenuTreeReqBodyBuilder { @@ -7409,7 +7409,7 @@ func (builder *SortChatMenuTreeReqBodyBuilder) Build() *SortChatMenuTreeReqBody } type SortChatMenuTreePathReqBodyBuilder struct { - chatMenuTopLevelIds []string // 新的一级菜单的顺序，进行排序ID列表需要跟群内目前存在的一级菜单ID列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 + chatMenuTopLevelIds []string // 新的一级菜单的顺序，进行排序 ID 列表需要跟群内目前存在的一级菜单 ID 列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 chatMenuTopLevelIdsFlag bool } @@ -7418,7 +7418,7 @@ func NewSortChatMenuTreePathReqBodyBuilder() *SortChatMenuTreePathReqBodyBuilder return builder } -// 新的一级菜单的顺序，进行排序ID列表需要跟群内目前存在的一级菜单ID列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 +// 新的一级菜单的顺序，进行排序 ID 列表需要跟群内目前存在的一级菜单 ID 列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 // // 示例值：7156553273518882844 func (builder *SortChatMenuTreePathReqBodyBuilder) ChatMenuTopLevelIds(chatMenuTopLevelIds []string) *SortChatMenuTreePathReqBodyBuilder { @@ -7449,7 +7449,7 @@ func NewSortChatMenuTreeReqBuilder() *SortChatMenuTreeReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：仅支持群模式为`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：仅支持群模式为`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *SortChatMenuTreeReqBuilder) ChatId(chatId string) *SortChatMenuTreeReqBuilder { @@ -7472,7 +7472,7 @@ func (builder *SortChatMenuTreeReqBuilder) Build() *SortChatMenuTreeReq { } type SortChatMenuTreeReqBody struct { - ChatMenuTopLevelIds []string `json:"chat_menu_top_level_ids,omitempty"` // 新的一级菜单的顺序，进行排序ID列表需要跟群内目前存在的一级菜单ID列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 + ChatMenuTopLevelIds []string `json:"chat_menu_top_level_ids,omitempty"` // 新的一级菜单的顺序，进行排序 ID 列表需要跟群内目前存在的一级菜单 ID 列表对齐。通过 [获取群菜单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-menu_tree/get) 接口获取群内菜单详情。 } type SortChatMenuTreeReq struct { @@ -7514,7 +7514,7 @@ func (builder *GetChatModerationReqBuilder) Limit(limit int) *GetChatModerationR return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *GetChatModerationReqBuilder) ChatId(chatId string) *GetChatModerationReqBuilder { @@ -7522,7 +7522,7 @@ func (builder *GetChatModerationReqBuilder) ChatId(chatId string) *GetChatModera return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetChatModerationReqBuilder) UserIdType(userIdType string) *GetChatModerationReqBuilder { @@ -7702,7 +7702,7 @@ func NewUpdateChatModerationReqBuilder() *UpdateChatModerationReqBuilder { return builder } -// 群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *UpdateChatModerationReqBuilder) ChatId(chatId string) *UpdateChatModerationReqBuilder { @@ -7710,7 +7710,7 @@ func (builder *UpdateChatModerationReqBuilder) ChatId(chatId string) *UpdateChat return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateChatModerationReqBuilder) UserIdType(userIdType string) *UpdateChatModerationReqBuilder { @@ -7754,7 +7754,7 @@ func (resp *UpdateChatModerationResp) Success() bool { } type CreateChatTabReqBodyBuilder struct { - chatTabs []*ChatTab // 会话标签页;;**注意**：一个群内最多只允许添加20个自定义会话标签页 + chatTabs []*ChatTab // 会话标签页;;** 注意 **：一个群内最多只允许添加 20 个自定义会话标签页 chatTabsFlag bool } @@ -7763,7 +7763,7 @@ func NewCreateChatTabReqBodyBuilder() *CreateChatTabReqBodyBuilder { return builder } -// 会话标签页;;**注意**：一个群内最多只允许添加20个自定义会话标签页 +// 会话标签页;;** 注意 **：一个群内最多只允许添加 20 个自定义会话标签页 // //示例值： func (builder *CreateChatTabReqBodyBuilder) ChatTabs(chatTabs []*ChatTab) *CreateChatTabReqBodyBuilder { @@ -7781,7 +7781,7 @@ func (builder *CreateChatTabReqBodyBuilder) Build() *CreateChatTabReqBody { } type CreateChatTabPathReqBodyBuilder struct { - chatTabs []*ChatTab // 会话标签页;;**注意**：一个群内最多只允许添加20个自定义会话标签页 + chatTabs []*ChatTab // 会话标签页;;** 注意 **：一个群内最多只允许添加 20 个自定义会话标签页 chatTabsFlag bool } @@ -7790,7 +7790,7 @@ func NewCreateChatTabPathReqBodyBuilder() *CreateChatTabPathReqBodyBuilder { return builder } -// 会话标签页;;**注意**：一个群内最多只允许添加20个自定义会话标签页 +// 会话标签页;;** 注意 **：一个群内最多只允许添加 20 个自定义会话标签页 // // 示例值： func (builder *CreateChatTabPathReqBodyBuilder) ChatTabs(chatTabs []*ChatTab) *CreateChatTabPathReqBodyBuilder { @@ -7821,7 +7821,7 @@ func NewCreateChatTabReqBuilder() *CreateChatTabReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：支持群模式为`p2p`与`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：支持群模式为`p2p`与`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *CreateChatTabReqBuilder) ChatId(chatId string) *CreateChatTabReqBuilder { @@ -7844,7 +7844,7 @@ func (builder *CreateChatTabReqBuilder) Build() *CreateChatTabReq { } type CreateChatTabReqBody struct { - ChatTabs []*ChatTab `json:"chat_tabs,omitempty"` // 会话标签页;;**注意**：一个群内最多只允许添加20个自定义会话标签页 + ChatTabs []*ChatTab `json:"chat_tabs,omitempty"` // 会话标签页;;** 注意 **：一个群内最多只允许添加 20 个自定义会话标签页 } type CreateChatTabReq struct { @@ -7867,7 +7867,7 @@ func (resp *CreateChatTabResp) Success() bool { } type DeleteTabsChatTabReqBodyBuilder struct { - tabIds []string // 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取 + tabIds []string // 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取 tabIdsFlag bool } @@ -7876,7 +7876,7 @@ func NewDeleteTabsChatTabReqBodyBuilder() *DeleteTabsChatTabReqBodyBuilder { return builder } -// 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取 +// 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取 // //示例值：["7101214603622940671", "7101214603622940672"] func (builder *DeleteTabsChatTabReqBodyBuilder) TabIds(tabIds []string) *DeleteTabsChatTabReqBodyBuilder { @@ -7894,7 +7894,7 @@ func (builder *DeleteTabsChatTabReqBodyBuilder) Build() *DeleteTabsChatTabReqBod } type DeleteTabsChatTabPathReqBodyBuilder struct { - tabIds []string // 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取 + tabIds []string // 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取 tabIdsFlag bool } @@ -7903,7 +7903,7 @@ func NewDeleteTabsChatTabPathReqBodyBuilder() *DeleteTabsChatTabPathReqBodyBuild return builder } -// 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取 +// 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取 // // 示例值：["7101214603622940671", "7101214603622940672"] func (builder *DeleteTabsChatTabPathReqBodyBuilder) TabIds(tabIds []string) *DeleteTabsChatTabPathReqBodyBuilder { @@ -7934,7 +7934,7 @@ func NewDeleteTabsChatTabReqBuilder() *DeleteTabsChatTabReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：支持群模式为`p2p`与`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：支持群模式为`p2p`与`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *DeleteTabsChatTabReqBuilder) ChatId(chatId string) *DeleteTabsChatTabReqBuilder { @@ -7957,7 +7957,7 @@ func (builder *DeleteTabsChatTabReqBuilder) Build() *DeleteTabsChatTabReq { } type DeleteTabsChatTabReqBody struct { - TabIds []string `json:"tab_ids,omitempty"` // 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取 + TabIds []string `json:"tab_ids,omitempty"` // 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取 } type DeleteTabsChatTabReq struct { @@ -7992,7 +7992,7 @@ func NewListTabsChatTabReqBuilder() *ListTabsChatTabReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：支持群模式为`p2p`与`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：支持群模式为`p2p`与`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *ListTabsChatTabReqBuilder) ChatId(chatId string) *ListTabsChatTabReqBuilder { @@ -8026,7 +8026,7 @@ func (resp *ListTabsChatTabResp) Success() bool { } type SortTabsChatTabReqBodyBuilder struct { - tabIds []string // 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取;;**注意**：必须包含该会话中全部的Tab ID + tabIds []string // 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取;;** 注意 **：必须包含该会话中全部的 Tab ID tabIdsFlag bool } @@ -8035,7 +8035,7 @@ func NewSortTabsChatTabReqBodyBuilder() *SortTabsChatTabReqBodyBuilder { return builder } -// 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取;;**注意**：必须包含该会话中全部的Tab ID +// 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取;;** 注意 **：必须包含该会话中全部的 Tab ID // //示例值：["7101214603622940671", "7101214603622940672"] func (builder *SortTabsChatTabReqBodyBuilder) TabIds(tabIds []string) *SortTabsChatTabReqBodyBuilder { @@ -8053,7 +8053,7 @@ func (builder *SortTabsChatTabReqBodyBuilder) Build() *SortTabsChatTabReqBody { } type SortTabsChatTabPathReqBodyBuilder struct { - tabIds []string // 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取;;**注意**：必须包含该会话中全部的Tab ID + tabIds []string // 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取;;** 注意 **：必须包含该会话中全部的 Tab ID tabIdsFlag bool } @@ -8062,7 +8062,7 @@ func NewSortTabsChatTabPathReqBodyBuilder() *SortTabsChatTabPathReqBodyBuilder { return builder } -// 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取;;**注意**：必须包含该会话中全部的Tab ID +// 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取;;** 注意 **：必须包含该会话中全部的 Tab ID // // 示例值：["7101214603622940671", "7101214603622940672"] func (builder *SortTabsChatTabPathReqBodyBuilder) TabIds(tabIds []string) *SortTabsChatTabPathReqBodyBuilder { @@ -8093,7 +8093,7 @@ func NewSortTabsChatTabReqBuilder() *SortTabsChatTabReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：支持群模式为`p2p`与`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：支持群模式为`p2p`与`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *SortTabsChatTabReqBuilder) ChatId(chatId string) *SortTabsChatTabReqBuilder { @@ -8116,7 +8116,7 @@ func (builder *SortTabsChatTabReqBuilder) Build() *SortTabsChatTabReq { } type SortTabsChatTabReqBody struct { - TabIds []string `json:"tab_ids,omitempty"` // 会话标签页ID列表，Tab ID可以在[添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create)与[拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs)的返回值中获取;;**注意**：必须包含该会话中全部的Tab ID + TabIds []string `json:"tab_ids,omitempty"` // 会话标签页 ID 列表，Tab ID 可以在 [添加会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/create) 与 [拉取会话标签页](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-tab/list_tabs) 的返回值中获取;;** 注意 **：必须包含该会话中全部的 Tab ID } type SortTabsChatTabReq struct { @@ -8206,7 +8206,7 @@ func NewUpdateTabsChatTabReqBuilder() *UpdateTabsChatTabReqBuilder { return builder } -// 群ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;**注意**：支持群模式为`p2p`与`group`的群ID +// 群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description);;** 注意 **：支持群模式为`p2p`与`group`的群 ID // // 示例值：oc_a0553eda9014c201e6969b478895c230 func (builder *UpdateTabsChatTabReqBuilder) ChatId(chatId string) *UpdateTabsChatTabReqBuilder { @@ -8264,7 +8264,7 @@ func NewDeleteTopNoticeChatTopNoticeReqBuilder() *DeleteTopNoticeChatTopNoticeRe return builder } -// 待撤销置顶的群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 待撤销置顶的群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_5ad11d72b830411d72b836c20 func (builder *DeleteTopNoticeChatTopNoticeReqBuilder) ChatId(chatId string) *DeleteTopNoticeChatTopNoticeReqBuilder { @@ -8360,7 +8360,7 @@ func NewPutTopNoticeChatTopNoticeReqBuilder() *PutTopNoticeChatTopNoticeReqBuild return builder } -// 待修改置顶的群 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 待修改置顶的群 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_5ad11d72b830411d72b836c20 func (builder *PutTopNoticeChatTopNoticeReqBuilder) ChatId(chatId string) *PutTopNoticeChatTopNoticeReqBuilder { @@ -8405,7 +8405,7 @@ type CreateFileReqBodyBuilder struct { fileTypeFlag bool fileName string // 带后缀的文件名 fileNameFlag bool - duration int // 文件的时长（视频、音频），单位:毫秒。不填充时无法显示具体时长。 + duration int // 文件的时长（视频、音频），单位：毫秒。不填充时无法显示具体时长。 durationFlag bool file io.Reader // 文件内容 fileFlag bool @@ -8434,7 +8434,7 @@ func (builder *CreateFileReqBodyBuilder) FileName(fileName string) *CreateFileRe return builder } -// 文件的时长（视频、音频），单位:毫秒。不填充时无法显示具体时长。 +// 文件的时长（视频、音频），单位：毫秒。不填充时无法显示具体时长。 // //示例值：3000 func (builder *CreateFileReqBodyBuilder) Duration(duration int) *CreateFileReqBodyBuilder { @@ -8474,7 +8474,7 @@ type CreateFilePathReqBodyBuilder struct { fileTypeFlag bool fileName string // 带后缀的文件名 fileNameFlag bool - duration int // 文件的时长（视频、音频），单位:毫秒。不填充时无法显示具体时长。 + duration int // 文件的时长（视频、音频），单位：毫秒。不填充时无法显示具体时长。 durationFlag bool filePath string // 文件内容 filePathFlag bool @@ -8503,7 +8503,7 @@ func (builder *CreateFilePathReqBodyBuilder) FileName(fileName string) *CreateFi return builder } -// 文件的时长（视频、音频），单位:毫秒。不填充时无法显示具体时长。 +// 文件的时长（视频、音频），单位：毫秒。不填充时无法显示具体时长。 // // 示例值：3000 func (builder *CreateFilePathReqBodyBuilder) Duration(duration int) *CreateFilePathReqBodyBuilder { @@ -8572,7 +8572,7 @@ func (builder *CreateFileReqBuilder) Build() *CreateFileReq { type CreateFileReqBody struct { FileType *string `json:"file_type,omitempty"` // 文件类型 FileName *string `json:"file_name,omitempty"` // 带后缀的文件名 - Duration *int `json:"duration,omitempty"` // 文件的时长（视频、音频），单位:毫秒。不填充时无法显示具体时长。 + Duration *int `json:"duration,omitempty"` // 文件的时长（视频、音频），单位：毫秒。不填充时无法显示具体时长。 File io.Reader `json:"file,omitempty"` // 文件内容 } @@ -8582,7 +8582,7 @@ type CreateFileReq struct { } type CreateFileRespData struct { - FileKey *string `json:"file_key,omitempty"` // 文件的key + FileKey *string `json:"file_key,omitempty"` // 文件的 key } type CreateFileResp struct { @@ -8608,7 +8608,7 @@ func NewGetFileReqBuilder() *GetFileReqBuilder { return builder } -// 文件的key，通过[上传文件]( https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口上传图片后获得 +// 文件的 key，通过 [上传文件]( https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create) 接口上传图片后获得 // // 示例值：file_456a92d6-c6ea-4de4-ac3f-7afcf44ac78g func (builder *GetFileReqBuilder) FileKey(fileKey string) *GetFileReqBuilder { @@ -8654,7 +8654,7 @@ func (resp *GetFileResp) WriteFile(fileName string) error { type CreateImageReqBodyBuilder struct { imageType string // 图片类型 imageTypeFlag bool - image io.Reader // 图片内容;; **注意：** 上传的图片大小不能超过10MB + image io.Reader // 图片内容;; ** 注意：** 上传的图片大小不能超过 10MB imageFlag bool } @@ -8672,7 +8672,7 @@ func (builder *CreateImageReqBodyBuilder) ImageType(imageType string) *CreateIma return builder } -// 图片内容;; **注意：** 上传的图片大小不能超过10MB +// 图片内容;; ** 注意：** 上传的图片大小不能超过 10MB // //示例值：二进制文件 func (builder *CreateImageReqBodyBuilder) Image(image io.Reader) *CreateImageReqBodyBuilder { @@ -8695,7 +8695,7 @@ func (builder *CreateImageReqBodyBuilder) Build() *CreateImageReqBody { type CreateImagePathReqBodyBuilder struct { imageType string // 图片类型 imageTypeFlag bool - imagePath string // 图片内容;; **注意：** 上传的图片大小不能超过10MB + imagePath string // 图片内容;; ** 注意：** 上传的图片大小不能超过 10MB imagePathFlag bool } @@ -8713,7 +8713,7 @@ func (builder *CreateImagePathReqBodyBuilder) ImageType(imageType string) *Creat return builder } -// 图片内容;; **注意：** 上传的图片大小不能超过10MB +// 图片内容;; ** 注意：** 上传的图片大小不能超过 10MB // // 示例值：二进制文件 func (builder *CreateImagePathReqBodyBuilder) ImagePath(imagePath string) *CreateImagePathReqBodyBuilder { @@ -8751,7 +8751,7 @@ func NewCreateImageReqBuilder() *CreateImageReqBuilder { return builder } -// 上传图片接口，支持上传 JPEG、PNG、WEBP、GIF、TIFF、BMP、ICO格式图片。 +// 上传图片接口，支持上传 JPEG、PNG、WEBP、GIF、TIFF、BMP、ICO 格式图片。 func (builder *CreateImageReqBuilder) Body(body *CreateImageReqBody) *CreateImageReqBuilder { builder.body = body return builder @@ -8766,7 +8766,7 @@ func (builder *CreateImageReqBuilder) Build() *CreateImageReq { type CreateImageReqBody struct { ImageType *string `json:"image_type,omitempty"` // 图片类型 - Image io.Reader `json:"image,omitempty"` // 图片内容;; **注意：** 上传的图片大小不能超过10MB + Image io.Reader `json:"image,omitempty"` // 图片内容;; ** 注意：** 上传的图片大小不能超过 10MB } type CreateImageReq struct { @@ -8775,7 +8775,7 @@ type CreateImageReq struct { } type CreateImageRespData struct { - ImageKey *string `json:"image_key,omitempty"` // 图片的key + ImageKey *string `json:"image_key,omitempty"` // 图片的 key } type CreateImageResp struct { @@ -8801,7 +8801,7 @@ func NewGetImageReqBuilder() *GetImageReqBuilder { return builder } -// 图片的key，通过[上传图片]( https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口上传图片后获得 +// 图片的 key，通过 [上传图片]( https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create) 接口上传图片后获得 // // 示例值：img_8d5181ca-0aed-40f0-b0d1-b1452132afbg func (builder *GetImageReqBuilder) ImageKey(imageKey string) *GetImageReqBuilder { @@ -8845,13 +8845,13 @@ func (resp *GetImageResp) WriteFile(fileName string) error { } type CreateMessageReqBodyBuilder struct { - receiveId string // 消息接收者的ID，ID类型应与查询参数==receive_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取消息接收者的Open ID + receiveId string // 消息接收者的 ID，ID 类型应与查询参数==receive_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取消息接收者的 Open ID receiveIdFlag bool - msgType string // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + msgType string // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) msgTypeFlag bool - content string // 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过150KB;- 卡片及富文本消息请求体最大不能超过30KB + content string // 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，具体格式说明参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过 150KB;- 卡片及富文本消息请求体最大不能超过 30KB contentFlag bool - uuid string // 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 + uuid string // 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 uuidFlag bool } @@ -8860,7 +8860,7 @@ func NewCreateMessageReqBodyBuilder() *CreateMessageReqBodyBuilder { return builder } -// 消息接收者的ID，ID类型应与查询参数==receive_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取消息接收者的Open ID +// 消息接收者的 ID，ID 类型应与查询参数==receive_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取消息接收者的 Open ID // //示例值：ou_7d8a6e6df7621556ce0d21922b676706ccs func (builder *CreateMessageReqBodyBuilder) ReceiveId(receiveId string) *CreateMessageReqBodyBuilder { @@ -8869,7 +8869,7 @@ func (builder *CreateMessageReqBodyBuilder) ReceiveId(receiveId string) *CreateM return builder } -// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) +// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) // //示例值：text func (builder *CreateMessageReqBodyBuilder) MsgType(msgType string) *CreateMessageReqBodyBuilder { @@ -8878,7 +8878,7 @@ func (builder *CreateMessageReqBodyBuilder) MsgType(msgType string) *CreateMessa return builder } -// 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过150KB;- 卡片及富文本消息请求体最大不能超过30KB +// 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，具体格式说明参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过 150KB;- 卡片及富文本消息请求体最大不能超过 30KB // //示例值：{\"text\":\"Tom test content\"} func (builder *CreateMessageReqBodyBuilder) Content(content string) *CreateMessageReqBodyBuilder { @@ -8887,7 +8887,7 @@ func (builder *CreateMessageReqBodyBuilder) Content(content string) *CreateMessa return builder } -// 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 +// 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 // //示例值：a0d69e20-1dd1-458b-k525-dfeca4015204 func (builder *CreateMessageReqBodyBuilder) Uuid(uuid string) *CreateMessageReqBodyBuilder { @@ -8914,13 +8914,13 @@ func (builder *CreateMessageReqBodyBuilder) Build() *CreateMessageReqBody { } type CreateMessagePathReqBodyBuilder struct { - receiveId string // 消息接收者的ID，ID类型应与查询参数==receive_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取消息接收者的Open ID + receiveId string // 消息接收者的 ID，ID 类型应与查询参数==receive_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取消息接收者的 Open ID receiveIdFlag bool - msgType string // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + msgType string // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) msgTypeFlag bool - content string // 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过150KB;- 卡片及富文本消息请求体最大不能超过30KB + content string // 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，具体格式说明参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过 150KB;- 卡片及富文本消息请求体最大不能超过 30KB contentFlag bool - uuid string // 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 + uuid string // 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 uuidFlag bool } @@ -8929,7 +8929,7 @@ func NewCreateMessagePathReqBodyBuilder() *CreateMessagePathReqBodyBuilder { return builder } -// 消息接收者的ID，ID类型应与查询参数==receive_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取消息接收者的Open ID +// 消息接收者的 ID，ID 类型应与查询参数==receive_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取消息接收者的 Open ID // // 示例值：ou_7d8a6e6df7621556ce0d21922b676706ccs func (builder *CreateMessagePathReqBodyBuilder) ReceiveId(receiveId string) *CreateMessagePathReqBodyBuilder { @@ -8938,7 +8938,7 @@ func (builder *CreateMessagePathReqBodyBuilder) ReceiveId(receiveId string) *Cre return builder } -// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) +// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) // // 示例值：text func (builder *CreateMessagePathReqBodyBuilder) MsgType(msgType string) *CreateMessagePathReqBodyBuilder { @@ -8947,7 +8947,7 @@ func (builder *CreateMessagePathReqBodyBuilder) MsgType(msgType string) *CreateM return builder } -// 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过150KB;- 卡片及富文本消息请求体最大不能超过30KB +// 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，具体格式说明参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过 150KB;- 卡片及富文本消息请求体最大不能超过 30KB // // 示例值：{\"text\":\"Tom test content\"} func (builder *CreateMessagePathReqBodyBuilder) Content(content string) *CreateMessagePathReqBodyBuilder { @@ -8956,7 +8956,7 @@ func (builder *CreateMessagePathReqBodyBuilder) Content(content string) *CreateM return builder } -// 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 +// 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 // // 示例值：a0d69e20-1dd1-458b-k525-dfeca4015204 func (builder *CreateMessagePathReqBodyBuilder) Uuid(uuid string) *CreateMessagePathReqBodyBuilder { @@ -8996,7 +8996,7 @@ func NewCreateMessageReqBuilder() *CreateMessageReqBuilder { return builder } -// 消息接收者id类型 open_id/user_id/union_id/email/chat_id +// 消息接收者 id 类型 open_id/user_id/union_id/email/chat_id // // 示例值：open_id func (builder *CreateMessageReqBuilder) ReceiveIdType(receiveIdType string) *CreateMessageReqBuilder { @@ -9004,7 +9004,7 @@ func (builder *CreateMessageReqBuilder) ReceiveIdType(receiveIdType string) *Cre return builder } -// 给指定用户或者会话发送消息，支持文本、富文本、可交互的[消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)、群名片、个人名片、图片、视频、音频、文件、表情包。 +// 给指定用户或者会话发送消息，支持文本、富文本、可交互的 [消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)、群名片、个人名片、图片、视频、音频、文件、表情包。 func (builder *CreateMessageReqBuilder) Body(body *CreateMessageReqBody) *CreateMessageReqBuilder { builder.body = body return builder @@ -9019,10 +9019,10 @@ func (builder *CreateMessageReqBuilder) Build() *CreateMessageReq { } type CreateMessageReqBody struct { - ReceiveId *string `json:"receive_id,omitempty"` // 消息接收者的ID，ID类型应与查询参数==receive_id_type== 对应；当ID类型为`open_id`时，可参考[如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)来获取消息接收者的Open ID - MsgType *string `json:"msg_type,omitempty"` // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，类型定义请参考[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) - Content *string `json:"content,omitempty"` // 消息内容，json结构序列化后的字符串。不同msg_type对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等，具体格式说明参考：[发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过150KB;- 卡片及富文本消息请求体最大不能超过30KB - Uuid *string `json:"uuid,omitempty"` // 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 + ReceiveId *string `json:"receive_id,omitempty"` // 消息接收者的 ID，ID 类型应与查询参数==receive_id_type== 对应；当 ID 类型为`open_id`时，可参考 [如何获取 Open ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) 来获取消息接收者的 Open ID + MsgType *string `json:"msg_type,omitempty"` // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，类型定义请参考 [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + Content *string `json:"content,omitempty"` // 消息内容，json 结构序列化后的字符串。不同 msg_type 对应不同内容。消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user 等，具体格式说明参考：[发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json);;请求体大小限制：;- 文本消息请求体最大不能超过 150KB;- 卡片及富文本消息请求体最大不能超过 30KB + Uuid *string `json:"uuid,omitempty"` // 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 } type CreateMessageReq struct { @@ -9031,19 +9031,19 @@ type CreateMessageReq struct { } type CreateMessageRespData struct { - MessageId *string `json:"message_id,omitempty"` // 消息id open_message_id - RootId *string `json:"root_id,omitempty"` // 根消息id open_message_id - ParentId *string `json:"parent_id,omitempty"` // 父消息的id open_message_id - MsgType *string `json:"msg_type,omitempty"` // 消息类型 text post card image等等 - CreateTime *string `json:"create_time,omitempty"` // 消息生成的时间戳(毫秒) + MessageId *string `json:"message_id,omitempty"` // 消息 id open_message_id + RootId *string `json:"root_id,omitempty"` // 根消息 id open_message_id + ParentId *string `json:"parent_id,omitempty"` // 父消息的 id open_message_id + MsgType *string `json:"msg_type,omitempty"` // 消息类型 text post card image 等等 + CreateTime *string `json:"create_time,omitempty"` // 消息生成的时间戳 (毫秒) UpdateTime *string `json:"update_time,omitempty"` // 消息更新的时间戳 Deleted *bool `json:"deleted,omitempty"` // 消息是否被撤回 Updated *bool `json:"updated,omitempty"` // 消息是否被更新 ChatId *string `json:"chat_id,omitempty"` // 所属的群 Sender *Sender `json:"sender,omitempty"` // 发送者，可以是用户或应用 - Body *MessageBody `json:"body,omitempty"` // 消息内容,json结构 - Mentions []*Mention `json:"mentions,omitempty"` // 被艾特的人或应用的id - UpperMessageId *string `json:"upper_message_id,omitempty"` // 合并消息的上一层级消息id open_message_id + Body *MessageBody `json:"body,omitempty"` // 消息内容，json 结构 + Mentions []*Mention `json:"mentions,omitempty"` // 被艾特的人或应用的 id + UpperMessageId *string `json:"upper_message_id,omitempty"` // 合并消息的上一层级消息 id open_message_id } type CreateMessageResp struct { @@ -9069,7 +9069,7 @@ func NewDeleteMessageReqBuilder() *DeleteMessageReqBuilder { return builder } -// 待撤回的消息的ID +// 待撤回的消息的 ID // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *DeleteMessageReqBuilder) MessageId(messageId string) *DeleteMessageReqBuilder { @@ -9110,7 +9110,7 @@ func NewGetMessageReqBuilder() *GetMessageReqBuilder { return builder } -// 待获取消息内容的消息的ID +// 待获取消息内容的消息的 ID // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *GetMessageReqBuilder) MessageId(messageId string) *GetMessageReqBuilder { @@ -9171,7 +9171,7 @@ func (builder *ListMessageReqBuilder) ContainerIdType(containerIdType string) *L return builder } -// 容器的id，即chat的id，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 容器的 id，即 chat 的 id，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_234jsi43d3ssi993d43545f func (builder *ListMessageReqBuilder) ContainerId(containerId string) *ListMessageReqBuilder { @@ -9227,7 +9227,7 @@ type ListMessageReq struct { type ListMessageRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否还有后续翻页 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*Message `json:"items,omitempty"` // message[] } @@ -9309,7 +9309,7 @@ func NewPatchMessageReqBuilder() *PatchMessageReqBuilder { return builder } -// 待更新的消息的ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待更新的消息的 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *PatchMessageReqBuilder) MessageId(messageId string) *PatchMessageReqBuilder { @@ -9362,7 +9362,7 @@ func NewReadUsersMessageReqBuilder() *ReadUsersMessageReqBuilder { return builder } -// 待查询的消息的ID，说明参见：[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;**注意**：不支持查询批量消息 +// 待查询的消息的 ID，说明参见：[消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;** 注意 **：不支持查询批量消息 // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *ReadUsersMessageReqBuilder) MessageId(messageId string) *ReadUsersMessageReqBuilder { @@ -9370,7 +9370,7 @@ func (builder *ReadUsersMessageReqBuilder) MessageId(messageId string) *ReadUser return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ReadUsersMessageReqBuilder) UserIdType(userIdType string) *ReadUsersMessageReqBuilder { @@ -9386,7 +9386,7 @@ func (builder *ReadUsersMessageReqBuilder) PageSize(pageSize int) *ReadUsersMess return builder } -// 下一页分页的token +// 下一页分页的 token // // 示例值：GxmvlNRvP0NdQZpa7yIqf_Lv_QuBwTQ8tXkX7w-irAghVD_TvuYd1aoJ1LQph86O-XImC4X9j9FhUPhXQDvtrQ== func (builder *ReadUsersMessageReqBuilder) PageToken(pageToken string) *ReadUsersMessageReqBuilder { @@ -9409,7 +9409,7 @@ type ReadUsersMessageReq struct { type ReadUsersMessageRespData struct { Items []*ReadUser `json:"items,omitempty"` // - HasMore *bool `json:"has_more,omitempty"` // 是否还有下一页 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token } type ReadUsersMessageResp struct { @@ -9423,11 +9423,11 @@ func (resp *ReadUsersMessageResp) Success() bool { } type ReplyMessageReqBodyBuilder struct { - content string // 消息内容 json 格式，格式说明参考: [发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + content string // 消息内容 json 格式，格式说明参考: [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) contentFlag bool msgType string // 消息类型，包括：text、post、image、file、audio、media、sticker、interactive、share_card、share_user msgTypeFlag bool - uuid string // 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 + uuid string // 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 uuidFlag bool } @@ -9436,7 +9436,7 @@ func NewReplyMessageReqBodyBuilder() *ReplyMessageReqBodyBuilder { return builder } -// 消息内容 json 格式，格式说明参考: [发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) +// 消息内容 json 格式，格式说明参考: [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) // //示例值：{\"text\":\"Tom test content\"} func (builder *ReplyMessageReqBodyBuilder) Content(content string) *ReplyMessageReqBodyBuilder { @@ -9454,7 +9454,7 @@ func (builder *ReplyMessageReqBodyBuilder) MsgType(msgType string) *ReplyMessage return builder } -// 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 +// 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 // //示例值：a0d69e20-1dd1-458b-k525-dfeca4015204 func (builder *ReplyMessageReqBodyBuilder) Uuid(uuid string) *ReplyMessageReqBodyBuilder { @@ -9478,11 +9478,11 @@ func (builder *ReplyMessageReqBodyBuilder) Build() *ReplyMessageReqBody { } type ReplyMessagePathReqBodyBuilder struct { - content string // 消息内容 json 格式，格式说明参考: [发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + content string // 消息内容 json 格式，格式说明参考: [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) contentFlag bool msgType string // 消息类型，包括：text、post、image、file、audio、media、sticker、interactive、share_card、share_user msgTypeFlag bool - uuid string // 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 + uuid string // 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 uuidFlag bool } @@ -9491,7 +9491,7 @@ func NewReplyMessagePathReqBodyBuilder() *ReplyMessagePathReqBodyBuilder { return builder } -// 消息内容 json 格式，格式说明参考: [发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) +// 消息内容 json 格式，格式说明参考: [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) // // 示例值：{\"text\":\"Tom test content\"} func (builder *ReplyMessagePathReqBodyBuilder) Content(content string) *ReplyMessagePathReqBodyBuilder { @@ -9509,7 +9509,7 @@ func (builder *ReplyMessagePathReqBodyBuilder) MsgType(msgType string) *ReplyMes return builder } -// 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 +// 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 // // 示例值：a0d69e20-1dd1-458b-k525-dfeca4015204 func (builder *ReplyMessagePathReqBodyBuilder) Uuid(uuid string) *ReplyMessagePathReqBodyBuilder { @@ -9546,7 +9546,7 @@ func NewReplyMessageReqBuilder() *ReplyMessageReqBuilder { return builder } -// 待回复的消息的ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待回复的消息的 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *ReplyMessageReqBuilder) MessageId(messageId string) *ReplyMessageReqBuilder { @@ -9569,9 +9569,9 @@ func (builder *ReplyMessageReqBuilder) Build() *ReplyMessageReq { } type ReplyMessageReqBody struct { - Content *string `json:"content,omitempty"` // 消息内容 json 格式，格式说明参考: [发送消息Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) + Content *string `json:"content,omitempty"` // 消息内容 json 格式，格式说明参考: [发送消息 Content](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json) MsgType *string `json:"msg_type,omitempty"` // 消息类型，包括：text、post、image、file、audio、media、sticker、interactive、share_card、share_user - Uuid *string `json:"uuid,omitempty"` // 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同uuid的请求1小时内至多成功执行一次 + Uuid *string `json:"uuid,omitempty"` // 由开发者生成的唯一字符串序列，用于回复消息请求去重；持有相同 uuid 的请求 1 小时内至多成功执行一次 } type ReplyMessageReq struct { @@ -9580,19 +9580,19 @@ type ReplyMessageReq struct { } type ReplyMessageRespData struct { - MessageId *string `json:"message_id,omitempty"` // 消息id open_message_id - RootId *string `json:"root_id,omitempty"` // 根消息id open_message_id - ParentId *string `json:"parent_id,omitempty"` // 父消息的id open_message_id - MsgType *string `json:"msg_type,omitempty"` // 消息类型 text post card image等等 - CreateTime *string `json:"create_time,omitempty"` // 消息生成的时间戳(毫秒) + MessageId *string `json:"message_id,omitempty"` // 消息 id open_message_id + RootId *string `json:"root_id,omitempty"` // 根消息 id open_message_id + ParentId *string `json:"parent_id,omitempty"` // 父消息的 id open_message_id + MsgType *string `json:"msg_type,omitempty"` // 消息类型 text post card image 等等 + CreateTime *string `json:"create_time,omitempty"` // 消息生成的时间戳 (毫秒) UpdateTime *string `json:"update_time,omitempty"` // 消息更新的时间戳 Deleted *bool `json:"deleted,omitempty"` // 消息是否被撤回 Updated *bool `json:"updated,omitempty"` // 消息是否被更新 ChatId *string `json:"chat_id,omitempty"` // 所属的群 Sender *Sender `json:"sender,omitempty"` // 发送者，可以是用户或应用 - Body *MessageBody `json:"body,omitempty"` // 消息内容,json结构 - Mentions []*Mention `json:"mentions,omitempty"` // 被艾特的人或应用的id - UpperMessageId *string `json:"upper_message_id,omitempty"` // 合并消息的上一层级消息id open_message_id + Body *MessageBody `json:"body,omitempty"` // 消息内容，json 结构 + Mentions []*Mention `json:"mentions,omitempty"` // 被艾特的人或应用的 id + UpperMessageId *string `json:"upper_message_id,omitempty"` // 合并消息的上一层级消息 id open_message_id } type ReplyMessageResp struct { @@ -9619,7 +9619,7 @@ func NewUrgentAppMessageReqBuilder() *UrgentAppMessageReqBuilder { return builder } -// 待加急的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;**注意**：不支持批量消息ID（bm_xxx） +// 待加急的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;** 注意 **：不支持批量消息 ID（bm_xxx） // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *UrgentAppMessageReqBuilder) MessageId(messageId string) *UrgentAppMessageReqBuilder { @@ -9627,7 +9627,7 @@ func (builder *UrgentAppMessageReqBuilder) MessageId(messageId string) *UrgentAp return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UrgentAppMessageReqBuilder) UserIdType(userIdType string) *UrgentAppMessageReqBuilder { @@ -9656,7 +9656,7 @@ type UrgentAppMessageReq struct { } type UrgentAppMessageRespData struct { - InvalidUserIdList []string `json:"invalid_user_id_list,omitempty"` // 无效的用户ID + InvalidUserIdList []string `json:"invalid_user_id_list,omitempty"` // 无效的用户 ID } type UrgentAppMessageResp struct { @@ -9683,7 +9683,7 @@ func NewUrgentPhoneMessageReqBuilder() *UrgentPhoneMessageReqBuilder { return builder } -// 待加急的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;**注意**：不支持批量消息ID（bm_xxx） +// 待加急的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;** 注意 **：不支持批量消息 ID（bm_xxx） // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *UrgentPhoneMessageReqBuilder) MessageId(messageId string) *UrgentPhoneMessageReqBuilder { @@ -9691,7 +9691,7 @@ func (builder *UrgentPhoneMessageReqBuilder) MessageId(messageId string) *Urgent return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UrgentPhoneMessageReqBuilder) UserIdType(userIdType string) *UrgentPhoneMessageReqBuilder { @@ -9720,7 +9720,7 @@ type UrgentPhoneMessageReq struct { } type UrgentPhoneMessageRespData struct { - InvalidUserIdList []string `json:"invalid_user_id_list,omitempty"` // 无效的用户ID + InvalidUserIdList []string `json:"invalid_user_id_list,omitempty"` // 无效的用户 ID } type UrgentPhoneMessageResp struct { @@ -9747,7 +9747,7 @@ func NewUrgentSmsMessageReqBuilder() *UrgentSmsMessageReqBuilder { return builder } -// 待加急的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;**注意**：不支持批量消息ID（bm_xxx） +// 待加急的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2);;** 注意 **：不支持批量消息 ID（bm_xxx） // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *UrgentSmsMessageReqBuilder) MessageId(messageId string) *UrgentSmsMessageReqBuilder { @@ -9755,7 +9755,7 @@ func (builder *UrgentSmsMessageReqBuilder) MessageId(messageId string) *UrgentSm return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UrgentSmsMessageReqBuilder) UserIdType(userIdType string) *UrgentSmsMessageReqBuilder { @@ -9784,7 +9784,7 @@ type UrgentSmsMessageReq struct { } type UrgentSmsMessageRespData struct { - InvalidUserIdList []string `json:"invalid_user_id_list,omitempty"` // 无效的用户ID + InvalidUserIdList []string `json:"invalid_user_id_list,omitempty"` // 无效的用户 ID } type UrgentSmsMessageResp struct { @@ -9798,7 +9798,7 @@ func (resp *UrgentSmsMessageResp) Success() bool { } type CreateMessageReactionReqBodyBuilder struct { - reactionType *Emoji // reaction资源类型 + reactionType *Emoji // reaction 资源类型 reactionTypeFlag bool } @@ -9807,7 +9807,7 @@ func NewCreateMessageReactionReqBodyBuilder() *CreateMessageReactionReqBodyBuild return builder } -// reaction资源类型 +// reaction 资源类型 // //示例值： func (builder *CreateMessageReactionReqBodyBuilder) ReactionType(reactionType *Emoji) *CreateMessageReactionReqBodyBuilder { @@ -9825,7 +9825,7 @@ func (builder *CreateMessageReactionReqBodyBuilder) Build() *CreateMessageReacti } type CreateMessageReactionPathReqBodyBuilder struct { - reactionType *Emoji // reaction资源类型 + reactionType *Emoji // reaction 资源类型 reactionTypeFlag bool } @@ -9834,7 +9834,7 @@ func NewCreateMessageReactionPathReqBodyBuilder() *CreateMessageReactionPathReqB return builder } -// reaction资源类型 +// reaction 资源类型 // // 示例值： func (builder *CreateMessageReactionPathReqBodyBuilder) ReactionType(reactionType *Emoji) *CreateMessageReactionPathReqBodyBuilder { @@ -9865,7 +9865,7 @@ func NewCreateMessageReactionReqBuilder() *CreateMessageReactionReqBuilder { return builder } -// 待添加reaction的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待添加 reaction 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_a8f2294b************a1a38afaac9d func (builder *CreateMessageReactionReqBuilder) MessageId(messageId string) *CreateMessageReactionReqBuilder { @@ -9873,7 +9873,7 @@ func (builder *CreateMessageReactionReqBuilder) MessageId(messageId string) *Cre return builder } -// 给指定消息添加指定类型的表情回复（reaction即表情回复，本文档统一用“reaction”代称）。 +// 给指定消息添加指定类型的表情回复（reaction 即表情回复，本文档统一用 “reaction” 代称）。 func (builder *CreateMessageReactionReqBuilder) Body(body *CreateMessageReactionReqBody) *CreateMessageReactionReqBuilder { builder.body = body return builder @@ -9888,7 +9888,7 @@ func (builder *CreateMessageReactionReqBuilder) Build() *CreateMessageReactionRe } type CreateMessageReactionReqBody struct { - ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction资源类型 + ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction 资源类型 } type CreateMessageReactionReq struct { @@ -9897,10 +9897,10 @@ type CreateMessageReactionReq struct { } type CreateMessageReactionRespData struct { - ReactionId *string `json:"reaction_id,omitempty"` // reaction资源ID - Operator *Operator `json:"operator,omitempty"` // 添加reaction的操作人 - ActionTime *string `json:"action_time,omitempty"` // reaction动作的的unix timestamp(单位:ms) - ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction资源类型 + ReactionId *string `json:"reaction_id,omitempty"` // reaction 资源 ID + Operator *Operator `json:"operator,omitempty"` // 添加 reaction 的操作人 + ActionTime *string `json:"action_time,omitempty"` // reaction 动作的的 unix timestamp(单位:ms) + ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction 资源类型 } type CreateMessageReactionResp struct { @@ -9926,7 +9926,7 @@ func NewDeleteMessageReactionReqBuilder() *DeleteMessageReactionReqBuilder { return builder } -// 待删除reaction的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待删除 reaction 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_8964d1b4*********2b31383276113 func (builder *DeleteMessageReactionReqBuilder) MessageId(messageId string) *DeleteMessageReactionReqBuilder { @@ -9934,7 +9934,7 @@ func (builder *DeleteMessageReactionReqBuilder) MessageId(messageId string) *Del return builder } -// 待删除reaction的资源id，可通过调用[添加消息表情回复](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/create)接口或[获取消息表情回复](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/list)获得 +// 待删除 reaction 的资源 id，可通过调用 [添加消息表情回复](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/create) 接口或 [获取消息表情回复](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/list) 获得 // // 示例值：ZCaCIjUBVVWSrm5L-3ZTw*************sNa8dHVplEzzSfJVUVLMLcS_ func (builder *DeleteMessageReactionReqBuilder) ReactionId(reactionId string) *DeleteMessageReactionReqBuilder { @@ -9954,10 +9954,10 @@ type DeleteMessageReactionReq struct { } type DeleteMessageReactionRespData struct { - ReactionId *string `json:"reaction_id,omitempty"` // reaction资源ID - Operator *Operator `json:"operator,omitempty"` // 添加reaction的操作人 - ActionTime *string `json:"action_time,omitempty"` // reaction动作的的unix timestamp(单位:ms) - ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction资源类型 + ReactionId *string `json:"reaction_id,omitempty"` // reaction 资源 ID + Operator *Operator `json:"operator,omitempty"` // 添加 reaction 的操作人 + ActionTime *string `json:"action_time,omitempty"` // reaction 动作的的 unix timestamp(单位:ms) + ReactionType *Emoji `json:"reaction_type,omitempty"` // reaction 资源类型 } type DeleteMessageReactionResp struct { @@ -9990,7 +9990,7 @@ func (builder *ListMessageReactionReqBuilder) Limit(limit int) *ListMessageReact return builder } -// 待获取reaction的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待获取 reaction 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_8964d1b4*********2b31383276113 func (builder *ListMessageReactionReqBuilder) MessageId(messageId string) *ListMessageReactionReqBuilder { @@ -9998,7 +9998,7 @@ func (builder *ListMessageReactionReqBuilder) MessageId(messageId string) *ListM return builder } -// 待查询消息reaction的类型[emoji类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce);;**注意**：不传入该参数，表示拉取所有类型reaction +// 待查询消息 reaction 的类型 [emoji 类型列举](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce);;** 注意 **：不传入该参数，表示拉取所有类型 reaction // // 示例值：LAUGH func (builder *ListMessageReactionReqBuilder) ReactionType(reactionType string) *ListMessageReactionReqBuilder { @@ -10022,7 +10022,7 @@ func (builder *ListMessageReactionReqBuilder) PageSize(pageSize int) *ListMessag return builder } -// 当操作人为用户时返回用户ID的类型 +// 当操作人为用户时返回用户 ID 的类型 // // 示例值： func (builder *ListMessageReactionReqBuilder) UserIdType(userIdType string) *ListMessageReactionReqBuilder { @@ -10046,9 +10046,9 @@ type ListMessageReactionReq struct { } type ListMessageReactionRespData struct { - Items []*MessageReaction `json:"items,omitempty"` // 查询指定reaction_type返回的reaction列表 + Items []*MessageReaction `json:"items,omitempty"` // 查询指定 reaction_type 返回的 reaction 列表 HasMore *bool `json:"has_more,omitempty"` // 是否还有后续翻页 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token } type ListMessageReactionResp struct { @@ -10074,7 +10074,7 @@ func NewGetMessageResourceReqBuilder() *GetMessageResourceReqBuilder { return builder } -// 待查询资源对应的消息ID +// 待查询资源对应的消息 ID // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *GetMessageResourceReqBuilder) MessageId(messageId string) *GetMessageResourceReqBuilder { @@ -10082,7 +10082,7 @@ func (builder *GetMessageResourceReqBuilder) MessageId(messageId string) *GetMes return builder } -// 待查询资源的key;;**注意**：请求的 file_key 和 message_id 需要匹配 +// 待查询资源的 key;;** 注意 **：请求的 file_key 和 message_id 需要匹配 // // 示例值：file_456a92d6-c6ea-4de4-ac3f-7afcf44ac78g func (builder *GetMessageResourceReqBuilder) FileKey(fileKey string) *GetMessageResourceReqBuilder { @@ -10090,7 +10090,7 @@ func (builder *GetMessageResourceReqBuilder) FileKey(fileKey string) *GetMessage return builder } -// 资源类型，可选"image, file“； image对应消息中的 图片，富文本消息中的图片。 file对应消息中的 文件、音频、视频、（表情包除外） +// 资源类型，可选"image, file“； image 对应消息中的 图片，富文本消息中的图片。 file 对应消息中的 文件、音频、视频、（表情包除外） // // 示例值：image func (builder *GetMessageResourceReqBuilder) Type(type_ string) *GetMessageResourceReqBuilder { @@ -10135,7 +10135,7 @@ func (resp *GetMessageResourceResp) WriteFile(fileName string) error { } type CreatePinReqBodyBuilder struct { - messageId string // 待Pin的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + messageId string // 待 Pin 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) messageIdFlag bool } @@ -10144,7 +10144,7 @@ func NewCreatePinReqBodyBuilder() *CreatePinReqBodyBuilder { return builder } -// 待Pin的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待 Pin 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // //示例值：om_dc13264520392913993dd051dba21dcf func (builder *CreatePinReqBodyBuilder) MessageId(messageId string) *CreatePinReqBodyBuilder { @@ -10162,7 +10162,7 @@ func (builder *CreatePinReqBodyBuilder) Build() *CreatePinReqBody { } type CreatePinPathReqBodyBuilder struct { - messageId string // 待Pin的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + messageId string // 待 Pin 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) messageIdFlag bool } @@ -10171,7 +10171,7 @@ func NewCreatePinPathReqBodyBuilder() *CreatePinPathReqBodyBuilder { return builder } -// 待Pin的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待 Pin 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *CreatePinPathReqBodyBuilder) MessageId(messageId string) *CreatePinPathReqBodyBuilder { @@ -10202,7 +10202,7 @@ func NewCreatePinReqBuilder() *CreatePinReqBuilder { return builder } -// Pin一条指定的消息。 +// Pin 一条指定的消息。 func (builder *CreatePinReqBuilder) Body(body *CreatePinReqBody) *CreatePinReqBuilder { builder.body = body return builder @@ -10216,7 +10216,7 @@ func (builder *CreatePinReqBuilder) Build() *CreatePinReq { } type CreatePinReqBody struct { - MessageId *string `json:"message_id,omitempty"` // 待Pin的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) + MessageId *string `json:"message_id,omitempty"` // 待 Pin 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) } type CreatePinReq struct { @@ -10225,7 +10225,7 @@ type CreatePinReq struct { } type CreatePinRespData struct { - Pin *Pin `json:"pin,omitempty"` // Pin的操作信息 + Pin *Pin `json:"pin,omitempty"` // Pin 的操作信息 } type CreatePinResp struct { @@ -10251,7 +10251,7 @@ func NewDeletePinReqBuilder() *DeletePinReqBuilder { return builder } -// 待移除Pin的消息ID，详情参见[消息ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) +// 待移除 Pin 的消息 ID，详情参见 [消息 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2) // // 示例值：om_dc13264520392913993dd051dba21dcf func (builder *DeletePinReqBuilder) MessageId(messageId string) *DeletePinReqBuilder { @@ -10299,7 +10299,7 @@ func (builder *ListPinReqBuilder) Limit(limit int) *ListPinReqBuilder { return builder } -// 待获取Pin消息的Chat ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) +// 待获取 Pin 消息的 Chat ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) // // 示例值：oc_234jsi43d3ssi993d43545f func (builder *ListPinReqBuilder) ChatId(chatId string) *ListPinReqBuilder { @@ -10307,7 +10307,7 @@ func (builder *ListPinReqBuilder) ChatId(chatId string) *ListPinReqBuilder { return builder } -// Pin信息的起始时间（毫秒级时间戳）。若未填写默认获取到群聊内最早的Pin信息 +// Pin 信息的起始时间（毫秒级时间戳）。若未填写默认获取到群聊内最早的 Pin 信息 // // 示例值：1658632251800 func (builder *ListPinReqBuilder) StartTime(startTime string) *ListPinReqBuilder { @@ -10315,7 +10315,7 @@ func (builder *ListPinReqBuilder) StartTime(startTime string) *ListPinReqBuilder return builder } -// Pin信息的结束时间（毫秒级时间戳）。若未填写默认从群聊内最新的Pin信息开始获取;;**注意**：`end_time`值应大于`start_time`值 +// Pin 信息的结束时间（毫秒级时间戳）。若未填写默认从群聊内最新的 Pin 信息开始获取;;** 注意 **：`end_time`值应大于`start_time`值 // // 示例值：1658731646425 func (builder *ListPinReqBuilder) EndTime(endTime string) *ListPinReqBuilder { @@ -10331,7 +10331,7 @@ func (builder *ListPinReqBuilder) PageSize(pageSize int) *ListPinReqBuilder { return builder } -// 下一页分页的token +// 下一页分页的 token // // 示例值：GxmvlNRvP0NdQZpa7yIqf_Lv_QuBwTQ8tXkX7w-irAghVD_TvuYd1aoJ1LQph86O-XImC4X9j9FhUPhXQDvtrQ== func (builder *ListPinReqBuilder) PageToken(pageToken string) *ListPinReqBuilder { @@ -10354,7 +10354,7 @@ type ListPinReq struct { } type ListPinRespData struct { - Items []*Pin `json:"items,omitempty"` // Pin的操作信息 + Items []*Pin `json:"items,omitempty"` // Pin 的操作信息 HasMore *bool `json:"has_more,omitempty"` // 是否还有更多项 PageToken *string `json:"page_token,omitempty"` // 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token } @@ -10370,10 +10370,10 @@ func (resp *ListPinResp) Success() bool { } type P2ChatDisbandedV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) - OperatorId *UserId `json:"operator_id,omitempty"` // 操作者的ID + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + OperatorId *UserId `json:"operator_id,omitempty"` // 操作者的 ID External *bool `json:"external,omitempty"` // 被解散的群是否是外部群 - OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户 Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 Name *string `json:"name,omitempty"` // 群名称 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 } @@ -10389,7 +10389,7 @@ func (m *P2ChatDisbandedV1) RawReq(req *larkevent.EventReq) { } type P2ChatUpdatedV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID External *bool `json:"external,omitempty"` // 是否是外部群 OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者租户 Key @@ -10409,10 +10409,10 @@ func (m *P2ChatUpdatedV1) RawReq(req *larkevent.EventReq) { } type P2ChatMemberBotAddedV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID External *bool `json:"external,omitempty"` // 是否是外部群 - OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 Name *string `json:"name,omitempty"` // 群名称 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 } @@ -10428,7 +10428,7 @@ func (m *P2ChatMemberBotAddedV1) RawReq(req *larkevent.EventReq) { } type P2ChatMemberBotDeletedV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID External *bool `json:"external,omitempty"` // 是否是外部群 OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者租户 Key @@ -10447,7 +10447,7 @@ func (m *P2ChatMemberBotDeletedV1) RawReq(req *larkevent.EventReq) { } type P2ChatMemberUserAddedV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID External *bool `json:"external,omitempty"` // 是否是外部群 OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者租户 Key @@ -10467,10 +10467,10 @@ func (m *P2ChatMemberUserAddedV1) RawReq(req *larkevent.EventReq) { } type P2ChatMemberUserDeletedV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID External *bool `json:"external,omitempty"` // 是否是外部群 - OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 Users []*ChatMemberUser `json:"users,omitempty"` // 被移除用户列表 Name *string `json:"name,omitempty"` // 群名称 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 @@ -10487,10 +10487,10 @@ func (m *P2ChatMemberUserDeletedV1) RawReq(req *larkevent.EventReq) { } type P2ChatMemberUserWithdrawnV1Data struct { - ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见[群ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) + ChatId *string `json:"chat_id,omitempty"` // 群组 ID，详情参见 [群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) OperatorId *UserId `json:"operator_id,omitempty"` // 用户 ID External *bool `json:"external,omitempty"` // 是否是外部群 - OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识 + OperatorTenantKey *string `json:"operator_tenant_key,omitempty"` // 操作者的租户 Key，为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用中的唯一标识 Users []*ChatMemberUser `json:"users,omitempty"` // 被撤销加群的用户列表 Name *string `json:"name,omitempty"` // 群名称 I18nNames *I18nNames `json:"i18n_names,omitempty"` // 群国际化名称 @@ -10522,8 +10522,8 @@ func (m *P2MessageReadV1) RawReq(req *larkevent.EventReq) { } type P2MessageRecalledV1Data struct { - MessageId *string `json:"message_id,omitempty"` // 消息ID - ChatId *string `json:"chat_id,omitempty"` // 群ID + MessageId *string `json:"message_id,omitempty"` // 消息 ID + ChatId *string `json:"chat_id,omitempty"` // 群 ID RecallTime *string `json:"recall_time,omitempty"` // 撤回事件 RecallType *string `json:"recall_type,omitempty"` // 撤回类型 } @@ -10609,7 +10609,7 @@ func (iterator *ListChatIterator) Next() (bool, *ListChat, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10663,7 +10663,7 @@ func (iterator *SearchChatIterator) Next() (bool, *ListChat, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10717,7 +10717,7 @@ func (iterator *GetChatMembersIterator) Next() (bool, *ListMember, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10771,7 +10771,7 @@ func (iterator *GetChatModerationIterator) Next() (bool, *ListModerator, error) return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10825,7 +10825,7 @@ func (iterator *ListMessageIterator) Next() (bool, *Message, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10879,7 +10879,7 @@ func (iterator *ListMessageReactionIterator) Next() (bool, *MessageReaction, err return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -10933,7 +10933,7 @@ func (iterator *ListPinIterator) Next() (bool, *Pin, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/mail/v1/api.go b/service/mail/v1/api.go index bea47bda..39402c6e 100644 --- a/service/mail/v1/api.go +++ b/service/mail/v1/api.go @@ -84,9 +84,9 @@ type userMailboxAlias struct { // // - 创建一个邮件组 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroup.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroup.go func (m *mailgroup) Create(ctx context.Context, req *CreateMailgroupReq, options ...larkcore.RequestOptionFunc) (*CreateMailgroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -110,9 +110,9 @@ func (m *mailgroup) Create(ctx context.Context, req *CreateMailgroupReq, options // // - 删除一个邮件组 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroup.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroup.go func (m *mailgroup) Delete(ctx context.Context, req *DeleteMailgroupReq, options ...larkcore.RequestOptionFunc) (*DeleteMailgroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -136,9 +136,9 @@ func (m *mailgroup) Delete(ctx context.Context, req *DeleteMailgroupReq, options // // - 获取特定邮件组信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_mailgroup.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_mailgroup.go func (m *mailgroup) Get(ctx context.Context, req *GetMailgroupReq, options ...larkcore.RequestOptionFunc) (*GetMailgroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -162,9 +162,9 @@ func (m *mailgroup) Get(ctx context.Context, req *GetMailgroupReq, options ...la // // - 分页批量获取邮件组 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroup.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroup.go func (m *mailgroup) List(ctx context.Context, req *ListMailgroupReq, options ...larkcore.RequestOptionFunc) (*ListMailgroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -196,9 +196,9 @@ func (m *mailgroup) ListByIterator(ctx context.Context, req *ListMailgroupReq, o // // - 更新邮件组部分字段，没有填写的字段不会被更新 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/patch_mailgroup.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/patch_mailgroup.go func (m *mailgroup) Patch(ctx context.Context, req *PatchMailgroupReq, options ...larkcore.RequestOptionFunc) (*PatchMailgroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -222,9 +222,9 @@ func (m *mailgroup) Patch(ctx context.Context, req *PatchMailgroupReq, options . // // - 更新邮件组所有信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/update_mailgroup.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/update_mailgroup.go func (m *mailgroup) Update(ctx context.Context, req *UpdateMailgroupReq, options ...larkcore.RequestOptionFunc) (*UpdateMailgroupResp, error) { // 发起请求 apiReq := req.apiReq @@ -248,9 +248,9 @@ func (m *mailgroup) Update(ctx context.Context, req *UpdateMailgroupReq, options // // - 创建邮件组别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-alias/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-alias/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroupAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroupAlias.go func (m *mailgroupAlias) Create(ctx context.Context, req *CreateMailgroupAliasReq, options ...larkcore.RequestOptionFunc) (*CreateMailgroupAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -274,9 +274,9 @@ func (m *mailgroupAlias) Create(ctx context.Context, req *CreateMailgroupAliasRe // // - 删除邮件组别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-alias/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-alias/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroupAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroupAlias.go func (m *mailgroupAlias) Delete(ctx context.Context, req *DeleteMailgroupAliasReq, options ...larkcore.RequestOptionFunc) (*DeleteMailgroupAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -300,9 +300,9 @@ func (m *mailgroupAlias) Delete(ctx context.Context, req *DeleteMailgroupAliasRe // // - 获取邮件组所有别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-alias/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-alias/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroupAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroupAlias.go func (m *mailgroupAlias) List(ctx context.Context, req *ListMailgroupAliasReq, options ...larkcore.RequestOptionFunc) (*ListMailgroupAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -326,9 +326,9 @@ func (m *mailgroupAlias) List(ctx context.Context, req *ListMailgroupAliasReq, o // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=mail&resource=mailgroup.member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=mail&resource=mailgroup.member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchCreate_mailgroupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchCreate_mailgroupMember.go func (m *mailgroupMember) BatchCreate(ctx context.Context, req *BatchCreateMailgroupMemberReq, options ...larkcore.RequestOptionFunc) (*BatchCreateMailgroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -352,9 +352,9 @@ func (m *mailgroupMember) BatchCreate(ctx context.Context, req *BatchCreateMailg // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=mail&resource=mailgroup.member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=mail&resource=mailgroup.member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchDelete_mailgroupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchDelete_mailgroupMember.go func (m *mailgroupMember) BatchDelete(ctx context.Context, req *BatchDeleteMailgroupMemberReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteMailgroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -378,9 +378,9 @@ func (m *mailgroupMember) BatchDelete(ctx context.Context, req *BatchDeleteMailg // // - 向邮件组添加单个成员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroupMember.go func (m *mailgroupMember) Create(ctx context.Context, req *CreateMailgroupMemberReq, options ...larkcore.RequestOptionFunc) (*CreateMailgroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -404,9 +404,9 @@ func (m *mailgroupMember) Create(ctx context.Context, req *CreateMailgroupMember // // - 删除邮件组单个成员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroupMember.go func (m *mailgroupMember) Delete(ctx context.Context, req *DeleteMailgroupMemberReq, options ...larkcore.RequestOptionFunc) (*DeleteMailgroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -430,9 +430,9 @@ func (m *mailgroupMember) Delete(ctx context.Context, req *DeleteMailgroupMember // // - 获取邮件组单个成员信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_mailgroupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_mailgroupMember.go func (m *mailgroupMember) Get(ctx context.Context, req *GetMailgroupMemberReq, options ...larkcore.RequestOptionFunc) (*GetMailgroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -456,9 +456,9 @@ func (m *mailgroupMember) Get(ctx context.Context, req *GetMailgroupMemberReq, o // // - 分页批量获取邮件组成员列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-member/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroupMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroupMember.go func (m *mailgroupMember) List(ctx context.Context, req *ListMailgroupMemberReq, options ...larkcore.RequestOptionFunc) (*ListMailgroupMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -490,9 +490,9 @@ func (m *mailgroupMember) ListByIterator(ctx context.Context, req *ListMailgroup // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=mail&resource=mailgroup.permission_member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=mail&resource=mailgroup.permission_member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchCreate_mailgroupPermissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchCreate_mailgroupPermissionMember.go func (m *mailgroupPermissionMember) BatchCreate(ctx context.Context, req *BatchCreateMailgroupPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*BatchCreateMailgroupPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -516,9 +516,9 @@ func (m *mailgroupPermissionMember) BatchCreate(ctx context.Context, req *BatchC // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=mail&resource=mailgroup.permission_member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=mail&resource=mailgroup.permission_member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchDelete_mailgroupPermissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchDelete_mailgroupPermissionMember.go func (m *mailgroupPermissionMember) BatchDelete(ctx context.Context, req *BatchDeleteMailgroupPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteMailgroupPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -542,9 +542,9 @@ func (m *mailgroupPermissionMember) BatchDelete(ctx context.Context, req *BatchD // // - 向邮件组添加单个自定义权限成员，添加后该成员可发送邮件到该邮件组 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroupPermissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_mailgroupPermissionMember.go func (m *mailgroupPermissionMember) Create(ctx context.Context, req *CreateMailgroupPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*CreateMailgroupPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -568,9 +568,9 @@ func (m *mailgroupPermissionMember) Create(ctx context.Context, req *CreateMailg // // - 从自定义成员中删除单个成员，删除后该成员无法发送邮件到该邮件组 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroupPermissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_mailgroupPermissionMember.go func (m *mailgroupPermissionMember) Delete(ctx context.Context, req *DeleteMailgroupPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*DeleteMailgroupPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -594,9 +594,9 @@ func (m *mailgroupPermissionMember) Delete(ctx context.Context, req *DeleteMailg // // - 获取邮件组单个权限成员信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_mailgroupPermissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_mailgroupPermissionMember.go func (m *mailgroupPermissionMember) Get(ctx context.Context, req *GetMailgroupPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*GetMailgroupPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -620,9 +620,9 @@ func (m *mailgroupPermissionMember) Get(ctx context.Context, req *GetMailgroupPe // // - 分页批量获取邮件组权限成员列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/mailgroup-permission_member/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroupPermissionMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_mailgroupPermissionMember.go func (m *mailgroupPermissionMember) List(ctx context.Context, req *ListMailgroupPermissionMemberReq, options ...larkcore.RequestOptionFunc) (*ListMailgroupPermissionMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -654,9 +654,9 @@ func (m *mailgroupPermissionMember) ListByIterator(ctx context.Context, req *Lis // // - 创建一个公共邮箱 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_publicMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_publicMailbox.go func (p *publicMailbox) Create(ctx context.Context, req *CreatePublicMailboxReq, options ...larkcore.RequestOptionFunc) (*CreatePublicMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -680,9 +680,9 @@ func (p *publicMailbox) Create(ctx context.Context, req *CreatePublicMailboxReq, // // - 该接口会永久删除公共邮箱地址。可用于释放邮箱回收站的公共邮箱地址，一旦删除，该邮箱地址将无法恢复。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_publicMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_publicMailbox.go func (p *publicMailbox) Delete(ctx context.Context, req *DeletePublicMailboxReq, options ...larkcore.RequestOptionFunc) (*DeletePublicMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -706,9 +706,9 @@ func (p *publicMailbox) Delete(ctx context.Context, req *DeletePublicMailboxReq, // // - 获取公共邮箱信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_publicMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_publicMailbox.go func (p *publicMailbox) Get(ctx context.Context, req *GetPublicMailboxReq, options ...larkcore.RequestOptionFunc) (*GetPublicMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -732,9 +732,9 @@ func (p *publicMailbox) Get(ctx context.Context, req *GetPublicMailboxReq, optio // // - 分页批量获取公共邮箱列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_publicMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_publicMailbox.go func (p *publicMailbox) List(ctx context.Context, req *ListPublicMailboxReq, options ...larkcore.RequestOptionFunc) (*ListPublicMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -766,9 +766,9 @@ func (p *publicMailbox) ListByIterator(ctx context.Context, req *ListPublicMailb // // - 更新公共邮箱部分字段，没有填写的字段不会被更新 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/patch_publicMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/patch_publicMailbox.go func (p *publicMailbox) Patch(ctx context.Context, req *PatchPublicMailboxReq, options ...larkcore.RequestOptionFunc) (*PatchPublicMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -792,9 +792,9 @@ func (p *publicMailbox) Patch(ctx context.Context, req *PatchPublicMailboxReq, o // // - 更新公共邮箱所有信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/update_publicMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/update_publicMailbox.go func (p *publicMailbox) Update(ctx context.Context, req *UpdatePublicMailboxReq, options ...larkcore.RequestOptionFunc) (*UpdatePublicMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -818,9 +818,9 @@ func (p *publicMailbox) Update(ctx context.Context, req *UpdatePublicMailboxReq, // // - 创建公共邮箱别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-alias/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-alias/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_publicMailboxAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_publicMailboxAlias.go func (p *publicMailboxAlias) Create(ctx context.Context, req *CreatePublicMailboxAliasReq, options ...larkcore.RequestOptionFunc) (*CreatePublicMailboxAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -844,9 +844,9 @@ func (p *publicMailboxAlias) Create(ctx context.Context, req *CreatePublicMailbo // // - 删除公共邮箱别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-alias/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-alias/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_publicMailboxAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_publicMailboxAlias.go func (p *publicMailboxAlias) Delete(ctx context.Context, req *DeletePublicMailboxAliasReq, options ...larkcore.RequestOptionFunc) (*DeletePublicMailboxAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -870,9 +870,9 @@ func (p *publicMailboxAlias) Delete(ctx context.Context, req *DeletePublicMailbo // // - 获取所有公共邮箱别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-alias/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-alias/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_publicMailboxAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_publicMailboxAlias.go func (p *publicMailboxAlias) List(ctx context.Context, req *ListPublicMailboxAliasReq, options ...larkcore.RequestOptionFunc) (*ListPublicMailboxAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -896,9 +896,9 @@ func (p *publicMailboxAlias) List(ctx context.Context, req *ListPublicMailboxAli // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=mail&resource=public_mailbox.member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_create&project=mail&resource=public_mailbox.member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchCreate_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchCreate_publicMailboxMember.go func (p *publicMailboxMember) BatchCreate(ctx context.Context, req *BatchCreatePublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*BatchCreatePublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -922,9 +922,9 @@ func (p *publicMailboxMember) BatchCreate(ctx context.Context, req *BatchCreateP // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=mail&resource=public_mailbox.member&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=mail&resource=public_mailbox.member&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchDelete_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/batchDelete_publicMailboxMember.go func (p *publicMailboxMember) BatchDelete(ctx context.Context, req *BatchDeletePublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*BatchDeletePublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -948,9 +948,9 @@ func (p *publicMailboxMember) BatchDelete(ctx context.Context, req *BatchDeleteP // // - 删除公共邮箱所有成员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/clear +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/clear // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/clear_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/clear_publicMailboxMember.go func (p *publicMailboxMember) Clear(ctx context.Context, req *ClearPublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*ClearPublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -974,9 +974,9 @@ func (p *publicMailboxMember) Clear(ctx context.Context, req *ClearPublicMailbox // // - 向公共邮箱添加单个成员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_publicMailboxMember.go func (p *publicMailboxMember) Create(ctx context.Context, req *CreatePublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*CreatePublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1000,9 +1000,9 @@ func (p *publicMailboxMember) Create(ctx context.Context, req *CreatePublicMailb // // - 删除公共邮箱单个成员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_publicMailboxMember.go func (p *publicMailboxMember) Delete(ctx context.Context, req *DeletePublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*DeletePublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1026,9 +1026,9 @@ func (p *publicMailboxMember) Delete(ctx context.Context, req *DeletePublicMailb // // - 获取公共邮箱单个成员信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/get_publicMailboxMember.go func (p *publicMailboxMember) Get(ctx context.Context, req *GetPublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*GetPublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1052,9 +1052,9 @@ func (p *publicMailboxMember) Get(ctx context.Context, req *GetPublicMailboxMemb // // - 分页批量获取公共邮箱成员列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/public_mailbox-member/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_publicMailboxMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_publicMailboxMember.go func (p *publicMailboxMember) List(ctx context.Context, req *ListPublicMailboxMemberReq, options ...larkcore.RequestOptionFunc) (*ListPublicMailboxMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -1086,9 +1086,9 @@ func (p *publicMailboxMember) ListByIterator(ctx context.Context, req *ListPubli // // - 使用邮箱状态查询接口，可以输入邮箱地址，查询出该邮箱地址对应的类型以及状态 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/query_user.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/query_user.go func (u *user) Query(ctx context.Context, req *QueryUserReq, options ...larkcore.RequestOptionFunc) (*QueryUserResp, error) { // 发起请求 apiReq := req.apiReq @@ -1112,9 +1112,9 @@ func (u *user) Query(ctx context.Context, req *QueryUserReq, options ...larkcore // // - 该接口会永久删除用户邮箱地址。可用于删除位于邮箱回收站中的用户邮箱地址，一旦删除，将无法恢复。该接口支持邮件的转移，可以将被释放邮箱的邮件转移到另外一个可以使用的邮箱中。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_userMailbox.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_userMailbox.go func (u *userMailbox) Delete(ctx context.Context, req *DeleteUserMailboxReq, options ...larkcore.RequestOptionFunc) (*DeleteUserMailboxResp, error) { // 发起请求 apiReq := req.apiReq @@ -1138,9 +1138,9 @@ func (u *userMailbox) Delete(ctx context.Context, req *DeleteUserMailboxReq, opt // // - 创建用户邮箱别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-alias/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-alias/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_userMailboxAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/create_userMailboxAlias.go func (u *userMailboxAlias) Create(ctx context.Context, req *CreateUserMailboxAliasReq, options ...larkcore.RequestOptionFunc) (*CreateUserMailboxAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -1164,9 +1164,9 @@ func (u *userMailboxAlias) Create(ctx context.Context, req *CreateUserMailboxAli // // - 删除用户邮箱别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-alias/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-alias/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_userMailboxAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/delete_userMailboxAlias.go func (u *userMailboxAlias) Delete(ctx context.Context, req *DeleteUserMailboxAliasReq, options ...larkcore.RequestOptionFunc) (*DeleteUserMailboxAliasResp, error) { // 发起请求 apiReq := req.apiReq @@ -1190,9 +1190,9 @@ func (u *userMailboxAlias) Delete(ctx context.Context, req *DeleteUserMailboxAli // // - 获取用户邮箱所有别名 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-alias/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-alias/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_userMailboxAlias.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/mailv1/list_userMailboxAlias.go func (u *userMailboxAlias) List(ctx context.Context, req *ListUserMailboxAliasReq, options ...larkcore.RequestOptionFunc) (*ListUserMailboxAliasResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/mail/v1/model.go b/service/mail/v1/model.go index 5144f2af..7b4aeeb7 100644 --- a/service/mail/v1/model.go +++ b/service/mail/v1/model.go @@ -30,9 +30,9 @@ const ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -50,14 +50,14 @@ const ( ) const ( - UserIdTypeBatchCreateMailgroupMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchCreateMailgroupMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchCreateMailgroupMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchCreateMailgroupMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchCreateMailgroupMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchCreateMailgroupMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -71,47 +71,47 @@ const ( ) const ( - UserIdTypeCreateMailgroupMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateMailgroupMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateMailgroupMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateMailgroupMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateMailgroupMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateMailgroupMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeCreateMailgroupMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeCreateMailgroupMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeCreateMailgroupMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeCreateMailgroupMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeGetMailgroupMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetMailgroupMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetMailgroupMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetMailgroupMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetMailgroupMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetMailgroupMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeGetMailgroupMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeGetMailgroupMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeGetMailgroupMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeGetMailgroupMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeListMailgroupMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListMailgroupMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListMailgroupMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListMailgroupMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListMailgroupMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListMailgroupMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeListMailgroupMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListMailgroupMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListMailgroupMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListMailgroupMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeBatchCreateMailgroupPermissionMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchCreateMailgroupPermissionMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchCreateMailgroupPermissionMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchCreateMailgroupPermissionMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchCreateMailgroupPermissionMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchCreateMailgroupPermissionMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeBatchCreateMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeBatchCreateMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeBatchCreateMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeBatchCreateMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( @@ -122,42 +122,42 @@ const ( ) const ( - UserIdTypeCreateMailgroupPermissionMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateMailgroupPermissionMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateMailgroupPermissionMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateMailgroupPermissionMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateMailgroupPermissionMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateMailgroupPermissionMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeCreateMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeCreateMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeCreateMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeCreateMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeGetMailgroupPermissionMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetMailgroupPermissionMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetMailgroupPermissionMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetMailgroupPermissionMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetMailgroupPermissionMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetMailgroupPermissionMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeGetMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeGetMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeGetMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeGetMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeListMailgroupPermissionMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListMailgroupPermissionMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListMailgroupPermissionMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListMailgroupPermissionMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListMailgroupPermissionMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListMailgroupPermissionMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - DepartmentIdTypeListMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义department_id来标识部门 - DepartmentIdTypeListMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以open_department_id来标识部门 + DepartmentIdTypeListMailgroupPermissionMemberDepartmentId = "department_id" // 以自定义 department_id 来标识部门 + DepartmentIdTypeListMailgroupPermissionMemberOpenDepartmentId = "open_department_id" // 以 open_department_id 来标识部门 ) const ( - UserIdTypeBatchCreatePublicMailboxMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchCreatePublicMailboxMemberUnionId = "union_id" // 以user_id来识别用户 - UserIdTypeBatchCreatePublicMailboxMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchCreatePublicMailboxMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchCreatePublicMailboxMemberUnionId = "union_id" // 以 user_id 来识别用户 + UserIdTypeBatchCreatePublicMailboxMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -165,21 +165,21 @@ const ( ) const ( - UserIdTypeCreatePublicMailboxMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreatePublicMailboxMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreatePublicMailboxMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreatePublicMailboxMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreatePublicMailboxMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreatePublicMailboxMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetPublicMailboxMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetPublicMailboxMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetPublicMailboxMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetPublicMailboxMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetPublicMailboxMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetPublicMailboxMemberOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListPublicMailboxMemberUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListPublicMailboxMemberUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListPublicMailboxMemberOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListPublicMailboxMemberUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListPublicMailboxMemberUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListPublicMailboxMemberOpenId = "open_id" // 以 open_id 来识别用户 ) type EmailAlias struct { @@ -231,7 +231,7 @@ func (builder *EmailAliasBuilder) Build() *EmailAlias { } type Mailgroup struct { - MailgroupId *string `json:"mailgroup_id,omitempty"` // 邮件组ID + MailgroupId *string `json:"mailgroup_id,omitempty"` // 邮件组 ID Email *string `json:"email,omitempty"` // 邮件组地址 Name *string `json:"name,omitempty"` // 邮件组名称 Description *string `json:"description,omitempty"` // 邮件组描述 @@ -242,7 +242,7 @@ type Mailgroup struct { } type MailgroupBuilder struct { - mailgroupId string // 邮件组ID + mailgroupId string // 邮件组 ID mailgroupIdFlag bool email string // 邮件组地址 emailFlag bool @@ -265,7 +265,7 @@ func NewMailgroupBuilder() *MailgroupBuilder { return builder } -// 邮件组ID +// 邮件组 ID // // 示例值：xxxxxxxxxxxxxxx func (builder *MailgroupBuilder) MailgroupId(mailgroupId string) *MailgroupBuilder { @@ -375,11 +375,11 @@ func (builder *MailgroupBuilder) Build() *Mailgroup { } type MailgroupManager struct { - UserId *string `json:"user_id,omitempty"` // 管理员用户ID + UserId *string `json:"user_id,omitempty"` // 管理员用户 ID } type MailgroupManagerBuilder struct { - userId string // 管理员用户ID + userId string // 管理员用户 ID userIdFlag bool } @@ -388,7 +388,7 @@ func NewMailgroupManagerBuilder() *MailgroupManagerBuilder { return builder } -// 管理员用户ID +// 管理员用户 ID // // 示例值：xxxxxx func (builder *MailgroupManagerBuilder) UserId(userId string) *MailgroupManagerBuilder { @@ -408,20 +408,20 @@ func (builder *MailgroupManagerBuilder) Build() *MailgroupManager { type MailgroupMember struct { MemberId *string `json:"member_id,omitempty"` // 邮件组内成员唯一标识 - Email *string `json:"email,omitempty"` // 成员邮箱地址（当成员类型是EXTERNAL_USER/MAIL_GROUP/OTHER_MEMBER时有值） - UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识（当成员类型是USER时有值） - DepartmentId *string `json:"department_id,omitempty"` // 租户内部门的唯一标识（当成员类型是DEPARTMENT时有值） + Email *string `json:"email,omitempty"` // 成员邮箱地址（当成员类型是 EXTERNAL_USER/MAIL_GROUP/OTHER_MEMBER 时有值） + UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识（当成员类型是 USER 时有值） + DepartmentId *string `json:"department_id,omitempty"` // 租户内部门的唯一标识（当成员类型是 DEPARTMENT 时有值） Type *string `json:"type,omitempty"` // 成员类型 } type MailgroupMemberBuilder struct { memberId string // 邮件组内成员唯一标识 memberIdFlag bool - email string // 成员邮箱地址（当成员类型是EXTERNAL_USER/MAIL_GROUP/OTHER_MEMBER时有值） + email string // 成员邮箱地址（当成员类型是 EXTERNAL_USER/MAIL_GROUP/OTHER_MEMBER 时有值） emailFlag bool - userId string // 租户内用户的唯一标识（当成员类型是USER时有值） + userId string // 租户内用户的唯一标识（当成员类型是 USER 时有值） userIdFlag bool - departmentId string // 租户内部门的唯一标识（当成员类型是DEPARTMENT时有值） + departmentId string // 租户内部门的唯一标识（当成员类型是 DEPARTMENT 时有值） departmentIdFlag bool type_ string // 成员类型 typeFlag bool @@ -441,7 +441,7 @@ func (builder *MailgroupMemberBuilder) MemberId(memberId string) *MailgroupMembe return builder } -// 成员邮箱地址（当成员类型是EXTERNAL_USER/MAIL_GROUP/OTHER_MEMBER时有值） +// 成员邮箱地址（当成员类型是 EXTERNAL_USER/MAIL_GROUP/OTHER_MEMBER 时有值） // // 示例值：test_memeber@xxx.xx func (builder *MailgroupMemberBuilder) Email(email string) *MailgroupMemberBuilder { @@ -450,7 +450,7 @@ func (builder *MailgroupMemberBuilder) Email(email string) *MailgroupMemberBuild return builder } -// 租户内用户的唯一标识（当成员类型是USER时有值） +// 租户内用户的唯一标识（当成员类型是 USER 时有值） // // 示例值：xxxxxxxxxx func (builder *MailgroupMemberBuilder) UserId(userId string) *MailgroupMemberBuilder { @@ -459,7 +459,7 @@ func (builder *MailgroupMemberBuilder) UserId(userId string) *MailgroupMemberBui return builder } -// 租户内部门的唯一标识（当成员类型是DEPARTMENT时有值） +// 租户内部门的唯一标识（当成员类型是 DEPARTMENT 时有值） // // 示例值：xxxxxxxxxx func (builder *MailgroupMemberBuilder) DepartmentId(departmentId string) *MailgroupMemberBuilder { @@ -504,20 +504,20 @@ func (builder *MailgroupMemberBuilder) Build() *MailgroupMember { type MailgroupPermissionMember struct { PermissionMemberId *string `json:"permission_member_id,omitempty"` // 权限组内成员唯一标识 - UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识（当成员类型是USER时有值） - DepartmentId *string `json:"department_id,omitempty"` // 租户内部门的唯一标识（当成员类型是DEPARTMENT时有值） - Email *string `json:"email,omitempty"` // 成员邮箱地址（当成员类型是MAIL_GROUP/PUBLIC_MAILBOX时有值） + UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识（当成员类型是 USER 时有值） + DepartmentId *string `json:"department_id,omitempty"` // 租户内部门的唯一标识（当成员类型是 DEPARTMENT 时有值） + Email *string `json:"email,omitempty"` // 成员邮箱地址（当成员类型是 MAIL_GROUP/PUBLIC_MAILBOX 时有值） Type *string `json:"type,omitempty"` // 成员类型 } type MailgroupPermissionMemberBuilder struct { permissionMemberId string // 权限组内成员唯一标识 permissionMemberIdFlag bool - userId string // 租户内用户的唯一标识（当成员类型是USER时有值） + userId string // 租户内用户的唯一标识（当成员类型是 USER 时有值） userIdFlag bool - departmentId string // 租户内部门的唯一标识（当成员类型是DEPARTMENT时有值） + departmentId string // 租户内部门的唯一标识（当成员类型是 DEPARTMENT 时有值） departmentIdFlag bool - email string // 成员邮箱地址（当成员类型是MAIL_GROUP/PUBLIC_MAILBOX时有值） + email string // 成员邮箱地址（当成员类型是 MAIL_GROUP/PUBLIC_MAILBOX 时有值） emailFlag bool type_ string // 成员类型 typeFlag bool @@ -537,7 +537,7 @@ func (builder *MailgroupPermissionMemberBuilder) PermissionMemberId(permissionMe return builder } -// 租户内用户的唯一标识（当成员类型是USER时有值） +// 租户内用户的唯一标识（当成员类型是 USER 时有值） // // 示例值：xxxxxxxxxx func (builder *MailgroupPermissionMemberBuilder) UserId(userId string) *MailgroupPermissionMemberBuilder { @@ -546,7 +546,7 @@ func (builder *MailgroupPermissionMemberBuilder) UserId(userId string) *Mailgrou return builder } -// 租户内部门的唯一标识（当成员类型是DEPARTMENT时有值） +// 租户内部门的唯一标识（当成员类型是 DEPARTMENT 时有值） // // 示例值：xxxxxxxxxx func (builder *MailgroupPermissionMemberBuilder) DepartmentId(departmentId string) *MailgroupPermissionMemberBuilder { @@ -555,7 +555,7 @@ func (builder *MailgroupPermissionMemberBuilder) DepartmentId(departmentId strin return builder } -// 成员邮箱地址（当成员类型是MAIL_GROUP/PUBLIC_MAILBOX时有值） +// 成员邮箱地址（当成员类型是 MAIL_GROUP/PUBLIC_MAILBOX 时有值） // // 示例值：xxx@xx.x func (builder *MailgroupPermissionMemberBuilder) Email(email string) *MailgroupPermissionMemberBuilder { @@ -599,11 +599,11 @@ func (builder *MailgroupPermissionMemberBuilder) Build() *MailgroupPermissionMem } type Message struct { - Raw *string `json:"raw,omitempty"` // MIME邮件数据，基于base64url编码 + Raw *string `json:"raw,omitempty"` // MIME 邮件数据，基于 base64url 编码 } type MessageBuilder struct { - raw string // MIME邮件数据，基于base64url编码 + raw string // MIME 邮件数据，基于 base64url 编码 rawFlag bool } @@ -612,7 +612,7 @@ func NewMessageBuilder() *MessageBuilder { return builder } -// MIME邮件数据，基于base64url编码 +// MIME 邮件数据，基于 base64url 编码 // // 示例值：Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogdG9AeHh4Lnh4CmZyb206IHNlbmRlckB4eHgueHgKc3ViamVjdDogdGhpcyBpcyBhIHN1YmplY3QKCnRoaXMgaXMgdGhlIG1lc3NhZ2UgYm9keS4= func (builder *MessageBuilder) Raw(raw string) *MessageBuilder { @@ -696,14 +696,14 @@ func (builder *PublicMailboxBuilder) Build() *PublicMailbox { type PublicMailboxMember struct { MemberId *string `json:"member_id,omitempty"` // 公共邮箱内成员唯一标识 - UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识（当成员类型是USER时有值） + UserId *string `json:"user_id,omitempty"` // 租户内用户的唯一标识（当成员类型是 USER 时有值） Type *string `json:"type,omitempty"` // 成员类型 } type PublicMailboxMemberBuilder struct { memberId string // 公共邮箱内成员唯一标识 memberIdFlag bool - userId string // 租户内用户的唯一标识（当成员类型是USER时有值） + userId string // 租户内用户的唯一标识（当成员类型是 USER 时有值） userIdFlag bool type_ string // 成员类型 typeFlag bool @@ -723,7 +723,7 @@ func (builder *PublicMailboxMemberBuilder) MemberId(memberId string) *PublicMail return builder } -// 租户内用户的唯一标识（当成员类型是USER时有值） +// 租户内用户的唯一标识（当成员类型是 USER 时有值） // // 示例值：xxxxxxxxxx func (builder *PublicMailboxMemberBuilder) UserId(userId string) *PublicMailboxMemberBuilder { @@ -888,7 +888,7 @@ func NewDeleteMailgroupReqBuilder() *DeleteMailgroupReqBuilder { return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *DeleteMailgroupReqBuilder) MailgroupId(mailgroupId string) *DeleteMailgroupReqBuilder { @@ -929,7 +929,7 @@ func NewGetMailgroupReqBuilder() *GetMailgroupReqBuilder { return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *GetMailgroupReqBuilder) MailgroupId(mailgroupId string) *GetMailgroupReqBuilder { @@ -989,7 +989,7 @@ func (builder *ListMailgroupReqBuilder) Limit(limit int) *ListMailgroupReqBuilde return builder } -// 邮件组管理员用户ID，用于获取该用户有管理权限的邮件组 +// 邮件组管理员用户 ID，用于获取该用户有管理权限的邮件组 // // 示例值：ou_xxxxxx func (builder *ListMailgroupReqBuilder) ManagerUserId(managerUserId string) *ListMailgroupReqBuilder { @@ -997,7 +997,7 @@ func (builder *ListMailgroupReqBuilder) ManagerUserId(managerUserId string) *Lis return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListMailgroupReqBuilder) UserIdType(userIdType string) *ListMailgroupReqBuilder { @@ -1037,7 +1037,7 @@ type ListMailgroupReq struct { type ListMailgroupRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*Mailgroup `json:"items,omitempty"` // 邮件组列表 } @@ -1065,7 +1065,7 @@ func NewPatchMailgroupReqBuilder() *PatchMailgroupReqBuilder { return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *PatchMailgroupReqBuilder) MailgroupId(mailgroupId string) *PatchMailgroupReqBuilder { @@ -1127,7 +1127,7 @@ func NewUpdateMailgroupReqBuilder() *UpdateMailgroupReqBuilder { return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *UpdateMailgroupReqBuilder) MailgroupId(mailgroupId string) *UpdateMailgroupReqBuilder { @@ -1189,7 +1189,7 @@ func NewCreateMailgroupAliasReqBuilder() *CreateMailgroupAliasReqBuilder { return builder } -// 邮件组id或邮件组邮箱地址 +// 邮件组 id 或邮件组邮箱地址 // // 示例值：xxxxxx 或者 xxx@xx.xxx func (builder *CreateMailgroupAliasReqBuilder) MailgroupId(mailgroupId string) *CreateMailgroupAliasReqBuilder { @@ -1243,7 +1243,7 @@ func NewDeleteMailgroupAliasReqBuilder() *DeleteMailgroupAliasReqBuilder { return builder } -// 邮件组id或邮件组邮箱地址 +// 邮件组 id 或邮件组邮箱地址 // // 示例值：xxxxxx 或 test_group@xx.xxx func (builder *DeleteMailgroupAliasReqBuilder) MailgroupId(mailgroupId string) *DeleteMailgroupAliasReqBuilder { @@ -1292,7 +1292,7 @@ func NewListMailgroupAliasReqBuilder() *ListMailgroupAliasReqBuilder { return builder } -// 邮件组id或邮件组邮箱地址 +// 邮件组 id 或邮件组邮箱地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *ListMailgroupAliasReqBuilder) MailgroupId(mailgroupId string) *ListMailgroupAliasReqBuilder { @@ -1401,7 +1401,7 @@ func (builder *BatchCreateMailgroupMemberReqBuilder) MailgroupId(mailgroupId str return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：open_id func (builder *BatchCreateMailgroupMemberReqBuilder) UserIdType(userIdType string) *BatchCreateMailgroupMemberReqBuilder { @@ -1409,7 +1409,7 @@ func (builder *BatchCreateMailgroupMemberReqBuilder) UserIdType(userIdType strin return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值： func (builder *BatchCreateMailgroupMemberReqBuilder) DepartmentIdType(departmentIdType string) *BatchCreateMailgroupMemberReqBuilder { @@ -1456,7 +1456,7 @@ func (resp *BatchCreateMailgroupMemberResp) Success() bool { } type BatchDeleteMailgroupMemberReqBodyBuilder struct { - memberIdList []string // 本次调用删除的成员ID列表 + memberIdList []string // 本次调用删除的成员 ID 列表 memberIdListFlag bool } @@ -1465,7 +1465,7 @@ func NewBatchDeleteMailgroupMemberReqBodyBuilder() *BatchDeleteMailgroupMemberRe return builder } -// 本次调用删除的成员ID列表 +// 本次调用删除的成员 ID 列表 // //示例值： func (builder *BatchDeleteMailgroupMemberReqBodyBuilder) MemberIdList(memberIdList []string) *BatchDeleteMailgroupMemberReqBodyBuilder { @@ -1483,7 +1483,7 @@ func (builder *BatchDeleteMailgroupMemberReqBodyBuilder) Build() *BatchDeleteMai } type BatchDeleteMailgroupMemberPathReqBodyBuilder struct { - memberIdList []string // 本次调用删除的成员ID列表 + memberIdList []string // 本次调用删除的成员 ID 列表 memberIdListFlag bool } @@ -1492,7 +1492,7 @@ func NewBatchDeleteMailgroupMemberPathReqBodyBuilder() *BatchDeleteMailgroupMemb return builder } -// 本次调用删除的成员ID列表 +// 本次调用删除的成员 ID 列表 // // 示例值： func (builder *BatchDeleteMailgroupMemberPathReqBodyBuilder) MemberIdList(memberIdList []string) *BatchDeleteMailgroupMemberPathReqBodyBuilder { @@ -1546,7 +1546,7 @@ func (builder *BatchDeleteMailgroupMemberReqBuilder) Build() *BatchDeleteMailgro } type BatchDeleteMailgroupMemberReqBody struct { - MemberIdList []string `json:"member_id_list,omitempty"` // 本次调用删除的成员ID列表 + MemberIdList []string `json:"member_id_list,omitempty"` // 本次调用删除的成员 ID 列表 } type BatchDeleteMailgroupMemberReq struct { @@ -1577,7 +1577,7 @@ func NewCreateMailgroupMemberReqBuilder() *CreateMailgroupMemberReqBuilder { return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *CreateMailgroupMemberReqBuilder) MailgroupId(mailgroupId string) *CreateMailgroupMemberReqBuilder { @@ -1585,7 +1585,7 @@ func (builder *CreateMailgroupMemberReqBuilder) MailgroupId(mailgroupId string) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateMailgroupMemberReqBuilder) UserIdType(userIdType string) *CreateMailgroupMemberReqBuilder { @@ -1593,7 +1593,7 @@ func (builder *CreateMailgroupMemberReqBuilder) UserIdType(userIdType string) *C return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *CreateMailgroupMemberReqBuilder) DepartmentIdType(departmentIdType string) *CreateMailgroupMemberReqBuilder { @@ -1701,7 +1701,7 @@ func NewGetMailgroupMemberReqBuilder() *GetMailgroupMemberReqBuilder { return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *GetMailgroupMemberReqBuilder) MailgroupId(mailgroupId string) *GetMailgroupMemberReqBuilder { @@ -1717,7 +1717,7 @@ func (builder *GetMailgroupMemberReqBuilder) MemberId(memberId string) *GetMailg return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetMailgroupMemberReqBuilder) UserIdType(userIdType string) *GetMailgroupMemberReqBuilder { @@ -1725,7 +1725,7 @@ func (builder *GetMailgroupMemberReqBuilder) UserIdType(userIdType string) *GetM return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *GetMailgroupMemberReqBuilder) DepartmentIdType(departmentIdType string) *GetMailgroupMemberReqBuilder { @@ -1791,7 +1791,7 @@ func (builder *ListMailgroupMemberReqBuilder) MailgroupId(mailgroupId string) *L return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListMailgroupMemberReqBuilder) UserIdType(userIdType string) *ListMailgroupMemberReqBuilder { @@ -1799,7 +1799,7 @@ func (builder *ListMailgroupMemberReqBuilder) UserIdType(userIdType string) *Lis return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *ListMailgroupMemberReqBuilder) DepartmentIdType(departmentIdType string) *ListMailgroupMemberReqBuilder { @@ -1840,7 +1840,7 @@ type ListMailgroupMemberReq struct { type ListMailgroupMemberRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*MailgroupMember `json:"items,omitempty"` // 邮件组成员列表 } @@ -1930,7 +1930,7 @@ func (builder *BatchCreateMailgroupPermissionMemberReqBuilder) MailgroupId(mailg return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值：open_id func (builder *BatchCreateMailgroupPermissionMemberReqBuilder) UserIdType(userIdType string) *BatchCreateMailgroupPermissionMemberReqBuilder { @@ -1938,7 +1938,7 @@ func (builder *BatchCreateMailgroupPermissionMemberReqBuilder) UserIdType(userId return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *BatchCreateMailgroupPermissionMemberReqBuilder) DepartmentIdType(departmentIdType string) *BatchCreateMailgroupPermissionMemberReqBuilder { @@ -1985,7 +1985,7 @@ func (resp *BatchCreateMailgroupPermissionMemberResp) Success() bool { } type BatchDeleteMailgroupPermissionMemberReqBodyBuilder struct { - permissionMemberIdList []string // 本次调用删除的权限成员ID列表 + permissionMemberIdList []string // 本次调用删除的权限成员 ID 列表 permissionMemberIdListFlag bool } @@ -1994,7 +1994,7 @@ func NewBatchDeleteMailgroupPermissionMemberReqBodyBuilder() *BatchDeleteMailgro return builder } -// 本次调用删除的权限成员ID列表 +// 本次调用删除的权限成员 ID 列表 // //示例值： func (builder *BatchDeleteMailgroupPermissionMemberReqBodyBuilder) PermissionMemberIdList(permissionMemberIdList []string) *BatchDeleteMailgroupPermissionMemberReqBodyBuilder { @@ -2012,7 +2012,7 @@ func (builder *BatchDeleteMailgroupPermissionMemberReqBodyBuilder) Build() *Batc } type BatchDeleteMailgroupPermissionMemberPathReqBodyBuilder struct { - permissionMemberIdList []string // 本次调用删除的权限成员ID列表 + permissionMemberIdList []string // 本次调用删除的权限成员 ID 列表 permissionMemberIdListFlag bool } @@ -2021,7 +2021,7 @@ func NewBatchDeleteMailgroupPermissionMemberPathReqBodyBuilder() *BatchDeleteMai return builder } -// 本次调用删除的权限成员ID列表 +// 本次调用删除的权限成员 ID 列表 // // 示例值： func (builder *BatchDeleteMailgroupPermissionMemberPathReqBodyBuilder) PermissionMemberIdList(permissionMemberIdList []string) *BatchDeleteMailgroupPermissionMemberPathReqBodyBuilder { @@ -2075,7 +2075,7 @@ func (builder *BatchDeleteMailgroupPermissionMemberReqBuilder) Build() *BatchDel } type BatchDeleteMailgroupPermissionMemberReqBody struct { - PermissionMemberIdList []string `json:"permission_member_id_list,omitempty"` // 本次调用删除的权限成员ID列表 + PermissionMemberIdList []string `json:"permission_member_id_list,omitempty"` // 本次调用删除的权限成员 ID 列表 } type BatchDeleteMailgroupPermissionMemberReq struct { @@ -2106,7 +2106,7 @@ func NewCreateMailgroupPermissionMemberReqBuilder() *CreateMailgroupPermissionMe return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *CreateMailgroupPermissionMemberReqBuilder) MailgroupId(mailgroupId string) *CreateMailgroupPermissionMemberReqBuilder { @@ -2114,7 +2114,7 @@ func (builder *CreateMailgroupPermissionMemberReqBuilder) MailgroupId(mailgroupI return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateMailgroupPermissionMemberReqBuilder) UserIdType(userIdType string) *CreateMailgroupPermissionMemberReqBuilder { @@ -2122,7 +2122,7 @@ func (builder *CreateMailgroupPermissionMemberReqBuilder) UserIdType(userIdType return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：xxx func (builder *CreateMailgroupPermissionMemberReqBuilder) DepartmentIdType(departmentIdType string) *CreateMailgroupPermissionMemberReqBuilder { @@ -2230,7 +2230,7 @@ func NewGetMailgroupPermissionMemberReqBuilder() *GetMailgroupPermissionMemberRe return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *GetMailgroupPermissionMemberReqBuilder) MailgroupId(mailgroupId string) *GetMailgroupPermissionMemberReqBuilder { @@ -2246,7 +2246,7 @@ func (builder *GetMailgroupPermissionMemberReqBuilder) PermissionMemberId(permis return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetMailgroupPermissionMemberReqBuilder) UserIdType(userIdType string) *GetMailgroupPermissionMemberReqBuilder { @@ -2254,7 +2254,7 @@ func (builder *GetMailgroupPermissionMemberReqBuilder) UserIdType(userIdType str return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *GetMailgroupPermissionMemberReqBuilder) DepartmentIdType(departmentIdType string) *GetMailgroupPermissionMemberReqBuilder { @@ -2312,7 +2312,7 @@ func (builder *ListMailgroupPermissionMemberReqBuilder) Limit(limit int) *ListMa return builder } -// 邮件组ID或者邮件组地址 +// 邮件组 ID 或者邮件组地址 // // 示例值：xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx func (builder *ListMailgroupPermissionMemberReqBuilder) MailgroupId(mailgroupId string) *ListMailgroupPermissionMemberReqBuilder { @@ -2320,7 +2320,7 @@ func (builder *ListMailgroupPermissionMemberReqBuilder) MailgroupId(mailgroupId return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListMailgroupPermissionMemberReqBuilder) UserIdType(userIdType string) *ListMailgroupPermissionMemberReqBuilder { @@ -2328,7 +2328,7 @@ func (builder *ListMailgroupPermissionMemberReqBuilder) UserIdType(userIdType st return builder } -// 此次调用中使用的部门ID的类型 +// 此次调用中使用的部门 ID 的类型 // // 示例值：open_department_id func (builder *ListMailgroupPermissionMemberReqBuilder) DepartmentIdType(departmentIdType string) *ListMailgroupPermissionMemberReqBuilder { @@ -2369,7 +2369,7 @@ type ListMailgroupPermissionMemberReq struct { type ListMailgroupPermissionMemberRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*MailgroupPermissionMember `json:"items,omitempty"` // 邮件组权限成员列表 } @@ -2572,7 +2572,7 @@ type ListPublicMailboxReq struct { type ListPublicMailboxRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*PublicMailbox `json:"items,omitempty"` // 公共邮箱列表 } @@ -2714,7 +2714,7 @@ func NewCreatePublicMailboxAliasReqBuilder() *CreatePublicMailboxAliasReqBuilder return builder } -// 公共邮箱id或公共邮箱地址 +// 公共邮箱 id 或公共邮箱地址 // // 示例值：xxxxxx 或 xxx@xx.xxx func (builder *CreatePublicMailboxAliasReqBuilder) PublicMailboxId(publicMailboxId string) *CreatePublicMailboxAliasReqBuilder { @@ -2768,7 +2768,7 @@ func NewDeletePublicMailboxAliasReqBuilder() *DeletePublicMailboxAliasReqBuilder return builder } -// 公共邮箱id或公共邮箱地址 +// 公共邮箱 id 或公共邮箱地址 // // 示例值：xxxxxx 或 xxx@xx.xxx func (builder *DeletePublicMailboxAliasReqBuilder) PublicMailboxId(publicMailboxId string) *DeletePublicMailboxAliasReqBuilder { @@ -2817,7 +2817,7 @@ func NewListPublicMailboxAliasReqBuilder() *ListPublicMailboxAliasReqBuilder { return builder } -// 公共邮箱id或公共邮箱邮件地址 +// 公共邮箱 id 或公共邮箱邮件地址 // // 示例值：xxxxxx 或 xxx@xx.xxx func (builder *ListPublicMailboxAliasReqBuilder) PublicMailboxId(publicMailboxId string) *ListPublicMailboxAliasReqBuilder { @@ -2926,7 +2926,7 @@ func (builder *BatchCreatePublicMailboxMemberReqBuilder) PublicMailboxId(publicM return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchCreatePublicMailboxMemberReqBuilder) UserIdType(userIdType string) *BatchCreatePublicMailboxMemberReqBuilder { @@ -2973,7 +2973,7 @@ func (resp *BatchCreatePublicMailboxMemberResp) Success() bool { } type BatchDeletePublicMailboxMemberReqBodyBuilder struct { - memberIdList []string // 本次调用删除的公共邮箱成员ID列表 + memberIdList []string // 本次调用删除的公共邮箱成员 ID 列表 memberIdListFlag bool } @@ -2982,7 +2982,7 @@ func NewBatchDeletePublicMailboxMemberReqBodyBuilder() *BatchDeletePublicMailbox return builder } -// 本次调用删除的公共邮箱成员ID列表 +// 本次调用删除的公共邮箱成员 ID 列表 // //示例值： func (builder *BatchDeletePublicMailboxMemberReqBodyBuilder) MemberIdList(memberIdList []string) *BatchDeletePublicMailboxMemberReqBodyBuilder { @@ -3000,7 +3000,7 @@ func (builder *BatchDeletePublicMailboxMemberReqBodyBuilder) Build() *BatchDelet } type BatchDeletePublicMailboxMemberPathReqBodyBuilder struct { - memberIdList []string // 本次调用删除的公共邮箱成员ID列表 + memberIdList []string // 本次调用删除的公共邮箱成员 ID 列表 memberIdListFlag bool } @@ -3009,7 +3009,7 @@ func NewBatchDeletePublicMailboxMemberPathReqBodyBuilder() *BatchDeletePublicMai return builder } -// 本次调用删除的公共邮箱成员ID列表 +// 本次调用删除的公共邮箱成员 ID 列表 // // 示例值： func (builder *BatchDeletePublicMailboxMemberPathReqBodyBuilder) MemberIdList(memberIdList []string) *BatchDeletePublicMailboxMemberPathReqBodyBuilder { @@ -3063,7 +3063,7 @@ func (builder *BatchDeletePublicMailboxMemberReqBuilder) Build() *BatchDeletePub } type BatchDeletePublicMailboxMemberReqBody struct { - MemberIdList []string `json:"member_id_list,omitempty"` // 本次调用删除的公共邮箱成员ID列表 + MemberIdList []string `json:"member_id_list,omitempty"` // 本次调用删除的公共邮箱成员 ID 列表 } type BatchDeletePublicMailboxMemberReq struct { @@ -3143,7 +3143,7 @@ func (builder *CreatePublicMailboxMemberReqBuilder) PublicMailboxId(publicMailbo return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreatePublicMailboxMemberReqBuilder) UserIdType(userIdType string) *CreatePublicMailboxMemberReqBuilder { @@ -3265,7 +3265,7 @@ func (builder *GetPublicMailboxMemberReqBuilder) MemberId(memberId string) *GetP return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetPublicMailboxMemberReqBuilder) UserIdType(userIdType string) *GetPublicMailboxMemberReqBuilder { @@ -3329,7 +3329,7 @@ func (builder *ListPublicMailboxMemberReqBuilder) PublicMailboxId(publicMailboxI return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListPublicMailboxMemberReqBuilder) UserIdType(userIdType string) *ListPublicMailboxMemberReqBuilder { @@ -3370,7 +3370,7 @@ type ListPublicMailboxMemberReq struct { type ListPublicMailboxMemberRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否有下一页数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token Items []*PublicMailboxMember `json:"items,omitempty"` // 公共邮箱成员列表 } @@ -3723,7 +3723,7 @@ func (iterator *ListMailgroupIterator) Next() (bool, *Mailgroup, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -3777,7 +3777,7 @@ func (iterator *ListMailgroupMemberIterator) Next() (bool, *MailgroupMember, err return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -3831,7 +3831,7 @@ func (iterator *ListMailgroupPermissionMemberIterator) Next() (bool, *MailgroupP return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -3885,7 +3885,7 @@ func (iterator *ListPublicMailboxIterator) Next() (bool, *PublicMailbox, error) return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -3939,7 +3939,7 @@ func (iterator *ListPublicMailboxMemberIterator) Next() (bool, *PublicMailboxMem return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/meeting_room/v1/event.go b/service/meeting_room/v1/event.go index 2e7caa98..c4036a2d 100644 --- a/service/meeting_room/v1/event.go +++ b/service/meeting_room/v1/event.go @@ -32,7 +32,7 @@ func (h *P2MeetingRoomCreatedV1Handler) Event() interface{} { return &P2MeetingRoomCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRoomCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRoomCreatedV1)) } @@ -52,7 +52,7 @@ func (h *P2MeetingRoomDeletedV1Handler) Event() interface{} { return &P2MeetingRoomDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRoomDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRoomDeletedV1)) } @@ -72,7 +72,7 @@ func (h *P2MeetingRoomStatusChangedV1Handler) Event() interface{} { return &P2MeetingRoomStatusChangedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRoomStatusChangedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRoomStatusChangedV1)) } @@ -92,7 +92,7 @@ func (h *P2MeetingRoomUpdatedV1Handler) Event() interface{} { return &P2MeetingRoomUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRoomUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRoomUpdatedV1)) } diff --git a/service/meeting_room/v1/ext_model.go b/service/meeting_room/v1/ext_model.go index 8c8eed1d..22643494 100644 --- a/service/meeting_room/v1/ext_model.go +++ b/service/meeting_room/v1/ext_model.go @@ -29,21 +29,21 @@ type P1EventTimeV1 struct { } type P1MeetingRoomV1 struct { - OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 + OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 } type P1OrganizerV1 struct { - OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的open_id不同 - UserId string `json:"user_id,omitempty"` // 用户在ISV下的唯一标识，申请了"获取用户user ID"权限后才会返回 + OpenId string `json:"open_id,omitempty"` // 员工对此应用的唯一标识，同一员工对不同应用的 open_id 不同 + UserId string `json:"user_id,omitempty"` // 用户在 ISV 下的唯一标识，申请了"获取用户 user ID"权限后才会返回 } type P1ThirdPartyMeetingRoomChangedV1Data struct { AppID string `json:"app_id,omitempty"` // App ID TenantKey string `json:"tenant_key,omitempty"` // 企业标识 - Type string `json:"type,omitempty"` // 此事件此处始终为event_callback + Type string `json:"type,omitempty"` // 此事件此处始终为 event_callback EventTime string `json:"event_time,omitempty"` //事件发生时间 Uid string `json:"uid,omitempty"` // 日程的唯一标识 - OriginalTime int `json:"original_time,omitempty"` // 重复日程的例外的唯一标识，如果不是重复的日程，此处为0 + OriginalTime int `json:"original_time,omitempty"` // 重复日程的例外的唯一标识，如果不是重复的日程，此处为 0 Start *P1EventTimeV1 `json:"start,omitempty"` //日历的日程开始时间 End *P1EventTimeV1 `json:"end,omitempty"` //日历的日程结束时间 MeetingRoom []*P1MeetingRoomV1 `json:"meeting_rooms,omitempty"` //日程关联的会议室 diff --git a/service/meeting_room/v1/model.go b/service/meeting_room/v1/model.go index 6690d099..91a28b11 100644 --- a/service/meeting_room/v1/model.go +++ b/service/meeting_room/v1/model.go @@ -49,16 +49,16 @@ func (builder *EventUidsBuilder) Build() *EventUids { } type EventInfo struct { - Uid *string `json:"uid,omitempty"` // 日程唯一ID - OriginalTime *int `json:"original_time,omitempty"` // 日程实例原始时间。非重复性日程和重复性日程，此处传0；重复性日程的例外，传对应的original_time + Uid *string `json:"uid,omitempty"` // 日程唯一 ID + OriginalTime *int `json:"original_time,omitempty"` // 日程实例原始时间。非重复性日程和重复性日程，此处传 0；重复性日程的例外，传对应的 original_time Summary *string `json:"summary,omitempty"` // 日程主题 Vchat []*Vchat `json:"vchat,omitempty"` // 视频会议信息 } type EventInfoBuilder struct { - uid string // 日程唯一ID + uid string // 日程唯一 ID uidFlag bool - originalTime int // 日程实例原始时间。非重复性日程和重复性日程，此处传0；重复性日程的例外，传对应的original_time + originalTime int // 日程实例原始时间。非重复性日程和重复性日程，此处传 0；重复性日程的例外，传对应的 original_time originalTimeFlag bool summary string // 日程主题 summaryFlag bool @@ -71,7 +71,7 @@ func NewEventInfoBuilder() *EventInfoBuilder { return builder } -// 日程唯一ID +// 日程唯一 ID // // 示例值：a04dbea1-86b9-4372-aa8d-64ebe801be2a func (builder *EventInfoBuilder) Uid(uid string) *EventInfoBuilder { @@ -80,7 +80,7 @@ func (builder *EventInfoBuilder) Uid(uid string) *EventInfoBuilder { return builder } -// 日程实例原始时间。非重复性日程和重复性日程，此处传0；重复性日程的例外，传对应的original_time +// 日程实例原始时间。非重复性日程和重复性日程，此处传 0；重复性日程的例外，传对应的 original_time // // 示例值：0 func (builder *EventInfoBuilder) OriginalTime(originalTime int) *EventInfoBuilder { @@ -160,12 +160,12 @@ func (builder *EventTimeBuilder) Build() *EventTime { } type EventUid struct { - Uid *string `json:"uid,omitempty"` // 日程唯一ID + Uid *string `json:"uid,omitempty"` // 日程唯一 ID OriginalTime *int `json:"original_time,omitempty"` // original_time } type EventUidBuilder struct { - uid string // 日程唯一ID + uid string // 日程唯一 ID uidFlag bool originalTime int // original_time originalTimeFlag bool @@ -176,7 +176,7 @@ func NewEventUidBuilder() *EventUidBuilder { return builder } -// 日程唯一ID +// 日程唯一 ID // // 示例值：a04dbea1-86b9-4372-aa8d-64ebe801be2a func (builder *EventUidBuilder) Uid(uid string) *EventUidBuilder { @@ -241,13 +241,13 @@ func (builder *MeetingRoomBuilder) Build() *MeetingRoom { type UserInfo struct { OpenId *string `json:"open_id,omitempty"` // - UserId *string `json:"user_id,omitempty"` // 用户在ISV下的唯一标识，申请了"获取用户 user ID"权限后才会返回 + UserId *string `json:"user_id,omitempty"` // 用户在 ISV 下的唯一标识，申请了"获取用户 user ID"权限后才会返回 } type UserInfoBuilder struct { openId string // openIdFlag bool - userId string // 用户在ISV下的唯一标识，申请了"获取用户 user ID"权限后才会返回 + userId string // 用户在 ISV 下的唯一标识，申请了"获取用户 user ID"权限后才会返回 userIdFlag bool } @@ -265,7 +265,7 @@ func (builder *UserInfoBuilder) OpenId(openId string) *UserInfoBuilder { return builder } -// 用户在ISV下的唯一标识，申请了"获取用户 user ID"权限后才会返回 +// 用户在 ISV 下的唯一标识，申请了"获取用户 user ID"权限后才会返回 // // 示例值： func (builder *UserInfoBuilder) UserId(userId string) *UserInfoBuilder { diff --git a/service/okr/v1/api.go b/service/okr/v1/api.go index 8977ae91..ade31773 100644 --- a/service/okr/v1/api.go +++ b/service/okr/v1/api.go @@ -40,9 +40,9 @@ type OkrService struct { MetricSourceTable *metricSourceTable // 指标表 MetricSourceTableItem *metricSourceTableItem // 指标项 Okr *okr // OKR - Period *period // OKR周期 - ProgressRecord *progressRecord // OKR进展记录 - UserOkr *userOkr // 用户OKR + Period *period // OKR 周期 + ProgressRecord *progressRecord // OKR 进展记录 + UserOkr *userOkr // 用户 OKR } type image struct { @@ -74,9 +74,9 @@ type userOkr struct { // // - 上传图片 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/image/upload +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/image/upload // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/upload_image.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/upload_image.go func (i *image) Upload(ctx context.Context, req *UploadImageReq, options ...larkcore.RequestOptionFunc) (*UploadImageResp, error) { options = append(options, larkcore.WithFileUpload()) // 发起请求 @@ -101,9 +101,9 @@ func (i *image) Upload(ctx context.Context, req *UploadImageReq, options ...lark // // - 获取租户下全部 OKR 指标库（仅限 OKR 企业版使用） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_metricSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_metricSource.go func (m *metricSource) List(ctx context.Context, req *ListMetricSourceReq, options ...larkcore.RequestOptionFunc) (*ListMetricSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -127,9 +127,9 @@ func (m *metricSource) List(ctx context.Context, req *ListMetricSourceReq, optio // // - 获取指定指标库下有哪些指标表（仅限 OKR 企业版使用） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_metricSourceTable.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_metricSourceTable.go func (m *metricSourceTable) List(ctx context.Context, req *ListMetricSourceTableReq, options ...larkcore.RequestOptionFunc) (*ListMetricSourceTableResp, error) { // 发起请求 apiReq := req.apiReq @@ -153,9 +153,9 @@ func (m *metricSourceTable) List(ctx context.Context, req *ListMetricSourceTable // // - - 该接口用于批量更新多项指标，单次调用最多更新 100 条记录。接口仅限 OKR 企业版使用。;; 更新成功后 OKR 系统会给以下人员发送消息通知：;; - 首次更新目标值的人员 ;; - 已经将指标添加为 KR、且本次目标值/起始值/支撑的上级有变更的人员，不包含仅更新了进度值的人员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/batch_update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/batch_update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/batchUpdate_metricSourceTableItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/batchUpdate_metricSourceTableItem.go func (m *metricSourceTableItem) BatchUpdate(ctx context.Context, req *BatchUpdateMetricSourceTableItemReq, options ...larkcore.RequestOptionFunc) (*BatchUpdateMetricSourceTableItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -179,9 +179,9 @@ func (m *metricSourceTableItem) BatchUpdate(ctx context.Context, req *BatchUpdat // // - 获取某项指标的具体内容（仅限 OKR 企业版使用） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/get_metricSourceTableItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/get_metricSourceTableItem.go func (m *metricSourceTableItem) Get(ctx context.Context, req *GetMetricSourceTableItemReq, options ...larkcore.RequestOptionFunc) (*GetMetricSourceTableItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -205,9 +205,9 @@ func (m *metricSourceTableItem) Get(ctx context.Context, req *GetMetricSourceTab // // - 获取指定指标表下的所有指标项（仅限 OKR 企业版使用） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_metricSourceTableItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_metricSourceTableItem.go func (m *metricSourceTableItem) List(ctx context.Context, req *ListMetricSourceTableItemReq, options ...larkcore.RequestOptionFunc) (*ListMetricSourceTableItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -231,9 +231,9 @@ func (m *metricSourceTableItem) List(ctx context.Context, req *ListMetricSourceT // // - - 该接口用于更新某项指标，接口仅限 OKR 企业版使用。;; 更新成功后 OKR 系统会给以下人员发送消息通知：;; - 首次更新目标值的人员 ;; - 已经将指标添加为 KR、且本次目标值/起始值/支撑的上级有变更的人员，不包含仅更新了进度值的人员 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/metric_source-table-item/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/patch_metricSourceTableItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/patch_metricSourceTableItem.go func (m *metricSourceTableItem) Patch(ctx context.Context, req *PatchMetricSourceTableItemReq, options ...larkcore.RequestOptionFunc) (*PatchMetricSourceTableItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -253,15 +253,15 @@ func (m *metricSourceTableItem) Patch(ctx context.Context, req *PatchMetricSourc return resp, err } -// 批量获取OKR +// 批量获取 OKR // -// - 根据OKR id批量获取OKR +// - 根据 OKR id 批量获取 OKR // -// - 使用tenant_access_token需要额外申请权限以应用身份访问OKR信息 +// - 使用tenant_access_token需要额外申请权限以应用身份访问 OKR 信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/okr/batch_get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/okr/batch_get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/batchGet_okr.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/batchGet_okr.go func (o *okr) BatchGet(ctx context.Context, req *BatchGetOkrReq, options ...larkcore.RequestOptionFunc) (*BatchGetOkrResp, error) { // 发起请求 apiReq := req.apiReq @@ -281,15 +281,15 @@ func (o *okr) BatchGet(ctx context.Context, req *BatchGetOkrReq, options ...lark return resp, err } -// 获取OKR周期列表 +// 获取 OKR 周期列表 // -// - 获取OKR周期列表 +// - 获取 OKR 周期列表 // -// - 使用tenant_access_token需要额外申请权限以应用身份访问OKR信息 +// - 使用tenant_access_token需要额外申请权限以应用身份访问 OKR 信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/period/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/period/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_period.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_period.go func (p *period) List(ctx context.Context, req *ListPeriodReq, options ...larkcore.RequestOptionFunc) (*ListPeriodResp, error) { // 发起请求 apiReq := req.apiReq @@ -309,13 +309,13 @@ func (p *period) List(ctx context.Context, req *ListPeriodReq, options ...larkco return resp, err } -// 创建OKR进展记录 +// 创建 OKR 进展记录 // -// - 创建OKR进展记录 +// - 创建 OKR 进展记录 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/create_progressRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/create_progressRecord.go func (p *progressRecord) Create(ctx context.Context, req *CreateProgressRecordReq, options ...larkcore.RequestOptionFunc) (*CreateProgressRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -335,13 +335,13 @@ func (p *progressRecord) Create(ctx context.Context, req *CreateProgressRecordRe return resp, err } -// 删除OKR进展记录 +// 删除 OKR 进展记录 // -// - 根据ID删除OKR进展记录 +// - 根据 ID 删除 OKR 进展记录 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/delete_progressRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/delete_progressRecord.go func (p *progressRecord) Delete(ctx context.Context, req *DeleteProgressRecordReq, options ...larkcore.RequestOptionFunc) (*DeleteProgressRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -361,13 +361,13 @@ func (p *progressRecord) Delete(ctx context.Context, req *DeleteProgressRecordRe return resp, err } -// 获取OKR进展记录 +// 获取 OKR 进展记录 // -// - 根据ID获取OKR进展记录详情 +// - 根据 ID 获取 OKR 进展记录详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/get_progressRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/get_progressRecord.go func (p *progressRecord) Get(ctx context.Context, req *GetProgressRecordReq, options ...larkcore.RequestOptionFunc) (*GetProgressRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -387,13 +387,13 @@ func (p *progressRecord) Get(ctx context.Context, req *GetProgressRecordReq, opt return resp, err } -// 更新OKR进展记录 +// 更新 OKR 进展记录 // -// - 根据OKR进展记录ID更新进展详情 +// - 根据 OKR 进展记录 ID 更新进展详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/progress_record/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/update_progressRecord.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/update_progressRecord.go func (p *progressRecord) Update(ctx context.Context, req *UpdateProgressRecordReq, options ...larkcore.RequestOptionFunc) (*UpdateProgressRecordResp, error) { // 发起请求 apiReq := req.apiReq @@ -413,15 +413,15 @@ func (p *progressRecord) Update(ctx context.Context, req *UpdateProgressRecordRe return resp, err } -// 获取用户的OKR列表 +// 获取用户的 OKR 列表 // -// - 根据用户的id获取OKR列表 +// - 根据用户的 id 获取 OKR 列表 // -// - 使用tenant_access_token需要额外申请权限以应用身份访问OKR信息 +// - 使用tenant_access_token需要额外申请权限以应用身份访问 OKR 信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/okr-v1/user-okr/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_userOkr.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/okrv1/list_userOkr.go func (u *userOkr) List(ctx context.Context, req *ListUserOkrReq, options ...larkcore.RequestOptionFunc) (*ListUserOkrResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/okr/v1/model.go b/service/okr/v1/model.go index 6d87b663..be8e64ce 100644 --- a/service/okr/v1/model.go +++ b/service/okr/v1/model.go @@ -24,71 +24,71 @@ import ( ) const ( - TargetTypeObjective = 2 // okr的O - TargetTypeKeyResult = 3 // okr的KR + TargetTypeObjective = 2 // okr 的 O + TargetTypeKeyResult = 3 // okr 的 KR ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetMetricSourceTableItemUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetMetricSourceTableItemUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetMetricSourceTableItemOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetMetricSourceTableItemUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetMetricSourceTableItemUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetMetricSourceTableItemOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListMetricSourceTableItemUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListMetricSourceTableItemUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListMetricSourceTableItemOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListMetricSourceTableItemUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListMetricSourceTableItemUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListMetricSourceTableItemOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypePatchMetricSourceTableItemUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchMetricSourceTableItemUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchMetricSourceTableItemOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchMetricSourceTableItemUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchMetricSourceTableItemUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchMetricSourceTableItemOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeBatchGetOkrUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchGetOkrUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchGetOkrOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeBatchGetOkrPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeBatchGetOkrUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchGetOkrUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchGetOkrOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeBatchGetOkrPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) const ( - TargetTypeCreateProgressRecordObjective = 2 // okr的O - TargetTypeCreateProgressRecordKeyResult = 3 // okr的KR + TargetTypeCreateProgressRecordObjective = 2 // okr 的 O + TargetTypeCreateProgressRecordKeyResult = 3 // okr 的 KR ) const ( - UserIdTypeCreateProgressRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateProgressRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateProgressRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateProgressRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateProgressRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateProgressRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetProgressRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetProgressRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetProgressRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetProgressRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetProgressRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetProgressRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateProgressRecordUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateProgressRecordUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateProgressRecordOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateProgressRecordUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateProgressRecordUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateProgressRecordOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListUserOkrUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListUserOkrUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListUserOkrOpenId = "open_id" // 以open_id来识别用户 - UserIdTypeListUserOkrPeopleAdminId = "people_admin_id" // 以people_admin_id来识别用户 + UserIdTypeListUserOkrUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListUserOkrUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListUserOkrOpenId = "open_id" // 以 open_id 来识别用户 + UserIdTypeListUserOkrPeopleAdminId = "people_admin_id" // 以 people_admin_id 来识别用户 ) type AlignObjective struct { @@ -249,20 +249,20 @@ func (builder *ContentBlockElementBuilder) Build() *ContentBlockElement { } type ContentColor struct { - Red *int `json:"red,omitempty"` // 红 取值范围[0,255] - Green *int `json:"green,omitempty"` // 绿 取值范围[0,255] - Blue *int `json:"blue,omitempty"` // 蓝 取值范围[0,255] - Alpha *float64 `json:"alpha,omitempty"` // 透明度 取值范围[0,1] + Red *int `json:"red,omitempty"` // 红 取值范围 [0,255] + Green *int `json:"green,omitempty"` // 绿 取值范围 [0,255] + Blue *int `json:"blue,omitempty"` // 蓝 取值范围 [0,255] + Alpha *float64 `json:"alpha,omitempty"` // 透明度 取值范围 [0,1] } type ContentColorBuilder struct { - red int // 红 取值范围[0,255] + red int // 红 取值范围 [0,255] redFlag bool - green int // 绿 取值范围[0,255] + green int // 绿 取值范围 [0,255] greenFlag bool - blue int // 蓝 取值范围[0,255] + blue int // 蓝 取值范围 [0,255] blueFlag bool - alpha float64 // 透明度 取值范围[0,1] + alpha float64 // 透明度 取值范围 [0,1] alphaFlag bool } @@ -271,7 +271,7 @@ func NewContentColorBuilder() *ContentColorBuilder { return builder } -// 红 取值范围[0,255] +// 红 取值范围 [0,255] // // 示例值：216 func (builder *ContentColorBuilder) Red(red int) *ContentColorBuilder { @@ -280,7 +280,7 @@ func (builder *ContentColorBuilder) Red(red int) *ContentColorBuilder { return builder } -// 绿 取值范围[0,255] +// 绿 取值范围 [0,255] // // 示例值：191 func (builder *ContentColorBuilder) Green(green int) *ContentColorBuilder { @@ -289,7 +289,7 @@ func (builder *ContentColorBuilder) Green(green int) *ContentColorBuilder { return builder } -// 蓝 取值范围[0,255] +// 蓝 取值范围 [0,255] // // 示例值：188 func (builder *ContentColorBuilder) Blue(blue int) *ContentColorBuilder { @@ -298,7 +298,7 @@ func (builder *ContentColorBuilder) Blue(blue int) *ContentColorBuilder { return builder } -// 透明度 取值范围[0,1] +// 透明度 取值范围 [0,1] // // 示例值：0.1 func (builder *ContentColorBuilder) Alpha(alpha float64) *ContentColorBuilder { @@ -410,8 +410,8 @@ func (builder *ContentGalleryBuilder) Build() *ContentGallery { type ContentImageItem struct { FileToken *string `json:"fileToken,omitempty"` // 图片 token，通过上传图片接口获取 Src *string `json:"src,omitempty"` // 图片链接 - Width *float64 `json:"width,omitempty"` // 图片宽，单位px - Height *float64 `json:"height,omitempty"` // 图片高，单位px + Width *float64 `json:"width,omitempty"` // 图片宽，单位 px + Height *float64 `json:"height,omitempty"` // 图片高，单位 px } type ContentImageItemBuilder struct { @@ -419,9 +419,9 @@ type ContentImageItemBuilder struct { fileTokenFlag bool src string // 图片链接 srcFlag bool - width float64 // 图片宽，单位px + width float64 // 图片宽，单位 px widthFlag bool - height float64 // 图片高，单位px + height float64 // 图片高，单位 px heightFlag bool } @@ -448,7 +448,7 @@ func (builder *ContentImageItemBuilder) Src(src string) *ContentImageItemBuilder return builder } -// 图片宽，单位px +// 图片宽，单位 px // // 示例值：458 func (builder *ContentImageItemBuilder) Width(width float64) *ContentImageItemBuilder { @@ -457,7 +457,7 @@ func (builder *ContentImageItemBuilder) Width(width float64) *ContentImageItemBu return builder } -// 图片高，单位px +// 图片高，单位 px // // 示例值：372 func (builder *ContentImageItemBuilder) Height(height float64) *ContentImageItemBuilder { @@ -738,11 +738,11 @@ func (builder *ContentParagraphStyleBuilder) Build() *ContentParagraphStyle { } type ContentPerson struct { - OpenId *string `json:"openId,omitempty"` // 员工的OpenID + OpenId *string `json:"openId,omitempty"` // 员工的 OpenID } type ContentPersonBuilder struct { - openId string // 员工的OpenID + openId string // 员工的 OpenID openIdFlag bool } @@ -751,7 +751,7 @@ func NewContentPersonBuilder() *ContentPersonBuilder { return builder } -// 员工的OpenID +// 员工的 OpenID // // 示例值：ou_3bbe8a09c20e89cce9bff989ed840674 func (builder *ContentPersonBuilder) OpenId(openId string) *ContentPersonBuilder { @@ -990,12 +990,12 @@ func (builder *DummyBuilder) Build() *Dummy { } type FailedMetricItem struct { - MetricItemId *string `json:"metric_item_id,omitempty"` // 指标项ID + MetricItemId *string `json:"metric_item_id,omitempty"` // 指标项 ID Reason *string `json:"reason,omitempty"` // 失败原因 } type FailedMetricItemBuilder struct { - metricItemId string // 指标项ID + metricItemId string // 指标项 ID metricItemIdFlag bool reason string // 失败原因 reasonFlag bool @@ -1006,7 +1006,7 @@ func NewFailedMetricItemBuilder() *FailedMetricItemBuilder { return builder } -// 指标项ID +// 指标项 ID // // 示例值：7139040982003302420 func (builder *FailedMetricItemBuilder) MetricItemId(metricItemId string) *FailedMetricItemBuilder { @@ -1038,12 +1038,12 @@ func (builder *FailedMetricItemBuilder) Build() *FailedMetricItem { } type ImageInfo struct { - FileToken *string `json:"file_token,omitempty"` // 图片token + FileToken *string `json:"file_token,omitempty"` // 图片 token Url *string `json:"url,omitempty"` // 图片下载链接 } type ImageInfoBuilder struct { - fileToken string // 图片token + fileToken string // 图片 token fileTokenFlag bool url string // 图片下载链接 urlFlag bool @@ -1054,7 +1054,7 @@ func NewImageInfoBuilder() *ImageInfoBuilder { return builder } -// 图片token +// 图片 token // // 示例值：boxbcLxEnhUE3REJSAwAbVFZwPf func (builder *ImageInfoBuilder) FileToken(fileToken string) *ImageInfoBuilder { @@ -1261,25 +1261,25 @@ func (builder *KrContentBuilder) Build() *KrContent { } type MetricItem struct { - MetricItemId *string `json:"metric_item_id,omitempty"` // 指标项id - UserId *string `json:"user_id,omitempty"` // 指标承接人员id - PeriodId *string `json:"period_id,omitempty"` // 指标的okr周期 + MetricItemId *string `json:"metric_item_id,omitempty"` // 指标项 id + UserId *string `json:"user_id,omitempty"` // 指标承接人员 id + PeriodId *string `json:"period_id,omitempty"` // 指标的 okr 周期 MetricUnit *MetricUnit `json:"metric_unit,omitempty"` // 指标单位 MetricInitialValue *float64 `json:"metric_initial_value,omitempty"` // 指标起始值 MetricTargetValue *float64 `json:"metric_target_value,omitempty"` // 指标目标值 MetricCurrentValue *float64 `json:"metric_current_value,omitempty"` // 指标进度值 - SupportedUserId *string `json:"supported_user_id,omitempty"` // 指标支撑的上级人员id - KrId *string `json:"kr_id,omitempty"` // 指标关联的kr + SupportedUserId *string `json:"supported_user_id,omitempty"` // 指标支撑的上级人员 id + KrId *string `json:"kr_id,omitempty"` // 指标关联的 kr UpdatedAt *string `json:"updated_at,omitempty"` // 更新时间 UpdatedBy *string `json:"updated_by,omitempty"` // 更新人 } type MetricItemBuilder struct { - metricItemId string // 指标项id + metricItemId string // 指标项 id metricItemIdFlag bool - userId string // 指标承接人员id + userId string // 指标承接人员 id userIdFlag bool - periodId string // 指标的okr周期 + periodId string // 指标的 okr 周期 periodIdFlag bool metricUnit *MetricUnit // 指标单位 metricUnitFlag bool @@ -1289,9 +1289,9 @@ type MetricItemBuilder struct { metricTargetValueFlag bool metricCurrentValue float64 // 指标进度值 metricCurrentValueFlag bool - supportedUserId string // 指标支撑的上级人员id + supportedUserId string // 指标支撑的上级人员 id supportedUserIdFlag bool - krId string // 指标关联的kr + krId string // 指标关联的 kr krIdFlag bool updatedAt string // 更新时间 updatedAtFlag bool @@ -1304,7 +1304,7 @@ func NewMetricItemBuilder() *MetricItemBuilder { return builder } -// 指标项id +// 指标项 id // // 示例值：635782378412311 func (builder *MetricItemBuilder) MetricItemId(metricItemId string) *MetricItemBuilder { @@ -1313,7 +1313,7 @@ func (builder *MetricItemBuilder) MetricItemId(metricItemId string) *MetricItemB return builder } -// 指标承接人员id +// 指标承接人员 id // // 示例值：635782378412311 func (builder *MetricItemBuilder) UserId(userId string) *MetricItemBuilder { @@ -1322,7 +1322,7 @@ func (builder *MetricItemBuilder) UserId(userId string) *MetricItemBuilder { return builder } -// 指标的okr周期 +// 指标的 okr 周期 // // 示例值：635782378412311 func (builder *MetricItemBuilder) PeriodId(periodId string) *MetricItemBuilder { @@ -1367,7 +1367,7 @@ func (builder *MetricItemBuilder) MetricCurrentValue(metricCurrentValue float64) return builder } -// 指标支撑的上级人员id +// 指标支撑的上级人员 id // // 示例值：ou_8e7d79ca2327bf4f0b3c37899d6abbd5 func (builder *MetricItemBuilder) SupportedUserId(supportedUserId string) *MetricItemBuilder { @@ -1376,7 +1376,7 @@ func (builder *MetricItemBuilder) SupportedUserId(supportedUserId string) *Metri return builder } -// 指标关联的kr +// 指标关联的 kr // // 示例值：7139040982003302420 func (builder *MetricItemBuilder) KrId(krId string) *MetricItemBuilder { @@ -1452,7 +1452,7 @@ func (builder *MetricItemBuilder) Build() *MetricItem { } type MetricItemRequest struct { - MetricItemId *string `json:"metric_item_id,omitempty"` // 指标表id + MetricItemId *string `json:"metric_item_id,omitempty"` // 指标表 id MetricInitialValue *float64 `json:"metric_initial_value,omitempty"` // 指标起始值 MetricTargetValue *float64 `json:"metric_target_value,omitempty"` // 指标目标值 MetricCurrentValue *float64 `json:"metric_current_value,omitempty"` // 指标进度值 @@ -1460,7 +1460,7 @@ type MetricItemRequest struct { } type MetricItemRequestBuilder struct { - metricItemId string // 指标表id + metricItemId string // 指标表 id metricItemIdFlag bool metricInitialValue float64 // 指标起始值 metricInitialValueFlag bool @@ -1477,7 +1477,7 @@ func NewMetricItemRequestBuilder() *MetricItemRequestBuilder { return builder } -// 指标表id +// 指标表 id // // 示例值：635782378412311 func (builder *MetricItemRequestBuilder) MetricItemId(metricItemId string) *MetricItemRequestBuilder { @@ -1581,7 +1581,7 @@ func (builder *MetricSourceBuilder) MetricSourceId(metricSourceId string) *Metri // 指标库名称 // -// 示例值：指标库A +// 示例值：指标库 A func (builder *MetricSourceBuilder) MetricSourceName(metricSourceName string) *MetricSourceBuilder { builder.metricSourceName = metricSourceName builder.metricSourceNameFlag = true @@ -1590,7 +1590,7 @@ func (builder *MetricSourceBuilder) MetricSourceName(metricSourceName string) *M // 指标名称 // -// 示例值：指标A +// 示例值：指标 A func (builder *MetricSourceBuilder) MetricName(metricName string) *MetricSourceBuilder { builder.metricName = metricName builder.metricNameFlag = true @@ -1629,7 +1629,7 @@ func (builder *MetricSourceBuilder) Build() *MetricSource { type MetricTable struct { MetricTableId *string `json:"metric_table_id,omitempty"` // 指标表 id MetricTableName *string `json:"metric_table_name,omitempty"` // 指标表名称 - PeriodId *string `json:"period_id,omitempty"` // okr周期 + PeriodId *string `json:"period_id,omitempty"` // okr 周期 } type MetricTableBuilder struct { @@ -1637,7 +1637,7 @@ type MetricTableBuilder struct { metricTableIdFlag bool metricTableName string // 指标表名称 metricTableNameFlag bool - periodId string // okr周期 + periodId string // okr 周期 periodIdFlag bool } @@ -1657,14 +1657,14 @@ func (builder *MetricTableBuilder) MetricTableId(metricTableId string) *MetricTa // 指标表名称 // -// 示例值：指标表a +// 示例值：指标表 a func (builder *MetricTableBuilder) MetricTableName(metricTableName string) *MetricTableBuilder { builder.metricTableName = metricTableName builder.metricTableNameFlag = true return builder } -// okr周期 +// okr 周期 // // 示例值：635782378221221 func (builder *MetricTableBuilder) PeriodId(periodId string) *MetricTableBuilder { @@ -1755,8 +1755,8 @@ func (builder *MetricUnitBuilder) Build() *MetricUnit { } type Objective struct { - Id *string `json:"id,omitempty"` // 目标的ID - OkrId *string `json:"okr_id,omitempty"` // 所属的OKR ID + Id *string `json:"id,omitempty"` // 目标的 ID + OkrId *string `json:"okr_id,omitempty"` // 所属的 OKR ID UserId *string `json:"user_id,omitempty"` // 拥有者的用户 UUID Pos *string `json:"pos,omitempty"` // Objective 在所属 OKR 中的排序 Score *string `json:"score,omitempty"` // Objective 评分，返回值为百分制分数，需要除以 100 以获得 OKR 页面上显示的 1 分制分数 @@ -1770,9 +1770,9 @@ type Objective struct { } type ObjectiveBuilder struct { - id string // 目标的ID + id string // 目标的 ID idFlag bool - okrId string // 所属的OKR ID + okrId string // 所属的 OKR ID okrIdFlag bool userId string // 拥有者的用户 UUID userIdFlag bool @@ -1801,7 +1801,7 @@ func NewObjectiveBuilder() *ObjectiveBuilder { return builder } -// 目标的ID +// 目标的 ID // // 示例值： func (builder *ObjectiveBuilder) Id(id string) *ObjectiveBuilder { @@ -1810,7 +1810,7 @@ func (builder *ObjectiveBuilder) Id(id string) *ObjectiveBuilder { return builder } -// 所属的OKR ID +// 所属的 OKR ID // // 示例值： func (builder *ObjectiveBuilder) OkrId(okrId string) *ObjectiveBuilder { @@ -2196,17 +2196,17 @@ func (builder *OkrBuilder) Build() *Okr { } type OkrComment struct { - Id *string `json:"id,omitempty"` // 全局评论ID + Id *string `json:"id,omitempty"` // 全局评论 ID Content *string `json:"content,omitempty"` // 全局评论内容 CommentTime *int `json:"comment_time,omitempty"` // 全局评论时间 毫秒 Commentator *OkrObjectiveAlignedObjectiveOwner `json:"commentator,omitempty"` // 评论人员 LastModifier *OkrObjectiveAlignedObjectiveOwner `json:"last_modifier,omitempty"` // 修改评论的用户 - ContentModifyTime *int `json:"content_modify_time,omitempty"` // 评论的被修改时间 0 表示未被修改过， ms级别时间戳 - SolvedTime *int `json:"solved_time,omitempty"` // 评论被解决的时间 0 表示未解决过， ms级别时间戳 + ContentModifyTime *int `json:"content_modify_time,omitempty"` // 评论的被修改时间 0 表示未被修改过， ms 级别时间戳 + SolvedTime *int `json:"solved_time,omitempty"` // 评论被解决的时间 0 表示未解决过， ms 级别时间戳 } type OkrCommentBuilder struct { - id string // 全局评论ID + id string // 全局评论 ID idFlag bool content string // 全局评论内容 contentFlag bool @@ -2216,9 +2216,9 @@ type OkrCommentBuilder struct { commentatorFlag bool lastModifier *OkrObjectiveAlignedObjectiveOwner // 修改评论的用户 lastModifierFlag bool - contentModifyTime int // 评论的被修改时间 0 表示未被修改过， ms级别时间戳 + contentModifyTime int // 评论的被修改时间 0 表示未被修改过， ms 级别时间戳 contentModifyTimeFlag bool - solvedTime int // 评论被解决的时间 0 表示未解决过， ms级别时间戳 + solvedTime int // 评论被解决的时间 0 表示未解决过， ms 级别时间戳 solvedTimeFlag bool } @@ -2227,7 +2227,7 @@ func NewOkrCommentBuilder() *OkrCommentBuilder { return builder } -// 全局评论ID +// 全局评论 ID // // 示例值：6976173067307927084 func (builder *OkrCommentBuilder) Id(id string) *OkrCommentBuilder { @@ -2272,7 +2272,7 @@ func (builder *OkrCommentBuilder) LastModifier(lastModifier *OkrObjectiveAligned return builder } -// 评论的被修改时间 0 表示未被修改过， ms级别时间戳 +// 评论的被修改时间 0 表示未被修改过， ms 级别时间戳 // // 示例值：1624267575928 func (builder *OkrCommentBuilder) ContentModifyTime(contentModifyTime int) *OkrCommentBuilder { @@ -2281,7 +2281,7 @@ func (builder *OkrCommentBuilder) ContentModifyTime(contentModifyTime int) *OkrC return builder } -// 评论被解决的时间 0 表示未解决过， ms级别时间戳 +// 评论被解决的时间 0 表示未解决过， ms 级别时间戳 // // 示例值：1624267575928 func (builder *OkrCommentBuilder) SolvedTime(solvedTime int) *OkrCommentBuilder { @@ -2323,14 +2323,14 @@ func (builder *OkrCommentBuilder) Build() *OkrComment { type OkrObjectiveAlignment struct { Id *string `json:"id,omitempty"` // ID - ToId *string `json:"to_id,omitempty"` // 目标id + ToId *string `json:"to_id,omitempty"` // 目标 id ToType *int `json:"to_type,omitempty"` // 目标类型 } type OkrObjectiveAlignmentBuilder struct { id string // ID idFlag bool - toId string // 目标id + toId string // 目标 id toIdFlag bool toType int // 目标类型 toTypeFlag bool @@ -2350,7 +2350,7 @@ func (builder *OkrObjectiveAlignmentBuilder) Id(id string) *OkrObjectiveAlignmen return builder } -// 目标id +// 目标 id // // 示例值： func (builder *OkrObjectiveAlignmentBuilder) ToId(toId string) *OkrObjectiveAlignmentBuilder { @@ -2387,25 +2387,25 @@ func (builder *OkrObjectiveAlignmentBuilder) Build() *OkrObjectiveAlignment { type OkrBatch struct { Id *string `json:"id,omitempty"` // id - Permission *int `json:"permission,omitempty"` // OKR的访问权限 + Permission *int `json:"permission,omitempty"` // OKR 的访问权限 PeriodId *string `json:"period_id,omitempty"` // period_id Name *string `json:"name,omitempty"` // 名称 - ObjectiveList []*OkrObjective `json:"objective_list,omitempty"` // Objective列表 - ConfirmStatus *int `json:"confirm_status,omitempty"` // OKR确认状态 + ObjectiveList []*OkrObjective `json:"objective_list,omitempty"` // Objective 列表 + ConfirmStatus *int `json:"confirm_status,omitempty"` // OKR 确认状态 } type OkrBatchBuilder struct { id string // id idFlag bool - permission int // OKR的访问权限 + permission int // OKR 的访问权限 permissionFlag bool periodId string // period_id periodIdFlag bool name string // 名称 nameFlag bool - objectiveList []*OkrObjective // Objective列表 + objectiveList []*OkrObjective // Objective 列表 objectiveListFlag bool - confirmStatus int // OKR确认状态 + confirmStatus int // OKR 确认状态 confirmStatusFlag bool } @@ -2423,7 +2423,7 @@ func (builder *OkrBatchBuilder) Id(id string) *OkrBatchBuilder { return builder } -// OKR的访问权限 +// OKR 的访问权限 // // 示例值：0 func (builder *OkrBatchBuilder) Permission(permission int) *OkrBatchBuilder { @@ -2450,7 +2450,7 @@ func (builder *OkrBatchBuilder) Name(name string) *OkrBatchBuilder { return builder } -// Objective列表 +// Objective 列表 // // 示例值： func (builder *OkrBatchBuilder) ObjectiveList(objectiveList []*OkrObjective) *OkrBatchBuilder { @@ -2459,7 +2459,7 @@ func (builder *OkrBatchBuilder) ObjectiveList(objectiveList []*OkrObjective) *Ok return builder } -// OKR确认状态 +// OKR 确认状态 // // 示例值：0 func (builder *OkrBatchBuilder) ConfirmStatus(confirmStatus int) *OkrBatchBuilder { @@ -2640,8 +2640,8 @@ func (builder *OkrDetailBuilder) Build() *OkrDetail { type OkrDetailObjective struct { Id *string `json:"id,omitempty"` // Objective ID - OkrId *string `json:"okr_id,omitempty"` // 所属okr id - UserId *string `json:"user_id,omitempty"` // 用户id + OkrId *string `json:"okr_id,omitempty"` // 所属 okr id + UserId *string `json:"user_id,omitempty"` // 用户 id Pos *int `json:"pos,omitempty"` // pos Score *int `json:"score,omitempty"` // 得分 Name *OkrName `json:"name,omitempty"` // Objective 名称 @@ -2657,9 +2657,9 @@ type OkrDetailObjective struct { type OkrDetailObjectiveBuilder struct { id string // Objective ID idFlag bool - okrId string // 所属okr id + okrId string // 所属 okr id okrIdFlag bool - userId string // 用户id + userId string // 用户 id userIdFlag bool pos int // pos posFlag bool @@ -2697,7 +2697,7 @@ func (builder *OkrDetailObjectiveBuilder) Id(id string) *OkrDetailObjectiveBuild return builder } -// 所属okr id +// 所属 okr id // // 示例值：6976173067307927084 func (builder *OkrDetailObjectiveBuilder) OkrId(okrId string) *OkrDetailObjectiveBuilder { @@ -2706,7 +2706,7 @@ func (builder *OkrDetailObjectiveBuilder) OkrId(okrId string) *OkrDetailObjectiv return builder } -// 用户id +// 用户 id // // 示例值：ou_186301103180d3469a0bfd6e80977ec9 func (builder *OkrDetailObjectiveBuilder) UserId(userId string) *OkrDetailObjectiveBuilder { @@ -2858,17 +2858,17 @@ func (builder *OkrDetailObjectiveBuilder) Build() *OkrDetailObjective { } type OkrDetailObjectiveAlign struct { - Id *string `json:"id,omitempty"` // Objective的ID - OkrId *string `json:"okr_id,omitempty"` // OKR的ID - UserId *string `json:"user_id,omitempty"` // 该Objective的Owner + Id *string `json:"id,omitempty"` // Objective 的 ID + OkrId *string `json:"okr_id,omitempty"` // OKR 的 ID + UserId *string `json:"user_id,omitempty"` // 该 Objective 的 Owner } type OkrDetailObjectiveAlignBuilder struct { - id string // Objective的ID + id string // Objective 的 ID idFlag bool - okrId string // OKR的ID + okrId string // OKR 的 ID okrIdFlag bool - userId string // 该Objective的Owner + userId string // 该 Objective 的 Owner userIdFlag bool } @@ -2877,7 +2877,7 @@ func NewOkrDetailObjectiveAlignBuilder() *OkrDetailObjectiveAlignBuilder { return builder } -// Objective的ID +// Objective 的 ID // // 示例值：6975871409026975276 func (builder *OkrDetailObjectiveAlignBuilder) Id(id string) *OkrDetailObjectiveAlignBuilder { @@ -2886,7 +2886,7 @@ func (builder *OkrDetailObjectiveAlignBuilder) Id(id string) *OkrDetailObjective return builder } -// OKR的ID +// OKR 的 ID // // 示例值：6975085709464143404 func (builder *OkrDetailObjectiveAlignBuilder) OkrId(okrId string) *OkrDetailObjectiveAlignBuilder { @@ -2895,7 +2895,7 @@ func (builder *OkrDetailObjectiveAlignBuilder) OkrId(okrId string) *OkrDetailObj return builder } -// 该Objective的Owner +// 该 Objective 的 Owner // // 示例值：6975085709464143404 func (builder *OkrDetailObjectiveAlignBuilder) UserId(userId string) *OkrDetailObjectiveAlignBuilder { @@ -2924,8 +2924,8 @@ func (builder *OkrDetailObjectiveAlignBuilder) Build() *OkrDetailObjectiveAlign type OkrDetailObjectiveKr struct { Id *string `json:"id,omitempty"` // Key Result ID Pos *int `json:"pos,omitempty"` // pos - Score *int `json:"score,omitempty"` // KeyResult打分（0 - 100） - Weight *float64 `json:"weight,omitempty"` // KeyResult的权重（0 - 100）（废弃） + Score *int `json:"score,omitempty"` // KeyResult 打分（0 - 100） + Weight *float64 `json:"weight,omitempty"` // KeyResult 的权重（0 - 100）（废弃） Content *OkrName `json:"content,omitempty"` // KeyResult 内容 CreateTime *int `json:"create_time,omitempty"` // 创建时间 毫秒 ModifyTime *int `json:"modify_time,omitempty"` // 修改时间 毫秒 @@ -2936,9 +2936,9 @@ type OkrDetailObjectiveKrBuilder struct { idFlag bool pos int // pos posFlag bool - score int // KeyResult打分（0 - 100） + score int // KeyResult 打分（0 - 100） scoreFlag bool - weight float64 // KeyResult的权重（0 - 100）（废弃） + weight float64 // KeyResult 的权重（0 - 100）（废弃） weightFlag bool content *OkrName // KeyResult 内容 contentFlag bool @@ -2971,7 +2971,7 @@ func (builder *OkrDetailObjectiveKrBuilder) Pos(pos int) *OkrDetailObjectiveKrBu return builder } -// KeyResult打分（0 - 100） +// KeyResult 打分（0 - 100） // // 示例值：100 func (builder *OkrDetailObjectiveKrBuilder) Score(score int) *OkrDetailObjectiveKrBuilder { @@ -2980,7 +2980,7 @@ func (builder *OkrDetailObjectiveKrBuilder) Score(score int) *OkrDetailObjective return builder } -// KeyResult的权重（0 - 100）（废弃） +// KeyResult 的权重（0 - 100）（废弃） // // 示例值：100 func (builder *OkrDetailObjectiveKrBuilder) Weight(weight float64) *OkrDetailObjectiveKrBuilder { @@ -3148,19 +3148,19 @@ type OkrObjective struct { Content *string `json:"content,omitempty"` // Objective 内容 ProgressReport *string `json:"progress_report,omitempty"` // Objective 备注内容 Score *int `json:"score,omitempty"` // Objective 分数（0 - 100） - Weight *float64 `json:"weight,omitempty"` // Objective的权重（0 - 100） - ProgressRate *OkrObjectiveProgressRate `json:"progress_rate,omitempty"` // Objective进度 + Weight *float64 `json:"weight,omitempty"` // Objective 的权重（0 - 100） + ProgressRate *OkrObjectiveProgressRate `json:"progress_rate,omitempty"` // Objective 进度 KrList []*OkrObjectiveKr `json:"kr_list,omitempty"` // Objective KeyResult 列表 - AlignedObjectiveList []*OkrObjectiveAlignedObjective `json:"aligned_objective_list,omitempty"` // 对齐到该Objective的Objective列表 - AligningObjectiveList []*OkrObjectiveAlignedObjective `json:"aligning_objective_list,omitempty"` // 该Objective对齐到的Objective列表 - ProgressRecordList []*ProgressRecordSimplify `json:"progress_record_list,omitempty"` // 该Objective的进度列表 + AlignedObjectiveList []*OkrObjectiveAlignedObjective `json:"aligned_objective_list,omitempty"` // 对齐到该 Objective 的 Objective 列表 + AligningObjectiveList []*OkrObjectiveAlignedObjective `json:"aligning_objective_list,omitempty"` // 该 Objective 对齐到的 Objective 列表 + ProgressRecordList []*ProgressRecordSimplify `json:"progress_record_list,omitempty"` // 该 Objective 的进度列表 ProgressRatePercentLastUpdatedTime *string `json:"progress_rate_percent_last_updated_time,omitempty"` // 最后一次进度百分比更新时间 毫秒 ProgressRateStatusLastUpdatedTime *string `json:"progress_rate_status_last_updated_time,omitempty"` // 最后一次状态更新时间 毫秒 ProgressRecordLastUpdatedTime *string `json:"progress_record_last_updated_time,omitempty"` // 最后一次在侧边栏新增或者编辑进展的时间 毫秒 ProgressReportLastUpdatedTime *string `json:"progress_report_last_updated_time,omitempty"` // 最后一次编辑备注的时间 毫秒 ScoreLastUpdatedTime *string `json:"score_last_updated_time,omitempty"` // 最后一次打分更新时间 毫秒 Deadline *string `json:"deadline,omitempty"` // 截止时间 毫秒 - MentionedUserList []*OkrObjectiveAlignedObjectiveOwner `json:"mentioned_user_list,omitempty"` // 该Objective提到的人员列表 + MentionedUserList []*OkrObjectiveAlignedObjectiveOwner `json:"mentioned_user_list,omitempty"` // 该 Objective 提到的人员列表 } type OkrObjectiveBuilder struct { @@ -3174,17 +3174,17 @@ type OkrObjectiveBuilder struct { progressReportFlag bool score int // Objective 分数（0 - 100） scoreFlag bool - weight float64 // Objective的权重（0 - 100） + weight float64 // Objective 的权重（0 - 100） weightFlag bool - progressRate *OkrObjectiveProgressRate // Objective进度 + progressRate *OkrObjectiveProgressRate // Objective 进度 progressRateFlag bool krList []*OkrObjectiveKr // Objective KeyResult 列表 krListFlag bool - alignedObjectiveList []*OkrObjectiveAlignedObjective // 对齐到该Objective的Objective列表 + alignedObjectiveList []*OkrObjectiveAlignedObjective // 对齐到该 Objective 的 Objective 列表 alignedObjectiveListFlag bool - aligningObjectiveList []*OkrObjectiveAlignedObjective // 该Objective对齐到的Objective列表 + aligningObjectiveList []*OkrObjectiveAlignedObjective // 该 Objective 对齐到的 Objective 列表 aligningObjectiveListFlag bool - progressRecordList []*ProgressRecordSimplify // 该Objective的进度列表 + progressRecordList []*ProgressRecordSimplify // 该 Objective 的进度列表 progressRecordListFlag bool progressRatePercentLastUpdatedTime string // 最后一次进度百分比更新时间 毫秒 progressRatePercentLastUpdatedTimeFlag bool @@ -3198,7 +3198,7 @@ type OkrObjectiveBuilder struct { scoreLastUpdatedTimeFlag bool deadline string // 截止时间 毫秒 deadlineFlag bool - mentionedUserList []*OkrObjectiveAlignedObjectiveOwner // 该Objective提到的人员列表 + mentionedUserList []*OkrObjectiveAlignedObjectiveOwner // 该 Objective 提到的人员列表 mentionedUserListFlag bool } @@ -3252,7 +3252,7 @@ func (builder *OkrObjectiveBuilder) Score(score int) *OkrObjectiveBuilder { return builder } -// Objective的权重（0 - 100） +// Objective 的权重（0 - 100） // // 示例值：33.33 func (builder *OkrObjectiveBuilder) Weight(weight float64) *OkrObjectiveBuilder { @@ -3261,7 +3261,7 @@ func (builder *OkrObjectiveBuilder) Weight(weight float64) *OkrObjectiveBuilder return builder } -// Objective进度 +// Objective 进度 // // 示例值： func (builder *OkrObjectiveBuilder) ProgressRate(progressRate *OkrObjectiveProgressRate) *OkrObjectiveBuilder { @@ -3279,7 +3279,7 @@ func (builder *OkrObjectiveBuilder) KrList(krList []*OkrObjectiveKr) *OkrObjecti return builder } -// 对齐到该Objective的Objective列表 +// 对齐到该 Objective 的 Objective 列表 // // 示例值： func (builder *OkrObjectiveBuilder) AlignedObjectiveList(alignedObjectiveList []*OkrObjectiveAlignedObjective) *OkrObjectiveBuilder { @@ -3288,7 +3288,7 @@ func (builder *OkrObjectiveBuilder) AlignedObjectiveList(alignedObjectiveList [] return builder } -// 该Objective对齐到的Objective列表 +// 该 Objective 对齐到的 Objective 列表 // // 示例值： func (builder *OkrObjectiveBuilder) AligningObjectiveList(aligningObjectiveList []*OkrObjectiveAlignedObjective) *OkrObjectiveBuilder { @@ -3297,7 +3297,7 @@ func (builder *OkrObjectiveBuilder) AligningObjectiveList(aligningObjectiveList return builder } -// 该Objective的进度列表 +// 该 Objective 的进度列表 // // 示例值： func (builder *OkrObjectiveBuilder) ProgressRecordList(progressRecordList []*ProgressRecordSimplify) *OkrObjectiveBuilder { @@ -3360,7 +3360,7 @@ func (builder *OkrObjectiveBuilder) Deadline(deadline string) *OkrObjectiveBuild return builder } -// 该Objective提到的人员列表 +// 该 Objective 提到的人员列表 // // 示例值： func (builder *OkrObjectiveBuilder) MentionedUserList(mentionedUserList []*OkrObjectiveAlignedObjectiveOwner) *OkrObjectiveBuilder { @@ -3441,17 +3441,17 @@ func (builder *OkrObjectiveBuilder) Build() *OkrObjective { } type OkrObjectiveAlignedObjective struct { - Id *string `json:"id,omitempty"` // Objective的ID - OkrId *string `json:"okr_id,omitempty"` // OKR的ID - Owner *OkrObjectiveAlignedObjectiveOwner `json:"owner,omitempty"` // 该Objective的Owner + Id *string `json:"id,omitempty"` // Objective 的 ID + OkrId *string `json:"okr_id,omitempty"` // OKR 的 ID + Owner *OkrObjectiveAlignedObjectiveOwner `json:"owner,omitempty"` // 该 Objective 的 Owner } type OkrObjectiveAlignedObjectiveBuilder struct { - id string // Objective的ID + id string // Objective 的 ID idFlag bool - okrId string // OKR的ID + okrId string // OKR 的 ID okrIdFlag bool - owner *OkrObjectiveAlignedObjectiveOwner // 该Objective的Owner + owner *OkrObjectiveAlignedObjectiveOwner // 该 Objective 的 Owner ownerFlag bool } @@ -3460,7 +3460,7 @@ func NewOkrObjectiveAlignedObjectiveBuilder() *OkrObjectiveAlignedObjectiveBuild return builder } -// Objective的ID +// Objective 的 ID // // 示例值：1231231231213 func (builder *OkrObjectiveAlignedObjectiveBuilder) Id(id string) *OkrObjectiveAlignedObjectiveBuilder { @@ -3469,7 +3469,7 @@ func (builder *OkrObjectiveAlignedObjectiveBuilder) Id(id string) *OkrObjectiveA return builder } -// OKR的ID +// OKR 的 ID // // 示例值：12323231231213 func (builder *OkrObjectiveAlignedObjectiveBuilder) OkrId(okrId string) *OkrObjectiveAlignedObjectiveBuilder { @@ -3478,7 +3478,7 @@ func (builder *OkrObjectiveAlignedObjectiveBuilder) OkrId(okrId string) *OkrObje return builder } -// 该Objective的Owner +// 该 Objective 的 Owner // // 示例值： func (builder *OkrObjectiveAlignedObjectiveBuilder) Owner(owner *OkrObjectiveAlignedObjectiveOwner) *OkrObjectiveAlignedObjectiveBuilder { @@ -3554,18 +3554,18 @@ func (builder *OkrObjectiveAlignedObjectiveOwnerBuilder) Build() *OkrObjectiveAl type OkrObjectiveKr struct { Id *string `json:"id,omitempty"` // Key Result ID Content *string `json:"content,omitempty"` // KeyResult 内容 - Score *int `json:"score,omitempty"` // KeyResult打分（0 - 100） - Weight *int `json:"weight,omitempty"` // KeyResult权重（0 - 100）（废弃） - KrWeight *float64 `json:"kr_weight,omitempty"` // KeyResult的权重（0 - 100） - ProgressRate *OkrObjectiveProgressRate `json:"progress_rate,omitempty"` // KR进度 - ProgressRecordList []*ProgressRecordSimplify `json:"progress_record_list,omitempty"` // 该KR的进度列表 + Score *int `json:"score,omitempty"` // KeyResult 打分（0 - 100） + Weight *int `json:"weight,omitempty"` // KeyResult 权重（0 - 100）（废弃） + KrWeight *float64 `json:"kr_weight,omitempty"` // KeyResult 的权重（0 - 100） + ProgressRate *OkrObjectiveProgressRate `json:"progress_rate,omitempty"` // KR 进度 + ProgressRecordList []*ProgressRecordSimplify `json:"progress_record_list,omitempty"` // 该 KR 的进度列表 ProgressRatePercentLastUpdatedTime *string `json:"progress_rate_percent_last_updated_time,omitempty"` // 最后一次进度百分比更新时间 毫秒 ProgressRateStatusLastUpdatedTime *string `json:"progress_rate_status_last_updated_time,omitempty"` // 最后一次状态更新时间 毫秒 ProgressRecordLastUpdatedTime *string `json:"progress_record_last_updated_time,omitempty"` // 最后一次在侧边栏新增或者编辑进展的时间 毫秒 ProgressReportLastUpdatedTime *string `json:"progress_report_last_updated_time,omitempty"` // 最后一次编辑备注的时间 毫秒 ScoreLastUpdatedTime *string `json:"score_last_updated_time,omitempty"` // 最后一次打分更新时间 毫秒 Deadline *string `json:"deadline,omitempty"` // 截止时间 毫秒 - MentionedUserList []*OkrObjectiveAlignedObjectiveOwner `json:"mentioned_user_list,omitempty"` // 该Objective提到的人员列表 + MentionedUserList []*OkrObjectiveAlignedObjectiveOwner `json:"mentioned_user_list,omitempty"` // 该 Objective 提到的人员列表 } type OkrObjectiveKrBuilder struct { @@ -3573,15 +3573,15 @@ type OkrObjectiveKrBuilder struct { idFlag bool content string // KeyResult 内容 contentFlag bool - score int // KeyResult打分（0 - 100） + score int // KeyResult 打分（0 - 100） scoreFlag bool - weight int // KeyResult权重（0 - 100）（废弃） + weight int // KeyResult 权重（0 - 100）（废弃） weightFlag bool - krWeight float64 // KeyResult的权重（0 - 100） + krWeight float64 // KeyResult 的权重（0 - 100） krWeightFlag bool - progressRate *OkrObjectiveProgressRate // KR进度 + progressRate *OkrObjectiveProgressRate // KR 进度 progressRateFlag bool - progressRecordList []*ProgressRecordSimplify // 该KR的进度列表 + progressRecordList []*ProgressRecordSimplify // 该 KR 的进度列表 progressRecordListFlag bool progressRatePercentLastUpdatedTime string // 最后一次进度百分比更新时间 毫秒 progressRatePercentLastUpdatedTimeFlag bool @@ -3595,7 +3595,7 @@ type OkrObjectiveKrBuilder struct { scoreLastUpdatedTimeFlag bool deadline string // 截止时间 毫秒 deadlineFlag bool - mentionedUserList []*OkrObjectiveAlignedObjectiveOwner // 该Objective提到的人员列表 + mentionedUserList []*OkrObjectiveAlignedObjectiveOwner // 该 Objective 提到的人员列表 mentionedUserListFlag bool } @@ -3622,7 +3622,7 @@ func (builder *OkrObjectiveKrBuilder) Content(content string) *OkrObjectiveKrBui return builder } -// KeyResult打分（0 - 100） +// KeyResult 打分（0 - 100） // // 示例值：100 func (builder *OkrObjectiveKrBuilder) Score(score int) *OkrObjectiveKrBuilder { @@ -3631,7 +3631,7 @@ func (builder *OkrObjectiveKrBuilder) Score(score int) *OkrObjectiveKrBuilder { return builder } -// KeyResult权重（0 - 100）（废弃） +// KeyResult 权重（0 - 100）（废弃） // // 示例值：100 func (builder *OkrObjectiveKrBuilder) Weight(weight int) *OkrObjectiveKrBuilder { @@ -3640,7 +3640,7 @@ func (builder *OkrObjectiveKrBuilder) Weight(weight int) *OkrObjectiveKrBuilder return builder } -// KeyResult的权重（0 - 100） +// KeyResult 的权重（0 - 100） // // 示例值：33.33 func (builder *OkrObjectiveKrBuilder) KrWeight(krWeight float64) *OkrObjectiveKrBuilder { @@ -3649,7 +3649,7 @@ func (builder *OkrObjectiveKrBuilder) KrWeight(krWeight float64) *OkrObjectiveKr return builder } -// KR进度 +// KR 进度 // // 示例值： func (builder *OkrObjectiveKrBuilder) ProgressRate(progressRate *OkrObjectiveProgressRate) *OkrObjectiveKrBuilder { @@ -3658,7 +3658,7 @@ func (builder *OkrObjectiveKrBuilder) ProgressRate(progressRate *OkrObjectivePro return builder } -// 该KR的进度列表 +// 该 KR 的进度列表 // // 示例值： func (builder *OkrObjectiveKrBuilder) ProgressRecordList(progressRecordList []*ProgressRecordSimplify) *OkrObjectiveKrBuilder { @@ -3721,7 +3721,7 @@ func (builder *OkrObjectiveKrBuilder) Deadline(deadline string) *OkrObjectiveKrB return builder } -// 该Objective提到的人员列表 +// 该 Objective 提到的人员列表 // // 示例值： func (builder *OkrObjectiveKrBuilder) MentionedUserList(mentionedUserList []*OkrObjectiveAlignedObjectiveOwner) *OkrObjectiveKrBuilder { @@ -3838,13 +3838,13 @@ func (builder *OkrObjectiveProgressRateBuilder) Build() *OkrObjectiveProgressRat type OkrReview struct { UserId *OkrObjectiveAlignedObjectiveOwner `json:"user_id,omitempty"` // 复盘的用户 - ReviewPeriodList []*OkrReviewPeriod `json:"review_period_list,omitempty"` // 用户对应的OKR复盘列表 + ReviewPeriodList []*OkrReviewPeriod `json:"review_period_list,omitempty"` // 用户对应的 OKR 复盘列表 } type OkrReviewBuilder struct { userId *OkrObjectiveAlignedObjectiveOwner // 复盘的用户 userIdFlag bool - reviewPeriodList []*OkrReviewPeriod // 用户对应的OKR复盘列表 + reviewPeriodList []*OkrReviewPeriod // 用户对应的 OKR 复盘列表 reviewPeriodListFlag bool } @@ -3862,7 +3862,7 @@ func (builder *OkrReviewBuilder) UserId(userId *OkrObjectiveAlignedObjectiveOwne return builder } -// 用户对应的OKR复盘列表 +// 用户对应的 OKR 复盘列表 // // 示例值： func (builder *OkrReviewBuilder) ReviewPeriodList(reviewPeriodList []*OkrReviewPeriod) *OkrReviewBuilder { @@ -3883,13 +3883,13 @@ func (builder *OkrReviewBuilder) Build() *OkrReview { } type OkrReviewPeriod struct { - PeriodId *string `json:"period_id,omitempty"` // 周期ID + PeriodId *string `json:"period_id,omitempty"` // 周期 ID CycleReviewList []*OkrReviewPeriodUrl `json:"cycle_review_list,omitempty"` // 复盘文档 ProgressReportList []*OkrReviewPeriodUrl `json:"progress_report_list,omitempty"` // 进展报告 } type OkrReviewPeriodBuilder struct { - periodId string // 周期ID + periodId string // 周期 ID periodIdFlag bool cycleReviewList []*OkrReviewPeriodUrl // 复盘文档 cycleReviewListFlag bool @@ -3902,7 +3902,7 @@ func NewOkrReviewPeriodBuilder() *OkrReviewPeriodBuilder { return builder } -// 周期ID +// 周期 ID // // 示例值：6951461264858777132 func (builder *OkrReviewPeriodBuilder) PeriodId(periodId string) *OkrReviewPeriodBuilder { @@ -4152,14 +4152,14 @@ func (builder *PeriodBuilder) Build() *Period { } type PeriodRule struct { - PeriodRuleId *string `json:"period_rule_id,omitempty"` // 周期规则ID + PeriodRuleId *string `json:"period_rule_id,omitempty"` // 周期规则 ID Type *string `json:"type,omitempty"` // 周期类型;- year: 年度周期;- month: 月度周期 Length *int `json:"length,omitempty"` // 周期长度（月) FirstMonth *int `json:"first_month,omitempty"` // 每年首个开始月份 } type PeriodRuleBuilder struct { - periodRuleId string // 周期规则ID + periodRuleId string // 周期规则 ID periodRuleIdFlag bool type_ string // 周期类型;- year: 年度周期;- month: 月度周期 typeFlag bool @@ -4174,7 +4174,7 @@ func NewPeriodRuleBuilder() *PeriodRuleBuilder { return builder } -// 周期规则ID +// 周期规则 ID // // 示例值：134 func (builder *PeriodRuleBuilder) PeriodRuleId(periodRuleId string) *PeriodRuleBuilder { @@ -4343,13 +4343,13 @@ func (builder *ProgressRateBuilder) Build() *ProgressRate { } type ProgressRecord struct { - ProgressId *string `json:"progress_id,omitempty"` // OKR 进展ID + ProgressId *string `json:"progress_id,omitempty"` // OKR 进展 ID ModifyTime *string `json:"modify_time,omitempty"` // 进展更新时间 毫秒 Content *ContentBlock `json:"content,omitempty"` // 进展 对应的 Content 详细内容 } type ProgressRecordBuilder struct { - progressId string // OKR 进展ID + progressId string // OKR 进展 ID progressIdFlag bool modifyTime string // 进展更新时间 毫秒 modifyTimeFlag bool @@ -4362,7 +4362,7 @@ func NewProgressRecordBuilder() *ProgressRecordBuilder { return builder } -// OKR 进展ID +// OKR 进展 ID // // 示例值：7041469619902693396 func (builder *ProgressRecordBuilder) ProgressId(progressId string) *ProgressRecordBuilder { @@ -4406,11 +4406,11 @@ func (builder *ProgressRecordBuilder) Build() *ProgressRecord { } type ProgressRecordSimplify struct { - Id *string `json:"id,omitempty"` // OKR 进展记录ID + Id *string `json:"id,omitempty"` // OKR 进展记录 ID } type ProgressRecordSimplifyBuilder struct { - id string // OKR 进展记录ID + id string // OKR 进展记录 ID idFlag bool } @@ -4419,7 +4419,7 @@ func NewProgressRecordSimplifyBuilder() *ProgressRecordSimplifyBuilder { return builder } -// OKR 进展记录ID +// OKR 进展记录 ID // // 示例值：7041469619902693396 func (builder *ProgressRecordSimplifyBuilder) Id(id string) *ProgressRecordSimplifyBuilder { @@ -4438,26 +4438,26 @@ func (builder *ProgressRecordSimplifyBuilder) Build() *ProgressRecordSimplify { } type UpsertObjective struct { - Content *string `json:"content,omitempty"` // OKR内容 + Content *string `json:"content,omitempty"` // OKR 内容 MentionList []string `json:"mention_list,omitempty"` // 负责人列表 - KrList []*UpsertObjectiveKr `json:"kr_list,omitempty"` // KR列表 - ProgressRate *ProgressRate `json:"progress_rate,omitempty"` // Objective进度状态 - ProgressList []*ProgressItem `json:"progress_list,omitempty"` // Objective进度列表 - Weight *float64 `json:"weight,omitempty"` // OKR权重 + KrList []*UpsertObjectiveKr `json:"kr_list,omitempty"` // KR 列表 + ProgressRate *ProgressRate `json:"progress_rate,omitempty"` // Objective 进度状态 + ProgressList []*ProgressItem `json:"progress_list,omitempty"` // Objective 进度列表 + Weight *float64 `json:"weight,omitempty"` // OKR 权重 } type UpsertObjectiveBuilder struct { - content string // OKR内容 + content string // OKR 内容 contentFlag bool mentionList []string // 负责人列表 mentionListFlag bool - krList []*UpsertObjectiveKr // KR列表 + krList []*UpsertObjectiveKr // KR 列表 krListFlag bool - progressRate *ProgressRate // Objective进度状态 + progressRate *ProgressRate // Objective 进度状态 progressRateFlag bool - progressList []*ProgressItem // Objective进度列表 + progressList []*ProgressItem // Objective 进度列表 progressListFlag bool - weight float64 // OKR权重 + weight float64 // OKR 权重 weightFlag bool } @@ -4466,7 +4466,7 @@ func NewUpsertObjectiveBuilder() *UpsertObjectiveBuilder { return builder } -// OKR内容 +// OKR 内容 // // 示例值：okr func (builder *UpsertObjectiveBuilder) Content(content string) *UpsertObjectiveBuilder { @@ -4484,7 +4484,7 @@ func (builder *UpsertObjectiveBuilder) MentionList(mentionList []string) *Upsert return builder } -// KR列表 +// KR 列表 // // 示例值： func (builder *UpsertObjectiveBuilder) KrList(krList []*UpsertObjectiveKr) *UpsertObjectiveBuilder { @@ -4493,7 +4493,7 @@ func (builder *UpsertObjectiveBuilder) KrList(krList []*UpsertObjectiveKr) *Upse return builder } -// Objective进度状态 +// Objective 进度状态 // // 示例值： func (builder *UpsertObjectiveBuilder) ProgressRate(progressRate *ProgressRate) *UpsertObjectiveBuilder { @@ -4502,7 +4502,7 @@ func (builder *UpsertObjectiveBuilder) ProgressRate(progressRate *ProgressRate) return builder } -// Objective进度列表 +// Objective 进度列表 // // 示例值： func (builder *UpsertObjectiveBuilder) ProgressList(progressList []*ProgressItem) *UpsertObjectiveBuilder { @@ -4511,7 +4511,7 @@ func (builder *UpsertObjectiveBuilder) ProgressList(progressList []*ProgressItem return builder } -// OKR权重 +// OKR 权重 // // 示例值：100 func (builder *UpsertObjectiveBuilder) Weight(weight float64) *UpsertObjectiveBuilder { @@ -4546,26 +4546,26 @@ func (builder *UpsertObjectiveBuilder) Build() *UpsertObjective { } type UpsertObjectiveKr struct { - Content *string `json:"content,omitempty"` // OKR内容 + Content *string `json:"content,omitempty"` // OKR 内容 MentionList []string `json:"mention_list,omitempty"` // 负责人列表 Score *int `json:"score,omitempty"` // 得分 - ProgressRate *ProgressRate `json:"progress_rate,omitempty"` // Objective进度状态 - ProgressList []*ProgressItem `json:"progress_list,omitempty"` // Objective进度列表 - Weight *float64 `json:"weight,omitempty"` // OKR权重 + ProgressRate *ProgressRate `json:"progress_rate,omitempty"` // Objective 进度状态 + ProgressList []*ProgressItem `json:"progress_list,omitempty"` // Objective 进度列表 + Weight *float64 `json:"weight,omitempty"` // OKR 权重 } type UpsertObjectiveKrBuilder struct { - content string // OKR内容 + content string // OKR 内容 contentFlag bool mentionList []string // 负责人列表 mentionListFlag bool score int // 得分 scoreFlag bool - progressRate *ProgressRate // Objective进度状态 + progressRate *ProgressRate // Objective 进度状态 progressRateFlag bool - progressList []*ProgressItem // Objective进度列表 + progressList []*ProgressItem // Objective 进度列表 progressListFlag bool - weight float64 // OKR权重 + weight float64 // OKR 权重 weightFlag bool } @@ -4574,7 +4574,7 @@ func NewUpsertObjectiveKrBuilder() *UpsertObjectiveKrBuilder { return builder } -// OKR内容 +// OKR 内容 // // 示例值：okr func (builder *UpsertObjectiveKrBuilder) Content(content string) *UpsertObjectiveKrBuilder { @@ -4601,7 +4601,7 @@ func (builder *UpsertObjectiveKrBuilder) Score(score int) *UpsertObjectiveKrBuil return builder } -// Objective进度状态 +// Objective 进度状态 // // 示例值： func (builder *UpsertObjectiveKrBuilder) ProgressRate(progressRate *ProgressRate) *UpsertObjectiveKrBuilder { @@ -4610,7 +4610,7 @@ func (builder *UpsertObjectiveKrBuilder) ProgressRate(progressRate *ProgressRate return builder } -// Objective进度列表 +// Objective 进度列表 // // 示例值： func (builder *UpsertObjectiveKrBuilder) ProgressList(progressList []*ProgressItem) *UpsertObjectiveKrBuilder { @@ -4619,7 +4619,7 @@ func (builder *UpsertObjectiveKrBuilder) ProgressList(progressList []*ProgressIt return builder } -// OKR权重 +// OKR 权重 // // 示例值：100 func (builder *UpsertObjectiveKrBuilder) Weight(weight float64) *UpsertObjectiveKrBuilder { @@ -4688,19 +4688,19 @@ func (builder *UserBuilder) Build() *User { type UserOkr struct { Id *string `json:"id,omitempty"` // OKR ID - Name *string `json:"name,omitempty"` // OKR周期名称(lang指定中英文) - Permission *int `json:"permission,omitempty"` // 权限，0无权限，1有权限 - ObjectiveList []*UserOkrObjective `json:"objective_list,omitempty"` // OKR的Objective 列表 + Name *string `json:"name,omitempty"` // OKR 周期名称 (lang 指定中英文) + Permission *int `json:"permission,omitempty"` // 权限，0 无权限，1 有权限 + ObjectiveList []*UserOkrObjective `json:"objective_list,omitempty"` // OKR 的 Objective 列表 } type UserOkrBuilder struct { id string // OKR ID idFlag bool - name string // OKR周期名称(lang指定中英文) + name string // OKR 周期名称 (lang 指定中英文) nameFlag bool - permission int // 权限，0无权限，1有权限 + permission int // 权限，0 无权限，1 有权限 permissionFlag bool - objectiveList []*UserOkrObjective // OKR的Objective 列表 + objectiveList []*UserOkrObjective // OKR 的 Objective 列表 objectiveListFlag bool } @@ -4718,7 +4718,7 @@ func (builder *UserOkrBuilder) Id(id string) *UserOkrBuilder { return builder } -// OKR周期名称(lang指定中英文) +// OKR 周期名称 (lang 指定中英文) // // 示例值： func (builder *UserOkrBuilder) Name(name string) *UserOkrBuilder { @@ -4727,7 +4727,7 @@ func (builder *UserOkrBuilder) Name(name string) *UserOkrBuilder { return builder } -// 权限，0无权限，1有权限 +// 权限，0 无权限，1 有权限 // // 示例值： func (builder *UserOkrBuilder) Permission(permission int) *UserOkrBuilder { @@ -4736,7 +4736,7 @@ func (builder *UserOkrBuilder) Permission(permission int) *UserOkrBuilder { return builder } -// OKR的Objective 列表 +// OKR 的 Objective 列表 // // 示例值： func (builder *UserOkrBuilder) ObjectiveList(objectiveList []*UserOkrObjective) *UserOkrBuilder { @@ -4767,20 +4767,20 @@ func (builder *UserOkrBuilder) Build() *UserOkr { type UserOkrObjective struct { Id *string `json:"id,omitempty"` // Objective ID - Permission *int `json:"permission,omitempty"` // 权限，0无权限，1有权限 + Permission *int `json:"permission,omitempty"` // 权限，0 无权限，1 有权限 Content *string `json:"content,omitempty"` // Objective 内容 ProgressReport *string `json:"progress_report,omitempty"` // Objective 进度记录内容 Score *string `json:"score,omitempty"` // Objective 分数（0 - 100） - ProgressRate *UserOkrObjectiveProgressRate `json:"progress_rate,omitempty"` // Objective进度 + ProgressRate *UserOkrObjectiveProgressRate `json:"progress_rate,omitempty"` // Objective 进度 KrList []*UserOkrObjectiveKr `json:"kr_list,omitempty"` // Objective KeyResult 列表 - AlignedObjectiveList []*UserOkrObjectiveAlignedObjective `json:"aligned_objective_list,omitempty"` // 对齐到该Objective的Objective列表 - AligningObjectiveList []*UserOkrObjectiveAlignedObjective `json:"aligning_objective_list,omitempty"` // 该Objective对齐到的Objective列表 + AlignedObjectiveList []*UserOkrObjectiveAlignedObjective `json:"aligned_objective_list,omitempty"` // 对齐到该 Objective 的 Objective 列表 + AligningObjectiveList []*UserOkrObjectiveAlignedObjective `json:"aligning_objective_list,omitempty"` // 该 Objective 对齐到的 Objective 列表 } type UserOkrObjectiveBuilder struct { id string // Objective ID idFlag bool - permission int // 权限，0无权限，1有权限 + permission int // 权限，0 无权限，1 有权限 permissionFlag bool content string // Objective 内容 contentFlag bool @@ -4788,13 +4788,13 @@ type UserOkrObjectiveBuilder struct { progressReportFlag bool score string // Objective 分数（0 - 100） scoreFlag bool - progressRate *UserOkrObjectiveProgressRate // Objective进度 + progressRate *UserOkrObjectiveProgressRate // Objective 进度 progressRateFlag bool krList []*UserOkrObjectiveKr // Objective KeyResult 列表 krListFlag bool - alignedObjectiveList []*UserOkrObjectiveAlignedObjective // 对齐到该Objective的Objective列表 + alignedObjectiveList []*UserOkrObjectiveAlignedObjective // 对齐到该 Objective 的 Objective 列表 alignedObjectiveListFlag bool - aligningObjectiveList []*UserOkrObjectiveAlignedObjective // 该Objective对齐到的Objective列表 + aligningObjectiveList []*UserOkrObjectiveAlignedObjective // 该 Objective 对齐到的 Objective 列表 aligningObjectiveListFlag bool } @@ -4812,7 +4812,7 @@ func (builder *UserOkrObjectiveBuilder) Id(id string) *UserOkrObjectiveBuilder { return builder } -// 权限，0无权限，1有权限 +// 权限，0 无权限，1 有权限 // // 示例值： func (builder *UserOkrObjectiveBuilder) Permission(permission int) *UserOkrObjectiveBuilder { @@ -4848,7 +4848,7 @@ func (builder *UserOkrObjectiveBuilder) Score(score string) *UserOkrObjectiveBui return builder } -// Objective进度 +// Objective 进度 // // 示例值： func (builder *UserOkrObjectiveBuilder) ProgressRate(progressRate *UserOkrObjectiveProgressRate) *UserOkrObjectiveBuilder { @@ -4866,7 +4866,7 @@ func (builder *UserOkrObjectiveBuilder) KrList(krList []*UserOkrObjectiveKr) *Us return builder } -// 对齐到该Objective的Objective列表 +// 对齐到该 Objective 的 Objective 列表 // // 示例值： func (builder *UserOkrObjectiveBuilder) AlignedObjectiveList(alignedObjectiveList []*UserOkrObjectiveAlignedObjective) *UserOkrObjectiveBuilder { @@ -4875,7 +4875,7 @@ func (builder *UserOkrObjectiveBuilder) AlignedObjectiveList(alignedObjectiveLis return builder } -// 该Objective对齐到的Objective列表 +// 该 Objective 对齐到的 Objective 列表 // // 示例值： func (builder *UserOkrObjectiveBuilder) AligningObjectiveList(aligningObjectiveList []*UserOkrObjectiveAlignedObjective) *UserOkrObjectiveBuilder { @@ -4922,17 +4922,17 @@ func (builder *UserOkrObjectiveBuilder) Build() *UserOkrObjective { } type UserOkrObjectiveAlignedObjective struct { - Id *string `json:"id,omitempty"` // Objective的ID - OkrId *string `json:"okr_id,omitempty"` // OKR的ID - Owner *UserOkrObjectiveAlignedObjectiveOwner `json:"owner,omitempty"` // 该Objective的Owner + Id *string `json:"id,omitempty"` // Objective 的 ID + OkrId *string `json:"okr_id,omitempty"` // OKR 的 ID + Owner *UserOkrObjectiveAlignedObjectiveOwner `json:"owner,omitempty"` // 该 Objective 的 Owner } type UserOkrObjectiveAlignedObjectiveBuilder struct { - id string // Objective的ID + id string // Objective 的 ID idFlag bool - okrId string // OKR的ID + okrId string // OKR 的 ID okrIdFlag bool - owner *UserOkrObjectiveAlignedObjectiveOwner // 该Objective的Owner + owner *UserOkrObjectiveAlignedObjectiveOwner // 该 Objective 的 Owner ownerFlag bool } @@ -4941,7 +4941,7 @@ func NewUserOkrObjectiveAlignedObjectiveBuilder() *UserOkrObjectiveAlignedObject return builder } -// Objective的ID +// Objective 的 ID // // 示例值： func (builder *UserOkrObjectiveAlignedObjectiveBuilder) Id(id string) *UserOkrObjectiveAlignedObjectiveBuilder { @@ -4950,7 +4950,7 @@ func (builder *UserOkrObjectiveAlignedObjectiveBuilder) Id(id string) *UserOkrOb return builder } -// OKR的ID +// OKR 的 ID // // 示例值： func (builder *UserOkrObjectiveAlignedObjectiveBuilder) OkrId(okrId string) *UserOkrObjectiveAlignedObjectiveBuilder { @@ -4959,7 +4959,7 @@ func (builder *UserOkrObjectiveAlignedObjectiveBuilder) OkrId(okrId string) *Use return builder } -// 该Objective的Owner +// 该 Objective 的 Owner // // 示例值： func (builder *UserOkrObjectiveAlignedObjectiveBuilder) Owner(owner *UserOkrObjectiveAlignedObjectiveOwner) *UserOkrObjectiveAlignedObjectiveBuilder { @@ -5083,9 +5083,9 @@ func (builder *UserOkrObjectiveAlignedObjectiveOwnerBuilder) Build() *UserOkrObj type UserOkrObjectiveKr struct { Id *string `json:"id,omitempty"` // Key Result ID Content *string `json:"content,omitempty"` // KeyResult 内容 - Score *int `json:"score,omitempty"` // KeyResult打分（0 - 100） - Weight *int `json:"weight,omitempty"` // KeyResult权重（0 - 100） - ProgressRate *UserOkrObjectiveProgressRate `json:"progress_rate,omitempty"` // Objective进度 + Score *int `json:"score,omitempty"` // KeyResult 打分（0 - 100） + Weight *int `json:"weight,omitempty"` // KeyResult 权重（0 - 100） + ProgressRate *UserOkrObjectiveProgressRate `json:"progress_rate,omitempty"` // Objective 进度 } type UserOkrObjectiveKrBuilder struct { @@ -5093,11 +5093,11 @@ type UserOkrObjectiveKrBuilder struct { idFlag bool content string // KeyResult 内容 contentFlag bool - score int // KeyResult打分（0 - 100） + score int // KeyResult 打分（0 - 100） scoreFlag bool - weight int // KeyResult权重（0 - 100） + weight int // KeyResult 权重（0 - 100） weightFlag bool - progressRate *UserOkrObjectiveProgressRate // Objective进度 + progressRate *UserOkrObjectiveProgressRate // Objective 进度 progressRateFlag bool } @@ -5124,7 +5124,7 @@ func (builder *UserOkrObjectiveKrBuilder) Content(content string) *UserOkrObject return builder } -// KeyResult打分（0 - 100） +// KeyResult 打分（0 - 100） // // 示例值： func (builder *UserOkrObjectiveKrBuilder) Score(score int) *UserOkrObjectiveKrBuilder { @@ -5133,7 +5133,7 @@ func (builder *UserOkrObjectiveKrBuilder) Score(score int) *UserOkrObjectiveKrBu return builder } -// KeyResult权重（0 - 100） +// KeyResult 权重（0 - 100） // // 示例值： func (builder *UserOkrObjectiveKrBuilder) Weight(weight int) *UserOkrObjectiveKrBuilder { @@ -5142,7 +5142,7 @@ func (builder *UserOkrObjectiveKrBuilder) Weight(weight int) *UserOkrObjectiveKr return builder } -// Objective进度 +// Objective 进度 // // 示例值： func (builder *UserOkrObjectiveKrBuilder) ProgressRate(progressRate *UserOkrObjectiveProgressRate) *UserOkrObjectiveKrBuilder { @@ -5177,13 +5177,13 @@ func (builder *UserOkrObjectiveKrBuilder) Build() *UserOkrObjectiveKr { type UserOkrObjectiveProgressRate struct { Percent *int `json:"percent,omitempty"` // Objective 进度百分比 >= 0 - Status *string `json:"status,omitempty"` // Objective 进度状态,undefined 未更新,normal 正常,risky 有风险,overdue 已延期 + Status *string `json:"status,omitempty"` // Objective 进度状态，undefined 未更新，normal 正常，risky 有风险，overdue 已延期 } type UserOkrObjectiveProgressRateBuilder struct { percent int // Objective 进度百分比 >= 0 percentFlag bool - status string // Objective 进度状态,undefined 未更新,normal 正常,risky 有风险,overdue 已延期 + status string // Objective 进度状态，undefined 未更新，normal 正常，risky 有风险，overdue 已延期 statusFlag bool } @@ -5201,7 +5201,7 @@ func (builder *UserOkrObjectiveProgressRateBuilder) Percent(percent int) *UserOk return builder } -// Objective 进度状态,undefined 未更新,normal 正常,risky 有风险,overdue 已延期 +// Objective 进度状态，undefined 未更新，normal 正常，risky 有风险，overdue 已延期 // // 示例值： func (builder *UserOkrObjectiveProgressRateBuilder) Status(status string) *UserOkrObjectiveProgressRateBuilder { @@ -5226,7 +5226,7 @@ func (builder *UserOkrObjectiveProgressRateBuilder) Build() *UserOkrObjectivePro type UploadImageReqBodyBuilder struct { data io.Reader // 图片 dataFlag bool - targetId string // 图片的目标ID + targetId string // 图片的目标 ID targetIdFlag bool targetType int // 图片使用的目标类型 targetTypeFlag bool @@ -5246,7 +5246,7 @@ func (builder *UploadImageReqBodyBuilder) Data(data io.Reader) *UploadImageReqBo return builder } -// 图片的目标ID +// 图片的目标 ID // //示例值：6974586812998174252 func (builder *UploadImageReqBodyBuilder) TargetId(targetId string) *UploadImageReqBodyBuilder { @@ -5281,7 +5281,7 @@ func (builder *UploadImageReqBodyBuilder) Build() *UploadImageReqBody { type UploadImagePathReqBodyBuilder struct { dataPath string // 图片 dataPathFlag bool - targetId string // 图片的目标ID + targetId string // 图片的目标 ID targetIdFlag bool targetType int // 图片使用的目标类型 targetTypeFlag bool @@ -5301,7 +5301,7 @@ func (builder *UploadImagePathReqBodyBuilder) DataPath(dataPath string) *UploadI return builder } -// 图片的目标ID +// 图片的目标 ID // // 示例值：6974586812998174252 func (builder *UploadImagePathReqBodyBuilder) TargetId(targetId string) *UploadImagePathReqBodyBuilder { @@ -5366,7 +5366,7 @@ func (builder *UploadImageReqBuilder) Build() *UploadImageReq { type UploadImageReqBody struct { Data io.Reader `json:"data,omitempty"` // 图片 - TargetId *string `json:"target_id,omitempty"` // 图片的目标ID + TargetId *string `json:"target_id,omitempty"` // 图片的目标 ID TargetType *int `json:"target_type,omitempty"` // 图片使用的目标类型 } @@ -5376,7 +5376,7 @@ type UploadImageReq struct { } type UploadImageRespData struct { - FileToken *string `json:"file_token,omitempty"` // 图片token + FileToken *string `json:"file_token,omitempty"` // 图片 token Url *string `json:"url,omitempty"` // 图片下载链接 } @@ -5403,7 +5403,7 @@ func NewListMetricSourceReqBuilder() *ListMetricSourceReqBuilder { return builder } -// 页码标识，获取第一页传空，每次查询会返回下一页的page_token +// 页码标识，获取第一页传空，每次查询会返回下一页的 page_token // // 示例值：6969864184272078374 func (builder *ListMetricSourceReqBuilder) PageToken(pageToken string) *ListMetricSourceReqBuilder { @@ -5460,7 +5460,7 @@ func NewListMetricSourceTableReqBuilder() *ListMetricSourceTableReqBuilder { return builder } -// okr指标库id +// okr 指标库 id // // 示例值：7041857032248410131 func (builder *ListMetricSourceTableReqBuilder) MetricSourceId(metricSourceId string) *ListMetricSourceTableReqBuilder { @@ -5468,7 +5468,7 @@ func (builder *ListMetricSourceTableReqBuilder) MetricSourceId(metricSourceId st return builder } -// 页码标识，获取第一页传空，每次查询会返回下一页的page_token +// 页码标识，获取第一页传空，每次查询会返回下一页的 page_token // // 示例值：6969864184272078374 func (builder *ListMetricSourceTableReqBuilder) PageToken(pageToken string) *ListMetricSourceTableReqBuilder { @@ -5581,7 +5581,7 @@ func NewBatchUpdateMetricSourceTableItemReqBuilder() *BatchUpdateMetricSourceTab return builder } -// okr指标库id +// okr 指标库 id // // 示例值：7041857032248410131 func (builder *BatchUpdateMetricSourceTableItemReqBuilder) MetricSourceId(metricSourceId string) *BatchUpdateMetricSourceTableItemReqBuilder { @@ -5589,7 +5589,7 @@ func (builder *BatchUpdateMetricSourceTableItemReqBuilder) MetricSourceId(metric return builder } -// okr指标表id +// okr 指标表 id // // 示例值：7041857032248410131 func (builder *BatchUpdateMetricSourceTableItemReqBuilder) MetricTableId(metricTableId string) *BatchUpdateMetricSourceTableItemReqBuilder { @@ -5597,7 +5597,7 @@ func (builder *BatchUpdateMetricSourceTableItemReqBuilder) MetricTableId(metricT return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchUpdateMetricSourceTableItemReqBuilder) UserIdType(userIdType string) *BatchUpdateMetricSourceTableItemReqBuilder { @@ -5657,7 +5657,7 @@ func NewGetMetricSourceTableItemReqBuilder() *GetMetricSourceTableItemReqBuilder return builder } -// okr指标库id +// okr 指标库 id // // 示例值：7041857032248410131 func (builder *GetMetricSourceTableItemReqBuilder) MetricSourceId(metricSourceId string) *GetMetricSourceTableItemReqBuilder { @@ -5665,7 +5665,7 @@ func (builder *GetMetricSourceTableItemReqBuilder) MetricSourceId(metricSourceId return builder } -// okr指标表id +// okr 指标表 id // // 示例值：7041857032248410131 func (builder *GetMetricSourceTableItemReqBuilder) MetricTableId(metricTableId string) *GetMetricSourceTableItemReqBuilder { @@ -5673,7 +5673,7 @@ func (builder *GetMetricSourceTableItemReqBuilder) MetricTableId(metricTableId s return builder } -// okr指标项id +// okr 指标项 id // // 示例值：7041857032248410131 func (builder *GetMetricSourceTableItemReqBuilder) MetricItemId(metricItemId string) *GetMetricSourceTableItemReqBuilder { @@ -5681,7 +5681,7 @@ func (builder *GetMetricSourceTableItemReqBuilder) MetricItemId(metricItemId str return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetMetricSourceTableItemReqBuilder) UserIdType(userIdType string) *GetMetricSourceTableItemReqBuilder { @@ -5702,15 +5702,15 @@ type GetMetricSourceTableItemReq struct { } type GetMetricSourceTableItemRespData struct { - MetricItemId *string `json:"metric_item_id,omitempty"` // 指标表id - UserId *string `json:"user_id,omitempty"` // 指标承接人员id - PeriodId *string `json:"period_id,omitempty"` // 指标的okr周期 + MetricItemId *string `json:"metric_item_id,omitempty"` // 指标表 id + UserId *string `json:"user_id,omitempty"` // 指标承接人员 id + PeriodId *string `json:"period_id,omitempty"` // 指标的 okr 周期 MetricUnit *MetricUnit `json:"metric_unit,omitempty"` // 指标单位 MetricInitialValue *float64 `json:"metric_initial_value,omitempty"` // 指标起始值 MetricTargetValue *float64 `json:"metric_target_value,omitempty"` // 指标目标值 MetricCurrentValue *float64 `json:"metric_current_value,omitempty"` // 指标进度值 - SupportedUserId *string `json:"supported_user_id,omitempty"` // 指标支撑的上级人员id - KrId *string `json:"kr_id,omitempty"` // 指标关联的kr + SupportedUserId *string `json:"supported_user_id,omitempty"` // 指标支撑的上级人员 id + KrId *string `json:"kr_id,omitempty"` // 指标关联的 kr UpdatedAt *string `json:"updated_at,omitempty"` // 更新时间 UpdatedBy *string `json:"updated_by,omitempty"` // 更新人 } @@ -5738,7 +5738,7 @@ func NewListMetricSourceTableItemReqBuilder() *ListMetricSourceTableItemReqBuild return builder } -// okr指标库id +// okr 指标库 id // // 示例值：7041857032248410131 func (builder *ListMetricSourceTableItemReqBuilder) MetricSourceId(metricSourceId string) *ListMetricSourceTableItemReqBuilder { @@ -5746,7 +5746,7 @@ func (builder *ListMetricSourceTableItemReqBuilder) MetricSourceId(metricSourceI return builder } -// okr指标表id +// okr 指标表 id // // 示例值：7041857032248410131 func (builder *ListMetricSourceTableItemReqBuilder) MetricTableId(metricTableId string) *ListMetricSourceTableItemReqBuilder { @@ -5754,7 +5754,7 @@ func (builder *ListMetricSourceTableItemReqBuilder) MetricTableId(metricTableId return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListMetricSourceTableItemReqBuilder) UserIdType(userIdType string) *ListMetricSourceTableItemReqBuilder { @@ -5762,7 +5762,7 @@ func (builder *ListMetricSourceTableItemReqBuilder) UserIdType(userIdType string return builder } -// 页码标识，获取第一页传空，每次查询会返回下一页的page_token +// 页码标识，获取第一页传空，每次查询会返回下一页的 page_token // // 示例值：6969864184272078374 func (builder *ListMetricSourceTableItemReqBuilder) PageToken(pageToken string) *ListMetricSourceTableItemReqBuilder { @@ -5959,7 +5959,7 @@ func NewPatchMetricSourceTableItemReqBuilder() *PatchMetricSourceTableItemReqBui return builder } -// okr指标库id +// okr 指标库 id // // 示例值：7041857032248410131 func (builder *PatchMetricSourceTableItemReqBuilder) MetricSourceId(metricSourceId string) *PatchMetricSourceTableItemReqBuilder { @@ -5967,7 +5967,7 @@ func (builder *PatchMetricSourceTableItemReqBuilder) MetricSourceId(metricSource return builder } -// okr指标表id +// okr 指标表 id // // 示例值：7041857032248410131 func (builder *PatchMetricSourceTableItemReqBuilder) MetricTableId(metricTableId string) *PatchMetricSourceTableItemReqBuilder { @@ -5975,7 +5975,7 @@ func (builder *PatchMetricSourceTableItemReqBuilder) MetricTableId(metricTableId return builder } -// okr指标项id +// okr 指标项 id // // 示例值：7041857032248410131 func (builder *PatchMetricSourceTableItemReqBuilder) MetricItemId(metricItemId string) *PatchMetricSourceTableItemReqBuilder { @@ -5983,7 +5983,7 @@ func (builder *PatchMetricSourceTableItemReqBuilder) MetricItemId(metricItemId s return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchMetricSourceTableItemReqBuilder) UserIdType(userIdType string) *PatchMetricSourceTableItemReqBuilder { @@ -6019,15 +6019,15 @@ type PatchMetricSourceTableItemReq struct { } type PatchMetricSourceTableItemRespData struct { - MetricItemId *string `json:"metric_item_id,omitempty"` // 指标表id - UserId *string `json:"user_id,omitempty"` // 指标承接人员id - PeriodId *string `json:"period_id,omitempty"` // 指标的okr周期 + MetricItemId *string `json:"metric_item_id,omitempty"` // 指标表 id + UserId *string `json:"user_id,omitempty"` // 指标承接人员 id + PeriodId *string `json:"period_id,omitempty"` // 指标的 okr 周期 MetricUnit *MetricUnit `json:"metric_unit,omitempty"` // 指标单位 MetricInitialValue *float64 `json:"metric_initial_value,omitempty"` // 指标起始值 MetricTargetValue *float64 `json:"metric_target_value,omitempty"` // 指标目标值 MetricCurrentValue *float64 `json:"metric_current_value,omitempty"` // 指标进度值 - SupportedUserId *string `json:"supported_user_id,omitempty"` // 指标支撑的上级人员id - KrId *string `json:"kr_id,omitempty"` // 指标关联的kr + SupportedUserId *string `json:"supported_user_id,omitempty"` // 指标支撑的上级人员 id + KrId *string `json:"kr_id,omitempty"` // 指标关联的 kr UpdatedAt *string `json:"updated_at,omitempty"` // 更新时间 UpdatedBy *string `json:"updated_by,omitempty"` // 更新人 } @@ -6055,7 +6055,7 @@ func NewBatchGetOkrReqBuilder() *BatchGetOkrReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchGetOkrReqBuilder) UserIdType(userIdType string) *BatchGetOkrReqBuilder { @@ -6063,7 +6063,7 @@ func (builder *BatchGetOkrReqBuilder) UserIdType(userIdType string) *BatchGetOkr return builder } -// OKR ID 列表，最多10个 +// OKR ID 列表，最多 10 个 // // 示例值：7043693679567028244 func (builder *BatchGetOkrReqBuilder) OkrIds(okrIds []string) *BatchGetOkrReqBuilder { @@ -6073,7 +6073,7 @@ func (builder *BatchGetOkrReqBuilder) OkrIds(okrIds []string) *BatchGetOkrReqBui return builder } -// 请求OKR的语言版本（比如@的人名），lang=en_us/zh_cn，请求 Query中 +// 请求 OKR 的语言版本（比如 @的人名），lang=en_us/zh_cn，请求 Query 中 // // 示例值：zh_cn func (builder *BatchGetOkrReqBuilder) Lang(lang string) *BatchGetOkrReqBuilder { @@ -6119,7 +6119,7 @@ func NewListPeriodReqBuilder() *ListPeriodReqBuilder { return builder } -// 分页标志page_token +// 分页标志 page_token // // 示例值：xaasdasdax func (builder *ListPeriodReqBuilder) PageToken(pageToken string) *ListPeriodReqBuilder { @@ -6127,7 +6127,7 @@ func (builder *ListPeriodReqBuilder) PageToken(pageToken string) *ListPeriodReqB return builder } -// 分页大小，默认10 +// 分页大小，默认 10 // // 示例值：10 func (builder *ListPeriodReqBuilder) PageSize(pageSize int) *ListPeriodReqBuilder { @@ -6167,15 +6167,15 @@ type CreateProgressRecordReqBodyBuilder struct { sourceTitleFlag bool sourceUrl string // 进展来源链接 sourceUrlFlag bool - targetId string // 目标id，与target_type对应 + targetId string // 目标 id，与 target_type 对应 targetIdFlag bool targetType int // 目标类型 targetTypeFlag bool content *ContentBlock // 进展详情 富文本格式 contentFlag bool - sourceUrlPc string // pc进展来源链接 + sourceUrlPc string // pc 进展来源链接 sourceUrlPcFlag bool - sourceUrlMobile string // mobile进展来源链接 + sourceUrlMobile string // mobile 进展来源链接 sourceUrlMobileFlag bool } @@ -6202,7 +6202,7 @@ func (builder *CreateProgressRecordReqBodyBuilder) SourceUrl(sourceUrl string) * return builder } -// 目标id，与target_type对应 +// 目标 id，与 target_type 对应 // //示例值：7041430377642082323 func (builder *CreateProgressRecordReqBodyBuilder) TargetId(targetId string) *CreateProgressRecordReqBodyBuilder { @@ -6229,7 +6229,7 @@ func (builder *CreateProgressRecordReqBodyBuilder) Content(content *ContentBlock return builder } -// pc进展来源链接 +// pc 进展来源链接 // //示例值：open.feishu.cn func (builder *CreateProgressRecordReqBodyBuilder) SourceUrlPc(sourceUrlPc string) *CreateProgressRecordReqBodyBuilder { @@ -6238,7 +6238,7 @@ func (builder *CreateProgressRecordReqBodyBuilder) SourceUrlPc(sourceUrlPc strin return builder } -// mobile进展来源链接 +// mobile 进展来源链接 // //示例值：open.feishu.cn func (builder *CreateProgressRecordReqBodyBuilder) SourceUrlMobile(sourceUrlMobile string) *CreateProgressRecordReqBodyBuilder { @@ -6278,15 +6278,15 @@ type CreateProgressRecordPathReqBodyBuilder struct { sourceTitleFlag bool sourceUrl string // 进展来源链接 sourceUrlFlag bool - targetId string // 目标id，与target_type对应 + targetId string // 目标 id，与 target_type 对应 targetIdFlag bool targetType int // 目标类型 targetTypeFlag bool content *ContentBlock // 进展详情 富文本格式 contentFlag bool - sourceUrlPc string // pc进展来源链接 + sourceUrlPc string // pc 进展来源链接 sourceUrlPcFlag bool - sourceUrlMobile string // mobile进展来源链接 + sourceUrlMobile string // mobile 进展来源链接 sourceUrlMobileFlag bool } @@ -6313,7 +6313,7 @@ func (builder *CreateProgressRecordPathReqBodyBuilder) SourceUrl(sourceUrl strin return builder } -// 目标id，与target_type对应 +// 目标 id，与 target_type 对应 // // 示例值：7041430377642082323 func (builder *CreateProgressRecordPathReqBodyBuilder) TargetId(targetId string) *CreateProgressRecordPathReqBodyBuilder { @@ -6340,7 +6340,7 @@ func (builder *CreateProgressRecordPathReqBodyBuilder) Content(content *ContentB return builder } -// pc进展来源链接 +// pc 进展来源链接 // // 示例值：open.feishu.cn func (builder *CreateProgressRecordPathReqBodyBuilder) SourceUrlPc(sourceUrlPc string) *CreateProgressRecordPathReqBodyBuilder { @@ -6349,7 +6349,7 @@ func (builder *CreateProgressRecordPathReqBodyBuilder) SourceUrlPc(sourceUrlPc s return builder } -// mobile进展来源链接 +// mobile 进展来源链接 // // 示例值：open.feishu.cn func (builder *CreateProgressRecordPathReqBodyBuilder) SourceUrlMobile(sourceUrlMobile string) *CreateProgressRecordPathReqBodyBuilder { @@ -6398,7 +6398,7 @@ func NewCreateProgressRecordReqBuilder() *CreateProgressRecordReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateProgressRecordReqBuilder) UserIdType(userIdType string) *CreateProgressRecordReqBuilder { @@ -6406,7 +6406,7 @@ func (builder *CreateProgressRecordReqBuilder) UserIdType(userIdType string) *Cr return builder } -// 创建OKR进展记录 +// 创建 OKR 进展记录 func (builder *CreateProgressRecordReqBuilder) Body(body *CreateProgressRecordReqBody) *CreateProgressRecordReqBuilder { builder.body = body return builder @@ -6423,11 +6423,11 @@ func (builder *CreateProgressRecordReqBuilder) Build() *CreateProgressRecordReq type CreateProgressRecordReqBody struct { SourceTitle *string `json:"source_title,omitempty"` // 进展来源 SourceUrl *string `json:"source_url,omitempty"` // 进展来源链接 - TargetId *string `json:"target_id,omitempty"` // 目标id，与target_type对应 + TargetId *string `json:"target_id,omitempty"` // 目标 id，与 target_type 对应 TargetType *int `json:"target_type,omitempty"` // 目标类型 Content *ContentBlock `json:"content,omitempty"` // 进展详情 富文本格式 - SourceUrlPc *string `json:"source_url_pc,omitempty"` // pc进展来源链接 - SourceUrlMobile *string `json:"source_url_mobile,omitempty"` // mobile进展来源链接 + SourceUrlPc *string `json:"source_url_pc,omitempty"` // pc 进展来源链接 + SourceUrlMobile *string `json:"source_url_mobile,omitempty"` // mobile 进展来源链接 } type CreateProgressRecordReq struct { @@ -6436,7 +6436,7 @@ type CreateProgressRecordReq struct { } type CreateProgressRecordRespData struct { - ProgressId *string `json:"progress_id,omitempty"` // OKR 进展ID + ProgressId *string `json:"progress_id,omitempty"` // OKR 进展 ID ModifyTime *string `json:"modify_time,omitempty"` // 进展更新时间 毫秒 Content *ContentBlock `json:"content,omitempty"` // 进展 对应的 Content 详细内容 } @@ -6464,7 +6464,7 @@ func NewDeleteProgressRecordReqBuilder() *DeleteProgressRecordReqBuilder { return builder } -// 待删除的 OKR进展记录 ID +// 待删除的 OKR 进展记录 ID // // 示例值：7041857032248410131 func (builder *DeleteProgressRecordReqBuilder) ProgressId(progressId string) *DeleteProgressRecordReqBuilder { @@ -6505,7 +6505,7 @@ func NewGetProgressRecordReqBuilder() *GetProgressRecordReqBuilder { return builder } -// 待查询的 OKR进展记录 ID +// 待查询的 OKR 进展记录 ID // // 示例值：7041857032248410131 func (builder *GetProgressRecordReqBuilder) ProgressId(progressId string) *GetProgressRecordReqBuilder { @@ -6513,7 +6513,7 @@ func (builder *GetProgressRecordReqBuilder) ProgressId(progressId string) *GetPr return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetProgressRecordReqBuilder) UserIdType(userIdType string) *GetProgressRecordReqBuilder { @@ -6534,7 +6534,7 @@ type GetProgressRecordReq struct { } type GetProgressRecordRespData struct { - ProgressId *string `json:"progress_id,omitempty"` // OKR 进展ID + ProgressId *string `json:"progress_id,omitempty"` // OKR 进展 ID ModifyTime *string `json:"modify_time,omitempty"` // 进展更新时间 毫秒 Content *ContentBlock `json:"content,omitempty"` // 进展 对应的 Content 详细内容 } @@ -6617,7 +6617,7 @@ func NewUpdateProgressRecordReqBuilder() *UpdateProgressRecordReqBuilder { return builder } -// 待更新的 OKR进展记录 ID +// 待更新的 OKR 进展记录 ID // // 示例值：7041857032248410131 func (builder *UpdateProgressRecordReqBuilder) ProgressId(progressId string) *UpdateProgressRecordReqBuilder { @@ -6625,7 +6625,7 @@ func (builder *UpdateProgressRecordReqBuilder) ProgressId(progressId string) *Up return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateProgressRecordReqBuilder) UserIdType(userIdType string) *UpdateProgressRecordReqBuilder { @@ -6633,7 +6633,7 @@ func (builder *UpdateProgressRecordReqBuilder) UserIdType(userIdType string) *Up return builder } -// 根据OKR进展记录ID更新进展详情 +// 根据 OKR 进展记录 ID 更新进展详情 func (builder *UpdateProgressRecordReqBuilder) Body(body *UpdateProgressRecordReqBody) *UpdateProgressRecordReqBuilder { builder.body = body return builder @@ -6658,7 +6658,7 @@ type UpdateProgressRecordReq struct { } type UpdateProgressRecordRespData struct { - ProgressId *string `json:"progress_id,omitempty"` // OKR 进展ID + ProgressId *string `json:"progress_id,omitempty"` // OKR 进展 ID ModifyTime *string `json:"modify_time,omitempty"` // 进展更新时间 毫秒 Content *ContentBlock `json:"content,omitempty"` // 进展 对应的 Content 详细内容 } @@ -6686,7 +6686,7 @@ func NewListUserOkrReqBuilder() *ListUserOkrReqBuilder { return builder } -// 目标用户id +// 目标用户 id // // 示例值：ou-asdasdasdasdasd func (builder *ListUserOkrReqBuilder) UserId(userId string) *ListUserOkrReqBuilder { @@ -6694,7 +6694,7 @@ func (builder *ListUserOkrReqBuilder) UserId(userId string) *ListUserOkrReqBuild return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListUserOkrReqBuilder) UserIdType(userIdType string) *ListUserOkrReqBuilder { @@ -6718,7 +6718,7 @@ func (builder *ListUserOkrReqBuilder) Limit(limit string) *ListUserOkrReqBuilder return builder } -// 请求OKR的语言版本（比如@的人名），lang=en_us/zh_cn +// 请求 OKR 的语言版本（比如 @的人名），lang=en_us/zh_cn // // 示例值：zh_cn func (builder *ListUserOkrReqBuilder) Lang(lang string) *ListUserOkrReqBuilder { @@ -6726,7 +6726,7 @@ func (builder *ListUserOkrReqBuilder) Lang(lang string) *ListUserOkrReqBuilder { return builder } -// period_id列表，最多10个 +// period_id 列表，最多 10 个 // // 示例值：["6951461264858777132"] func (builder *ListUserOkrReqBuilder) PeriodIds(periodIds []string) *ListUserOkrReqBuilder { @@ -6749,7 +6749,7 @@ type ListUserOkrReq struct { } type ListUserOkrRespData struct { - Total *int `json:"total,omitempty"` // OKR周期总数 + Total *int `json:"total,omitempty"` // OKR 周期总数 OkrList []*OkrBatch `json:"okr_list,omitempty"` // OKR 列表 } diff --git a/service/optical_char_recognition/v1/api.go b/service/optical_char_recognition/v1/api.go index 947f48ce..b207f396 100644 --- a/service/optical_char_recognition/v1/api.go +++ b/service/optical_char_recognition/v1/api.go @@ -41,9 +41,9 @@ type image struct { // // - 单租户限流：20QPS，同租户下的应用没有限流，共享本租户的 20QPS 限流 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/optical_char_recognition-v1/image/basic_recognize +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/optical_char_recognition-v1/image/basic_recognize // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/optical_char_recognitionv1/basicRecognize_image.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/optical_char_recognitionv1/basicRecognize_image.go func (i *image) BasicRecognize(ctx context.Context, req *BasicRecognizeImageReq, options ...larkcore.RequestOptionFunc) (*BasicRecognizeImageResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/optical_char_recognition/v1/model.go b/service/optical_char_recognition/v1/model.go index e3942210..051d288f 100644 --- a/service/optical_char_recognition/v1/model.go +++ b/service/optical_char_recognition/v1/model.go @@ -32,7 +32,7 @@ func NewBasicRecognizeImageReqBodyBuilder() *BasicRecognizeImageReqBodyBuilder { // base64 后的图片数据 // -//示例值：base64后的图片二进制数据 +//示例值：base64 后的图片二进制数据 func (builder *BasicRecognizeImageReqBodyBuilder) Image(image string) *BasicRecognizeImageReqBodyBuilder { builder.image = image builder.imageFlag = true @@ -59,7 +59,7 @@ func NewBasicRecognizeImagePathReqBodyBuilder() *BasicRecognizeImagePathReqBodyB // base64 后的图片数据 // -// 示例值：base64后的图片二进制数据 +// 示例值：base64 后的图片二进制数据 func (builder *BasicRecognizeImagePathReqBodyBuilder) Image(image string) *BasicRecognizeImagePathReqBodyBuilder { builder.image = image builder.imageFlag = true diff --git a/service/passport/v1/api.go b/service/passport/v1/api.go index 0432eece..86574656 100644 --- a/service/passport/v1/api.go +++ b/service/passport/v1/api.go @@ -39,9 +39,9 @@ type session struct { // // - 该接口用于查询用户的登录信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/passport-v1/session/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/passport-v1/session/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/passportv1/query_session.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/passportv1/query_session.go func (s *session) Query(ctx context.Context, req *QuerySessionReq, options ...larkcore.RequestOptionFunc) (*QuerySessionResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/passport/v1/model.go b/service/passport/v1/model.go index dc3ce528..011eba7f 100644 --- a/service/passport/v1/model.go +++ b/service/passport/v1/model.go @@ -28,7 +28,7 @@ const ( type Credentials struct { Email *string `json:"email,omitempty"` // 邮箱 Mobile *string `json:"mobile,omitempty"` // 手机号 - UserId *string `json:"user_id,omitempty"` // 用户id + UserId *string `json:"user_id,omitempty"` // 用户 id } type CredentialsBuilder struct { @@ -36,7 +36,7 @@ type CredentialsBuilder struct { emailFlag bool mobile string // 手机号 mobileFlag bool - userId string // 用户id + userId string // 用户 id userIdFlag bool } @@ -63,7 +63,7 @@ func (builder *CredentialsBuilder) Mobile(mobile string) *CredentialsBuilder { return builder } -// 用户id +// 用户 id // // 示例值： func (builder *CredentialsBuilder) UserId(userId string) *CredentialsBuilder { @@ -93,11 +93,11 @@ type IdpCredential struct { } type IdpCredentialId struct { - IdpCredentialId *string `json:"idp_credential_id,omitempty"` // idp侧租户唯一标识 + IdpCredentialId *string `json:"idp_credential_id,omitempty"` // idp 侧租户唯一标识 } type IdpCredentialIdBuilder struct { - idpCredentialId string // idp侧租户唯一标识 + idpCredentialId string // idp 侧租户唯一标识 idpCredentialIdFlag bool } @@ -106,7 +106,7 @@ func NewIdpCredentialIdBuilder() *IdpCredentialIdBuilder { return builder } -// idp侧租户唯一标识 +// idp 侧租户唯一标识 // // 示例值： func (builder *IdpCredentialIdBuilder) IdpCredentialId(idpCredentialId string) *IdpCredentialIdBuilder { @@ -127,7 +127,7 @@ func (builder *IdpCredentialIdBuilder) Build() *IdpCredentialId { type MaskSession struct { CreateTime *string `json:"create_time,omitempty"` // 创建时间 TerminalType *int `json:"terminal_type,omitempty"` // 客户端类型 - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID } type MaskSessionBuilder struct { @@ -135,7 +135,7 @@ type MaskSessionBuilder struct { createTimeFlag bool terminalType int // 客户端类型 terminalTypeFlag bool - userId string // 用户ID + userId string // 用户 ID userIdFlag bool } @@ -162,7 +162,7 @@ func (builder *MaskSessionBuilder) TerminalType(terminalType int) *MaskSessionBu return builder } -// 用户ID +// 用户 ID // // 示例值： func (builder *MaskSessionBuilder) UserId(userId string) *MaskSessionBuilder { diff --git a/service/search/v2/api.go b/service/search/v2/api.go index f71a8b29..fc93c4a9 100644 --- a/service/search/v2/api.go +++ b/service/search/v2/api.go @@ -49,9 +49,9 @@ type schema struct { // // - 创建一个数据源 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/create_dataSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/create_dataSource.go func (d *dataSource) Create(ctx context.Context, req *CreateDataSourceReq, options ...larkcore.RequestOptionFunc) (*CreateDataSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -75,9 +75,9 @@ func (d *dataSource) Create(ctx context.Context, req *CreateDataSourceReq, optio // // - 删除一个已存在的数据源 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/delete_dataSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/delete_dataSource.go func (d *dataSource) Delete(ctx context.Context, req *DeleteDataSourceReq, options ...larkcore.RequestOptionFunc) (*DeleteDataSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -101,9 +101,9 @@ func (d *dataSource) Delete(ctx context.Context, req *DeleteDataSourceReq, optio // // - 获取已经创建的数据源 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/get_dataSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/get_dataSource.go func (d *dataSource) Get(ctx context.Context, req *GetDataSourceReq, options ...larkcore.RequestOptionFunc) (*GetDataSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -127,9 +127,9 @@ func (d *dataSource) Get(ctx context.Context, req *GetDataSourceReq, options ... // // - 批量获取创建的数据源信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/list_dataSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/list_dataSource.go func (d *dataSource) List(ctx context.Context, req *ListDataSourceReq, options ...larkcore.RequestOptionFunc) (*ListDataSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -161,9 +161,9 @@ func (d *dataSource) ListByIterator(ctx context.Context, req *ListDataSourceReq, // // - 更新一个已经存在的数据源 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/patch_dataSource.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/patch_dataSource.go func (d *dataSource) Patch(ctx context.Context, req *PatchDataSourceReq, options ...larkcore.RequestOptionFunc) (*PatchDataSourceResp, error) { // 发起请求 apiReq := req.apiReq @@ -187,9 +187,9 @@ func (d *dataSource) Patch(ctx context.Context, req *PatchDataSourceReq, options // // - 索引一条数据记录 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source-item/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source-item/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/create_dataSourceItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/create_dataSourceItem.go func (d *dataSourceItem) Create(ctx context.Context, req *CreateDataSourceItemReq, options ...larkcore.RequestOptionFunc) (*CreateDataSourceItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -213,9 +213,9 @@ func (d *dataSourceItem) Create(ctx context.Context, req *CreateDataSourceItemRe // // - 删除数据项 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source-item/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source-item/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/delete_dataSourceItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/delete_dataSourceItem.go func (d *dataSourceItem) Delete(ctx context.Context, req *DeleteDataSourceItemReq, options ...larkcore.RequestOptionFunc) (*DeleteDataSourceItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -239,9 +239,9 @@ func (d *dataSourceItem) Delete(ctx context.Context, req *DeleteDataSourceItemRe // // - 获取单个数据记录 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source-item/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/data_source-item/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/get_dataSourceItem.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/get_dataSourceItem.go func (d *dataSourceItem) Get(ctx context.Context, req *GetDataSourceItemReq, options ...larkcore.RequestOptionFunc) (*GetDataSourceItemResp, error) { // 发起请求 apiReq := req.apiReq @@ -265,9 +265,9 @@ func (d *dataSourceItem) Get(ctx context.Context, req *GetDataSourceItemReq, opt // // - 创建一个数据范式 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/create_schema.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/create_schema.go func (s *schema) Create(ctx context.Context, req *CreateSchemaReq, options ...larkcore.RequestOptionFunc) (*CreateSchemaResp, error) { // 发起请求 apiReq := req.apiReq @@ -291,9 +291,9 @@ func (s *schema) Create(ctx context.Context, req *CreateSchemaReq, options ...la // // - 删除已存在的数据范式 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/delete_schema.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/delete_schema.go func (s *schema) Delete(ctx context.Context, req *DeleteSchemaReq, options ...larkcore.RequestOptionFunc) (*DeleteSchemaResp, error) { // 发起请求 apiReq := req.apiReq @@ -317,9 +317,9 @@ func (s *schema) Delete(ctx context.Context, req *DeleteSchemaReq, options ...la // // - 获取单个数据范式 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/get_schema.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/get_schema.go func (s *schema) Get(ctx context.Context, req *GetSchemaReq, options ...larkcore.RequestOptionFunc) (*GetSchemaResp, error) { // 发起请求 apiReq := req.apiReq @@ -343,9 +343,9 @@ func (s *schema) Get(ctx context.Context, req *GetSchemaReq, options ...larkcore // // - 修改数据范式 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/schema/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/patch_schema.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/searchv2/patch_schema.go func (s *schema) Patch(ctx context.Context, req *PatchSchemaReq, options ...larkcore.RequestOptionFunc) (*PatchSchemaResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/search/v2/model.go b/service/search/v2/model.go index fc90104f..192fc8fe 100644 --- a/service/search/v2/model.go +++ b/service/search/v2/model.go @@ -42,14 +42,14 @@ const ( type Acl struct { Access *string `json:"access,omitempty"` // 权限类型，优先级：Deny > Allow。 - Value *string `json:"value,omitempty"` // 设置的权限值，例如 userID ，依赖 type 描述。;;**注**：在 type 为 user 且 access 为 allow 时，可填 "everyone" 来表示该数据项对全员可见； + Value *string `json:"value,omitempty"` // 设置的权限值，例如 userID ，依赖 type 描述。;;** 注 **：在 type 为 user 且 access 为 allow 时，可填 "everyone" 来表示该数据项对全员可见； Type *string `json:"type,omitempty"` // 权限值类型 } type AclBuilder struct { access string // 权限类型，优先级：Deny > Allow。 accessFlag bool - value string // 设置的权限值，例如 userID ，依赖 type 描述。;;**注**：在 type 为 user 且 access 为 allow 时，可填 "everyone" 来表示该数据项对全员可见； + value string // 设置的权限值，例如 userID ，依赖 type 描述。;;** 注 **：在 type 为 user 且 access 为 allow 时，可填 "everyone" 来表示该数据项对全员可见； valueFlag bool type_ string // 权限值类型 typeFlag bool @@ -69,7 +69,7 @@ func (builder *AclBuilder) Access(access string) *AclBuilder { return builder } -// 设置的权限值，例如 userID ，依赖 type 描述。;;**注**：在 type 为 user 且 access 为 allow 时，可填 "everyone" 来表示该数据项对全员可见； +// 设置的权限值，例如 userID ，依赖 type 描述。;;** 注 **：在 type 为 user 且 access 为 allow 时，可填 "everyone" 来表示该数据项对全员可见； // // 示例值：d35e3c23 func (builder *AclBuilder) Value(value string) *AclBuilder { @@ -105,17 +105,17 @@ func (builder *AclBuilder) Build() *Acl { } type BatchItemResult struct { - ItemId *string `json:"item_id,omitempty"` // 数据项ID，对应一条索引数据的ID + ItemId *string `json:"item_id,omitempty"` // 数据项 ID，对应一条索引数据的 ID IsSuccess *bool `json:"is_success,omitempty"` // 判断单条数据是否成功 - Err *string `json:"err,omitempty"` // 如果单条数据失败，表示单条数据的错误信息；如果单条数据成功被索引，则err是空字符串 + Err *string `json:"err,omitempty"` // 如果单条数据失败，表示单条数据的错误信息；如果单条数据成功被索引，则 err 是空字符串 } type BatchItemResultBuilder struct { - itemId string // 数据项ID，对应一条索引数据的ID + itemId string // 数据项 ID，对应一条索引数据的 ID itemIdFlag bool isSuccess bool // 判断单条数据是否成功 isSuccessFlag bool - err string // 如果单条数据失败，表示单条数据的错误信息；如果单条数据成功被索引，则err是空字符串 + err string // 如果单条数据失败，表示单条数据的错误信息；如果单条数据成功被索引，则 err 是空字符串 errFlag bool } @@ -124,7 +124,7 @@ func NewBatchItemResultBuilder() *BatchItemResultBuilder { return builder } -// 数据项ID，对应一条索引数据的ID +// 数据项 ID，对应一条索引数据的 ID // // 示例值： func (builder *BatchItemResultBuilder) ItemId(itemId string) *BatchItemResultBuilder { @@ -142,7 +142,7 @@ func (builder *BatchItemResultBuilder) IsSuccess(isSuccess bool) *BatchItemResul return builder } -// 如果单条数据失败，表示单条数据的错误信息；如果单条数据成功被索引，则err是空字符串 +// 如果单条数据失败，表示单条数据的错误信息；如果单条数据成功被索引，则 err 是空字符串 // // 示例值： func (builder *BatchItemResultBuilder) Err(err string) *BatchItemResultBuilder { @@ -169,32 +169,32 @@ func (builder *BatchItemResultBuilder) Build() *BatchItemResult { } type ConnectDataSource struct { - ServiceUrl *string `json:"service_url,omitempty"` // 要托管的服务API地址，例如https://open.feishu.cn/xxxx/xxxx - ProjectName *string `json:"project_name,omitempty"` // 项目地址，只能包含小写字母，如bytedance_test - DisplayName *string `json:"display_name,omitempty"` // datasource名称，会展示在飞书搜索分类按钮（searchTab）中，如：公司wiki - Description *string `json:"description,omitempty"` // 描述datasource + ServiceUrl *string `json:"service_url,omitempty"` // 要托管的服务 API 地址，例如 https://open.feishu.cn/xxxx/xxxx + ProjectName *string `json:"project_name,omitempty"` // 项目地址，只能包含小写字母，如 bytedance_test + DisplayName *string `json:"display_name,omitempty"` // datasource 名称，会展示在飞书搜索分类按钮（searchTab）中，如：公司 wiki + Description *string `json:"description,omitempty"` // 描述 datasource IconUrl *string `json:"icon_url,omitempty"` // 图标 - ProjectDescription *string `json:"project_description,omitempty"` // 托管api的描述 - ContactEmail *string `json:"contact_email,omitempty"` // 联系人邮箱，开发人员的邮箱，用于托管API的SLA（Service Level Agreement）问题沟通 - TenantName *string `json:"tenant_name,omitempty"` // 创建api的组织名称，对企业开发者来说，建议使用企业名称 + ProjectDescription *string `json:"project_description,omitempty"` // 托管 api 的描述 + ContactEmail *string `json:"contact_email,omitempty"` // 联系人邮箱，开发人员的邮箱，用于托管 API 的 SLA（Service Level Agreement）问题沟通 + TenantName *string `json:"tenant_name,omitempty"` // 创建 api 的组织名称，对企业开发者来说，建议使用企业名称 } type ConnectDataSourceBuilder struct { - serviceUrl string // 要托管的服务API地址，例如https://open.feishu.cn/xxxx/xxxx + serviceUrl string // 要托管的服务 API 地址，例如 https://open.feishu.cn/xxxx/xxxx serviceUrlFlag bool - projectName string // 项目地址，只能包含小写字母，如bytedance_test + projectName string // 项目地址，只能包含小写字母，如 bytedance_test projectNameFlag bool - displayName string // datasource名称，会展示在飞书搜索分类按钮（searchTab）中，如：公司wiki + displayName string // datasource 名称，会展示在飞书搜索分类按钮（searchTab）中，如：公司 wiki displayNameFlag bool - description string // 描述datasource + description string // 描述 datasource descriptionFlag bool iconUrl string // 图标 iconUrlFlag bool - projectDescription string // 托管api的描述 + projectDescription string // 托管 api 的描述 projectDescriptionFlag bool - contactEmail string // 联系人邮箱，开发人员的邮箱，用于托管API的SLA（Service Level Agreement）问题沟通 + contactEmail string // 联系人邮箱，开发人员的邮箱，用于托管 API 的 SLA（Service Level Agreement）问题沟通 contactEmailFlag bool - tenantName string // 创建api的组织名称，对企业开发者来说，建议使用企业名称 + tenantName string // 创建 api 的组织名称，对企业开发者来说，建议使用企业名称 tenantNameFlag bool } @@ -203,7 +203,7 @@ func NewConnectDataSourceBuilder() *ConnectDataSourceBuilder { return builder } -// 要托管的服务API地址，例如https://open.feishu.cn/xxxx/xxxx +// 要托管的服务 API 地址，例如 https://open.feishu.cn/xxxx/xxxx // // 示例值： func (builder *ConnectDataSourceBuilder) ServiceUrl(serviceUrl string) *ConnectDataSourceBuilder { @@ -212,7 +212,7 @@ func (builder *ConnectDataSourceBuilder) ServiceUrl(serviceUrl string) *ConnectD return builder } -// 项目地址，只能包含小写字母，如bytedance_test +// 项目地址，只能包含小写字母，如 bytedance_test // // 示例值： func (builder *ConnectDataSourceBuilder) ProjectName(projectName string) *ConnectDataSourceBuilder { @@ -221,7 +221,7 @@ func (builder *ConnectDataSourceBuilder) ProjectName(projectName string) *Connec return builder } -// datasource名称，会展示在飞书搜索分类按钮（searchTab）中，如：公司wiki +// datasource 名称，会展示在飞书搜索分类按钮（searchTab）中，如：公司 wiki // // 示例值： func (builder *ConnectDataSourceBuilder) DisplayName(displayName string) *ConnectDataSourceBuilder { @@ -230,7 +230,7 @@ func (builder *ConnectDataSourceBuilder) DisplayName(displayName string) *Connec return builder } -// 描述datasource +// 描述 datasource // // 示例值： func (builder *ConnectDataSourceBuilder) Description(description string) *ConnectDataSourceBuilder { @@ -248,7 +248,7 @@ func (builder *ConnectDataSourceBuilder) IconUrl(iconUrl string) *ConnectDataSou return builder } -// 托管api的描述 +// 托管 api 的描述 // // 示例值： func (builder *ConnectDataSourceBuilder) ProjectDescription(projectDescription string) *ConnectDataSourceBuilder { @@ -257,7 +257,7 @@ func (builder *ConnectDataSourceBuilder) ProjectDescription(projectDescription s return builder } -// 联系人邮箱，开发人员的邮箱，用于托管API的SLA（Service Level Agreement）问题沟通 +// 联系人邮箱，开发人员的邮箱，用于托管 API 的 SLA（Service Level Agreement）问题沟通 // // 示例值： func (builder *ConnectDataSourceBuilder) ContactEmail(contactEmail string) *ConnectDataSourceBuilder { @@ -266,7 +266,7 @@ func (builder *ConnectDataSourceBuilder) ContactEmail(contactEmail string) *Conn return builder } -// 创建api的组织名称，对企业开发者来说，建议使用企业名称 +// 创建 api 的组织名称，对企业开发者来说，建议使用企业名称 // // 示例值： func (builder *ConnectDataSourceBuilder) TenantName(tenantName string) *ConnectDataSourceBuilder { @@ -314,33 +314,33 @@ func (builder *ConnectDataSourceBuilder) Build() *ConnectDataSource { type DataSource struct { Id *string `json:"id,omitempty"` // 数据源的唯一标识 - Name *string `json:"name,omitempty"` // data_source的展示名称 + Name *string `json:"name,omitempty"` // data_source 的展示名称 State *int `json:"state,omitempty"` // 数据源状态，0-已上线，1-未上线。如果未填，默认是未上线状态。 Description *string `json:"description,omitempty"` // 对于数据源的描述 - CreateTime *string `json:"create_time,omitempty"` // 创建时间，使用Unix时间戳，单位为“秒” - UpdateTime *string `json:"update_time,omitempty"` // 更新时间，使用Unix时间戳，单位为“秒” + CreateTime *string `json:"create_time,omitempty"` // 创建时间，使用 Unix 时间戳，单位为 “秒” + UpdateTime *string `json:"update_time,omitempty"` // 更新时间，使用 Unix 时间戳，单位为 “秒” IsExceedQuota *bool `json:"is_exceed_quota,omitempty"` // 是否超限 IconUrl *string `json:"icon_url,omitempty"` // 数据源在 search tab 上的展示图标路径 Template *string `json:"template,omitempty"` // 数据源采用的展示模版名称 - SearchableFields []string `json:"searchable_fields,omitempty"` // 【已废弃，如有定制需要请使用“数据范式”接口】描述哪些字段可以被搜索 + SearchableFields []string `json:"searchable_fields,omitempty"` //【已废弃，如有定制需要请使用 “数据范式” 接口】描述哪些字段可以被搜索 I18nName *I18nMeta `json:"i18n_name,omitempty"` // 数据源的国际化展示名称 I18nDescription *I18nMeta `json:"i18n_description,omitempty"` // 数据源的国际化描述 SchemaId *string `json:"schema_id,omitempty"` // 数据源关联的 schema 标识 - AppId *string `json:"app_id,omitempty"` // datasource对应的开放平台应用id + AppId *string `json:"app_id,omitempty"` // datasource 对应的开放平台应用 id } type DataSourceBuilder struct { id string // 数据源的唯一标识 idFlag bool - name string // data_source的展示名称 + name string // data_source 的展示名称 nameFlag bool state int // 数据源状态，0-已上线，1-未上线。如果未填，默认是未上线状态。 stateFlag bool description string // 对于数据源的描述 descriptionFlag bool - createTime string // 创建时间，使用Unix时间戳，单位为“秒” + createTime string // 创建时间，使用 Unix 时间戳，单位为 “秒” createTimeFlag bool - updateTime string // 更新时间，使用Unix时间戳，单位为“秒” + updateTime string // 更新时间，使用 Unix 时间戳，单位为 “秒” updateTimeFlag bool isExceedQuota bool // 是否超限 isExceedQuotaFlag bool @@ -348,7 +348,7 @@ type DataSourceBuilder struct { iconUrlFlag bool template string // 数据源采用的展示模版名称 templateFlag bool - searchableFields []string // 【已废弃，如有定制需要请使用“数据范式”接口】描述哪些字段可以被搜索 + searchableFields []string //【已废弃，如有定制需要请使用 “数据范式” 接口】描述哪些字段可以被搜索 searchableFieldsFlag bool i18nName *I18nMeta // 数据源的国际化展示名称 i18nNameFlag bool @@ -356,7 +356,7 @@ type DataSourceBuilder struct { i18nDescriptionFlag bool schemaId string // 数据源关联的 schema 标识 schemaIdFlag bool - appId string // datasource对应的开放平台应用id + appId string // datasource 对应的开放平台应用 id appIdFlag bool } @@ -374,7 +374,7 @@ func (builder *DataSourceBuilder) Id(id string) *DataSourceBuilder { return builder } -// data_source的展示名称 +// data_source 的展示名称 // // 示例值：客服工单 func (builder *DataSourceBuilder) Name(name string) *DataSourceBuilder { @@ -401,7 +401,7 @@ func (builder *DataSourceBuilder) Description(description string) *DataSourceBui return builder } -// 创建时间，使用Unix时间戳，单位为“秒” +// 创建时间，使用 Unix 时间戳，单位为 “秒” // // 示例值：1674309260 func (builder *DataSourceBuilder) CreateTime(createTime string) *DataSourceBuilder { @@ -410,7 +410,7 @@ func (builder *DataSourceBuilder) CreateTime(createTime string) *DataSourceBuild return builder } -// 更新时间，使用Unix时间戳，单位为“秒” +// 更新时间，使用 Unix 时间戳，单位为 “秒” // // 示例值：1674309260 func (builder *DataSourceBuilder) UpdateTime(updateTime string) *DataSourceBuilder { @@ -446,9 +446,9 @@ func (builder *DataSourceBuilder) Template(template string) *DataSourceBuilder { return builder } -// 【已废弃，如有定制需要请使用“数据范式”接口】描述哪些字段可以被搜索 +//【已废弃，如有定制需要请使用 “数据范式” 接口】描述哪些字段可以被搜索 // -// 示例值：【已废弃，如有定制需要请使用“数据范式”接口】["field1", "field2"] +// 示例值：【已废弃，如有定制需要请使用 “数据范式” 接口】["field1", "field2"] func (builder *DataSourceBuilder) SearchableFields(searchableFields []string) *DataSourceBuilder { builder.searchableFields = searchableFields builder.searchableFieldsFlag = true @@ -482,7 +482,7 @@ func (builder *DataSourceBuilder) SchemaId(schemaId string) *DataSourceBuilder { return builder } -// datasource对应的开放平台应用id +// datasource 对应的开放平台应用 id // // 示例值：cli_a1306bed4738d01b func (builder *DataSourceBuilder) AppId(appId string) *DataSourceBuilder { @@ -617,7 +617,7 @@ type Item struct { Id *string `json:"id,omitempty"` // item 在 datasource 中的唯一标识 Acl []*Acl `json:"acl,omitempty"` // item 的访问权限控制。 acl 字段为空数组，则默认数据不可见。如果数据是全员可见，需要设置 access="allow"; type="user"; value="everyone" Metadata *ItemMetadata `json:"metadata,omitempty"` // item 的元信息 - StructuredData *string `json:"structured_data,omitempty"` // 结构化数据（以 json 字符串传递），这些字段是搜索结果的展示字段(特殊字段无须在此另外指定);具体格式可参参考 [通用模块接入指南](/uAjLw4CM/ukTMukTMukTM/search-v2/common-template-intergration-handbook) **请求创建数据项**部分 + StructuredData *string `json:"structured_data,omitempty"` // 结构化数据（以 json 字符串传递），这些字段是搜索结果的展示字段 (特殊字段无须在此另外指定);具体格式可参参考 [通用模块接入指南](/uAjLw4CM/ukTMukTMukTM/search-v2/common-template-intergration-handbook) ** 请求创建数据项 ** 部分 Content *ItemContent `json:"content,omitempty"` // 非结构化数据，如文档文本，飞书搜索会用来做召回 } @@ -628,7 +628,7 @@ type ItemBuilder struct { aclFlag bool metadata *ItemMetadata // item 的元信息 metadataFlag bool - structuredData string // 结构化数据（以 json 字符串传递），这些字段是搜索结果的展示字段(特殊字段无须在此另外指定);具体格式可参参考 [通用模块接入指南](/uAjLw4CM/ukTMukTMukTM/search-v2/common-template-intergration-handbook) **请求创建数据项**部分 + structuredData string // 结构化数据（以 json 字符串传递），这些字段是搜索结果的展示字段 (特殊字段无须在此另外指定);具体格式可参参考 [通用模块接入指南](/uAjLw4CM/ukTMukTMukTM/search-v2/common-template-intergration-handbook) ** 请求创建数据项 ** 部分 structuredDataFlag bool content *ItemContent // 非结构化数据，如文档文本，飞书搜索会用来做召回 contentFlag bool @@ -666,7 +666,7 @@ func (builder *ItemBuilder) Metadata(metadata *ItemMetadata) *ItemBuilder { return builder } -// 结构化数据（以 json 字符串传递），这些字段是搜索结果的展示字段(特殊字段无须在此另外指定);具体格式可参参考 [通用模块接入指南](/uAjLw4CM/ukTMukTMukTM/search-v2/common-template-intergration-handbook) **请求创建数据项**部分 +// 结构化数据（以 json 字符串传递），这些字段是搜索结果的展示字段 (特殊字段无须在此另外指定);具体格式可参参考 [通用模块接入指南](/uAjLw4CM/ukTMukTMukTM/search-v2/common-template-intergration-handbook) ** 请求创建数据项 ** 部分 // // 示例值：{\"key\":\"value\"} func (builder *ItemBuilder) StructuredData(structuredData string) *ItemBuilder { @@ -756,22 +756,22 @@ func (builder *ItemContentBuilder) Build() *ItemContent { type ItemMetadata struct { Title *string `json:"title,omitempty"` // 该条数据记录对应的标题 - SourceUrl *string `json:"source_url,omitempty"` // 该条数据记录对应的跳转url + SourceUrl *string `json:"source_url,omitempty"` // 该条数据记录对应的跳转 url CreateTime *int `json:"create_time,omitempty"` // 数据项的创建时间。Unix 时间，单位为秒 UpdateTime *int `json:"update_time,omitempty"` // 数据项的更新时间。Unix 时间，单位为秒 - SourceUrlMobile *string `json:"source_url_mobile,omitempty"` // 移动端搜索命中的跳转地址。如果您PC端和移动端有不同的跳转地址，可以在这里写入移动端专用的url，我们会在搜索时为您选择合适的地址 + SourceUrlMobile *string `json:"source_url_mobile,omitempty"` // 移动端搜索命中的跳转地址。如果您 PC 端和移动端有不同的跳转地址，可以在这里写入移动端专用的 url，我们会在搜索时为您选择合适的地址 } type ItemMetadataBuilder struct { title string // 该条数据记录对应的标题 titleFlag bool - sourceUrl string // 该条数据记录对应的跳转url + sourceUrl string // 该条数据记录对应的跳转 url sourceUrlFlag bool createTime int // 数据项的创建时间。Unix 时间，单位为秒 createTimeFlag bool updateTime int // 数据项的更新时间。Unix 时间，单位为秒 updateTimeFlag bool - sourceUrlMobile string // 移动端搜索命中的跳转地址。如果您PC端和移动端有不同的跳转地址，可以在这里写入移动端专用的url，我们会在搜索时为您选择合适的地址 + sourceUrlMobile string // 移动端搜索命中的跳转地址。如果您 PC 端和移动端有不同的跳转地址，可以在这里写入移动端专用的 url，我们会在搜索时为您选择合适的地址 sourceUrlMobileFlag bool } @@ -789,7 +789,7 @@ func (builder *ItemMetadataBuilder) Title(title string) *ItemMetadataBuilder { return builder } -// 该条数据记录对应的跳转url +// 该条数据记录对应的跳转 url // // 示例值：http://www.abc.com.cn func (builder *ItemMetadataBuilder) SourceUrl(sourceUrl string) *ItemMetadataBuilder { @@ -816,7 +816,7 @@ func (builder *ItemMetadataBuilder) UpdateTime(updateTime int) *ItemMetadataBuil return builder } -// 移动端搜索命中的跳转地址。如果您PC端和移动端有不同的跳转地址，可以在这里写入移动端专用的url，我们会在搜索时为您选择合适的地址 +// 移动端搜索命中的跳转地址。如果您 PC 端和移动端有不同的跳转地址，可以在这里写入移动端专用的 url，我们会在搜索时为您选择合适的地址 // // 示例值：https://www.feishu.cn func (builder *ItemMetadataBuilder) SourceUrlMobile(sourceUrlMobile string) *ItemMetadataBuilder { @@ -851,19 +851,19 @@ func (builder *ItemMetadataBuilder) Build() *ItemMetadata { } type ItemRecord struct { - ItemId *string `json:"item_id,omitempty"` // 冗余当前item的ID - DataSourceId *string `json:"data_source_id,omitempty"` // 数据源id - Version *string `json:"version,omitempty"` // 当前数据的最新版本号，其值等于上一次item/create接口传入的时间戳 + ItemId *string `json:"item_id,omitempty"` // 冗余当前 item 的 ID + DataSourceId *string `json:"data_source_id,omitempty"` // 数据源 id + Version *string `json:"version,omitempty"` // 当前数据的最新版本号，其值等于上一次 item/create 接口传入的时间戳 CreatedAt *string `json:"created_at,omitempty"` // 第一次投递时间 UpdatedAt *string `json:"updated_at,omitempty"` // 上一次更新落库时间 } type ItemRecordBuilder struct { - itemId string // 冗余当前item的ID + itemId string // 冗余当前 item 的 ID itemIdFlag bool - dataSourceId string // 数据源id + dataSourceId string // 数据源 id dataSourceIdFlag bool - version string // 当前数据的最新版本号，其值等于上一次item/create接口传入的时间戳 + version string // 当前数据的最新版本号，其值等于上一次 item/create 接口传入的时间戳 versionFlag bool createdAt string // 第一次投递时间 createdAtFlag bool @@ -876,7 +876,7 @@ func NewItemRecordBuilder() *ItemRecordBuilder { return builder } -// 冗余当前item的ID +// 冗余当前 item 的 ID // // 示例值： func (builder *ItemRecordBuilder) ItemId(itemId string) *ItemRecordBuilder { @@ -885,7 +885,7 @@ func (builder *ItemRecordBuilder) ItemId(itemId string) *ItemRecordBuilder { return builder } -// 数据源id +// 数据源 id // // 示例值： func (builder *ItemRecordBuilder) DataSourceId(dataSourceId string) *ItemRecordBuilder { @@ -894,7 +894,7 @@ func (builder *ItemRecordBuilder) DataSourceId(dataSourceId string) *ItemRecordB return builder } -// 当前数据的最新版本号，其值等于上一次item/create接口传入的时间戳 +// 当前数据的最新版本号，其值等于上一次 item/create 接口传入的时间戳 // // 示例值： func (builder *ItemRecordBuilder) Version(version string) *ItemRecordBuilder { @@ -1152,11 +1152,11 @@ func (builder *SchemaDisplayOptionBuilder) Build() *SchemaDisplayOption { } type SchemaEnumOptions struct { - PossibleValues []string `json:"possible_values,omitempty"` // 用户自定filter 枚举值数组，最大长度为50 + PossibleValues []string `json:"possible_values,omitempty"` // 用户自定 filter 枚举值数组，最大长度为 50 } type SchemaEnumOptionsBuilder struct { - possibleValues []string // 用户自定filter 枚举值数组，最大长度为50 + possibleValues []string // 用户自定 filter 枚举值数组，最大长度为 50 possibleValuesFlag bool } @@ -1165,7 +1165,7 @@ func NewSchemaEnumOptionsBuilder() *SchemaEnumOptionsBuilder { return builder } -// 用户自定filter 枚举值数组，最大长度为50 +// 用户自定 filter 枚举值数组，最大长度为 50 // // 示例值：v1 func (builder *SchemaEnumOptionsBuilder) PossibleValues(possibleValues []string) *SchemaEnumOptionsBuilder { @@ -1470,7 +1470,7 @@ type SchemaSearchOptions struct { EnableSemanticMatch *bool `json:"enable_semantic_match,omitempty"` // 是否支持语义切词召回。默认不支持（推荐使用在长文本的场景） EnableExactMatch *bool `json:"enable_exact_match,omitempty"` // 是否支持精确匹配。默认不支持（推荐使用在短文本、需要精确查找的场景） EnablePrefixMatch *bool `json:"enable_prefix_match,omitempty"` // 是否支持前缀匹配（短文本的默认的分词/召回策略。前缀长度为 1-12） - EnableNumberSuffixMatch *bool `json:"enable_number_suffix_match,omitempty"` // 是否支持数据后缀匹配。默认不支持（推荐使用在短文本、有数字后缀查找的场景。后缀长度为3-12） + EnableNumberSuffixMatch *bool `json:"enable_number_suffix_match,omitempty"` // 是否支持数据后缀匹配。默认不支持（推荐使用在短文本、有数字后缀查找的场景。后缀长度为 3-12） EnableCamelMatch *bool `json:"enable_camel_match,omitempty"` // 是否支持驼峰英文匹配。默认不支持（推荐使用在短文本，且包含驼峰形式英文的查找场景） } @@ -1481,7 +1481,7 @@ type SchemaSearchOptionsBuilder struct { enableExactMatchFlag bool enablePrefixMatch bool // 是否支持前缀匹配（短文本的默认的分词/召回策略。前缀长度为 1-12） enablePrefixMatchFlag bool - enableNumberSuffixMatch bool // 是否支持数据后缀匹配。默认不支持（推荐使用在短文本、有数字后缀查找的场景。后缀长度为3-12） + enableNumberSuffixMatch bool // 是否支持数据后缀匹配。默认不支持（推荐使用在短文本、有数字后缀查找的场景。后缀长度为 3-12） enableNumberSuffixMatchFlag bool enableCamelMatch bool // 是否支持驼峰英文匹配。默认不支持（推荐使用在短文本，且包含驼峰形式英文的查找场景） enableCamelMatchFlag bool @@ -1519,7 +1519,7 @@ func (builder *SchemaSearchOptionsBuilder) EnablePrefixMatch(enablePrefixMatch b return builder } -// 是否支持数据后缀匹配。默认不支持（推荐使用在短文本、有数字后缀查找的场景。后缀长度为3-12） +// 是否支持数据后缀匹配。默认不支持（推荐使用在短文本、有数字后缀查找的场景。后缀长度为 3-12） // // 示例值：false func (builder *SchemaSearchOptionsBuilder) EnableNumberSuffixMatch(enableNumberSuffixMatch bool) *SchemaSearchOptionsBuilder { @@ -1563,12 +1563,12 @@ func (builder *SchemaSearchOptionsBuilder) Build() *SchemaSearchOptions { } type SchemaSortOptions struct { - Priority *int `json:"priority,omitempty"` // 排序的优先级，可选范围为 0~4，0为最高优先级。如果优先级相同，则随机进行排序。默认为0 + Priority *int `json:"priority,omitempty"` // 排序的优先级，可选范围为 0~4，0 为最高优先级。如果优先级相同，则随机进行排序。默认为 0 Order *string `json:"order,omitempty"` // 排序的顺序。默认为 desc } type SchemaSortOptionsBuilder struct { - priority int // 排序的优先级，可选范围为 0~4，0为最高优先级。如果优先级相同，则随机进行排序。默认为0 + priority int // 排序的优先级，可选范围为 0~4，0 为最高优先级。如果优先级相同，则随机进行排序。默认为 0 priorityFlag bool order string // 排序的顺序。默认为 desc orderFlag bool @@ -1579,7 +1579,7 @@ func NewSchemaSortOptionsBuilder() *SchemaSortOptionsBuilder { return builder } -// 排序的优先级，可选范围为 0~4，0为最高优先级。如果优先级相同，则随机进行排序。默认为0 +// 排序的优先级，可选范围为 0~4，0 为最高优先级。如果优先级相同，则随机进行排序。默认为 0 // // 示例值：0 func (builder *SchemaSortOptionsBuilder) Priority(priority int) *SchemaSortOptionsBuilder { @@ -1858,7 +1858,7 @@ func (builder *ListDataSourceReqBuilder) Limit(limit int) *ListDataSourceReqBuil return builder } -// 回包数据格式，0-全量数据；1-摘要数据。;;**注**：摘要数据仅包含"id"，"name"，"state"。 +// 回包数据格式，0-全量数据；1-摘要数据。;;** 注 **：摘要数据仅包含"id"，"name"，"state"。 // // 示例值：0 func (builder *ListDataSourceReqBuilder) View(view int) *ListDataSourceReqBuilder { @@ -1921,9 +1921,9 @@ type PatchDataSourceReqBodyBuilder struct { descriptionFlag bool iconUrl string // 数据源在 search tab 上的展示图标路径 iconUrlFlag bool - i18nName *I18nMeta // 数据源名称多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} + i18nName *I18nMeta // 数据源名称多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} i18nNameFlag bool - i18nDescription *I18nMeta // 数据源描述多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} + i18nDescription *I18nMeta // 数据源描述多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} i18nDescriptionFlag bool } @@ -1968,7 +1968,7 @@ func (builder *PatchDataSourceReqBodyBuilder) IconUrl(iconUrl string) *PatchData return builder } -// 数据源名称多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} +// 数据源名称多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} // //示例值： func (builder *PatchDataSourceReqBodyBuilder) I18nName(i18nName *I18nMeta) *PatchDataSourceReqBodyBuilder { @@ -1977,7 +1977,7 @@ func (builder *PatchDataSourceReqBodyBuilder) I18nName(i18nName *I18nMeta) *Patc return builder } -// 数据源描述多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} +// 数据源描述多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} // //示例值： func (builder *PatchDataSourceReqBodyBuilder) I18nDescription(i18nDescription *I18nMeta) *PatchDataSourceReqBodyBuilder { @@ -2018,9 +2018,9 @@ type PatchDataSourcePathReqBodyBuilder struct { descriptionFlag bool iconUrl string // 数据源在 search tab 上的展示图标路径 iconUrlFlag bool - i18nName *I18nMeta // 数据源名称多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} + i18nName *I18nMeta // 数据源名称多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} i18nNameFlag bool - i18nDescription *I18nMeta // 数据源描述多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} + i18nDescription *I18nMeta // 数据源描述多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} i18nDescriptionFlag bool } @@ -2065,7 +2065,7 @@ func (builder *PatchDataSourcePathReqBodyBuilder) IconUrl(iconUrl string) *Patch return builder } -// 数据源名称多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} +// 数据源名称多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} // // 示例值： func (builder *PatchDataSourcePathReqBodyBuilder) I18nName(i18nName *I18nMeta) *PatchDataSourcePathReqBodyBuilder { @@ -2074,7 +2074,7 @@ func (builder *PatchDataSourcePathReqBodyBuilder) I18nName(i18nName *I18nMeta) * return builder } -// 数据源描述多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} +// 数据源描述多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} // // 示例值： func (builder *PatchDataSourcePathReqBodyBuilder) I18nDescription(i18nDescription *I18nMeta) *PatchDataSourcePathReqBodyBuilder { @@ -2147,8 +2147,8 @@ type PatchDataSourceReqBody struct { State *int `json:"state,omitempty"` // 数据源状态，0-已上线，1-未上线 Description *string `json:"description,omitempty"` // 对于数据源的描述 IconUrl *string `json:"icon_url,omitempty"` // 数据源在 search tab 上的展示图标路径 - I18nName *I18nMeta `json:"i18n_name,omitempty"` // 数据源名称多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} - I18nDescription *I18nMeta `json:"i18n_description,omitempty"` // 数据源描述多语言配置，json格式，key为语言locale，value为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} + I18nName *I18nMeta `json:"i18n_name,omitempty"` // 数据源名称多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"测试数据源", "en_us":"Test DataSource"} + I18nDescription *I18nMeta `json:"i18n_description,omitempty"` // 数据源描述多语言配置，json 格式，key 为语言 locale，value 为对应文案，例如{"zh_cn":"搜索测试数据源相关数据", "en_us":"Search data from Test DataSource"} } type PatchDataSourceReq struct { @@ -2184,7 +2184,7 @@ func NewCreateDataSourceItemReqBuilder() *CreateDataSourceItemReqBuilder { return builder } -// 数据源的ID +// 数据源的 ID // // 示例值：service_ticket func (builder *CreateDataSourceItemReqBuilder) DataSourceId(dataSourceId string) *CreateDataSourceItemReqBuilder { @@ -2233,7 +2233,7 @@ func NewDeleteDataSourceItemReqBuilder() *DeleteDataSourceItemReqBuilder { return builder } -// 数据源的ID +// 数据源的 ID // // 示例值：service_ticket func (builder *DeleteDataSourceItemReqBuilder) DataSourceId(dataSourceId string) *DeleteDataSourceItemReqBuilder { @@ -2241,7 +2241,7 @@ func (builder *DeleteDataSourceItemReqBuilder) DataSourceId(dataSourceId string) return builder } -// 数据记录的ID +// 数据记录的 ID // // 示例值：01010111 func (builder *DeleteDataSourceItemReqBuilder) ItemId(itemId string) *DeleteDataSourceItemReqBuilder { @@ -2282,7 +2282,7 @@ func NewGetDataSourceItemReqBuilder() *GetDataSourceItemReqBuilder { return builder } -// 数据源的id +// 数据源的 id // // 示例值：service_ticket func (builder *GetDataSourceItemReqBuilder) DataSourceId(dataSourceId string) *GetDataSourceItemReqBuilder { @@ -2596,7 +2596,7 @@ func (iterator *ListDataSourceIterator) Next() (bool, *DataSource, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/sheets/v3/api.go b/service/sheets/v3/api.go index 533be5e6..7adabcca 100644 --- a/service/sheets/v3/api.go +++ b/service/sheets/v3/api.go @@ -64,9 +64,9 @@ type spreadsheetSheetFloatImage struct { // // - 在指定目录下创建表格 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheet.go func (s *spreadsheet) Create(ctx context.Context, req *CreateSpreadsheetReq, options ...larkcore.RequestOptionFunc) (*CreateSpreadsheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -90,9 +90,9 @@ func (s *spreadsheet) Create(ctx context.Context, req *CreateSpreadsheetReq, opt // // - 该接口用于获取电子表格的基础信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheet.go func (s *spreadsheet) Get(ctx context.Context, req *GetSpreadsheetReq, options ...larkcore.RequestOptionFunc) (*GetSpreadsheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -116,9 +116,9 @@ func (s *spreadsheet) Get(ctx context.Context, req *GetSpreadsheetReq, options . // // - 该接口用于修改电子表格的属性 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/patch_spreadsheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/patch_spreadsheet.go func (s *spreadsheet) Patch(ctx context.Context, req *PatchSpreadsheetReq, options ...larkcore.RequestOptionFunc) (*PatchSpreadsheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -142,9 +142,9 @@ func (s *spreadsheet) Patch(ctx context.Context, req *PatchSpreadsheetReq, optio // // - 在指定范围内查找符合查找条件的单元格。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/find +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/find // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/find_spreadsheetSheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/find_spreadsheetSheet.go func (s *spreadsheetSheet) Find(ctx context.Context, req *FindSpreadsheetSheetReq, options ...larkcore.RequestOptionFunc) (*FindSpreadsheetSheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -166,11 +166,11 @@ func (s *spreadsheetSheet) Find(ctx context.Context, req *FindSpreadsheetSheetRe // 查询工作表 // -// - 该接口用于通过工作表ID查询工作表属性信息。 +// - 该接口用于通过工作表 ID 查询工作表属性信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheet.go func (s *spreadsheetSheet) Get(ctx context.Context, req *GetSpreadsheetSheetReq, options ...larkcore.RequestOptionFunc) (*GetSpreadsheetSheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -194,9 +194,9 @@ func (s *spreadsheetSheet) Get(ctx context.Context, req *GetSpreadsheetSheetReq, // // - 该接口用于移动行列，行列被移动到目标位置后，原本在目标位置的行列会对应右移或下移。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/move_dimension +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/move_dimension // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/moveDimension_spreadsheetSheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/moveDimension_spreadsheetSheet.go func (s *spreadsheetSheet) MoveDimension(ctx context.Context, req *MoveDimensionSpreadsheetSheetReq, options ...larkcore.RequestOptionFunc) (*MoveDimensionSpreadsheetSheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -220,9 +220,9 @@ func (s *spreadsheetSheet) MoveDimension(ctx context.Context, req *MoveDimension // // - 该接口用于获取电子表格下所有工作表及其属性。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheet.go func (s *spreadsheetSheet) Query(ctx context.Context, req *QuerySpreadsheetSheetReq, options ...larkcore.RequestOptionFunc) (*QuerySpreadsheetSheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -244,11 +244,11 @@ func (s *spreadsheetSheet) Query(ctx context.Context, req *QuerySpreadsheetSheet // 替换单元格 // -// - 按照指定的条件查找子表的某个范围内的数据符合条件的单元格并替换值，返回替换成功的单元格位置。一次请求最多允许替换5000个单元格，如果超过请将range缩小范围再操作。请求体中的 range、find、replaccement 字段必填。 +// - 按照指定的条件查找子表的某个范围内的数据符合条件的单元格并替换值，返回替换成功的单元格位置。一次请求最多允许替换 5000 个单元格，如果超过请将 range 缩小范围再操作。请求体中的 range、find、replaccement 字段必填。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/replace +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/replace // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/replace_spreadsheetSheet.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/replace_spreadsheetSheet.go func (s *spreadsheetSheet) Replace(ctx context.Context, req *ReplaceSpreadsheetSheetReq, options ...larkcore.RequestOptionFunc) (*ReplaceSpreadsheetSheetResp, error) { // 发起请求 apiReq := req.apiReq @@ -272,11 +272,11 @@ func (s *spreadsheetSheet) Replace(ctx context.Context, req *ReplaceSpreadsheetS // // - 在子表内创建筛选。 // -// - 参数值可参考[筛选指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/filter-user-guide) +// - 参数值可参考 [筛选指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/filter-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFilter.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFilter.go func (s *spreadsheetSheetFilter) Create(ctx context.Context, req *CreateSpreadsheetSheetFilterReq, options ...larkcore.RequestOptionFunc) (*CreateSpreadsheetSheetFilterResp, error) { // 发起请求 apiReq := req.apiReq @@ -300,9 +300,9 @@ func (s *spreadsheetSheetFilter) Create(ctx context.Context, req *CreateSpreadsh // // - 删除子表的筛选 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFilter.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFilter.go func (s *spreadsheetSheetFilter) Delete(ctx context.Context, req *DeleteSpreadsheetSheetFilterReq, options ...larkcore.RequestOptionFunc) (*DeleteSpreadsheetSheetFilterResp, error) { // 发起请求 apiReq := req.apiReq @@ -326,9 +326,9 @@ func (s *spreadsheetSheetFilter) Delete(ctx context.Context, req *DeleteSpreadsh // // - 获取子表的详细筛选信息 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFilter.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFilter.go func (s *spreadsheetSheetFilter) Get(ctx context.Context, req *GetSpreadsheetSheetFilterReq, options ...larkcore.RequestOptionFunc) (*GetSpreadsheetSheetFilterResp, error) { // 发起请求 apiReq := req.apiReq @@ -352,11 +352,11 @@ func (s *spreadsheetSheetFilter) Get(ctx context.Context, req *GetSpreadsheetShe // // - 更新子表筛选范围中的列筛选条件。 // -// - 参数值可参考[筛选指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/filter-user-guide) +// - 参数值可参考 [筛选指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/filter-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/update +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/update_spreadsheetSheetFilter.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/update_spreadsheetSheetFilter.go func (s *spreadsheetSheetFilter) Update(ctx context.Context, req *UpdateSpreadsheetSheetFilterReq, options ...larkcore.RequestOptionFunc) (*UpdateSpreadsheetSheetFilterResp, error) { // 发起请求 apiReq := req.apiReq @@ -378,13 +378,13 @@ func (s *spreadsheetSheetFilter) Update(ctx context.Context, req *UpdateSpreadsh // 创建筛选视图 // -// - 根据传入的参数创建一个筛选视图。Id 和 名字可选，不填的话会默认生成；range 必填。Id 长度为10，由 0-9、a-z、A-Z 组合生成。名字长度不超过100。单个子表内的筛选视图个数不超过 150。 +// - 根据传入的参数创建一个筛选视图。Id 和 名字可选，不填的话会默认生成；range 必填。Id 长度为 10，由 0-9、a-z、A-Z 组合生成。名字长度不超过 100。单个子表内的筛选视图个数不超过 150。 // // - 筛选范围的设置参考：[筛选视图的筛选条件指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFilterView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFilterView.go func (s *spreadsheetSheetFilterView) Create(ctx context.Context, req *CreateSpreadsheetSheetFilterViewReq, options ...larkcore.RequestOptionFunc) (*CreateSpreadsheetSheetFilterViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -408,9 +408,9 @@ func (s *spreadsheetSheetFilterView) Create(ctx context.Context, req *CreateSpre // // - 删除指定 id 对应的筛选视图。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFilterView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFilterView.go func (s *spreadsheetSheetFilterView) Delete(ctx context.Context, req *DeleteSpreadsheetSheetFilterViewReq, options ...larkcore.RequestOptionFunc) (*DeleteSpreadsheetSheetFilterViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -434,9 +434,9 @@ func (s *spreadsheetSheetFilterView) Delete(ctx context.Context, req *DeleteSpre // // - 获取指定筛选视图 id 的名字和筛选范围。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFilterView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFilterView.go func (s *spreadsheetSheetFilterView) Get(ctx context.Context, req *GetSpreadsheetSheetFilterViewReq, options ...larkcore.RequestOptionFunc) (*GetSpreadsheetSheetFilterViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -458,13 +458,13 @@ func (s *spreadsheetSheetFilterView) Get(ctx context.Context, req *GetSpreadshee // 更新筛选视图 // -// - 更新筛选视图的名字或者筛选范围。名字长度不超过100，不能重复即子表内唯一；筛选范围不超过子表的最大范围。 +// - 更新筛选视图的名字或者筛选范围。名字长度不超过 100，不能重复即子表内唯一；筛选范围不超过子表的最大范围。 // // - 筛选范围的设置参考：[筛选视图的筛选条件指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/patch_spreadsheetSheetFilterView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/patch_spreadsheetSheetFilterView.go func (s *spreadsheetSheetFilterView) Patch(ctx context.Context, req *PatchSpreadsheetSheetFilterViewReq, options ...larkcore.RequestOptionFunc) (*PatchSpreadsheetSheetFilterViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -488,9 +488,9 @@ func (s *spreadsheetSheetFilterView) Patch(ctx context.Context, req *PatchSpread // // - 查询子表内所有的筛选视图基本信息，包括 id、name 和 range // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/query +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheetFilterView.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheetFilterView.go func (s *spreadsheetSheetFilterView) Query(ctx context.Context, req *QuerySpreadsheetSheetFilterViewReq, options ...larkcore.RequestOptionFunc) (*QuerySpreadsheetSheetFilterViewResp, error) { // 发起请求 apiReq := req.apiReq @@ -516,9 +516,9 @@ func (s *spreadsheetSheetFilterView) Query(ctx context.Context, req *QuerySpread // // - 筛选条件参考 [筛选视图的筛选条件指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFilterViewCondition.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFilterViewCondition.go func (s *spreadsheetSheetFilterViewCondition) Create(ctx context.Context, req *CreateSpreadsheetSheetFilterViewConditionReq, options ...larkcore.RequestOptionFunc) (*CreateSpreadsheetSheetFilterViewConditionResp, error) { // 发起请求 apiReq := req.apiReq @@ -542,9 +542,9 @@ func (s *spreadsheetSheetFilterViewCondition) Create(ctx context.Context, req *C // // - 删除筛选视图的筛选范围某一列的筛选条件。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFilterViewCondition.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFilterViewCondition.go func (s *spreadsheetSheetFilterViewCondition) Delete(ctx context.Context, req *DeleteSpreadsheetSheetFilterViewConditionReq, options ...larkcore.RequestOptionFunc) (*DeleteSpreadsheetSheetFilterViewConditionResp, error) { // 发起请求 apiReq := req.apiReq @@ -570,9 +570,9 @@ func (s *spreadsheetSheetFilterViewCondition) Delete(ctx context.Context, req *D // // - 筛选条件含义参考 [筛选视图的筛选条件指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFilterViewCondition.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFilterViewCondition.go func (s *spreadsheetSheetFilterViewCondition) Get(ctx context.Context, req *GetSpreadsheetSheetFilterViewConditionReq, options ...larkcore.RequestOptionFunc) (*GetSpreadsheetSheetFilterViewConditionResp, error) { // 发起请求 apiReq := req.apiReq @@ -598,9 +598,9 @@ func (s *spreadsheetSheetFilterViewCondition) Get(ctx context.Context, req *GetS // // - 筛选条件含义可参考 [筛选视图的筛选条件指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/query +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheetFilterViewCondition.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheetFilterViewCondition.go func (s *spreadsheetSheetFilterViewCondition) Query(ctx context.Context, req *QuerySpreadsheetSheetFilterViewConditionReq, options ...larkcore.RequestOptionFunc) (*QuerySpreadsheetSheetFilterViewConditionResp, error) { // 发起请求 apiReq := req.apiReq @@ -626,9 +626,9 @@ func (s *spreadsheetSheetFilterViewCondition) Query(ctx context.Context, req *Qu // // - 筛选条件参数可参考 [筛选视图的筛选条件指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/update +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/update_spreadsheetSheetFilterViewCondition.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/update_spreadsheetSheetFilterViewCondition.go func (s *spreadsheetSheetFilterViewCondition) Update(ctx context.Context, req *UpdateSpreadsheetSheetFilterViewConditionReq, options ...larkcore.RequestOptionFunc) (*UpdateSpreadsheetSheetFilterViewConditionResp, error) { // 发起请求 apiReq := req.apiReq @@ -650,13 +650,13 @@ func (s *spreadsheetSheetFilterViewCondition) Update(ctx context.Context, req *U // 创建浮动图片 // -// - 根据传入的参数创建一张浮动图片。Float_image_token （[上传图片至表格后得到](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all)）和range（只支持一个单元格） 必填。Float_image_id 可选，不填的话会默认生成，长度为10，由 0-9、a-z、A-Z 组合生成。表格内不重复的图片（浮动图片+单元格图片）总数不超过4000。width 和 height 为图片展示的宽高，可选，不填的话会使用图片的真实宽高。offset_x 和 offset_y 为图片左上角距离所在单元格左上角的偏移，可选，默认为 0。 +// - 根据传入的参数创建一张浮动图片。Float_image_token（[上传图片至表格后得到](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all)）和 range（只支持一个单元格）必填。Float_image_id 可选，不填的话会默认生成，长度为 10，由 0-9、a-z、A-Z 组合生成。表格内不重复的图片（浮动图片 + 单元格图片）总数不超过 4000。width 和 height 为图片展示的宽高，可选，不填的话会使用图片的真实宽高。offset_x 和 offset_y 为图片左上角距离所在单元格左上角的偏移，可选，默认为 0。 // // - 浮动图片的设置参考：[浮动图片指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/float-image-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFloatImage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/create_spreadsheetSheetFloatImage.go func (s *spreadsheetSheetFloatImage) Create(ctx context.Context, req *CreateSpreadsheetSheetFloatImageReq, options ...larkcore.RequestOptionFunc) (*CreateSpreadsheetSheetFloatImageResp, error) { // 发起请求 apiReq := req.apiReq @@ -680,9 +680,9 @@ func (s *spreadsheetSheetFloatImage) Create(ctx context.Context, req *CreateSpre // // - 删除 float_image_id 对应的浮动图片。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFloatImage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/delete_spreadsheetSheetFloatImage.go func (s *spreadsheetSheetFloatImage) Delete(ctx context.Context, req *DeleteSpreadsheetSheetFloatImageReq, options ...larkcore.RequestOptionFunc) (*DeleteSpreadsheetSheetFloatImageResp, error) { // 发起请求 apiReq := req.apiReq @@ -708,9 +708,9 @@ func (s *spreadsheetSheetFloatImage) Delete(ctx context.Context, req *DeleteSpre // // - 浮动图片参考：[浮动图片指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/float-image-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFloatImage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/get_spreadsheetSheetFloatImage.go func (s *spreadsheetSheetFloatImage) Get(ctx context.Context, req *GetSpreadsheetSheetFloatImageReq, options ...larkcore.RequestOptionFunc) (*GetSpreadsheetSheetFloatImageResp, error) { // 发起请求 apiReq := req.apiReq @@ -736,9 +736,9 @@ func (s *spreadsheetSheetFloatImage) Get(ctx context.Context, req *GetSpreadshee // // - 浮动图片更新参考：[浮动图片指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/float-image-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/patch_spreadsheetSheetFloatImage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/patch_spreadsheetSheetFloatImage.go func (s *spreadsheetSheetFloatImage) Patch(ctx context.Context, req *PatchSpreadsheetSheetFloatImageReq, options ...larkcore.RequestOptionFunc) (*PatchSpreadsheetSheetFloatImageResp, error) { // 发起请求 apiReq := req.apiReq @@ -764,9 +764,9 @@ func (s *spreadsheetSheetFloatImage) Patch(ctx context.Context, req *PatchSpread // // - 浮动图片参考：[浮动图片指南](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/float-image-user-guide) // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/query +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheetFloatImage.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/sheetsv3/query_spreadsheetSheetFloatImage.go func (s *spreadsheetSheetFloatImage) Query(ctx context.Context, req *QuerySpreadsheetSheetFloatImageReq, options ...larkcore.RequestOptionFunc) (*QuerySpreadsheetSheetFloatImageResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/sheets/v3/model.go b/service/sheets/v3/model.go index 89bb0e4d..805b9716 100644 --- a/service/sheets/v3/model.go +++ b/service/sheets/v3/model.go @@ -20,9 +20,9 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) type AddSheet struct { @@ -138,14 +138,14 @@ func (builder *AppendDimensionBuilder) Build() *AppendDimension { } type BitableProperties struct { - BitableToken *string `json:"bitable_token,omitempty"` // 多维表格token - TableId *string `json:"table_id,omitempty"` // 数据表id + BitableToken *string `json:"bitable_token,omitempty"` // 多维表格 token + TableId *string `json:"table_id,omitempty"` // 数据表 id } type BitablePropertiesBuilder struct { - bitableToken string // 多维表格token + bitableToken string // 多维表格 token bitableTokenFlag bool - tableId string // 数据表id + tableId string // 数据表 id tableIdFlag bool } @@ -154,7 +154,7 @@ func NewBitablePropertiesBuilder() *BitablePropertiesBuilder { return builder } -// 多维表格token +// 多维表格 token // // 示例值：basxxxxxxxxxxxxxxxx func (builder *BitablePropertiesBuilder) BitableToken(bitableToken string) *BitablePropertiesBuilder { @@ -163,7 +163,7 @@ func (builder *BitablePropertiesBuilder) BitableToken(bitableToken string) *Bita return builder } -// 数据表id +// 数据表 id // // 示例值：tblxxxxxxxxxx func (builder *BitablePropertiesBuilder) TableId(tableId string) *BitablePropertiesBuilder { @@ -638,13 +638,13 @@ func (builder *DimensionPropertiesBuilder) Build() *DimensionProperties { } type File struct { - FileToken *string `json:"file_token,omitempty"` // 附件token + FileToken *string `json:"file_token,omitempty"` // 附件 token Name *string `json:"name,omitempty"` // 附件名称 SegmentStyle *SegmentStyle `json:"segment_style,omitempty"` // } type FileBuilder struct { - fileToken string // 附件token + fileToken string // 附件 token fileTokenFlag bool name string // 附件名称 nameFlag bool @@ -657,7 +657,7 @@ func NewFileBuilder() *FileBuilder { return builder } -// 附件token +// 附件 token // // 示例值：boxxxxxxx func (builder *FileBuilder) FileToken(fileToken string) *FileBuilder { @@ -1034,15 +1034,15 @@ func (builder *FindConditionBuilder) Build() *FindCondition { } type FindReplaceResult struct { - MatchedCells []string `json:"matched_cells,omitempty"` // 符合查找条件的单元格数组，不包含公式，例如["A1", "A2"...] - MatchedFormulaCells []string `json:"matched_formula_cells,omitempty"` // 符合查找条件的含有公式的单元格数组，例如["B3", "H7"...] + MatchedCells []string `json:"matched_cells,omitempty"` // 符合查找条件的单元格数组，不包含公式，例如 ["A1", "A2"...] + MatchedFormulaCells []string `json:"matched_formula_cells,omitempty"` // 符合查找条件的含有公式的单元格数组，例如 ["B3", "H7"...] RowsCount *int `json:"rows_count,omitempty"` // 符合查找条件的总行数 } type FindReplaceResultBuilder struct { - matchedCells []string // 符合查找条件的单元格数组，不包含公式，例如["A1", "A2"...] + matchedCells []string // 符合查找条件的单元格数组，不包含公式，例如 ["A1", "A2"...] matchedCellsFlag bool - matchedFormulaCells []string // 符合查找条件的含有公式的单元格数组，例如["B3", "H7"...] + matchedFormulaCells []string // 符合查找条件的含有公式的单元格数组，例如 ["B3", "H7"...] matchedFormulaCellsFlag bool rowsCount int // 符合查找条件的总行数 rowsCountFlag bool @@ -1053,7 +1053,7 @@ func NewFindReplaceResultBuilder() *FindReplaceResultBuilder { return builder } -// 符合查找条件的单元格数组，不包含公式，例如["A1", "A2"...] +// 符合查找条件的单元格数组，不包含公式，例如 ["A1", "A2"...] // // 示例值： func (builder *FindReplaceResultBuilder) MatchedCells(matchedCells []string) *FindReplaceResultBuilder { @@ -1062,7 +1062,7 @@ func (builder *FindReplaceResultBuilder) MatchedCells(matchedCells []string) *Fi return builder } -// 符合查找条件的含有公式的单元格数组，例如["B3", "H7"...] +// 符合查找条件的含有公式的单元格数组，例如 ["B3", "H7"...] // // 示例值： func (builder *FindReplaceResultBuilder) MatchedFormulaCells(matchedFormulaCells []string) *FindReplaceResultBuilder { @@ -1097,18 +1097,18 @@ func (builder *FindReplaceResultBuilder) Build() *FindReplaceResult { type FloatImage struct { FloatImageId *string `json:"float_image_id,omitempty"` // 浮动图片 id - FloatImageToken *string `json:"float_image_token,omitempty"` // 【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作 + FloatImageToken *string `json:"float_image_token,omitempty"` //【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作 Range *string `json:"range,omitempty"` // 浮动图片的左上角单元格定位，只支持一个单元格 Width *float64 `json:"width,omitempty"` // 浮动图片的宽度，大于等于 20px Height *float64 `json:"height,omitempty"` // 浮动图片的高度，大于等于 20px - OffsetX *float64 `json:"offset_x,omitempty"` // 浮动图片左上角所在位置相对于所在单元格左上角的横向偏移，大于等于0且小于所在单元格的宽度 - OffsetY *float64 `json:"offset_y,omitempty"` // 浮动图片左上角所在位置相对于所在单元格左上角的纵向偏移，大于等于0且小于所在单元格的高度 + OffsetX *float64 `json:"offset_x,omitempty"` // 浮动图片左上角所在位置相对于所在单元格左上角的横向偏移，大于等于 0 且小于所在单元格的宽度 + OffsetY *float64 `json:"offset_y,omitempty"` // 浮动图片左上角所在位置相对于所在单元格左上角的纵向偏移，大于等于 0 且小于所在单元格的高度 } type FloatImageBuilder struct { floatImageId string // 浮动图片 id floatImageIdFlag bool - floatImageToken string // 【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作 + floatImageToken string //【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作 floatImageTokenFlag bool range_ string // 浮动图片的左上角单元格定位，只支持一个单元格 rangeFlag bool @@ -1116,9 +1116,9 @@ type FloatImageBuilder struct { widthFlag bool height float64 // 浮动图片的高度，大于等于 20px heightFlag bool - offsetX float64 // 浮动图片左上角所在位置相对于所在单元格左上角的横向偏移，大于等于0且小于所在单元格的宽度 + offsetX float64 // 浮动图片左上角所在位置相对于所在单元格左上角的横向偏移，大于等于 0 且小于所在单元格的宽度 offsetXFlag bool - offsetY float64 // 浮动图片左上角所在位置相对于所在单元格左上角的纵向偏移，大于等于0且小于所在单元格的高度 + offsetY float64 // 浮动图片左上角所在位置相对于所在单元格左上角的纵向偏移，大于等于 0 且小于所在单元格的高度 offsetYFlag bool } @@ -1136,7 +1136,7 @@ func (builder *FloatImageBuilder) FloatImageId(floatImageId string) *FloatImageB return builder } -// 【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作 +//【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作 // // 示例值：boxbcbQsaSqIXsxxxxx1HCPJFbh func (builder *FloatImageBuilder) FloatImageToken(floatImageToken string) *FloatImageBuilder { @@ -1172,7 +1172,7 @@ func (builder *FloatImageBuilder) Height(height float64) *FloatImageBuilder { return builder } -// 浮动图片左上角所在位置相对于所在单元格左上角的横向偏移，大于等于0且小于所在单元格的宽度 +// 浮动图片左上角所在位置相对于所在单元格左上角的横向偏移，大于等于 0 且小于所在单元格的宽度 // // 示例值：0 func (builder *FloatImageBuilder) OffsetX(offsetX float64) *FloatImageBuilder { @@ -1181,7 +1181,7 @@ func (builder *FloatImageBuilder) OffsetX(offsetX float64) *FloatImageBuilder { return builder } -// 浮动图片左上角所在位置相对于所在单元格左上角的纵向偏移，大于等于0且小于所在单元格的高度 +// 浮动图片左上角所在位置相对于所在单元格左上角的纵向偏移，大于等于 0 且小于所在单元格的高度 // // 示例值：0 func (builder *FloatImageBuilder) OffsetY(offsetY float64) *FloatImageBuilder { @@ -1289,19 +1289,19 @@ func (builder *FormulaBuilder) Build() *Formula { type GetSpreadsheet struct { Title *string `json:"title,omitempty"` // 电子表格标题 - OwnerId *string `json:"owner_id,omitempty"` // 电子表格owner - Token *string `json:"token,omitempty"` // 电子表格token - Url *string `json:"url,omitempty"` // 电子表格url + OwnerId *string `json:"owner_id,omitempty"` // 电子表格 owner + Token *string `json:"token,omitempty"` // 电子表格 token + Url *string `json:"url,omitempty"` // 电子表格 url } type GetSpreadsheetBuilder struct { title string // 电子表格标题 titleFlag bool - ownerId string // 电子表格owner + ownerId string // 电子表格 owner ownerIdFlag bool - token string // 电子表格token + token string // 电子表格 token tokenFlag bool - url string // 电子表格url + url string // 电子表格 url urlFlag bool } @@ -1319,7 +1319,7 @@ func (builder *GetSpreadsheetBuilder) Title(title string) *GetSpreadsheetBuilder return builder } -// 电子表格owner +// 电子表格 owner // // 示例值：ou_xxxxxxxxxxxx func (builder *GetSpreadsheetBuilder) OwnerId(ownerId string) *GetSpreadsheetBuilder { @@ -1328,7 +1328,7 @@ func (builder *GetSpreadsheetBuilder) OwnerId(ownerId string) *GetSpreadsheetBui return builder } -// 电子表格token +// 电子表格 token // // 示例值：shtxxxxxxxxxxxxxx func (builder *GetSpreadsheetBuilder) Token(token string) *GetSpreadsheetBuilder { @@ -1337,7 +1337,7 @@ func (builder *GetSpreadsheetBuilder) Token(token string) *GetSpreadsheetBuilder return builder } -// 电子表格url +// 电子表格 url // // 示例值：https://bytedance.feishu.cn/sheets/shtcnmBA*****yGehy8 func (builder *GetSpreadsheetBuilder) Url(url string) *GetSpreadsheetBuilder { @@ -1448,11 +1448,11 @@ func (builder *GridPropertiesBuilder) Build() *GridProperties { } type Image struct { - ImageToken *string `json:"image_token,omitempty"` // 图片token + ImageToken *string `json:"image_token,omitempty"` // 图片 token } type ImageBuilder struct { - imageToken string // 图片token + imageToken string // 图片 token imageTokenFlag bool } @@ -1461,7 +1461,7 @@ func NewImageBuilder() *ImageBuilder { return builder } -// 图片token +// 图片 token // // 示例值：boxxxxxxxxxx func (builder *ImageBuilder) ImageToken(imageToken string) *ImageBuilder { @@ -1592,7 +1592,7 @@ func (builder *LinkBuilder) Build() *Link { type MentionDocument struct { Title *string `json:"title,omitempty"` // 文档标题 ObjectType *string `json:"object_type,omitempty"` // 文档类型 - Token *string `json:"token,omitempty"` // 文档token + Token *string `json:"token,omitempty"` // 文档 token SegmentStyle *SegmentStyle `json:"segment_style,omitempty"` // } @@ -1601,7 +1601,7 @@ type MentionDocumentBuilder struct { titleFlag bool objectType string // 文档类型 objectTypeFlag bool - token string // 文档token + token string // 文档 token tokenFlag bool segmentStyle *SegmentStyle // segmentStyleFlag bool @@ -1630,7 +1630,7 @@ func (builder *MentionDocumentBuilder) ObjectType(objectType string) *MentionDoc return builder } -// 文档token +// 文档 token // // 示例值：shtxxxxxxxxx func (builder *MentionDocumentBuilder) Token(token string) *MentionDocumentBuilder { @@ -1670,7 +1670,7 @@ func (builder *MentionDocumentBuilder) Build() *MentionDocument { type MentionUser struct { Name *string `json:"name,omitempty"` // 用户名 - UserId *string `json:"user_id,omitempty"` // 用户id + UserId *string `json:"user_id,omitempty"` // 用户 id Notify *bool `json:"notify,omitempty"` // 是否通知用户 SegmentStyle *SegmentStyle `json:"segment_style,omitempty"` // } @@ -1678,7 +1678,7 @@ type MentionUser struct { type MentionUserBuilder struct { name string // 用户名 nameFlag bool - userId string // 用户id + userId string // 用户 id userIdFlag bool notify bool // 是否通知用户 notifyFlag bool @@ -1700,7 +1700,7 @@ func (builder *MentionUserBuilder) Name(name string) *MentionUserBuilder { return builder } -// 用户id +// 用户 id // // 示例值：ou_xxxxxxx func (builder *MentionUserBuilder) UserId(userId string) *MentionUserBuilder { @@ -2189,11 +2189,11 @@ func (builder *RichTextValueRangeBuilder) Build() *RichTextValueRange { } type RichValue struct { - Values [][][]*CellValue `json:"values,omitempty"` // 数据，数据结构参见[单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) + Values [][][]*CellValue `json:"values,omitempty"` // 数据，数据结构参见 [单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) } type RichValueBuilder struct { - values [][][]*CellValue // 数据，数据结构参见[单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) + values [][][]*CellValue // 数据，数据结构参见 [单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) valuesFlag bool } @@ -2202,7 +2202,7 @@ func NewRichValueBuilder() *RichValueBuilder { return builder } -// 数据，数据结构参见[单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) +// 数据，数据结构参见 [单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) // // 示例值：数据 func (builder *RichValueBuilder) Values(values [][][]*CellValue) *RichValueBuilder { @@ -2379,7 +2379,7 @@ func (builder *SegmentStyleStyleBuilder) Build() *SegmentStyleStyle { } type Sheet struct { - SheetId *string `json:"sheet_id,omitempty"` // 工作表id + SheetId *string `json:"sheet_id,omitempty"` // 工作表 id Title *string `json:"title,omitempty"` // 工作表标题 Index *int `json:"index,omitempty"` // 工作表索引位置，索引从 0 开始计数。 Hidden *bool `json:"hidden,omitempty"` // 工作表是否被隐藏;- `true`：表示被隐藏;- `false`：表示未被隐藏 @@ -2389,7 +2389,7 @@ type Sheet struct { } type SheetBuilder struct { - sheetId string // 工作表id + sheetId string // 工作表 id sheetIdFlag bool title string // 工作表标题 titleFlag bool @@ -2410,7 +2410,7 @@ func NewSheetBuilder() *SheetBuilder { return builder } -// 工作表id +// 工作表 id // // 示例值：sxj5ws func (builder *SheetBuilder) SheetId(sheetId string) *SheetBuilder { @@ -2507,7 +2507,7 @@ func (builder *SheetBuilder) Build() *Sheet { type SheetFilterInfo struct { Range *string `json:"range,omitempty"` // 筛选应用范围 FilteredOutRows []int `json:"filtered_out_rows,omitempty"` // 筛选出来隐藏的行 - FilterInfos []*FilterInfo `json:"filter_infos,omitempty"` // sheet的筛选条件 + FilterInfos []*FilterInfo `json:"filter_infos,omitempty"` // sheet 的筛选条件 } type SheetFilterInfoBuilder struct { @@ -2515,7 +2515,7 @@ type SheetFilterInfoBuilder struct { rangeFlag bool filteredOutRows []int // 筛选出来隐藏的行 filteredOutRowsFlag bool - filterInfos []*FilterInfo // sheet的筛选条件 + filterInfos []*FilterInfo // sheet 的筛选条件 filterInfosFlag bool } @@ -2542,7 +2542,7 @@ func (builder *SheetFilterInfoBuilder) FilteredOutRows(filteredOutRows []int) *S return builder } -// sheet的筛选条件 +// sheet 的筛选条件 // // 示例值： func (builder *SheetFilterInfoBuilder) FilterInfos(filterInfos []*FilterInfo) *SheetFilterInfoBuilder { @@ -2648,19 +2648,19 @@ func (builder *SheetPropertiesBuilder) Build() *SheetProperties { type Spreadsheet struct { Title *string `json:"title,omitempty"` // 表格标题 - FolderToken *string `json:"folder_token,omitempty"` // 文件夹token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) - Url *string `json:"url,omitempty"` // 文档url - SpreadsheetToken *string `json:"spreadsheet_token,omitempty"` // 表格token + FolderToken *string `json:"folder_token,omitempty"` // 文件夹 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) + Url *string `json:"url,omitempty"` // 文档 url + SpreadsheetToken *string `json:"spreadsheet_token,omitempty"` // 表格 token } type SpreadsheetBuilder struct { title string // 表格标题 titleFlag bool - folderToken string // 文件夹token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) + folderToken string // 文件夹 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) folderTokenFlag bool - url string // 文档url + url string // 文档 url urlFlag bool - spreadsheetToken string // 表格token + spreadsheetToken string // 表格 token spreadsheetTokenFlag bool } @@ -2678,7 +2678,7 @@ func (builder *SpreadsheetBuilder) Title(title string) *SpreadsheetBuilder { return builder } -// 文件夹token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) +// 文件夹 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) // // 示例值：fldcnMsNb*****hIW9IjG1LVswg func (builder *SpreadsheetBuilder) FolderToken(folderToken string) *SpreadsheetBuilder { @@ -2687,7 +2687,7 @@ func (builder *SpreadsheetBuilder) FolderToken(folderToken string) *SpreadsheetB return builder } -// 文档url +// 文档 url // // 示例值：https://bytedance.feishu.cn/sheets/shtcnmBA*****yGehy8 func (builder *SpreadsheetBuilder) Url(url string) *SpreadsheetBuilder { @@ -2696,7 +2696,7 @@ func (builder *SpreadsheetBuilder) Url(url string) *SpreadsheetBuilder { return builder } -// 表格token +// 表格 token // // 示例值：shtcnmBA*****yGehy8 func (builder *SpreadsheetBuilder) SpreadsheetToken(spreadsheetToken string) *SpreadsheetBuilder { @@ -2948,13 +2948,13 @@ func (builder *UpdateSpreadsheetPropertiesBuilder) Build() *UpdateSpreadsheetPro type Value struct { Range *string `json:"range,omitempty"` // 范围 - Values [][][]*CellValue `json:"values,omitempty"` // 数据，数据结构参见[单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) + Values [][][]*CellValue `json:"values,omitempty"` // 数据，数据结构参见 [单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) } type ValueBuilder struct { range_ string // 范围 rangeFlag bool - values [][][]*CellValue // 数据，数据结构参见[单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) + values [][][]*CellValue // 数据，数据结构参见 [单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) valuesFlag bool } @@ -2972,7 +2972,7 @@ func (builder *ValueBuilder) Range(range_ string) *ValueBuilder { return builder } -// 数据，数据结构参见[单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) +// 数据，数据结构参见 [单元格数据结构](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-value/cell-data-structure) // // 示例值：[] func (builder *ValueBuilder) Values(values [][][]*CellValue) *ValueBuilder { @@ -3084,7 +3084,7 @@ func NewGetSpreadsheetReqBuilder() *GetSpreadsheetReqBuilder { return builder } -// 表格的token +// 表格的 token // // 示例值：shtxxxxxxxxxxxxxxx func (builder *GetSpreadsheetReqBuilder) SpreadsheetToken(spreadsheetToken string) *GetSpreadsheetReqBuilder { @@ -3092,7 +3092,7 @@ func (builder *GetSpreadsheetReqBuilder) SpreadsheetToken(spreadsheetToken strin return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetSpreadsheetReqBuilder) UserIdType(userIdType string) *GetSpreadsheetReqBuilder { @@ -3140,7 +3140,7 @@ func NewPatchSpreadsheetReqBuilder() *PatchSpreadsheetReqBuilder { return builder } -// 表格的token +// 表格的 token // // 示例值：shtxxxxxxxxxxxxxxx func (builder *PatchSpreadsheetReqBuilder) SpreadsheetToken(spreadsheetToken string) *PatchSpreadsheetReqBuilder { @@ -3190,7 +3190,7 @@ func NewFindSpreadsheetSheetReqBuilder() *FindSpreadsheetSheetReqBuilder { return builder } -// 表格的token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) +// 表格的 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) // // 示例值：shtcnmBA*****yGehy8 func (builder *FindSpreadsheetSheetReqBuilder) SpreadsheetToken(spreadsheetToken string) *FindSpreadsheetSheetReqBuilder { @@ -3198,7 +3198,7 @@ func (builder *FindSpreadsheetSheetReqBuilder) SpreadsheetToken(spreadsheetToken return builder } -// 工作表的id，获取方式见[获取工作表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) +// 工作表的 id，获取方式见 [获取工作表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) // // 示例值：0b**12 func (builder *FindSpreadsheetSheetReqBuilder) SheetId(sheetId string) *FindSpreadsheetSheetReqBuilder { @@ -3252,7 +3252,7 @@ func NewGetSpreadsheetSheetReqBuilder() *GetSpreadsheetSheetReqBuilder { return builder } -// 表格的token，获取方式见[如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) +// 表格的 token，获取方式见 [如何获取云文档资源相关 token](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN) // // 示例值：shtxxxxxxxxxxxxxxx func (builder *GetSpreadsheetSheetReqBuilder) SpreadsheetToken(spreadsheetToken string) *GetSpreadsheetSheetReqBuilder { @@ -3260,7 +3260,7 @@ func (builder *GetSpreadsheetSheetReqBuilder) SpreadsheetToken(spreadsheetToken return builder } -// 工作表的id，获取方式见[获取工作表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) +// 工作表的 id，获取方式见 [获取工作表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) // // 示例值：giDk9k func (builder *GetSpreadsheetSheetReqBuilder) SheetId(sheetId string) *GetSpreadsheetSheetReqBuilder { @@ -3364,7 +3364,7 @@ func NewQuerySpreadsheetSheetReqBuilder() *QuerySpreadsheetSheetReqBuilder { return builder } -// 电子表格的token +// 电子表格的 token // // 示例值：shtxxxxxxxxxxxxxxxx func (builder *QuerySpreadsheetSheetReqBuilder) SpreadsheetToken(spreadsheetToken string) *QuerySpreadsheetSheetReqBuilder { @@ -3427,7 +3427,7 @@ func (builder *ReplaceSpreadsheetSheetReqBuilder) SheetId(sheetId string) *Repla return builder } -// 按照指定的条件查找子表的某个范围内的数据符合条件的单元格并替换值，返回替换成功的单元格位置。一次请求最多允许替换5000个单元格，如果超过请将range缩小范围再操作。请求体中的 range、find、replaccement 字段必填。 +// 按照指定的条件查找子表的某个范围内的数据符合条件的单元格并替换值，返回替换成功的单元格位置。一次请求最多允许替换 5000 个单元格，如果超过请将 range 缩小范围再操作。请求体中的 range、find、replaccement 字段必填。 func (builder *ReplaceSpreadsheetSheetReqBuilder) Replace(replace *Replace) *ReplaceSpreadsheetSheetReqBuilder { builder.replace = replace return builder @@ -3709,7 +3709,7 @@ func (builder *CreateSpreadsheetSheetFilterViewReqBuilder) SheetId(sheetId strin return builder } -// 根据传入的参数创建一个筛选视图。Id 和 名字可选，不填的话会默认生成；range 必填。Id 长度为10，由 0-9、a-z、A-Z 组合生成。名字长度不超过100。单个子表内的筛选视图个数不超过 150。 +// 根据传入的参数创建一个筛选视图。Id 和 名字可选，不填的话会默认生成；range 必填。Id 长度为 10，由 0-9、a-z、A-Z 组合生成。名字长度不超过 100。单个子表内的筛选视图个数不超过 150。 func (builder *CreateSpreadsheetSheetFilterViewReqBuilder) FilterView(filterView *FilterView) *CreateSpreadsheetSheetFilterViewReqBuilder { builder.filterView = filterView return builder @@ -3899,7 +3899,7 @@ func (builder *PatchSpreadsheetSheetFilterViewReqBuilder) FilterViewId(filterVie return builder } -// 更新筛选视图的名字或者筛选范围。名字长度不超过100，不能重复即子表内唯一；筛选范围不超过子表的最大范围。 +// 更新筛选视图的名字或者筛选范围。名字长度不超过 100，不能重复即子表内唯一；筛选范围不超过子表的最大范围。 func (builder *PatchSpreadsheetSheetFilterViewReqBuilder) FilterView(filterView *FilterView) *PatchSpreadsheetSheetFilterViewReqBuilder { builder.filterView = filterView return builder @@ -4363,7 +4363,7 @@ func (builder *CreateSpreadsheetSheetFloatImageReqBuilder) SheetId(sheetId strin return builder } -// 根据传入的参数创建一张浮动图片。Float_image_token （[上传图片至表格后得到](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all)）和range（只支持一个单元格） 必填。Float_image_id 可选，不填的话会默认生成，长度为10，由 0-9、a-z、A-Z 组合生成。表格内不重复的图片（浮动图片+单元格图片）总数不超过4000。width 和 height 为图片展示的宽高，可选，不填的话会使用图片的真实宽高。offset_x 和 offset_y 为图片左上角距离所在单元格左上角的偏移，可选，默认为 0。 +// 根据传入的参数创建一张浮动图片。Float_image_token（[上传图片至表格后得到](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all)）和 range（只支持一个单元格）必填。Float_image_id 可选，不填的话会默认生成，长度为 10，由 0-9、a-z、A-Z 组合生成。表格内不重复的图片（浮动图片 + 单元格图片）总数不超过 4000。width 和 height 为图片展示的宽高，可选，不填的话会使用图片的真实宽高。offset_x 和 offset_y 为图片左上角距离所在单元格左上角的偏移，可选，默认为 0。 func (builder *CreateSpreadsheetSheetFloatImageReqBuilder) FloatImage(floatImage *FloatImage) *CreateSpreadsheetSheetFloatImageReqBuilder { builder.floatImage = floatImage return builder diff --git a/service/speech_to_text/v1/api.go b/service/speech_to_text/v1/api.go index 941cda9e..4030f32a 100644 --- a/service/speech_to_text/v1/api.go +++ b/service/speech_to_text/v1/api.go @@ -41,9 +41,9 @@ type speech struct { // // - 单租户限流：20QPS，同租户下的应用没有限流，共享本租户的 20QPS 限流 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/speech_to_text-v1/speech/file_recognize +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/speech_to_text-v1/speech/file_recognize // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/speech_to_textv1/fileRecognize_speech.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/speech_to_textv1/fileRecognize_speech.go func (s *speech) FileRecognize(ctx context.Context, req *FileRecognizeSpeechReq, options ...larkcore.RequestOptionFunc) (*FileRecognizeSpeechResp, error) { // 发起请求 apiReq := req.apiReq @@ -67,11 +67,11 @@ func (s *speech) FileRecognize(ctx context.Context, req *FileRecognizeSpeechReq, // // - 语音流式接口，将整个音频文件分片进行传入模型。能够实时返回数据。建议每个音频分片的大小为 100-200ms // -// - 单租户限流：20 路（一个 stream_id 称为一路会话），同租户下的应用没有限流，共享本租户的 20路限流 +// - 单租户限流：20 路（一个 stream_id 称为一路会话），同租户下的应用没有限流，共享本租户的 20 路限流 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/speech_to_text-v1/speech/stream_recognize +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/speech_to_text-v1/speech/stream_recognize // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/speech_to_textv1/streamRecognize_speech.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/speech_to_textv1/streamRecognize_speech.go func (s *speech) StreamRecognize(ctx context.Context, req *StreamRecognizeSpeechReq, options ...larkcore.RequestOptionFunc) (*StreamRecognizeSpeechResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/speech_to_text/v1/model.go b/service/speech_to_text/v1/model.go index d5646ac4..2aeb5f5e 100644 --- a/service/speech_to_text/v1/model.go +++ b/service/speech_to_text/v1/model.go @@ -82,14 +82,14 @@ func (builder *FileConfigBuilder) Build() *FileConfig { } type Speech struct { - Speech *string `json:"speech,omitempty"` // pcm格式音频文件（文件识别）或音频分片（流式识别）经base64编码后的内容 - SpeechKey *string `json:"speech_key,omitempty"` // 上传到 drive 存储平台后获取到的 key （暂不支持） + Speech *string `json:"speech,omitempty"` // pcm 格式音频文件（文件识别）或音频分片（流式识别）经 base64 编码后的内容 + SpeechKey *string `json:"speech_key,omitempty"` // 上传到 drive 存储平台后获取到的 key（暂不支持） } type SpeechBuilder struct { - speech string // pcm格式音频文件（文件识别）或音频分片（流式识别）经base64编码后的内容 + speech string // pcm 格式音频文件（文件识别）或音频分片（流式识别）经 base64 编码后的内容 speechFlag bool - speechKey string // 上传到 drive 存储平台后获取到的 key （暂不支持） + speechKey string // 上传到 drive 存储平台后获取到的 key（暂不支持） speechKeyFlag bool } @@ -98,7 +98,7 @@ func NewSpeechBuilder() *SpeechBuilder { return builder } -// pcm格式音频文件（文件识别）或音频分片（流式识别）经base64编码后的内容 +// pcm 格式音频文件（文件识别）或音频分片（流式识别）经 base64 编码后的内容 // // 示例值：PdmrfE267Cd/Z9KpmNFh71A2PSJZxSp7+8upCg== func (builder *SpeechBuilder) Speech(speech string) *SpeechBuilder { @@ -107,7 +107,7 @@ func (builder *SpeechBuilder) Speech(speech string) *SpeechBuilder { return builder } -// 上传到 drive 存储平台后获取到的 key （暂不支持） +// 上传到 drive 存储平台后获取到的 key（暂不支持） // // 示例值： func (builder *SpeechBuilder) SpeechKey(speechKey string) *SpeechBuilder { diff --git a/service/task/v1/api.go b/service/task/v1/api.go index ad857718..7da2f46c 100644 --- a/service/task/v1/api.go +++ b/service/task/v1/api.go @@ -59,9 +59,9 @@ type taskReminder struct { // // - 该接口用于批量删除执行者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/batch_delete_collaborator +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/batch_delete_collaborator // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/batchDeleteCollaborator_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/batchDeleteCollaborator_task.go func (t *task) BatchDeleteCollaborator(ctx context.Context, req *BatchDeleteCollaboratorTaskReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteCollaboratorTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -85,9 +85,9 @@ func (t *task) BatchDeleteCollaborator(ctx context.Context, req *BatchDeleteColl // // - 该接口用于批量删除关注人 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/batch_delete_follower +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/batch_delete_follower // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/batchDeleteFollower_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/batchDeleteFollower_task.go func (t *task) BatchDeleteFollower(ctx context.Context, req *BatchDeleteFollowerTaskReq, options ...larkcore.RequestOptionFunc) (*BatchDeleteFollowerTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -109,11 +109,11 @@ func (t *task) BatchDeleteFollower(ctx context.Context, req *BatchDeleteFollower // 完成任务 // -// - 该接口用于将任务状态修改为“已完成”。;完成任务是指整个任务全部完成，而不支持执行者分别完成任务，执行成功后，任务对所有关联用户都变为完成状态。 +// - 该接口用于将任务状态修改为 “已完成”。;完成任务是指整个任务全部完成，而不支持执行者分别完成任务，执行成功后，任务对所有关联用户都变为完成状态。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/complete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/complete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/complete_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/complete_task.go func (t *task) Complete(ctx context.Context, req *CompleteTaskReq, options ...larkcore.RequestOptionFunc) (*CompleteTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -137,9 +137,9 @@ func (t *task) Complete(ctx context.Context, req *CompleteTaskReq, options ...la // // - 该接口可以创建一个任务，支持填写任务的基本信息，包括任务的标题，描述及协作者等。;在此基础上，创建任务时可以设置截止时间和重复规则，将任务设置为定期执行的重复任务。通过添加协作者，则可以让其他用户协同完成该任务。;此外，接口也提供了一些支持自定义内容的字段，调用方可以实现定制化效果，如完成任务后跳转到指定结束界面。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_task.go func (t *task) Create(ctx context.Context, req *CreateTaskReq, options ...larkcore.RequestOptionFunc) (*CreateTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -163,9 +163,9 @@ func (t *task) Create(ctx context.Context, req *CreateTaskReq, options ...larkco // // - 该接口用于删除任务 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_task.go func (t *task) Delete(ctx context.Context, req *DeleteTaskReq, options ...larkcore.RequestOptionFunc) (*DeleteTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -189,9 +189,9 @@ func (t *task) Delete(ctx context.Context, req *DeleteTaskReq, options ...larkco // // - 该接口用于获取任务详情，包括任务标题、描述、时间、来源等信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/get_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/get_task.go func (t *task) Get(ctx context.Context, req *GetTaskReq, options ...larkcore.RequestOptionFunc) (*GetTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -213,11 +213,11 @@ func (t *task) Get(ctx context.Context, req *GetTaskReq, options ...larkcore.Req // 获取任务列表 // -// - 以分页的方式获取任务列表。当使用user_access_token时，获取与该用户身份相关的所有任务。当使用tenant_access_token时，获取以该应用身份通过“创建任务“接口创建的所有任务（并非获取该应用所在租户下所有用户创建的任务）。;本接口支持通过任务创建时间以及任务的完成状态对任务进行过滤。 +// - 以分页的方式获取任务列表。当使用 user_access_token 时，获取与该用户身份相关的所有任务。当使用 tenant_access_token 时，获取以该应用身份通过 “创建任务 “接口创建的所有任务（并非获取该应用所在租户下所有用户创建的任务）。;本接口支持通过任务创建时间以及任务的完成状态对任务进行过滤。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_task.go func (t *task) List(ctx context.Context, req *ListTaskReq, options ...larkcore.RequestOptionFunc) (*ListTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -249,9 +249,9 @@ func (t *task) ListByIterator(ctx context.Context, req *ListTaskReq, options ... // // - 该接口用于修改任务的标题、描述、时间、来源等相关信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/patch_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/patch_task.go func (t *task) Patch(ctx context.Context, req *PatchTaskReq, options ...larkcore.RequestOptionFunc) (*PatchTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -275,9 +275,9 @@ func (t *task) Patch(ctx context.Context, req *PatchTaskReq, options ...larkcore // // - 该接口用于取消任务的已完成状态 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/uncomplete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/uncomplete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/uncomplete_task.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/uncomplete_task.go func (t *task) Uncomplete(ctx context.Context, req *UncompleteTaskReq, options ...larkcore.RequestOptionFunc) (*UncompleteTaskResp, error) { // 发起请求 apiReq := req.apiReq @@ -301,9 +301,9 @@ func (t *task) Uncomplete(ctx context.Context, req *UncompleteTaskReq, options . // // - 该接口用于新增任务执行者，一次性可以添加多个执行者。;只有任务的创建者和执行者才能添加执行者，关注人无权限添加。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-collaborator/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-collaborator/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskCollaborator.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskCollaborator.go func (t *taskCollaborator) Create(ctx context.Context, req *CreateTaskCollaboratorReq, options ...larkcore.RequestOptionFunc) (*CreateTaskCollaboratorResp, error) { // 发起请求 apiReq := req.apiReq @@ -327,9 +327,9 @@ func (t *taskCollaborator) Create(ctx context.Context, req *CreateTaskCollaborat // // - 该接口用于删除任务执行者 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-collaborator/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-collaborator/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskCollaborator.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskCollaborator.go func (t *taskCollaborator) Delete(ctx context.Context, req *DeleteTaskCollaboratorReq, options ...larkcore.RequestOptionFunc) (*DeleteTaskCollaboratorResp, error) { // 发起请求 apiReq := req.apiReq @@ -351,11 +351,11 @@ func (t *taskCollaborator) Delete(ctx context.Context, req *DeleteTaskCollaborat // 获取一个任务的执行者列表 // -// - 该接口用于查询任务执行者列表，支持分页，最大值为50 +// - 该接口用于查询任务执行者列表，支持分页，最大值为 50 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-collaborator/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-collaborator/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskCollaborator.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskCollaborator.go func (t *taskCollaborator) List(ctx context.Context, req *ListTaskCollaboratorReq, options ...larkcore.RequestOptionFunc) (*ListTaskCollaboratorResp, error) { // 发起请求 apiReq := req.apiReq @@ -385,11 +385,11 @@ func (t *taskCollaborator) ListByIterator(ctx context.Context, req *ListTaskColl // 创建评论 // -// - 该接口用于创建和回复任务的评论。当parent_id字段为0时，为创建评论；当parent_id不为0时，为回复某条评论 +// - 该接口用于创建和回复任务的评论。当 parent_id 字段为 0 时，为创建评论；当 parent_id 不为 0 时，为回复某条评论 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskComment.go func (t *taskComment) Create(ctx context.Context, req *CreateTaskCommentReq, options ...larkcore.RequestOptionFunc) (*CreateTaskCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -411,11 +411,11 @@ func (t *taskComment) Create(ctx context.Context, req *CreateTaskCommentReq, opt // 删除评论 // -// - 该接口用于通过评论ID删除评论 +// - 该接口用于通过评论 ID 删除评论 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskComment.go func (t *taskComment) Delete(ctx context.Context, req *DeleteTaskCommentReq, options ...larkcore.RequestOptionFunc) (*DeleteTaskCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -437,11 +437,11 @@ func (t *taskComment) Delete(ctx context.Context, req *DeleteTaskCommentReq, opt // 获取评论详情 // -// - 该接口用于通过评论ID获取评论详情 +// - 该接口用于通过评论 ID 获取评论详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/get_taskComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/get_taskComment.go func (t *taskComment) Get(ctx context.Context, req *GetTaskCommentReq, options ...larkcore.RequestOptionFunc) (*GetTaskCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -463,11 +463,11 @@ func (t *taskComment) Get(ctx context.Context, req *GetTaskCommentReq, options . // 获取评论列表 // -// - 该接口用于查询任务评论列表，支持分页，最大值为100 +// - 该接口用于查询任务评论列表，支持分页，最大值为 100 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskComment.go func (t *taskComment) List(ctx context.Context, req *ListTaskCommentReq, options ...larkcore.RequestOptionFunc) (*ListTaskCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -499,9 +499,9 @@ func (t *taskComment) ListByIterator(ctx context.Context, req *ListTaskCommentRe // // - 该接口用于更新评论内容 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-comment/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/update_taskComment.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/update_taskComment.go func (t *taskComment) Update(ctx context.Context, req *UpdateTaskCommentReq, options ...larkcore.RequestOptionFunc) (*UpdateTaskCommentResp, error) { // 发起请求 apiReq := req.apiReq @@ -523,11 +523,11 @@ func (t *taskComment) Update(ctx context.Context, req *UpdateTaskCommentReq, opt // 新增关注人 // -// - 该接口用于创建任务关注人。可以一次性添加多位关注人。关注人ID要使用表示用户的ID。 +// - 该接口用于创建任务关注人。可以一次性添加多位关注人。关注人 ID 要使用表示用户的 ID。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-follower/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-follower/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskFollower.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskFollower.go func (t *taskFollower) Create(ctx context.Context, req *CreateTaskFollowerReq, options ...larkcore.RequestOptionFunc) (*CreateTaskFollowerResp, error) { // 发起请求 apiReq := req.apiReq @@ -551,9 +551,9 @@ func (t *taskFollower) Create(ctx context.Context, req *CreateTaskFollowerReq, o // // - 该接口用于删除任务关注人 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-follower/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-follower/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskFollower.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskFollower.go func (t *taskFollower) Delete(ctx context.Context, req *DeleteTaskFollowerReq, options ...larkcore.RequestOptionFunc) (*DeleteTaskFollowerResp, error) { // 发起请求 apiReq := req.apiReq @@ -575,11 +575,11 @@ func (t *taskFollower) Delete(ctx context.Context, req *DeleteTaskFollowerReq, o // 获取任务关注人列表 // -// - 该接口用于查询任务关注人列表，支持分页，最大值为50 +// - 该接口用于查询任务关注人列表，支持分页，最大值为 50 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-follower/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-follower/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskFollower.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskFollower.go func (t *taskFollower) List(ctx context.Context, req *ListTaskFollowerReq, options ...larkcore.RequestOptionFunc) (*ListTaskFollowerResp, error) { // 发起请求 apiReq := req.apiReq @@ -611,9 +611,9 @@ func (t *taskFollower) ListByIterator(ctx context.Context, req *ListTaskFollower // // - 该接口用于创建任务的提醒时间。提醒时间在截止时间基础上做偏移，但是偏移后的结果不能早于当前时间。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-reminder/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-reminder/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskReminder.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/create_taskReminder.go func (t *taskReminder) Create(ctx context.Context, req *CreateTaskReminderReq, options ...larkcore.RequestOptionFunc) (*CreateTaskReminderResp, error) { // 发起请求 apiReq := req.apiReq @@ -637,9 +637,9 @@ func (t *taskReminder) Create(ctx context.Context, req *CreateTaskReminderReq, o // // - 删除提醒时间，返回结果状态 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-reminder/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-reminder/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskReminder.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/delete_taskReminder.go func (t *taskReminder) Delete(ctx context.Context, req *DeleteTaskReminderReq, options ...larkcore.RequestOptionFunc) (*DeleteTaskReminderResp, error) { // 发起请求 apiReq := req.apiReq @@ -661,11 +661,11 @@ func (t *taskReminder) Delete(ctx context.Context, req *DeleteTaskReminderReq, o // 查询提醒时间列表 // -// - 返回提醒时间列表，支持分页，最大值为50 +// - 返回提醒时间列表，支持分页，最大值为 50 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-reminder/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task-reminder/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskReminder.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/taskv1/list_taskReminder.go func (t *taskReminder) List(ctx context.Context, req *ListTaskReminderReq, options ...larkcore.RequestOptionFunc) (*ListTaskReminderResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/task/v1/event.go b/service/task/v1/event.go index 6eb1fd06..c1e21bd1 100644 --- a/service/task/v1/event.go +++ b/service/task/v1/event.go @@ -32,7 +32,7 @@ func (h *P2TaskUpdateTenantV1Handler) Event() interface{} { return &P2TaskUpdateTenantV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2TaskUpdateTenantV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2TaskUpdateTenantV1)) } @@ -52,7 +52,7 @@ func (h *P2TaskUpdatedV1Handler) Event() interface{} { return &P2TaskUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2TaskUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2TaskUpdatedV1)) } @@ -72,7 +72,7 @@ func (h *P2TaskCommentUpdatedV1Handler) Event() interface{} { return &P2TaskCommentUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2TaskCommentUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2TaskCommentUpdatedV1)) } diff --git a/service/task/v1/model.go b/service/task/v1/model.go index e6d2344a..cc54f564 100644 --- a/service/task/v1/model.go +++ b/service/task/v1/model.go @@ -25,69 +25,69 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeBatchDeleteFollowerTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeBatchDeleteFollowerTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeBatchDeleteFollowerTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeBatchDeleteFollowerTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeBatchDeleteFollowerTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeBatchDeleteFollowerTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypePatchTaskUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchTaskUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchTaskOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchTaskUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchTaskUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchTaskOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateTaskCollaboratorUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateTaskCollaboratorUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateTaskCollaboratorOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateTaskCollaboratorUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateTaskCollaboratorUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateTaskCollaboratorOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeDeleteTaskCollaboratorUserId = "user_id" // 以user_id来识别用户 - UserIdTypeDeleteTaskCollaboratorUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeDeleteTaskCollaboratorOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeDeleteTaskCollaboratorUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeDeleteTaskCollaboratorUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeDeleteTaskCollaboratorOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListTaskCollaboratorUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListTaskCollaboratorUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListTaskCollaboratorOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListTaskCollaboratorUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListTaskCollaboratorUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListTaskCollaboratorOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateTaskCommentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateTaskCommentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateTaskCommentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateTaskCommentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateTaskCommentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateTaskCommentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetTaskCommentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetTaskCommentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetTaskCommentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetTaskCommentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetTaskCommentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetTaskCommentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -97,44 +97,44 @@ const ( ) const ( - UserIdTypeListTaskCommentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListTaskCommentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListTaskCommentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListTaskCommentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListTaskCommentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListTaskCommentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateTaskCommentUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateTaskCommentUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateTaskCommentOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeUpdateTaskCommentUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateTaskCommentUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateTaskCommentOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateTaskFollowerUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateTaskFollowerUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateTaskFollowerOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeCreateTaskFollowerUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateTaskFollowerUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateTaskFollowerOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeDeleteTaskFollowerUserId = "user_id" // 以user_id来识别用户 - UserIdTypeDeleteTaskFollowerUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeDeleteTaskFollowerOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeDeleteTaskFollowerUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeDeleteTaskFollowerUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeDeleteTaskFollowerOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeListTaskFollowerUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListTaskFollowerUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListTaskFollowerOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeListTaskFollowerUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListTaskFollowerUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListTaskFollowerOpenId = "open_id" // 以 open_id 来识别用户 ) type Attachment struct { } type Attatchment struct { - Guid *string `json:"guid,omitempty"` // 全局唯一ID + Guid *string `json:"guid,omitempty"` // 全局唯一 ID } type AttatchmentBuilder struct { - guid string // 全局唯一ID + guid string // 全局唯一 ID guidFlag bool } @@ -143,7 +143,7 @@ func NewAttatchmentBuilder() *AttatchmentBuilder { return builder } -// 全局唯一ID +// 全局唯一 ID // // 示例值：dddd func (builder *AttatchmentBuilder) Guid(guid string) *AttatchmentBuilder { @@ -162,14 +162,14 @@ func (builder *AttatchmentBuilder) Build() *Attatchment { } type Collaborator struct { - Id *string `json:"id,omitempty"` // 任务执行者的 ID。;传入的值为 user_id 或 open_id，由user_id_type 决定。user_id和open_id的获取可见文档[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。;;已经废弃，为了向前兼容早期只支持单次添加一个人的情况而保留，但不再推荐使用，建议使用id_list字段; - IdList []string `json:"id_list,omitempty"` // 执行者的用户ID列表。;传入的值为 user_id 或 open_id，由user_id_type 决定。user_id和open_id的获取可见文档[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 + Id *string `json:"id,omitempty"` // 任务执行者的 ID。;传入的值为 user_id 或 open_id，由 user_id_type 决定。user_id 和 open_id 的获取可见文档 [如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。;;已经废弃，为了向前兼容早期只支持单次添加一个人的情况而保留，但不再推荐使用，建议使用 id_list 字段; + IdList []string `json:"id_list,omitempty"` // 执行者的用户 ID 列表。;传入的值为 user_id 或 open_id，由 user_id_type 决定。user_id 和 open_id 的获取可见文档 [如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 } type CollaboratorBuilder struct { - id string // 任务执行者的 ID。;传入的值为 user_id 或 open_id，由user_id_type 决定。user_id和open_id的获取可见文档[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。;;已经废弃，为了向前兼容早期只支持单次添加一个人的情况而保留，但不再推荐使用，建议使用id_list字段; + id string // 任务执行者的 ID。;传入的值为 user_id 或 open_id，由 user_id_type 决定。user_id 和 open_id 的获取可见文档 [如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。;;已经废弃，为了向前兼容早期只支持单次添加一个人的情况而保留，但不再推荐使用，建议使用 id_list 字段; idFlag bool - idList []string // 执行者的用户ID列表。;传入的值为 user_id 或 open_id，由user_id_type 决定。user_id和open_id的获取可见文档[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 + idList []string // 执行者的用户 ID 列表。;传入的值为 user_id 或 open_id，由 user_id_type 决定。user_id 和 open_id 的获取可见文档 [如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 idListFlag bool } @@ -178,7 +178,7 @@ func NewCollaboratorBuilder() *CollaboratorBuilder { return builder } -// 任务执行者的 ID。;传入的值为 user_id 或 open_id，由user_id_type 决定。user_id和open_id的获取可见文档[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。;;已经废弃，为了向前兼容早期只支持单次添加一个人的情况而保留，但不再推荐使用，建议使用id_list字段; +// 任务执行者的 ID。;传入的值为 user_id 或 open_id，由 user_id_type 决定。user_id 和 open_id 的获取可见文档 [如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。;;已经废弃，为了向前兼容早期只支持单次添加一个人的情况而保留，但不再推荐使用，建议使用 id_list 字段; // // 示例值：ou_99e1a581b36ecc4862cbfbce473f1234 func (builder *CollaboratorBuilder) Id(id string) *CollaboratorBuilder { @@ -187,7 +187,7 @@ func (builder *CollaboratorBuilder) Id(id string) *CollaboratorBuilder { return builder } -// 执行者的用户ID列表。;传入的值为 user_id 或 open_id，由user_id_type 决定。user_id和open_id的获取可见文档[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 +// 执行者的用户 ID 列表。;传入的值为 user_id 或 open_id，由 user_id_type 决定。user_id 和 open_id 的获取可见文档 [如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 // // 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0"] func (builder *CollaboratorBuilder) IdList(idList []string) *CollaboratorBuilder { @@ -210,23 +210,23 @@ func (builder *CollaboratorBuilder) Build() *Collaborator { type Comment struct { Content *string `json:"content,omitempty"` // 评论内容。;;评论内容和富文本评论内容同时存在时只使用富文本评论内容。; - ParentId *string `json:"parent_id,omitempty"` // 评论的父ID，创建评论时若不为空则为某条评论的回复，若为空则不是回复 - Id *string `json:"id,omitempty"` // 评论ID，由飞书服务器发号 + ParentId *string `json:"parent_id,omitempty"` // 评论的父 ID，创建评论时若不为空则为某条评论的回复，若为空则不是回复 + Id *string `json:"id,omitempty"` // 评论 ID，由飞书服务器发号 CreateMilliTime *string `json:"create_milli_time,omitempty"` // 评论创建的时间戳，单位为毫秒，用于展示，创建时不用填写 - RichContent *string `json:"rich_content,omitempty"` // 富文本评论内容。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) + RichContent *string `json:"rich_content,omitempty"` // 富文本评论内容。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) CreatorId *string `json:"creator_id,omitempty"` // 评论的创建者 ID。在创建评论时无需填充该字段 } type CommentBuilder struct { content string // 评论内容。;;评论内容和富文本评论内容同时存在时只使用富文本评论内容。; contentFlag bool - parentId string // 评论的父ID，创建评论时若不为空则为某条评论的回复，若为空则不是回复 + parentId string // 评论的父 ID，创建评论时若不为空则为某条评论的回复，若为空则不是回复 parentIdFlag bool - id string // 评论ID，由飞书服务器发号 + id string // 评论 ID，由飞书服务器发号 idFlag bool createMilliTime string // 评论创建的时间戳，单位为毫秒，用于展示，创建时不用填写 createMilliTimeFlag bool - richContent string // 富文本评论内容。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) + richContent string // 富文本评论内容。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) richContentFlag bool creatorId string // 评论的创建者 ID。在创建评论时无需填充该字段 creatorIdFlag bool @@ -246,7 +246,7 @@ func (builder *CommentBuilder) Content(content string) *CommentBuilder { return builder } -// 评论的父ID，创建评论时若不为空则为某条评论的回复，若为空则不是回复 +// 评论的父 ID，创建评论时若不为空则为某条评论的回复，若为空则不是回复 // // 示例值：6937231762296684564 func (builder *CommentBuilder) ParentId(parentId string) *CommentBuilder { @@ -255,7 +255,7 @@ func (builder *CommentBuilder) ParentId(parentId string) *CommentBuilder { return builder } -// 评论ID，由飞书服务器发号 +// 评论 ID，由飞书服务器发号 // // 示例值：6937231762296684564 func (builder *CommentBuilder) Id(id string) *CommentBuilder { @@ -273,7 +273,7 @@ func (builder *CommentBuilder) CreateMilliTime(createMilliTime string) *CommentB return builder } -// 富文本评论内容。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) +// 富文本评论内容。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) // // 示例值：举杯邀明月，对影成三人 func (builder *CommentBuilder) RichContent(richContent string) *CommentBuilder { @@ -321,15 +321,15 @@ func (builder *CommentBuilder) Build() *Comment { } type Due struct { - Time *string `json:"time,omitempty"` // 表示截止时间的Unix时间戳（单位为秒）。 - Timezone *string `json:"timezone,omitempty"` // 截止时间对应的时区。;传入值需要符合IANA Time Zone Database标准，规范见[Time Zone Database](https://www.iana.org/time-zones)。 + Time *string `json:"time,omitempty"` // 表示截止时间的 Unix 时间戳（单位为秒）。 + Timezone *string `json:"timezone,omitempty"` // 截止时间对应的时区。;传入值需要符合 IANA Time Zone Database 标准，规范见 [Time Zone Database](https://www.iana.org/time-zones)。 IsAllDay *bool `json:"is_all_day,omitempty"` // 标记任务是否为全天任务。;包括如下取值：;- true：表示是全天任务，全天任务的截止时间为当天 UTC 时间的 0 点。;- false：表示不是全天任务。 } type DueBuilder struct { - time string // 表示截止时间的Unix时间戳（单位为秒）。 + time string // 表示截止时间的 Unix 时间戳（单位为秒）。 timeFlag bool - timezone string // 截止时间对应的时区。;传入值需要符合IANA Time Zone Database标准，规范见[Time Zone Database](https://www.iana.org/time-zones)。 + timezone string // 截止时间对应的时区。;传入值需要符合 IANA Time Zone Database 标准，规范见 [Time Zone Database](https://www.iana.org/time-zones)。 timezoneFlag bool isAllDay bool // 标记任务是否为全天任务。;包括如下取值：;- true：表示是全天任务，全天任务的截止时间为当天 UTC 时间的 0 点。;- false：表示不是全天任务。 isAllDayFlag bool @@ -340,7 +340,7 @@ func NewDueBuilder() *DueBuilder { return builder } -// 表示截止时间的Unix时间戳（单位为秒）。 +// 表示截止时间的 Unix 时间戳（单位为秒）。 // // 示例值：1623124318 func (builder *DueBuilder) Time(time string) *DueBuilder { @@ -349,7 +349,7 @@ func (builder *DueBuilder) Time(time string) *DueBuilder { return builder } -// 截止时间对应的时区。;传入值需要符合IANA Time Zone Database标准，规范见[Time Zone Database](https://www.iana.org/time-zones)。 +// 截止时间对应的时区。;传入值需要符合 IANA Time Zone Database 标准，规范见 [Time Zone Database](https://www.iana.org/time-zones)。 // // 示例值：Asia/Shanghai func (builder *DueBuilder) Timezone(timezone string) *DueBuilder { @@ -386,13 +386,13 @@ func (builder *DueBuilder) Build() *Due { type Follower struct { Id *string `json:"id,omitempty"` // 任务关注人 ID - IdList []string `json:"id_list,omitempty"` // 要删除的关注人ID列表 + IdList []string `json:"id_list,omitempty"` // 要删除的关注人 ID 列表 } type FollowerBuilder struct { id string // 任务关注人 ID idFlag bool - idList []string // 要删除的关注人ID列表 + idList []string // 要删除的关注人 ID 列表 idListFlag bool } @@ -410,7 +410,7 @@ func (builder *FollowerBuilder) Id(id string) *FollowerBuilder { return builder } -// 要删除的关注人ID列表 +// 要删除的关注人 ID 列表 // // 示例值：[; "ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0";] func (builder *FollowerBuilder) IdList(idList []string) *FollowerBuilder { @@ -432,12 +432,12 @@ func (builder *FollowerBuilder) Build() *Follower { } type Href struct { - Url *string `json:"url,omitempty"` // 具体链接地址。;URL仅支持解析http、https。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) + Url *string `json:"url,omitempty"` // 具体链接地址。;URL 仅支持解析 http、https。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) Title *string `json:"title,omitempty"` // 链接对应的标题 } type HrefBuilder struct { - url string // 具体链接地址。;URL仅支持解析http、https。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) + url string // 具体链接地址。;URL 仅支持解析 http、https。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) urlFlag bool title string // 链接对应的标题 titleFlag bool @@ -448,7 +448,7 @@ func NewHrefBuilder() *HrefBuilder { return builder } -// 具体链接地址。;URL仅支持解析http、https。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) +// 具体链接地址。;URL 仅支持解析 http、https。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) // // 示例值：https://support.feishu.com/internal/foo-bar func (builder *HrefBuilder) Url(url string) *HrefBuilder { @@ -528,13 +528,13 @@ func (builder *OriginBuilder) Build() *Origin { type Reminder struct { Id *string `json:"id,omitempty"` // 提醒时间设置的 ID（在删除时候需要使用这个） - RelativeFireMinute *int `json:"relative_fire_minute,omitempty"` // 相对于截止时间的提醒时间（如提前 30 分钟，截止时间后 30 分钟，则为 -30） 任务没有截止时间则为全天任务(截止时间为0) + RelativeFireMinute *int `json:"relative_fire_minute,omitempty"` // 相对于截止时间的提醒时间（如提前 30 分钟，截止时间后 30 分钟，则为 -30）任务没有截止时间则为全天任务 (截止时间为 0) } type ReminderBuilder struct { id string // 提醒时间设置的 ID（在删除时候需要使用这个） idFlag bool - relativeFireMinute int // 相对于截止时间的提醒时间（如提前 30 分钟，截止时间后 30 分钟，则为 -30） 任务没有截止时间则为全天任务(截止时间为0) + relativeFireMinute int // 相对于截止时间的提醒时间（如提前 30 分钟，截止时间后 30 分钟，则为 -30）任务没有截止时间则为全天任务 (截止时间为 0) relativeFireMinuteFlag bool } @@ -552,7 +552,7 @@ func (builder *ReminderBuilder) Id(id string) *ReminderBuilder { return builder } -// 相对于截止时间的提醒时间（如提前 30 分钟，截止时间后 30 分钟，则为 -30） 任务没有截止时间则为全天任务(截止时间为0) +// 相对于截止时间的提醒时间（如提前 30 分钟，截止时间后 30 分钟，则为 -30）任务没有截止时间则为全天任务 (截止时间为 0) // // 示例值：30 func (builder *ReminderBuilder) RelativeFireMinute(relativeFireMinute int) *ReminderBuilder { @@ -575,50 +575,50 @@ func (builder *ReminderBuilder) Build() *Reminder { } type Task struct { - Id *string `json:"id,omitempty"` // 任务的唯一ID，例如"83912691-2e43-47fc-94a4-d512e03984fa" - Summary *string `json:"summary,omitempty"` // 任务的标题，类型为文本字符串。;如果要在任务标题中插入 URL 或者 @某个用户，请使用rich_summary字段。;创建任务时，任务标题(summary字段)和任务富文本标题(rich_summary字段)不能同时为空，需要至少填充其中一个字段。;;任务标题和任务富文本标题同时存在时只使用富文本标题。; - Description *string `json:"description,omitempty"` // 任务的描述，类型为文本字符串。;如果要在任务描述中插入 URL 或者 @某个用户，请使用rich_description字段。;;任务备注和任务富文本备注同时存在时只使用富文本备注。; - CompleteTime *string `json:"complete_time,omitempty"` // 任务的完成时间戳（单位为秒），完成时间为0则表示任务尚未完成。;不支持部分完成，只有整个任务完成，该字段才会有非0值。 - CreatorId *string `json:"creator_id,omitempty"` // 任务的创建者 ID。;其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型，不传时默认返回 open_id。;特别的，使用tenant_access_token 调用接口时，如果是user_id_type是openid，则返回代表该应用身份的openid；当user_id_type为user_id时，不返回creator_id。原因是user_id代表一个真实飞书用户的id，应用身份没有user_id。使用user_access_token调用接口正常返回创建者。 - Extra *string `json:"extra,omitempty"` // 附属信息。;接入方可以传入base64 编码后的自定义的数据。用户如果需要对当前任务备注信息，但对外不显示，可使用该字段进行存储。;该数据会在获取任务详情时，原样返回给用户。 - CreateTime *string `json:"create_time,omitempty"` // 任务的创建时间的Unix时间戳（单位为秒） - UpdateTime *string `json:"update_time,omitempty"` // 任务的更新时间的Unix时间戳（单位为秒）;创建任务时update_time与create_time相同 + Id *string `json:"id,omitempty"` // 任务的唯一 ID，例如"83912691-2e43-47fc-94a4-d512e03984fa" + Summary *string `json:"summary,omitempty"` // 任务的标题，类型为文本字符串。;如果要在任务标题中插入 URL 或者 @某个用户，请使用 rich_summary 字段。;创建任务时，任务标题 (summary 字段) 和任务富文本标题 (rich_summary 字段) 不能同时为空，需要至少填充其中一个字段。;;任务标题和任务富文本标题同时存在时只使用富文本标题。; + Description *string `json:"description,omitempty"` // 任务的描述，类型为文本字符串。;如果要在任务描述中插入 URL 或者 @某个用户，请使用 rich_description 字段。;;任务备注和任务富文本备注同时存在时只使用富文本备注。; + CompleteTime *string `json:"complete_time,omitempty"` // 任务的完成时间戳（单位为秒），完成时间为 0 则表示任务尚未完成。;不支持部分完成，只有整个任务完成，该字段才会有非 0 值。 + CreatorId *string `json:"creator_id,omitempty"` // 任务的创建者 ID。;其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型，不传时默认返回 open_id。;特别的，使用 tenant_access_token 调用接口时，如果是 user_id_type 是 openid，则返回代表该应用身份的 openid；当 user_id_type 为 user_id 时，不返回 creator_id。原因是 user_id 代表一个真实飞书用户的 id，应用身份没有 user_id。使用 user_access_token 调用接口正常返回创建者。 + Extra *string `json:"extra,omitempty"` // 附属信息。;接入方可以传入 base64 编码后的自定义的数据。用户如果需要对当前任务备注信息，但对外不显示，可使用该字段进行存储。;该数据会在获取任务详情时，原样返回给用户。 + CreateTime *string `json:"create_time,omitempty"` // 任务的创建时间的 Unix 时间戳（单位为秒） + UpdateTime *string `json:"update_time,omitempty"` // 任务的更新时间的 Unix 时间戳（单位为秒）;创建任务时 update_time 与 create_time 相同 Due *Due `json:"due,omitempty"` // 任务的截止时间设置 Origin *Origin `json:"origin,omitempty"` // 任务关联的第三方平台来源信息 - CanEdit *bool `json:"can_edit,omitempty"` // 此字段用于控制该任务在飞书任务中心是否可编辑，默认为false;;已经废弃，向前兼容故仍然保留，但不推荐使用; + CanEdit *bool `json:"can_edit,omitempty"` // 此字段用于控制该任务在飞书任务中心是否可编辑，默认为 false;;已经废弃，向前兼容故仍然保留，但不推荐使用; Custom *string `json:"custom,omitempty"` // 自定义完成配置。;此字段用于设置完成任务时的页面跳转，或展示提示语。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) Source *int `json:"source,omitempty"` // 任务创建的来源 Followers []*Follower `json:"followers,omitempty"` // 任务的关注者 Collaborators []*Collaborator `json:"collaborators,omitempty"` // 任务的执行者 - CollaboratorIds []string `json:"collaborator_ids,omitempty"` // 创建任务时添加的执行者用户id列表。;传入的值为 user_id 或 open_id ，由user_id_type 决定。user_id和open_id的获取可见文档：[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 - FollowerIds []string `json:"follower_ids,omitempty"` // 创建任务时添加的关注者用户id列表。;传入的值为 user_id 或 open_id ，由user_id_type 决定。user_id和open_id的获取可见文档：[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 - RepeatRule *string `json:"repeat_rule,omitempty"` // 重复任务的规则表达式。;语法格式参见[RRule语法规范](https://www.ietf.org/rfc/rfc2445.txt) 4.3.10小节 - RichSummary *string `json:"rich_summary,omitempty"` // 富文本任务标题。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module);。创建任务时，任务标题(summary字段)和任务富文本标题(rich_summary字段)不能同时为空，需要至少填充其中一个字段。 - RichDescription *string `json:"rich_description,omitempty"` // 富文本任务备注。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) + CollaboratorIds []string `json:"collaborator_ids,omitempty"` // 创建任务时添加的执行者用户 id 列表。;传入的值为 user_id 或 open_id ，由 user_id_type 决定。user_id 和 open_id 的获取可见文档：[如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 + FollowerIds []string `json:"follower_ids,omitempty"` // 创建任务时添加的关注者用户 id 列表。;传入的值为 user_id 或 open_id ，由 user_id_type 决定。user_id 和 open_id 的获取可见文档：[如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 + RepeatRule *string `json:"repeat_rule,omitempty"` // 重复任务的规则表达式。;语法格式参见 [RRule 语法规范](https://www.ietf.org/rfc/rfc2445.txt) 4.3.10 小节 + RichSummary *string `json:"rich_summary,omitempty"` // 富文本任务标题。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module);。创建任务时，任务标题 (summary 字段) 和任务富文本标题 (rich_summary 字段) 不能同时为空，需要至少填充其中一个字段。 + RichDescription *string `json:"rich_description,omitempty"` // 富文本任务备注。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) } type TaskBuilder struct { - id string // 任务的唯一ID，例如"83912691-2e43-47fc-94a4-d512e03984fa" + id string // 任务的唯一 ID，例如"83912691-2e43-47fc-94a4-d512e03984fa" idFlag bool - summary string // 任务的标题，类型为文本字符串。;如果要在任务标题中插入 URL 或者 @某个用户，请使用rich_summary字段。;创建任务时，任务标题(summary字段)和任务富文本标题(rich_summary字段)不能同时为空，需要至少填充其中一个字段。;;任务标题和任务富文本标题同时存在时只使用富文本标题。; + summary string // 任务的标题，类型为文本字符串。;如果要在任务标题中插入 URL 或者 @某个用户，请使用 rich_summary 字段。;创建任务时，任务标题 (summary 字段) 和任务富文本标题 (rich_summary 字段) 不能同时为空，需要至少填充其中一个字段。;;任务标题和任务富文本标题同时存在时只使用富文本标题。; summaryFlag bool - description string // 任务的描述，类型为文本字符串。;如果要在任务描述中插入 URL 或者 @某个用户，请使用rich_description字段。;;任务备注和任务富文本备注同时存在时只使用富文本备注。; + description string // 任务的描述，类型为文本字符串。;如果要在任务描述中插入 URL 或者 @某个用户，请使用 rich_description 字段。;;任务备注和任务富文本备注同时存在时只使用富文本备注。; descriptionFlag bool - completeTime string // 任务的完成时间戳（单位为秒），完成时间为0则表示任务尚未完成。;不支持部分完成，只有整个任务完成，该字段才会有非0值。 + completeTime string // 任务的完成时间戳（单位为秒），完成时间为 0 则表示任务尚未完成。;不支持部分完成，只有整个任务完成，该字段才会有非 0 值。 completeTimeFlag bool - creatorId string // 任务的创建者 ID。;其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型，不传时默认返回 open_id。;特别的，使用tenant_access_token 调用接口时，如果是user_id_type是openid，则返回代表该应用身份的openid；当user_id_type为user_id时，不返回creator_id。原因是user_id代表一个真实飞书用户的id，应用身份没有user_id。使用user_access_token调用接口正常返回创建者。 + creatorId string // 任务的创建者 ID。;其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型，不传时默认返回 open_id。;特别的，使用 tenant_access_token 调用接口时，如果是 user_id_type 是 openid，则返回代表该应用身份的 openid；当 user_id_type 为 user_id 时，不返回 creator_id。原因是 user_id 代表一个真实飞书用户的 id，应用身份没有 user_id。使用 user_access_token 调用接口正常返回创建者。 creatorIdFlag bool - extra string // 附属信息。;接入方可以传入base64 编码后的自定义的数据。用户如果需要对当前任务备注信息，但对外不显示，可使用该字段进行存储。;该数据会在获取任务详情时，原样返回给用户。 + extra string // 附属信息。;接入方可以传入 base64 编码后的自定义的数据。用户如果需要对当前任务备注信息，但对外不显示，可使用该字段进行存储。;该数据会在获取任务详情时，原样返回给用户。 extraFlag bool - createTime string // 任务的创建时间的Unix时间戳（单位为秒） + createTime string // 任务的创建时间的 Unix 时间戳（单位为秒） createTimeFlag bool - updateTime string // 任务的更新时间的Unix时间戳（单位为秒）;创建任务时update_time与create_time相同 + updateTime string // 任务的更新时间的 Unix 时间戳（单位为秒）;创建任务时 update_time 与 create_time 相同 updateTimeFlag bool due *Due // 任务的截止时间设置 dueFlag bool origin *Origin // 任务关联的第三方平台来源信息 originFlag bool - canEdit bool // 此字段用于控制该任务在飞书任务中心是否可编辑，默认为false;;已经废弃，向前兼容故仍然保留，但不推荐使用; + canEdit bool // 此字段用于控制该任务在飞书任务中心是否可编辑，默认为 false;;已经废弃，向前兼容故仍然保留，但不推荐使用; canEditFlag bool custom string // 自定义完成配置。;此字段用于设置完成任务时的页面跳转，或展示提示语。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) customFlag bool @@ -628,15 +628,15 @@ type TaskBuilder struct { followersFlag bool collaborators []*Collaborator // 任务的执行者 collaboratorsFlag bool - collaboratorIds []string // 创建任务时添加的执行者用户id列表。;传入的值为 user_id 或 open_id ，由user_id_type 决定。user_id和open_id的获取可见文档：[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 + collaboratorIds []string // 创建任务时添加的执行者用户 id 列表。;传入的值为 user_id 或 open_id ，由 user_id_type 决定。user_id 和 open_id 的获取可见文档：[如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 collaboratorIdsFlag bool - followerIds []string // 创建任务时添加的关注者用户id列表。;传入的值为 user_id 或 open_id ，由user_id_type 决定。user_id和open_id的获取可见文档：[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 + followerIds []string // 创建任务时添加的关注者用户 id 列表。;传入的值为 user_id 或 open_id ，由 user_id_type 决定。user_id 和 open_id 的获取可见文档：[如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 followerIdsFlag bool - repeatRule string // 重复任务的规则表达式。;语法格式参见[RRule语法规范](https://www.ietf.org/rfc/rfc2445.txt) 4.3.10小节 + repeatRule string // 重复任务的规则表达式。;语法格式参见 [RRule 语法规范](https://www.ietf.org/rfc/rfc2445.txt) 4.3.10 小节 repeatRuleFlag bool - richSummary string // 富文本任务标题。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module);。创建任务时，任务标题(summary字段)和任务富文本标题(rich_summary字段)不能同时为空，需要至少填充其中一个字段。 + richSummary string // 富文本任务标题。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module);。创建任务时，任务标题 (summary 字段) 和任务富文本标题 (rich_summary 字段) 不能同时为空，需要至少填充其中一个字段。 richSummaryFlag bool - richDescription string // 富文本任务备注。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) + richDescription string // 富文本任务备注。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) richDescriptionFlag bool } @@ -645,7 +645,7 @@ func NewTaskBuilder() *TaskBuilder { return builder } -// 任务的唯一ID，例如"83912691-2e43-47fc-94a4-d512e03984fa" +// 任务的唯一 ID，例如"83912691-2e43-47fc-94a4-d512e03984fa" // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *TaskBuilder) Id(id string) *TaskBuilder { @@ -654,25 +654,25 @@ func (builder *TaskBuilder) Id(id string) *TaskBuilder { return builder } -// 任务的标题，类型为文本字符串。;如果要在任务标题中插入 URL 或者 @某个用户，请使用rich_summary字段。;创建任务时，任务标题(summary字段)和任务富文本标题(rich_summary字段)不能同时为空，需要至少填充其中一个字段。;;任务标题和任务富文本标题同时存在时只使用富文本标题。; +// 任务的标题，类型为文本字符串。;如果要在任务标题中插入 URL 或者 @某个用户，请使用 rich_summary 字段。;创建任务时，任务标题 (summary 字段) 和任务富文本标题 (rich_summary 字段) 不能同时为空，需要至少填充其中一个字段。;;任务标题和任务富文本标题同时存在时只使用富文本标题。; // -// 示例值：完成本季度OKR编写 +// 示例值：完成本季度 OKR 编写 func (builder *TaskBuilder) Summary(summary string) *TaskBuilder { builder.summary = summary builder.summaryFlag = true return builder } -// 任务的描述，类型为文本字符串。;如果要在任务描述中插入 URL 或者 @某个用户，请使用rich_description字段。;;任务备注和任务富文本备注同时存在时只使用富文本备注。; +// 任务的描述，类型为文本字符串。;如果要在任务描述中插入 URL 或者 @某个用户，请使用 rich_description 字段。;;任务备注和任务富文本备注同时存在时只使用富文本备注。; // -// 示例值：对本次会议内容复盘总结，编写更新本季度OKR +// 示例值：对本次会议内容复盘总结，编写更新本季度 OKR func (builder *TaskBuilder) Description(description string) *TaskBuilder { builder.description = description builder.descriptionFlag = true return builder } -// 任务的完成时间戳（单位为秒），完成时间为0则表示任务尚未完成。;不支持部分完成，只有整个任务完成，该字段才会有非0值。 +// 任务的完成时间戳（单位为秒），完成时间为 0 则表示任务尚未完成。;不支持部分完成，只有整个任务完成，该字段才会有非 0 值。 // // 示例值：1623499200 func (builder *TaskBuilder) CompleteTime(completeTime string) *TaskBuilder { @@ -681,7 +681,7 @@ func (builder *TaskBuilder) CompleteTime(completeTime string) *TaskBuilder { return builder } -// 任务的创建者 ID。;其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型，不传时默认返回 open_id。;特别的，使用tenant_access_token 调用接口时，如果是user_id_type是openid，则返回代表该应用身份的openid；当user_id_type为user_id时，不返回creator_id。原因是user_id代表一个真实飞书用户的id，应用身份没有user_id。使用user_access_token调用接口正常返回创建者。 +// 任务的创建者 ID。;其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型，不传时默认返回 open_id。;特别的，使用 tenant_access_token 调用接口时，如果是 user_id_type 是 openid，则返回代表该应用身份的 openid；当 user_id_type 为 user_id 时，不返回 creator_id。原因是 user_id 代表一个真实飞书用户的 id，应用身份没有 user_id。使用 user_access_token 调用接口正常返回创建者。 // // 示例值：ou_99e1a581b36ecc4862cbfbce473f346a func (builder *TaskBuilder) CreatorId(creatorId string) *TaskBuilder { @@ -690,7 +690,7 @@ func (builder *TaskBuilder) CreatorId(creatorId string) *TaskBuilder { return builder } -// 附属信息。;接入方可以传入base64 编码后的自定义的数据。用户如果需要对当前任务备注信息，但对外不显示，可使用该字段进行存储。;该数据会在获取任务详情时，原样返回给用户。 +// 附属信息。;接入方可以传入 base64 编码后的自定义的数据。用户如果需要对当前任务备注信息，但对外不显示，可使用该字段进行存储。;该数据会在获取任务详情时，原样返回给用户。 // // 示例值：dGVzdA== func (builder *TaskBuilder) Extra(extra string) *TaskBuilder { @@ -699,7 +699,7 @@ func (builder *TaskBuilder) Extra(extra string) *TaskBuilder { return builder } -// 任务的创建时间的Unix时间戳（单位为秒） +// 任务的创建时间的 Unix 时间戳（单位为秒） // // 示例值：1623392486 func (builder *TaskBuilder) CreateTime(createTime string) *TaskBuilder { @@ -708,7 +708,7 @@ func (builder *TaskBuilder) CreateTime(createTime string) *TaskBuilder { return builder } -// 任务的更新时间的Unix时间戳（单位为秒）;创建任务时update_time与create_time相同 +// 任务的更新时间的 Unix 时间戳（单位为秒）;创建任务时 update_time 与 create_time 相同 // // 示例值：1623392486 func (builder *TaskBuilder) UpdateTime(updateTime string) *TaskBuilder { @@ -735,7 +735,7 @@ func (builder *TaskBuilder) Origin(origin *Origin) *TaskBuilder { return builder } -// 此字段用于控制该任务在飞书任务中心是否可编辑，默认为false;;已经废弃，向前兼容故仍然保留，但不推荐使用; +// 此字段用于控制该任务在飞书任务中心是否可编辑，默认为 false;;已经废弃，向前兼容故仍然保留，但不推荐使用; // // 示例值：true func (builder *TaskBuilder) CanEdit(canEdit bool) *TaskBuilder { @@ -780,7 +780,7 @@ func (builder *TaskBuilder) Collaborators(collaborators []*Collaborator) *TaskBu return builder } -// 创建任务时添加的执行者用户id列表。;传入的值为 user_id 或 open_id ，由user_id_type 决定。user_id和open_id的获取可见文档：[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 +// 创建任务时添加的执行者用户 id 列表。;传入的值为 user_id 或 open_id ，由 user_id_type 决定。user_id 和 open_id 的获取可见文档：[如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 // // 示例值：["ou_1400208f15333e20e11339d39067844b", "ou_84ed6312949945c8ae6168f10829e9e6"] func (builder *TaskBuilder) CollaboratorIds(collaboratorIds []string) *TaskBuilder { @@ -789,7 +789,7 @@ func (builder *TaskBuilder) CollaboratorIds(collaboratorIds []string) *TaskBuild return builder } -// 创建任务时添加的关注者用户id列表。;传入的值为 user_id 或 open_id ，由user_id_type 决定。user_id和open_id的获取可见文档：[如何获取相关id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 +// 创建任务时添加的关注者用户 id 列表。;传入的值为 user_id 或 open_id ，由 user_id_type 决定。user_id 和 open_id 的获取可见文档：[如何获取相关 id](https://open.feishu.cn/document/home/user-identity-introduction/how-to-get)。 // // 示例值：["ou_1400208f15333e20e11339d39067844b", "ou_84ed6312949945c8ae6168f10829e9e6"] func (builder *TaskBuilder) FollowerIds(followerIds []string) *TaskBuilder { @@ -798,7 +798,7 @@ func (builder *TaskBuilder) FollowerIds(followerIds []string) *TaskBuilder { return builder } -// 重复任务的规则表达式。;语法格式参见[RRule语法规范](https://www.ietf.org/rfc/rfc2445.txt) 4.3.10小节 +// 重复任务的规则表达式。;语法格式参见 [RRule 语法规范](https://www.ietf.org/rfc/rfc2445.txt) 4.3.10 小节 // // 示例值：FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR func (builder *TaskBuilder) RepeatRule(repeatRule string) *TaskBuilder { @@ -807,18 +807,18 @@ func (builder *TaskBuilder) RepeatRule(repeatRule string) *TaskBuilder { return builder } -// 富文本任务标题。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module);。创建任务时，任务标题(summary字段)和任务富文本标题(rich_summary字段)不能同时为空，需要至少填充其中一个字段。 +// 富文本任务标题。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module);。创建任务时，任务标题 (summary 字段) 和任务富文本标题 (rich_summary 字段) 不能同时为空，需要至少填充其中一个字段。 // -// 示例值：完成本季度OKR编写\[飞书开放平台](https://open.feishu.cn/) +// 示例值：完成本季度 OKR 编写\[飞书开放平台](https://open.feishu.cn/) func (builder *TaskBuilder) RichSummary(richSummary string) *TaskBuilder { builder.richSummary = richSummary builder.richSummaryFlag = true return builder } -// 富文本任务备注。语法格式参见[Markdown模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) +// 富文本任务备注。语法格式参见 [Markdown 模块](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/markdown-module) // -// 示例值：对本次会议内容复盘总结，编写更新本季度OKR\[飞书开放平台](https://open.feishu.cn/) +// 示例值：对本次会议内容复盘总结，编写更新本季度 OKR\[飞书开放平台](https://open.feishu.cn/) func (builder *TaskBuilder) RichDescription(richDescription string) *TaskBuilder { builder.richDescription = richDescription builder.richDescriptionFlag = true @@ -1016,7 +1016,7 @@ func NewBatchDeleteCollaboratorTaskReqBuilder() *BatchDeleteCollaboratorTaskReqB return builder } -// 任务ID +// 任务 ID // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *BatchDeleteCollaboratorTaskReqBuilder) TaskId(taskId string) *BatchDeleteCollaboratorTaskReqBuilder { @@ -1024,7 +1024,7 @@ func (builder *BatchDeleteCollaboratorTaskReqBuilder) TaskId(taskId string) *Bat return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchDeleteCollaboratorTaskReqBuilder) UserIdType(userIdType string) *BatchDeleteCollaboratorTaskReqBuilder { @@ -1053,7 +1053,7 @@ type BatchDeleteCollaboratorTaskReq struct { } type BatchDeleteCollaboratorTaskRespData struct { - Collaborators []string `json:"collaborators,omitempty"` // 实际删除的执行人用户ID列表 + Collaborators []string `json:"collaborators,omitempty"` // 实际删除的执行人用户 ID 列表 } type BatchDeleteCollaboratorTaskResp struct { @@ -1080,7 +1080,7 @@ func NewBatchDeleteFollowerTaskReqBuilder() *BatchDeleteFollowerTaskReqBuilder { return builder } -// 任务ID +// 任务 ID // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *BatchDeleteFollowerTaskReqBuilder) TaskId(taskId string) *BatchDeleteFollowerTaskReqBuilder { @@ -1088,7 +1088,7 @@ func (builder *BatchDeleteFollowerTaskReqBuilder) TaskId(taskId string) *BatchDe return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *BatchDeleteFollowerTaskReqBuilder) UserIdType(userIdType string) *BatchDeleteFollowerTaskReqBuilder { @@ -1117,7 +1117,7 @@ type BatchDeleteFollowerTaskReq struct { } type BatchDeleteFollowerTaskRespData struct { - Followers []string `json:"followers,omitempty"` // 实际删除的关注人用户ID列表 + Followers []string `json:"followers,omitempty"` // 实际删除的关注人用户 ID 列表 } type BatchDeleteFollowerTaskResp struct { @@ -1143,7 +1143,7 @@ func NewCompleteTaskReqBuilder() *CompleteTaskReqBuilder { return builder } -// 任务 ID，可通过[创建任务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/create)时响应体中的id字段获取 +// 任务 ID，可通过 [创建任务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/create) 时响应体中的 id 字段获取 // // 示例值：bb54ab99-d360-434f-bcaa-a4cc4c05840e func (builder *CompleteTaskReqBuilder) TaskId(taskId string) *CompleteTaskReqBuilder { @@ -1185,7 +1185,7 @@ func NewCreateTaskReqBuilder() *CreateTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateTaskReqBuilder) UserIdType(userIdType string) *CreateTaskReqBuilder { @@ -1288,7 +1288,7 @@ func (builder *GetTaskReqBuilder) TaskId(taskId string) *GetTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetTaskReqBuilder) UserIdType(userIdType string) *GetTaskReqBuilder { @@ -1374,7 +1374,7 @@ func (builder *ListTaskReqBuilder) EndCreateTime(endCreateTime string) *ListTask return builder } -// 可用于查询时过滤任务完成状态。true表示只返回已完成的任务，false表示只返回未完成的任务。不填时表示同时返回两种完成状态的任务。 +// 可用于查询时过滤任务完成状态。true 表示只返回已完成的任务，false 表示只返回未完成的任务。不填时表示同时返回两种完成状态的任务。 // // 示例值：false func (builder *ListTaskReqBuilder) TaskCompleted(taskCompleted bool) *ListTaskReqBuilder { @@ -1382,7 +1382,7 @@ func (builder *ListTaskReqBuilder) TaskCompleted(taskCompleted bool) *ListTaskRe return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListTaskReqBuilder) UserIdType(userIdType string) *ListTaskReqBuilder { @@ -1524,7 +1524,7 @@ func (builder *PatchTaskReqBuilder) TaskId(taskId string) *PatchTaskReqBuilder { return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchTaskReqBuilder) UserIdType(userIdType string) *PatchTaskReqBuilder { @@ -1626,7 +1626,7 @@ func NewCreateTaskCollaboratorReqBuilder() *CreateTaskCollaboratorReqBuilder { return builder } -// 任务 ID，可通过[创建任务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/create)时响应体中的id字段获取 +// 任务 ID，可通过 [创建任务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/task/create) 时响应体中的 id 字段获取 // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *CreateTaskCollaboratorReqBuilder) TaskId(taskId string) *CreateTaskCollaboratorReqBuilder { @@ -1634,7 +1634,7 @@ func (builder *CreateTaskCollaboratorReqBuilder) TaskId(taskId string) *CreateTa return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateTaskCollaboratorReqBuilder) UserIdType(userIdType string) *CreateTaskCollaboratorReqBuilder { @@ -1697,7 +1697,7 @@ func (builder *DeleteTaskCollaboratorReqBuilder) TaskId(taskId string) *DeleteTa return builder } -// 任务执行者 ID（Open ID或User ID，由user_id_type指定） +// 任务执行者 ID（Open ID 或 User ID，由 user_id_type 指定） // // 示例值：ou_99e1a581b36ecc4862cbfbce123f346a func (builder *DeleteTaskCollaboratorReqBuilder) CollaboratorId(collaboratorId string) *DeleteTaskCollaboratorReqBuilder { @@ -1705,7 +1705,7 @@ func (builder *DeleteTaskCollaboratorReqBuilder) CollaboratorId(collaboratorId s return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *DeleteTaskCollaboratorReqBuilder) UserIdType(userIdType string) *DeleteTaskCollaboratorReqBuilder { @@ -1772,13 +1772,13 @@ func (builder *ListTaskCollaboratorReqBuilder) PageSize(pageSize int) *ListTaskC // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 // -// 示例值：「上次返回的page_token」 +// 示例值：「上次返回的 page_token」 func (builder *ListTaskCollaboratorReqBuilder) PageToken(pageToken string) *ListTaskCollaboratorReqBuilder { builder.apiReq.QueryParams.Set("page_token", fmt.Sprint(pageToken)) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListTaskCollaboratorReqBuilder) UserIdType(userIdType string) *ListTaskCollaboratorReqBuilder { @@ -1802,7 +1802,7 @@ type ListTaskCollaboratorReq struct { } type ListTaskCollaboratorRespData struct { - Items []*Collaborator `json:"items,omitempty"` // 返回的执行者ID列表 + Items []*Collaborator `json:"items,omitempty"` // 返回的执行者 ID 列表 PageToken *string `json:"page_token,omitempty"` // 分页标记，分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 HasMore *bool `json:"has_more,omitempty"` // 是否还有更多数据 } @@ -1839,7 +1839,7 @@ func (builder *CreateTaskCommentReqBuilder) TaskId(taskId string) *CreateTaskCom return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateTaskCommentReqBuilder) UserIdType(userIdType string) *CreateTaskCommentReqBuilder { @@ -1847,7 +1847,7 @@ func (builder *CreateTaskCommentReqBuilder) UserIdType(userIdType string) *Creat return builder } -// 该接口用于创建和回复任务的评论。当parent_id字段为0时，为创建评论；当parent_id不为0时，为回复某条评论 +// 该接口用于创建和回复任务的评论。当 parent_id 字段为 0 时，为创建评论；当 parent_id 不为 0 时，为回复某条评论 func (builder *CreateTaskCommentReqBuilder) Comment(comment *Comment) *CreateTaskCommentReqBuilder { builder.comment = comment return builder @@ -1894,7 +1894,7 @@ func NewDeleteTaskCommentReqBuilder() *DeleteTaskCommentReqBuilder { return builder } -// 任务ID +// 任务 ID // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *DeleteTaskCommentReqBuilder) TaskId(taskId string) *DeleteTaskCommentReqBuilder { @@ -1902,7 +1902,7 @@ func (builder *DeleteTaskCommentReqBuilder) TaskId(taskId string) *DeleteTaskCom return builder } -// 评论ID +// 评论 ID // // 示例值：6937231762296684564 func (builder *DeleteTaskCommentReqBuilder) CommentId(commentId string) *DeleteTaskCommentReqBuilder { @@ -1943,7 +1943,7 @@ func NewGetTaskCommentReqBuilder() *GetTaskCommentReqBuilder { return builder } -// 任务ID +// 任务 ID // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *GetTaskCommentReqBuilder) TaskId(taskId string) *GetTaskCommentReqBuilder { @@ -1951,7 +1951,7 @@ func (builder *GetTaskCommentReqBuilder) TaskId(taskId string) *GetTaskCommentRe return builder } -// 评论ID +// 评论 ID // // 示例值：6937231762296684564 func (builder *GetTaskCommentReqBuilder) CommentId(commentId string) *GetTaskCommentReqBuilder { @@ -1959,7 +1959,7 @@ func (builder *GetTaskCommentReqBuilder) CommentId(commentId string) *GetTaskCom return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetTaskCommentReqBuilder) UserIdType(userIdType string) *GetTaskCommentReqBuilder { @@ -2013,7 +2013,7 @@ func (builder *ListTaskCommentReqBuilder) Limit(limit int) *ListTaskCommentReqBu return builder } -// 任务id +// 任务 id // // 示例值："83912691-2e43-47fc-94a4-d512e03984fa" func (builder *ListTaskCommentReqBuilder) TaskId(taskId string) *ListTaskCommentReqBuilder { @@ -2029,7 +2029,7 @@ func (builder *ListTaskCommentReqBuilder) PageSize(pageSize int) *ListTaskCommen return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 // // 示例值："MTYzMTg3ODUxNQ==" func (builder *ListTaskCommentReqBuilder) PageToken(pageToken string) *ListTaskCommentReqBuilder { @@ -2045,7 +2045,7 @@ func (builder *ListTaskCommentReqBuilder) ListDirection(listDirection int) *List return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListTaskCommentReqBuilder) UserIdType(userIdType string) *ListTaskCommentReqBuilder { @@ -2180,7 +2180,7 @@ func NewUpdateTaskCommentReqBuilder() *UpdateTaskCommentReqBuilder { return builder } -// 任务ID +// 任务 ID // // 示例值：83912691-2e43-47fc-94a4-d512e03984fa func (builder *UpdateTaskCommentReqBuilder) TaskId(taskId string) *UpdateTaskCommentReqBuilder { @@ -2196,7 +2196,7 @@ func (builder *UpdateTaskCommentReqBuilder) CommentId(commentId string) *UpdateT return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *UpdateTaskCommentReqBuilder) UserIdType(userIdType string) *UpdateTaskCommentReqBuilder { @@ -2265,7 +2265,7 @@ func (builder *CreateTaskFollowerReqBuilder) TaskId(taskId string) *CreateTaskFo return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *CreateTaskFollowerReqBuilder) UserIdType(userIdType string) *CreateTaskFollowerReqBuilder { @@ -2273,7 +2273,7 @@ func (builder *CreateTaskFollowerReqBuilder) UserIdType(userIdType string) *Crea return builder } -// 该接口用于创建任务关注人。可以一次性添加多位关注人。关注人ID要使用表示用户的ID。 +// 该接口用于创建任务关注人。可以一次性添加多位关注人。关注人 ID 要使用表示用户的 ID。 func (builder *CreateTaskFollowerReqBuilder) Follower(follower *Follower) *CreateTaskFollowerReqBuilder { builder.follower = follower return builder @@ -2328,7 +2328,7 @@ func (builder *DeleteTaskFollowerReqBuilder) TaskId(taskId string) *DeleteTaskFo return builder } -// 任务关注人 ID（Open ID或User ID，由user_id_type指定） +// 任务关注人 ID（Open ID 或 User ID，由 user_id_type 指定） // // 示例值：ou_87e1a581b36ecc4862cbfbce473f346a func (builder *DeleteTaskFollowerReqBuilder) FollowerId(followerId string) *DeleteTaskFollowerReqBuilder { @@ -2336,7 +2336,7 @@ func (builder *DeleteTaskFollowerReqBuilder) FollowerId(followerId string) *Dele return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *DeleteTaskFollowerReqBuilder) UserIdType(userIdType string) *DeleteTaskFollowerReqBuilder { @@ -2403,13 +2403,13 @@ func (builder *ListTaskFollowerReqBuilder) PageSize(pageSize int) *ListTaskFollo // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 // -// 示例值：「上次返回的page_token」 +// 示例值：「上次返回的 page_token」 func (builder *ListTaskFollowerReqBuilder) PageToken(pageToken string) *ListTaskFollowerReqBuilder { builder.apiReq.QueryParams.Set("page_token", fmt.Sprint(pageToken)) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ListTaskFollowerReqBuilder) UserIdType(userIdType string) *ListTaskFollowerReqBuilder { @@ -2433,7 +2433,7 @@ type ListTaskFollowerReq struct { } type ListTaskFollowerRespData struct { - Items []*Follower `json:"items,omitempty"` // 返回的关注人ID列表 + Items []*Follower `json:"items,omitempty"` // 返回的关注人 ID 列表 PageToken *string `json:"page_token,omitempty"` // 分页标记，分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 HasMore *bool `json:"has_more,omitempty"` // 是否还有更多数据 } @@ -2590,7 +2590,7 @@ func (builder *ListTaskReminderReqBuilder) PageSize(pageSize int) *ListTaskRemin // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 // -// 示例值：「填写上次返回的page_token」 +// 示例值：「填写上次返回的 page_token」 func (builder *ListTaskReminderReqBuilder) PageToken(pageToken string) *ListTaskReminderReqBuilder { builder.apiReq.QueryParams.Set("page_token", fmt.Sprint(pageToken)) return builder @@ -2629,7 +2629,7 @@ func (resp *ListTaskReminderResp) Success() bool { type P2TaskUpdateTenantV1Data struct { UserIdList *UserIdList `json:"user_id_list,omitempty"` // 用户 ID 列表 - TaskId *string `json:"task_id,omitempty"` // 任务的id + TaskId *string `json:"task_id,omitempty"` // 任务的 id ObjectType *string `json:"object_type,omitempty"` // 变更的数据类型，可选值：;"task"，"collaborator"，"follower" EventType *string `json:"event_type,omitempty"` // 事件类型，可选值：;"create"，"delete"，"update" } @@ -2645,7 +2645,7 @@ func (m *P2TaskUpdateTenantV1) RawReq(req *larkevent.EventReq) { } type P2TaskUpdatedV1Data struct { - TaskId *string `json:"task_id,omitempty"` // 任务ID + TaskId *string `json:"task_id,omitempty"` // 任务 ID ObjType *int `json:"obj_type,omitempty"` // 通知类型（1：任务详情发生变化，2：任务协作者发生变化，3：任务关注者发生变化，4：任务提醒时间发生变化，5：任务完成，6：任务取消完成，7：任务删除） } @@ -2660,9 +2660,9 @@ func (m *P2TaskUpdatedV1) RawReq(req *larkevent.EventReq) { } type P2TaskCommentUpdatedV1Data struct { - TaskId *string `json:"task_id,omitempty"` // 任务ID - CommentId *string `json:"comment_id,omitempty"` // 任务评论ID - ParentId *string `json:"parent_id,omitempty"` // 任务评论父ID + TaskId *string `json:"task_id,omitempty"` // 任务 ID + CommentId *string `json:"comment_id,omitempty"` // 任务评论 ID + ParentId *string `json:"parent_id,omitempty"` // 任务评论父 ID ObjType *int `json:"obj_type,omitempty"` // 通知类型（1：创建评论，2：回复评论，3：更新评论，4：删除评论） } @@ -2694,7 +2694,7 @@ func (iterator *ListTaskIterator) Next() (bool, *Task, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2748,7 +2748,7 @@ func (iterator *ListTaskCollaboratorIterator) Next() (bool, *Collaborator, error return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2802,7 +2802,7 @@ func (iterator *ListTaskCommentIterator) Next() (bool, *Comment, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2856,7 +2856,7 @@ func (iterator *ListTaskFollowerIterator) Next() (bool, *Follower, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2910,7 +2910,7 @@ func (iterator *ListTaskReminderIterator) Next() (bool, *Reminder, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/tenant/v2/api.go b/service/tenant/v2/api.go index 104528ed..82216392 100644 --- a/service/tenant/v2/api.go +++ b/service/tenant/v2/api.go @@ -44,11 +44,11 @@ type tenantProductAssignInfo struct { // // - 获取企业名称、企业编号等企业信息 // -// - 如果ISV应用是企业创建时默认安装，并且180天内企业未打开或使用过此应用，则无法通过此接口获取到企业信息。 +// - 如果 ISV 应用是企业创建时默认安装，并且 180 天内企业未打开或使用过此应用，则无法通过此接口获取到企业信息。 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/tenant-v2/tenant/query +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/tenant-v2/tenant/query // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/tenantv2/query_tenant.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/tenantv2/query_tenant.go func (t *tenant) Query(ctx context.Context, options ...larkcore.RequestOptionFunc) (*QueryTenantResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ @@ -75,9 +75,9 @@ func (t *tenant) Query(ctx context.Context, options ...larkcore.RequestOptionFun // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=tenant&resource=tenant.product_assign_info&version=v2 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=tenant&resource=tenant.product_assign_info&version=v2 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/tenantv2/query_tenantProductAssignInfo.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/tenantv2/query_tenantProductAssignInfo.go func (t *tenantProductAssignInfo) Query(ctx context.Context, options ...larkcore.RequestOptionFunc) (*QueryTenantProductAssignInfoResp, error) { // 发起请求 apiReq := &larkcore.ApiReq{ diff --git a/service/tenant/v2/model.go b/service/tenant/v2/model.go index 8145a6fe..f550372d 100644 --- a/service/tenant/v2/model.go +++ b/service/tenant/v2/model.go @@ -257,7 +257,7 @@ func (builder *TenantBuilder) Build() *Tenant { } type TenantAssignInfo struct { - SubscriptionId *string `json:"subscription_id,omitempty"` // 席位id + SubscriptionId *string `json:"subscription_id,omitempty"` // 席位 id LicensePlanKey *string `json:"license_plan_key,omitempty"` // license_plan_key ProductName *string `json:"product_name,omitempty"` // 商业化产品名称 I18nName *ProductI18nName `json:"i18n_name,omitempty"` // 国际化名称 @@ -268,7 +268,7 @@ type TenantAssignInfo struct { } type TenantAssignInfoBuilder struct { - subscriptionId string // 席位id + subscriptionId string // 席位 id subscriptionIdFlag bool licensePlanKey string // license_plan_key licensePlanKeyFlag bool @@ -291,7 +291,7 @@ func NewTenantAssignInfoBuilder() *TenantAssignInfoBuilder { return builder } -// 席位id +// 席位 id // // 示例值：7079609167680782300 func (builder *TenantAssignInfoBuilder) SubscriptionId(subscriptionId string) *TenantAssignInfoBuilder { diff --git a/service/translation/v1/api.go b/service/translation/v1/api.go index fa77d5e3..7ce17f8e 100644 --- a/service/translation/v1/api.go +++ b/service/translation/v1/api.go @@ -41,9 +41,9 @@ type text struct { // // - 单租户限流：20QPS，同租户下的应用没有限流，共享本租户的 20QPS 限流 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/translation-v1/text/detect +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/translation-v1/text/detect // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/translationv1/detect_text.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/translationv1/detect_text.go func (t *text) Detect(ctx context.Context, req *DetectTextReq, options ...larkcore.RequestOptionFunc) (*DetectTextResp, error) { // 发起请求 apiReq := req.apiReq @@ -69,9 +69,9 @@ func (t *text) Detect(ctx context.Context, req *DetectTextReq, options ...larkco // // - 单租户限流：20QPS，同租户下的应用没有限流，共享本租户的 20QPS 限流 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/translation-v1/text/translate +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/ai/translation-v1/text/translate // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/translationv1/translate_text.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/translationv1/translate_text.go func (t *text) Translate(ctx context.Context, req *TranslateTextReq, options ...larkcore.RequestOptionFunc) (*TranslateTextResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/translation/v1/model.go b/service/translation/v1/model.go index 12baca66..1e5386b2 100644 --- a/service/translation/v1/model.go +++ b/service/translation/v1/model.go @@ -179,7 +179,7 @@ type TranslateTextReqBodyBuilder struct { textFlag bool targetLanguage string // 目标语言 targetLanguageFlag bool - glossary []*Term // 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词） + glossary []*Term // 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128 个术语词） glossaryFlag bool } @@ -215,7 +215,7 @@ func (builder *TranslateTextReqBodyBuilder) TargetLanguage(targetLanguage string return builder } -// 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词） +// 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128 个术语词） // //示例值： func (builder *TranslateTextReqBodyBuilder) Glossary(glossary []*Term) *TranslateTextReqBodyBuilder { @@ -248,7 +248,7 @@ type TranslateTextPathReqBodyBuilder struct { textFlag bool targetLanguage string // 目标语言 targetLanguageFlag bool - glossary []*Term // 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词） + glossary []*Term // 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128 个术语词） glossaryFlag bool } @@ -284,7 +284,7 @@ func (builder *TranslateTextPathReqBodyBuilder) TargetLanguage(targetLanguage st return builder } -// 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词） +// 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128 个术语词） // // 示例值： func (builder *TranslateTextPathReqBodyBuilder) Glossary(glossary []*Term) *TranslateTextPathReqBodyBuilder { @@ -341,7 +341,7 @@ type TranslateTextReqBody struct { SourceLanguage *string `json:"source_language,omitempty"` // 源语言 Text *string `json:"text,omitempty"` // 源文本 TargetLanguage *string `json:"target_language,omitempty"` // 目标语言 - Glossary []*Term `json:"glossary,omitempty"` // 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词） + Glossary []*Term `json:"glossary,omitempty"` // 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128 个术语词） } type TranslateTextReq struct { diff --git a/service/vc/v1/api.go b/service/vc/v1/api.go index a610fce0..1f0ec196 100644 --- a/service/vc/v1/api.go +++ b/service/vc/v1/api.go @@ -110,9 +110,9 @@ type scopeConfig struct { // // - 下载导出文件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/download +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/download // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/download_export.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/download_export.go func (e *export) Download(ctx context.Context, req *DownloadExportReq, options ...larkcore.RequestOptionFunc) (*DownloadExportResp, error) { // 发起请求 apiReq := req.apiReq @@ -142,9 +142,9 @@ func (e *export) Download(ctx context.Context, req *DownloadExportReq, options . // // - 查看异步导出的进度 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_export.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_export.go func (e *export) Get(ctx context.Context, req *GetExportReq, options ...larkcore.RequestOptionFunc) (*GetExportResp, error) { // 发起请求 apiReq := req.apiReq @@ -168,9 +168,9 @@ func (e *export) Get(ctx context.Context, req *GetExportReq, options ...larkcore // // - 导出会议明细，具体权限要求请参考「导出概述」 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/meeting_list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/meeting_list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/meetingList_export.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/meetingList_export.go func (e *export) MeetingList(ctx context.Context, req *MeetingListExportReq, options ...larkcore.RequestOptionFunc) (*MeetingListExportResp, error) { // 发起请求 apiReq := req.apiReq @@ -194,9 +194,9 @@ func (e *export) MeetingList(ctx context.Context, req *MeetingListExportReq, opt // // - 导出某个会议的参会人详情列表，具体权限要求请参考「导出概述」 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/participant_list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/participant_list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/participantList_export.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/participantList_export.go func (e *export) ParticipantList(ctx context.Context, req *ParticipantListExportReq, options ...larkcore.RequestOptionFunc) (*ParticipantListExportResp, error) { // 发起请求 apiReq := req.apiReq @@ -220,9 +220,9 @@ func (e *export) ParticipantList(ctx context.Context, req *ParticipantListExport // // - 导出某场会议某个参会人的音视频&共享质量数据;，具体权限要求请参考「导出概述」 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/participant_quality_list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/participant_quality_list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/participantQualityList_export.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/participantQualityList_export.go func (e *export) ParticipantQualityList(ctx context.Context, req *ParticipantQualityListExportReq, options ...larkcore.RequestOptionFunc) (*ParticipantQualityListExportResp, error) { // 发起请求 apiReq := req.apiReq @@ -246,9 +246,9 @@ func (e *export) ParticipantQualityList(ctx context.Context, req *ParticipantQua // // - 导出会议室预定数据，具体权限要求请参考「导出概述」 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/resource_reservation_list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/resource_reservation_list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/resourceReservationList_export.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/resourceReservationList_export.go func (e *export) ResourceReservationList(ctx context.Context, req *ResourceReservationListExportReq, options ...larkcore.RequestOptionFunc) (*ResourceReservationListExportResp, error) { // 发起请求 apiReq := req.apiReq @@ -274,9 +274,9 @@ func (e *export) ResourceReservationList(ctx context.Context, req *ResourceReser // // - 会议正在进行中，且操作者须具有相应的权限（如果操作者为用户，必须是会中当前主持人） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/end +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/end // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/end_meeting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/end_meeting.go func (m *meeting) End(ctx context.Context, req *EndMeetingReq, options ...larkcore.RequestOptionFunc) (*EndMeetingResp, error) { // 发起请求 apiReq := req.apiReq @@ -300,11 +300,11 @@ func (m *meeting) End(ctx context.Context, req *EndMeetingReq, options ...larkco // // - 获取一个会议的详细数据 // -// - 只能获取归属于自己的会议，支持查询最近90天内的会议 +// - 只能获取归属于自己的会议，支持查询最近 90 天内的会议 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_meeting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_meeting.go func (m *meeting) Get(ctx context.Context, req *GetMeetingReq, options ...larkcore.RequestOptionFunc) (*GetMeetingResp, error) { // 发起请求 apiReq := req.apiReq @@ -330,9 +330,9 @@ func (m *meeting) Get(ctx context.Context, req *GetMeetingReq, options ...larkco // // - 发起邀请的操作者必须具有相应的权限（如果操作者为用户，则必须在会中），如果会议被锁定、或参会人数如果达到上限，则会邀请失败 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/invite +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/invite // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/invite_meeting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/invite_meeting.go func (m *meeting) Invite(ctx context.Context, req *InviteMeetingReq, options ...larkcore.RequestOptionFunc) (*InviteMeetingResp, error) { // 发起请求 apiReq := req.apiReq @@ -356,9 +356,9 @@ func (m *meeting) Invite(ctx context.Context, req *InviteMeetingReq, options ... // // - 将参会人从会议中移除 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/kickout +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/kickout // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/kickout_meeting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/kickout_meeting.go func (m *meeting) Kickout(ctx context.Context, req *KickoutMeetingReq, options ...larkcore.RequestOptionFunc) (*KickoutMeetingResp, error) { // 发起请求 apiReq := req.apiReq @@ -380,11 +380,11 @@ func (m *meeting) Kickout(ctx context.Context, req *KickoutMeetingReq, options . // 获取与会议号相关联的会议列表 // -// - 获取指定时间范围（90天内)会议号关联的会议简要信息列表 +// - 获取指定时间范围（90 天内) 会议号关联的会议简要信息列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/list_by_no +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/list_by_no // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/listByNo_meeting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/listByNo_meeting.go func (m *meeting) ListByNo(ctx context.Context, req *ListByNoMeetingReq, options ...larkcore.RequestOptionFunc) (*ListByNoMeetingResp, error) { // 发起请求 apiReq := req.apiReq @@ -416,11 +416,11 @@ func (m *meeting) ListByNoByIterator(ctx context.Context, req *ListByNoMeetingRe // // - 设置会议的主持人 // -// - 发起设置主持人的操作者必须具有相应的权限（如果操作者为用户，必须是会中当前主持人）；该操作使用CAS并发安全机制，需传入会中当前主持人，如果操作失败可使用返回的最新数据重试 +// - 发起设置主持人的操作者必须具有相应的权限（如果操作者为用户，必须是会中当前主持人）；该操作使用 CAS 并发安全机制，需传入会中当前主持人，如果操作失败可使用返回的最新数据重试 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/set_host +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting/set_host // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/setHost_meeting.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/setHost_meeting.go func (m *meeting) SetHost(ctx context.Context, req *SetHostMeetingReq, options ...larkcore.RequestOptionFunc) (*SetHostMeetingResp, error) { // 发起请求 apiReq := req.apiReq @@ -444,11 +444,11 @@ func (m *meeting) SetHost(ctx context.Context, req *SetHostMeetingReq, options . // // - 获取一个会议的录制文件。 // -// - 会议结束后并且收到了"录制完成"的事件方可获取录制文件；只有会议owner（通过开放平台预约的会议即为预约人）有权限获取；录制时间太短(<5s)有可能无法生成录制文件 +// - 会议结束后并且收到了"录制完成"的事件方可获取录制文件；只有会议 owner（通过开放平台预约的会议即为预约人）有权限获取；录制时间太短 (<5s) 有可能无法生成录制文件 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_meetingRecording.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_meetingRecording.go func (m *meetingRecording) Get(ctx context.Context, req *GetMeetingRecordingReq, options ...larkcore.RequestOptionFunc) (*GetMeetingRecordingResp, error) { // 发起请求 apiReq := req.apiReq @@ -472,11 +472,11 @@ func (m *meetingRecording) Get(ctx context.Context, req *GetMeetingRecordingReq, // // - 将一个会议的录制文件授权给组织、用户或公开到公网 // -// - 会议结束后并且收到了"录制完成"的事件方可进行授权；会议owner（通过开放平台预约的会议即为预约人）才有权限操作 +// - 会议结束后并且收到了"录制完成"的事件方可进行授权；会议 owner（通过开放平台预约的会议即为预约人）才有权限操作 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/set_permission +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/set_permission // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/setPermission_meetingRecording.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/setPermission_meetingRecording.go func (m *meetingRecording) SetPermission(ctx context.Context, req *SetPermissionMeetingRecordingReq, options ...larkcore.RequestOptionFunc) (*SetPermissionMeetingRecordingResp, error) { // 发起请求 apiReq := req.apiReq @@ -502,9 +502,9 @@ func (m *meetingRecording) SetPermission(ctx context.Context, req *SetPermission // // - 会议正在进行中，且操作者具有相应权限（如果操作者为用户，必须是会中当前主持人） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/start +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/start // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/start_meetingRecording.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/start_meetingRecording.go func (m *meetingRecording) Start(ctx context.Context, req *StartMeetingRecordingReq, options ...larkcore.RequestOptionFunc) (*StartMeetingRecordingResp, error) { // 发起请求 apiReq := req.apiReq @@ -530,9 +530,9 @@ func (m *meetingRecording) Start(ctx context.Context, req *StartMeetingRecording // // - 会议正在录制中，且操作者具有相应权限（如果操作者为用户，必须是会中当前主持人） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/stop +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/meeting-recording/stop // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/stop_meetingRecording.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/stop_meetingRecording.go func (m *meetingRecording) Stop(ctx context.Context, req *StopMeetingRecordingReq, options ...larkcore.RequestOptionFunc) (*StopMeetingRecordingResp, error) { // 发起请求 apiReq := req.apiReq @@ -556,9 +556,9 @@ func (m *meetingRecording) Stop(ctx context.Context, req *StopMeetingRecordingRe // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=meeting_list&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=meeting_list&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_meetingList.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_meetingList.go func (m *meetingList) Get(ctx context.Context, req *GetMeetingListReq, options ...larkcore.RequestOptionFunc) (*GetMeetingListResp, error) { // 发起请求 apiReq := req.apiReq @@ -590,9 +590,9 @@ func (m *meetingList) GetByIterator(ctx context.Context, req *GetMeetingListReq, // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=participant_list&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=participant_list&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_participantList.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_participantList.go func (p *participantList) Get(ctx context.Context, req *GetParticipantListReq, options ...larkcore.RequestOptionFunc) (*GetParticipantListResp, error) { // 发起请求 apiReq := req.apiReq @@ -624,9 +624,9 @@ func (p *participantList) GetByIterator(ctx context.Context, req *GetParticipant // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=participant_quality_list&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=participant_quality_list&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_participantQualityList.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_participantQualityList.go func (p *participantQualityList) Get(ctx context.Context, req *GetParticipantQualityListReq, options ...larkcore.RequestOptionFunc) (*GetParticipantQualityListResp, error) { // 发起请求 apiReq := req.apiReq @@ -658,11 +658,11 @@ func (p *participantQualityList) GetByIterator(ctx context.Context, req *GetPart // // - 获取一段时间内组织的每日会议使用报告。 // -// - 支持最近90天内的数据查询 +// - 支持最近 90 天内的数据查询 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/report/get_daily +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/report/get_daily // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/getDaily_report.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/getDaily_report.go func (r *report) GetDaily(ctx context.Context, req *GetDailyReportReq, options ...larkcore.RequestOptionFunc) (*GetDailyReportResp, error) { // 发起请求 apiReq := req.apiReq @@ -682,15 +682,15 @@ func (r *report) GetDaily(ctx context.Context, req *GetDailyReportReq, options . return resp, err } -// 获取top用户列表 +// 获取 top 用户列表 // -// - 获取一段时间内组织内会议使用的top用户列表。 +// - 获取一段时间内组织内会议使用的 top 用户列表。 // -// - 支持最近90天内的数据查询；默认返回前10位，最多可查询前100位 +// - 支持最近 90 天内的数据查询；默认返回前 10 位，最多可查询前 100 位 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/report/get_top_user +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/report/get_top_user // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/getTopUser_report.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/getTopUser_report.go func (r *report) GetTopUser(ctx context.Context, req *GetTopUserReportReq, options ...larkcore.RequestOptionFunc) (*GetTopUserReportResp, error) { // 发起请求 apiReq := req.apiReq @@ -714,11 +714,11 @@ func (r *report) GetTopUser(ctx context.Context, req *GetTopUserReportReq, optio // // - 创建一个会议预约。 // -// - 支持预约最近30天内的会议（到期时间距离当前时间不超过30天），预约到期后会议号将被释放，如需继续使用可通过"更新预约"接口进行续期；预约会议时可配置参会人在会中的权限，以达到控制会议的目的 +// - 支持预约最近 30 天内的会议（到期时间距离当前时间不超过 30 天），预约到期后会议号将被释放，如需继续使用可通过"更新预约"接口进行续期；预约会议时可配置参会人在会中的权限，以达到控制会议的目的 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/apply +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/apply // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/apply_reserve.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/apply_reserve.go func (r *reserve) Apply(ctx context.Context, req *ApplyReserveReq, options ...larkcore.RequestOptionFunc) (*ApplyReserveResp, error) { // 发起请求 apiReq := req.apiReq @@ -744,9 +744,9 @@ func (r *reserve) Apply(ctx context.Context, req *ApplyReserveReq, options ...la // // - 只能删除归属于自己的预约；删除后数据不可恢复 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/delete_reserve.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/delete_reserve.go func (r *reserve) Delete(ctx context.Context, req *DeleteReserveReq, options ...larkcore.RequestOptionFunc) (*DeleteReserveResp, error) { // 发起请求 apiReq := req.apiReq @@ -772,9 +772,9 @@ func (r *reserve) Delete(ctx context.Context, req *DeleteReserveReq, options ... // // - 只能获取归属于自己的预约 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_reserve.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_reserve.go func (r *reserve) Get(ctx context.Context, req *GetReserveReq, options ...larkcore.RequestOptionFunc) (*GetReserveResp, error) { // 发起请求 apiReq := req.apiReq @@ -800,9 +800,9 @@ func (r *reserve) Get(ctx context.Context, req *GetReserveReq, options ...larkco // // - 只能获取归属于自己的预约的活跃会议（一个预约最多有一个正在进行中的会议） // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/get_active_meeting +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/get_active_meeting // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/getActiveMeeting_reserve.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/getActiveMeeting_reserve.go func (r *reserve) GetActiveMeeting(ctx context.Context, req *GetActiveMeetingReserveReq, options ...larkcore.RequestOptionFunc) (*GetActiveMeetingReserveResp, error) { // 发起请求 apiReq := req.apiReq @@ -826,11 +826,11 @@ func (r *reserve) GetActiveMeeting(ctx context.Context, req *GetActiveMeetingRes // // - 更新一个预约 // -// - 只能更新归属于自己的预约，不需要更新的字段不传（如果传空则会被更新为空）；可用于续期操作，到期时间距离当前时间不超过30天 +// - 只能更新归属于自己的预约，不需要更新的字段不传（如果传空则会被更新为空）；可用于续期操作，到期时间距离当前时间不超过 30 天 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/update +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve/update // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/update_reserve.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/update_reserve.go func (r *reserve) Update(ctx context.Context, req *UpdateReserveReq, options ...larkcore.RequestOptionFunc) (*UpdateReserveResp, error) { // 发起请求 apiReq := req.apiReq @@ -854,9 +854,9 @@ func (r *reserve) Update(ctx context.Context, req *UpdateReserveReq, options ... // // - 更新会议室预定范围 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve_config/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve_config/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_reserveConfig.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_reserveConfig.go func (r *reserveConfig) Patch(ctx context.Context, req *PatchReserveConfigReq, options ...larkcore.RequestOptionFunc) (*PatchReserveConfigResp, error) { // 发起请求 apiReq := req.apiReq @@ -880,9 +880,9 @@ func (r *reserveConfig) Patch(ctx context.Context, req *PatchReserveConfigReq, o // // - 获取会议室预定范围 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve_config/reserve_scope +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/reserve_config/reserve_scope // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/reserveScope_reserveConfig.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/reserveScope_reserveConfig.go func (r *reserveConfig) ReserveScope(ctx context.Context, req *ReserveScopeReserveConfigReq, options ...larkcore.RequestOptionFunc) (*ReserveScopeReserveConfigResp, error) { // 发起请求 apiReq := req.apiReq @@ -906,9 +906,9 @@ func (r *reserveConfig) ReserveScope(ctx context.Context, req *ReserveScopeReser // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=reserve_config.admin&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=reserve_config.admin&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_reserveConfigAdmin.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_reserveConfigAdmin.go func (r *reserveConfigAdmin) Get(ctx context.Context, req *GetReserveConfigAdminReq, options ...larkcore.RequestOptionFunc) (*GetReserveConfigAdminResp, error) { // 发起请求 apiReq := req.apiReq @@ -932,9 +932,9 @@ func (r *reserveConfigAdmin) Get(ctx context.Context, req *GetReserveConfigAdmin // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=patch&project=vc&resource=reserve_config.admin&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=patch&project=vc&resource=reserve_config.admin&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_reserveConfigAdmin.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_reserveConfigAdmin.go func (r *reserveConfigAdmin) Patch(ctx context.Context, req *PatchReserveConfigAdminReq, options ...larkcore.RequestOptionFunc) (*PatchReserveConfigAdminResp, error) { // 发起请求 apiReq := req.apiReq @@ -958,9 +958,9 @@ func (r *reserveConfigAdmin) Patch(ctx context.Context, req *PatchReserveConfigA // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=resource_reservation_list&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=vc&resource=resource_reservation_list&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_resourceReservationList.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_resourceReservationList.go func (r *resourceReservationList) Get(ctx context.Context, req *GetResourceReservationListReq, options ...larkcore.RequestOptionFunc) (*GetResourceReservationListResp, error) { // 发起请求 apiReq := req.apiReq @@ -992,9 +992,9 @@ func (r *resourceReservationList) GetByIterator(ctx context.Context, req *GetRes // // - 该接口用于创建会议室 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/create_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/create_room.go func (r *room) Create(ctx context.Context, req *CreateRoomReq, options ...larkcore.RequestOptionFunc) (*CreateRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1018,9 +1018,9 @@ func (r *room) Create(ctx context.Context, req *CreateRoomReq, options ...larkco // // - 该接口可以用来删除某个会议室 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/delete_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/delete_room.go func (r *room) Delete(ctx context.Context, req *DeleteRoomReq, options ...larkcore.RequestOptionFunc) (*DeleteRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1042,11 +1042,11 @@ func (r *room) Delete(ctx context.Context, req *DeleteRoomReq, options ...larkco // 查询会议室详情 // -// - 该接口可以使用会议室ID查询会议室详情 +// - 该接口可以使用会议室 ID 查询会议室详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_room.go func (r *room) Get(ctx context.Context, req *GetRoomReq, options ...larkcore.RequestOptionFunc) (*GetRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1070,9 +1070,9 @@ func (r *room) Get(ctx context.Context, req *GetRoomReq, options ...larkcore.Req // // - 该接口可以用来查询某个会议室层级下会议室列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/list_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/list_room.go func (r *room) List(ctx context.Context, req *ListRoomReq, options ...larkcore.RequestOptionFunc) (*ListRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1102,11 +1102,11 @@ func (r *room) ListByIterator(ctx context.Context, req *ListRoomReq, options ... // 批量查询会议室详情 // -// - 该接口可以使用会议室ID批量查询会议室详情 +// - 该接口可以使用会议室 ID 批量查询会议室详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/mget +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/mget // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/mget_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/mget_room.go func (r *room) Mget(ctx context.Context, req *MgetRoomReq, options ...larkcore.RequestOptionFunc) (*MgetRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1130,9 +1130,9 @@ func (r *room) Mget(ctx context.Context, req *MgetRoomReq, options ...larkcore.R // // - 该接口可以用来更新某个会议室的信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_room.go func (r *room) Patch(ctx context.Context, req *PatchRoomReq, options ...larkcore.RequestOptionFunc) (*PatchRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1154,11 +1154,11 @@ func (r *room) Patch(ctx context.Context, req *PatchRoomReq, options ...larkcore // 搜索会议室 // -// - 该接口可以用来搜索会议室，支持使用关键词进行搜索，也支持使用自定义会议室ID进行查询 +// - 该接口可以用来搜索会议室，支持使用关键词进行搜索，也支持使用自定义会议室 ID 进行查询 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/search_room.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/search_room.go func (r *room) Search(ctx context.Context, req *SearchRoomReq, options ...larkcore.RequestOptionFunc) (*SearchRoomResp, error) { // 发起请求 apiReq := req.apiReq @@ -1182,9 +1182,9 @@ func (r *room) Search(ctx context.Context, req *SearchRoomReq, options ...larkco // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=vc&resource=room_config&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=vc&resource=room_config&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/query_roomConfig.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/query_roomConfig.go func (r *roomConfig) Query(ctx context.Context, req *QueryRoomConfigReq, options ...larkcore.RequestOptionFunc) (*QueryRoomConfigResp, error) { // 发起请求 apiReq := req.apiReq @@ -1208,9 +1208,9 @@ func (r *roomConfig) Query(ctx context.Context, req *QueryRoomConfigReq, options // // - // -// - 官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=set&project=vc&resource=room_config&version=v1 +// - 官网 API 文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=set&project=vc&resource=room_config&version=v1 // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/set_roomConfig.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/set_roomConfig.go func (r *roomConfig) Set(ctx context.Context, req *SetRoomConfigReq, options ...larkcore.RequestOptionFunc) (*SetRoomConfigResp, error) { // 发起请求 apiReq := req.apiReq @@ -1234,9 +1234,9 @@ func (r *roomConfig) Set(ctx context.Context, req *SetRoomConfigReq, options ... // // - 该接口用于创建会议室层级 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/create_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/create_roomLevel.go func (r *roomLevel) Create(ctx context.Context, req *CreateRoomLevelReq, options ...larkcore.RequestOptionFunc) (*CreateRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1260,9 +1260,9 @@ func (r *roomLevel) Create(ctx context.Context, req *CreateRoomLevelReq, options // // - 该接口可以用来删除某个会议室层级 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/del +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/del // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/del_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/del_roomLevel.go func (r *roomLevel) Del(ctx context.Context, req *DelRoomLevelReq, options ...larkcore.RequestOptionFunc) (*DelRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1284,11 +1284,11 @@ func (r *roomLevel) Del(ctx context.Context, req *DelRoomLevelReq, options ...la // 查询会议室层级详情 // -// - 该接口可以使用会议室层级ID查询会议室层级详情 +// - 该接口可以使用会议室层级 ID 查询会议室层级详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_roomLevel.go func (r *roomLevel) Get(ctx context.Context, req *GetRoomLevelReq, options ...larkcore.RequestOptionFunc) (*GetRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1312,9 +1312,9 @@ func (r *roomLevel) Get(ctx context.Context, req *GetRoomLevelReq, options ...la // // - 该接口用来查询某个会议室层级下的子层级列表 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/list +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/list_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/list_roomLevel.go func (r *roomLevel) List(ctx context.Context, req *ListRoomLevelReq, options ...larkcore.RequestOptionFunc) (*ListRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1344,11 +1344,11 @@ func (r *roomLevel) ListByIterator(ctx context.Context, req *ListRoomLevelReq, o // 批量查询会议室层级详情 // -// - 该接口可以使用会议室层级ID批量查询会议室层级详情 +// - 该接口可以使用会议室层级 ID 批量查询会议室层级详情 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/mget +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/mget // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/mget_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/mget_roomLevel.go func (r *roomLevel) Mget(ctx context.Context, req *MgetRoomLevelReq, options ...larkcore.RequestOptionFunc) (*MgetRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1372,9 +1372,9 @@ func (r *roomLevel) Mget(ctx context.Context, req *MgetRoomLevelReq, options ... // // - 该接口可以用来更新某个会议室层级的信息 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/patch +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/patch // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/patch_roomLevel.go func (r *roomLevel) Patch(ctx context.Context, req *PatchRoomLevelReq, options ...larkcore.RequestOptionFunc) (*PatchRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1396,11 +1396,11 @@ func (r *roomLevel) Patch(ctx context.Context, req *PatchRoomLevelReq, options . // 搜索会议室层级 // -// - 该接口可以用来搜索会议室层级，支持使用自定义会议室层级ID进行查询 +// - 该接口可以用来搜索会议室层级，支持使用自定义会议室层级 ID 进行查询 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/search +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/search // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/search_roomLevel.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/search_roomLevel.go func (r *roomLevel) Search(ctx context.Context, req *SearchRoomLevelReq, options ...larkcore.RequestOptionFunc) (*SearchRoomLevelResp, error) { // 发起请求 apiReq := req.apiReq @@ -1424,9 +1424,9 @@ func (r *roomLevel) Search(ctx context.Context, req *SearchRoomLevelReq, options // // - 该接口可以用来设置某个会议层级范围下或者某个会议室的配置 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/create +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/create_scopeConfig.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/create_scopeConfig.go func (s *scopeConfig) Create(ctx context.Context, req *CreateScopeConfigReq, options ...larkcore.RequestOptionFunc) (*CreateScopeConfigResp, error) { // 发起请求 apiReq := req.apiReq @@ -1450,9 +1450,9 @@ func (s *scopeConfig) Create(ctx context.Context, req *CreateScopeConfigReq, opt // // - 该接口可以用来查询某个会议层级范围下或者某个会议室的配置 // -// - 官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/get +// - 官网 API 文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_scopeConfig.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/vcv1/get_scopeConfig.go func (s *scopeConfig) Get(ctx context.Context, req *GetScopeConfigReq, options ...larkcore.RequestOptionFunc) (*GetScopeConfigResp, error) { // 发起请求 apiReq := req.apiReq diff --git a/service/vc/v1/event.go b/service/vc/v1/event.go index f04d4a85..1b9cd6fc 100644 --- a/service/vc/v1/event.go +++ b/service/vc/v1/event.go @@ -32,7 +32,7 @@ func (h *P2MeetingAllMeetingEndedV1Handler) Event() interface{} { return &P2MeetingAllMeetingEndedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingAllMeetingEndedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingAllMeetingEndedV1)) } @@ -52,7 +52,7 @@ func (h *P2MeetingAllMeetingStartedV1Handler) Event() interface{} { return &P2MeetingAllMeetingStartedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingAllMeetingStartedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingAllMeetingStartedV1)) } @@ -72,7 +72,7 @@ func (h *P2MeetingJoinMeetingV1Handler) Event() interface{} { return &P2MeetingJoinMeetingV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingJoinMeetingV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingJoinMeetingV1)) } @@ -92,7 +92,7 @@ func (h *P2MeetingLeaveMeetingV1Handler) Event() interface{} { return &P2MeetingLeaveMeetingV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingLeaveMeetingV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingLeaveMeetingV1)) } @@ -112,7 +112,7 @@ func (h *P2MeetingEndedV1Handler) Event() interface{} { return &P2MeetingEndedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingEndedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingEndedV1)) } @@ -132,7 +132,7 @@ func (h *P2MeetingStartedV1Handler) Event() interface{} { return &P2MeetingStartedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingStartedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingStartedV1)) } @@ -152,7 +152,7 @@ func (h *P2MeetingRecordingEndedV1Handler) Event() interface{} { return &P2MeetingRecordingEndedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRecordingEndedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRecordingEndedV1)) } @@ -172,7 +172,7 @@ func (h *P2MeetingRecordingReadyV1Handler) Event() interface{} { return &P2MeetingRecordingReadyV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRecordingReadyV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRecordingReadyV1)) } @@ -192,7 +192,7 @@ func (h *P2MeetingRecordingStartedV1Handler) Event() interface{} { return &P2MeetingRecordingStartedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingRecordingStartedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingRecordingStartedV1)) } @@ -212,7 +212,7 @@ func (h *P2MeetingShareEndedV1Handler) Event() interface{} { return &P2MeetingShareEndedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingShareEndedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingShareEndedV1)) } @@ -232,7 +232,7 @@ func (h *P2MeetingShareStartedV1Handler) Event() interface{} { return &P2MeetingShareStartedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2MeetingShareStartedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2MeetingShareStartedV1)) } @@ -252,7 +252,7 @@ func (h *P2ReserveConfigUpdatedV1Handler) Event() interface{} { return &P2ReserveConfigUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2ReserveConfigUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2ReserveConfigUpdatedV1)) } @@ -272,7 +272,7 @@ func (h *P2RoomCreatedV1Handler) Event() interface{} { return &P2RoomCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2RoomCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2RoomCreatedV1)) } @@ -292,7 +292,7 @@ func (h *P2RoomDeletedV1Handler) Event() interface{} { return &P2RoomDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2RoomDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2RoomDeletedV1)) } @@ -312,7 +312,7 @@ func (h *P2RoomUpdatedV1Handler) Event() interface{} { return &P2RoomUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2RoomUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2RoomUpdatedV1)) } @@ -332,7 +332,7 @@ func (h *P2RoomLevelCreatedV1Handler) Event() interface{} { return &P2RoomLevelCreatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2RoomLevelCreatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2RoomLevelCreatedV1)) } @@ -352,7 +352,7 @@ func (h *P2RoomLevelDeletedV1Handler) Event() interface{} { return &P2RoomLevelDeletedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2RoomLevelDeletedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2RoomLevelDeletedV1)) } @@ -372,7 +372,7 @@ func (h *P2RoomLevelUpdatedV1Handler) Event() interface{} { return &P2RoomLevelUpdatedV1{} } -// 回调开发者注册的handle +// 回调开发者注册的 handle func (h *P2RoomLevelUpdatedV1Handler) Handle(ctx context.Context, event interface{}) error { return h.handler(ctx, event.(*P2RoomLevelUpdatedV1)) } diff --git a/service/vc/v1/model.go b/service/vc/v1/model.go index 199e98ad..c8dd5091 100644 --- a/service/vc/v1/model.go +++ b/service/vc/v1/model.go @@ -29,69 +29,69 @@ import ( ) const ( - UserIdTypeUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeParticipantListExportUserId = "user_id" // 以user_id来识别用户 - UserIdTypeParticipantListExportUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeParticipantListExportOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeParticipantListExportUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeParticipantListExportUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeParticipantListExportOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeParticipantQualityListExportUserId = "user_id" // 以user_id来识别用户 - UserIdTypeParticipantQualityListExportUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeParticipantQualityListExportOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeParticipantQualityListExportUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeParticipantQualityListExportUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeParticipantQualityListExportOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeGetMeetingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetMeetingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetMeetingOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeGetMeetingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetMeetingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetMeetingOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeInviteMeetingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeInviteMeetingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeInviteMeetingOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeInviteMeetingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeInviteMeetingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeInviteMeetingOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeKickoutMeetingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeKickoutMeetingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeKickoutMeetingOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeKickoutMeetingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeKickoutMeetingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeKickoutMeetingOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeSetHostMeetingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSetHostMeetingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSetHostMeetingOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeSetHostMeetingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSetHostMeetingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSetHostMeetingOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeSetPermissionMeetingRecordingUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSetPermissionMeetingRecordingUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSetPermissionMeetingRecordingOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeSetPermissionMeetingRecordingUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSetPermissionMeetingRecordingUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSetPermissionMeetingRecordingOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeGetMeetingListUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetMeetingListUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetMeetingListOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetMeetingListUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetMeetingListUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetMeetingListOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetParticipantListUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetParticipantListUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetParticipantListOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetParticipantListUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetParticipantListUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetParticipantListOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetParticipantQualityListUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetParticipantQualityListUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetParticipantQualityListOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetParticipantQualityListUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetParticipantQualityListUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetParticipantQualityListOpenId = "open_id" // 以 open_id 来识别用户 ) const ( @@ -101,93 +101,93 @@ const ( ) const ( - UserIdTypeGetTopUserReportUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetTopUserReportUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetTopUserReportOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetTopUserReportUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetTopUserReportUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetTopUserReportOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeApplyReserveUserId = "user_id" // 以user_id来识别用户 - UserIdTypeApplyReserveUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeApplyReserveOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeApplyReserveUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeApplyReserveUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeApplyReserveOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeGetReserveUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetReserveUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetReserveOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetReserveUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetReserveUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetReserveOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetActiveMeetingReserveUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetActiveMeetingReserveUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetActiveMeetingReserveOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetActiveMeetingReserveUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetActiveMeetingReserveUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetActiveMeetingReserveOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeUpdateReserveUserId = "user_id" // 以user_id来识别用户 - UserIdTypeUpdateReserveUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeUpdateReserveOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeUpdateReserveUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeUpdateReserveUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeUpdateReserveOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypePatchReserveConfigUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchReserveConfigUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchReserveConfigOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchReserveConfigUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchReserveConfigUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchReserveConfigOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeReserveScopeReserveConfigUserId = "user_id" // 以user_id来识别用户 - UserIdTypeReserveScopeReserveConfigUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeReserveScopeReserveConfigOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeReserveScopeReserveConfigUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeReserveScopeReserveConfigUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeReserveScopeReserveConfigOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeGetReserveConfigAdminUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetReserveConfigAdminUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetReserveConfigAdminOpenId = "open_id" // 以open_id来识别用户 + UserIdTypeGetReserveConfigAdminUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetReserveConfigAdminUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetReserveConfigAdminOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypePatchReserveConfigAdminUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchReserveConfigAdminUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchReserveConfigAdminOpenId = "open_id" // 以open_id来识别用户 + UserIdTypePatchReserveConfigAdminUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchReserveConfigAdminUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchReserveConfigAdminOpenId = "open_id" // 以 open_id 来识别用户 ) const ( - UserIdTypeCreateRoomUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateRoomUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateRoomOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeCreateRoomUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateRoomUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateRoomOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeGetRoomUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetRoomUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetRoomOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeGetRoomUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetRoomUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetRoomOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeListRoomUserId = "user_id" // 以user_id来识别用户 - UserIdTypeListRoomUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeListRoomOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeListRoomUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeListRoomUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeListRoomOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeMgetRoomUserId = "user_id" // 以user_id来识别用户 - UserIdTypeMgetRoomUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeMgetRoomOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeMgetRoomUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeMgetRoomUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeMgetRoomOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypePatchRoomUserId = "user_id" // 以user_id来识别用户 - UserIdTypePatchRoomUnionId = "union_id" // 以union_id来识别用户 - UserIdTypePatchRoomOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypePatchRoomUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypePatchRoomUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypePatchRoomOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( - UserIdTypeSearchRoomUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSearchRoomUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSearchRoomOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeSearchRoomUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSearchRoomUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSearchRoomOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( @@ -201,9 +201,9 @@ const ( ) const ( - UserIdTypeQueryRoomConfigUserId = "user_id" // 以user_id来识别用户 - UserIdTypeQueryRoomConfigUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeQueryRoomConfigOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeQueryRoomConfigUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeQueryRoomConfigUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeQueryRoomConfigOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( @@ -217,9 +217,9 @@ const ( ) const ( - UserIdTypeSetRoomConfigUserId = "user_id" // 以user_id来识别用户 - UserIdTypeSetRoomConfigUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeSetRoomConfigOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeSetRoomConfigUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeSetRoomConfigUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeSetRoomConfigOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( @@ -229,9 +229,9 @@ const ( ) const ( - UserIdTypeCreateScopeConfigUserId = "user_id" // 以user_id来识别用户 - UserIdTypeCreateScopeConfigUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeCreateScopeConfigOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeCreateScopeConfigUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeCreateScopeConfigUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeCreateScopeConfigOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) const ( @@ -241,17 +241,17 @@ const ( ) const ( - UserIdTypeGetScopeConfigUserId = "user_id" // 以user_id来识别用户 - UserIdTypeGetScopeConfigUnionId = "union_id" // 以union_id来识别用户 - UserIdTypeGetScopeConfigOpenId = "open_id" // 以open_id来识别用户（推荐） + UserIdTypeGetScopeConfigUserId = "user_id" // 以 user_id 来识别用户 + UserIdTypeGetScopeConfigUnionId = "union_id" // 以 union_id 来识别用户 + UserIdTypeGetScopeConfigOpenId = "open_id" // 以 open_id 来识别用户（推荐） ) type Alert struct { - AlertId *string `json:"alert_id,omitempty"` // 告警ID + AlertId *string `json:"alert_id,omitempty"` // 告警 ID ResourceScope *string `json:"resource_scope,omitempty"` // 触发告警规则的会议室/服务器具体的名称 MonitorTarget *int `json:"monitor_target,omitempty"` // 触发告警规则的监控对象 AlertStrategy *string `json:"alert_strategy,omitempty"` // 告警规则的规则描述 - AlertTime *string `json:"alert_time,omitempty"` // 告警通知发生时间（unix时间，单位sec） + AlertTime *string `json:"alert_time,omitempty"` // 告警通知发生时间（unix 时间，单位 sec） AlertLevel *int `json:"alert_level,omitempty"` // 告警等级：严重/警告/提醒 Contacts []*Contact `json:"contacts,omitempty"` // 告警联系人 NotifyMethods []int `json:"notifyMethods,omitempty"` // 通知方式 @@ -259,7 +259,7 @@ type Alert struct { } type AlertBuilder struct { - alertId string // 告警ID + alertId string // 告警 ID alertIdFlag bool resourceScope string // 触发告警规则的会议室/服务器具体的名称 resourceScopeFlag bool @@ -267,7 +267,7 @@ type AlertBuilder struct { monitorTargetFlag bool alertStrategy string // 告警规则的规则描述 alertStrategyFlag bool - alertTime string // 告警通知发生时间（unix时间，单位sec） + alertTime string // 告警通知发生时间（unix 时间，单位 sec） alertTimeFlag bool alertLevel int // 告警等级：严重/警告/提醒 alertLevelFlag bool @@ -284,7 +284,7 @@ func NewAlertBuilder() *AlertBuilder { return builder } -// 告警ID +// 告警 ID // // 示例值：7115030004018184212 func (builder *AlertBuilder) AlertId(alertId string) *AlertBuilder { @@ -295,7 +295,7 @@ func (builder *AlertBuilder) AlertId(alertId string) *AlertBuilder { // 触发告警规则的会议室/服务器具体的名称 // -// 示例值：XX层级 +// 示例值：XX 层级 func (builder *AlertBuilder) ResourceScope(resourceScope string) *AlertBuilder { builder.resourceScope = resourceScope builder.resourceScopeFlag = true @@ -313,14 +313,14 @@ func (builder *AlertBuilder) MonitorTarget(monitorTarget int) *AlertBuilder { // 告警规则的规则描述 // -// 示例值：连续1个周期（共1分钟），控制器电量 < 50%，则告警 +// 示例值：连续 1 个周期（共 1 分钟），控制器电量 < 50%，则告警 func (builder *AlertBuilder) AlertStrategy(alertStrategy string) *AlertBuilder { builder.alertStrategy = alertStrategy builder.alertStrategyFlag = true return builder } -// 告警通知发生时间（unix时间，单位sec） +// 告警通知发生时间（unix 时间，单位 sec） // // 示例值：1656914944 func (builder *AlertBuilder) AlertTime(alertTime string) *AlertBuilder { @@ -407,7 +407,7 @@ func (builder *AlertBuilder) Build() *Alert { type ApprovalConfig struct { ApprovalSwitch *int `json:"approval_switch,omitempty"` // 预定审批开关：0 代表关闭，1 代表打开。;说明：;1. 未设置值时不更新原开关的值，但此时必填 approval_condition;2. 设置值为 1 时，必填 approval_condition
;3. 设置值为 0 时整个 ;approval_config 其他字段均可省略。 ApprovalCondition *int `json:"approval_condition,omitempty"` // 预定审批条件：0 代表所有预定均需审批，1 代表满足条件的需审批;说明：为 1 时必填 meeting_duration - MeetingDuration *float64 `json:"meeting_duration,omitempty"` // 超过 meeting_duration;的预定需要审批（单位：小时，取值范围[0.1-99]）;;说明：;1. 当 approval_condition ; 为 0 ，更新时如果未设置值，默认更新为 99 .;2. 传入的值小数点后超过 2 位，自动四舍五入保留两位。 + MeetingDuration *float64 `json:"meeting_duration,omitempty"` // 超过 meeting_duration;的预定需要审批（单位：小时，取值范围 [0.1-99]）;;说明：;1. 当 approval_condition ; 为 0 ，更新时如果未设置值，默认更新为 99 .;2. 传入的值小数点后超过 2 位，自动四舍五入保留两位。 Approvers []*SubscribeUser `json:"approvers,omitempty"` // 审批人列表，当打开审批开关时，至少需要设置一位审批人 } @@ -416,7 +416,7 @@ type ApprovalConfigBuilder struct { approvalSwitchFlag bool approvalCondition int // 预定审批条件：0 代表所有预定均需审批，1 代表满足条件的需审批;说明：为 1 时必填 meeting_duration approvalConditionFlag bool - meetingDuration float64 // 超过 meeting_duration;的预定需要审批（单位：小时，取值范围[0.1-99]）;;说明：;1. 当 approval_condition ; 为 0 ，更新时如果未设置值，默认更新为 99 .;2. 传入的值小数点后超过 2 位，自动四舍五入保留两位。 + meetingDuration float64 // 超过 meeting_duration;的预定需要审批（单位：小时，取值范围 [0.1-99]）;;说明：;1. 当 approval_condition ; 为 0 ，更新时如果未设置值，默认更新为 99 .;2. 传入的值小数点后超过 2 位，自动四舍五入保留两位。 meetingDurationFlag bool approvers []*SubscribeUser // 审批人列表，当打开审批开关时，至少需要设置一位审批人 approversFlag bool @@ -445,7 +445,7 @@ func (builder *ApprovalConfigBuilder) ApprovalCondition(approvalCondition int) * return builder } -// 超过 meeting_duration;的预定需要审批（单位：小时，取值范围[0.1-99]）;;说明：;1. 当 approval_condition ; 为 0 ，更新时如果未设置值，默认更新为 99 .;2. 传入的值小数点后超过 2 位，自动四舍五入保留两位。 +// 超过 meeting_duration;的预定需要审批（单位：小时，取值范围 [0.1-99]）;;说明：;1. 当 approval_condition ; 为 0 ，更新时如果未设置值，默认更新为 99 .;2. 传入的值小数点后超过 2 位，自动四舍五入保留两位。 // // 示例值：3 func (builder *ApprovalConfigBuilder) MeetingDuration(meetingDuration float64) *ApprovalConfigBuilder { @@ -484,18 +484,18 @@ func (builder *ApprovalConfigBuilder) Build() *ApprovalConfig { } type ApprovalConfigEvent struct { - ApprovalSwitch *int `json:"approval_switch,omitempty"` // 预定审批开关，0关闭，1打开 - ApprovalCondition *int `json:"approval_condition,omitempty"` // 预定审批条件，0所有预定需要审批，1满足条件需审批 - MeetingDuration *float64 `json:"meeting_duration,omitempty"` // 超过 meeting_duration小时需要审批 + ApprovalSwitch *int `json:"approval_switch,omitempty"` // 预定审批开关，0 关闭，1 打开 + ApprovalCondition *int `json:"approval_condition,omitempty"` // 预定审批条件，0 所有预定需要审批，1 满足条件需审批 + MeetingDuration *float64 `json:"meeting_duration,omitempty"` // 超过 meeting_duration 小时需要审批 Approvers []*SubscribeUserEvent `json:"approvers,omitempty"` // 审批人列表 } type ApprovalConfigEventBuilder struct { - approvalSwitch int // 预定审批开关，0关闭，1打开 + approvalSwitch int // 预定审批开关，0 关闭，1 打开 approvalSwitchFlag bool - approvalCondition int // 预定审批条件，0所有预定需要审批，1满足条件需审批 + approvalCondition int // 预定审批条件，0 所有预定需要审批，1 满足条件需审批 approvalConditionFlag bool - meetingDuration float64 // 超过 meeting_duration小时需要审批 + meetingDuration float64 // 超过 meeting_duration 小时需要审批 meetingDurationFlag bool approvers []*SubscribeUserEvent // 审批人列表 approversFlag bool @@ -506,7 +506,7 @@ func NewApprovalConfigEventBuilder() *ApprovalConfigEventBuilder { return builder } -// 预定审批开关，0关闭，1打开 +// 预定审批开关，0 关闭，1 打开 // // 示例值：0 func (builder *ApprovalConfigEventBuilder) ApprovalSwitch(approvalSwitch int) *ApprovalConfigEventBuilder { @@ -515,7 +515,7 @@ func (builder *ApprovalConfigEventBuilder) ApprovalSwitch(approvalSwitch int) *A return builder } -// 预定审批条件，0所有预定需要审批，1满足条件需审批 +// 预定审批条件，0 所有预定需要审批，1 满足条件需审批 // // 示例值：0 func (builder *ApprovalConfigEventBuilder) ApprovalCondition(approvalCondition int) *ApprovalConfigEventBuilder { @@ -524,7 +524,7 @@ func (builder *ApprovalConfigEventBuilder) ApprovalCondition(approvalCondition i return builder } -// 超过 meeting_duration小时需要审批 +// 超过 meeting_duration 小时需要审批 // // 示例值：1 func (builder *ApprovalConfigEventBuilder) MeetingDuration(meetingDuration float64) *ApprovalConfigEventBuilder { @@ -563,14 +563,14 @@ func (builder *ApprovalConfigEventBuilder) Build() *ApprovalConfigEvent { } type Conditions struct { - CustomKey *string `json:"custom_key,omitempty"` // 自定义题目的key - OptionKeys []string `json:"option_keys,omitempty"` // 自定义选项的key + CustomKey *string `json:"custom_key,omitempty"` // 自定义题目的 key + OptionKeys []string `json:"option_keys,omitempty"` // 自定义选项的 key } type ConditionsBuilder struct { - customKey string // 自定义题目的key + customKey string // 自定义题目的 key customKeyFlag bool - optionKeys []string // 自定义选项的key + optionKeys []string // 自定义选项的 key optionKeysFlag bool } @@ -579,7 +579,7 @@ func NewConditionsBuilder() *ConditionsBuilder { return builder } -// 自定义题目的key +// 自定义题目的 key // // 示例值：167383928372636 func (builder *ConditionsBuilder) CustomKey(customKey string) *ConditionsBuilder { @@ -588,7 +588,7 @@ func (builder *ConditionsBuilder) CustomKey(customKey string) *ConditionsBuilder return builder } -// 自定义选项的key +// 自定义选项的 key // // 示例值： func (builder *ConditionsBuilder) OptionKeys(optionKeys []string) *ConditionsBuilder { @@ -659,7 +659,7 @@ func (builder *ContactBuilder) Build() *Contact { type CustomList struct { CustomType *int `json:"custom_type,omitempty"` // 问题类型 - Key *string `json:"key,omitempty"` // 自定义题目的key，用于设置显示条件 + Key *string `json:"key,omitempty"` // 自定义题目的 key，用于设置显示条件 NeedFill *bool `json:"need_fill,omitempty"` // 题目是否必填 Title *string `json:"title,omitempty"` // 题目标题 Placeholder *string `json:"placeholder,omitempty"` // 文本框题目对应的输入提示 @@ -670,7 +670,7 @@ type CustomList struct { type CustomListBuilder struct { customType int // 问题类型 customTypeFlag bool - key string // 自定义题目的key，用于设置显示条件 + key string // 自定义题目的 key，用于设置显示条件 keyFlag bool needFill bool // 题目是否必填 needFillFlag bool @@ -698,7 +698,7 @@ func (builder *CustomListBuilder) CustomType(customType int) *CustomListBuilder return builder } -// 自定义题目的key，用于设置显示条件 +// 自定义题目的 key，用于设置显示条件 // // 示例值：238281272 func (builder *CustomListBuilder) Key(key string) *CustomListBuilder { @@ -817,8 +817,8 @@ func (builder *DeviceBuilder) Build() *Device { type Material struct { Name *string `json:"name,omitempty"` // 素材名称 - FileToken *string `json:"file_token,omitempty"` // 文件上传drive后的token - FileSize *int `json:"file_size,omitempty"` // 文件大小(KB) + FileToken *string `json:"file_token,omitempty"` // 文件上传 drive 后的 token + FileSize *int `json:"file_size,omitempty"` // 文件大小 (KB) DeviceType *int `json:"device_type,omitempty"` // 素材适用设备类型 MaterialType *int `json:"material_type,omitempty"` // 素材类型 ReviewResult *int `json:"review_result,omitempty"` // 审核结果 @@ -828,9 +828,9 @@ type Material struct { type MaterialBuilder struct { name string // 素材名称 nameFlag bool - fileToken string // 文件上传drive后的token + fileToken string // 文件上传 drive 后的 token fileTokenFlag bool - fileSize int // 文件大小(KB) + fileSize int // 文件大小 (KB) fileSizeFlag bool deviceType int // 素材适用设备类型 deviceTypeFlag bool @@ -856,7 +856,7 @@ func (builder *MaterialBuilder) Name(name string) *MaterialBuilder { return builder } -// 文件上传drive后的token +// 文件上传 drive 后的 token // // 示例值：u8ajdjadau8wqu func (builder *MaterialBuilder) FileToken(fileToken string) *MaterialBuilder { @@ -865,7 +865,7 @@ func (builder *MaterialBuilder) FileToken(fileToken string) *MaterialBuilder { return builder } -// 文件大小(KB) +// 文件大小 (KB) // // 示例值：1024 func (builder *MaterialBuilder) FileSize(fileSize int) *MaterialBuilder { @@ -944,12 +944,12 @@ func (builder *MaterialBuilder) Build() *Material { } type MaterialDeleteResult struct { - FileToken *string `json:"file_token,omitempty"` // 文件上传drive后的token + FileToken *string `json:"file_token,omitempty"` // 文件上传 drive 后的 token Result *int `json:"result,omitempty"` // 删除结果 } type MaterialDeleteResultBuilder struct { - fileToken string // 文件上传drive后的token + fileToken string // 文件上传 drive 后的 token fileTokenFlag bool result int // 删除结果 resultFlag bool @@ -960,7 +960,7 @@ func NewMaterialDeleteResultBuilder() *MaterialDeleteResultBuilder { return builder } -// 文件上传drive后的token +// 文件上传 drive 后的 token // // 示例值：u8ajdjadau8wqu func (builder *MaterialDeleteResultBuilder) FileToken(fileToken string) *MaterialDeleteResultBuilder { @@ -992,12 +992,12 @@ func (builder *MaterialDeleteResultBuilder) Build() *MaterialDeleteResult { } type MaterialReviewResult struct { - FileToken *string `json:"file_token,omitempty"` // 文件上传drive后的token + FileToken *string `json:"file_token,omitempty"` // 文件上传 drive 后的 token Result *int `json:"result,omitempty"` // 审核结果 } type MaterialReviewResultBuilder struct { - fileToken string // 文件上传drive后的token + fileToken string // 文件上传 drive 后的 token fileTokenFlag bool result int // 审核结果 resultFlag bool @@ -1008,7 +1008,7 @@ func NewMaterialReviewResultBuilder() *MaterialReviewResultBuilder { return builder } -// 文件上传drive后的token +// 文件上传 drive 后的 token // // 示例值：u8ajdjadau8wqu func (builder *MaterialReviewResultBuilder) FileToken(fileToken string) *MaterialReviewResultBuilder { @@ -1040,12 +1040,12 @@ func (builder *MaterialReviewResultBuilder) Build() *MaterialReviewResult { } type MaterialUploadResult struct { - FileToken *string `json:"file_token,omitempty"` // 文件上传drive后的token + FileToken *string `json:"file_token,omitempty"` // 文件上传 drive 后的 token Result *int `json:"result,omitempty"` // 上传结果 } type MaterialUploadResultBuilder struct { - fileToken string // 文件上传drive后的token + fileToken string // 文件上传 drive 后的 token fileTokenFlag bool result int // 上传结果 resultFlag bool @@ -1056,7 +1056,7 @@ func NewMaterialUploadResultBuilder() *MaterialUploadResultBuilder { return builder } -// 文件上传drive后的token +// 文件上传 drive 后的 token // // 示例值：u8ajdjadau8wqu func (builder *MaterialUploadResultBuilder) FileToken(fileToken string) *MaterialUploadResultBuilder { @@ -1088,13 +1088,13 @@ func (builder *MaterialUploadResultBuilder) Build() *MaterialUploadResult { } type Meeting struct { - Id *string `json:"id,omitempty"` // 会议ID（视频会议的唯一标识，视频会议开始后才会产生） + Id *string `json:"id,omitempty"` // 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） Topic *string `json:"topic,omitempty"` // 会议主题 Url *string `json:"url,omitempty"` // 会议链接（飞书用户可通过点击会议链接快捷入会） MeetingNo *string `json:"meeting_no,omitempty"` // 会议号 - CreateTime *string `json:"create_time,omitempty"` // 会议创建时间（unix时间，单位sec） - StartTime *string `json:"start_time,omitempty"` // 会议开始时间（unix时间，单位sec） - EndTime *string `json:"end_time,omitempty"` // 会议结束时间（unix时间，单位sec） + CreateTime *string `json:"create_time,omitempty"` // 会议创建时间（unix 时间，单位 sec） + StartTime *string `json:"start_time,omitempty"` // 会议开始时间（unix 时间，单位 sec） + EndTime *string `json:"end_time,omitempty"` // 会议结束时间（unix 时间，单位 sec） HostUser *MeetingUser `json:"host_user,omitempty"` // 主持人 Status *int `json:"status,omitempty"` // 会议状态 ParticipantCount *string `json:"participant_count,omitempty"` // 参会峰值人数 @@ -1104,7 +1104,7 @@ type Meeting struct { } type MeetingBuilder struct { - id string // 会议ID（视频会议的唯一标识，视频会议开始后才会产生） + id string // 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） idFlag bool topic string // 会议主题 topicFlag bool @@ -1112,11 +1112,11 @@ type MeetingBuilder struct { urlFlag bool meetingNo string // 会议号 meetingNoFlag bool - createTime string // 会议创建时间（unix时间，单位sec） + createTime string // 会议创建时间（unix 时间，单位 sec） createTimeFlag bool - startTime string // 会议开始时间（unix时间，单位sec） + startTime string // 会议开始时间（unix 时间，单位 sec） startTimeFlag bool - endTime string // 会议结束时间（unix时间，单位sec） + endTime string // 会议结束时间（unix 时间，单位 sec） endTimeFlag bool hostUser *MeetingUser // 主持人 hostUserFlag bool @@ -1137,7 +1137,7 @@ func NewMeetingBuilder() *MeetingBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411934433028 func (builder *MeetingBuilder) Id(id string) *MeetingBuilder { @@ -1173,7 +1173,7 @@ func (builder *MeetingBuilder) MeetingNo(meetingNo string) *MeetingBuilder { return builder } -// 会议创建时间（unix时间，单位sec） +// 会议创建时间（unix 时间，单位 sec） // // 示例值：1608885566 func (builder *MeetingBuilder) CreateTime(createTime string) *MeetingBuilder { @@ -1182,7 +1182,7 @@ func (builder *MeetingBuilder) CreateTime(createTime string) *MeetingBuilder { return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // // 示例值：1608883322 func (builder *MeetingBuilder) StartTime(startTime string) *MeetingBuilder { @@ -1191,7 +1191,7 @@ func (builder *MeetingBuilder) StartTime(startTime string) *MeetingBuilder { return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // // 示例值：1608888867 func (builder *MeetingBuilder) EndTime(endTime string) *MeetingBuilder { @@ -1309,20 +1309,20 @@ func (builder *MeetingBuilder) Build() *Meeting { } type MeetingRecording struct { - Id *string `json:"id,omitempty"` // 录制ID - MeetingId *string `json:"meeting_id,omitempty"` // 会议ID - Url *string `json:"url,omitempty"` // 录制文件URL - Duration *string `json:"duration,omitempty"` // 录制总时长（单位msec） + Id *string `json:"id,omitempty"` // 录制 ID + MeetingId *string `json:"meeting_id,omitempty"` // 会议 ID + Url *string `json:"url,omitempty"` // 录制文件 URL + Duration *string `json:"duration,omitempty"` // 录制总时长（单位 msec） } type MeetingRecordingBuilder struct { - id string // 录制ID + id string // 录制 ID idFlag bool - meetingId string // 会议ID + meetingId string // 会议 ID meetingIdFlag bool - url string // 录制文件URL + url string // 录制文件 URL urlFlag bool - duration string // 录制总时长（单位msec） + duration string // 录制总时长（单位 msec） durationFlag bool } @@ -1331,7 +1331,7 @@ func NewMeetingRecordingBuilder() *MeetingRecordingBuilder { return builder } -// 录制ID +// 录制 ID // // 示例值：6911188411932033028 func (builder *MeetingRecordingBuilder) Id(id string) *MeetingRecordingBuilder { @@ -1340,7 +1340,7 @@ func (builder *MeetingRecordingBuilder) Id(id string) *MeetingRecordingBuilder { return builder } -// 会议ID +// 会议 ID // // 示例值：6911188411932033028 func (builder *MeetingRecordingBuilder) MeetingId(meetingId string) *MeetingRecordingBuilder { @@ -1349,7 +1349,7 @@ func (builder *MeetingRecordingBuilder) MeetingId(meetingId string) *MeetingReco return builder } -// 录制文件URL +// 录制文件 URL // // 示例值：https://meetings.feishu.cn/minutes/obcn37dxcftoc3656rgyejm7 func (builder *MeetingRecordingBuilder) Url(url string) *MeetingRecordingBuilder { @@ -1358,7 +1358,7 @@ func (builder *MeetingRecordingBuilder) Url(url string) *MeetingRecordingBuilder return builder } -// 录制总时长（单位msec） +// 录制总时长（单位 msec） // // 示例值：30000 func (builder *MeetingRecordingBuilder) Duration(duration string) *MeetingRecordingBuilder { @@ -1394,7 +1394,7 @@ type MeetingAbility struct { UseShareScreen *bool `json:"use_share_screen,omitempty"` // 是否使用共享屏幕 UseFollowScreen *bool `json:"use_follow_screen,omitempty"` // 是否使用妙享（magic share） UseRecording *bool `json:"use_recording,omitempty"` // 是否使用录制 - UsePstn *bool `json:"use_pstn,omitempty"` // 是否使用PSTN + UsePstn *bool `json:"use_pstn,omitempty"` // 是否使用 PSTN } type MeetingAbilityBuilder struct { @@ -1408,7 +1408,7 @@ type MeetingAbilityBuilder struct { useFollowScreenFlag bool useRecording bool // 是否使用录制 useRecordingFlag bool - usePstn bool // 是否使用PSTN + usePstn bool // 是否使用 PSTN usePstnFlag bool } @@ -1462,7 +1462,7 @@ func (builder *MeetingAbilityBuilder) UseRecording(useRecording bool) *MeetingAb return builder } -// 是否使用PSTN +// 是否使用 PSTN // // 示例值：true func (builder *MeetingAbilityBuilder) UsePstn(usePstn bool) *MeetingAbilityBuilder { @@ -1501,28 +1501,28 @@ func (builder *MeetingAbilityBuilder) Build() *MeetingAbility { } type MeetingEventMeeting struct { - Id *string `json:"id,omitempty"` // 会议ID（视频会议的唯一标识，视频会议开始后才会产生） + Id *string `json:"id,omitempty"` // 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） Topic *string `json:"topic,omitempty"` // 会议主题 - MeetingNo *string `json:"meeting_no,omitempty"` // 9位会议号（飞书用户可通过输入9位会议号快捷入会） + MeetingNo *string `json:"meeting_no,omitempty"` // 9 位会议号（飞书用户可通过输入 9 位会议号快捷入会） MeetingSource *int `json:"meeting_source,omitempty"` // 会议创建源 - StartTime *string `json:"start_time,omitempty"` // 会议开始时间（unix时间，单位sec） - EndTime *string `json:"end_time,omitempty"` // 会议结束时间（unix时间，单位sec） + StartTime *string `json:"start_time,omitempty"` // 会议开始时间（unix 时间，单位 sec） + EndTime *string `json:"end_time,omitempty"` // 会议结束时间（unix 时间，单位 sec） HostUser *MeetingEventUser `json:"host_user,omitempty"` // 会议主持人 Owner *MeetingEventUser `json:"owner,omitempty"` // 会议拥有者 } type MeetingEventMeetingBuilder struct { - id string // 会议ID（视频会议的唯一标识，视频会议开始后才会产生） + id string // 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） idFlag bool topic string // 会议主题 topicFlag bool - meetingNo string // 9位会议号（飞书用户可通过输入9位会议号快捷入会） + meetingNo string // 9 位会议号（飞书用户可通过输入 9 位会议号快捷入会） meetingNoFlag bool meetingSource int // 会议创建源 meetingSourceFlag bool - startTime string // 会议开始时间（unix时间，单位sec） + startTime string // 会议开始时间（unix 时间，单位 sec） startTimeFlag bool - endTime string // 会议结束时间（unix时间，单位sec） + endTime string // 会议结束时间（unix 时间，单位 sec） endTimeFlag bool hostUser *MeetingEventUser // 会议主持人 hostUserFlag bool @@ -1535,7 +1535,7 @@ func NewMeetingEventMeetingBuilder() *MeetingEventMeetingBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411934433028 func (builder *MeetingEventMeetingBuilder) Id(id string) *MeetingEventMeetingBuilder { @@ -1553,7 +1553,7 @@ func (builder *MeetingEventMeetingBuilder) Topic(topic string) *MeetingEventMeet return builder } -// 9位会议号（飞书用户可通过输入9位会议号快捷入会） +// 9 位会议号（飞书用户可通过输入 9 位会议号快捷入会） // // 示例值：235812466 func (builder *MeetingEventMeetingBuilder) MeetingNo(meetingNo string) *MeetingEventMeetingBuilder { @@ -1571,7 +1571,7 @@ func (builder *MeetingEventMeetingBuilder) MeetingSource(meetingSource int) *Mee return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // // 示例值：1608883322 func (builder *MeetingEventMeetingBuilder) StartTime(startTime string) *MeetingEventMeetingBuilder { @@ -1580,7 +1580,7 @@ func (builder *MeetingEventMeetingBuilder) StartTime(startTime string) *MeetingE return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // // 示例值：1608883899 func (builder *MeetingEventMeetingBuilder) EndTime(endTime string) *MeetingEventMeetingBuilder { @@ -1706,11 +1706,11 @@ func (builder *MeetingEventUserBuilder) Build() *MeetingEventUser { } type MeetingInfo struct { - MeetingId *string `json:"meeting_id,omitempty"` // 会议ID + MeetingId *string `json:"meeting_id,omitempty"` // 会议 ID MeetingTopic *string `json:"meeting_topic,omitempty"` // 会议主题 Organizer *string `json:"organizer,omitempty"` // 组织者 Department *string `json:"department,omitempty"` // 部门 - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID EmployeeId *string `json:"employee_id,omitempty"` // 工号 Email *string `json:"email,omitempty"` // 邮箱 Mobile *string `json:"mobile,omitempty"` // 手机 @@ -1726,7 +1726,7 @@ type MeetingInfo struct { } type MeetingInfoBuilder struct { - meetingId string // 会议ID + meetingId string // 会议 ID meetingIdFlag bool meetingTopic string // 会议主题 meetingTopicFlag bool @@ -1734,7 +1734,7 @@ type MeetingInfoBuilder struct { organizerFlag bool department string // 部门 departmentFlag bool - userId string // 用户ID + userId string // 用户 ID userIdFlag bool employeeId string // 工号 employeeIdFlag bool @@ -1767,7 +1767,7 @@ func NewMeetingInfoBuilder() *MeetingInfoBuilder { return builder } -// 会议ID +// 会议 ID // // 示例值：705605196 func (builder *MeetingInfoBuilder) MeetingId(meetingId string) *MeetingInfoBuilder { @@ -1803,7 +1803,7 @@ func (builder *MeetingInfoBuilder) Department(department string) *MeetingInfoBui return builder } -// 用户ID +// 用户 ID // // 示例值：92f879 func (builder *MeetingInfoBuilder) UserId(userId string) *MeetingInfoBuilder { @@ -1994,13 +1994,13 @@ func (builder *MeetingInfoBuilder) Build() *MeetingInfo { } type MeetingInviteStatus struct { - Id *string `json:"id,omitempty"` // 用户ID + Id *string `json:"id,omitempty"` // 用户 ID UserType *int `json:"user_type,omitempty"` // 用户类型 Status *int `json:"status,omitempty"` // 邀请结果 } type MeetingInviteStatusBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool userType int // 用户类型 userTypeFlag bool @@ -2013,7 +2013,7 @@ func NewMeetingInviteStatusBuilder() *MeetingInviteStatusBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *MeetingInviteStatusBuilder) Id(id string) *MeetingInviteStatusBuilder { @@ -2058,9 +2058,9 @@ func (builder *MeetingInviteStatusBuilder) Build() *MeetingInviteStatus { } type MeetingParticipant struct { - Id *string `json:"id,omitempty"` // 用户ID - FirstJoinTime *string `json:"first_join_time,omitempty"` // 首次入会时间，秒级Unix时间戳 - FinalLeaveTime *string `json:"final_leave_time,omitempty"` // 最终离会时间，秒级Unix时间戳 + Id *string `json:"id,omitempty"` // 用户 ID + FirstJoinTime *string `json:"first_join_time,omitempty"` // 首次入会时间，秒级 Unix 时间戳 + FinalLeaveTime *string `json:"final_leave_time,omitempty"` // 最终离会时间，秒级 Unix 时间戳 InMeetingDuration *string `json:"in_meeting_duration,omitempty"` // 累计在会中时间，时间单位：秒 UserType *int `json:"user_type,omitempty"` // 用户类型 IsHost *bool `json:"is_host,omitempty"` // 是否为主持人 @@ -2070,11 +2070,11 @@ type MeetingParticipant struct { } type MeetingParticipantBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool - firstJoinTime string // 首次入会时间，秒级Unix时间戳 + firstJoinTime string // 首次入会时间，秒级 Unix 时间戳 firstJoinTimeFlag bool - finalLeaveTime string // 最终离会时间，秒级Unix时间戳 + finalLeaveTime string // 最终离会时间，秒级 Unix 时间戳 finalLeaveTimeFlag bool inMeetingDuration string // 累计在会中时间，时间单位：秒 inMeetingDurationFlag bool @@ -2095,7 +2095,7 @@ func NewMeetingParticipantBuilder() *MeetingParticipantBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *MeetingParticipantBuilder) Id(id string) *MeetingParticipantBuilder { @@ -2104,7 +2104,7 @@ func (builder *MeetingParticipantBuilder) Id(id string) *MeetingParticipantBuild return builder } -// 首次入会时间，秒级Unix时间戳 +// 首次入会时间，秒级 Unix 时间戳 // // 示例值：1624438144 func (builder *MeetingParticipantBuilder) FirstJoinTime(firstJoinTime string) *MeetingParticipantBuilder { @@ -2113,7 +2113,7 @@ func (builder *MeetingParticipantBuilder) FirstJoinTime(firstJoinTime string) *M return builder } -// 最终离会时间，秒级Unix时间戳 +// 最终离会时间，秒级 Unix 时间戳 // // 示例值：1624438144 func (builder *MeetingParticipantBuilder) FinalLeaveTime(finalLeaveTime string) *MeetingParticipantBuilder { @@ -2218,13 +2218,13 @@ func (builder *MeetingParticipantBuilder) Build() *MeetingParticipant { } type MeetingParticipantResult struct { - Id *string `json:"id,omitempty"` // 用户ID + Id *string `json:"id,omitempty"` // 用户 ID UserType *int `json:"user_type,omitempty"` // 用户类型 Result *int `json:"result,omitempty"` // 移除结果 } type MeetingParticipantResultBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool userType int // 用户类型 userTypeFlag bool @@ -2237,7 +2237,7 @@ func NewMeetingParticipantResultBuilder() *MeetingParticipantResultBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *MeetingParticipantResultBuilder) Id(id string) *MeetingParticipantResultBuilder { @@ -2282,12 +2282,12 @@ func (builder *MeetingParticipantResultBuilder) Build() *MeetingParticipantResul } type MeetingUser struct { - Id *string `json:"id,omitempty"` // 用户ID + Id *string `json:"id,omitempty"` // 用户 ID UserType *int `json:"user_type,omitempty"` // 用户类型 } type MeetingUserBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool userType int // 用户类型 userTypeFlag bool @@ -2298,7 +2298,7 @@ func NewMeetingUserBuilder() *MeetingUserBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *MeetingUserBuilder) Id(id string) *MeetingUserBuilder { @@ -2331,14 +2331,14 @@ func (builder *MeetingUserBuilder) Build() *MeetingUser { type Options struct { Text *string `json:"text,omitempty"` // 选项文本名称/其他选项的对应文本 - Key *string `json:"key,omitempty"` // 选项的自定义key + Key *string `json:"key,omitempty"` // 选项的自定义 key IsOther *bool `json:"is_other,omitempty"` // 区分是否为其他选项 } type OptionsBuilder struct { text string // 选项文本名称/其他选项的对应文本 textFlag bool - key string // 选项的自定义key + key string // 选项的自定义 key keyFlag bool isOther bool // 区分是否为其他选项 isOtherFlag bool @@ -2351,14 +2351,14 @@ func NewOptionsBuilder() *OptionsBuilder { // 选项文本名称/其他选项的对应文本 // -// 示例值：选项1 +// 示例值：选项 1 func (builder *OptionsBuilder) Text(text string) *OptionsBuilder { builder.text = text builder.textFlag = true return builder } -// 选项的自定义key +// 选项的自定义 key // // 示例值：23213812938 func (builder *OptionsBuilder) Key(key string) *OptionsBuilder { @@ -2396,14 +2396,14 @@ func (builder *OptionsBuilder) Build() *Options { type Participant struct { ParticipantName *string `json:"participant_name,omitempty"` // 参会者 Department *string `json:"department,omitempty"` // 部门 - UserId *string `json:"user_id,omitempty"` // 用户ID + UserId *string `json:"user_id,omitempty"` // 用户 ID EmployeeId *string `json:"employee_id,omitempty"` // 工号 Phone *string `json:"phone,omitempty"` // 电话 Email *string `json:"email,omitempty"` // 邮箱 Device *string `json:"device,omitempty"` // 设备 AppVersion *string `json:"app_version,omitempty"` // 客户端版本 - PublicIp *string `json:"public_ip,omitempty"` // 公网IP - InternalIp *string `json:"internal_ip,omitempty"` // 内网IP + PublicIp *string `json:"public_ip,omitempty"` // 公网 IP + InternalIp *string `json:"internal_ip,omitempty"` // 内网 IP UseRtcProxy *bool `json:"use_rtc_proxy,omitempty"` // 代理服务 Location *string `json:"location,omitempty"` // 位置 NetworkType *string `json:"network_type,omitempty"` // 网络类型 @@ -2425,7 +2425,7 @@ type ParticipantBuilder struct { participantNameFlag bool department string // 部门 departmentFlag bool - userId string // 用户ID + userId string // 用户 ID userIdFlag bool employeeId string // 工号 employeeIdFlag bool @@ -2437,9 +2437,9 @@ type ParticipantBuilder struct { deviceFlag bool appVersion string // 客户端版本 appVersionFlag bool - publicIp string // 公网IP + publicIp string // 公网 IP publicIpFlag bool - internalIp string // 内网IP + internalIp string // 内网 IP internalIpFlag bool useRtcProxy bool // 代理服务 useRtcProxyFlag bool @@ -2494,7 +2494,7 @@ func (builder *ParticipantBuilder) Department(department string) *ParticipantBui return builder } -// 用户ID +// 用户 ID // // 示例值：8efq90 func (builder *ParticipantBuilder) UserId(userId string) *ParticipantBuilder { @@ -2548,7 +2548,7 @@ func (builder *ParticipantBuilder) AppVersion(appVersion string) *ParticipantBui return builder } -// 公网IP +// 公网 IP // // 示例值：27.xx.xx.183 func (builder *ParticipantBuilder) PublicIp(publicIp string) *ParticipantBuilder { @@ -2557,7 +2557,7 @@ func (builder *ParticipantBuilder) PublicIp(publicIp string) *ParticipantBuilder return builder } -// 内网IP +// 内网 IP // // 示例值：192.xx.xx.13 func (builder *ParticipantBuilder) InternalIp(internalIp string) *ParticipantBuilder { @@ -2798,7 +2798,7 @@ type ParticipantQuality struct { Audio *QualityAudio `json:"audio,omitempty"` // 音频 Video *QualityVideoSharing `json:"video,omitempty"` // 视频 ScreenSharing *QualityVideoSharing `json:"screen_sharing,omitempty"` // 共享屏幕 - CpuUsage *QualityCpuUsage `json:"cpu_usage,omitempty"` // Cpu使用量 + CpuUsage *QualityCpuUsage `json:"cpu_usage,omitempty"` // Cpu 使用量 } type ParticipantQualityBuilder struct { @@ -2810,7 +2810,7 @@ type ParticipantQualityBuilder struct { videoFlag bool screenSharing *QualityVideoSharing // 共享屏幕 screenSharingFlag bool - cpuUsage *QualityCpuUsage // Cpu使用量 + cpuUsage *QualityCpuUsage // Cpu 使用量 cpuUsageFlag bool } @@ -2855,7 +2855,7 @@ func (builder *ParticipantQualityBuilder) ScreenSharing(screenSharing *QualityVi return builder } -// Cpu使用量 +// Cpu 使用量 // // 示例值： func (builder *ParticipantQualityBuilder) CpuUsage(cpuUsage *QualityCpuUsage) *ParticipantQualityBuilder { @@ -2885,14 +2885,14 @@ func (builder *ParticipantQualityBuilder) Build() *ParticipantQuality { } type PstnSipInfo struct { - Nickname *string `json:"nickname,omitempty"` // 给pstn/sip用户设置的临时昵称 - MainAddress *string `json:"main_address,omitempty"` // pstn/sip主机号，格式为：[国际冠字]-[电话区号][电话号码]，当前仅支持国内手机及固定电话号码 + Nickname *string `json:"nickname,omitempty"` // 给 pstn/sip 用户设置的临时昵称 + MainAddress *string `json:"main_address,omitempty"` // pstn/sip 主机号，格式为：[国际冠字]-[电话区号][电话号码]，当前仅支持国内手机及固定电话号码 } type PstnSipInfoBuilder struct { - nickname string // 给pstn/sip用户设置的临时昵称 + nickname string // 给 pstn/sip 用户设置的临时昵称 nicknameFlag bool - mainAddress string // pstn/sip主机号，格式为：[国际冠字]-[电话区号][电话号码]，当前仅支持国内手机及固定电话号码 + mainAddress string // pstn/sip 主机号，格式为：[国际冠字]-[电话区号][电话号码]，当前仅支持国内手机及固定电话号码 mainAddressFlag bool } @@ -2901,7 +2901,7 @@ func NewPstnSipInfoBuilder() *PstnSipInfoBuilder { return builder } -// 给pstn/sip用户设置的临时昵称 +// 给 pstn/sip 用户设置的临时昵称 // // 示例值：dodo func (builder *PstnSipInfoBuilder) Nickname(nickname string) *PstnSipInfoBuilder { @@ -2910,7 +2910,7 @@ func (builder *PstnSipInfoBuilder) Nickname(nickname string) *PstnSipInfoBuilder return builder } -// pstn/sip主机号，格式为：[国际冠字]-[电话区号][电话号码]，当前仅支持国内手机及固定电话号码 +// pstn/sip 主机号，格式为：[国际冠字]-[电话区号][电话号码]，当前仅支持国内手机及固定电话号码 // // 示例值：+86-02187654321 func (builder *PstnSipInfoBuilder) MainAddress(mainAddress string) *PstnSipInfoBuilder { @@ -3525,13 +3525,13 @@ func (builder *QualityVideoSharingBuilder) Build() *QualityVideoSharing { } type RecordingPermissionObject struct { - Id *string `json:"id,omitempty"` // 授权对象ID + Id *string `json:"id,omitempty"` // 授权对象 ID Type *int `json:"type,omitempty"` // 授权对象类型 Permission *int `json:"permission,omitempty"` // 权限 } type RecordingPermissionObjectBuilder struct { - id string // 授权对象ID + id string // 授权对象 ID idFlag bool type_ int // 授权对象类型 typeFlag bool @@ -3544,7 +3544,7 @@ func NewRecordingPermissionObjectBuilder() *RecordingPermissionObjectBuilder { return builder } -// 授权对象ID +// 授权对象 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *RecordingPermissionObjectBuilder) Id(id string) *RecordingPermissionObjectBuilder { @@ -3590,7 +3590,7 @@ func (builder *RecordingPermissionObjectBuilder) Build() *RecordingPermissionObj type Report struct { TotalMeetingCount *string `json:"total_meeting_count,omitempty"` // 总会议数量 - TotalMeetingDuration *string `json:"total_meeting_duration,omitempty"` // 总会议时长（单位sec） + TotalMeetingDuration *string `json:"total_meeting_duration,omitempty"` // 总会议时长（单位 sec） TotalParticipantCount *string `json:"total_participant_count,omitempty"` // 总参会人数 DailyReport []*ReportMeetingDaily `json:"daily_report,omitempty"` // 每日会议报告列表 } @@ -3598,7 +3598,7 @@ type Report struct { type ReportBuilder struct { totalMeetingCount string // 总会议数量 totalMeetingCountFlag bool - totalMeetingDuration string // 总会议时长（单位sec） + totalMeetingDuration string // 总会议时长（单位 sec） totalMeetingDurationFlag bool totalParticipantCount string // 总参会人数 totalParticipantCountFlag bool @@ -3620,7 +3620,7 @@ func (builder *ReportBuilder) TotalMeetingCount(totalMeetingCount string) *Repor return builder } -// 总会议时长（单位sec） +// 总会议时长（单位 sec） // // 示例值：300000 func (builder *ReportBuilder) TotalMeetingDuration(totalMeetingDuration string) *ReportBuilder { @@ -3668,18 +3668,18 @@ func (builder *ReportBuilder) Build() *Report { } type ReportMeetingDaily struct { - Date *string `json:"date,omitempty"` // 日期（unix时间，单位sec） + Date *string `json:"date,omitempty"` // 日期（unix 时间，单位 sec） MeetingCount *string `json:"meeting_count,omitempty"` // 会议数量 - MeetingDuration *string `json:"meeting_duration,omitempty"` // 会议时长（单位sec） + MeetingDuration *string `json:"meeting_duration,omitempty"` // 会议时长（单位 sec） ParticipantCount *string `json:"participant_count,omitempty"` // 参会人数 } type ReportMeetingDailyBuilder struct { - date string // 日期（unix时间，单位sec） + date string // 日期（unix 时间，单位 sec） dateFlag bool meetingCount string // 会议数量 meetingCountFlag bool - meetingDuration string // 会议时长（单位sec） + meetingDuration string // 会议时长（单位 sec） meetingDurationFlag bool participantCount string // 参会人数 participantCountFlag bool @@ -3690,7 +3690,7 @@ func NewReportMeetingDailyBuilder() *ReportMeetingDailyBuilder { return builder } -// 日期（unix时间，单位sec） +// 日期（unix 时间，单位 sec） // // 示例值：1609113600 func (builder *ReportMeetingDailyBuilder) Date(date string) *ReportMeetingDailyBuilder { @@ -3708,7 +3708,7 @@ func (builder *ReportMeetingDailyBuilder) MeetingCount(meetingCount string) *Rep return builder } -// 会议时长（单位sec） +// 会议时长（单位 sec） // // 示例值：147680 func (builder *ReportMeetingDailyBuilder) MeetingDuration(meetingDuration string) *ReportMeetingDailyBuilder { @@ -3748,15 +3748,15 @@ func (builder *ReportMeetingDailyBuilder) Build() *ReportMeetingDaily { } type ReportTopUser struct { - Id *string `json:"id,omitempty"` // 用户ID + Id *string `json:"id,omitempty"` // 用户 ID Name *string `json:"name,omitempty"` // 用户名 UserType *int `json:"user_type,omitempty"` // 用户类型 MeetingCount *string `json:"meeting_count,omitempty"` // 会议数量 - MeetingDuration *string `json:"meeting_duration,omitempty"` // 会议时长（单位min） + MeetingDuration *string `json:"meeting_duration,omitempty"` // 会议时长（单位 min） } type ReportTopUserBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool name string // 用户名 nameFlag bool @@ -3764,7 +3764,7 @@ type ReportTopUserBuilder struct { userTypeFlag bool meetingCount string // 会议数量 meetingCountFlag bool - meetingDuration string // 会议时长（单位min） + meetingDuration string // 会议时长（单位 min） meetingDurationFlag bool } @@ -3773,7 +3773,7 @@ func NewReportTopUserBuilder() *ReportTopUserBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ReportTopUserBuilder) Id(id string) *ReportTopUserBuilder { @@ -3809,7 +3809,7 @@ func (builder *ReportTopUserBuilder) MeetingCount(meetingCount string) *ReportTo return builder } -// 会议时长（单位min） +// 会议时长（单位 min） // // 示例值：3000 func (builder *ReportTopUserBuilder) MeetingDuration(meetingDuration string) *ReportTopUserBuilder { @@ -3844,33 +3844,33 @@ func (builder *ReportTopUserBuilder) Build() *ReportTopUser { } type Reserve struct { - Id *string `json:"id,omitempty"` // 预约ID（预约的唯一标识） - MeetingNo *string `json:"meeting_no,omitempty"` // 9位会议号（飞书用户可通过输入9位会议号快捷入会） + Id *string `json:"id,omitempty"` // 预约 ID（预约的唯一标识） + MeetingNo *string `json:"meeting_no,omitempty"` // 9 位会议号（飞书用户可通过输入 9 位会议号快捷入会） Url *string `json:"url,omitempty"` // 会议链接（飞书用户可通过点击会议链接快捷入会） - AppLink *string `json:"app_link,omitempty"` // APPLink用于唤起飞书APP入会。"{?}"为占位符，用于配置入会参数，使用时需替换具体值：0表示关闭，1表示打开。preview为入会前的设置页，mic为麦克风，speaker为扬声器，camera为摄像头 + AppLink *string `json:"app_link,omitempty"` // APPLink 用于唤起飞书 APP 入会。"{?}"为占位符，用于配置入会参数，使用时需替换具体值：0 表示关闭，1 表示打开。preview 为入会前的设置页，mic 为麦克风，speaker 为扬声器，camera 为摄像头 LiveLink *string `json:"live_link,omitempty"` // 会议转直播链接 - EndTime *string `json:"end_time,omitempty"` // 预约到期时间（unix时间，单位sec） + EndTime *string `json:"end_time,omitempty"` // 预约到期时间（unix 时间，单位 sec） ExpireStatus *int `json:"expire_status,omitempty"` // 过期状态 - ReserveUserId *string `json:"reserve_user_id,omitempty"` // 预约人ID + ReserveUserId *string `json:"reserve_user_id,omitempty"` // 预约人 ID MeetingSettings *ReserveMeetingSetting `json:"meeting_settings,omitempty"` // 会议设置 } type ReserveBuilder struct { - id string // 预约ID（预约的唯一标识） + id string // 预约 ID（预约的唯一标识） idFlag bool - meetingNo string // 9位会议号（飞书用户可通过输入9位会议号快捷入会） + meetingNo string // 9 位会议号（飞书用户可通过输入 9 位会议号快捷入会） meetingNoFlag bool url string // 会议链接（飞书用户可通过点击会议链接快捷入会） urlFlag bool - appLink string // APPLink用于唤起飞书APP入会。"{?}"为占位符，用于配置入会参数，使用时需替换具体值：0表示关闭，1表示打开。preview为入会前的设置页，mic为麦克风，speaker为扬声器，camera为摄像头 + appLink string // APPLink 用于唤起飞书 APP 入会。"{?}"为占位符，用于配置入会参数，使用时需替换具体值：0 表示关闭，1 表示打开。preview 为入会前的设置页，mic 为麦克风，speaker 为扬声器，camera 为摄像头 appLinkFlag bool liveLink string // 会议转直播链接 liveLinkFlag bool - endTime string // 预约到期时间（unix时间，单位sec） + endTime string // 预约到期时间（unix 时间，单位 sec） endTimeFlag bool expireStatus int // 过期状态 expireStatusFlag bool - reserveUserId string // 预约人ID + reserveUserId string // 预约人 ID reserveUserIdFlag bool meetingSettings *ReserveMeetingSetting // 会议设置 meetingSettingsFlag bool @@ -3881,7 +3881,7 @@ func NewReserveBuilder() *ReserveBuilder { return builder } -// 预约ID（预约的唯一标识） +// 预约 ID（预约的唯一标识） // // 示例值：6911188411934973028 func (builder *ReserveBuilder) Id(id string) *ReserveBuilder { @@ -3890,7 +3890,7 @@ func (builder *ReserveBuilder) Id(id string) *ReserveBuilder { return builder } -// 9位会议号（飞书用户可通过输入9位会议号快捷入会） +// 9 位会议号（飞书用户可通过输入 9 位会议号快捷入会） // // 示例值：112000358 func (builder *ReserveBuilder) MeetingNo(meetingNo string) *ReserveBuilder { @@ -3908,7 +3908,7 @@ func (builder *ReserveBuilder) Url(url string) *ReserveBuilder { return builder } -// APPLink用于唤起飞书APP入会。"{?}"为占位符，用于配置入会参数，使用时需替换具体值：0表示关闭，1表示打开。preview为入会前的设置页，mic为麦克风，speaker为扬声器，camera为摄像头 +// APPLink 用于唤起飞书 APP 入会。"{?}"为占位符，用于配置入会参数，使用时需替换具体值：0 表示关闭，1 表示打开。preview 为入会前的设置页，mic 为麦克风，speaker 为扬声器，camera 为摄像头 // // 示例值：https://applink.feishu.cn/client/videochat/open?source=openplatform&action=join&idtype=reservationid&id={?}&preview={?}&mic={?}&speaker={?}&camera={?} func (builder *ReserveBuilder) AppLink(appLink string) *ReserveBuilder { @@ -3926,7 +3926,7 @@ func (builder *ReserveBuilder) LiveLink(liveLink string) *ReserveBuilder { return builder } -// 预约到期时间（unix时间，单位sec） +// 预约到期时间（unix 时间，单位 sec） // // 示例值：1608883322 func (builder *ReserveBuilder) EndTime(endTime string) *ReserveBuilder { @@ -3944,7 +3944,7 @@ func (builder *ReserveBuilder) ExpireStatus(expireStatus int) *ReserveBuilder { return builder } -// 预约人ID +// 预约人 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ReserveBuilder) ReserveUserId(reserveUserId string) *ReserveBuilder { @@ -4004,13 +4004,13 @@ func (builder *ReserveBuilder) Build() *Reserve { type ReserveActionPermission struct { Permission *int `json:"permission,omitempty"` // 权限项 - PermissionCheckers []*ReservePermissionChecker `json:"permission_checkers,omitempty"` // 权限检查器列表，权限检查器之间为"逻辑或"的关系（即 有一个为true则拥有该权限） + PermissionCheckers []*ReservePermissionChecker `json:"permission_checkers,omitempty"` // 权限检查器列表，权限检查器之间为"逻辑或"的关系（即 有一个为 true 则拥有该权限） } type ReserveActionPermissionBuilder struct { permission int // 权限项 permissionFlag bool - permissionCheckers []*ReservePermissionChecker // 权限检查器列表，权限检查器之间为"逻辑或"的关系（即 有一个为true则拥有该权限） + permissionCheckers []*ReservePermissionChecker // 权限检查器列表，权限检查器之间为"逻辑或"的关系（即 有一个为 true 则拥有该权限） permissionCheckersFlag bool } @@ -4028,7 +4028,7 @@ func (builder *ReserveActionPermissionBuilder) Permission(permission int) *Reser return builder } -// 权限检查器列表，权限检查器之间为"逻辑或"的关系（即 有一个为true则拥有该权限） +// 权限检查器列表，权限检查器之间为"逻辑或"的关系（即 有一个为 true 则拥有该权限） // // 示例值： func (builder *ReserveActionPermissionBuilder) PermissionCheckers(permissionCheckers []*ReservePermissionChecker) *ReserveActionPermissionBuilder { @@ -4097,13 +4097,13 @@ func (builder *ReserveAdminConfigBuilder) Build() *ReserveAdminConfig { type ReserveAssignHost struct { UserType *int `json:"user_type,omitempty"` // 用户类型，仅支持设置同租户下的 Lark 用户 - Id *string `json:"id,omitempty"` // 用户ID + Id *string `json:"id,omitempty"` // 用户 ID } type ReserveAssignHostBuilder struct { userType int // 用户类型，仅支持设置同租户下的 Lark 用户 userTypeFlag bool - id string // 用户ID + id string // 用户 ID idFlag bool } @@ -4121,7 +4121,7 @@ func (builder *ReserveAssignHostBuilder) UserType(userType int) *ReserveAssignHo return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ReserveAssignHostBuilder) Id(id string) *ReserveAssignHostBuilder { @@ -4175,17 +4175,17 @@ func (builder *ReserveCallSettingBuilder) Build() *ReserveCallSetting { } type ReserveCallee struct { - Id *string `json:"id,omitempty"` // 用户ID - UserType *int `json:"user_type,omitempty"` // 用户类型，当前仅支持用户类型6(pstn用户) - PstnSipInfo *PstnSipInfo `json:"pstn_sip_info,omitempty"` // pstn/sip信息 + Id *string `json:"id,omitempty"` // 用户 ID + UserType *int `json:"user_type,omitempty"` // 用户类型，当前仅支持用户类型 6(pstn 用户) + PstnSipInfo *PstnSipInfo `json:"pstn_sip_info,omitempty"` // pstn/sip 信息 } type ReserveCalleeBuilder struct { - id string // 用户ID + id string // 用户 ID idFlag bool - userType int // 用户类型，当前仅支持用户类型6(pstn用户) + userType int // 用户类型，当前仅支持用户类型 6(pstn 用户) userTypeFlag bool - pstnSipInfo *PstnSipInfo // pstn/sip信息 + pstnSipInfo *PstnSipInfo // pstn/sip 信息 pstnSipInfoFlag bool } @@ -4194,7 +4194,7 @@ func NewReserveCalleeBuilder() *ReserveCalleeBuilder { return builder } -// 用户ID +// 用户 ID // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ReserveCalleeBuilder) Id(id string) *ReserveCalleeBuilder { @@ -4203,7 +4203,7 @@ func (builder *ReserveCalleeBuilder) Id(id string) *ReserveCalleeBuilder { return builder } -// 用户类型，当前仅支持用户类型6(pstn用户) +// 用户类型，当前仅支持用户类型 6(pstn 用户) // // 示例值：1 func (builder *ReserveCalleeBuilder) UserType(userType int) *ReserveCalleeBuilder { @@ -4212,7 +4212,7 @@ func (builder *ReserveCalleeBuilder) UserType(userType int) *ReserveCalleeBuilde return builder } -// pstn/sip信息 +// pstn/sip 信息 // // 示例值： func (builder *ReserveCalleeBuilder) PstnSipInfo(pstnSipInfo *PstnSipInfo) *ReserveCalleeBuilder { @@ -4238,11 +4238,11 @@ func (builder *ReserveCalleeBuilder) Build() *ReserveCallee { } type ReserveCorrectionCheckInfo struct { - InvalidHostIdList []string `json:"invalid_host_id_list,omitempty"` // 指定主持人无效id列表 + InvalidHostIdList []string `json:"invalid_host_id_list,omitempty"` // 指定主持人无效 id 列表 } type ReserveCorrectionCheckInfoBuilder struct { - invalidHostIdList []string // 指定主持人无效id列表 + invalidHostIdList []string // 指定主持人无效 id 列表 invalidHostIdListFlag bool } @@ -4251,7 +4251,7 @@ func NewReserveCorrectionCheckInfoBuilder() *ReserveCorrectionCheckInfoBuilder { return builder } -// 指定主持人无效id列表 +// 指定主持人无效 id 列表 // // 示例值： func (builder *ReserveCorrectionCheckInfoBuilder) InvalidHostIdList(invalidHostIdList []string) *ReserveCorrectionCheckInfoBuilder { @@ -4271,8 +4271,8 @@ func (builder *ReserveCorrectionCheckInfoBuilder) Build() *ReserveCorrectionChec type ReserveFormConfig struct { ReserveForm *bool `json:"reserve_form,omitempty"` // 预定表单开关 NotifiedUsers []*SubscribeUser `json:"notified_users,omitempty"` // 通知人列表 - NotifiedTime *int `json:"notified_time,omitempty"` // 最晚于会议开始前 notified_time收到通知(单位:分/时/天) - TimeUnit *int `json:"time_unit,omitempty"` // 时间单位,1为分钟;2为小时;3为天，默认为天 + NotifiedTime *int `json:"notified_time,omitempty"` // 最晚于会议开始前 notified_time 收到通知 (单位：分/时/天) + TimeUnit *int `json:"time_unit,omitempty"` // 时间单位，1 为分钟;2 为小时;3 为天，默认为天 } @@ -4281,9 +4281,9 @@ type ReserveFormConfigBuilder struct { reserveFormFlag bool notifiedUsers []*SubscribeUser // 通知人列表 notifiedUsersFlag bool - notifiedTime int // 最晚于会议开始前 notified_time收到通知(单位:分/时/天) + notifiedTime int // 最晚于会议开始前 notified_time 收到通知 (单位：分/时/天) notifiedTimeFlag bool - timeUnit int // 时间单位,1为分钟;2为小时;3为天，默认为天 + timeUnit int // 时间单位，1 为分钟;2 为小时;3 为天，默认为天 timeUnitFlag bool } @@ -4310,7 +4310,7 @@ func (builder *ReserveFormConfigBuilder) NotifiedUsers(notifiedUsers []*Subscrib return builder } -// 最晚于会议开始前 notified_time收到通知(单位:分/时/天) +// 最晚于会议开始前 notified_time 收到通知 (单位：分/时/天) // // 示例值：3 func (builder *ReserveFormConfigBuilder) NotifiedTime(notifiedTime int) *ReserveFormConfigBuilder { @@ -4319,7 +4319,7 @@ func (builder *ReserveFormConfigBuilder) NotifiedTime(notifiedTime int) *Reserve return builder } -// 时间单位,1为分钟;2为小时;3为天，默认为天 +// 时间单位，1 为分钟;2 为小时;3 为天，默认为天 // // 示例值：3 func (builder *ReserveFormConfigBuilder) TimeUnit(timeUnit int) *ReserveFormConfigBuilder { @@ -4351,23 +4351,23 @@ func (builder *ReserveFormConfigBuilder) Build() *ReserveFormConfig { type ReserveMeetingSetting struct { Topic *string `json:"topic,omitempty"` // 会议主题 - ActionPermissions []*ReserveActionPermission `json:"action_permissions,omitempty"` // 会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即 有一个为true则拥有该权限） + ActionPermissions []*ReserveActionPermission `json:"action_permissions,omitempty"` // 会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即 有一个为 true 则拥有该权限） MeetingInitialType *int `json:"meeting_initial_type,omitempty"` // 会议初始类型 - CallSetting *ReserveCallSetting `json:"call_setting,omitempty"` // 1v1呼叫相关参数 - AutoRecord *bool `json:"auto_record,omitempty"` // 使用飞书视频会议时，是否开启自动录制，默认false + CallSetting *ReserveCallSetting `json:"call_setting,omitempty"` // 1v1 呼叫相关参数 + AutoRecord *bool `json:"auto_record,omitempty"` // 使用飞书视频会议时，是否开启自动录制，默认 false AssignHostList []*ReserveAssignHost `json:"assign_host_list,omitempty"` // 指定主持人列表 } type ReserveMeetingSettingBuilder struct { topic string // 会议主题 topicFlag bool - actionPermissions []*ReserveActionPermission // 会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即 有一个为true则拥有该权限） + actionPermissions []*ReserveActionPermission // 会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即 有一个为 true 则拥有该权限） actionPermissionsFlag bool meetingInitialType int // 会议初始类型 meetingInitialTypeFlag bool - callSetting *ReserveCallSetting // 1v1呼叫相关参数 + callSetting *ReserveCallSetting // 1v1 呼叫相关参数 callSettingFlag bool - autoRecord bool // 使用飞书视频会议时，是否开启自动录制，默认false + autoRecord bool // 使用飞书视频会议时，是否开启自动录制，默认 false autoRecordFlag bool assignHostList []*ReserveAssignHost // 指定主持人列表 assignHostListFlag bool @@ -4387,7 +4387,7 @@ func (builder *ReserveMeetingSettingBuilder) Topic(topic string) *ReserveMeeting return builder } -// 会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即 有一个为true则拥有该权限） +// 会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即 有一个为 true 则拥有该权限） // // 示例值： func (builder *ReserveMeetingSettingBuilder) ActionPermissions(actionPermissions []*ReserveActionPermission) *ReserveMeetingSettingBuilder { @@ -4405,7 +4405,7 @@ func (builder *ReserveMeetingSettingBuilder) MeetingInitialType(meetingInitialTy return builder } -// 1v1呼叫相关参数 +// 1v1 呼叫相关参数 // // 示例值： func (builder *ReserveMeetingSettingBuilder) CallSetting(callSetting *ReserveCallSetting) *ReserveMeetingSettingBuilder { @@ -4414,7 +4414,7 @@ func (builder *ReserveMeetingSettingBuilder) CallSetting(callSetting *ReserveCal return builder } -// 使用飞书视频会议时，是否开启自动录制，默认false +// 使用飞书视频会议时，是否开启自动录制，默认 false // // 示例值：true func (builder *ReserveMeetingSettingBuilder) AutoRecord(autoRecord bool) *ReserveMeetingSettingBuilder { @@ -4584,13 +4584,13 @@ func (builder *ReserveScopeConfigBuilder) Build() *ReserveScopeConfig { } type ReserveScopeConfigEvent struct { - AllowAllUsers *int `json:"allow_all_users,omitempty"` // 可预定成员范围，0部分成员，1全部成员 + AllowAllUsers *int `json:"allow_all_users,omitempty"` // 可预定成员范围，0 部分成员，1 全部成员 AllowUsers []*SubscribeUserEvent `json:"allow_users,omitempty"` // 可预定成员列表 AllowDepts []*SubscribeDepartment `json:"allow_depts,omitempty"` // 可预定部门列表 } type ReserveScopeConfigEventBuilder struct { - allowAllUsers int // 可预定成员范围，0部分成员，1全部成员 + allowAllUsers int // 可预定成员范围，0 部分成员，1 全部成员 allowAllUsersFlag bool allowUsers []*SubscribeUserEvent // 可预定成员列表 allowUsersFlag bool @@ -4603,7 +4603,7 @@ func NewReserveScopeConfigEventBuilder() *ReserveScopeConfigEventBuilder { return builder } -// 可预定成员范围，0部分成员，1全部成员 +// 可预定成员范围，0 部分成员，1 全部成员 // // 示例值：1 func (builder *ReserveScopeConfigEventBuilder) AllowAllUsers(allowAllUsers int) *ReserveScopeConfigEventBuilder { @@ -4646,20 +4646,20 @@ func (builder *ReserveScopeConfigEventBuilder) Build() *ReserveScopeConfigEvent } type Room struct { - RoomId *string `json:"room_id,omitempty"` // 会议室ID + RoomId *string `json:"room_id,omitempty"` // 会议室 ID Name *string `json:"name,omitempty"` // 会议室名称 Capacity *int `json:"capacity,omitempty"` // 会议室能容纳的人数 Description *string `json:"description,omitempty"` // 会议室的相关描述 - DisplayId *string `json:"display_id,omitempty"` // 会议室的展示ID - CustomRoomId *string `json:"custom_room_id,omitempty"` // 自定义的会议室ID - RoomLevelId *string `json:"room_level_id,omitempty"` // 层级ID + DisplayId *string `json:"display_id,omitempty"` // 会议室的展示 ID + CustomRoomId *string `json:"custom_room_id,omitempty"` // 自定义的会议室 ID + RoomLevelId *string `json:"room_level_id,omitempty"` // 层级 ID Path []string `json:"path,omitempty"` // 层级路径 RoomStatus *RoomStatus `json:"room_status,omitempty"` // 会议室状态 Device []*Device `json:"device,omitempty"` // 设施信息列表 } type RoomBuilder struct { - roomId string // 会议室ID + roomId string // 会议室 ID roomIdFlag bool name string // 会议室名称 nameFlag bool @@ -4667,11 +4667,11 @@ type RoomBuilder struct { capacityFlag bool description string // 会议室的相关描述 descriptionFlag bool - displayId string // 会议室的展示ID + displayId string // 会议室的展示 ID displayIdFlag bool - customRoomId string // 自定义的会议室ID + customRoomId string // 自定义的会议室 ID customRoomIdFlag bool - roomLevelId string // 层级ID + roomLevelId string // 层级 ID roomLevelIdFlag bool path []string // 层级路径 pathFlag bool @@ -4686,7 +4686,7 @@ func NewRoomBuilder() *RoomBuilder { return builder } -// 会议室ID +// 会议室 ID // // 示例值：omm_4de32cf10a4358788ff4e09e37ebbf9b func (builder *RoomBuilder) RoomId(roomId string) *RoomBuilder { @@ -4722,7 +4722,7 @@ func (builder *RoomBuilder) Description(description string) *RoomBuilder { return builder } -// 会议室的展示ID +// 会议室的展示 ID // // 示例值：LM134742334 func (builder *RoomBuilder) DisplayId(displayId string) *RoomBuilder { @@ -4731,7 +4731,7 @@ func (builder *RoomBuilder) DisplayId(displayId string) *RoomBuilder { return builder } -// 自定义的会议室ID +// 自定义的会议室 ID // // 示例值：1234 func (builder *RoomBuilder) CustomRoomId(customRoomId string) *RoomBuilder { @@ -4740,7 +4740,7 @@ func (builder *RoomBuilder) CustomRoomId(customRoomId string) *RoomBuilder { return builder } -// 层级ID +// 层级 ID // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *RoomBuilder) RoomLevelId(roomLevelId string) *RoomBuilder { @@ -4914,8 +4914,8 @@ func (builder *RoomConfigBuilder) Build() *RoomConfig { type RoomDigitalSignage struct { Enable *bool `json:"enable,omitempty"` // 是否开启数字标牌功能 Mute *bool `json:"mute,omitempty"` // 是否静音播放 - StartDisplay *int `json:"start_display,omitempty"` // 在会议结束n分钟后开始播放，取值1~720（仅对飞书会议室数字标牌生效） - StopDisplay *int `json:"stop_display,omitempty"` // 在日程会议开始前n分钟停止播放，取值1~720（仅对飞书会议室数字标牌生效） + StartDisplay *int `json:"start_display,omitempty"` // 在会议结束 n 分钟后开始播放，取值 1~720（仅对飞书会议室数字标牌生效） + StopDisplay *int `json:"stop_display,omitempty"` // 在日程会议开始前 n 分钟停止播放，取值 1~720（仅对飞书会议室数字标牌生效） Materials []*RoomDigitalSignageMaterial `json:"materials,omitempty"` // 素材列表 } @@ -4924,9 +4924,9 @@ type RoomDigitalSignageBuilder struct { enableFlag bool mute bool // 是否静音播放 muteFlag bool - startDisplay int // 在会议结束n分钟后开始播放，取值1~720（仅对飞书会议室数字标牌生效） + startDisplay int // 在会议结束 n 分钟后开始播放，取值 1~720（仅对飞书会议室数字标牌生效） startDisplayFlag bool - stopDisplay int // 在日程会议开始前n分钟停止播放，取值1~720（仅对飞书会议室数字标牌生效） + stopDisplay int // 在日程会议开始前 n 分钟停止播放，取值 1~720（仅对飞书会议室数字标牌生效） stopDisplayFlag bool materials []*RoomDigitalSignageMaterial // 素材列表 materialsFlag bool @@ -4955,7 +4955,7 @@ func (builder *RoomDigitalSignageBuilder) Mute(mute bool) *RoomDigitalSignageBui return builder } -// 在会议结束n分钟后开始播放，取值1~720（仅对飞书会议室数字标牌生效） +// 在会议结束 n 分钟后开始播放，取值 1~720（仅对飞书会议室数字标牌生效） // // 示例值：3 func (builder *RoomDigitalSignageBuilder) StartDisplay(startDisplay int) *RoomDigitalSignageBuilder { @@ -4964,7 +4964,7 @@ func (builder *RoomDigitalSignageBuilder) StartDisplay(startDisplay int) *RoomDi return builder } -// 在日程会议开始前n分钟停止播放，取值1~720（仅对飞书会议室数字标牌生效） +// 在日程会议开始前 n 分钟停止播放，取值 1~720（仅对飞书会议室数字标牌生效） // // 示例值：3 func (builder *RoomDigitalSignageBuilder) StopDisplay(stopDisplay int) *RoomDigitalSignageBuilder { @@ -5007,35 +5007,35 @@ func (builder *RoomDigitalSignageBuilder) Build() *RoomDigitalSignage { } type RoomDigitalSignageMaterial struct { - Id *string `json:"id,omitempty"` // 素材ID，当设置新素材时，无需传递该字段 + Id *string `json:"id,omitempty"` // 素材 ID，当设置新素材时，无需传递该字段 Name *string `json:"name,omitempty"` // 素材名称 MaterialType *int `json:"material_type,omitempty"` // 素材类型 - Url *string `json:"url,omitempty"` // 素材url - Duration *int `json:"duration,omitempty"` // 播放时长（单位sec），取值1~43200 - Cover *string `json:"cover,omitempty"` // 素材封面url - Md5 *string `json:"md5,omitempty"` // 素材文件md5 - Vid *string `json:"vid,omitempty"` // 素材文件vid - Size *string `json:"size,omitempty"` // 素材文件大小（单位byte） + Url *string `json:"url,omitempty"` // 素材 url + Duration *int `json:"duration,omitempty"` // 播放时长（单位 sec），取值 1~43200 + Cover *string `json:"cover,omitempty"` // 素材封面 url + Md5 *string `json:"md5,omitempty"` // 素材文件 md5 + Vid *string `json:"vid,omitempty"` // 素材文件 vid + Size *string `json:"size,omitempty"` // 素材文件大小（单位 byte） } type RoomDigitalSignageMaterialBuilder struct { - id string // 素材ID，当设置新素材时，无需传递该字段 + id string // 素材 ID，当设置新素材时，无需传递该字段 idFlag bool name string // 素材名称 nameFlag bool materialType int // 素材类型 materialTypeFlag bool - url string // 素材url + url string // 素材 url urlFlag bool - duration int // 播放时长（单位sec），取值1~43200 + duration int // 播放时长（单位 sec），取值 1~43200 durationFlag bool - cover string // 素材封面url + cover string // 素材封面 url coverFlag bool - md5 string // 素材文件md5 + md5 string // 素材文件 md5 md5Flag bool - vid string // 素材文件vid + vid string // 素材文件 vid vidFlag bool - size string // 素材文件大小（单位byte） + size string // 素材文件大小（单位 byte） sizeFlag bool } @@ -5044,7 +5044,7 @@ func NewRoomDigitalSignageMaterialBuilder() *RoomDigitalSignageMaterialBuilder { return builder } -// 素材ID，当设置新素材时，无需传递该字段 +// 素材 ID，当设置新素材时，无需传递该字段 // // 示例值：7847784676276 func (builder *RoomDigitalSignageMaterialBuilder) Id(id string) *RoomDigitalSignageMaterialBuilder { @@ -5071,7 +5071,7 @@ func (builder *RoomDigitalSignageMaterialBuilder) MaterialType(materialType int) return builder } -// 素材url +// 素材 url // // 示例值：url func (builder *RoomDigitalSignageMaterialBuilder) Url(url string) *RoomDigitalSignageMaterialBuilder { @@ -5080,7 +5080,7 @@ func (builder *RoomDigitalSignageMaterialBuilder) Url(url string) *RoomDigitalSi return builder } -// 播放时长（单位sec），取值1~43200 +// 播放时长（单位 sec），取值 1~43200 // // 示例值：15 func (builder *RoomDigitalSignageMaterialBuilder) Duration(duration int) *RoomDigitalSignageMaterialBuilder { @@ -5089,7 +5089,7 @@ func (builder *RoomDigitalSignageMaterialBuilder) Duration(duration int) *RoomDi return builder } -// 素材封面url +// 素材封面 url // // 示例值：url func (builder *RoomDigitalSignageMaterialBuilder) Cover(cover string) *RoomDigitalSignageMaterialBuilder { @@ -5098,7 +5098,7 @@ func (builder *RoomDigitalSignageMaterialBuilder) Cover(cover string) *RoomDigit return builder } -// 素材文件md5 +// 素材文件 md5 // // 示例值：md5 func (builder *RoomDigitalSignageMaterialBuilder) Md5(md5 string) *RoomDigitalSignageMaterialBuilder { @@ -5107,7 +5107,7 @@ func (builder *RoomDigitalSignageMaterialBuilder) Md5(md5 string) *RoomDigitalSi return builder } -// 素材文件vid +// 素材文件 vid // // 示例值：vid func (builder *RoomDigitalSignageMaterialBuilder) Vid(vid string) *RoomDigitalSignageMaterialBuilder { @@ -5116,7 +5116,7 @@ func (builder *RoomDigitalSignageMaterialBuilder) Vid(vid string) *RoomDigitalSi return builder } -// 素材文件大小（单位byte） +// 素材文件大小（单位 byte） // // 示例值：100 func (builder *RoomDigitalSignageMaterialBuilder) Size(size string) *RoomDigitalSignageMaterialBuilder { @@ -5167,20 +5167,20 @@ func (builder *RoomDigitalSignageMaterialBuilder) Build() *RoomDigitalSignageMat } type RoomEvent struct { - RoomId *string `json:"room_id,omitempty"` // 会议室ID + RoomId *string `json:"room_id,omitempty"` // 会议室 ID Name *string `json:"name,omitempty"` // 会议室名称 Capacity *int `json:"capacity,omitempty"` // 会议室能容纳的人数 Description *string `json:"description,omitempty"` // 会议室的相关描述 - DisplayId *string `json:"display_id,omitempty"` // 会议室的展示ID - CustomRoomId *string `json:"custom_room_id,omitempty"` // 自定义的会议室ID - RoomLevelId *string `json:"room_level_id,omitempty"` // 层级ID + DisplayId *string `json:"display_id,omitempty"` // 会议室的展示 ID + CustomRoomId *string `json:"custom_room_id,omitempty"` // 自定义的会议室 ID + RoomLevelId *string `json:"room_level_id,omitempty"` // 层级 ID Path []string `json:"path,omitempty"` // 层级路径 RoomStatus *RoomStatusEvent `json:"room_status,omitempty"` // 会议室状态 Device []*Device `json:"device,omitempty"` // 设施信息列表 } type RoomEventBuilder struct { - roomId string // 会议室ID + roomId string // 会议室 ID roomIdFlag bool name string // 会议室名称 nameFlag bool @@ -5188,11 +5188,11 @@ type RoomEventBuilder struct { capacityFlag bool description string // 会议室的相关描述 descriptionFlag bool - displayId string // 会议室的展示ID + displayId string // 会议室的展示 ID displayIdFlag bool - customRoomId string // 自定义的会议室ID + customRoomId string // 自定义的会议室 ID customRoomIdFlag bool - roomLevelId string // 层级ID + roomLevelId string // 层级 ID roomLevelIdFlag bool path []string // 层级路径 pathFlag bool @@ -5207,7 +5207,7 @@ func NewRoomEventBuilder() *RoomEventBuilder { return builder } -// 会议室ID +// 会议室 ID // // 示例值：omm_4de32cf10a4358788ff4e09e37ebbf9b func (builder *RoomEventBuilder) RoomId(roomId string) *RoomEventBuilder { @@ -5243,7 +5243,7 @@ func (builder *RoomEventBuilder) Description(description string) *RoomEventBuild return builder } -// 会议室的展示ID +// 会议室的展示 ID // // 示例值：LM134742334 func (builder *RoomEventBuilder) DisplayId(displayId string) *RoomEventBuilder { @@ -5252,7 +5252,7 @@ func (builder *RoomEventBuilder) DisplayId(displayId string) *RoomEventBuilder { return builder } -// 自定义的会议室ID +// 自定义的会议室 ID // // 示例值：1234 func (builder *RoomEventBuilder) CustomRoomId(customRoomId string) *RoomEventBuilder { @@ -5261,7 +5261,7 @@ func (builder *RoomEventBuilder) CustomRoomId(customRoomId string) *RoomEventBui return builder } -// 层级ID +// 层级 ID // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *RoomEventBuilder) RoomLevelId(roomLevelId string) *RoomEventBuilder { @@ -5340,26 +5340,26 @@ func (builder *RoomEventBuilder) Build() *RoomEvent { } type RoomLevel struct { - RoomLevelId *string `json:"room_level_id,omitempty"` // 层级ID + RoomLevelId *string `json:"room_level_id,omitempty"` // 层级 ID Name *string `json:"name,omitempty"` // 层级名称 - ParentId *string `json:"parent_id,omitempty"` // 父层级ID + ParentId *string `json:"parent_id,omitempty"` // 父层级 ID Path []string `json:"path,omitempty"` // 层级路径 HasChild *bool `json:"has_child,omitempty"` // 是否有子层级 - CustomGroupId *string `json:"custom_group_id,omitempty"` // 自定义层级ID + CustomGroupId *string `json:"custom_group_id,omitempty"` // 自定义层级 ID } type RoomLevelBuilder struct { - roomLevelId string // 层级ID + roomLevelId string // 层级 ID roomLevelIdFlag bool name string // 层级名称 nameFlag bool - parentId string // 父层级ID + parentId string // 父层级 ID parentIdFlag bool path []string // 层级路径 pathFlag bool hasChild bool // 是否有子层级 hasChildFlag bool - customGroupId string // 自定义层级ID + customGroupId string // 自定义层级 ID customGroupIdFlag bool } @@ -5368,9 +5368,9 @@ func NewRoomLevelBuilder() *RoomLevelBuilder { return builder } -// 层级ID +// 层级 ID // -// 示例值：层级ID +// 示例值：层级 ID func (builder *RoomLevelBuilder) RoomLevelId(roomLevelId string) *RoomLevelBuilder { builder.roomLevelId = roomLevelId builder.roomLevelIdFlag = true @@ -5386,7 +5386,7 @@ func (builder *RoomLevelBuilder) Name(name string) *RoomLevelBuilder { return builder } -// 父层级ID +// 父层级 ID // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *RoomLevelBuilder) ParentId(parentId string) *RoomLevelBuilder { @@ -5413,7 +5413,7 @@ func (builder *RoomLevelBuilder) HasChild(hasChild bool) *RoomLevelBuilder { return builder } -// 自定义层级ID +// 自定义层级 ID // // 示例值：10000 func (builder *RoomLevelBuilder) CustomGroupId(customGroupId string) *RoomLevelBuilder { @@ -5725,10 +5725,10 @@ func (builder *RoomMeetingReservationBuilder) Build() *RoomMeetingReservation { type RoomStatus struct { Status *bool `json:"status,omitempty"` // 是否启用会议室 ScheduleStatus *bool `json:"schedule_status,omitempty"` // 会议室未来状态为启用或禁用 - DisableStartTime *string `json:"disable_start_time,omitempty"` // 禁用开始时间（unix时间，单位sec） - DisableEndTime *string `json:"disable_end_time,omitempty"` // 禁用结束时间（unix时间，单位sec，数值0表示永久禁用） + DisableStartTime *string `json:"disable_start_time,omitempty"` // 禁用开始时间（unix 时间，单位 sec） + DisableEndTime *string `json:"disable_end_time,omitempty"` // 禁用结束时间（unix 时间，单位 sec，数值 0 表示永久禁用） DisableReason *string `json:"disable_reason,omitempty"` // 禁用原因 - ContactIds []string `json:"contact_ids,omitempty"` // 联系人列表，id类型由user_id_type参数决定 + ContactIds []string `json:"contact_ids,omitempty"` // 联系人列表，id 类型由 user_id_type 参数决定 DisableNotice *bool `json:"disable_notice,omitempty"` // 是否在禁用时发送通知给预定了该会议室的员工 ResumeNotice *bool `json:"resume_notice,omitempty"` // 是否在恢复启用时发送通知给联系人 } @@ -5738,13 +5738,13 @@ type RoomStatusBuilder struct { statusFlag bool scheduleStatus bool // 会议室未来状态为启用或禁用 scheduleStatusFlag bool - disableStartTime string // 禁用开始时间（unix时间，单位sec） + disableStartTime string // 禁用开始时间（unix 时间，单位 sec） disableStartTimeFlag bool - disableEndTime string // 禁用结束时间（unix时间，单位sec，数值0表示永久禁用） + disableEndTime string // 禁用结束时间（unix 时间，单位 sec，数值 0 表示永久禁用） disableEndTimeFlag bool disableReason string // 禁用原因 disableReasonFlag bool - contactIds []string // 联系人列表，id类型由user_id_type参数决定 + contactIds []string // 联系人列表，id 类型由 user_id_type 参数决定 contactIdsFlag bool disableNotice bool // 是否在禁用时发送通知给预定了该会议室的员工 disableNoticeFlag bool @@ -5775,7 +5775,7 @@ func (builder *RoomStatusBuilder) ScheduleStatus(scheduleStatus bool) *RoomStatu return builder } -// 禁用开始时间（unix时间，单位sec） +// 禁用开始时间（unix 时间，单位 sec） // // 示例值：1652356050 func (builder *RoomStatusBuilder) DisableStartTime(disableStartTime string) *RoomStatusBuilder { @@ -5784,7 +5784,7 @@ func (builder *RoomStatusBuilder) DisableStartTime(disableStartTime string) *Roo return builder } -// 禁用结束时间（unix时间，单位sec，数值0表示永久禁用） +// 禁用结束时间（unix 时间，单位 sec，数值 0 表示永久禁用） // // 示例值：1652442450 func (builder *RoomStatusBuilder) DisableEndTime(disableEndTime string) *RoomStatusBuilder { @@ -5802,7 +5802,7 @@ func (builder *RoomStatusBuilder) DisableReason(disableReason string) *RoomStatu return builder } -// 联系人列表，id类型由user_id_type参数决定 +// 联系人列表，id 类型由 user_id_type 参数决定 // // 示例值：["ou_3ec3f6a28a0d08c45d895276e8e5e19b"] func (builder *RoomStatusBuilder) ContactIds(contactIds []string) *RoomStatusBuilder { @@ -5868,8 +5868,8 @@ func (builder *RoomStatusBuilder) Build() *RoomStatus { type RoomStatusEvent struct { Status *bool `json:"status,omitempty"` // 是否启用会议室 ScheduleStatus *bool `json:"schedule_status,omitempty"` // 会议室未来状态为启用或禁用 - DisableStartTime *string `json:"disable_start_time,omitempty"` // 禁用开始时间（unix时间，单位sec） - DisableEndTime *string `json:"disable_end_time,omitempty"` // 禁用结束时间（unix时间，单位sec，数值0表示永久禁用） + DisableStartTime *string `json:"disable_start_time,omitempty"` // 禁用开始时间（unix 时间，单位 sec） + DisableEndTime *string `json:"disable_end_time,omitempty"` // 禁用结束时间（unix 时间，单位 sec，数值 0 表示永久禁用） DisableReason *string `json:"disable_reason,omitempty"` // 禁用原因 ContactIds []*UserId `json:"contact_ids,omitempty"` // 联系人列表 DisableNotice *bool `json:"disable_notice,omitempty"` // 是否在禁用时发送通知给预定了该会议室的员工 @@ -5881,9 +5881,9 @@ type RoomStatusEventBuilder struct { statusFlag bool scheduleStatus bool // 会议室未来状态为启用或禁用 scheduleStatusFlag bool - disableStartTime string // 禁用开始时间（unix时间，单位sec） + disableStartTime string // 禁用开始时间（unix 时间，单位 sec） disableStartTimeFlag bool - disableEndTime string // 禁用结束时间（unix时间，单位sec，数值0表示永久禁用） + disableEndTime string // 禁用结束时间（unix 时间，单位 sec，数值 0 表示永久禁用） disableEndTimeFlag bool disableReason string // 禁用原因 disableReasonFlag bool @@ -5918,7 +5918,7 @@ func (builder *RoomStatusEventBuilder) ScheduleStatus(scheduleStatus bool) *Room return builder } -// 禁用开始时间（unix时间，单位sec） +// 禁用开始时间（unix 时间，单位 sec） // // 示例值：1652356050 func (builder *RoomStatusEventBuilder) DisableStartTime(disableStartTime string) *RoomStatusEventBuilder { @@ -5927,7 +5927,7 @@ func (builder *RoomStatusEventBuilder) DisableStartTime(disableStartTime string) return builder } -// 禁用结束时间（unix时间，单位sec，数值0表示永久禁用） +// 禁用结束时间（unix 时间，单位 sec，数值 0 表示永久禁用） // // 示例值：1652442450 func (builder *RoomStatusEventBuilder) DisableEndTime(disableEndTime string) *RoomStatusEventBuilder { @@ -6010,14 +6010,14 @@ func (builder *RoomStatusEventBuilder) Build() *RoomStatusEvent { type ScopeConfig struct { ScopeType *int `json:"scope_type,omitempty"` // 查询节点范围 - ScopeId *string `json:"scope_id,omitempty"` // 查询节点ID：如果scope_type为1，则为层级ID，如果scope_type为2，则为会议室ID + ScopeId *string `json:"scope_id,omitempty"` // 查询节点 ID：如果 scope_type 为 1，则为层级 ID，如果 scope_type 为 2，则为会议室 ID ScopeConfig *RoomConfig `json:"scope_config,omitempty"` // 节点配置 } type ScopeConfigBuilder struct { scopeType int // 查询节点范围 scopeTypeFlag bool - scopeId string // 查询节点ID：如果scope_type为1，则为层级ID，如果scope_type为2，则为会议室ID + scopeId string // 查询节点 ID：如果 scope_type 为 1，则为层级 ID，如果 scope_type 为 2，则为会议室 ID scopeIdFlag bool scopeConfig *RoomConfig // 节点配置 scopeConfigFlag bool @@ -6037,7 +6037,7 @@ func (builder *ScopeConfigBuilder) ScopeType(scopeType int) *ScopeConfigBuilder return builder } -// 查询节点ID：如果scope_type为1，则为层级ID，如果scope_type为2，则为会议室ID +// 查询节点 ID：如果 scope_type 为 1，则为层级 ID，如果 scope_type 为 2，则为会议室 ID // // 示例值：omm_608d34d82d531b27fa993902d350a307 func (builder *ScopeConfigBuilder) ScopeId(scopeId string) *ScopeConfigBuilder { @@ -6072,12 +6072,12 @@ func (builder *ScopeConfigBuilder) Build() *ScopeConfig { } type SubscribeDepartment struct { - DepartmentId *string `json:"department_id,omitempty"` // 可预定部门id + DepartmentId *string `json:"department_id,omitempty"` // 可预定部门 id DepartmentName *string `json:"department_name,omitempty"` // 预定部门名称 } type SubscribeDepartmentBuilder struct { - departmentId string // 可预定部门id + departmentId string // 可预定部门 id departmentIdFlag bool departmentName string // 预定部门名称 departmentNameFlag bool @@ -6088,7 +6088,7 @@ func NewSubscribeDepartmentBuilder() *SubscribeDepartmentBuilder { return builder } -// 可预定部门id +// 可预定部门 id // // 示例值：od-47d8b570b0a011e9679a755efcc5f61a func (builder *SubscribeDepartmentBuilder) DepartmentId(departmentId string) *SubscribeDepartmentBuilder { @@ -6120,12 +6120,12 @@ func (builder *SubscribeDepartmentBuilder) Build() *SubscribeDepartment { } type SubscribeUser struct { - UserId *string `json:"user_id,omitempty"` // 审批人/预定人id + UserId *string `json:"user_id,omitempty"` // 审批人/预定人 id UserName *string `json:"user_name,omitempty"` // 预订人姓名 } type SubscribeUserBuilder struct { - userId string // 审批人/预定人id + userId string // 审批人/预定人 id userIdFlag bool userName string // 预订人姓名 userNameFlag bool @@ -6136,7 +6136,7 @@ func NewSubscribeUserBuilder() *SubscribeUserBuilder { return builder } -// 审批人/预定人id +// 审批人/预定人 id // // 示例值：ou_a27b07a9071d90577c0177bcec98f856 func (builder *SubscribeUserBuilder) UserId(userId string) *SubscribeUserBuilder { @@ -6168,11 +6168,11 @@ func (builder *SubscribeUserBuilder) Build() *SubscribeUser { } type SubscribeUserEvent struct { - UserId *UserId `json:"user_id,omitempty"` // 预定人/审批人id + UserId *UserId `json:"user_id,omitempty"` // 预定人/审批人 id } type SubscribeUserEventBuilder struct { - userId *UserId // 预定人/审批人id + userId *UserId // 预定人/审批人 id userIdFlag bool } @@ -6181,7 +6181,7 @@ func NewSubscribeUserEventBuilder() *SubscribeUserEventBuilder { return builder } -// 预定人/审批人id +// 预定人/审批人 id // // 示例值：ou_e8bce6c3935ef1fc1b432992fd9d3db8 func (builder *SubscribeUserEventBuilder) UserId(userId *UserId) *SubscribeUserEventBuilder { @@ -6200,25 +6200,25 @@ func (builder *SubscribeUserEventBuilder) Build() *SubscribeUserEvent { type TimeConfig struct { TimeSwitch *int `json:"time_switch,omitempty"` // 预定时间开关：0 代表关闭，1 代表开启 - DaysInAdvance *int `json:"days_in_advance,omitempty"` // 最早可提前 ; days_in_advance 预定会议室（单位：天，取值范围[1-730]）;说明：不填写时，默认更新为 365 - OpeningHour *string `json:"opening_hour,omitempty"` // 开放当天可于 ; opening_hour 开始预定（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时默认更新为 ; 28800 ;2. 如果填写的值不是 60 ; 的倍数，则自动会更新为离其最近的 60 整数倍的值。 - StartTime *string `json:"start_time,omitempty"` // 每日可预定时间范围的开始时间（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。;2. 当 start_time 与; end_time 均填写时，; end_time 至少超过 ; start_time 30 。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 - EndTime *string `json:"end_time,omitempty"` // 每日可预定时间范围结束时间（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时，默认更新为 86400 ，此时填写的; start_time 不得大于等于 86370 。;2. 当 start_time 与; end_time 均填写时，; end_time 至少要超过; start_time 30。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 - MaxDuration *int `json:"max_duration,omitempty"` // 单次会议室可预定时长上限（单位：小时，取值范围[1,99]）;说明：不填写时默认更新为 2 + DaysInAdvance *int `json:"days_in_advance,omitempty"` // 最早可提前 ; days_in_advance 预定会议室（单位：天，取值范围 [1-730]）;说明：不填写时，默认更新为 365 + OpeningHour *string `json:"opening_hour,omitempty"` // 开放当天可于 ; opening_hour 开始预定（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时默认更新为 ; 28800 ;2. 如果填写的值不是 60 ; 的倍数，则自动会更新为离其最近的 60 整数倍的值。 + StartTime *string `json:"start_time,omitempty"` // 每日可预定时间范围的开始时间（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。;2. 当 start_time 与; end_time 均填写时，; end_time 至少超过 ; start_time 30 。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 + EndTime *string `json:"end_time,omitempty"` // 每日可预定时间范围结束时间（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时，默认更新为 86400 ，此时填写的; start_time 不得大于等于 86370 。;2. 当 start_time 与; end_time 均填写时，; end_time 至少要超过; start_time 30。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 + MaxDuration *int `json:"max_duration,omitempty"` // 单次会议室可预定时长上限（单位：小时，取值范围 [1,99]）;说明：不填写时默认更新为 2 } type TimeConfigBuilder struct { timeSwitch int // 预定时间开关：0 代表关闭，1 代表开启 timeSwitchFlag bool - daysInAdvance int // 最早可提前 ; days_in_advance 预定会议室（单位：天，取值范围[1-730]）;说明：不填写时，默认更新为 365 + daysInAdvance int // 最早可提前 ; days_in_advance 预定会议室（单位：天，取值范围 [1-730]）;说明：不填写时，默认更新为 365 daysInAdvanceFlag bool - openingHour string // 开放当天可于 ; opening_hour 开始预定（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时默认更新为 ; 28800 ;2. 如果填写的值不是 60 ; 的倍数，则自动会更新为离其最近的 60 整数倍的值。 + openingHour string // 开放当天可于 ; opening_hour 开始预定（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时默认更新为 ; 28800 ;2. 如果填写的值不是 60 ; 的倍数，则自动会更新为离其最近的 60 整数倍的值。 openingHourFlag bool - startTime string // 每日可预定时间范围的开始时间（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。;2. 当 start_time 与; end_time 均填写时，; end_time 至少超过 ; start_time 30 。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 + startTime string // 每日可预定时间范围的开始时间（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。;2. 当 start_time 与; end_time 均填写时，; end_time 至少超过 ; start_time 30 。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 startTimeFlag bool - endTime string // 每日可预定时间范围结束时间（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时，默认更新为 86400 ，此时填写的; start_time 不得大于等于 86370 。;2. 当 start_time 与; end_time 均填写时，; end_time 至少要超过; start_time 30。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 + endTime string // 每日可预定时间范围结束时间（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时，默认更新为 86400 ，此时填写的; start_time 不得大于等于 86370 。;2. 当 start_time 与; end_time 均填写时，; end_time 至少要超过; start_time 30。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 endTimeFlag bool - maxDuration int // 单次会议室可预定时长上限（单位：小时，取值范围[1,99]）;说明：不填写时默认更新为 2 + maxDuration int // 单次会议室可预定时长上限（单位：小时，取值范围 [1,99]）;说明：不填写时默认更新为 2 maxDurationFlag bool } @@ -6236,7 +6236,7 @@ func (builder *TimeConfigBuilder) TimeSwitch(timeSwitch int) *TimeConfigBuilder return builder } -// 最早可提前 ; days_in_advance 预定会议室（单位：天，取值范围[1-730]）;说明：不填写时，默认更新为 365 +// 最早可提前 ; days_in_advance 预定会议室（单位：天，取值范围 [1-730]）;说明：不填写时，默认更新为 365 // // 示例值：30 func (builder *TimeConfigBuilder) DaysInAdvance(daysInAdvance int) *TimeConfigBuilder { @@ -6245,7 +6245,7 @@ func (builder *TimeConfigBuilder) DaysInAdvance(daysInAdvance int) *TimeConfigBu return builder } -// 开放当天可于 ; opening_hour 开始预定（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时默认更新为 ; 28800 ;2. 如果填写的值不是 60 ; 的倍数，则自动会更新为离其最近的 60 整数倍的值。 +// 开放当天可于 ; opening_hour 开始预定（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时默认更新为 ; 28800 ;2. 如果填写的值不是 60 ; 的倍数，则自动会更新为离其最近的 60 整数倍的值。 // // 示例值：27900 func (builder *TimeConfigBuilder) OpeningHour(openingHour string) *TimeConfigBuilder { @@ -6254,7 +6254,7 @@ func (builder *TimeConfigBuilder) OpeningHour(openingHour string) *TimeConfigBui return builder } -// 每日可预定时间范围的开始时间（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。;2. 当 start_time 与; end_time 均填写时，; end_time 至少超过 ; start_time 30 。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 +// 每日可预定时间范围的开始时间（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。;2. 当 start_time 与; end_time 均填写时，; end_time 至少超过 ; start_time 30 。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 // // 示例值：0 func (builder *TimeConfigBuilder) StartTime(startTime string) *TimeConfigBuilder { @@ -6263,7 +6263,7 @@ func (builder *TimeConfigBuilder) StartTime(startTime string) *TimeConfigBuilder return builder } -// 每日可预定时间范围结束时间（单位：秒，取值范围[0,86400]）;说明：;1. 不填写时，默认更新为 86400 ，此时填写的; start_time 不得大于等于 86370 。;2. 当 start_time 与; end_time 均填写时，; end_time 至少要超过; start_time 30。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 +// 每日可预定时间范围结束时间（单位：秒，取值范围 [0,86400]）;说明：;1. 不填写时，默认更新为 86400 ，此时填写的; start_time 不得大于等于 86370 。;2. 当 start_time 与; end_time 均填写时，; end_time 至少要超过; start_time 30。;3. 如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。 // // 示例值：86400 func (builder *TimeConfigBuilder) EndTime(endTime string) *TimeConfigBuilder { @@ -6272,7 +6272,7 @@ func (builder *TimeConfigBuilder) EndTime(endTime string) *TimeConfigBuilder { return builder } -// 单次会议室可预定时长上限（单位：小时，取值范围[1,99]）;说明：不填写时默认更新为 2 +// 单次会议室可预定时长上限（单位：小时，取值范围 [1,99]）;说明：不填写时默认更新为 2 // // 示例值：24 func (builder *TimeConfigBuilder) MaxDuration(maxDuration int) *TimeConfigBuilder { @@ -6387,7 +6387,7 @@ func NewDownloadExportReqBuilder() *DownloadExportReqBuilder { return builder } -// 文档token +// 文档 token // // 示例值：6yHu7Igp7Igy62Ez6fLr6IJz7j9i5WMe6fHq5yZeY2Jz6yLqYAMAY46fZfEz64Lr5fYyYQ== func (builder *DownloadExportReqBuilder) FileToken(fileToken string) *DownloadExportReqBuilder { @@ -6443,7 +6443,7 @@ func NewGetExportReqBuilder() *GetExportReqBuilder { return builder } -// 任务id +// 任务 id // // 示例值：7108646852144136212 func (builder *GetExportReqBuilder) TaskId(taskId string) *GetExportReqBuilder { @@ -6465,7 +6465,7 @@ type GetExportReq struct { type GetExportRespData struct { Status *int `json:"status,omitempty"` // 任务状态 Url *string `json:"url,omitempty"` // 文件下载地址 - FileToken *string `json:"file_token,omitempty"` // 文件token + FileToken *string `json:"file_token,omitempty"` // 文件 token FailMsg *string `json:"fail_msg,omitempty"` // 失败信息 } @@ -6480,15 +6480,15 @@ func (resp *GetExportResp) Success() bool { } type MeetingListExportReqBodyBuilder struct { - startTime string // 查询开始时间（unix时间，单位sec） + startTime string // 查询开始时间（unix 时间，单位 sec） startTimeFlag bool - endTime string // 查询结束时间（unix时间，单位sec） + endTime string // 查询结束时间（unix 时间，单位 sec） endTimeFlag bool - meetingNo string // 按9位会议号筛选（最多一个筛选条件） + meetingNo string // 按 9 位会议号筛选（最多一个筛选条件） meetingNoFlag bool - userId string // 按参会Lark用户筛选（最多一个筛选条件） + userId string // 按参会 Lark 用户筛选（最多一个筛选条件） userIdFlag bool - roomId string // 按参会Rooms筛选（最多一个筛选条件） + roomId string // 按参会 Rooms 筛选（最多一个筛选条件） roomIdFlag bool } @@ -6497,7 +6497,7 @@ func NewMeetingListExportReqBodyBuilder() *MeetingListExportReqBodyBuilder { return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *MeetingListExportReqBodyBuilder) StartTime(startTime string) *MeetingListExportReqBodyBuilder { @@ -6506,7 +6506,7 @@ func (builder *MeetingListExportReqBodyBuilder) StartTime(startTime string) *Mee return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *MeetingListExportReqBodyBuilder) EndTime(endTime string) *MeetingListExportReqBodyBuilder { @@ -6515,7 +6515,7 @@ func (builder *MeetingListExportReqBodyBuilder) EndTime(endTime string) *Meeting return builder } -// 按9位会议号筛选（最多一个筛选条件） +// 按 9 位会议号筛选（最多一个筛选条件） // //示例值：123456789 func (builder *MeetingListExportReqBodyBuilder) MeetingNo(meetingNo string) *MeetingListExportReqBodyBuilder { @@ -6524,7 +6524,7 @@ func (builder *MeetingListExportReqBodyBuilder) MeetingNo(meetingNo string) *Mee return builder } -// 按参会Lark用户筛选（最多一个筛选条件） +// 按参会 Lark 用户筛选（最多一个筛选条件） // //示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *MeetingListExportReqBodyBuilder) UserId(userId string) *MeetingListExportReqBodyBuilder { @@ -6533,7 +6533,7 @@ func (builder *MeetingListExportReqBodyBuilder) UserId(userId string) *MeetingLi return builder } -// 按参会Rooms筛选（最多一个筛选条件） +// 按参会 Rooms 筛选（最多一个筛选条件） // //示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *MeetingListExportReqBodyBuilder) RoomId(roomId string) *MeetingListExportReqBodyBuilder { @@ -6563,15 +6563,15 @@ func (builder *MeetingListExportReqBodyBuilder) Build() *MeetingListExportReqBod } type MeetingListExportPathReqBodyBuilder struct { - startTime string // 查询开始时间（unix时间，单位sec） + startTime string // 查询开始时间（unix 时间，单位 sec） startTimeFlag bool - endTime string // 查询结束时间（unix时间，单位sec） + endTime string // 查询结束时间（unix 时间，单位 sec） endTimeFlag bool - meetingNo string // 按9位会议号筛选（最多一个筛选条件） + meetingNo string // 按 9 位会议号筛选（最多一个筛选条件） meetingNoFlag bool - userId string // 按参会Lark用户筛选（最多一个筛选条件） + userId string // 按参会 Lark 用户筛选（最多一个筛选条件） userIdFlag bool - roomId string // 按参会Rooms筛选（最多一个筛选条件） + roomId string // 按参会 Rooms 筛选（最多一个筛选条件） roomIdFlag bool } @@ -6580,7 +6580,7 @@ func NewMeetingListExportPathReqBodyBuilder() *MeetingListExportPathReqBodyBuild return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *MeetingListExportPathReqBodyBuilder) StartTime(startTime string) *MeetingListExportPathReqBodyBuilder { @@ -6589,7 +6589,7 @@ func (builder *MeetingListExportPathReqBodyBuilder) StartTime(startTime string) return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *MeetingListExportPathReqBodyBuilder) EndTime(endTime string) *MeetingListExportPathReqBodyBuilder { @@ -6598,7 +6598,7 @@ func (builder *MeetingListExportPathReqBodyBuilder) EndTime(endTime string) *Mee return builder } -// 按9位会议号筛选（最多一个筛选条件） +// 按 9 位会议号筛选（最多一个筛选条件） // // 示例值：123456789 func (builder *MeetingListExportPathReqBodyBuilder) MeetingNo(meetingNo string) *MeetingListExportPathReqBodyBuilder { @@ -6607,7 +6607,7 @@ func (builder *MeetingListExportPathReqBodyBuilder) MeetingNo(meetingNo string) return builder } -// 按参会Lark用户筛选（最多一个筛选条件） +// 按参会 Lark 用户筛选（最多一个筛选条件） // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *MeetingListExportPathReqBodyBuilder) UserId(userId string) *MeetingListExportPathReqBodyBuilder { @@ -6616,7 +6616,7 @@ func (builder *MeetingListExportPathReqBodyBuilder) UserId(userId string) *Meeti return builder } -// 按参会Rooms筛选（最多一个筛选条件） +// 按参会 Rooms 筛选（最多一个筛选条件） // // 示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *MeetingListExportPathReqBodyBuilder) RoomId(roomId string) *MeetingListExportPathReqBodyBuilder { @@ -6659,7 +6659,7 @@ func NewMeetingListExportReqBuilder() *MeetingListExportReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *MeetingListExportReqBuilder) UserIdType(userIdType string) *MeetingListExportReqBuilder { @@ -6682,11 +6682,11 @@ func (builder *MeetingListExportReqBuilder) Build() *MeetingListExportReq { } type MeetingListExportReqBody struct { - StartTime *string `json:"start_time,omitempty"` // 查询开始时间（unix时间，单位sec） - EndTime *string `json:"end_time,omitempty"` // 查询结束时间（unix时间，单位sec） - MeetingNo *string `json:"meeting_no,omitempty"` // 按9位会议号筛选（最多一个筛选条件） - UserId *string `json:"user_id,omitempty"` // 按参会Lark用户筛选（最多一个筛选条件） - RoomId *string `json:"room_id,omitempty"` // 按参会Rooms筛选（最多一个筛选条件） + StartTime *string `json:"start_time,omitempty"` // 查询开始时间（unix 时间，单位 sec） + EndTime *string `json:"end_time,omitempty"` // 查询结束时间（unix 时间，单位 sec） + MeetingNo *string `json:"meeting_no,omitempty"` // 按 9 位会议号筛选（最多一个筛选条件） + UserId *string `json:"user_id,omitempty"` // 按参会 Lark 用户筛选（最多一个筛选条件） + RoomId *string `json:"room_id,omitempty"` // 按参会 Rooms 筛选（最多一个筛选条件） } type MeetingListExportReq struct { @@ -6695,7 +6695,7 @@ type MeetingListExportReq struct { } type MeetingListExportRespData struct { - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id } type MeetingListExportResp struct { @@ -6709,15 +6709,15 @@ func (resp *MeetingListExportResp) Success() bool { } type ParticipantListExportReqBodyBuilder struct { - meetingStartTime string // 会议开始时间（unix时间，单位sec） + meetingStartTime string // 会议开始时间（unix 时间，单位 sec） meetingStartTimeFlag bool - meetingEndTime string // 会议结束时间（unix时间，单位sec） + meetingEndTime string // 会议结束时间（unix 时间，单位 sec） meetingEndTimeFlag bool - meetingNo string // 9位会议号 + meetingNo string // 9 位会议号 meetingNoFlag bool - userId string // 按参会Lark用户筛选（最多一个筛选条件） + userId string // 按参会 Lark 用户筛选（最多一个筛选条件） userIdFlag bool - roomId string // 按参会Rooms筛选（最多一个筛选条件） + roomId string // 按参会 Rooms 筛选（最多一个筛选条件） roomIdFlag bool } @@ -6726,7 +6726,7 @@ func NewParticipantListExportReqBodyBuilder() *ParticipantListExportReqBodyBuild return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ParticipantListExportReqBodyBuilder) MeetingStartTime(meetingStartTime string) *ParticipantListExportReqBodyBuilder { @@ -6735,7 +6735,7 @@ func (builder *ParticipantListExportReqBodyBuilder) MeetingStartTime(meetingStar return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ParticipantListExportReqBodyBuilder) MeetingEndTime(meetingEndTime string) *ParticipantListExportReqBodyBuilder { @@ -6744,7 +6744,7 @@ func (builder *ParticipantListExportReqBodyBuilder) MeetingEndTime(meetingEndTim return builder } -// 9位会议号 +// 9 位会议号 // //示例值：123456789 func (builder *ParticipantListExportReqBodyBuilder) MeetingNo(meetingNo string) *ParticipantListExportReqBodyBuilder { @@ -6753,7 +6753,7 @@ func (builder *ParticipantListExportReqBodyBuilder) MeetingNo(meetingNo string) return builder } -// 按参会Lark用户筛选（最多一个筛选条件） +// 按参会 Lark 用户筛选（最多一个筛选条件） // //示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ParticipantListExportReqBodyBuilder) UserId(userId string) *ParticipantListExportReqBodyBuilder { @@ -6762,7 +6762,7 @@ func (builder *ParticipantListExportReqBodyBuilder) UserId(userId string) *Parti return builder } -// 按参会Rooms筛选（最多一个筛选条件） +// 按参会 Rooms 筛选（最多一个筛选条件） // //示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *ParticipantListExportReqBodyBuilder) RoomId(roomId string) *ParticipantListExportReqBodyBuilder { @@ -6792,15 +6792,15 @@ func (builder *ParticipantListExportReqBodyBuilder) Build() *ParticipantListExpo } type ParticipantListExportPathReqBodyBuilder struct { - meetingStartTime string // 会议开始时间（unix时间，单位sec） + meetingStartTime string // 会议开始时间（unix 时间，单位 sec） meetingStartTimeFlag bool - meetingEndTime string // 会议结束时间（unix时间，单位sec） + meetingEndTime string // 会议结束时间（unix 时间，单位 sec） meetingEndTimeFlag bool - meetingNo string // 9位会议号 + meetingNo string // 9 位会议号 meetingNoFlag bool - userId string // 按参会Lark用户筛选（最多一个筛选条件） + userId string // 按参会 Lark 用户筛选（最多一个筛选条件） userIdFlag bool - roomId string // 按参会Rooms筛选（最多一个筛选条件） + roomId string // 按参会 Rooms 筛选（最多一个筛选条件） roomIdFlag bool } @@ -6809,7 +6809,7 @@ func NewParticipantListExportPathReqBodyBuilder() *ParticipantListExportPathReqB return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ParticipantListExportPathReqBodyBuilder) MeetingStartTime(meetingStartTime string) *ParticipantListExportPathReqBodyBuilder { @@ -6818,7 +6818,7 @@ func (builder *ParticipantListExportPathReqBodyBuilder) MeetingStartTime(meeting return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ParticipantListExportPathReqBodyBuilder) MeetingEndTime(meetingEndTime string) *ParticipantListExportPathReqBodyBuilder { @@ -6827,7 +6827,7 @@ func (builder *ParticipantListExportPathReqBodyBuilder) MeetingEndTime(meetingEn return builder } -// 9位会议号 +// 9 位会议号 // // 示例值：123456789 func (builder *ParticipantListExportPathReqBodyBuilder) MeetingNo(meetingNo string) *ParticipantListExportPathReqBodyBuilder { @@ -6836,7 +6836,7 @@ func (builder *ParticipantListExportPathReqBodyBuilder) MeetingNo(meetingNo stri return builder } -// 按参会Lark用户筛选（最多一个筛选条件） +// 按参会 Lark 用户筛选（最多一个筛选条件） // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ParticipantListExportPathReqBodyBuilder) UserId(userId string) *ParticipantListExportPathReqBodyBuilder { @@ -6845,7 +6845,7 @@ func (builder *ParticipantListExportPathReqBodyBuilder) UserId(userId string) *P return builder } -// 按参会Rooms筛选（最多一个筛选条件） +// 按参会 Rooms 筛选（最多一个筛选条件） // // 示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *ParticipantListExportPathReqBodyBuilder) RoomId(roomId string) *ParticipantListExportPathReqBodyBuilder { @@ -6888,7 +6888,7 @@ func NewParticipantListExportReqBuilder() *ParticipantListExportReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *ParticipantListExportReqBuilder) UserIdType(userIdType string) *ParticipantListExportReqBuilder { @@ -6911,11 +6911,11 @@ func (builder *ParticipantListExportReqBuilder) Build() *ParticipantListExportRe } type ParticipantListExportReqBody struct { - MeetingStartTime *string `json:"meeting_start_time,omitempty"` // 会议开始时间（unix时间，单位sec） - MeetingEndTime *string `json:"meeting_end_time,omitempty"` // 会议结束时间（unix时间，单位sec） - MeetingNo *string `json:"meeting_no,omitempty"` // 9位会议号 - UserId *string `json:"user_id,omitempty"` // 按参会Lark用户筛选（最多一个筛选条件） - RoomId *string `json:"room_id,omitempty"` // 按参会Rooms筛选（最多一个筛选条件） + MeetingStartTime *string `json:"meeting_start_time,omitempty"` // 会议开始时间（unix 时间，单位 sec） + MeetingEndTime *string `json:"meeting_end_time,omitempty"` // 会议结束时间（unix 时间，单位 sec） + MeetingNo *string `json:"meeting_no,omitempty"` // 9 位会议号 + UserId *string `json:"user_id,omitempty"` // 按参会 Lark 用户筛选（最多一个筛选条件） + RoomId *string `json:"room_id,omitempty"` // 按参会 Rooms 筛选（最多一个筛选条件） } type ParticipantListExportReq struct { @@ -6924,7 +6924,7 @@ type ParticipantListExportReq struct { } type ParticipantListExportRespData struct { - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id } type ParticipantListExportResp struct { @@ -6938,17 +6938,17 @@ func (resp *ParticipantListExportResp) Success() bool { } type ParticipantQualityListExportReqBodyBuilder struct { - meetingStartTime string // 会议开始时间（unix时间，单位sec） + meetingStartTime string // 会议开始时间（unix 时间，单位 sec） meetingStartTimeFlag bool - meetingEndTime string // 会议结束时间（unix时间，单位sec） + meetingEndTime string // 会议结束时间（unix 时间，单位 sec） meetingEndTimeFlag bool - meetingNo string // 9位会议号 + meetingNo string // 9 位会议号 meetingNoFlag bool - joinTime string // 参会人入会时间（unix时间，单位sec） + joinTime string // 参会人入会时间（unix 时间，单位 sec） joinTimeFlag bool - userId string // 参会人为Lark用户时填入，room_id和user_id必须只填一个 + userId string // 参会人为 Lark 用户时填入，room_id 和 user_id 必须只填一个 userIdFlag bool - roomId string // 参会人为Rooms时填入，room_id和user_id必须只填一个 + roomId string // 参会人为 Rooms 时填入，room_id 和 user_id 必须只填一个 roomIdFlag bool } @@ -6957,7 +6957,7 @@ func NewParticipantQualityListExportReqBodyBuilder() *ParticipantQualityListExpo return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ParticipantQualityListExportReqBodyBuilder) MeetingStartTime(meetingStartTime string) *ParticipantQualityListExportReqBodyBuilder { @@ -6966,7 +6966,7 @@ func (builder *ParticipantQualityListExportReqBodyBuilder) MeetingStartTime(meet return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ParticipantQualityListExportReqBodyBuilder) MeetingEndTime(meetingEndTime string) *ParticipantQualityListExportReqBodyBuilder { @@ -6975,7 +6975,7 @@ func (builder *ParticipantQualityListExportReqBodyBuilder) MeetingEndTime(meetin return builder } -// 9位会议号 +// 9 位会议号 // //示例值：123456789 func (builder *ParticipantQualityListExportReqBodyBuilder) MeetingNo(meetingNo string) *ParticipantQualityListExportReqBodyBuilder { @@ -6984,7 +6984,7 @@ func (builder *ParticipantQualityListExportReqBodyBuilder) MeetingNo(meetingNo s return builder } -// 参会人入会时间（unix时间，单位sec） +// 参会人入会时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ParticipantQualityListExportReqBodyBuilder) JoinTime(joinTime string) *ParticipantQualityListExportReqBodyBuilder { @@ -6993,7 +6993,7 @@ func (builder *ParticipantQualityListExportReqBodyBuilder) JoinTime(joinTime str return builder } -// 参会人为Lark用户时填入，room_id和user_id必须只填一个 +// 参会人为 Lark 用户时填入，room_id 和 user_id 必须只填一个 // //示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ParticipantQualityListExportReqBodyBuilder) UserId(userId string) *ParticipantQualityListExportReqBodyBuilder { @@ -7002,7 +7002,7 @@ func (builder *ParticipantQualityListExportReqBodyBuilder) UserId(userId string) return builder } -// 参会人为Rooms时填入，room_id和user_id必须只填一个 +// 参会人为 Rooms 时填入，room_id 和 user_id 必须只填一个 // //示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *ParticipantQualityListExportReqBodyBuilder) RoomId(roomId string) *ParticipantQualityListExportReqBodyBuilder { @@ -7035,17 +7035,17 @@ func (builder *ParticipantQualityListExportReqBodyBuilder) Build() *ParticipantQ } type ParticipantQualityListExportPathReqBodyBuilder struct { - meetingStartTime string // 会议开始时间（unix时间，单位sec） + meetingStartTime string // 会议开始时间（unix 时间，单位 sec） meetingStartTimeFlag bool - meetingEndTime string // 会议结束时间（unix时间，单位sec） + meetingEndTime string // 会议结束时间（unix 时间，单位 sec） meetingEndTimeFlag bool - meetingNo string // 9位会议号 + meetingNo string // 9 位会议号 meetingNoFlag bool - joinTime string // 参会人入会时间（unix时间，单位sec） + joinTime string // 参会人入会时间（unix 时间，单位 sec） joinTimeFlag bool - userId string // 参会人为Lark用户时填入，room_id和user_id必须只填一个 + userId string // 参会人为 Lark 用户时填入，room_id 和 user_id 必须只填一个 userIdFlag bool - roomId string // 参会人为Rooms时填入，room_id和user_id必须只填一个 + roomId string // 参会人为 Rooms 时填入，room_id 和 user_id 必须只填一个 roomIdFlag bool } @@ -7054,7 +7054,7 @@ func NewParticipantQualityListExportPathReqBodyBuilder() *ParticipantQualityList return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ParticipantQualityListExportPathReqBodyBuilder) MeetingStartTime(meetingStartTime string) *ParticipantQualityListExportPathReqBodyBuilder { @@ -7063,7 +7063,7 @@ func (builder *ParticipantQualityListExportPathReqBodyBuilder) MeetingStartTime( return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ParticipantQualityListExportPathReqBodyBuilder) MeetingEndTime(meetingEndTime string) *ParticipantQualityListExportPathReqBodyBuilder { @@ -7072,7 +7072,7 @@ func (builder *ParticipantQualityListExportPathReqBodyBuilder) MeetingEndTime(me return builder } -// 9位会议号 +// 9 位会议号 // // 示例值：123456789 func (builder *ParticipantQualityListExportPathReqBodyBuilder) MeetingNo(meetingNo string) *ParticipantQualityListExportPathReqBodyBuilder { @@ -7081,7 +7081,7 @@ func (builder *ParticipantQualityListExportPathReqBodyBuilder) MeetingNo(meeting return builder } -// 参会人入会时间（unix时间，单位sec） +// 参会人入会时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ParticipantQualityListExportPathReqBodyBuilder) JoinTime(joinTime string) *ParticipantQualityListExportPathReqBodyBuilder { @@ -7090,7 +7090,7 @@ func (builder *ParticipantQualityListExportPathReqBodyBuilder) JoinTime(joinTime return builder } -// 参会人为Lark用户时填入，room_id和user_id必须只填一个 +// 参会人为 Lark 用户时填入，room_id 和 user_id 必须只填一个 // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ParticipantQualityListExportPathReqBodyBuilder) UserId(userId string) *ParticipantQualityListExportPathReqBodyBuilder { @@ -7099,7 +7099,7 @@ func (builder *ParticipantQualityListExportPathReqBodyBuilder) UserId(userId str return builder } -// 参会人为Rooms时填入，room_id和user_id必须只填一个 +// 参会人为 Rooms 时填入，room_id 和 user_id 必须只填一个 // // 示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *ParticipantQualityListExportPathReqBodyBuilder) RoomId(roomId string) *ParticipantQualityListExportPathReqBodyBuilder { @@ -7145,7 +7145,7 @@ func NewParticipantQualityListExportReqBuilder() *ParticipantQualityListExportRe return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *ParticipantQualityListExportReqBuilder) UserIdType(userIdType string) *ParticipantQualityListExportReqBuilder { @@ -7168,12 +7168,12 @@ func (builder *ParticipantQualityListExportReqBuilder) Build() *ParticipantQuali } type ParticipantQualityListExportReqBody struct { - MeetingStartTime *string `json:"meeting_start_time,omitempty"` // 会议开始时间（unix时间，单位sec） - MeetingEndTime *string `json:"meeting_end_time,omitempty"` // 会议结束时间（unix时间，单位sec） - MeetingNo *string `json:"meeting_no,omitempty"` // 9位会议号 - JoinTime *string `json:"join_time,omitempty"` // 参会人入会时间（unix时间，单位sec） - UserId *string `json:"user_id,omitempty"` // 参会人为Lark用户时填入，room_id和user_id必须只填一个 - RoomId *string `json:"room_id,omitempty"` // 参会人为Rooms时填入，room_id和user_id必须只填一个 + MeetingStartTime *string `json:"meeting_start_time,omitempty"` // 会议开始时间（unix 时间，单位 sec） + MeetingEndTime *string `json:"meeting_end_time,omitempty"` // 会议结束时间（unix 时间，单位 sec） + MeetingNo *string `json:"meeting_no,omitempty"` // 9 位会议号 + JoinTime *string `json:"join_time,omitempty"` // 参会人入会时间（unix 时间，单位 sec） + UserId *string `json:"user_id,omitempty"` // 参会人为 Lark 用户时填入，room_id 和 user_id 必须只填一个 + RoomId *string `json:"room_id,omitempty"` // 参会人为 Rooms 时填入，room_id 和 user_id 必须只填一个 } type ParticipantQualityListExportReq struct { @@ -7182,7 +7182,7 @@ type ParticipantQualityListExportReq struct { } type ParticipantQualityListExportRespData struct { - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id } type ParticipantQualityListExportResp struct { @@ -7196,17 +7196,17 @@ func (resp *ParticipantQualityListExportResp) Success() bool { } type ResourceReservationListExportReqBodyBuilder struct { - roomLevelId string // 会议室层级id + roomLevelId string // 会议室层级 id roomLevelIdFlag bool needTopic bool // 是否展示会议主题 needTopicFlag bool - startTime string // 查询开始时间（unix时间，单位sec） + startTime string // 查询开始时间（unix 时间，单位 sec） startTimeFlag bool - endTime string // 查询结束时间（unix时间，单位sec） + endTime string // 查询结束时间（unix 时间，单位 sec） endTimeFlag bool - roomIds []string // 待筛选的会议室id列表 + roomIds []string // 待筛选的会议室 id 列表 roomIdsFlag bool - isExclude bool // 若为true表示导出room_ids范围外的会议室，默认为false + isExclude bool // 若为 true 表示导出 room_ids 范围外的会议室，默认为 false isExcludeFlag bool } @@ -7215,7 +7215,7 @@ func NewResourceReservationListExportReqBodyBuilder() *ResourceReservationListEx return builder } -// 会议室层级id +// 会议室层级 id // //示例值：omm_608d34d82d531b27fa993902d350a307 func (builder *ResourceReservationListExportReqBodyBuilder) RoomLevelId(roomLevelId string) *ResourceReservationListExportReqBodyBuilder { @@ -7233,7 +7233,7 @@ func (builder *ResourceReservationListExportReqBodyBuilder) NeedTopic(needTopic return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ResourceReservationListExportReqBodyBuilder) StartTime(startTime string) *ResourceReservationListExportReqBodyBuilder { @@ -7242,7 +7242,7 @@ func (builder *ResourceReservationListExportReqBodyBuilder) StartTime(startTime return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // //示例值：1655276858 func (builder *ResourceReservationListExportReqBodyBuilder) EndTime(endTime string) *ResourceReservationListExportReqBodyBuilder { @@ -7251,7 +7251,7 @@ func (builder *ResourceReservationListExportReqBodyBuilder) EndTime(endTime stri return builder } -// 待筛选的会议室id列表 +// 待筛选的会议室 id 列表 // //示例值：["omm_eada1d61a550955240c28757e7dec3af"] func (builder *ResourceReservationListExportReqBodyBuilder) RoomIds(roomIds []string) *ResourceReservationListExportReqBodyBuilder { @@ -7260,7 +7260,7 @@ func (builder *ResourceReservationListExportReqBodyBuilder) RoomIds(roomIds []st return builder } -// 若为true表示导出room_ids范围外的会议室，默认为false +// 若为 true 表示导出 room_ids 范围外的会议室，默认为 false // //示例值：false func (builder *ResourceReservationListExportReqBodyBuilder) IsExclude(isExclude bool) *ResourceReservationListExportReqBodyBuilder { @@ -7293,17 +7293,17 @@ func (builder *ResourceReservationListExportReqBodyBuilder) Build() *ResourceRes } type ResourceReservationListExportPathReqBodyBuilder struct { - roomLevelId string // 会议室层级id + roomLevelId string // 会议室层级 id roomLevelIdFlag bool needTopic bool // 是否展示会议主题 needTopicFlag bool - startTime string // 查询开始时间（unix时间，单位sec） + startTime string // 查询开始时间（unix 时间，单位 sec） startTimeFlag bool - endTime string // 查询结束时间（unix时间，单位sec） + endTime string // 查询结束时间（unix 时间，单位 sec） endTimeFlag bool - roomIds []string // 待筛选的会议室id列表 + roomIds []string // 待筛选的会议室 id 列表 roomIdsFlag bool - isExclude bool // 若为true表示导出room_ids范围外的会议室，默认为false + isExclude bool // 若为 true 表示导出 room_ids 范围外的会议室，默认为 false isExcludeFlag bool } @@ -7312,7 +7312,7 @@ func NewResourceReservationListExportPathReqBodyBuilder() *ResourceReservationLi return builder } -// 会议室层级id +// 会议室层级 id // // 示例值：omm_608d34d82d531b27fa993902d350a307 func (builder *ResourceReservationListExportPathReqBodyBuilder) RoomLevelId(roomLevelId string) *ResourceReservationListExportPathReqBodyBuilder { @@ -7330,7 +7330,7 @@ func (builder *ResourceReservationListExportPathReqBodyBuilder) NeedTopic(needTo return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ResourceReservationListExportPathReqBodyBuilder) StartTime(startTime string) *ResourceReservationListExportPathReqBodyBuilder { @@ -7339,7 +7339,7 @@ func (builder *ResourceReservationListExportPathReqBodyBuilder) StartTime(startT return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *ResourceReservationListExportPathReqBodyBuilder) EndTime(endTime string) *ResourceReservationListExportPathReqBodyBuilder { @@ -7348,7 +7348,7 @@ func (builder *ResourceReservationListExportPathReqBodyBuilder) EndTime(endTime return builder } -// 待筛选的会议室id列表 +// 待筛选的会议室 id 列表 // // 示例值：["omm_eada1d61a550955240c28757e7dec3af"] func (builder *ResourceReservationListExportPathReqBodyBuilder) RoomIds(roomIds []string) *ResourceReservationListExportPathReqBodyBuilder { @@ -7357,7 +7357,7 @@ func (builder *ResourceReservationListExportPathReqBodyBuilder) RoomIds(roomIds return builder } -// 若为true表示导出room_ids范围外的会议室，默认为false +// 若为 true 表示导出 room_ids 范围外的会议室，默认为 false // // 示例值：false func (builder *ResourceReservationListExportPathReqBodyBuilder) IsExclude(isExclude bool) *ResourceReservationListExportPathReqBodyBuilder { @@ -7417,12 +7417,12 @@ func (builder *ResourceReservationListExportReqBuilder) Build() *ResourceReserva } type ResourceReservationListExportReqBody struct { - RoomLevelId *string `json:"room_level_id,omitempty"` // 会议室层级id + RoomLevelId *string `json:"room_level_id,omitempty"` // 会议室层级 id NeedTopic *bool `json:"need_topic,omitempty"` // 是否展示会议主题 - StartTime *string `json:"start_time,omitempty"` // 查询开始时间（unix时间，单位sec） - EndTime *string `json:"end_time,omitempty"` // 查询结束时间（unix时间，单位sec） - RoomIds []string `json:"room_ids,omitempty"` // 待筛选的会议室id列表 - IsExclude *bool `json:"is_exclude,omitempty"` // 若为true表示导出room_ids范围外的会议室，默认为false + StartTime *string `json:"start_time,omitempty"` // 查询开始时间（unix 时间，单位 sec） + EndTime *string `json:"end_time,omitempty"` // 查询结束时间（unix 时间，单位 sec） + RoomIds []string `json:"room_ids,omitempty"` // 待筛选的会议室 id 列表 + IsExclude *bool `json:"is_exclude,omitempty"` // 若为 true 表示导出 room_ids 范围外的会议室，默认为 false } type ResourceReservationListExportReq struct { @@ -7431,7 +7431,7 @@ type ResourceReservationListExportReq struct { } type ResourceReservationListExportRespData struct { - TaskId *string `json:"task_id,omitempty"` // 任务id + TaskId *string `json:"task_id,omitempty"` // 任务 id } type ResourceReservationListExportResp struct { @@ -7457,7 +7457,7 @@ func NewEndMeetingReqBuilder() *EndMeetingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *EndMeetingReqBuilder) MeetingId(meetingId string) *EndMeetingReqBuilder { @@ -7498,7 +7498,7 @@ func NewGetMeetingReqBuilder() *GetMeetingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *GetMeetingReqBuilder) MeetingId(meetingId string) *GetMeetingReqBuilder { @@ -7514,7 +7514,7 @@ func (builder *GetMeetingReqBuilder) WithParticipants(withParticipants bool) *Ge return builder } -// 是否需要会中使用能力统计（仅限tenant_access_token） +// 是否需要会中使用能力统计（仅限 tenant_access_token） // // 示例值：false func (builder *GetMeetingReqBuilder) WithMeetingAbility(withMeetingAbility bool) *GetMeetingReqBuilder { @@ -7522,7 +7522,7 @@ func (builder *GetMeetingReqBuilder) WithMeetingAbility(withMeetingAbility bool) return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *GetMeetingReqBuilder) UserIdType(userIdType string) *GetMeetingReqBuilder { @@ -7624,7 +7624,7 @@ func NewInviteMeetingReqBuilder() *InviteMeetingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *InviteMeetingReqBuilder) MeetingId(meetingId string) *InviteMeetingReqBuilder { @@ -7632,7 +7632,7 @@ func (builder *InviteMeetingReqBuilder) MeetingId(meetingId string) *InviteMeeti return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *InviteMeetingReqBuilder) UserIdType(userIdType string) *InviteMeetingReqBuilder { @@ -7746,7 +7746,7 @@ func NewKickoutMeetingReqBuilder() *KickoutMeetingReqBuilder { return builder } -// 会议ID +// 会议 ID // // 示例值：6911188411932033028 func (builder *KickoutMeetingReqBuilder) MeetingId(meetingId string) *KickoutMeetingReqBuilder { @@ -7754,7 +7754,7 @@ func (builder *KickoutMeetingReqBuilder) MeetingId(meetingId string) *KickoutMee return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *KickoutMeetingReqBuilder) UserIdType(userIdType string) *KickoutMeetingReqBuilder { @@ -7820,7 +7820,7 @@ func (builder *ListByNoMeetingReqBuilder) Limit(limit int) *ListByNoMeetingReqBu return builder } -// 9位会议号 +// 9 位会议号 // // 示例值：123456789 func (builder *ListByNoMeetingReqBuilder) MeetingNo(meetingNo string) *ListByNoMeetingReqBuilder { @@ -7828,7 +7828,7 @@ func (builder *ListByNoMeetingReqBuilder) MeetingNo(meetingNo string) *ListByNoM return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // // 示例值：1608888867 func (builder *ListByNoMeetingReqBuilder) StartTime(startTime string) *ListByNoMeetingReqBuilder { @@ -7836,7 +7836,7 @@ func (builder *ListByNoMeetingReqBuilder) StartTime(startTime string) *ListByNoM return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // // 示例值：1608888867 func (builder *ListByNoMeetingReqBuilder) EndTime(endTime string) *ListByNoMeetingReqBuilder { @@ -7876,7 +7876,7 @@ type ListByNoMeetingReq struct { type ListByNoMeetingRespData struct { HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 MeetingBriefs []*Meeting `json:"meeting_briefs,omitempty"` // 会议简要信息列表 } @@ -7893,7 +7893,7 @@ func (resp *ListByNoMeetingResp) Success() bool { type SetHostMeetingReqBodyBuilder struct { hostUser *MeetingUser // 将要设置的主持人 hostUserFlag bool - oldHostUser *MeetingUser // 当前主持人（CAS并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） + oldHostUser *MeetingUser // 当前主持人（CAS 并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） oldHostUserFlag bool } @@ -7911,7 +7911,7 @@ func (builder *SetHostMeetingReqBodyBuilder) HostUser(hostUser *MeetingUser) *Se return builder } -// 当前主持人（CAS并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） +// 当前主持人（CAS 并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） // //示例值： func (builder *SetHostMeetingReqBodyBuilder) OldHostUser(oldHostUser *MeetingUser) *SetHostMeetingReqBodyBuilder { @@ -7934,7 +7934,7 @@ func (builder *SetHostMeetingReqBodyBuilder) Build() *SetHostMeetingReqBody { type SetHostMeetingPathReqBodyBuilder struct { hostUser *MeetingUser // 将要设置的主持人 hostUserFlag bool - oldHostUser *MeetingUser // 当前主持人（CAS并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） + oldHostUser *MeetingUser // 当前主持人（CAS 并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） oldHostUserFlag bool } @@ -7952,7 +7952,7 @@ func (builder *SetHostMeetingPathReqBodyBuilder) HostUser(hostUser *MeetingUser) return builder } -// 当前主持人（CAS并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） +// 当前主持人（CAS 并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） // // 示例值： func (builder *SetHostMeetingPathReqBodyBuilder) OldHostUser(oldHostUser *MeetingUser) *SetHostMeetingPathReqBodyBuilder { @@ -7986,7 +7986,7 @@ func NewSetHostMeetingReqBuilder() *SetHostMeetingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *SetHostMeetingReqBuilder) MeetingId(meetingId string) *SetHostMeetingReqBuilder { @@ -7994,7 +7994,7 @@ func (builder *SetHostMeetingReqBuilder) MeetingId(meetingId string) *SetHostMee return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *SetHostMeetingReqBuilder) UserIdType(userIdType string) *SetHostMeetingReqBuilder { @@ -8019,7 +8019,7 @@ func (builder *SetHostMeetingReqBuilder) Build() *SetHostMeetingReq { type SetHostMeetingReqBody struct { HostUser *MeetingUser `json:"host_user,omitempty"` // 将要设置的主持人 - OldHostUser *MeetingUser `json:"old_host_user,omitempty"` // 当前主持人（CAS并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） + OldHostUser *MeetingUser `json:"old_host_user,omitempty"` // 当前主持人（CAS 并发安全：如果和会中当前主持人不符则会设置失败，可使用返回的最新数据重新设置） } type SetHostMeetingReq struct { @@ -8054,7 +8054,7 @@ func NewGetMeetingRecordingReqBuilder() *GetMeetingRecordingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *GetMeetingRecordingReqBuilder) MeetingId(meetingId string) *GetMeetingRecordingReqBuilder { @@ -8155,7 +8155,7 @@ func NewSetPermissionMeetingRecordingReqBuilder() *SetPermissionMeetingRecording return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *SetPermissionMeetingRecordingReqBuilder) MeetingId(meetingId string) *SetPermissionMeetingRecordingReqBuilder { @@ -8163,7 +8163,7 @@ func (builder *SetPermissionMeetingRecordingReqBuilder) MeetingId(meetingId stri return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *SetPermissionMeetingRecordingReqBuilder) UserIdType(userIdType string) *SetPermissionMeetingRecordingReqBuilder { @@ -8205,7 +8205,7 @@ func (resp *SetPermissionMeetingRecordingResp) Success() bool { } type StartMeetingRecordingReqBodyBuilder struct { - timezone int // 录制文件时间显示使用的时区[-12,12] + timezone int // 录制文件时间显示使用的时区 [-12,12] timezoneFlag bool } @@ -8214,7 +8214,7 @@ func NewStartMeetingRecordingReqBodyBuilder() *StartMeetingRecordingReqBodyBuild return builder } -// 录制文件时间显示使用的时区[-12,12] +// 录制文件时间显示使用的时区 [-12,12] // //示例值：8 func (builder *StartMeetingRecordingReqBodyBuilder) Timezone(timezone int) *StartMeetingRecordingReqBodyBuilder { @@ -8232,7 +8232,7 @@ func (builder *StartMeetingRecordingReqBodyBuilder) Build() *StartMeetingRecordi } type StartMeetingRecordingPathReqBodyBuilder struct { - timezone int // 录制文件时间显示使用的时区[-12,12] + timezone int // 录制文件时间显示使用的时区 [-12,12] timezoneFlag bool } @@ -8241,7 +8241,7 @@ func NewStartMeetingRecordingPathReqBodyBuilder() *StartMeetingRecordingPathReqB return builder } -// 录制文件时间显示使用的时区[-12,12] +// 录制文件时间显示使用的时区 [-12,12] // // 示例值：8 func (builder *StartMeetingRecordingPathReqBodyBuilder) Timezone(timezone int) *StartMeetingRecordingPathReqBodyBuilder { @@ -8272,7 +8272,7 @@ func NewStartMeetingRecordingReqBuilder() *StartMeetingRecordingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *StartMeetingRecordingReqBuilder) MeetingId(meetingId string) *StartMeetingRecordingReqBuilder { @@ -8295,7 +8295,7 @@ func (builder *StartMeetingRecordingReqBuilder) Build() *StartMeetingRecordingRe } type StartMeetingRecordingReqBody struct { - Timezone *int `json:"timezone,omitempty"` // 录制文件时间显示使用的时区[-12,12] + Timezone *int `json:"timezone,omitempty"` // 录制文件时间显示使用的时区 [-12,12] } type StartMeetingRecordingReq struct { @@ -8325,7 +8325,7 @@ func NewStopMeetingRecordingReqBuilder() *StopMeetingRecordingReqBuilder { return builder } -// 会议ID（视频会议的唯一标识，视频会议开始后才会产生） +// 会议 ID（视频会议的唯一标识，视频会议开始后才会产生） // // 示例值：6911188411932033028 func (builder *StopMeetingRecordingReqBuilder) MeetingId(meetingId string) *StopMeetingRecordingReqBuilder { @@ -8373,7 +8373,7 @@ func (builder *GetMeetingListReqBuilder) Limit(limit int) *GetMeetingListReqBuil return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetMeetingListReqBuilder) StartTime(startTime string) *GetMeetingListReqBuilder { @@ -8381,7 +8381,7 @@ func (builder *GetMeetingListReqBuilder) StartTime(startTime string) *GetMeeting return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetMeetingListReqBuilder) EndTime(endTime string) *GetMeetingListReqBuilder { @@ -8389,7 +8389,7 @@ func (builder *GetMeetingListReqBuilder) EndTime(endTime string) *GetMeetingList return builder } -// 按9位会议号筛选（最多一个筛选条件） +// 按 9 位会议号筛选（最多一个筛选条件） // // 示例值：123456789 func (builder *GetMeetingListReqBuilder) MeetingNo(meetingNo string) *GetMeetingListReqBuilder { @@ -8397,7 +8397,7 @@ func (builder *GetMeetingListReqBuilder) MeetingNo(meetingNo string) *GetMeeting return builder } -// 按参会Lark用户筛选（最多一个筛选条件） +// 按参会 Lark 用户筛选（最多一个筛选条件） // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *GetMeetingListReqBuilder) UserId(userId string) *GetMeetingListReqBuilder { @@ -8405,7 +8405,7 @@ func (builder *GetMeetingListReqBuilder) UserId(userId string) *GetMeetingListRe return builder } -// 按参会Rooms筛选（最多一个筛选条件） +// 按参会 Rooms 筛选（最多一个筛选条件） // // 示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *GetMeetingListReqBuilder) RoomId(roomId string) *GetMeetingListReqBuilder { @@ -8421,7 +8421,7 @@ func (builder *GetMeetingListReqBuilder) PageSize(pageSize int) *GetMeetingListR return builder } -// 分页标记,第一次请求不填,表示从头开始遍历.下次遍历可采用该 page_token获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历。下次遍历可采用该 page_token 获取查询结果 // // 示例值： func (builder *GetMeetingListReqBuilder) PageToken(pageToken string) *GetMeetingListReqBuilder { @@ -8429,7 +8429,7 @@ func (builder *GetMeetingListReqBuilder) PageToken(pageToken string) *GetMeeting return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetMeetingListReqBuilder) UserIdType(userIdType string) *GetMeetingListReqBuilder { @@ -8453,7 +8453,7 @@ type GetMeetingListReq struct { type GetMeetingListRespData struct { MeetingList []*MeetingInfo `json:"meeting_list,omitempty"` // 会议列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 } @@ -8487,7 +8487,7 @@ func (builder *GetParticipantListReqBuilder) Limit(limit int) *GetParticipantLis return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetParticipantListReqBuilder) MeetingStartTime(meetingStartTime string) *GetParticipantListReqBuilder { @@ -8495,7 +8495,7 @@ func (builder *GetParticipantListReqBuilder) MeetingStartTime(meetingStartTime s return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetParticipantListReqBuilder) MeetingEndTime(meetingEndTime string) *GetParticipantListReqBuilder { @@ -8503,7 +8503,7 @@ func (builder *GetParticipantListReqBuilder) MeetingEndTime(meetingEndTime strin return builder } -// 9位会议号 +// 9 位会议号 // // 示例值：123456789 func (builder *GetParticipantListReqBuilder) MeetingNo(meetingNo string) *GetParticipantListReqBuilder { @@ -8511,7 +8511,7 @@ func (builder *GetParticipantListReqBuilder) MeetingNo(meetingNo string) *GetPar return builder } -// 按参会Lark用户筛选（最多一个筛选条件） +// 按参会 Lark 用户筛选（最多一个筛选条件） // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *GetParticipantListReqBuilder) UserId(userId string) *GetParticipantListReqBuilder { @@ -8519,7 +8519,7 @@ func (builder *GetParticipantListReqBuilder) UserId(userId string) *GetParticipa return builder } -// 按参会Rooms筛选（最多一个筛选条件） +// 按参会 Rooms 筛选（最多一个筛选条件） // // 示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *GetParticipantListReqBuilder) RoomId(roomId string) *GetParticipantListReqBuilder { @@ -8535,7 +8535,7 @@ func (builder *GetParticipantListReqBuilder) PageSize(pageSize int) *GetParticip return builder } -// 分页标记,第一次请求不填,表示从头开始遍历.下次遍历可采用该 page_token获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历。下次遍历可采用该 page_token 获取查询结果 // // 示例值： func (builder *GetParticipantListReqBuilder) PageToken(pageToken string) *GetParticipantListReqBuilder { @@ -8543,7 +8543,7 @@ func (builder *GetParticipantListReqBuilder) PageToken(pageToken string) *GetPar return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetParticipantListReqBuilder) UserIdType(userIdType string) *GetParticipantListReqBuilder { @@ -8567,7 +8567,7 @@ type GetParticipantListReq struct { type GetParticipantListRespData struct { Participants []*Participant `json:"participants,omitempty"` // 参会人列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 } @@ -8601,7 +8601,7 @@ func (builder *GetParticipantQualityListReqBuilder) Limit(limit int) *GetPartici return builder } -// 会议开始时间（unix时间，单位sec） +// 会议开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetParticipantQualityListReqBuilder) MeetingStartTime(meetingStartTime string) *GetParticipantQualityListReqBuilder { @@ -8609,7 +8609,7 @@ func (builder *GetParticipantQualityListReqBuilder) MeetingStartTime(meetingStar return builder } -// 会议结束时间（unix时间，单位sec） +// 会议结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetParticipantQualityListReqBuilder) MeetingEndTime(meetingEndTime string) *GetParticipantQualityListReqBuilder { @@ -8617,7 +8617,7 @@ func (builder *GetParticipantQualityListReqBuilder) MeetingEndTime(meetingEndTim return builder } -// 9位会议号 +// 9 位会议号 // // 示例值：123456789 func (builder *GetParticipantQualityListReqBuilder) MeetingNo(meetingNo string) *GetParticipantQualityListReqBuilder { @@ -8625,7 +8625,7 @@ func (builder *GetParticipantQualityListReqBuilder) MeetingNo(meetingNo string) return builder } -// 参会人入会时间（unix时间，单位sec） +// 参会人入会时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetParticipantQualityListReqBuilder) JoinTime(joinTime string) *GetParticipantQualityListReqBuilder { @@ -8633,7 +8633,7 @@ func (builder *GetParticipantQualityListReqBuilder) JoinTime(joinTime string) *G return builder } -// 参会人为Lark用户时填入 +// 参会人为 Lark 用户时填入 // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *GetParticipantQualityListReqBuilder) UserId(userId string) *GetParticipantQualityListReqBuilder { @@ -8641,7 +8641,7 @@ func (builder *GetParticipantQualityListReqBuilder) UserId(userId string) *GetPa return builder } -// 参会人为Rooms时填入 +// 参会人为 Rooms 时填入 // // 示例值：omm_eada1d61a550955240c28757e7dec3af func (builder *GetParticipantQualityListReqBuilder) RoomId(roomId string) *GetParticipantQualityListReqBuilder { @@ -8657,7 +8657,7 @@ func (builder *GetParticipantQualityListReqBuilder) PageSize(pageSize int) *GetP return builder } -// 分页标记,第一次请求不填,表示从头开始遍历.下次遍历可采用该 page_token获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历。下次遍历可采用该 page_token 获取查询结果 // // 示例值： func (builder *GetParticipantQualityListReqBuilder) PageToken(pageToken string) *GetParticipantQualityListReqBuilder { @@ -8665,7 +8665,7 @@ func (builder *GetParticipantQualityListReqBuilder) PageToken(pageToken string) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetParticipantQualityListReqBuilder) UserIdType(userIdType string) *GetParticipantQualityListReqBuilder { @@ -8689,7 +8689,7 @@ type GetParticipantQualityListReq struct { type GetParticipantQualityListRespData struct { ParticipantQualityList []*ParticipantQuality `json:"participant_quality_list,omitempty"` // 参会人参会质量列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 } @@ -8716,7 +8716,7 @@ func NewGetDailyReportReqBuilder() *GetDailyReportReqBuilder { return builder } -// 开始时间（unix时间，单位sec） +// 开始时间（unix 时间，单位 sec） // // 示例值：1608888867 func (builder *GetDailyReportReqBuilder) StartTime(startTime string) *GetDailyReportReqBuilder { @@ -8724,7 +8724,7 @@ func (builder *GetDailyReportReqBuilder) StartTime(startTime string) *GetDailyRe return builder } -// 结束时间（unix时间，单位sec） +// 结束时间（unix 时间，单位 sec） // // 示例值：1608888966 func (builder *GetDailyReportReqBuilder) EndTime(endTime string) *GetDailyReportReqBuilder { @@ -8770,7 +8770,7 @@ func NewGetTopUserReportReqBuilder() *GetTopUserReportReqBuilder { return builder } -// 开始时间（unix时间，单位sec） +// 开始时间（unix 时间，单位 sec） // // 示例值：1608888867 func (builder *GetTopUserReportReqBuilder) StartTime(startTime string) *GetTopUserReportReqBuilder { @@ -8778,7 +8778,7 @@ func (builder *GetTopUserReportReqBuilder) StartTime(startTime string) *GetTopUs return builder } -// 结束时间（unix时间，单位sec） +// 结束时间（unix 时间，单位 sec） // // 示例值：1608889966 func (builder *GetTopUserReportReqBuilder) EndTime(endTime string) *GetTopUserReportReqBuilder { @@ -8802,7 +8802,7 @@ func (builder *GetTopUserReportReqBuilder) OrderBy(orderBy int) *GetTopUserRepor return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetTopUserReportReqBuilder) UserIdType(userIdType string) *GetTopUserReportReqBuilder { @@ -8822,7 +8822,7 @@ type GetTopUserReportReq struct { } type GetTopUserReportRespData struct { - TopUserReport []*ReportTopUser `json:"top_user_report,omitempty"` // top用户列表 + TopUserReport []*ReportTopUser `json:"top_user_report,omitempty"` // top 用户列表 } type GetTopUserReportResp struct { @@ -8836,9 +8836,9 @@ func (resp *GetTopUserReportResp) Success() bool { } type ApplyReserveReqBodyBuilder struct { - endTime string // 预约到期时间（unix时间，单位sec），多人会议必填 + endTime string // 预约到期时间（unix 时间，单位 sec），多人会议必填 endTimeFlag bool - ownerId string // 指定会议归属人，使用tenant_access_token时生效且必传，使用user_access_token时不生效，必须指定为同租户下的合法lark用户 + ownerId string // 指定会议归属人，使用 tenant_access_token 时生效且必传，使用 user_access_token 时不生效，必须指定为同租户下的合法 lark 用户 ownerIdFlag bool meetingSettings *ReserveMeetingSetting // 会议设置 meetingSettingsFlag bool @@ -8849,7 +8849,7 @@ func NewApplyReserveReqBodyBuilder() *ApplyReserveReqBodyBuilder { return builder } -// 预约到期时间（unix时间，单位sec），多人会议必填 +// 预约到期时间（unix 时间，单位 sec），多人会议必填 // //示例值：1608888867 func (builder *ApplyReserveReqBodyBuilder) EndTime(endTime string) *ApplyReserveReqBodyBuilder { @@ -8858,7 +8858,7 @@ func (builder *ApplyReserveReqBodyBuilder) EndTime(endTime string) *ApplyReserve return builder } -// 指定会议归属人，使用tenant_access_token时生效且必传，使用user_access_token时不生效，必须指定为同租户下的合法lark用户 +// 指定会议归属人，使用 tenant_access_token 时生效且必传，使用 user_access_token 时不生效，必须指定为同租户下的合法 lark 用户 // //示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ApplyReserveReqBodyBuilder) OwnerId(ownerId string) *ApplyReserveReqBodyBuilder { @@ -8891,9 +8891,9 @@ func (builder *ApplyReserveReqBodyBuilder) Build() *ApplyReserveReqBody { } type ApplyReservePathReqBodyBuilder struct { - endTime string // 预约到期时间（unix时间，单位sec），多人会议必填 + endTime string // 预约到期时间（unix 时间，单位 sec），多人会议必填 endTimeFlag bool - ownerId string // 指定会议归属人，使用tenant_access_token时生效且必传，使用user_access_token时不生效，必须指定为同租户下的合法lark用户 + ownerId string // 指定会议归属人，使用 tenant_access_token 时生效且必传，使用 user_access_token 时不生效，必须指定为同租户下的合法 lark 用户 ownerIdFlag bool meetingSettings *ReserveMeetingSetting // 会议设置 meetingSettingsFlag bool @@ -8904,7 +8904,7 @@ func NewApplyReservePathReqBodyBuilder() *ApplyReservePathReqBodyBuilder { return builder } -// 预约到期时间（unix时间，单位sec），多人会议必填 +// 预约到期时间（unix 时间，单位 sec），多人会议必填 // // 示例值：1608888867 func (builder *ApplyReservePathReqBodyBuilder) EndTime(endTime string) *ApplyReservePathReqBodyBuilder { @@ -8913,7 +8913,7 @@ func (builder *ApplyReservePathReqBodyBuilder) EndTime(endTime string) *ApplyRes return builder } -// 指定会议归属人，使用tenant_access_token时生效且必传，使用user_access_token时不生效，必须指定为同租户下的合法lark用户 +// 指定会议归属人，使用 tenant_access_token 时生效且必传，使用 user_access_token 时不生效，必须指定为同租户下的合法 lark 用户 // // 示例值：ou_3ec3f6a28a0d08c45d895276e8e5e19b func (builder *ApplyReservePathReqBodyBuilder) OwnerId(ownerId string) *ApplyReservePathReqBodyBuilder { @@ -8959,7 +8959,7 @@ func NewApplyReserveReqBuilder() *ApplyReserveReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *ApplyReserveReqBuilder) UserIdType(userIdType string) *ApplyReserveReqBuilder { @@ -8982,8 +8982,8 @@ func (builder *ApplyReserveReqBuilder) Build() *ApplyReserveReq { } type ApplyReserveReqBody struct { - EndTime *string `json:"end_time,omitempty"` // 预约到期时间（unix时间，单位sec），多人会议必填 - OwnerId *string `json:"owner_id,omitempty"` // 指定会议归属人，使用tenant_access_token时生效且必传，使用user_access_token时不生效，必须指定为同租户下的合法lark用户 + EndTime *string `json:"end_time,omitempty"` // 预约到期时间（unix 时间，单位 sec），多人会议必填 + OwnerId *string `json:"owner_id,omitempty"` // 指定会议归属人，使用 tenant_access_token 时生效且必传，使用 user_access_token 时不生效，必须指定为同租户下的合法 lark 用户 MeetingSettings *ReserveMeetingSetting `json:"meeting_settings,omitempty"` // 会议设置 } @@ -9020,7 +9020,7 @@ func NewDeleteReserveReqBuilder() *DeleteReserveReqBuilder { return builder } -// 预约ID（预约的唯一标识） +// 预约 ID（预约的唯一标识） // // 示例值：6911188411932033028 func (builder *DeleteReserveReqBuilder) ReserveId(reserveId string) *DeleteReserveReqBuilder { @@ -9061,7 +9061,7 @@ func NewGetReserveReqBuilder() *GetReserveReqBuilder { return builder } -// 预约ID（预约的唯一标识） +// 预约 ID（预约的唯一标识） // // 示例值：6911188411932033028 func (builder *GetReserveReqBuilder) ReserveId(reserveId string) *GetReserveReqBuilder { @@ -9069,7 +9069,7 @@ func (builder *GetReserveReqBuilder) ReserveId(reserveId string) *GetReserveReqB return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetReserveReqBuilder) UserIdType(userIdType string) *GetReserveReqBuilder { @@ -9116,7 +9116,7 @@ func NewGetActiveMeetingReserveReqBuilder() *GetActiveMeetingReserveReqBuilder { return builder } -// 预约ID（预约的唯一标识） +// 预约 ID（预约的唯一标识） // // 示例值：6911188411932033028 func (builder *GetActiveMeetingReserveReqBuilder) ReserveId(reserveId string) *GetActiveMeetingReserveReqBuilder { @@ -9124,7 +9124,7 @@ func (builder *GetActiveMeetingReserveReqBuilder) ReserveId(reserveId string) *G return builder } -// 是否需要参会人列表，默认为false +// 是否需要参会人列表，默认为 false // // 示例值：false func (builder *GetActiveMeetingReserveReqBuilder) WithParticipants(withParticipants bool) *GetActiveMeetingReserveReqBuilder { @@ -9132,7 +9132,7 @@ func (builder *GetActiveMeetingReserveReqBuilder) WithParticipants(withParticipa return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetActiveMeetingReserveReqBuilder) UserIdType(userIdType string) *GetActiveMeetingReserveReqBuilder { @@ -9167,7 +9167,7 @@ func (resp *GetActiveMeetingReserveResp) Success() bool { } type UpdateReserveReqBodyBuilder struct { - endTime string // 预约到期时间（unix时间，单位sec） + endTime string // 预约到期时间（unix 时间，单位 sec） endTimeFlag bool meetingSettings *ReserveMeetingSetting // 会议设置 meetingSettingsFlag bool @@ -9178,7 +9178,7 @@ func NewUpdateReserveReqBodyBuilder() *UpdateReserveReqBodyBuilder { return builder } -// 预约到期时间（unix时间，单位sec） +// 预约到期时间（unix 时间，单位 sec） // //示例值：1608888867 func (builder *UpdateReserveReqBodyBuilder) EndTime(endTime string) *UpdateReserveReqBodyBuilder { @@ -9208,7 +9208,7 @@ func (builder *UpdateReserveReqBodyBuilder) Build() *UpdateReserveReqBody { } type UpdateReservePathReqBodyBuilder struct { - endTime string // 预约到期时间（unix时间，单位sec） + endTime string // 预约到期时间（unix 时间，单位 sec） endTimeFlag bool meetingSettings *ReserveMeetingSetting // 会议设置 meetingSettingsFlag bool @@ -9219,7 +9219,7 @@ func NewUpdateReservePathReqBodyBuilder() *UpdateReservePathReqBodyBuilder { return builder } -// 预约到期时间（unix时间，单位sec） +// 预约到期时间（unix 时间，单位 sec） // // 示例值：1608888867 func (builder *UpdateReservePathReqBodyBuilder) EndTime(endTime string) *UpdateReservePathReqBodyBuilder { @@ -9262,7 +9262,7 @@ func NewUpdateReserveReqBuilder() *UpdateReserveReqBuilder { return builder } -// 预约ID（预约的唯一标识） +// 预约 ID（预约的唯一标识） // // 示例值：6911188411932033028 func (builder *UpdateReserveReqBuilder) ReserveId(reserveId string) *UpdateReserveReqBuilder { @@ -9270,7 +9270,7 @@ func (builder *UpdateReserveReqBuilder) ReserveId(reserveId string) *UpdateReser return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *UpdateReserveReqBuilder) UserIdType(userIdType string) *UpdateReserveReqBuilder { @@ -9294,7 +9294,7 @@ func (builder *UpdateReserveReqBuilder) Build() *UpdateReserveReq { } type UpdateReserveReqBody struct { - EndTime *string `json:"end_time,omitempty"` // 预约到期时间（unix时间，单位sec） + EndTime *string `json:"end_time,omitempty"` // 预约到期时间（unix 时间，单位 sec） MeetingSettings *ReserveMeetingSetting `json:"meeting_settings,omitempty"` // 会议设置 } @@ -9470,7 +9470,7 @@ func NewPatchReserveConfigReqBuilder() *PatchReserveConfigReqBuilder { return builder } -// 会议室或层级id +// 会议室或层级 id // // 示例值：omm_3c5dd7e09bac0c1758fcf9511bd1a771 func (builder *PatchReserveConfigReqBuilder) ReserveConfigId(reserveConfigId string) *PatchReserveConfigReqBuilder { @@ -9478,7 +9478,7 @@ func (builder *PatchReserveConfigReqBuilder) ReserveConfigId(reserveConfigId str return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchReserveConfigReqBuilder) UserIdType(userIdType string) *PatchReserveConfigReqBuilder { @@ -9535,7 +9535,7 @@ func NewReserveScopeReserveConfigReqBuilder() *ReserveScopeReserveConfigReqBuild return builder } -// 会议室或层级id +// 会议室或层级 id // // 示例值：omm_3c5dd7e09bac0c1758fcf9511bd1a771 func (builder *ReserveScopeReserveConfigReqBuilder) ScopeId(scopeId string) *ReserveScopeReserveConfigReqBuilder { @@ -9551,7 +9551,7 @@ func (builder *ReserveScopeReserveConfigReqBuilder) ScopeType(scopeType string) return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *ReserveScopeReserveConfigReqBuilder) UserIdType(userIdType string) *ReserveScopeReserveConfigReqBuilder { @@ -9599,7 +9599,7 @@ func NewGetReserveConfigAdminReqBuilder() *GetReserveConfigAdminReqBuilder { return builder } -// 会议室或层级id +// 会议室或层级 id // // 示例值：omm_3c5dd7e09bac0c1758fcf9511bd1a771 func (builder *GetReserveConfigAdminReqBuilder) ReserveConfigId(reserveConfigId string) *GetReserveConfigAdminReqBuilder { @@ -9615,7 +9615,7 @@ func (builder *GetReserveConfigAdminReqBuilder) ScopeType(scopeType int) *GetRes return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *GetReserveConfigAdminReqBuilder) UserIdType(userIdType string) *GetReserveConfigAdminReqBuilder { @@ -9650,7 +9650,7 @@ func (resp *GetReserveConfigAdminResp) Success() bool { } type PatchReserveConfigAdminReqBodyBuilder struct { - scopeType int // 1代表层级，2代表会议室 + scopeType int // 1 代表层级，2 代表会议室 scopeTypeFlag bool reserveAdminConfig *ReserveAdminConfig // 预定管理员或部门 reserveAdminConfigFlag bool @@ -9661,7 +9661,7 @@ func NewPatchReserveConfigAdminReqBodyBuilder() *PatchReserveConfigAdminReqBodyB return builder } -// 1代表层级，2代表会议室 +// 1 代表层级，2 代表会议室 // //示例值：2 func (builder *PatchReserveConfigAdminReqBodyBuilder) ScopeType(scopeType int) *PatchReserveConfigAdminReqBodyBuilder { @@ -9691,7 +9691,7 @@ func (builder *PatchReserveConfigAdminReqBodyBuilder) Build() *PatchReserveConfi } type PatchReserveConfigAdminPathReqBodyBuilder struct { - scopeType int // 1代表层级，2代表会议室 + scopeType int // 1 代表层级，2 代表会议室 scopeTypeFlag bool reserveAdminConfig *ReserveAdminConfig // 预定管理员或部门 reserveAdminConfigFlag bool @@ -9702,7 +9702,7 @@ func NewPatchReserveConfigAdminPathReqBodyBuilder() *PatchReserveConfigAdminPath return builder } -// 1代表层级，2代表会议室 +// 1 代表层级，2 代表会议室 // // 示例值：2 func (builder *PatchReserveConfigAdminPathReqBodyBuilder) ScopeType(scopeType int) *PatchReserveConfigAdminPathReqBodyBuilder { @@ -9745,7 +9745,7 @@ func NewPatchReserveConfigAdminReqBuilder() *PatchReserveConfigAdminReqBuilder { return builder } -// 会议室或层级id +// 会议室或层级 id // // 示例值：omm_3c5dd7e09bac0c1758fcf9511bd1a771 func (builder *PatchReserveConfigAdminReqBuilder) ReserveConfigId(reserveConfigId string) *PatchReserveConfigAdminReqBuilder { @@ -9753,7 +9753,7 @@ func (builder *PatchReserveConfigAdminReqBuilder) ReserveConfigId(reserveConfigI return builder } -// 此次调用中使用的用户ID的类型 +// 此次调用中使用的用户 ID 的类型 // // 示例值： func (builder *PatchReserveConfigAdminReqBuilder) UserIdType(userIdType string) *PatchReserveConfigAdminReqBuilder { @@ -9777,7 +9777,7 @@ func (builder *PatchReserveConfigAdminReqBuilder) Build() *PatchReserveConfigAdm } type PatchReserveConfigAdminReqBody struct { - ScopeType *int `json:"scope_type,omitempty"` // 1代表层级，2代表会议室 + ScopeType *int `json:"scope_type,omitempty"` // 1 代表层级，2 代表会议室 ReserveAdminConfig *ReserveAdminConfig `json:"reserve_admin_config,omitempty"` // 预定管理员或部门 } @@ -9815,7 +9815,7 @@ func (builder *GetResourceReservationListReqBuilder) Limit(limit int) *GetResour return builder } -// 层级id +// 层级 id // // 示例值：omb_57c9cc7d9a81e27e54c8fabfd02759e7 func (builder *GetResourceReservationListReqBuilder) RoomLevelId(roomLevelId string) *GetResourceReservationListReqBuilder { @@ -9831,7 +9831,7 @@ func (builder *GetResourceReservationListReqBuilder) NeedTopic(needTopic bool) * return builder } -// 查询开始时间（unix时间，单位sec） +// 查询开始时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetResourceReservationListReqBuilder) StartTime(startTime string) *GetResourceReservationListReqBuilder { @@ -9839,7 +9839,7 @@ func (builder *GetResourceReservationListReqBuilder) StartTime(startTime string) return builder } -// 查询结束时间（unix时间，单位sec） +// 查询结束时间（unix 时间，单位 sec） // // 示例值：1655276858 func (builder *GetResourceReservationListReqBuilder) EndTime(endTime string) *GetResourceReservationListReqBuilder { @@ -9847,7 +9847,7 @@ func (builder *GetResourceReservationListReqBuilder) EndTime(endTime string) *Ge return builder } -// 待筛选的会议室id列表 +// 待筛选的会议室 id 列表 // // 示例值： func (builder *GetResourceReservationListReqBuilder) RoomIds(roomIds []string) *GetResourceReservationListReqBuilder { @@ -9857,7 +9857,7 @@ func (builder *GetResourceReservationListReqBuilder) RoomIds(roomIds []string) * return builder } -// 若为true表示导出room_ids范围外的会议室，默认为false +// 若为 true 表示导出 room_ids 范围外的会议室，默认为 false // // 示例值：false func (builder *GetResourceReservationListReqBuilder) IsExclude(isExclude bool) *GetResourceReservationListReqBuilder { @@ -9873,7 +9873,7 @@ func (builder *GetResourceReservationListReqBuilder) PageSize(pageSize int) *Get return builder } -// 分页标记,第一次请求不填,表示从头开始遍历.下次遍历可采用该 page_token获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历。下次遍历可采用该 page_token 获取查询结果 // // 示例值： func (builder *GetResourceReservationListReqBuilder) PageToken(pageToken string) *GetResourceReservationListReqBuilder { @@ -9897,7 +9897,7 @@ type GetResourceReservationListReq struct { type GetResourceReservationListRespData struct { RoomReservationList []*RoomMeetingReservation `json:"room_reservation_list,omitempty"` // 会议室预定列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 } @@ -9925,7 +9925,7 @@ func NewCreateRoomReqBuilder() *CreateRoomReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值：open_id func (builder *CreateRoomReqBuilder) UserIdType(userIdType string) *CreateRoomReqBuilder { @@ -9979,7 +9979,7 @@ func NewDeleteRoomReqBuilder() *DeleteRoomReqBuilder { return builder } -// 会议室ID +// 会议室 ID // // 示例值：omm_4de32cf10a4358788ff4e09e37ebbf9b func (builder *DeleteRoomReqBuilder) RoomId(roomId string) *DeleteRoomReqBuilder { @@ -10020,7 +10020,7 @@ func NewGetRoomReqBuilder() *GetRoomReqBuilder { return builder } -// 会议室ID +// 会议室 ID // // 示例值：omm_4de32cf10a4358788ff4e09e37ebbf9c func (builder *GetRoomReqBuilder) RoomId(roomId string) *GetRoomReqBuilder { @@ -10028,7 +10028,7 @@ func (builder *GetRoomReqBuilder) RoomId(roomId string) *GetRoomReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *GetRoomReqBuilder) UserIdType(userIdType string) *GetRoomReqBuilder { @@ -10098,7 +10098,7 @@ func (builder *ListRoomReqBuilder) PageToken(pageToken string) *ListRoomReqBuild return builder } -// 层级ID，当需要获取租户下会议室列表时，room_level_id可传空 +// 层级 ID，当需要获取租户下会议室列表时，room_level_id 可传空 // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *ListRoomReqBuilder) RoomLevelId(roomLevelId string) *ListRoomReqBuilder { @@ -10106,7 +10106,7 @@ func (builder *ListRoomReqBuilder) RoomLevelId(roomLevelId string) *ListRoomReqB return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *ListRoomReqBuilder) UserIdType(userIdType string) *ListRoomReqBuilder { @@ -10130,7 +10130,7 @@ type ListRoomReq struct { type ListRoomRespData struct { Rooms []*Room `json:"rooms,omitempty"` // 会议室列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 } @@ -10145,7 +10145,7 @@ func (resp *ListRoomResp) Success() bool { } type MgetRoomReqBodyBuilder struct { - roomIds []string // 会议室id列表 + roomIds []string // 会议室 id 列表 roomIdsFlag bool } @@ -10154,7 +10154,7 @@ func NewMgetRoomReqBodyBuilder() *MgetRoomReqBodyBuilder { return builder } -// 会议室id列表 +// 会议室 id 列表 // //示例值：["omm_4de32cf10a4358788ff4e09e37ebbf9b","omm_3c5dd7e09bac0c1758fcf9511bd1a771"] func (builder *MgetRoomReqBodyBuilder) RoomIds(roomIds []string) *MgetRoomReqBodyBuilder { @@ -10172,7 +10172,7 @@ func (builder *MgetRoomReqBodyBuilder) Build() *MgetRoomReqBody { } type MgetRoomPathReqBodyBuilder struct { - roomIds []string // 会议室id列表 + roomIds []string // 会议室 id 列表 roomIdsFlag bool } @@ -10181,7 +10181,7 @@ func NewMgetRoomPathReqBodyBuilder() *MgetRoomPathReqBodyBuilder { return builder } -// 会议室id列表 +// 会议室 id 列表 // // 示例值：["omm_4de32cf10a4358788ff4e09e37ebbf9b","omm_3c5dd7e09bac0c1758fcf9511bd1a771"] func (builder *MgetRoomPathReqBodyBuilder) RoomIds(roomIds []string) *MgetRoomPathReqBodyBuilder { @@ -10212,7 +10212,7 @@ func NewMgetRoomReqBuilder() *MgetRoomReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *MgetRoomReqBuilder) UserIdType(userIdType string) *MgetRoomReqBuilder { @@ -10220,7 +10220,7 @@ func (builder *MgetRoomReqBuilder) UserIdType(userIdType string) *MgetRoomReqBui return builder } -// 该接口可以使用会议室ID批量查询会议室详情 +// 该接口可以使用会议室 ID 批量查询会议室详情 func (builder *MgetRoomReqBuilder) Body(body *MgetRoomReqBody) *MgetRoomReqBuilder { builder.body = body return builder @@ -10235,7 +10235,7 @@ func (builder *MgetRoomReqBuilder) Build() *MgetRoomReq { } type MgetRoomReqBody struct { - RoomIds []string `json:"room_ids,omitempty"` // 会议室id列表 + RoomIds []string `json:"room_ids,omitempty"` // 会议室 id 列表 } type MgetRoomReq struct { @@ -10271,7 +10271,7 @@ func NewPatchRoomReqBuilder() *PatchRoomReqBuilder { return builder } -// 会议室ID +// 会议室 ID // // 示例值：omm_4de32cf10a4358788ff4e09e37ebbf9b func (builder *PatchRoomReqBuilder) RoomId(roomId string) *PatchRoomReqBuilder { @@ -10279,7 +10279,7 @@ func (builder *PatchRoomReqBuilder) RoomId(roomId string) *PatchRoomReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值：open_id func (builder *PatchRoomReqBuilder) UserIdType(userIdType string) *PatchRoomReqBuilder { @@ -10317,17 +10317,17 @@ func (resp *PatchRoomResp) Success() bool { } type SearchRoomReqBodyBuilder struct { - customRoomIds []string // 用于查询指定会议室的租户自定义会议室ID列表，优先使用该字段进行查询 + customRoomIds []string // 用于查询指定会议室的租户自定义会议室 ID 列表，优先使用该字段进行查询 customRoomIdsFlag bool - keyword string // 会议室搜索关键词（当custom_room_ids为空时，使用该字段进行查询） + keyword string // 会议室搜索关键词（当 custom_room_ids 为空时，使用该字段进行查询） keywordFlag bool - roomLevelId string // 在该会议室层级下进行搜索（当custom_room_ids为空时，使用该字段进行查询） + roomLevelId string // 在该会议室层级下进行搜索（当 custom_room_ids 为空时，使用该字段进行查询） roomLevelIdFlag bool - searchLevelName bool // 搜索会议室是否包括层级名称（当custom_room_ids为空时，使用该字段进行查询） + searchLevelName bool // 搜索会议室是否包括层级名称（当 custom_room_ids 为空时，使用该字段进行查询） searchLevelNameFlag bool - pageSize int // 分页大小，该值默认为10，最大为100（当custom_room_ids为空时，使用该字段进行查询） + pageSize int // 分页大小，该值默认为 10，最大为 100（当 custom_room_ids 为空时，使用该字段进行查询） pageSizeFlag bool - pageToken string // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当custom_room_ids为空时，使用该字段进行查询） + pageToken string // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当 custom_room_ids 为空时，使用该字段进行查询） pageTokenFlag bool } @@ -10336,7 +10336,7 @@ func NewSearchRoomReqBodyBuilder() *SearchRoomReqBodyBuilder { return builder } -// 用于查询指定会议室的租户自定义会议室ID列表，优先使用该字段进行查询 +// 用于查询指定会议室的租户自定义会议室 ID 列表，优先使用该字段进行查询 // //示例值：["10001"] func (builder *SearchRoomReqBodyBuilder) CustomRoomIds(customRoomIds []string) *SearchRoomReqBodyBuilder { @@ -10345,7 +10345,7 @@ func (builder *SearchRoomReqBodyBuilder) CustomRoomIds(customRoomIds []string) * return builder } -// 会议室搜索关键词（当custom_room_ids为空时，使用该字段进行查询） +// 会议室搜索关键词（当 custom_room_ids 为空时，使用该字段进行查询） // //示例值：测试会议室 func (builder *SearchRoomReqBodyBuilder) Keyword(keyword string) *SearchRoomReqBodyBuilder { @@ -10354,7 +10354,7 @@ func (builder *SearchRoomReqBodyBuilder) Keyword(keyword string) *SearchRoomReqB return builder } -// 在该会议室层级下进行搜索（当custom_room_ids为空时，使用该字段进行查询） +// 在该会议室层级下进行搜索（当 custom_room_ids 为空时，使用该字段进行查询） // //示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *SearchRoomReqBodyBuilder) RoomLevelId(roomLevelId string) *SearchRoomReqBodyBuilder { @@ -10363,7 +10363,7 @@ func (builder *SearchRoomReqBodyBuilder) RoomLevelId(roomLevelId string) *Search return builder } -// 搜索会议室是否包括层级名称（当custom_room_ids为空时，使用该字段进行查询） +// 搜索会议室是否包括层级名称（当 custom_room_ids 为空时，使用该字段进行查询） // //示例值：true func (builder *SearchRoomReqBodyBuilder) SearchLevelName(searchLevelName bool) *SearchRoomReqBodyBuilder { @@ -10372,7 +10372,7 @@ func (builder *SearchRoomReqBodyBuilder) SearchLevelName(searchLevelName bool) * return builder } -// 分页大小，该值默认为10，最大为100（当custom_room_ids为空时，使用该字段进行查询） +// 分页大小，该值默认为 10，最大为 100（当 custom_room_ids 为空时，使用该字段进行查询） // //示例值：10 func (builder *SearchRoomReqBodyBuilder) PageSize(pageSize int) *SearchRoomReqBodyBuilder { @@ -10381,7 +10381,7 @@ func (builder *SearchRoomReqBodyBuilder) PageSize(pageSize int) *SearchRoomReqBo return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当custom_room_ids为空时，使用该字段进行查询） +// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当 custom_room_ids 为空时，使用该字段进行查询） // //示例值：0 func (builder *SearchRoomReqBodyBuilder) PageToken(pageToken string) *SearchRoomReqBodyBuilder { @@ -10414,17 +10414,17 @@ func (builder *SearchRoomReqBodyBuilder) Build() *SearchRoomReqBody { } type SearchRoomPathReqBodyBuilder struct { - customRoomIds []string // 用于查询指定会议室的租户自定义会议室ID列表，优先使用该字段进行查询 + customRoomIds []string // 用于查询指定会议室的租户自定义会议室 ID 列表，优先使用该字段进行查询 customRoomIdsFlag bool - keyword string // 会议室搜索关键词（当custom_room_ids为空时，使用该字段进行查询） + keyword string // 会议室搜索关键词（当 custom_room_ids 为空时，使用该字段进行查询） keywordFlag bool - roomLevelId string // 在该会议室层级下进行搜索（当custom_room_ids为空时，使用该字段进行查询） + roomLevelId string // 在该会议室层级下进行搜索（当 custom_room_ids 为空时，使用该字段进行查询） roomLevelIdFlag bool - searchLevelName bool // 搜索会议室是否包括层级名称（当custom_room_ids为空时，使用该字段进行查询） + searchLevelName bool // 搜索会议室是否包括层级名称（当 custom_room_ids 为空时，使用该字段进行查询） searchLevelNameFlag bool - pageSize int // 分页大小，该值默认为10，最大为100（当custom_room_ids为空时，使用该字段进行查询） + pageSize int // 分页大小，该值默认为 10，最大为 100（当 custom_room_ids 为空时，使用该字段进行查询） pageSizeFlag bool - pageToken string // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当custom_room_ids为空时，使用该字段进行查询） + pageToken string // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当 custom_room_ids 为空时，使用该字段进行查询） pageTokenFlag bool } @@ -10433,7 +10433,7 @@ func NewSearchRoomPathReqBodyBuilder() *SearchRoomPathReqBodyBuilder { return builder } -// 用于查询指定会议室的租户自定义会议室ID列表，优先使用该字段进行查询 +// 用于查询指定会议室的租户自定义会议室 ID 列表，优先使用该字段进行查询 // // 示例值：["10001"] func (builder *SearchRoomPathReqBodyBuilder) CustomRoomIds(customRoomIds []string) *SearchRoomPathReqBodyBuilder { @@ -10442,7 +10442,7 @@ func (builder *SearchRoomPathReqBodyBuilder) CustomRoomIds(customRoomIds []strin return builder } -// 会议室搜索关键词（当custom_room_ids为空时，使用该字段进行查询） +// 会议室搜索关键词（当 custom_room_ids 为空时，使用该字段进行查询） // // 示例值：测试会议室 func (builder *SearchRoomPathReqBodyBuilder) Keyword(keyword string) *SearchRoomPathReqBodyBuilder { @@ -10451,7 +10451,7 @@ func (builder *SearchRoomPathReqBodyBuilder) Keyword(keyword string) *SearchRoom return builder } -// 在该会议室层级下进行搜索（当custom_room_ids为空时，使用该字段进行查询） +// 在该会议室层级下进行搜索（当 custom_room_ids 为空时，使用该字段进行查询） // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *SearchRoomPathReqBodyBuilder) RoomLevelId(roomLevelId string) *SearchRoomPathReqBodyBuilder { @@ -10460,7 +10460,7 @@ func (builder *SearchRoomPathReqBodyBuilder) RoomLevelId(roomLevelId string) *Se return builder } -// 搜索会议室是否包括层级名称（当custom_room_ids为空时，使用该字段进行查询） +// 搜索会议室是否包括层级名称（当 custom_room_ids 为空时，使用该字段进行查询） // // 示例值：true func (builder *SearchRoomPathReqBodyBuilder) SearchLevelName(searchLevelName bool) *SearchRoomPathReqBodyBuilder { @@ -10469,7 +10469,7 @@ func (builder *SearchRoomPathReqBodyBuilder) SearchLevelName(searchLevelName boo return builder } -// 分页大小，该值默认为10，最大为100（当custom_room_ids为空时，使用该字段进行查询） +// 分页大小，该值默认为 10，最大为 100（当 custom_room_ids 为空时，使用该字段进行查询） // // 示例值：10 func (builder *SearchRoomPathReqBodyBuilder) PageSize(pageSize int) *SearchRoomPathReqBodyBuilder { @@ -10478,7 +10478,7 @@ func (builder *SearchRoomPathReqBodyBuilder) PageSize(pageSize int) *SearchRoomP return builder } -// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当custom_room_ids为空时，使用该字段进行查询） +// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当 custom_room_ids 为空时，使用该字段进行查询） // // 示例值：0 func (builder *SearchRoomPathReqBodyBuilder) PageToken(pageToken string) *SearchRoomPathReqBodyBuilder { @@ -10524,7 +10524,7 @@ func NewSearchRoomReqBuilder() *SearchRoomReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *SearchRoomReqBuilder) UserIdType(userIdType string) *SearchRoomReqBuilder { @@ -10532,7 +10532,7 @@ func (builder *SearchRoomReqBuilder) UserIdType(userIdType string) *SearchRoomRe return builder } -// 该接口可以用来搜索会议室，支持使用关键词进行搜索，也支持使用自定义会议室ID进行查询 +// 该接口可以用来搜索会议室，支持使用关键词进行搜索，也支持使用自定义会议室 ID 进行查询 func (builder *SearchRoomReqBuilder) Body(body *SearchRoomReqBody) *SearchRoomReqBuilder { builder.body = body return builder @@ -10547,12 +10547,12 @@ func (builder *SearchRoomReqBuilder) Build() *SearchRoomReq { } type SearchRoomReqBody struct { - CustomRoomIds []string `json:"custom_room_ids,omitempty"` // 用于查询指定会议室的租户自定义会议室ID列表，优先使用该字段进行查询 - Keyword *string `json:"keyword,omitempty"` // 会议室搜索关键词（当custom_room_ids为空时，使用该字段进行查询） - RoomLevelId *string `json:"room_level_id,omitempty"` // 在该会议室层级下进行搜索（当custom_room_ids为空时，使用该字段进行查询） - SearchLevelName *bool `json:"search_level_name,omitempty"` // 搜索会议室是否包括层级名称（当custom_room_ids为空时，使用该字段进行查询） - PageSize *int `json:"page_size,omitempty"` // 分页大小，该值默认为10，最大为100（当custom_room_ids为空时，使用该字段进行查询） - PageToken *string `json:"page_token,omitempty"` // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当custom_room_ids为空时，使用该字段进行查询） + CustomRoomIds []string `json:"custom_room_ids,omitempty"` // 用于查询指定会议室的租户自定义会议室 ID 列表，优先使用该字段进行查询 + Keyword *string `json:"keyword,omitempty"` // 会议室搜索关键词（当 custom_room_ids 为空时，使用该字段进行查询） + RoomLevelId *string `json:"room_level_id,omitempty"` // 在该会议室层级下进行搜索（当 custom_room_ids 为空时，使用该字段进行查询） + SearchLevelName *bool `json:"search_level_name,omitempty"` // 搜索会议室是否包括层级名称（当 custom_room_ids 为空时，使用该字段进行查询） + PageSize *int `json:"page_size,omitempty"` // 分页大小，该值默认为 10，最大为 100（当 custom_room_ids 为空时，使用该字段进行查询） + PageToken *string `json:"page_token,omitempty"` // 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当 custom_room_ids 为空时，使用该字段进行查询） } type SearchRoomReq struct { @@ -10562,7 +10562,7 @@ type SearchRoomReq struct { type SearchRoomRespData struct { Rooms []*Room `json:"rooms,omitempty"` // 会议室列表 - PageToken *string `json:"page_token,omitempty"` // 下一页分页的token，下次请求时传入 + PageToken *string `json:"page_token,omitempty"` // 下一页分页的 token，下次请求时传入 HasMore *bool `json:"has_more,omitempty"` // 是否还有数据 } @@ -10597,7 +10597,7 @@ func (builder *QueryRoomConfigReqBuilder) Scope(scope int) *QueryRoomConfigReqBu return builder } -// 国家/地区ID scope为2，3时需要此参数 +// 国家/地区 ID scope 为 2，3 时需要此参数 // // 示例值：1 func (builder *QueryRoomConfigReqBuilder) CountryId(countryId string) *QueryRoomConfigReqBuilder { @@ -10605,7 +10605,7 @@ func (builder *QueryRoomConfigReqBuilder) CountryId(countryId string) *QueryRoom return builder } -// 城市ID scope为3时需要此参数 +// 城市 ID scope 为 3 时需要此参数 // // 示例值：2 func (builder *QueryRoomConfigReqBuilder) DistrictId(districtId string) *QueryRoomConfigReqBuilder { @@ -10613,7 +10613,7 @@ func (builder *QueryRoomConfigReqBuilder) DistrictId(districtId string) *QueryRo return builder } -// 建筑ID scope为4，5时需要此参数 +// 建筑 ID scope 为 4，5 时需要此参数 // // 示例值：3 func (builder *QueryRoomConfigReqBuilder) BuildingId(buildingId string) *QueryRoomConfigReqBuilder { @@ -10621,7 +10621,7 @@ func (builder *QueryRoomConfigReqBuilder) BuildingId(buildingId string) *QueryRo return builder } -// 楼层 scope为5时需要此参数 +// 楼层 scope 为 5 时需要此参数 // // 示例值：4 func (builder *QueryRoomConfigReqBuilder) FloorName(floorName string) *QueryRoomConfigReqBuilder { @@ -10629,7 +10629,7 @@ func (builder *QueryRoomConfigReqBuilder) FloorName(floorName string) *QueryRoom return builder } -// 会议室ID scope为6时需要此参数 +// 会议室 ID scope 为 6 时需要此参数 // // 示例值：6383786266263 func (builder *QueryRoomConfigReqBuilder) RoomId(roomId string) *QueryRoomConfigReqBuilder { @@ -10637,7 +10637,7 @@ func (builder *QueryRoomConfigReqBuilder) RoomId(roomId string) *QueryRoomConfig return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *QueryRoomConfigReqBuilder) UserIdType(userIdType string) *QueryRoomConfigReqBuilder { @@ -10677,15 +10677,15 @@ func (resp *QueryRoomConfigResp) Success() bool { type SetRoomConfigReqBodyBuilder struct { scope int // 设置节点范围 scopeFlag bool - countryId string // 国家/地区ID scope为2，3时需要此参数 + countryId string // 国家/地区 ID scope 为 2，3 时需要此参数 countryIdFlag bool - districtId string // 城市ID scope为3时需要此参数 + districtId string // 城市 ID scope 为 3 时需要此参数 districtIdFlag bool - buildingId string // 建筑ID scope为4，5时需要此参数 + buildingId string // 建筑 ID scope 为 4，5 时需要此参数 buildingIdFlag bool - floorName string // 楼层 scope为5时需要此参数 + floorName string // 楼层 scope 为 5 时需要此参数 floorNameFlag bool - roomId string // 会议室ID scope为6时需要此参数 + roomId string // 会议室 ID scope 为 6 时需要此参数 roomIdFlag bool roomConfig *RoomConfig // 会议室设置 roomConfigFlag bool @@ -10705,7 +10705,7 @@ func (builder *SetRoomConfigReqBodyBuilder) Scope(scope int) *SetRoomConfigReqBo return builder } -// 国家/地区ID scope为2，3时需要此参数 +// 国家/地区 ID scope 为 2，3 时需要此参数 // //示例值：1 func (builder *SetRoomConfigReqBodyBuilder) CountryId(countryId string) *SetRoomConfigReqBodyBuilder { @@ -10714,7 +10714,7 @@ func (builder *SetRoomConfigReqBodyBuilder) CountryId(countryId string) *SetRoom return builder } -// 城市ID scope为3时需要此参数 +// 城市 ID scope 为 3 时需要此参数 // //示例值：2 func (builder *SetRoomConfigReqBodyBuilder) DistrictId(districtId string) *SetRoomConfigReqBodyBuilder { @@ -10723,7 +10723,7 @@ func (builder *SetRoomConfigReqBodyBuilder) DistrictId(districtId string) *SetRo return builder } -// 建筑ID scope为4，5时需要此参数 +// 建筑 ID scope 为 4，5 时需要此参数 // //示例值：3 func (builder *SetRoomConfigReqBodyBuilder) BuildingId(buildingId string) *SetRoomConfigReqBodyBuilder { @@ -10732,7 +10732,7 @@ func (builder *SetRoomConfigReqBodyBuilder) BuildingId(buildingId string) *SetRo return builder } -// 楼层 scope为5时需要此参数 +// 楼层 scope 为 5 时需要此参数 // //示例值：4 func (builder *SetRoomConfigReqBodyBuilder) FloorName(floorName string) *SetRoomConfigReqBodyBuilder { @@ -10741,7 +10741,7 @@ func (builder *SetRoomConfigReqBodyBuilder) FloorName(floorName string) *SetRoom return builder } -// 会议室ID scope为6时需要此参数 +// 会议室 ID scope 为 6 时需要此参数 // //示例值：67687262867363 func (builder *SetRoomConfigReqBodyBuilder) RoomId(roomId string) *SetRoomConfigReqBodyBuilder { @@ -10788,15 +10788,15 @@ func (builder *SetRoomConfigReqBodyBuilder) Build() *SetRoomConfigReqBody { type SetRoomConfigPathReqBodyBuilder struct { scope int // 设置节点范围 scopeFlag bool - countryId string // 国家/地区ID scope为2，3时需要此参数 + countryId string // 国家/地区 ID scope 为 2，3 时需要此参数 countryIdFlag bool - districtId string // 城市ID scope为3时需要此参数 + districtId string // 城市 ID scope 为 3 时需要此参数 districtIdFlag bool - buildingId string // 建筑ID scope为4，5时需要此参数 + buildingId string // 建筑 ID scope 为 4，5 时需要此参数 buildingIdFlag bool - floorName string // 楼层 scope为5时需要此参数 + floorName string // 楼层 scope 为 5 时需要此参数 floorNameFlag bool - roomId string // 会议室ID scope为6时需要此参数 + roomId string // 会议室 ID scope 为 6 时需要此参数 roomIdFlag bool roomConfig *RoomConfig // 会议室设置 roomConfigFlag bool @@ -10816,7 +10816,7 @@ func (builder *SetRoomConfigPathReqBodyBuilder) Scope(scope int) *SetRoomConfigP return builder } -// 国家/地区ID scope为2，3时需要此参数 +// 国家/地区 ID scope 为 2，3 时需要此参数 // // 示例值：1 func (builder *SetRoomConfigPathReqBodyBuilder) CountryId(countryId string) *SetRoomConfigPathReqBodyBuilder { @@ -10825,7 +10825,7 @@ func (builder *SetRoomConfigPathReqBodyBuilder) CountryId(countryId string) *Set return builder } -// 城市ID scope为3时需要此参数 +// 城市 ID scope 为 3 时需要此参数 // // 示例值：2 func (builder *SetRoomConfigPathReqBodyBuilder) DistrictId(districtId string) *SetRoomConfigPathReqBodyBuilder { @@ -10834,7 +10834,7 @@ func (builder *SetRoomConfigPathReqBodyBuilder) DistrictId(districtId string) *S return builder } -// 建筑ID scope为4，5时需要此参数 +// 建筑 ID scope 为 4，5 时需要此参数 // // 示例值：3 func (builder *SetRoomConfigPathReqBodyBuilder) BuildingId(buildingId string) *SetRoomConfigPathReqBodyBuilder { @@ -10843,7 +10843,7 @@ func (builder *SetRoomConfigPathReqBodyBuilder) BuildingId(buildingId string) *S return builder } -// 楼层 scope为5时需要此参数 +// 楼层 scope 为 5 时需要此参数 // // 示例值：4 func (builder *SetRoomConfigPathReqBodyBuilder) FloorName(floorName string) *SetRoomConfigPathReqBodyBuilder { @@ -10852,7 +10852,7 @@ func (builder *SetRoomConfigPathReqBodyBuilder) FloorName(floorName string) *Set return builder } -// 会议室ID scope为6时需要此参数 +// 会议室 ID scope 为 6 时需要此参数 // // 示例值：67687262867363 func (builder *SetRoomConfigPathReqBodyBuilder) RoomId(roomId string) *SetRoomConfigPathReqBodyBuilder { @@ -10910,7 +10910,7 @@ func NewSetRoomConfigReqBuilder() *SetRoomConfigReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *SetRoomConfigReqBuilder) UserIdType(userIdType string) *SetRoomConfigReqBuilder { @@ -10934,11 +10934,11 @@ func (builder *SetRoomConfigReqBuilder) Build() *SetRoomConfigReq { type SetRoomConfigReqBody struct { Scope *int `json:"scope,omitempty"` // 设置节点范围 - CountryId *string `json:"country_id,omitempty"` // 国家/地区ID scope为2，3时需要此参数 - DistrictId *string `json:"district_id,omitempty"` // 城市ID scope为3时需要此参数 - BuildingId *string `json:"building_id,omitempty"` // 建筑ID scope为4，5时需要此参数 - FloorName *string `json:"floor_name,omitempty"` // 楼层 scope为5时需要此参数 - RoomId *string `json:"room_id,omitempty"` // 会议室ID scope为6时需要此参数 + CountryId *string `json:"country_id,omitempty"` // 国家/地区 ID scope 为 2，3 时需要此参数 + DistrictId *string `json:"district_id,omitempty"` // 城市 ID scope 为 3 时需要此参数 + BuildingId *string `json:"building_id,omitempty"` // 建筑 ID scope 为 4，5 时需要此参数 + FloorName *string `json:"floor_name,omitempty"` // 楼层 scope 为 5 时需要此参数 + RoomId *string `json:"room_id,omitempty"` // 会议室 ID scope 为 6 时需要此参数 RoomConfig *RoomConfig `json:"room_config,omitempty"` // 会议室设置 } @@ -11003,7 +11003,7 @@ func (resp *CreateRoomLevelResp) Success() bool { } type DelRoomLevelReqBodyBuilder struct { - roomLevelId string // 层级ID + roomLevelId string // 层级 ID roomLevelIdFlag bool deleteChild bool // 是否删除所有子层级 deleteChildFlag bool @@ -11014,7 +11014,7 @@ func NewDelRoomLevelReqBodyBuilder() *DelRoomLevelReqBodyBuilder { return builder } -// 层级ID +// 层级 ID // //示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *DelRoomLevelReqBodyBuilder) RoomLevelId(roomLevelId string) *DelRoomLevelReqBodyBuilder { @@ -11044,7 +11044,7 @@ func (builder *DelRoomLevelReqBodyBuilder) Build() *DelRoomLevelReqBody { } type DelRoomLevelPathReqBodyBuilder struct { - roomLevelId string // 层级ID + roomLevelId string // 层级 ID roomLevelIdFlag bool deleteChild bool // 是否删除所有子层级 deleteChildFlag bool @@ -11055,7 +11055,7 @@ func NewDelRoomLevelPathReqBodyBuilder() *DelRoomLevelPathReqBodyBuilder { return builder } -// 层级ID +// 层级 ID // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *DelRoomLevelPathReqBodyBuilder) RoomLevelId(roomLevelId string) *DelRoomLevelPathReqBodyBuilder { @@ -11112,7 +11112,7 @@ func (builder *DelRoomLevelReqBuilder) Build() *DelRoomLevelReq { } type DelRoomLevelReqBody struct { - RoomLevelId *string `json:"room_level_id,omitempty"` // 层级ID + RoomLevelId *string `json:"room_level_id,omitempty"` // 层级 ID DeleteChild *bool `json:"delete_child,omitempty"` // 是否删除所有子层级 } @@ -11143,7 +11143,7 @@ func NewGetRoomLevelReqBuilder() *GetRoomLevelReqBuilder { return builder } -// 层级ID，查询租户层级可传0 +// 层级 ID，查询租户层级可传 0 // // 示例值：omb_57c9cc7d9a81e27e54c8fabfd02759e7 func (builder *GetRoomLevelReqBuilder) RoomLevelId(roomLevelId string) *GetRoomLevelReqBuilder { @@ -11196,7 +11196,7 @@ func (builder *ListRoomLevelReqBuilder) Limit(limit int) *ListRoomLevelReqBuilde return builder } -// 层级ID，当需要获取租户下层级列表时，room_level_id可传空 +// 层级 ID，当需要获取租户下层级列表时，room_level_id 可传空 // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *ListRoomLevelReqBuilder) RoomLevelId(roomLevelId string) *ListRoomLevelReqBuilder { @@ -11212,7 +11212,7 @@ func (builder *ListRoomLevelReqBuilder) PageSize(pageSize int) *ListRoomLevelReq return builder } -// 分页标记,第一次请求不填,表示从头开始遍历.下次遍历可采用该 page_token获取查询结果 +// 分页标记，第一次请求不填，表示从头开始遍历。下次遍历可采用该 page_token 获取查询结果 // // 示例值： func (builder *ListRoomLevelReqBuilder) PageToken(pageToken string) *ListRoomLevelReqBuilder { @@ -11251,7 +11251,7 @@ func (resp *ListRoomLevelResp) Success() bool { } type MgetRoomLevelReqBodyBuilder struct { - levelIds []string // 层级ID列表 + levelIds []string // 层级 ID 列表 levelIdsFlag bool } @@ -11260,7 +11260,7 @@ func NewMgetRoomLevelReqBodyBuilder() *MgetRoomLevelReqBodyBuilder { return builder } -// 层级ID列表 +// 层级 ID 列表 // //示例值：["omb_4ad1a2c7a2fbc5fc9570f38456931293"] func (builder *MgetRoomLevelReqBodyBuilder) LevelIds(levelIds []string) *MgetRoomLevelReqBodyBuilder { @@ -11278,7 +11278,7 @@ func (builder *MgetRoomLevelReqBodyBuilder) Build() *MgetRoomLevelReqBody { } type MgetRoomLevelPathReqBodyBuilder struct { - levelIds []string // 层级ID列表 + levelIds []string // 层级 ID 列表 levelIdsFlag bool } @@ -11287,7 +11287,7 @@ func NewMgetRoomLevelPathReqBodyBuilder() *MgetRoomLevelPathReqBodyBuilder { return builder } -// 层级ID列表 +// 层级 ID 列表 // // 示例值：["omb_4ad1a2c7a2fbc5fc9570f38456931293"] func (builder *MgetRoomLevelPathReqBodyBuilder) LevelIds(levelIds []string) *MgetRoomLevelPathReqBodyBuilder { @@ -11318,7 +11318,7 @@ func NewMgetRoomLevelReqBuilder() *MgetRoomLevelReqBuilder { return builder } -// 该接口可以使用会议室层级ID批量查询会议室层级详情 +// 该接口可以使用会议室层级 ID 批量查询会议室层级详情 func (builder *MgetRoomLevelReqBuilder) Body(body *MgetRoomLevelReqBody) *MgetRoomLevelReqBuilder { builder.body = body return builder @@ -11332,7 +11332,7 @@ func (builder *MgetRoomLevelReqBuilder) Build() *MgetRoomLevelReq { } type MgetRoomLevelReqBody struct { - LevelIds []string `json:"level_ids,omitempty"` // 层级ID列表 + LevelIds []string `json:"level_ids,omitempty"` // 层级 ID 列表 } type MgetRoomLevelReq struct { @@ -11368,7 +11368,7 @@ func NewPatchRoomLevelReqBuilder() *PatchRoomLevelReqBuilder { return builder } -// 层级ID +// 层级 ID // // 示例值：omb_4ad1a2c7a2fbc5fc9570f38456931293 func (builder *PatchRoomLevelReqBuilder) RoomLevelId(roomLevelId string) *PatchRoomLevelReqBuilder { @@ -11417,7 +11417,7 @@ func NewSearchRoomLevelReqBuilder() *SearchRoomLevelReqBuilder { return builder } -// 用于查询指定会议室层级的自定义会议室层级ID +// 用于查询指定会议室层级的自定义会议室层级 ID // // 示例值：1000,1001 func (builder *SearchRoomLevelReqBuilder) CustomLevelIds(customLevelIds string) *SearchRoomLevelReqBuilder { @@ -11437,7 +11437,7 @@ type SearchRoomLevelReq struct { } type SearchRoomLevelRespData struct { - LevelIds []string `json:"level_ids,omitempty"` // 层级ID列表 + LevelIds []string `json:"level_ids,omitempty"` // 层级 ID 列表 } type SearchRoomLevelResp struct { @@ -11464,7 +11464,7 @@ func NewCreateScopeConfigReqBuilder() *CreateScopeConfigReqBuilder { return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值：open_id func (builder *CreateScopeConfigReqBuilder) UserIdType(userIdType string) *CreateScopeConfigReqBuilder { @@ -11521,7 +11521,7 @@ func (builder *GetScopeConfigReqBuilder) ScopeType(scopeType int) *GetScopeConfi return builder } -// 查询节点ID：如果scope_type为1，则为层级ID，如果scope_type为2，则为会议室ID +// 查询节点 ID：如果 scope_type 为 1，则为层级 ID，如果 scope_type 为 2，则为会议室 ID // // 示例值：omm_608d34d82d531b27fa993902d350a307 func (builder *GetScopeConfigReqBuilder) ScopeId(scopeId string) *GetScopeConfigReqBuilder { @@ -11529,7 +11529,7 @@ func (builder *GetScopeConfigReqBuilder) ScopeId(scopeId string) *GetScopeConfig return builder } -// 此次调用中使用的用户ID的类型，默认使用open_id可不填 +// 此次调用中使用的用户 ID 的类型，默认使用 open_id 可不填 // // 示例值： func (builder *GetScopeConfigReqBuilder) UserIdType(userIdType string) *GetScopeConfigReqBuilder { @@ -11672,7 +11672,7 @@ func (m *P2MeetingRecordingEndedV1) RawReq(req *larkevent.EventReq) { type P2MeetingRecordingReadyV1Data struct { Meeting *MeetingEventMeeting `json:"meeting,omitempty"` // 会议数据 Url *string `json:"url,omitempty"` // 会议录制链接 - Duration *string `json:"duration,omitempty"` // 录制总时长（单位msec） + Duration *string `json:"duration,omitempty"` // 录制总时长（单位 msec） } type P2MeetingRecordingReadyV1 struct { @@ -11731,8 +11731,8 @@ func (m *P2MeetingShareStartedV1) RawReq(req *larkevent.EventReq) { } type P2ReserveConfigUpdatedV1Data struct { - ScopeId *string `json:"scope_id,omitempty"` // 会议室或层级id - ScopeType *int `json:"scope_type,omitempty"` // 1代表层级，2代表会议室 + ScopeId *string `json:"scope_id,omitempty"` // 会议室或层级 id + ScopeType *int `json:"scope_type,omitempty"` // 1 代表层级，2 代表会议室 ApproveConfig *ApprovalConfigEvent `json:"approve_config,omitempty"` // 预定审批设置 TimeConfig *TimeConfig `json:"time_config,omitempty"` // 预定时间设置 ReserveScopeConfig *ReserveScopeConfigEvent `json:"reserve_scope_config,omitempty"` // 预定范围设置 @@ -11805,7 +11805,7 @@ func (m *P2RoomLevelCreatedV1) RawReq(req *larkevent.EventReq) { } type P2RoomLevelDeletedV1Data struct { - RoomLevelId *string `json:"room_level_id,omitempty"` // 层级ID + RoomLevelId *string `json:"room_level_id,omitempty"` // 层级 ID DeleteChild *bool `json:"delete_child,omitempty"` // 是否删除所有子层级 } @@ -11851,7 +11851,7 @@ func (iterator *ListByNoMeetingIterator) Next() (bool, *Meeting, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11905,7 +11905,7 @@ func (iterator *GetMeetingListIterator) Next() (bool, *MeetingInfo, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -11959,7 +11959,7 @@ func (iterator *GetParticipantListIterator) Next() (bool, *Participant, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -12013,7 +12013,7 @@ func (iterator *GetParticipantQualityListIterator) Next() (bool, *ParticipantQua return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -12067,7 +12067,7 @@ func (iterator *GetResourceReservationListIterator) Next() (bool, *RoomMeetingRe return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -12121,7 +12121,7 @@ func (iterator *ListRoomIterator) Next() (bool, *Room, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -12175,7 +12175,7 @@ func (iterator *ListRoomLevelIterator) Next() (bool, *RoomLevel, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil diff --git a/service/wiki/v2/api.go b/service/wiki/v2/api.go index c5a690d3..d5874ee0 100644 --- a/service/wiki/v2/api.go +++ b/service/wiki/v2/api.go @@ -59,11 +59,11 @@ type task struct { // // - 此接口用于创建知识空间 // -// - 此接口不支持tenant access token（应用身份访问） +// - 此接口不支持 tenant access token（应用身份访问） // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/create_space.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/create_space.go func (s *space) Create(ctx context.Context, req *CreateSpaceReq, options ...larkcore.RequestOptionFunc) (*CreateSpaceResp, error) { // 发起请求 apiReq := req.apiReq @@ -85,13 +85,13 @@ func (s *space) Create(ctx context.Context, req *CreateSpaceReq, options ...lark // 获取知识空间信息 // -// - 此接口用于根据知识空间ID来查询知识空间的信息。;;空间类型（type）：;- 个人空间：归个人管理。一人仅可拥有一个个人空间，无法添加其他管理员。;- 团队空间：归团队（多人)管理，可添加多个管理员。;;空间可见性（visibility）：;- 公开空间：租户所有用户可见，默认为成员权限。无法额外添加成员，但可以添加管理员。;- 私有空间：仅对知识空间管理员、成员可见，需要手动添加管理员、成员。 +// - 此接口用于根据知识空间 ID 来查询知识空间的信息。;;空间类型（type）：;- 个人空间：归个人管理。一人仅可拥有一个个人空间，无法添加其他管理员。;- 团队空间：归团队（多人) 管理，可添加多个管理员。;;空间可见性（visibility）：;- 公开空间：租户所有用户可见，默认为成员权限。无法额外添加成员，但可以添加管理员。;- 私有空间：仅对知识空间管理员、成员可见，需要手动添加管理员、成员。 // // - 本接口要求知识库权限：;- 需要为知识空间成员（管理员） // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/get_space.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/get_space.go func (s *space) Get(ctx context.Context, req *GetSpaceReq, options ...larkcore.RequestOptionFunc) (*GetSpaceResp, error) { // 发起请求 apiReq := req.apiReq @@ -117,9 +117,9 @@ func (s *space) Get(ctx context.Context, req *GetSpaceReq, options ...larkcore.R // // - 知识库权限要求，当前使用的 access token 所代表的应用或用户拥有：;- 节点阅读权限 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/getNode_space.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/getNode_space.go func (s *space) GetNode(ctx context.Context, req *GetNodeSpaceReq, options ...larkcore.RequestOptionFunc) (*GetNodeSpaceResp, error) { // 发起请求 apiReq := req.apiReq @@ -141,13 +141,13 @@ func (s *space) GetNode(ctx context.Context, req *GetNodeSpaceReq, options ...la // 获取知识空间列表 // -// - 此接口用于获取有权限访问的知识空间列表。;;此接口为分页接口。由于权限过滤，可能返回列表为空，但分页标记（has_more）为true，可以继续分页请求。;;对于知识空间各项属性描述请参阅[获取知识空间信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get) +// - 此接口用于获取有权限访问的知识空间列表。;;此接口为分页接口。由于权限过滤，可能返回列表为空，但分页标记（has_more）为 true，可以继续分页请求。;;对于知识空间各项属性描述请参阅 [获取知识空间信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get) // -// - 使用tenant access token调用时，请确认应用/机器人拥有部分知识空间的访问权限，否则返回列表容易为空。 +// - 使用 tenant access token 调用时，请确认应用/机器人拥有部分知识空间的访问权限，否则返回列表容易为空。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/list_space.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/list_space.go func (s *space) List(ctx context.Context, req *ListSpaceReq, options ...larkcore.RequestOptionFunc) (*ListSpaceResp, error) { // 发起请求 apiReq := req.apiReq @@ -179,11 +179,11 @@ func (s *space) ListByIterator(ctx context.Context, req *ListSpaceReq, options . // // - 添加知识空间成员或管理员。 // -// - 知识空间具有[类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)和[可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)的概念。不同的类型或可见性可以对本操作做出限制：;- 可见性限制：公开知识空间（visibility为public）对租户所有用户可见，因此不支持再添加成员，但可以添加管理员。;- 类型限制：个人知识空间 （type为person）为个人管理的知识空间，不支持添加其他管理员（包括应用/机器人）。但可以添加成员。;;;知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：;- 为知识空间管理员 +// - 知识空间具有 [类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview) 和 [可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview) 的概念。不同的类型或可见性可以对本操作做出限制：;- 可见性限制：公开知识空间（visibility 为 public）对租户所有用户可见，因此不支持再添加成员，但可以添加管理员。;- 类型限制：个人知识空间（type 为 person）为个人管理的知识空间，不支持添加其他管理员（包括应用/机器人）。但可以添加成员。;;;知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：;- 为知识空间管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-member/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-member/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/create_spaceMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/create_spaceMember.go func (s *spaceMember) Create(ctx context.Context, req *CreateSpaceMemberReq, options ...larkcore.RequestOptionFunc) (*CreateSpaceMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -207,11 +207,11 @@ func (s *spaceMember) Create(ctx context.Context, req *CreateSpaceMemberReq, opt // // - 此接口用于删除知识空间成员或管理员。 // -// - 知识空间具有[类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)和[可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)的概念。不同的类型或可见性可以对本操作做出限制：;- 可见性限制：公开知识空间（visibility为public）对租户所有用户可见，因此不支持再删除成员，但可以删除管理员。;- 类型限制：个人知识空间 （type为person）为个人管理的知识空间，不支持删除管理员。但可以删除成员。;;;知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：;- 为知识空间管理员 +// - 知识空间具有 [类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview) 和 [可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview) 的概念。不同的类型或可见性可以对本操作做出限制：;- 可见性限制：公开知识空间（visibility 为 public）对租户所有用户可见，因此不支持再删除成员，但可以删除管理员。;- 类型限制：个人知识空间（type 为 person）为个人管理的知识空间，不支持删除管理员。但可以删除成员。;;;知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：;- 为知识空间管理员 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-member/delete +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-member/delete // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/delete_spaceMember.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/delete_spaceMember.go func (s *spaceMember) Delete(ctx context.Context, req *DeleteSpaceMemberReq, options ...larkcore.RequestOptionFunc) (*DeleteSpaceMemberResp, error) { // 发起请求 apiReq := req.apiReq @@ -235,9 +235,9 @@ func (s *spaceMember) Delete(ctx context.Context, req *DeleteSpaceMemberReq, opt // // - 此接口用于在知识空间创建节点副本到指定位置。 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/copy +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/copy // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/copy_spaceNode.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/copy_spaceNode.go func (s *spaceNode) Copy(ctx context.Context, req *CopySpaceNodeReq, options ...larkcore.RequestOptionFunc) (*CopySpaceNodeResp, error) { // 发起请求 apiReq := req.apiReq @@ -259,13 +259,13 @@ func (s *spaceNode) Copy(ctx context.Context, req *CopySpaceNodeReq, options ... // 创建知识空间节点 // -// - 此接口用于在知识节点里创建[节点](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)到指定位置。 +// - 此接口用于在知识节点里创建 [节点](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview) 到指定位置。 // -// - 知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：;- **父节点**容器编辑权限 +// - 知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：;- ** 父节点 ** 容器编辑权限 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/create +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/create // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/create_spaceNode.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/create_spaceNode.go func (s *spaceNode) Create(ctx context.Context, req *CreateSpaceNodeReq, options ...larkcore.RequestOptionFunc) (*CreateSpaceNodeResp, error) { // 发起请求 apiReq := req.apiReq @@ -287,13 +287,13 @@ func (s *spaceNode) Create(ctx context.Context, req *CreateSpaceNodeReq, options // 获取知识空间子节点列表 // -// - 此接口用于分页获取Wiki节点的子节点列表。;;此接口为分页接口。由于权限过滤，可能返回列表为空，但分页标记（has_more）为true，可以继续分页请求。 +// - 此接口用于分页获取 Wiki 节点的子节点列表。;;此接口为分页接口。由于权限过滤，可能返回列表为空，但分页标记（has_more）为 true，可以继续分页请求。 // // - 知识库权限要求，当前使用的 access token 所代表的应用或用户拥有：;- 父节点阅读权限 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/list +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/list // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/list_spaceNode.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/list_spaceNode.go func (s *spaceNode) List(ctx context.Context, req *ListSpaceNodeReq, options ...larkcore.RequestOptionFunc) (*ListSpaceNodeResp, error) { // 发起请求 apiReq := req.apiReq @@ -323,13 +323,13 @@ func (s *spaceNode) ListByIterator(ctx context.Context, req *ListSpaceNodeReq, o // 移动知识空间节点 // -// - 此方法用于在Wiki内移动节点，支持跨知识空间移动。如果有子节点，会携带子节点一起移动。 +// - 此方法用于在 Wiki 内移动节点，支持跨知识空间移动。如果有子节点，会携带子节点一起移动。 // // - 知识库权限要求：;- 节点编辑权限;- 原父节点容器编辑权限;- 目的父节点容器编辑权限 // -// - 官网API文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/move +// - 官网 API 文档链接:https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/move // -// - 使用Demo链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/move_spaceNode.go +// - 使用 Demo 链接:https://github.com/larksuite/oapi-sdk-go/tree/v3_main/sample/apiall/wikiv2/move_spaceNode.go func (s *spaceNode) Move(ctx context.Context, req *MoveSpaceNodeReq, options ...larkcore.RequestOptionFunc) (*MoveSpaceNodeResp, error) { // 发起请求 apiReq := req.apiReq @@ -353,13 +353,13 @@ func (s *spaceNode) Move(ctx context.Context, req *MoveSpaceNodeReq, options ... // // - 该接口允许移动云空间文档至知识空间，并挂载在指定位置 // -// - ### 移动操作 ###;移动后，文档将从“我的空间”或“共享空间”转移至“知识库”后，无法从下列入口查看到文档：;- 云空间主页：快速访问;- 我的空间;- 共享空间;;### 权限变更 ###;移动后，文档会向所有可查看“页面树”的用户显示，默认继承父页面的权限设置。;= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil @@ -2129,7 +2129,7 @@ func (iterator *ListSpaceNodeIterator) Next() (bool, *Node, error) { return false, nil, nil } - // 为0则拉取数据 + // 为 0 则拉取数据 if iterator.index == 0 || iterator.index >= len(iterator.items) { if iterator.index != 0 && iterator.nextPageToken == nil { return false, nil, nil