file

Documentation

Overview

Package file 素材管理相关API

Index

• func ImageDelete(clt *core.SDKClient, accessToken string, req *file.ImageDeleteRequest) ([]string, error)
• func ImageGet(clt *core.SDKClient, accessToken string, req *file.ImageGetRequest) (*file.ImageGetResult, error)
• func VideoAwemeGet(clt *core.SDKClient, accessToken string, req *file.VideoAwemeGetRequest) (*file.VideoAwemeGetResponseData, 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.VideoGetResult, error)
• func VideoOriginalGet(clt *core.SDKClient, accessToken string, req *file.VideoOriginalGetRequest) ([]string, error)

Functions

func ImageDelete

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

ImageDelete 批量删除图片素材 通过此接口，用户可以批量删除广告主下创意素材库的图片。

func ImageGet

func ImageGet(clt *core.SDKClient, accessToken string, req *file.ImageGetRequest) (*file.ImageGetResult, error)

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

func VideoAwemeGet

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

VideoAwemeGet 获取抖音号下的视频 获取抖音号下已有的视频素材，支持传入商品id，过滤拉取包含待推广商品的视频 1、仅自定义创意支持选择抖音号视频，程序化创意不支持 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列表，返回低效素材列表。 1.什么是低效素材？ 在一定历史投放周期内，素材累积消耗低于系统标准，即定义为低效素材。 目前低效素材仅针对视频素材进行识别。 2.低效素材有什么影响？ 根据整体数据分析，无论是复用低效素材新建计划或将低效素材稍加修改后重新使用，低效素材起量的可能性较小，进而影响计划的跑量能力； 如计划下出现大量低效素材，则该计划预计跑量困难，占用在投计划配额、投放人力和投放预算，建议更换素材。 3. 如依然使用低效素材会产生哪些问题？ 如果新建创意下素材全部为低效素材，那么创意将无法创建成功，建议更换其他素材。创建广告创意相关接口的拦截功能将于2023年1月初上线。请务必提前关注【获取低效素材】接口，进行低效素材识别和管理。

func VideoGet

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

VideoGet 获取千川素材库视频 该接口用于获取千川素材库视频 获取视频素材数据目前仅支持10000个 对素材视频进行过滤的时候，video_ids（视频ID）、material_ids（素材ID）、signatures（视频的md5值）只能选择一个进行过滤 为保证接口使用的安全性，避免调取他人的视频信息，该接口针对素材URL的字段仅查询自己广告主下的素材才会返回，即需查询的广告主账号的主体需与APPID对应开发者的主体保持一致，才可获取到素材的预览URL的信息，否则会提示：“素材所属主体与开发者主体不一致无法获取URL”（第三方获取敏感物料信息可在授权时申请广告主授权敏感物料权限，可参考常见问题【敏感物料授权】） 由于素材库存在分钟级延迟，上传素材后请勿立即获取并创建计划。

func VideoOriginalGet

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

VideoOriginalGet 获取首发素材 支持查询素材是否是首发素材，传入素材ID列表，返回首发素材列表。