搜索推广API

    ToolKitService

    历史操作记录查询。

    数据类型

    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
    下一篇
    错误信息