Documentation ¶
Overview ¶
Package datasource 数据源相关API models
Index ¶
- Variables
- type Audience
- type ChangeLog
- type CreateRequest
- type CreateResponse
- type CreateResponseData
- type DataSource
- type DmpData
- type FileUploadRequest
- type FileUploadResponse
- type FileUploadResponseData
- type IdItem
- func (*IdItem) Descriptor() ([]byte, []int)deprecated
- func (x *IdItem) GetDataType() IdItem_DataType
- func (x *IdItem) GetId() string
- func (x *IdItem) GetTags() []string
- func (x *IdItem) GetTimestamp() uint32
- func (*IdItem) ProtoMessage()
- func (x *IdItem) ProtoReflect() protoreflect.Message
- func (x *IdItem) Reset()
- func (x *IdItem) String() string
- type IdItem_DataType
- func (IdItem_DataType) Descriptor() protoreflect.EnumDescriptor
- func (x IdItem_DataType) Enum() *IdItem_DataType
- func (IdItem_DataType) EnumDescriptor() ([]byte, []int)deprecated
- func (x IdItem_DataType) Number() protoreflect.EnumNumber
- func (x IdItem_DataType) String() string
- func (IdItem_DataType) Type() protoreflect.EnumType
- func (x *IdItem_DataType) UnmarshalJSON(b []byte) errordeprecated
- type ReadRequest
- type ReadResponse
- type ReadResponseData
- type UpdateRequest
Constants ¶
This section is empty.
Variables ¶
var ( IdItem_DataType_name = map[int32]string{ 0: "IMEI", 1: "IDFA", 2: "UID", 4: "IMEI_MD5", 5: "IDFA_MD5", 6: "MOBILE_HASH_SHA256", 7: "OAID", 8: "OAID_MD5", } IdItem_DataType_value = map[string]int32{ "IMEI": 0, "IDFA": 1, "UID": 2, "IMEI_MD5": 4, "IDFA_MD5": 5, "MOBILE_HASH_SHA256": 6, "OAID": 7, "OAID_MD5": 8, } )
Enum value maps for IdItem_DataType.
var File_github_com_bububa_oceanengine_marketing_api_model_dmp_datasource_dmp_proto protoreflect.FileDescriptor
Functions ¶
This section is empty.
Types ¶
type Audience ¶
type Audience struct { // AdvertiserID 广告主id AdvertiserID uint64 `json:"advertiser_id,omitempty"` // CustomAudienceID 人群包id CustomAudienceID uint64 `json:"custom_audience_id,omitempty"` // Name 人群包名称 Name string `json:"name,omitempty"` // CustomType 人群类型,枚举值见【DMP相关-人群类型】 CustomType enum.DmpCustomType `json:"custom_type,omitempty"` // Source 来源,枚举值见【DMP相关-人群包来源】 Source int `json:"source,omitempty"` // Status 人群包状态,枚举值见【DMP相关-人群包状态】 Status int `json:"status,omitempty"` // PushStatus 推送状态,枚举值见【DMP相关-DMP推送状态】 PushStatus enum.DmpPushStatus `json:"push_status,omitempty"` // UploadNum 上传数据源包含的人群数目 UploadNum int64 `json:"upload_num,omitempty"` // CoverNum 人群包覆盖人群数目,基于"upload_num":上传数据源包含的人群数目与uid对应后,再与头条系产品MAU交集后的数量(存在一个设备号/手机号对应多个uid的情况) // 实际数量可能多于/少于"upload_num":上传数据源包含的人群数目 CoverNum int64 `json:"cover_num,omitempty"` // ExpireDate 人群包过期时间 ExpireDate string `json:"expire_date,omitempty"` // CreateTime 人群包创建时间 CreateTime string `json:"create_time,omitempty"` // ModifyTime 人群包修改时间 ModifyTime string `json:"modify_time,omitempty"` // Isdel 删除标志,枚举值:"1":已删除,"0":未删除 IsDel int `json:"isdel,omitempty"` // CalculateSubType 计算子类型 CalculateSubType int `json:"calculate_sub_type,omitempty"` // CalculateType 计算类型 CalculateType int `json:"calculate_type,omitempty"` // DataSourceID 数据源id DataSourceID string `json:"data_source_id,omitempty"` // Tag 人群包标签,通过数据源创建的人群包,标签会默认为“API文件数据源” Tag string `json:"tag,omitempty"` // ThirdPartyInfo 三方信息,均返回“非三方包” ThirdPartyInfo string `json:"third_party_info,omitempty"` // DeliveryStatus 人群包可投放状态,只有当状态为CUSTOM_AUDIENCE_DELIVERY_STATUS_AVAILABLE时才可进行投放使用 // 可选值: // CUSTOM_AUDIENCE_DELIVERY_STATUS_AVAILABLE:可投放,人群包发布完成且推送完成 // CUSTOM_AUDIENCE_DELIVERY_STATUS_NEED_PUSH:不可投放,人群包发布完成,但未推送,需要进行推送后再使用 // CUSTOM_AUDIENCE_DELIVERY_STATUS_NEED_PUBLISH:不可投放,群包未发布但已推送,需要进行发布后再使用 //CUSTOM_AUDIENCE_DELIVERY_STATUS_UNAVAILABLE:不可投放,未发布完成且未推送 DeliveryStatus enum.CustomAudienceDeliveryStatus `json:"delivery_status,omitempty"` }
Audience 数据源对应的人群包,如果还未生成将不会返回
type ChangeLog ¶
type ChangeLog struct { // Action 本次更新进行的操作,枚举值:"0":新建,"1":添加,"2":删除,"3":重置 Action enum.DmpDatasourceOperationType `json:"action,omitempty"` // FilePaths 使用数据源文件上传文件后返回的文件路径参数 FilePaths []string `json:"file_paths,omitempty"` // Status 本次更新的状态,枚举值:"0":新建,"1":处理中,"2":生效,"3":失败 Status enum.DataSourceStatus `json:"status,omitempty"` // CreateTime 本次更新创建时间 CreateTime string `json:"create_time,omitempty"` // ModifyTime 本次更新完成时间 ModifyTime string `json:"modify_time,omitempty"` // ID 更新日志id ID int64 `json:"change_log_id,omitempty"` // PublishTime 数据源本次更新发布完成时间记录 PublishTime string `json:"publish_time,omitempty"` }
ChangeLog 每一次更新,会记录一次日志id
type CreateRequest ¶
type CreateRequest struct { // AdvertiserID 广告主ID AdvertiserID uint64 `json:"advertiser_id,omitempty"` // DataSourceName 数据源名称, 限30个字符内 DataSourceName string `json:"data_source_name,omitempty"` // Description 数据源描述, 限256个字符内 Description string `json:"description,omitempty"` // DataFormat 数据格式, 枚举值:"0":ProtocolBuffer DataFormat int `json:"data_format"` // FileStorageType 数据存储类型, 枚举值:"0":API FileStorageType int `json:"file_storage_type"` // FilePaths 通过【数据源文件上传】接口得到的文件路径,注意:一次上传最多1000个 FilePaths []string `json:"file_paths,omitempty"` // DataSourceType 投放数据源类型,枚举值如下: "UID":用户ID, "DID":设备ID ,默认值: "UID" DataSourceType string `json:"data_source_type,omitempty"` }
CreateRequest 数据源创建API Request
func (CreateRequest) Encode ¶
func (r CreateRequest) Encode() []byte
Encode implement PostRequest interface
type CreateResponse ¶
type CreateResponse struct { model.BaseResponse // Data json返回值, 其中data_source_id参数包含唯一标识数据源的字符串 Data *CreateResponseData `json:"data,omitempty"` }
CreateResponse 数据源创建API Response
type CreateResponseData ¶
type CreateResponseData struct { // DataSourceID 数据源id, 唯一标识数据源的字符串 DataSourceID string `json:"data_source_id,omitempty"` }
CreateResponseData json返回值, 其中data_source_id参数包含唯一标识数据源的字符串
type DataSource ¶
type DataSource struct { // Name 数据源名称 Name string `json:"name,omitempty"` // ID 数据源ID ID string `json:"data_source_id,omitempty"` // Description 数据源描述 Description string `json:"description,omitempty"` // Status 数据源初次创建状态,枚举值:"0":已创建,"1":解析中暂不可用,"2":完成 Status enum.DataSourceStatus `json:"status,omitempty"` // CoverNum 人群包覆盖人群数目,基于"upload_num":上传数据源包含的人群数目与uid对应后,再与头条系产品MAU交集后的数量(存在一个设备号/手机号对应多个uid的情况) // 实际数量可能多于/少于"upload_num":上传数据源包含的人群数目 CoverNum int64 `json:"cover_num,omitempty"` // UploadNum 上传数据源包含的人群数目 UploadNum int64 `json:"upload_num,omitempty"` // CreateTime 数据源创建时间 CreateTime string `json:"create_time,omitempty"` // ModifyTime 数据源修改时间 ModifyTime string `json:"modify_time,omitempty"` // LatestPublishedChangeLogID 数据源最近一次更新对应的日志id,若未完成更新,返回“-1 LatestPublishedChangeLogID int64 `json:"latest_published_changelog_id,omitempty"` // LatestPublishedTime 数据源最近一次发布完成时间 LatestPublishedTime string `json:"latest_published_time,omitempty"` // DataSourceType 数据源类型,枚举值:"UID":用户ID,"DID" :设备ID DataSourceType string `json:"data_source_type,omitempty"` // ChangeLogs 每一次更新,会记录一次日志id ChangeLogs []ChangeLog `json:"change_logs,omitempty"` // DefaultAudience 数据源对应的人群包,如果还未生成将不会返回 DefaultAudience *Audience `json:"default_audience,omitempty"` }
DataSource 数据源信息
type DmpData ¶
type DmpData struct { IdList []*IdItem `protobuf:"bytes,1,rep,name=idList" json:"idList,omitempty"` // 每行数据包含的idList大小不能超过10000 // contains filtered or unexported fields }
func (*DmpData) Descriptor
deprecated
func (*DmpData) ProtoMessage ¶
func (*DmpData) ProtoMessage()
func (*DmpData) ProtoReflect ¶
func (x *DmpData) ProtoReflect() protoreflect.Message
type FileUploadRequest ¶
type FileUploadRequest struct { // AdvertiserID 广告主ID AdvertiserID uint64 `json:"advertiser_id,omitempty"` // File 文件 File io.Reader `json:"file,omitempty"` // Filename 文件名 Filename string `json:"filename,omitempty"` // FileSignature 文件MD5 FileSignature string `json:"file_signature,omitempty"` }
FileUploadRequest 数据源文件上传 API Request
func (FileUploadRequest) Encode ¶
func (r FileUploadRequest) Encode() []model.UploadField
Encode implement UploadReqeust interface
type FileUploadResponse ¶
type FileUploadResponse struct { model.BaseResponse Data *FileUploadResponseData `json:"data,omitempty"` }
FileUploadResponse 数据文件上传API Response
type FileUploadResponseData ¶
type FileUploadResponseData struct { // FilePath 文件路径,包含作为文件唯一标识的字符串(14天后文件路径过期) FilePath string `json:"file_path,omitempty"` }
FileUploadResponseData json返回值
type IdItem ¶
type IdItem struct { Timestamp *uint32 `protobuf:"varint,1,opt,name=timestamp" json:"timestamp,omitempty"` //若不设置,默认以上传文件的创建时间为此条记录的创建时间 DataType *IdItem_DataType `protobuf:"varint,2,req,name=dataType,enum=toutiao.dmp.IdItem_DataType" json:"dataType,omitempty"` //指定此id的类型,如IMEI、IDFA等 Id *string `protobuf:"bytes,3,req,name=id" json:"id,omitempty"` //根据dataType字段的类型,放置对应类型的id的字符串,需要小写 Tags []string `protobuf:"bytes,4,rep,name=tags" json:"tags,omitempty"` //标识此id的业务标签字符串 // contains filtered or unexported fields }
func (*IdItem) Descriptor
deprecated
func (*IdItem) GetDataType ¶
func (x *IdItem) GetDataType() IdItem_DataType
func (*IdItem) GetTimestamp ¶
func (*IdItem) ProtoMessage ¶
func (*IdItem) ProtoMessage()
func (*IdItem) ProtoReflect ¶
func (x *IdItem) ProtoReflect() protoreflect.Message
type IdItem_DataType ¶
type IdItem_DataType int32
const ( IdItem_IMEI IdItem_DataType = 0 IdItem_IDFA IdItem_DataType = 1 IdItem_UID IdItem_DataType = 2 IdItem_IMEI_MD5 IdItem_DataType = 4 IdItem_IDFA_MD5 IdItem_DataType = 5 IdItem_MOBILE_HASH_SHA256 IdItem_DataType = 6 IdItem_OAID IdItem_DataType = 7 IdItem_OAID_MD5 IdItem_DataType = 8 )
func (IdItem_DataType) Descriptor ¶
func (IdItem_DataType) Descriptor() protoreflect.EnumDescriptor
func (IdItem_DataType) Enum ¶
func (x IdItem_DataType) Enum() *IdItem_DataType
func (IdItem_DataType) EnumDescriptor
deprecated
func (IdItem_DataType) EnumDescriptor() ([]byte, []int)
Deprecated: Use IdItem_DataType.Descriptor instead.
func (IdItem_DataType) Number ¶
func (x IdItem_DataType) Number() protoreflect.EnumNumber
func (IdItem_DataType) String ¶
func (x IdItem_DataType) String() string
func (IdItem_DataType) Type ¶
func (IdItem_DataType) Type() protoreflect.EnumType
func (*IdItem_DataType) UnmarshalJSON
deprecated
func (x *IdItem_DataType) UnmarshalJSON(b []byte) error
Deprecated: Do not use.
type ReadRequest ¶
type ReadRequest struct { // AdvertiserID 广告主ID AdvertiserID uint64 `json:"advertiser_id,omitempty"` // DataSourceIDList 数据源ID列表 // 一次最多传400个数据源id DataSourceIDList []string `json:"data_source_id_list,omitempty"` }
ReadRequest 数据源详细信息 API Request
func (ReadRequest) Encode ¶
func (r ReadRequest) Encode() string
Encode implement GetRequest interface
type ReadResponse ¶
type ReadResponse struct { model.BaseResponse // Data json返回值 Data *ReadResponseData `json:"data,omitempty"` }
ReadResponse 数据源详细信息 API Response
type ReadResponseData ¶
type ReadResponseData struct { // DataList 数据信息列表 DataList []DataSource `json:"data_list,omitempty"` }
ReadResponseData json返回值
type UpdateRequest ¶
type UpdateRequest struct { // AdvertiserID 广告主ID AdvertiserID uint64 `json:"advertiser_id,omitempty"` // DataSourceID 数据源ID DataSourceID string `json:"data_source_id,omitempty"` // OperationType 更新操作类型, 枚举值:"1" :添加,"2":删除, "3":重置 OperationType enum.DmpDatasourceOperationType `json:"operation_type,omitempty"` // DataFormat 数据格式, 枚举值:"0":ProtocolBuffer DataFormat int `json:"data_format"` // FileStorageType 数据存储类型, 枚举值:"0":API FileStorageType int `json:"file_storage_type"` // FilePaths 通过【数据源文件上传】接口得到的文件路径,注意:一次上传最多1000个 FilePaths []string `json:"file_paths,omitempty"` }
UpdateRequest 数据源更新API Request
func (UpdateRequest) Encode ¶
func (r UpdateRequest) Encode() []byte
Encode implement PostRequest interface