所有文档

          搜索推广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
          下一篇
          错误信息