file

Documentation

Overview

Package file 素材管理相关API

Index

• func AudioAd(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.Audio, error)
• func CarouselAdGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.CarouselAdGetResult, error)
• func CarouselAwemeGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.CarouselAwemeGetResult, error)
• func CarouselCreate(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.Carousel, error)
• func CarouselDelete(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.CarouselDeleteResult, error)
• func CarouselList(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.CarouselListResult, error)
• func CarouselUpdate(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]file.CarouselUpdateResult, error)
• func ImageAd(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.Image, error)
• func ImageAdGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]file.Image, error)
• func ImageAdvertiser(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.Image, error)
• func ImageGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.ImageGetResponseData, error)
• func MaterialAttributesList(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.MaterialAttributesListResult, error)
• func MaterialBind(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]file.FailedMaterialBind, error)
• func MaterialDetail(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]file.Material, error)
• func MaterialList(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.MaterialListData, error)
• func RebateMaterialSearch(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.RebateMaterialSearchResult, error)
• func VideoAd(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.Video, error)
• func VideoAdGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]file.Video, error)
• func VideoAgent(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.Video, error)
• func VideoAwemeGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.VideoAwemeGetResponseData, error)
• func VideoCoverSuggest(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.VideoCoverSuggestResponseData, error)
• func VideoDelete(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]string, error)
• func VideoEffeciencyGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]string, error)
• func VideoGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.VideoGetResponseData, error)
• func VideoMaterialClearTaskCreate(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (uint64, error)
• func VideoMaterialClearTaskGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.VideoMaterialClearTaskGetData, error)
• func VideoMaterialClearTaskResultGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.VideoMaterialClearTaskResultGetData, error)
• func VideoPause(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*file.VideoPauseResult, error)
• func VideoUpdate(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]file.VideoForUpdate, error)

Functions

func AudioAd

func AudioAd(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.AudioAdRequest) (*file.Audio, error)

AudioAd 上传图文内的音频素材

func CarouselAdGet

func CarouselAdGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.CarouselAdGetRequest) (*file.CarouselAdGetResult, error)

CarouselAdGet 获取同主体下广告主图集素材 通过此接口，用户可以查询获取同主体下的广告主图集素材信息。

func CarouselAwemeGet

func CarouselAwemeGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.CarouselAwemeGetRequest) (*file.CarouselAwemeGetResult, error)

CarouselAwemeGet 获取创编可用的抖音图文素材 该接口用于获取「巨量广告平台」创建广告时可用的抖音图文素材，您可以获取抖音图文素材的item_id，在广告创编接口使用。 您必须先和抖音号建立以下任意3种生效中的授权关系：抖音号授权、主页作品授权、单个作品授权，才可获取抖音图文素材 当抖音号下没有图文素材时，列表会返回为空

func CarouselCreate

func CarouselCreate(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.CarouselCreateRequest) (*file.Carousel, error)

CarouselCreate 上传图集 利用图片和音频塑造图集。 通过上传广告图片接口按顺序上传图集中的图片，获取图片id； 通过上传视频接口上传音频（video_file或video_url），获取音频id（video_id） 利用上述两步的图片、视频id塑造图集，获取出参图集mid。不同图片顺序对应不同的图集mid。

func CarouselDelete

func CarouselDelete(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.CarouselDeleteRequest) (*file.CarouselDeleteResult, error)

CarouselDelete 批量删除图集 通过此接口，用户可以对素材视频进行批量删除。当素材删除失败时，会展示在carousel_id列表，不在此列表内的素材表示删除成功！

func CarouselList

func CarouselList(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.CarouselListRequest) (*file.CarouselListResult, error)

CarouselList 获取图集素材 通过此接口，用户可以获取经过一定条件过滤后的广告主下创意素材库对应的图集及图集信息。

func CarouselUpdate

func CarouselUpdate(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.CarouselUpdateRequest) ([]file.CarouselUpdateResult, error)

CarouselUpdate 更新图集信息 更细图集信息，目前仅支持图集 file_name 和主题修改

func ImageAd

func ImageAd(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.ImageAdRequest) (*file.Image, error)

ImageAd 上传广告图片 通过此接口，用户可以上传和广告相关的素材图片，例如创意素材。 图片格式：jpg、jpeg、png、bmp、gif，大小1.5M内 上传的图片一定要符合格式，才会在投放平台素材库显示！ 若同一素材已进行上传，重新上传不会改名！

func ImageAdGet

func ImageAdGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.ImageAdGetRequest) ([]file.Image, error)

ImageAdGet 获取同主体下广告主图片素材 通过此接口，用户可以查询获取同主体下的广告主图片素材信息。 接口权限：查看图片的信息，获取图片md5、宽高、预览地址等内容，合理利用还可以搭建自己的素材库进行素材的管理。 - 为保证接口使用的安全性避免调取他人的图片信息，该接口只可用于查询自己公司下的图片信息，即需查询的图片ID所属广告主账号的主体需与APPID对应开发者的主体保持一致，才可获取到图片的信息！ - 如果您的开发者账号还未完成企业认证也将无法调用。请先完成企业认证！

func ImageAdvertiser

func ImageAdvertiser(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.ImageAdvertiserRequest) (*file.Image, error)

ImageAdvertiser 上传广告主图片 通过此接口，用户可以按照一定方式上传符合格式的广告主资质相关图片，例如营业执照等，接口会返回"code_0"和"message_OK"，代表上传成功 图片格式：jpg、jpeg、png、bmp、gif，大小1.5M内 此接口上传的是广告主资质图片，如需上传广告素材图片请调用【上传广告图片】接口！

func ImageGet

func ImageGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.ImageGetRequest) (*file.ImageGetResponseData, error)

ImageGet 获取图片素材 通过此接口，用户可以获取经过一定条件过滤后的广告主下创意素材库的图片及图片信息。 为保证接口使用的安全性，避免调取他人的图片信息，该接口针对素材URL的字段仅查询自己广告主下的素材才会返回，即需查询的广告主账号的主体需与APPID对应开发者的主体保持一致，才可获取到素材的预览URL的信息，否则会提示：“素材所属主体与开发者主体不一致无法获取URL”（第三方获取敏感物料信息可在授权时申请广告主授权敏感物料权限，可参考常见问题【敏感物料授权】）！ 对素材图片进行过滤的时候，image_ids（图片ID）、material_ids（素材ID）、signatures（图片的md5值）只能选择一个进行过滤！ 获取图片素材数据目前仅支持10000个！

func MaterialAttributesList

func MaterialAttributesList(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.MaterialAttributesListRequest) (*file.MaterialAttributesListResult, error)

MaterialAttributesList 获取视频素材评估标签（新版） 本接口是「获取素材标签列表」、「获取素材标签信息」接口的升级版，支持查询账户下视频库的素材评估标签。新接口在支持原接口能力的基础上，扩展了以下新能力： - account_id支持4类平台账户：巨量广告/巨量千川/工作台（组织）/方舟，即可查询4类账户下的素材评估标签。如果您管理账户量级大、查询素材量级多，可使用本接口，by工作台/方舟账户拉取账户下素材的评估标签

1. 工作台账户维度（即管家账户/纵横组织账户，现已更名）：可获取查询「资产」-「视频库」下所有视频素材的评估标签 2.方舟账户维度：可获取方舟代理公司下的视频素材评估标签

- 支持查询素材存在搬运风险标签：

1. 搬运授权保护的维度为广告账户，请使用巨量广告/巨量千川账户查询该标签。
2. 接口目前返回工作台/方舟账户维度下「存在搬运风险」标签，仅代表一个素材在工作台/方舟下的某个广告账户下存在搬运风险，暂不支持查询关联账户信息。

注意本接口支持在不同账户维度下查询素材的评估标签（创意生态标签介绍），能力支持情况如下： - 目前仅支持视频素材，可以获取的素材信息包括在投素材和不在投素材，查询结果不区分是否在投 - 巨量广告或千川的「低效素材」、「同质化挤压严重」、「同质化排队素材」可搭配「创建素材清理任务」/「获取清理任务列表」/「下载清理任务结果」3个素材清理接口使用

func MaterialBind

func MaterialBind(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.MaterialBindRequest) ([]file.FailedMaterialBind, error)

MaterialBind 素材推送 通过此接口，用户可以进行同主体下不同广告主间的素材的推送。也就是说，将A广告主素材推送到，与A广告主主体（公司）相同的广告主。 推送后素材的名称不会改变，将使用推送的原素材名！ 推送前需确认推送素材属于当前操作广告主，可通过【获取图片素材】和【获取视频素材】接口确认！ 新上传素材存在同步延迟情况，建议等待2-3分钟再尝试操作推送！ 当素材已存在待推送的广告主的素材库内时，不会重复推送，推送失败的结果会在推送失败列表展示！

func MaterialDetail

func MaterialDetail(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.MaterialDetailRequest) ([]file.Material, error)

MaterialDetail 查询素材标签信息 素材信息查询，根据提供的素材 id 查询素材属性信息，目前仅支持视频素材

func MaterialList

func MaterialList(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.MaterialListRequest) (*file.MaterialListData, error)

MaterialList 获取素材标签列表 根据 adv 检索素材列表的接口，返回结果包含素材属性，支持素材属性标签筛选，目前仅支持视频素材

func RebateMaterialSearch

func RebateMaterialSearch(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.RebateMaterialSearchRequest) (*file.RebateMaterialSearchResult, error)

RebateMaterialSearch 【代理商】明点无效素材查询 支持根据代理商id和月份日期等入参数，查找返点政策粒度下的有效/无效素材

func VideoAd

func VideoAd(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoAdRequest) (*file.Video, error)

VideoAd 上传视频 通过此接口，用户可以上传和广告相关的素材视频。 视频格式：mp4、mpeg、3gp、avi

func VideoAdGet

func VideoAdGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoAdGetRequest) ([]file.Video, error)

VideoAdGet 获取同主体下广告主视频素材 通过此接口，用户可以查询同主体下的广告主视频信息。 接口权限：查看视频的信息，获取视频md5、宽高、预览地址等内容，合理利用还可以搭建自己的素材库进行素材的管理。 - 为保证接口使用的安全性避免调取他人的视频信息，该接口只可用于查询自己公司下的视频信息，即需查询的视频ID所属广告主账号的主体需与APPID对应开发者的主体保持一致，才可获取到图片的信息！ - 如果您的开发者账号还未完成企业认证也将无法调用。请先完成企业认证！

func VideoAgent

func VideoAgent(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoAgentRequest) (*file.Video, error)

VideoAgent 【代理商】上传自产首发素材至方舟（搬运治理） 代理商可以通过此接口将「首发素材」上传视频素材至巨量方舟，上传后「首发素材」即可自动完成保护（前置需要先完成整体保护授权，参考详细文档介绍「搬运治理-首发保护」说明手册（可对外））。保护后系统将根据代理授权范围识别搬运素材生效打压，避免其他方抢夺代理的流量。 注意1：建议代理商务必将自己制作的「首发素材」先通过本接口上传到方舟平台（素材才可能按照代理授权生效，否则可能会被客户先做授权保护），避免素材被其他方抢先保护。 注意2：非首发素材，即使进行上传也不会生效授权保护（点此查看「首发素材」相关说明） 注意3：调用接口上传的素材可在“方舟平台-优化-搬运治理页面”查看

func VideoAwemeGet

func VideoAwemeGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoAwemeGetRequest) (*file.VideoAwemeGetResponseData, error)

VideoAwemeGet 获取抖音号下的视频 获取抖音号下已有的视频素材，支持传入商品id，过滤拉取包含待推广商品的视频 1、仅自定义创意支持选择抖音号视频，程序化创意不支持 2、短视频带货场景下，仅支持选择抖音号下已关联相应推广商品的视频 3、由于素材库存在分钟级延迟，上传素材后请勿立即获取并创建计划

func VideoCoverSuggest

func VideoCoverSuggest(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoCoverSuggestRequest) (*file.VideoCoverSuggestResponseData, error)

VideoCoverSuggest 获取视频智能封面 通过此接口，用户可以获取针对素材视频推荐的智能封面。智能封面是通过提取视频关键帧筛选出推荐封面，帮助发现视频内优质封面素材。 推荐封面图片的数量是1-13个，对于相似度极高的封面图片会进行去重等处理，由实际的视频内容和时长决定。 智能封面不是实时获取，而需要先根据status判断封面获取的状态，然后再进行获取视频封面！ 新上传素材存在同步延迟情况，建议等待2-3分钟再尝试操作获取视频智能封面！ 获取封面素材仅用于当前广告主投放使用，不支持推送！

func VideoDelete

func VideoDelete(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoDeleteRequest) ([]string, error)

VideoDelete 批量删除视频素材 通过此接口，用户可以对素材视频进行批量删除。 当素材删除失败时，会展示在video_id列表，不在此列表内的素材表示删除成功！

func VideoEffeciencyGet

func VideoEffeciencyGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoEffeciencyGetRequest) ([]string, error)

VideoEffeciencyGet 获取低效素材 支持查询素材是否是低效素材，传入素材ID列表，返回低效素材列表。

func VideoGet

func VideoGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoGetRequest) (*file.VideoGetResponseData, error)

VideoGet 获取视频素材 通过此接口，用户可以获取经过一定条件过滤后的广告主下创意素材库对应的视频及视频信息。

func VideoMaterialClearTaskCreate

func VideoMaterialClearTaskCreate(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoMaterialClearTaskCreateRequest) (uint64, error)

VideoMaterialClearTaskCreate 创建素材清理任务 创建低效/同质素材清理任务的异步接口，最多同时创建10个运行中的清理任务，配合「获取清理任务列表」、「下载清理任务结果」接口使用

func VideoMaterialClearTaskGet

func VideoMaterialClearTaskGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoMaterialClearTaskGetRequest) (*file.VideoMaterialClearTaskGetData, error)

VideoMaterialClearTaskGet 获取清理任务列表 返回已创建的低效/同质视频素材清理任务列表

func VideoMaterialClearTaskResultGet

func VideoMaterialClearTaskResultGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoMaterialClearTaskResultGetRequest) (*file.VideoMaterialClearTaskResultGetData, error)

VideoMaterialClearTaskResultGet 下载清理任务结果 根据adv_id和clear_id返回低效/同质视频素材的清理结果，与「创建素材清理任务」、「获取清理任务列表」接口配合使用

func VideoPause

func VideoPause(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoPauseRequest) (*file.VideoPauseResult, error)

VideoPause 按账户暂停素材

func VideoUpdate

func VideoUpdate(ctx context.Context, clt *core.SDKClient, accessToken string, req *file.VideoUpdateRequest) ([]file.VideoForUpdate, error)

VideoUpdate 更新视频 通过此接口，用户可以批量更新素材视频的名称。