file

package
v1.33.9 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 20, 2026 License: Apache-2.0 Imports: 5 Imported by: 1

Documentation

Overview

Package file 素材管理API models

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Image added in v1.18.6 

type Image struct {
	// ID 图片ID
	ID string `json:"id,omitempty"`
	// MaterialID 素材id，即多合一报表中的素材id，一个素材唯一对应一个素材id
	MaterialID uint64 `json:"material_id,omitempty"`
	// Size 图片大小
	Size uint64 `json:"size,omitempty"`
	// Width 图片宽度
	Width int `json:"width,omitempty"`
	// Height 图片高度
	Height int `json:"height,omitempty"`
	// URL 图片预览地址，仅限同主体进行素材预览查看，若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”
	// 链接仅做预览使用，预览链接有效期为1小时
	URL string `json:"url,omitempty"`
	// Format 图片格式
	Format string `json:"format,omitempty"`
	// Signature 图片md5
	Signature string `json:"signature,omitempty"`
	// CreateTime 素材的上传时间，格式："yyyy-mm-dd HH:MM:SS"
	CreateTime string `json:"create_time,omitempty"`
	// Filename 素材的文件名
	Filename string `json:"filename,omitempty"`
	// ImageMode 素材类型，允许值:
	// SQUARE 方图
	// LARGE 大图
	// SMALL 小图
	// LARGE_VERTICAL 大图竖图
	// UNION_SPLASH 穿山甲开屏图片
	// VIDEO_LARGE 横版视频
	// VIDEO_VERTICAL 竖版视频
	ImageMode enum.MaterialMode `json:"image_mode,omitempty"`
	// Tag 素材标签
	Tag string `json:"tag,omitempty"`
	// 是否AI生成
	// false：不是AI生成
	// true：AI生成
	IsAiCreate bool `json:"is_ai_create,omitempty"`
}

Image 图片

type ImageDeleteRequest added in v1.16.0 

type ImageDeleteRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// ImageIDs 待删除的image_id列表，长度范围：1 ~ 100
	ImageIDs []string `json:"image_ids,omitempty"`
}

ImageDeleteRequest 批量删除图片素材 API Request

func (ImageDeleteRequest) Encode added in v1.16.0 

func (r ImageDeleteRequest) Encode() []byte

Encode implement PostRequest interface

type ImageDeleteResponse added in v1.16.0 

type ImageDeleteResponse struct {
	model.BaseResponse
	Data struct {
		// FailImageIDs 操作失败的image_id列表，不在此列表内的素材表示删除成功
		FailImageIDs []string `json:"fail_image_ids,omitempty"`
	} `json:"data,omitempty"`
}

ImageDeleteResponse 批量删除图片素材 API Response

type ImageGetFilter added in v1.16.0 

type ImageGetFilter struct {
	// ImageIDs 图片ids，可以根据图片ids（创意中使用的图片key，存在一张图片对应多个image_ids的情况）进行过滤数量限制：<=100
	// 注意：image_ids、material_ids、signatures只能选择一个进行过滤
	ImageIDs []string `json:"image_ids,omitempty"`
	// MaterialIDs 素材id列表，可以根据material_ids（素材报表使用的id，一个素材唯一对应一个素材id）进行过滤数量限制：<=100
	// 注意：image_ids、material_ids、signatures只能选择一个进行过滤
	MaterialIDs []string `json:"material_ids,omitempty"`
	// Sigatures md5值列表，可以根据素材的md5进行过滤数量限制：<=100
	// 注意：image_ids、material_ids、signatures只能选择一个进行过滤
	Sigatures []string `json:"signatures,omitempty"`
	// ImageMode 素材类型
	ImageMode []enum.MaterialMode `json:"image_mode,omitempty"`
	// Tags 素材标签
	Tags []string `json:"tags,omitempty"`
	// StartTime 根据图片上传时间进行过滤的起始时间，与end_time搭配使用，格式："yyyy-mm-dd"
	StartTIme string `json:"start_time,omitempty"`
	// EndTime 根据图片上传时间进行过滤的截止时间，与start_time搭配使用，格式："yyyy-mm-dd"
	EndTime string `json:"end_time,omitempty"`
}

ImageGetFilter 图片过滤条件

type ImageGetRequest added in v1.16.0 

type ImageGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Filtering 图片过滤条件
	Filtering *ImageGetFilter `json:"filtering,omitempty"`
	// Page 页码，默认值1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，默认值20
	PageSize int `json:"page_size,omitempty"`
}

ImageGetRequest 获取千川素材库图片 API Request

func (ImageGetRequest) Encode added in v1.16.0 

func (r ImageGetRequest) Encode() string

Encode implement GetRequest interface

type ImageGetResponse added in v1.18.6 

type ImageGetResponse struct {
	model.BaseResponse
	Data *ImageGetResult `json:"data,omitempty"`
}

ImageGetResponse 获取图片素材 API Response

type ImageGetResult added in v1.18.6 

type ImageGetResult struct {
	// List 图片列表
	List []Image `json:"list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

ImageGetResult json返回值

type Video added in v1.18.6 

type Video struct {
	// ID 视频ID
	ID string `json:"id,omitempty"`
	// VideoID 视频ID
	VideoID string `json:"video_id,omitempty"`
	// VideoCoverURL 视频封面图片url
	VideoCoverURL string `json:"video_cover_url,omitempty"`
	// Size 视频大小
	Size uint64 `json:"size,omitempty"`
	// Width 视频宽度
	Width int `json:"width,omitempty"`
	// Height 视频高度
	Height int `json:"height,omitempty"`
	// URL 视频地址，仅限同主体进行素材预览查看，若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”
	// 链接仅做预览使用，预览链接有效期为1小时
	URL string `json:"url,omitempty"`
	// VideoURL 视频地址
	VideoURL string `json:"video_url,omitempty"`
	// Format 视频格式
	Format string `json:"format,omitempty"`
	// Signature 视频md5
	Signature string `json:"signature,omitempty"`
	// PosterURL 视频首帧截图，仅限同主体进行素材预览查看，若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”
	PosterURL string `json:"poster_url,omitempty"`
	// BitRate 码率，单位bps
	BitRate int64 `json:"bit_rate,omitempty"`
	// Duration 视频时长
	Duration float64 `json:"duration,omitempty"`
	// MaterialID 素材id，即多合一报表中的素材id，一个素材唯一对应一个素材id
	MaterialID uint64 `json:"material_id,omitempty"`
	// ImageMode 素材类型，枚举值:
	// LARGE 大图
	// SMALL 小图
	// LARGE_VERTICAL 大图竖图
	// UNION_SPLASH 穿山甲开屏图片
	// VIDEO_LARGE 横版视频
	// VIDEO_VERTICAL 竖版视频
	ImageMode enum.MaterialMode `json:"image_mode,omitempty"`
	// Source 素材来源，详见【附录-素材来源】
	Source enum.MaterialSource `json:"source,omitempty"`
	// CreateTime 素材的上传时间，格式："yyyy-mm-dd HH:MM:SS"
	CreateTime string `json:"create_time,omitempty"`
	// Filename 素材的文件名
	Filename string `json:"filename,omitempty"`
	// Tags 素材标签
	Tags []string `json:"tags,omitempty"`
	// Labels 视频标签
	Labels []string `json:"labels,omitempty"`
	// AwemeItemID 抖音短视频 ID
	AwemeItemID uint64 `json:"aweme_item_id,omitempty"`
	// Title 抖音中的视频标题
	Title string `json:"title,omitempty"`
	// IsRecommend 是否推荐; 0 不推荐 1 推荐
	IsRecommend int `json:"is_recommend,omitempty"`
	// ViewCnt 观看数
	ViewCnt int64 `json:"view_cnt,omitempty"`
	// LikeCnt 点赞数
	LikeCnt int64 `json:"like_cnt,omitempty"`
	// ShareCnt 分享数
	ShareCnt int64 `json:"share_cnt,omitempty"`
	// CommentCnt 评论数
	CommentCnt int64 `json:"comment_cnt,omitempty"`
	// 是否AI生成
	// false：不是AI生成
	// true：AI生成
	IsAiCreate bool `json:"is_ai_create,omitempty"`
}

Video 视频

type VideoAwemeGetFiltering 

type VideoAwemeGetFiltering struct {
	//ProductID 商品ID，查询关联商品的相应视频，仅短视频带货场景需入参
	ProductID uint64 `json:"product_id,omitempty"`
	// AwemeItemURL 抖音主页视频url
	AwemeItemURL string `json:"aweme_item_url,omitempty"`
	// MaterialIDs 素材id，抖音主页视频用来投放才会有，限制0-50
	// 注意：material_ids和aweme_item_id只能选择一个进行过滤，否则可能会查询不到数据
	MaterialIDs []uint64 `json:"material_ids,omitempty"`
	// AwemeItemIDs 抖音主页视频id，限制0-50
	// 注意：material_ids和aweme_item_id只能选择一个进行过滤，否则可能会查询不到数据
	AwemeItemIDs []uint64 `json:"aweme_item_id,omitempty"`
}

VideoAwemeGetFiltering 筛选条件

type VideoAwemeGetRequest 

type VideoAwemeGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// AwemeID 需拉取视频的抖音号
	AwemeID uint64 `json:"aweme_id,omitempty"`
	// Filtering 视频过滤条件
	Filtering *VideoAwemeGetFiltering `json:"filtering,omitempty"`
	// Cursor 页码游标值，第一次拉取，无需入参
	Cursor int `json:"cursor,omitempty"`
	// Count 页面大小，默认值30，限制1-50
	Count int `json:"count,omitempty"`
}

VideoAwemeGetRequest 获取抖音号下的视频 API Request

func (VideoAwemeGetRequest) Encode 

func (r VideoAwemeGetRequest) Encode() string

Encode implement GetRequest interface

type VideoAwemeGetResponse 

type VideoAwemeGetResponse struct {
	model.BaseResponse
	Data *VideoAwemeGetResponseData `json:"data,omitempty"`
}

VideoAwemeGetResponse 获取抖音号下的视频 API Response

type VideoAwemeGetResponseData 

type VideoAwemeGetResponseData struct {
	// List 视频列表
	List []Video `json:"video_list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

VideoAwemeGetResponseData json返回值

type VideoDeleteRequest added in v1.16.0 

type VideoDeleteRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// VideoIDs 待删除的video_id列表，长度范围：1 ~ 100
	VideoIDs []string `json:"video_ids,omitempty"`
}

VideoDeleteRequest 批量删除视频素材 API Request

func (VideoDeleteRequest) Encode added in v1.16.0 

func (r VideoDeleteRequest) Encode() []byte

Encode implement PostRequest interface

type VideoDeleteResponse added in v1.16.0 

type VideoDeleteResponse struct {
	model.BaseResponse
	Data struct {
		// FailVideoIDs 操作失败的video_id列表，不在此列表内的素材表示删除成功
		FailVideoIDs []string `json:"fail_video_ids,omitempty"`
	} `json:"data,omitempty"`
}

VideoDeleteResponse 批量删除视频素材 API Response

type VideoEfficiencyGetRequest added in v1.33.7 

type VideoEfficiencyGetRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// MaterialIDs 需要查询的素材id，不超过100个
	MaterialIDs []string `json:"material_ids,omitempty"`
}

VideoEfficiencyGetRequest 获取低效素材 API Request

func (VideoEfficiencyGetRequest) Encode added in v1.33.7 

func (r VideoEfficiencyGetRequest) Encode() string

Encode implement GetRequest interface

type VideoEfficiencyGetResponse added in v1.33.7 

type VideoEfficiencyGetResponse struct {
	model.BaseResponse
	Data struct {
		// InefficientMaterialIDs 低效素材id列表
		InefficientMaterialIDs []string `json:"inefficient_material_ids,omitempty"`
	} `json:"data,omitempty"`
}

VideoEfficiencyGetResponse 获取低效素材 API Response

type VideoGetFilter added in v1.16.0 

type VideoGetFilter struct {
	// VideoIDs 视频ids，示例: ["86adb23eaa21229fc04ef932b5089bb8"] 数量限制：<=100
	// 注意：video_ids、material_ids、signatures只能选择一个进行过滤
	VideoIDs []string `json:"video_ids,omitempty"`
	// MaterialIDs 素材id列表，可以根据material_ids（素材报表使用的id，一个素材唯一对应一个素材id）进行过滤数量限制：<=100
	// 注意：image_ids、material_ids、signatures只能选择一个进行过滤
	MaterialIDs []string `json:"material_ids,omitempty"`
	// Sigatures md5值列表，可以根据素材的md5进行过滤数量限制：<=100
	// 注意：image_ids、material_ids、signatures只能选择一个进行过滤
	Sigatures []string `json:"signatures,omitempty"`
	// ImageMode 素材类型
	ImageMode []enum.MaterialMode `json:"image_mode,omitempty"`
	// Tags 素材标签
	Tags []string `json:"tags,omitempty"`
	// Sources 素材来源，允许值：
	// ARTHUR 亚瑟共享素材
	// BP 巨量纵横共享素材
	// CREATIVE_CENTER 巨量创意PC共享素材
	// E_COMMERCE 本地上传
	// LIVE_HIGHLIGHT 直播剪辑素材
	// STAR 星图&即合共享素材
	// TADA tada共享素材
	// VIDEO_CAPTURE 易拍APP共享素材
	Sources []enum.MaterialSource `json:"sources,omitempty"`
	// StartTime 根据图片上传时间进行过滤的起始时间，与end_time搭配使用，格式："yyyy-mm-dd"
	StartTIme string `json:"start_time,omitempty"`
	// EndTime 根据图片上传时间进行过滤的截止时间，与start_time搭配使用，格式："yyyy-mm-dd"
	EndTime string `json:"end_time,omitempty"`
}

ImageVideoFilter 视频过滤条件

type VideoGetRequest added in v1.16.0 

type VideoGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Filtering 图片过滤条件
	Filtering *ImageGetFilter `json:"filtering,omitempty"`
	// Page 页码，默认值1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，默认值20
	PageSize int `json:"page_size,omitempty"`
}

VideoGetRequest 获取千川素材库视频 API Request

func (VideoGetRequest) Encode added in v1.16.0 

func (r VideoGetRequest) Encode() string

Encode implement GetRequest interface

type VideoGetResponse added in v1.18.6 

type VideoGetResponse struct {
	model.BaseResponse
	Data *VideoGetResult `json:"data,omitempty"`
}

VideoGetResponse 获取视频素材 API Response

type VideoGetResult added in v1.18.6 

type VideoGetResult struct {
	// List 视频列表
	List []Video `json:"list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

VideoGetResult json返回值

type VideoOriginalGetRequest added in v1.16.0 

type VideoOriginalGetRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// MaterialIDs 需要查询的素材id，不超过100个
	MaterialIDs []string `json:"material_ids,omitempty"`
}

VideoOriginalGetRequest 获取首发素材 API Request

func (VideoOriginalGetRequest) Encode added in v1.16.0 

func (r VideoOriginalGetRequest) Encode() string

Encode implement GetRequest interface

type VideoOriginalGetResponse added in v1.16.0 

type VideoOriginalGetResponse struct {
	model.BaseResponse
	Data struct {
		// OriginalMaterialIDs 首发素材id列表
		OriginalMaterialIDs []string `json:"original_material_ids,omitempty"`
	} `json:"data,omitempty"`
}

VideoOriginalGetResponse 获取首发素材 API Response

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.