feat(tools): 获取抖音授权关系新增授权状态相关字段信息

marketing-api/enum/aweme_auth_share_type.go

@@ -0,0 +1,13 @@
+package enum
+
+// AwemeAuthShareType 授权共享类型
+type AwemeAuthShareType = string
+
+const (
+	// AwemeAuthShareType_SHARE_BY_ONESELF 广告账户自主授权
+	AwemeAuthShareType_SHARE_BY_ONESELF AwemeAuthShareType = "SHARE_BY_ONESELF"
+	// AwemeAuthShareType_SHARE_BY_SAME_ENTITY 客户共享授权
+	AwemeAuthShareType_SHARE_BY_SAME_ENTITY AwemeAuthShareType = "SHARE_BY_SAME_ENTITY"
+	// AwemeAuthShareType_SHARE_FROM_BP 组织共享授权
+	AwemeAuthShareType_SHARE_FROM_BP AwemeAuthShareType = "SHARE_FROM_BP"
+)

marketing-api/enum/aweme_auth_sub_status.go

@@ -1,8 +1,17 @@
 package enum
 
+// AwemeAuthSubStatus 授权子状态
 type AwemeAuthSubStatus string
 
 const (
+	// AwemeAuthSubStatus_RENEWING 续期待确认
+	AwemeAuthSubStatus_RENEWING AwemeAuthSubStatus = "RENEWING"
+	// AwemeAuthSubStatus_RENEW_FAIL 续期申请失效
+	AwemeAuthSubStatus_RENEW_FAIL AwemeAuthSubStatus = "RENEW_FAIL"
+	// AwemeAuthSubStatus_RENEW_SUCCESS 续期成功
+	AwemeAuthSubStatus_RENEW_SUCCESS AwemeAuthSubStatus = "RENEW_SUCCESS"
+	// AwemeAuthSubStatus_RENEW_FAILED_BY_AWEME 授权续期申请失败
+	AwemeAuthSubStatus_RENEW_FAILED_BY_AWEME AwemeAuthSubStatus = "RENEW_FAILED_BY_AWEME"
 	// AwemeAuthSubStatus_INVALID_CANCEL 主动操作解除授权
 	AwemeAuthSubStatus_INVALID_CANCEL AwemeAuthSubStatus = "INVALID_CANCEL"
 	// AwemeAuthSubStatus_INVALID_EXPIRED 授权期限已到
@@ -11,10 +20,12 @@ const (
 	AwemeAuthSubStatus_INVALID_REJECT AwemeAuthSubStatus = "INVALID_REJECT"
 	// AwemeAuthSubStatus_INVALID_TIME_OUT 超时未确认
 	AwemeAuthSubStatus_INVALID_TIME_OUT AwemeAuthSubStatus = "INVALID_TIME_OUT"
-	// AwemeAuthSubStatus_RENEWING 续期待确认
-	AwemeAuthSubStatus_RENEWING AwemeAuthSubStatus = "RENEWING"
-	// AwemeAuthSubStatus_RENEW_FAIL 续期申请失效
-	AwemeAuthSubStatus_RENEW_FAIL AwemeAuthSubStatus = "RENEW_FAIL"
-	// AwemeAuthSubStatus_RENEW_SUCCESS 续期成功
-	AwemeAuthSubStatus_RENEW_SUCCESS AwemeAuthSubStatus = "RENEW_SUCCESS"
+	// AwemeAuthSubStatus_INVALID_FAILED_BY_AWEME 授权申请失败
+	AwemeAuthSubStatus_INVALID_FAILED_BY_AWEME AwemeAuthSubStatus = "INVALID_FAILED_BY_AWEME"
+	// AwemeAuthSubStatus_INVALID_PROCESS_TIME_OUT 超时未处理自动解除
+	AwemeAuthSubStatus_INVALID_PROCESS_TIME_OUT AwemeAuthSubStatus = "INVALID_PROCESS_TIME_OUT"
+	// AwemeAuthSubStatus_AWEME_REVOKE_REQUEST 创作者发起解除申请
+	AwemeAuthSubStatus_AWEME_REVOKE_REQUEST AwemeAuthSubStatus = "AWEME_REVOKE_REQUEST"
+	// AwemeAuthSubStatus_CONFIRM_REVOKE_REQUEST 同意解除授权申请
+	AwemeAuthSubStatus_CONFIRM_REVOKE_REQUEST AwemeAuthSubStatus = "CONFIRM_REVOKE_REQUEST"
 )

marketing-api/model/tools/aweme_auth_list.go

@@ -85,14 +85,49 @@ type AwemeAuthItem struct {
 	// AuthStatus 授权状态
 	AuthStatus enum.AwemeAuthStatus `json:"auth_status,omitempty"`
 	// SubStatus 授权子状态，返回值
-	// INVALID_CANCEL: 主动操作解除授权、INVALID_EXPIRED: 授权期限已到、INVALID_REJECT: C端拒绝授权、INVALID_TIME_OUT: 超时未确认、RENEWING: 续期待确认、RENEW_FAIL: 续期申请失效、RENEW_SUCCESS: 续期成功
+	// RENEWING 续期待确认
+	// RENEW_FAIL 续期失效
+	// RENEW_SUCCESS 续期成功
+	// INVALID_TIME_OUT 超时未确认
+	// INVALID_EXPIRED 授权期限已到
+	// INVALID_CANCEL 主动操作解除授权
+	// INVALID_REJECT 抖音号作者拒绝授权
+	// INVALID_FAILED_BY_AWEME 授权申请失败
+	// RENEW_FAILED_BY_AWEME 授权续期申请失败
+	// AWEME_REVOKE_REQUEST 创作者发起解除申请
+	// INVALID_PROCESS_TIME_OUT 超时未处理自动解除
+	// CONFIRM_REVOKE_REQUEST 同意解除授权申请
 	SubStatus enum.AwemeAuthSubStatus `json:"sub_status,omitempty"`
 	// StartTime 授权开始时间，格式为yyyy-MM-dd HH:mm:ss
 	StartTime string `json:"start_time,omitempty"`
 	// EndTime 授权结束时间，格式为yyyy-MM-dd HH:mm:ss
 	EndTime string `json:"end_time,omitempty"`
 	// VideoInfo 授权视频信息，若为单视频授权会返回
 	VideoInfo *AwemeAuthVideo `json:"video_info,omitempty"`
+	// Note 备注信息，发起抖音授权申请时填写的希望展示给抖音号创作者的备注，创作者可在授权邀请页&授权详情页查看
+	Note string `json:"note,omitempty"`
+	// AwemeCancelReason 抖音号作者发起解除授权的原因，仅当抖音号作者发起解除授权时有值，100字以内，可能包括：
+	// 不知道该授权是怎么建立的，申请解除授权
+	// 联系不到对方，无法进行合作沟通，申请解除授权
+	// 与对方合作到期或者有纠纷，申请解除授权
+	// 其他情况（作者会填写其他文案给到）
+	AwemeCancelReason string `json:"aweme_cancel_reason,omitempty"`
+	// AwemeCancelImageList 抖音号作者发起解除授权时上传的凭证信息（选填项，抖音号作者可能不填，此时该参数返回为null）
+	AwemeCancelImageList []string `json:"aweme_cancel_image_list,omitempty"`
+	// AwemeCancelNote 抖音号作者发起解除授权时填写的联系方式（选填项，抖音号作者可能不填，此时该参数返回为null）
+	AwemeCancelNote string `json:"aweme_cancel_note,omitempty"`
+	// WarningContent 抖音授权关系警告信息，您可根据该信息及时处理，可能返回
+	// 不达门槛：表示发起授权的抖音号未达到要求，详细未达门槛信息可通过auth_threshold_info获取
+	// 即将解除：表示抖音号作者已发起解除授权申请，您需要及时联系作者或同意解除
+	WarningContent []string `json:"warning_content,omitempty"`
+	// AuthThresholdInfo 当抖音号不达授权门槛时，您可通过此结构体获取具体不达门槛的原因并及时处理
+	// 当抖音号正常时，该结构体下信息会返回为空
+	AuthThresholdInfo *AwemeAuthThresholdInfo `json:"auth_threshold_info,omitempty"`
+	// HasVideoHpVisibilityLimit 发布新视频素材到该抖音号下时，视频主页可见性只能设置「仅单次展示可见」，枚举值：
+	// true：是
+	// false：否，表示无此限制
+	// 当值返回true时，代表在创建广告时添加新视频素材到该抖音号下推广，视频的主页可见性设置只允许HIDE_VIDEO_ON_HP「仅单次展示可见」
+	HasVideoHpVisibilityLimit bool `json:"has_video_hp_visibility_limit,omitempty"`
 }
 
 // AwemeAuthVideo 授权视频信息，若为单视频授权会返回
@@ -117,3 +152,23 @@ type AwemeAuthVideo struct {
 	// （仅抖音视频会有此字段，抖音图文素材没有此字段）
 	Mid string `json:"mid,omitempty"`
 }
+
+// AwemeAuthThresholdInfo 当抖音号不达授权门槛时，您可通过此结构体获取具体不达门槛的原因并及时处理
+type AwemeAuthThresholdInfo struct {
+	// IsAudit 是否已成年
+	// true表示 是
+	// false 表示 否，表示未成年，会导致不达门槛A
+	IsAudit bool `json:"is_audit,omitempty"`
+	// IsRealNameCert 是否已实名
+	// true表示 是
+	// false 表示 否，表示未实名，会导致不达门槛
+	IsRealNameCert bool `json:"is_real_name_cert,omitempty"`
+	// IsSeriousViolation 是否严重违规，
+	// true表示 严重违规，会导致不达门槛
+	// false 表示 没有严重违规
+	IsSeriousViolation bool `json:"is_serious_violation,omitempty"`
+	// IsReachedRiseFansCount 有效涨粉数是否达到1000
+	// true表示 达到
+	// false 表示 否，表示没有达到1000，会导致不达门槛
+	IsReachedRiseFansCount bool `json:"is_reached_rise_fans_count,omitempty"`
+}