mute: 禁言批量成员 (merge request !51)

Squash merge branch 'feature_20220420_kodypan_multimute_story_873489705' into 'master'
mute: 禁言批量成员

    1、批量禁言指定成员

--story=873489705


TAPD: --story=873489705

Author: kodytencent

dto/mute.go

@@ -6,4 +6,12 @@ type UpdateGuildMute struct {
 	MuteEndTimestamp string `json:"mute_end_timestamp,omitempty"`
 	// 禁言多少秒（两个字段二选一，默认以mute_end_timstamp为准）
 	MuteSeconds string `json:"mute_seconds,omitempty"`
+	// 批量禁言的成员列表（全员禁言时不填写该字段）
+	UserIDs []string `json:"user_ids,omitempty"`
+}
+
+// UpdateGuildMuteResponse 批量禁言的回参
+type UpdateGuildMuteResponse struct {
+	// 批量禁言成功的成员列表
+	UserIDs []string `json:"user_ids,omitempty"`
 }

examples/apitest/mute_test.go

@@ -38,4 +38,17 @@ func Test_mute(t *testing.T) {
 			t.Logf("Testing_Succ")
 		},
 	)
+	t.Run(
+		"频道指定批量成员禁言", func(t *testing.T) {
+			mute := &dto.UpdateGuildMute{
+				MuteEndTimestamp: strconv.FormatInt(time.Now().Unix()+600, 10),
+				UserIDs:          []string{testMuteUserID},
+			}
+			_, err := api.MultiMemberMute(ctx, testGuildID, mute)
+			if err != nil {
+				t.Error(err)
+			}
+			t.Logf("Testing_Succ")
+		},
+	)
 }

openapi/iface.go

@@ -134,8 +134,11 @@ type MemberAPI interface {
 		ctx context.Context,
 		guildID string, roleID dto.RoleID, userID string, value *dto.MemberAddRoleBody,
 	) error
-	// 频道指定成员禁言
+	//MemberMute 频道指定单个成员禁言
 	MemberMute(ctx context.Context, guildID, userID string, mute *dto.UpdateGuildMute) error
+	//MultiMemberMute 频道指定批量成员禁言
+	MultiMemberMute(ctx context.Context, guildID string,
+		mute *dto.UpdateGuildMute) (*dto.UpdateGuildMuteResponse, error)
 }
 
 // DirectMessageAPI 信息相关接口

openapi/v1/mute.go

@@ -2,6 +2,9 @@ package v1
 
 import (
 	"context"
+	"errors"
+
+	"github.com/tencent-connect/botgo/log"
 
 	"github.com/tencent-connect/botgo/dto"
 )
@@ -31,3 +34,20 @@ func (o *openAPI) MemberMute(ctx context.Context, guildID, userID string,
 	}
 	return nil
 }
+
+//MultiMemberMute 频道批量成员禁言
+func (o *openAPI) MultiMemberMute(ctx context.Context, guildID string,
+	mute *dto.UpdateGuildMute) (*dto.UpdateGuildMuteResponse, error) {
+	if len(mute.UserIDs) == 0 {
+		return nil, errors.New("no user id param")
+	}
+	rsp, err := o.request(ctx).
+		SetPathParam("guild_id", guildID).
+		SetBody(mute).
+		Patch(o.getURL(guildMuteURI))
+	if err != nil {
+		return nil, err
+	}
+	log.Infof("MultiMemberMute rsp: %#v", rsp)
+	return rsp.Result().(*dto.UpdateGuildMuteResponse), nil
+}