From c78974206dc6700d269dfcc76aa3cf687c1d2e5f Mon Sep 17 00:00:00 2001 From: "Vicente.Yu" <^@^> Date: Tue, 7 Nov 2023 16:27:36 +0800 Subject: [PATCH] =?UTF-8?q?=E6=97=A5=E5=B8=B8=E6=9B=B4=E6=96=B0=20Signed-o?= =?UTF-8?q?ff-by:=20Vicente.Yu=20<^@^>?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...TablesByTableIdFormsByFormIdResponseDto.cs | 2 +- ...TablesByTableIdFormsByFormIdResponseDto.cs | 2 +- src/Base/PostBitableV1AppsBodyDto.cs | 2 +- .../PostBitableV1AppsByAppTokenCopyBodyDto.cs | 2 +- ...tBitableV1AppsByAppTokenCopyResponseDto.cs | 4 +-- ...ablesByTableIdRecordsBatchDeleteBodyDto.cs | 2 +- ...ByAppTokenTablesByTableIdRecordsBodyDto.cs | 2 +- ...tsBySpreadsheetTokenValuesAppendBodyDto.cs | 2 +- ...preadsheetTokenValuesBatchUpdateBodyDto.cs | 2 +- ...sBySpreadsheetTokenValuesPrependBodyDto.cs | 2 +- ...adsheetsBySpreadsheetTokenValuesBodyDto.cs | 2 +- ...eadsheetTokenSheetsBySheetIdFindBodyDto.cs | 2 +- src/FeishuNetSdk.csproj | 2 +- ...pdeskV1TicketsByTicketIdMessagesBodyDto.cs | 2 +- src/IFeishuTenantApi.cs | 33 +++++++------------ src/Im/GetImV1ChatsResponseDto.cs | 2 +- src/Im/GetImV1ChatsSearchResponseDto.cs | 2 +- src/Im/PostImV1FilesBodyDto.cs | 2 +- src/Task/PatchTaskV1TasksByTaskIdBodyDto.cs | 19 ++++++++--- .../PatchTaskV1TasksByTaskIdResponseDto.cs | 19 ++++++++--- ...TasksByTaskIdBatchDeleteFollowerBodyDto.cs | 2 +- ...PostTaskV1TasksByTaskIdFollowersBodyDto.cs | 2 +- ...TaskV1TasksByTaskIdFollowersResponseDto.cs | 2 +- .../GetVcV1ReservesByReserveIdResponseDto.cs | 4 +-- src/Vc/PostVcV1ReservesApplyBodyDto.cs | 2 +- src/Vc/PutVcV1ReservesByReserveIdBodyDto.cs | 4 +-- 26 files changed, 66 insertions(+), 57 deletions(-) diff --git a/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs b/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs index 98ee70d6..aa1e5584 100644 --- a/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs +++ b/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs @@ -48,7 +48,7 @@ public record AppTableForm /// /// 分享 URL /// 必填：否 - /// 示例值：https://bytedance.feishu.cn/share/base/shrcnCy1KAlpahNotmhRn1abcde + /// 示例值：https://example.feishu.cn/share/base/shrcnCy1KAlpahNotmhRn1abcde /// [JsonProperty("shared_url")] public string? SharedUrl { get; set; } diff --git a/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs index b40ed92f..f2a8f676 100644 --- a/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs +++ b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdResponseDto.cs @@ -48,7 +48,7 @@ public record AppTableForm /// /// 分享 URL /// 必填：否 - /// 示例值：https://bytedance.feishu.cn/share/base/shrcnCy1KAlpahNotmhRn1abcde + /// 示例值：https://example.feishu.cn/share/base/shrcnCy1KAlpahNotmhRn1abcde /// [JsonProperty("shared_url")] public string? SharedUrl { get; set; } diff --git a/src/Base/PostBitableV1AppsBodyDto.cs b/src/Base/PostBitableV1AppsBodyDto.cs index 40f32807..b383dae0 100644 --- a/src/Base/PostBitableV1AppsBodyDto.cs +++ b/src/Base/PostBitableV1AppsBodyDto.cs @@ -26,7 +26,7 @@ public record PostBitableV1AppsBodyDto public string? FolderToken { get; set; } /// - /// 文档时区，[详见](https://bytedance.feishu.cn/docx/YKRndTM7VoyDqpxqqeEcd67MnEf) + /// 文档时区，[详见](https://feishu.feishu.cn/docx/YKRndTM7VoyDqpxqqeEcd67MnEf) /// 必填：否 /// 示例值：Asia/Macau /// diff --git a/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs b/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs index b0858fe6..2d9abbdc 100644 --- a/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs @@ -36,7 +36,7 @@ public record PostBitableV1AppsByAppTokenCopyBodyDto public bool? WithoutContent { get; set; } /// - /// 文档时区，[详见](https://bytedance.feishu.cn/docx/YKRndTM7VoyDqpxqqeEcd67MnEf) + /// 文档时区，[详见](https://feishu.feishu.cn/docx/YKRndTM7VoyDqpxqqeEcd67MnEf) /// 必填：否 /// 示例值：Asia/Shanghai /// diff --git a/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs b/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs index fd3c6928..b2742bf2 100644 --- a/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs @@ -48,7 +48,7 @@ public record PostBitableV1AppsByAppTokenCopyResponseDtoApp /// /// 多维表格 App URL /// 必填：否 - /// 示例值：https://by*****ce.feishu.cn/base/S404b*****e9PQsYDWYcNryFn0g + /// 示例值：https://example.feishu.cn/base/S404b*****e9PQsYDWYcNryFn0g /// [JsonProperty("url")] public string? Url { get; set; } @@ -56,7 +56,7 @@ public record PostBitableV1AppsByAppTokenCopyResponseDtoApp /// /// 默认的表格id /// 必填：否 - /// 示例值：tblxxxxxxxxoumSQ + /// 示例值："" //只有创建才返回默认表Id /// [JsonProperty("default_table_id")] public string? DefaultTableId { get; set; } diff --git a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchDeleteBodyDto.cs b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchDeleteBodyDto.cs index 98cc29c3..bd046a96 100644 --- a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchDeleteBodyDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchDeleteBodyDto.cs @@ -12,7 +12,7 @@ public record PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchDeleteBodyDt /// /// 删除的多条记录id列表 /// 必填：是 - /// 示例值：["recIcJBbvC","recvmiCORa"] + /// 示例值：[ "recIcJBbvC", "recvmiCORa" ] /// [JsonProperty("records")] public string[] Records { get; set; } = Array.Empty(); diff --git a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBodyDto.cs b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBodyDto.cs index f28d008a..abdbd294 100644 --- a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBodyDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBodyDto.cs @@ -14,7 +14,7 @@ public record PostBitableV1AppsByAppTokenTablesByTableIdRecordsBodyDto /// 当前接口支持的字段类型请参考[接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#31f78a3c) /// 不同类型字段的数据结构请参考[数据结构概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/development-guide/bitable-structure) /// 必填：是 - /// 示例值：{"多行文本":"HelloWorld"} + /// 示例值：{ "多行文本":"HelloWorld" } /// [JsonProperty("fields")] public object Fields { get; set; } = new(); diff --git a/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesAppendBodyDto.cs b/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesAppendBodyDto.cs index 315d5ab3..d3cc8d01 100644 --- a/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesAppendBodyDto.cs +++ b/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesAppendBodyDto.cs @@ -28,5 +28,5 @@ public record PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesAppendBodyDto /// 必填：是 /// [JsonProperty("values")] - public array> Values { get; set; } + public object[][] Values { get; set; } = Array.Empty(); } diff --git a/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdateBodyDto.cs b/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdateBodyDto.cs index f06b8bd6..17d13b45 100644 --- a/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdateBodyDto.cs +++ b/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdateBodyDto.cs @@ -28,5 +28,5 @@ public record PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdateBodyDto /// 必填：是 /// [JsonProperty("values")] - public array> Values { get; set; } + public object[][] Values { get; set; } = Array.Empty(); } diff --git a/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesPrependBodyDto.cs b/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesPrependBodyDto.cs index 330b0b96..42361076 100644 --- a/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesPrependBodyDto.cs +++ b/src/Ccm.Spec/PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesPrependBodyDto.cs @@ -29,5 +29,5 @@ public record PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesPrependBodyDto /// 必填：是 /// [JsonProperty("values")] - public array> Values { get; set; } + public object[][] Values { get; set; } = Array.Empty(); } diff --git a/src/Ccm.Spec/PutSheetsV2SpreadsheetsBySpreadsheetTokenValuesBodyDto.cs b/src/Ccm.Spec/PutSheetsV2SpreadsheetsBySpreadsheetTokenValuesBodyDto.cs index 6fa274f4..256e7da0 100644 --- a/src/Ccm.Spec/PutSheetsV2SpreadsheetsBySpreadsheetTokenValuesBodyDto.cs +++ b/src/Ccm.Spec/PutSheetsV2SpreadsheetsBySpreadsheetTokenValuesBodyDto.cs @@ -28,5 +28,5 @@ public record PutSheetsV2SpreadsheetsBySpreadsheetTokenValuesBodyDto /// 必填：是 /// [JsonProperty("values")] - public array> Values { get; set; } + public object[][] Values { get; set; } = Array.Empty(); } diff --git a/src/Ccm/PostSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFindBodyDto.cs b/src/Ccm/PostSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFindBodyDto.cs index c2262754..680e00fc 100644 --- a/src/Ccm/PostSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFindBodyDto.cs +++ b/src/Ccm/PostSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFindBodyDto.cs @@ -73,7 +73,7 @@ public record PostSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFindBodyD /// /// 查找的字符串，当`search_by_regex`字段为 true 时，该字段为正则表达式 /// 必填：是 - /// 示例值：如下- 普通查找示例: "hello"- 正则查找示例: "[A-Z]\w+" + /// 示例值：如下 - 普通查找示例: "hello" - 正则查找示例: "[A-Z]\w+" /// [JsonProperty("find")] public string Find { get; set; } = string.Empty; diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index f4280885..7b07b393 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 1.0.9 + 1.0.10 diff --git a/src/Helpdesk/PostHelpdeskV1TicketsByTicketIdMessagesBodyDto.cs b/src/Helpdesk/PostHelpdeskV1TicketsByTicketIdMessagesBodyDto.cs index 59bca978..e104226c 100644 --- a/src/Helpdesk/PostHelpdeskV1TicketsByTicketIdMessagesBodyDto.cs +++ b/src/Helpdesk/PostHelpdeskV1TicketsByTicketIdMessagesBodyDto.cs @@ -21,7 +21,7 @@ public record PostHelpdeskV1TicketsByTicketIdMessagesBodyDto /// - 纯文本，参考[发送文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uUjNz4SN2MjL1YzM)中的content； /// - 富文本，参考[发送富文本消息](https://open.feishu.cn/document/ukTMukTMukTM/uMDMxEjLzATMx4yMwETM)中的content /// 必填：是 - /// 示例值：{"msg_type":"post","content":{"post":{"zh_cn":{"title":"thisistitle","content":[[{"tag":"text","un_escape":true,"text":"第一行 :"},{"tag":"a","text":"超链接","href":"http://www.feishu.cn"}],[{"tag":"text","text":"第二行:"},{"tag":"text","text":"文本测试"}]]}}}} + /// 示例值：{ "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": "文本测试" } ] ] } } } } /// [JsonProperty("content")] public string Content { get; set; } = string.Empty; diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index a4d0b6ab..87e7fd13 100644 --- a/src/IFeishuTenantApi.cs +++ b/src/IFeishuTenantApi.cs @@ -1983,7 +1983,7 @@ System.Threading.Tasks.Task DeleteContactV3JobFamiliesByJobFamil /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) /// email：以用户的真实邮箱来标识用户。 - /// chat_id：以群ID来标识群聊。[了解更多：如何获取群ID ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)</md-enum-item>**当值为 `user_id`，字段权限要求**：<md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> + /// chat_id：以群ID来标识群聊。[了解更多：如何获取群ID ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)</md-enum-item> **当值为 `user_id`，字段权限要求**： <md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> /// /// /// 请求体 @@ -2069,7 +2069,7 @@ System.Threading.Tasks.Task DeleteImV1MessagesByMessageIdAsync( /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) /// email：以用户的真实邮箱来标识用户。 - /// chat_id：以群ID来标识群聊。[了解更多：如何获取群ID ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)</md-enum-item>**当值为 `user_id`，字段权限要求**：<md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> + /// chat_id：以群ID来标识群聊。[了解更多：如何获取群ID ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)</md-enum-item> **当值为 `user_id`，字段权限要求**： <md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> /// /// /// @@ -2101,7 +2101,7 @@ System.Threading.Tasks.Task DeleteImV1MessagesByMessageIdAsync( /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) /// email：以用户的真实邮箱来标识用户。 - /// chat_id：以群ID来标识群聊。[了解更多：如何获取群ID ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)</md-enum-item>**当值为 `user_id`，字段权限要求**：<md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> + /// chat_id：以群ID来标识群聊。[了解更多：如何获取群ID ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)</md-enum-item> **当值为 `user_id`，字段权限要求**： <md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> /// /// /// @@ -2924,7 +2924,7 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// 接口ID：6946222931479412737 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/list /// Authorization：tenant_access_token、user_access_token - /// 获取用户或者机器人所在群列表。 + /// 根据使用的 access_token 获取用户或者机器人所在群列表。 /// /// /// 必填：否 @@ -2971,7 +2971,7 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// 接口ID：6946222929790648348 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/search /// Authorization：tenant_access_token、user_access_token - /// 搜索对用户或机器人可见的群列表，包括：用户或机器人所在的群、对用户或机器人公开的群。 + /// 根据使用的 access_token 搜索对用户或机器人可见的群列表，包括：用户或机器人所在的群、对用户或机器人公开的群。 /// 搜索可获得的群信息包括：群ID（chat_id）、群名称、群描述等。 /// /// @@ -3262,19 +3262,13 @@ System.Threading.Tasks.Task PatchImV1ChatsByChatIdMembersMeJoinA /// /// user_id：以 user_id 来识别成员 /// union_id：以 union_id 来识别成员 - /// open_id：以 open_id 来识别成员</md-enum-item>**当值为 `user_id`，字段权限要求**：<md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm></md-td></md-tr> + /// open_id：以 open_id 来识别成员</md-enum-item> **当值为 `user_id`，字段权限要求**： <md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> </md-td> </md-tr> /// /// /// /// 必填：否 /// 分页大小 - /// 示例值：20 - -**默认值**：`20` - -**数据校验规则**： - -- 最大值：`100` + /// 示例值：20 **默认值**：`20` **数据校验规则**： - 最大值：`100` /// 默认值：10 /// /// @@ -3902,7 +3896,7 @@ System.Threading.Tasks.Task GetDriveV1MediasByFileTokenDown /// /// 必填：否 /// 拓展信息，比如对于拥有高级权限的 Bitable，在下载素材或者获取素材临时下载链接时，需要添加额外的`extra`作为 URL 查询参数进行鉴权。 - /// 示例值：[请参考-上传点类型及对应Extra说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction) + /// 示例值：[请参考-上传点类型及对应Extra说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction) /// [HttpGet("/open-apis/drive/v1/medias/batch_get_tmp_download_url")] System.Threading.Tasks.Task> GetDriveV1MediasBatchGetTmpDownloadUrlAsync( @@ -5158,10 +5152,7 @@ System.Threading.Tasks.Task DeleteDriveV1PermissionsByTokenPubli /// /// 必填：是 /// 文档类型 - /// 示例值：doc -docx -sheet -file + /// 示例值：doc docx sheet file /// /// doc：文档类型 /// sheet：电子表格类型 @@ -7733,7 +7724,7 @@ System.Threading.Tasks.Task DeleteBitableV1AppsByAppTokenTablesB /// 1.不支持对“人员”以及“关联字段”的属性进行过滤筛选，如人员的 OpenID。 /// 2.指定筛选条件时，参数长度不超过2000个字符。 /// 详细请参考[筛选条件支持的公式](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter) - /// 示例值：AND(CurrentValue.[身高]>180, CurrentValue.[体重]>150) + /// 示例值：AND(CurrentValue.[身高]>180, CurrentValue.[体重]>150) /// /// /// 必填：否 @@ -12481,7 +12472,7 @@ System.Threading.Tasks.Task PostApprovalV4ApprovalsByApprovalCod /// 路径参数 /// 必填：是 /// 客服 id - /// 示例值： 客服 id + /// 示例值：客服 id /// [HttpGet("/open-apis/helpdesk/v1/agents/{agent_id}/schedules")] System.Threading.Tasks.Task> GetHelpdeskV1AgentsByAgentIdSchedulesAsync( @@ -12497,7 +12488,7 @@ System.Threading.Tasks.Task PostApprovalV4ApprovalsByApprovalCod /// /// 必填：是 /// 筛选条件, 1 - online客服, 2 - offline(手动)客服, 3 - off duty(下班)客服, 4 - 移除客服 - /// 示例值：status=1&status=2 + /// 示例值：status=1&status=2 /// [HttpGet("/open-apis/helpdesk/v1/agent_schedules")] System.Threading.Tasks.Task> GetHelpdeskV1AgentSchedulesAsync( diff --git a/src/Im/GetImV1ChatsResponseDto.cs b/src/Im/GetImV1ChatsResponseDto.cs index 9f22b5e1..f2c7653e 100644 --- a/src/Im/GetImV1ChatsResponseDto.cs +++ b/src/Im/GetImV1ChatsResponseDto.cs @@ -2,7 +2,7 @@ namespace FeishuNetSdk.Im; /// /// 获取用户或机器人所在的群列表 响应体 -/// 获取用户或者机器人所在群列表。 +/// 根据使用的 access_token 获取用户或者机器人所在群列表。 /// 接口ID：6946222931479412737 /// 文档地址：https://open.feishu.cn/document/server-docs/group/chat/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fim-v1%2fchat%2flist diff --git a/src/Im/GetImV1ChatsSearchResponseDto.cs b/src/Im/GetImV1ChatsSearchResponseDto.cs index e8bd6888..44ba5408 100644 --- a/src/Im/GetImV1ChatsSearchResponseDto.cs +++ b/src/Im/GetImV1ChatsSearchResponseDto.cs @@ -2,7 +2,7 @@ namespace FeishuNetSdk.Im; /// /// 搜索对用户或机器人可见的群列表 响应体 -/// 搜索对用户或机器人可见的群列表，包括：用户或机器人所在的群、对用户或机器人公开的群。 +/// 根据使用的 access_token 搜索对用户或机器人可见的群列表，包括：用户或机器人所在的群、对用户或机器人公开的群。 /// 搜索可获得的群信息包括：群ID（chat_id）、群名称、群描述等。 /// 接口ID：6946222929790648348 /// 文档地址：https://open.feishu.cn/document/server-docs/group/chat/search diff --git a/src/Im/PostImV1FilesBodyDto.cs b/src/Im/PostImV1FilesBodyDto.cs index b09de3e8..42db247c 100644 --- a/src/Im/PostImV1FilesBodyDto.cs +++ b/src/Im/PostImV1FilesBodyDto.cs @@ -14,7 +14,7 @@ public record PostImV1FilesBodyDto /// 必填：是 /// 示例值：mp4 /// 可选值： - /// opus：上传opus音频文件；其他格式的音频文件，请转为opus格式后上传，转换方式可参考：`ffmpeg-iSourceFile.mp3-acodeclibopus-ac1-ar16000TargetFile.opus` + /// opus：上传opus音频文件； 其他格式的音频文件，请转为opus格式后上传，转换方式可参考：`ffmpeg -i SourceFile.mp3 -acodec libopus -ac 1 -ar 16000 TargetFile.opus` /// mp4：上传mp4视频文件 /// pdf：上传pdf格式文件 /// doc：上传doc格式文件 diff --git a/src/Task/PatchTaskV1TasksByTaskIdBodyDto.cs b/src/Task/PatchTaskV1TasksByTaskIdBodyDto.cs index a42b7ae4..460a14a4 100644 --- a/src/Task/PatchTaskV1TasksByTaskIdBodyDto.cs +++ b/src/Task/PatchTaskV1TasksByTaskIdBodyDto.cs @@ -29,6 +29,7 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTask /// 必填：否 /// 示例值：完成本季度OKR编写 /// 最大长度：1000 + /// 最小长度：0 /// [JsonProperty("summary")] public string? Summary { get; set; } @@ -40,6 +41,7 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTask /// 必填：否 /// 示例值：对本次会议内容复盘总结，编写更新本季度OKR /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("description")] public string? Description { get; set; } @@ -51,6 +53,7 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTask /// 必填：否 /// 示例值：dGVzdA== /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("extra")] public string? Extra { get; set; } @@ -114,8 +117,9 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTaskOrigin /// 任务来源的名称。 /// 用于在任务中心详情页展示。需要提供一个字典，支持多种语言名称映射。应用在使用不同语言时，导入来源也将展示对应的内容。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) /// 必填：是 - /// 示例值：{\"zh_cn\":\"IT工作台\",\"en_us\":\"ITWorkspace\"} + /// 示例值：{\"zh_cn\": \"IT 工作台\", \"en_us\": \"IT Workspace\"} /// 最大长度：1024 + /// 最小长度：0 /// [JsonProperty("platform_i18n_name")] public string PlatformI18nName { get; set; } = string.Empty; @@ -138,6 +142,7 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTaskOriginHref /// 必填：否 /// 示例值：https://support.feishu.com/internal/foo-bar /// 最大长度：1024 + /// 最小长度：0 /// [JsonProperty("url")] public string? Url { get; set; } @@ -147,6 +152,7 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTaskOriginHref /// 必填：否 /// 示例值：反馈一个问题，需要协助排查 /// 最大长度：512 + /// 最小长度：0 /// [JsonProperty("title")] public string? Title { get; set; } @@ -169,6 +175,7 @@ public record PatchTaskV1TasksByTaskIdBodyDtoTaskOriginHref /// 必填：否 /// 示例值：{\"custom_complete\":{\"android\":{\"href\":\"https://www.feishu.cn/\",\"tip\":{\"zh_cn\":\"你好\",\"en_us\":\"hello\"}},\"ios\":{\"href\":\"https://www.feishu.cn/\",\"tip\":{\"zh_cn\":\"你好\",\"en_us\":\"hello\"}},\"pc\":{\"href\":\"https://www.feishu.cn/\",\"tip\":{\"zh_cn\":\"你好\",\"en_us\":\"hello\"}}}} /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("custom")] public string? Custom { get; set; } @@ -197,7 +204,7 @@ public record Follower /// /// 要删除的关注人ID列表 /// 必填：否 - /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4","ou_d1e9d27cf3235b40ca9a67c67ef088b0"] + /// 示例值：[ "ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0" ] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } @@ -230,7 +237,7 @@ public record Collaborator /// 执行者的用户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"] + /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0"] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } @@ -240,7 +247,7 @@ public record Collaborator /// 创建任务时添加的执行者用户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"] + /// 示例值：["ou_1400208f15333e20e11339d39067844b", "ou_84ed6312949945c8ae6168f10829e9e6"] /// 最大长度：100 /// [JsonProperty("collaborator_ids")] @@ -250,7 +257,7 @@ public record Collaborator /// 创建任务时添加的关注者用户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"] + /// 示例值：["ou_1400208f15333e20e11339d39067844b", "ou_84ed6312949945c8ae6168f10829e9e6"] /// 最大长度：100 /// [JsonProperty("follower_ids")] @@ -271,6 +278,7 @@ public record Collaborator /// 必填：否 /// 示例值：完成本季度OKR编写\[飞书开放平台](https://open.feishu.cn/) /// 最大长度：1000 + /// 最小长度：0 /// [JsonProperty("rich_summary")] public string? RichSummary { get; set; } @@ -280,6 +288,7 @@ public record Collaborator /// 必填：否 /// 示例值：对本次会议内容复盘总结，编写更新本季度OKR\[飞书开放平台](https://open.feishu.cn/) /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("rich_description")] public string? RichDescription { get; set; } diff --git a/src/Task/PatchTaskV1TasksByTaskIdResponseDto.cs b/src/Task/PatchTaskV1TasksByTaskIdResponseDto.cs index cf83f273..ad8ee48d 100644 --- a/src/Task/PatchTaskV1TasksByTaskIdResponseDto.cs +++ b/src/Task/PatchTaskV1TasksByTaskIdResponseDto.cs @@ -37,6 +37,7 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTask /// 必填：否 /// 示例值：完成本季度OKR编写 /// 最大长度：1000 + /// 最小长度：0 /// [JsonProperty("summary")] public string? Summary { get; set; } @@ -48,6 +49,7 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTask /// 必填：否 /// 示例值：对本次会议内容复盘总结，编写更新本季度OKR /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("description")] public string? Description { get; set; } @@ -78,6 +80,7 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTask /// 必填：否 /// 示例值：dGVzdA== /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("extra")] public string? Extra { get; set; } @@ -158,8 +161,9 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTaskOrigin /// 任务来源的名称。 /// 用于在任务中心详情页展示。需要提供一个字典，支持多种语言名称映射。应用在使用不同语言时，导入来源也将展示对应的内容。详细参见：[任务字段补充说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/task-v1/Supplementary-directions-of-task-fields) /// 必填：是 - /// 示例值：{\"zh_cn\":\"IT工作台\",\"en_us\":\"ITWorkspace\"} + /// 示例值：{\"zh_cn\": \"IT 工作台\", \"en_us\": \"IT Workspace\"} /// 最大长度：1024 + /// 最小长度：0 /// [JsonProperty("platform_i18n_name")] public string PlatformI18nName { get; set; } = string.Empty; @@ -182,6 +186,7 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTaskOriginHref /// 必填：否 /// 示例值：https://support.feishu.com/internal/foo-bar /// 最大长度：1024 + /// 最小长度：0 /// [JsonProperty("url")] public string? Url { get; set; } @@ -191,6 +196,7 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTaskOriginHref /// 必填：否 /// 示例值：反馈一个问题，需要协助排查 /// 最大长度：512 + /// 最小长度：0 /// [JsonProperty("title")] public string? Title { get; set; } @@ -203,6 +209,7 @@ public record PatchTaskV1TasksByTaskIdResponseDtoTaskOriginHref /// 必填：否 /// 示例值：{\"custom_complete\":{\"android\":{\"href\":\"https://www.feishu.cn/\",\"tip\":{\"zh_cn\":\"你好\",\"en_us\":\"hello\"}},\"ios\":{\"href\":\"https://www.feishu.cn/\",\"tip\":{\"zh_cn\":\"你好\",\"en_us\":\"hello\"}},\"pc\":{\"href\":\"https://www.feishu.cn/\",\"tip\":{\"zh_cn\":\"你好\",\"en_us\":\"hello\"}}}} /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("custom")] public string? Custom { get; set; } @@ -250,7 +257,7 @@ public record Follower /// /// 要删除的关注人ID列表 /// 必填：否 - /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4","ou_d1e9d27cf3235b40ca9a67c67ef088b0"] + /// 示例值：[ "ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0" ] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } @@ -283,7 +290,7 @@ public record Collaborator /// 执行者的用户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"] + /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0"] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } @@ -293,7 +300,7 @@ public record Collaborator /// 创建任务时添加的执行者用户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"] + /// 示例值：["ou_1400208f15333e20e11339d39067844b", "ou_84ed6312949945c8ae6168f10829e9e6"] /// 最大长度：100 /// [JsonProperty("collaborator_ids")] @@ -303,7 +310,7 @@ public record Collaborator /// 创建任务时添加的关注者用户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"] + /// 示例值：["ou_1400208f15333e20e11339d39067844b", "ou_84ed6312949945c8ae6168f10829e9e6"] /// 最大长度：100 /// [JsonProperty("follower_ids")] @@ -324,6 +331,7 @@ public record Collaborator /// 必填：否 /// 示例值：完成本季度OKR编写\[飞书开放平台](https://open.feishu.cn/) /// 最大长度：1000 + /// 最小长度：0 /// [JsonProperty("rich_summary")] public string? RichSummary { get; set; } @@ -333,6 +341,7 @@ public record Collaborator /// 必填：否 /// 示例值：对本次会议内容复盘总结，编写更新本季度OKR\[飞书开放平台](https://open.feishu.cn/) /// 最大长度：65536 + /// 最小长度：0 /// [JsonProperty("rich_description")] public string? RichDescription { get; set; } diff --git a/src/Task/PostTaskV1TasksByTaskIdBatchDeleteFollowerBodyDto.cs b/src/Task/PostTaskV1TasksByTaskIdBatchDeleteFollowerBodyDto.cs index 5490c984..6c7d7975 100644 --- a/src/Task/PostTaskV1TasksByTaskIdBatchDeleteFollowerBodyDto.cs +++ b/src/Task/PostTaskV1TasksByTaskIdBatchDeleteFollowerBodyDto.cs @@ -12,7 +12,7 @@ public record PostTaskV1TasksByTaskIdBatchDeleteFollowerBodyDto /// /// 要删除的关注人ID列表 /// 必填：否 - /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4","ou_d1e9d27cf3235b40ca9a67c67ef088b0"] + /// 示例值：[ "ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0" ] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } diff --git a/src/Task/PostTaskV1TasksByTaskIdFollowersBodyDto.cs b/src/Task/PostTaskV1TasksByTaskIdFollowersBodyDto.cs index 7419fc9b..19370f1a 100644 --- a/src/Task/PostTaskV1TasksByTaskIdFollowersBodyDto.cs +++ b/src/Task/PostTaskV1TasksByTaskIdFollowersBodyDto.cs @@ -20,7 +20,7 @@ public record PostTaskV1TasksByTaskIdFollowersBodyDto /// /// 要删除的关注人ID列表 /// 必填：否 - /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4","ou_d1e9d27cf3235b40ca9a67c67ef088b0"] + /// 示例值：[ "ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0" ] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } diff --git a/src/Task/PostTaskV1TasksByTaskIdFollowersResponseDto.cs b/src/Task/PostTaskV1TasksByTaskIdFollowersResponseDto.cs index 693f2119..04582954 100644 --- a/src/Task/PostTaskV1TasksByTaskIdFollowersResponseDto.cs +++ b/src/Task/PostTaskV1TasksByTaskIdFollowersResponseDto.cs @@ -32,7 +32,7 @@ public record PostTaskV1TasksByTaskIdFollowersResponseDtoFollower /// /// 要删除的关注人ID列表 /// 必填：否 - /// 示例值：["ou_550cc75233d8b7b9fcbdad65f34433f4","ou_d1e9d27cf3235b40ca9a67c67ef088b0"] + /// 示例值：[ "ou_550cc75233d8b7b9fcbdad65f34433f4", "ou_d1e9d27cf3235b40ca9a67c67ef088b0" ] /// [JsonProperty("id_list")] public string[]? IdList { get; set; } diff --git a/src/Vc/GetVcV1ReservesByReserveIdResponseDto.cs b/src/Vc/GetVcV1ReservesByReserveIdResponseDto.cs index 2a1e4194..61c42258 100644 --- a/src/Vc/GetVcV1ReservesByReserveIdResponseDto.cs +++ b/src/Vc/GetVcV1ReservesByReserveIdResponseDto.cs @@ -104,7 +104,7 @@ public record ReserveMeetingSetting /// /// 会议主题 /// 必填：否 - /// 示例值：mymeeting + /// 示例值：my meeting /// [JsonProperty("topic")] public string? Topic { get; set; } @@ -152,7 +152,7 @@ public record ReservePermissionChecker /// 示例值：1 /// 可选值： /// 1：用户ID（check_list填入用户ID） - /// 2：用户类型（check_list可选值有"1"：飞书用户、"2"：rooms用户、"6"：pstn用户、"7"：sip用户） + /// 2：用户类型（check_list可选值有 "1"：飞书用户、 "2"：rooms用户、 "6"：pstn用户、 "7"：sip用户） /// 3：租户ID（check_list填入租户tenant_key） /// /// diff --git a/src/Vc/PostVcV1ReservesApplyBodyDto.cs b/src/Vc/PostVcV1ReservesApplyBodyDto.cs index c18bad30..c5fe0e17 100644 --- a/src/Vc/PostVcV1ReservesApplyBodyDto.cs +++ b/src/Vc/PostVcV1ReservesApplyBodyDto.cs @@ -89,7 +89,7 @@ public record ReservePermissionChecker /// 示例值：1 /// 可选值： /// 1：用户ID（check_list填入用户ID） - /// 2：用户类型（check_list可选值有 "1"：飞书用户、"2"：rooms用户、"6"：pstn用户、"7"：sip用户） + /// 2：用户类型（check_list可选值有 "1"：飞书用户、 "2"：rooms用户、 "6"：pstn用户、 "7"：sip用户） /// 3：租户ID（check_list填入租户tenant_key） /// /// diff --git a/src/Vc/PutVcV1ReservesByReserveIdBodyDto.cs b/src/Vc/PutVcV1ReservesByReserveIdBodyDto.cs index bb83a2c2..9fb2a719 100644 --- a/src/Vc/PutVcV1ReservesByReserveIdBodyDto.cs +++ b/src/Vc/PutVcV1ReservesByReserveIdBodyDto.cs @@ -32,7 +32,7 @@ public record ReserveMeetingSetting /// /// 会议主题 /// 必填：否 - /// 示例值：mymeeting + /// 示例值：my meeting /// [JsonProperty("topic")] public string? Topic { get; set; } @@ -80,7 +80,7 @@ public record ReservePermissionChecker /// 示例值：1 /// 可选值： /// 1：用户ID（check_list填入用户ID） - /// 2：用户类型（check_list可选值有"1"：飞书用户、"2"：rooms用户、"6"：pstn用户、"7"：sip用户） + /// 2：用户类型（check_list可选值有 "1"：飞书用户、 "2"：rooms用户、 "6"：pstn用户、 "7"：sip用户） /// 3：租户ID（check_list填入租户tenant_key） /// ///