file

Documentation

Overview

Package file 素材管理相关API

Index

• func AudioAd(clt *core.SDKClient, accessToken string, req *file.AudioAdRequest) (*file.Audio, error)
• func CarouselAdGet(clt *core.SDKClient, accessToken string, req *file.CarouselAdGetRequest) (*file.CarouselAdGetResult, error)
• func CarouselCreate(clt *core.SDKClient, accessToken string, req *file.CarouselCreateRequest) (*file.Carousel, error)
• func CarouselDelete(clt *core.SDKClient, accessToken string, req *file.CarouselDeleteRequest) (*file.CarouselDeleteResult, error)
• func CarouselList(clt *core.SDKClient, accessToken string, req *file.CarouselListRequest) (*file.CarouselListResult, error)
• func CarouselUpdate(clt *core.SDKClient, accessToken string, req *file.CarouselUpdateRequest) ([]file.CarouselUpdateResult, error)
• func ImageAd(clt *core.SDKClient, accessToken string, req *file.ImageAdRequest) (*file.Image, error)
• func ImageAdGet(clt *core.SDKClient, accessToken string, req *file.ImageAdGetRequest) ([]file.Image, error)
• func ImageAdvertiser(clt *core.SDKClient, accessToken string, req *file.ImageAdvertiserRequest) (*file.Image, error)
• func ImageGet(clt *core.SDKClient, accessToken string, req *file.ImageGetRequest) (*file.ImageGetResponseData, error)
• func MaterialAttributesList(clt *core.SDKClient, accessToken string, ...) (*file.MaterialAttributesListResult, error)
• func MaterialBind(clt *core.SDKClient, accessToken string, req *file.MaterialBindRequest) ([]file.FailedMaterialBind, error)
• func MaterialDetail(clt *core.SDKClient, accessToken string, req *file.MaterialDetailRequest) ([]file.Material, error)
• func MaterialList(clt *core.SDKClient, accessToken string, req *file.MaterialListRequest) (*file.MaterialListData, error)
• func RebateMaterialSearch(clt *core.SDKClient, accessToken string, req *file.RebateMaterialSearchRequest) (*file.RebateMaterialSearchResult, error)
• func VideoAd(clt *core.SDKClient, accessToken string, req *file.VideoAdRequest) (*file.Video, error)
• func VideoAdGet(clt *core.SDKClient, accessToken string, req *file.VideoAdGetRequest) ([]file.Video, error)
• func VideoAwemeGet(clt *core.SDKClient, accessToken string, req *file.VideoAwemeGetRequest) (*file.VideoAwemeGetResponseData, error)
• func VideoCoverSuggest(clt *core.SDKClient, accessToken string, req *file.VideoCoverSuggestRequest) (*file.VideoCoverSuggestResponseData, error)
• func VideoDelete(clt *core.SDKClient, accessToken string, req *file.VideoDeleteRequest) ([]string, error)
• func VideoEffeciencyGet(clt *core.SDKClient, accessToken string, req *file.VideoEffeciencyGetRequest) ([]string, error)
• func VideoGet(clt *core.SDKClient, accessToken string, req *file.VideoGetRequest) (*file.VideoGetResponseData, error)
• func VideoMaterialClearTaskCreate(clt *core.SDKClient, accessToken string, ...) (uint64, error)
• func VideoMaterialClearTaskGet(clt *core.SDKClient, accessToken string, ...) (*file.VideoMaterialClearTaskGetData, error)
• func VideoMaterialClearTaskResultGet(clt *core.SDKClient, accessToken string, ...) (*file.VideoMaterialClearTaskResultGetData, error)
• func VideoPause(clt *core.SDKClient, accessToken string, req *file.VideoPauseRequest) (*file.VideoPauseResult, error)
• func VideoUpdate(clt *core.SDKClient, accessToken string, req *file.VideoUpdateRequest) ([]file.VideoForUpdate, error)

Functions

func AudioAd

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

AudioAd 上传图文内的音频素材

func CarouselAdGet

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

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

func CarouselCreate

func CarouselCreate(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(clt *core.SDKClient, accessToken string, req *file.CarouselDeleteRequest) (*file.CarouselDeleteResult, error)

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

func CarouselList

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

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

func CarouselUpdate

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

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

func ImageAd

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

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

func ImageAdGet

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

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

func ImageAdvertiser

func ImageAdvertiser(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(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(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(clt *core.SDKClient, accessToken string, req *file.MaterialBindRequest) ([]file.FailedMaterialBind, error)

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

func MaterialDetail

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

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

func MaterialList

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

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

func RebateMaterialSearch

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

RebateMaterialSearch 获取低效素材List

func VideoAd

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

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

func VideoAdGet

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

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

func VideoAwemeGet

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

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

func VideoCoverSuggest

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

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

func VideoDelete

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

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

func VideoEffeciencyGet

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

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

func VideoGet

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

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

func VideoMaterialClearTaskCreate

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

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

func VideoMaterialClearTaskGet

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

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

func VideoMaterialClearTaskResultGet

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

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

func VideoPause

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

VideoPause 按账户暂停素材

func VideoUpdate

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

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