datasource

Documentation

Overview

Package datasource 数据源相关API

Index

• func Create(clt *core.SDKClient, accessToken string, req *datasource.CreateRequest) (string, error)
• func FileUpload(clt *core.SDKClient, accessToken string, req *datasource.FileUploadRequest) (string, error)
• func Read(clt *core.SDKClient, accessToken string, req *datasource.ReadRequest) ([]datasource.DataSource, error)
• func Update(clt *core.SDKClient, accessToken string, req *datasource.UpdateRequest) error

Functions

func Create

func Create(clt *core.SDKClient, accessToken string, req *datasource.CreateRequest) (string, error)

Create 数据源创建 通过【数据源文件上传】接口得到file_path文件路径后，调用当前接口将数据源文件创建成一个数据源，创建成功后会返回一个数据源id，作为数据源的唯一标识。 数据源创建完成后，系统会进行一个数据源解析的过程，将数据源解析成对应的人群包，这个过程大概持续20-60分钟；（同时使用该功能的用户数量多时可能造成解析时间较长，超出60分钟，具体时长将由具体任务量决定，请耐心等待）。 人群包的生成进度可通过【数据源详细信息】查询。 目前每个广告主账号一天只能创建100次数据源，超出报错！ 一次上传的file_paths文件路径限制个数为1000，超出报错！

func FileUpload

func FileUpload(clt *core.SDKClient, accessToken string, req *datasource.FileUploadRequest) (string, error)

FileUpload 数据源文件上传 当用户需要上传本地数据到DMP数据平台上时，需要使用数据源文件上传功能。用户上传数据源文件后会返回文件路径file_path，用于调用【数据源创建】时创建相应的数据源。 文件内容：可接受的文件内容为设备id和用户id，需要在序列化时选择相应的匹配类型。 文件格式：数据源文件需要经过protocal buffer序列化,序列化具体操作方式参见【DMP相关附录-DMP上传数据格式】。数据源序列化后需要压缩成zip文件； 文件个数：不限制压缩包内文件个数。 压缩包大小不超过50M！ 接口限制了10s超时，建议文件不要太大！

func Read

func Read(clt *core.SDKClient, accessToken string, req *datasource.ReadRequest) ([]datasource.DataSource, error)

Read 数据源详细信息 通过数据源id，查询该数据源相关信息和其对应的人群包信息。数据源解析完成后会返回default_audience：数据源对应的人群包相关信息，其中人群包ID是该人群包的唯一标识。解析未完成不返回default_audience：数据源对应的人群包相关信息。 数据源解析成人群包后，调用该接口会返回该数据源对应的人群包的人群包id，作为该人群包的标识； 数据源在创建后被解析成人群包需要20-60分钟。高峰期可能造成解析时间延长，请您耐心等待； 本接口可以批量查询多个数据源的信息。其中应答参数是按create_time：数据源创建时间倒序返回的。如果您有数据处理的需求，可以参考此排序逻辑。

func Update

func Update(clt *core.SDKClient, accessToken string, req *datasource.UpdateRequest) error

Update 数据源更新 用户可以调用该接口在原有的数据源上进行添加、删除、重置操作。 数据源更新不会导致数据源id发生变化。用户可以在【数据源详细信息】查看更新是否完成。当lastest_published_time:数据源最近一次发布时间返回的数据被覆盖为最新的更新发布时间后，则说明最近一次更新已经完成。 添加：将需要添加的数据源文件内容通过调用【数据源文件上传】的方式获得文件路径file_path，作为【数据源更新】的请求参数file_paths添加到当前数据源内； 删除：将需要删除的数据源文件内容通过调用【数据源文件上传】的方式获得文件路径file_path，作为【数据源更新】的请求参数file_paths进行删除操作，删除掉当前数据源内这部分内容； 重置：将需要替换的新数据源内容通过调用【数据源文件上传】的方式获得文件路径file_path，作为【数据源更新】的请求参数file_paths进行重置操作，替换掉当前数据源内的内容； 每一个数据源一天只能更新50次,建议合理使用更新次数，减少无效的更新！ 每次更新数据源后，都需要重新调用【发布人群包】接口发布人群包才能让对应的更新生效！否则人群包将使用更新前的数据源！ 在调用【发布人群包】接口发布人群包的过程中，建议不要更新数据源，这会导致人群包发布过程延后！