搜索推广API

    ToolKitService

    更新时间：2019-08-08

    历史操作记录查询。

    数据类型

    GetOperationRecordParams

    操作记录请求。

    属性名类型说明限制
    startDatedateTime统计开始时间，格式参考：
    2010-08-01    		必填（天粒度）；提供最近一个月的数据，如今天是9.25，
    则可以查询8.26 ~ 9.25号的数据
    endDatedateTime统计结束时间，格式参考：
    2010-08-17    		必填（天粒度）
    optTypesInteger[]指定返回的操作类型选填，可多选，不填默认为全部。
    有效的type取值如下：
    1：设置；
    2：新增；
    3：删除；
    4：修改；
    5：暂停；
    6：启用；
    7：重命名；
    8：激活；
    9：取消；
    10：系统激活；
    11：关键词转移
    optLevelInteger指定返回的层级必填；
    1：推广单元；
    2：推广计划；
    3：帐户；
    4：创意；
    5：关键词；
    7：蹊径子链；
    8：App推广；
    9：推广电话；
    10：商桥；
    11：页面回呼；
    12：动态创意
    optContentsString[]针对特定的层级，返回特定操作的操作记录选填，可多选，为填默认为全部；
    各层级有效操作项（optContents）参见后表。

    各层级optContents有效取值如下：

    • 帐户（3）
    Content中文Content英文备注
    预算budgetbudget为复合content，包括以下5种content：
    日预算、
    日预算->日预算、
    日预算->周预算、
    周预算->日预算、
    周预算->周预算
    每日预算dailyBudget-
    日预算->日预算budgetDay2Day-
    日预算->周预算budgetDay2Week-
    周预算->日预算budgetWeek2Day-
    周预算->周预算budgetWeek2Week-
    推广地域zone-
    激活时长设置materialActive-
    IP排除ipExclude-
    搜索意图定位queryRegion-
    动态创意dynamicIdeaStat-
    修改搜索合作网络出价updExternalFlow-
    • 帐户（2）
    Content中文Content英文备注
    新建计划addPlan
    删除推广计划delPlan
    暂停/启用推广shelve
    推广时段管理cycShelve
    每日预算dailyBudget
    推广地域zone
    IP排除ipExclude
    展现方式showFac
    否定关键词negativeWord
    精确否定关键词accurateNegativeWord
    参加网盟推广cproJoin
    网盟推广出价setCproPrice
    勾选投放设备deviceCfgStat
    切换投放设备targetDevice
    推广电话phoneNumber
    商桥移动咨询bridge
    修改移动出价mobilePrice
    搜索意图定位queryRegion
    动态创意dynamicIdeaStat
    • 帐户（1）
    Content中文Content英文备注
    新建单元addUnit
    删除单元delUnit
    暂停/启用推广shelve
    修改单元出价bidPrice
    编辑单元名称updUnitName
    否定关键词negativeWord
    精确否定关键词accurateNegativeWord
    修改移动出价比例mobilePriceFactor
    分匹配模式出价matchPriceFactorStatus
    修改分匹配模式出价matchPriceFactor
    • 关键词（5）
    Content中文Content英文备注
    添加关键词addWord
    删除关键词delWord
    暂停/启用推广shelve
    修改关键词出价bidPrice
    匹配方式updWordMatch
    激活关键词active
    转移关键词wordTransfer
    关键词URLupdWordUrl
    移动URLupdWordMobileUrl
    接受/不接受分匹配模式出价matchPrefer
    • 关键词（4）
    Content中文Content英文备注
    新建创意addIdea
    删除创意delIdea
    暂停/启用推广shelve
    编辑创意updIdea
    激活创意active
    修改设备偏好deviceOpt
    • 蹊径子链（7）
    Content中文Content英文备注
    新建子链addSublink
    删除子链delSublink
    编辑子链updSublink
    暂停/启用子链shelveSublink
    • App推广（8）
    Content中文Content英文备注
    新建app推广addAppCreative
    删除app推广delAppCreative
    修改app推广updAppCreative
    暂停/启用app推广shelveAppCreative
    • 推广电话（9）
    Content中文Content英文备注
    新建推广电话addPhoneCreative
    删除推广电话delPhoneCreative
    编辑推广电话updPhoneCreative
    暂停/启用推广电话shelvePhoneCreative
    • 商桥（10）
    Content中文Content英文备注
    新建商桥移动咨询addBridgeCreative
    删除商桥移动咨询delBridgeCreative
    暂停/启用商桥移动咨询shelveBridgeCreative
    • 网页回呼（11）
    Content中文Content英文备注
    新建网页回呼addLXBCreative
    删除网页回呼delLXBCreative
    编辑网页回呼updLXBCreative
    暂停/启用网页回呼shelveLXBCreative
    • 动态创意（12）
    Content中文Content英文备注
    新建动态创意addDynamicIdea
    删除动态创意delDynamicIdea
    修改动态创意updDynamicIdea
    暂停/启用动态创意shelveDynamicIdea

    OptlogType

    操作记录。

    属性名 类型 说明
    userIdLong用户id
    planIdLong计划id
    unitIdLong单元id
    optTimeDate操作时间
    optContentString操作内容
    optTypeInteger操作类型
    optLevelInteger操作层级
    oldValueString操作前内容
    newValueString操作后内容
    optObjString被操作对象名称

    接口描述

    getOperationRecord

    历史操作记录查询。

    说明：

    • 请求账户，计划，单元，关键词等层级的历史操作记录，请求时提供所查询条件，返回本次请求数据
    • 如果是新增操作，操作前值为“-”，同理，如果是删除操作，操作后值为“-“；
    • 从属service: ToolkitService

    输入信息（getOperationRecordRequest）

    属性名类型说明
    operationRecordRequestTypeOperationRecordRequestType历史操作记录查询条件

    返回信息（getOperationRecordResponse）

    属性名类型说明限制
    optLogTypesOptlogType[]历史操作记录查询结果

    代码示例

    • 请求 历史操作记录查询：

      { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "startDate":"2014-12-10", "startDate":"2014-12-15", "optTypes": null, "optLevel": 3, "optContents": [ "budget", "zone", "ipExclude" ] } }

    • 返回

    返回关键词的全部信息：

    {
    "header": {
        "desc": "success",
        "failures": [],
        "oprs": n,
        "succ": n,
        "oprtime": 0,
        "quota": used_quota_of_this_operation,
        "rquota": your_remain_quota,
        "status": 0
    },
    "body": {
        "data": [
            {
                "userId": user_id,
                "planId": plan_id,
                "unitId": unit_id,
                "optTime": "1418642731000",
                "optContent": "budgetDay2Week",
                "optType": 4,
                "optLevel": 3,
                "oldValue": "old_value",
                "newValue": "new_value",
                "optObj": "操作对象内容"
            },
            {
                "userId": user_id,
                "planId": plan_id,
                "unitId": unit_id,
                "optTime": "1418642761000",,
                "optContent": "zone",
                "optType": 4,
                "optLevel": 3,
                "oldValue": "old_value",
                "newValue": "new_value",
                "optObj": "操作对象内容"
            }
        ]
    }
}
    上一篇
    KeywordService
    下一篇
    错误信息