搜索推广API

    BulkJobService

    使用此服务可以将对您的大批量请求安排为异步批量请求,并可以获取您近期所执行请求的状态、结果等信息。

    数据类型

    FilePathType

    属性名类型说明
    accountFilePathstring账户属性文件下载路径
    accountFileMd5string账户属性文件md5
    campaignFilePathstring计划文件下载路径
    campaignFileMd5string计划文件md5
    adgroupFilePathstring单元文件下载路径
    adgroupFileMd5string单元文件md5
    keywordFilePathstring关键词文件下载路径
    keywordFileMd5string关键词文件md5
    creativeFilePathstring创意文件下载路径
    creativeFileMd5string创意文件md5
    sublinkFilePathstring蹊径文件下载路径
    sublinkFileMd5string蹊径文件md5
    mobileSublinkFilePathstring蹊径文件下载路径
    mobileSublinkFileMd5string蹊径文件md5
    phoneFilePathstring蹊径文件下载路径
    phoneFileMd5string蹊径文件md5
    bridgeFilePathstring新创意文件下载路径
    bridgeFileMd5string新创意文件md5
    dynamicCreativeFilePathstring动态创意文件下载路径
    dynamicCreativeFileMd5string动态创意文件md5
    ecallFilePathstring网页回呼文件下载路径
    ecallFileMd5string网页回呼文件md5

    ChangedItemIdType

    属性名类型说明限制
    operatorint变化标识1: 新增计划;
    2: 删除计划;
    3: 计划属性有修改;
    4 : 新增单元;
    5 : 删除单元;
    6 : 单元属性有修改;
    7 : 新增关键词/创意;
    8 : 删除关键词/创意;
    9 : 关键词/创意属性有修改;-
    1 : 关键词转入;
    -2 : 关键词转出;
    10:新增蹊径;
    11:删除蹊径;
    12:蹊径属性有修改;
    13:新增移动推广子链;
    14:删除移动推广子链;
    15:移动推广子链属性有修改;
    16:新增推广电话;
    17:删除推广电话;
    18:推广电话属性有修改;
    19:新增商桥移动咨询;
    20:删除商桥移动咨询;
    21:商桥移动咨询属性有修改;
    22:新增动态创意;
    23:删除动态创意;
    24:动态创意属性有修改
    creativeIdlong创意id-
    dynCreativeIdlong动态创意id-
    keywordIdlong关键词id-
    adgroupIdlong动态创意所属的单元id-
    campaignIdlong动态创意所属的计划id-

    接口描述

    getAllObjects

    获取指定账户下的完整数据(计划、单元、关键词、创意、蹊径、无线蹊径、电话、商桥、动态创意),或者获取指定计划下的完整数据(计划、单元、关键词、创意、蹊径、无线蹊径、电话、商桥、动态创意)。

    输入信息(getAllObjectsRequest)

    属性名类型说明限制
    campaignIdslong[]指定计划id,获取其下全部物料信息。如为空,则获取该账户下的完整物料信息选填,
    默认为空;
    为空表示获取该账户下的完整物料信息
    includeTempboolean是否包含修改后还未生效的关键词、创意、蹊径。默认不包含修改后未生效的关键词、创意、蹊径选填,
    默认为true;
    true:包含修改未生效物料,即获取的是全集 ;
    false:不包含修改后还未生效的关键词、创意
    formatint压缩文件格式选填,
    默认为1;
    0:zip;
    1:Gzip
    accountFieldsString[]帐户层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    campaignFieldsString[]计划层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    adgroupFieldsString[]单元层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    keywordFieldsString[]关键词层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    creativeFieldsString[]创意层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段;
    有效列名请参见有效列表。
    sublinkFieldsString[]蹊径层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    mobileSublinkFieldsString[]无线蹊径需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    phoneFieldsString[]电话层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    bridgeFieldsString[]商桥层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    dynamicCreativeFieldsString[]动态创意层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    ecallFieldsString[]网页回呼层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    mobileExtendint是否需要返回移动优先的数据行选填,默认为不获取
    null/[]不返回文件;
    all获取所有基本字段
    有效列名请参见有效列表。
    需在请求时添加该字段才会返回
    0或1,默认0,不获取

    返回信息(getAllObjectsResponse)

    属性名类型说明限制
    fileIdString整账户下载文件id-

    代码示例

    • 请求 获取用户“指定计划”下“keyword、creative层级”的“所有物料列”:

      { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "campaignIds": [campaign_id_1, campaign_id_2], "keywordFields": ["all"], "creativeFields": ["all"] } }

    • 返回

    返回用户添加的信息:

    {
        "header": {
            "desc": "success",
            "failures": [],
            "oprs": 1,
            "succ": 1,
            "oprtime": 0,
            "quota": used_quota_of_this_operation,
            "rquota": your_remain_quota,
            "status": 0
        },
        "body": {
            "data": [
                {
                    "fileId": "cc405142375a55dbc64a856e7f22ac76"
                }
            ]
        }
    }

    返回文件示例

    1、账户文件示例

    如果没有数据,则用“-”表示。

    userIdBalancecostpaymentbudgetTypebudgetregionTargetexcludeIpopenDomainsregDomainsbudgetOfflineTimeweeklyBudget
    658555.55111.11666.661345.09999999123.123.123.1||1.1.1.3apihome.baidu.comapihome.baidu.com2**0**24||3**0**24||5**0**2449||49||49||49||49||49||49

    2、计划文件示例 如果没有数据,则用“-”表示。

    campaignIdcampaignNamebudgetregionTargetexcludeIpnegativeWordsexactNegativeWordsschedule(weekDay startHour endHour)budgetOfflineTime(time flag)showProbdevicepriceRatiopausestatus
    359316示例56.0202.38.64.34鲜花-2**0**24||3**0**24||5**0**24-201.01false23

    3、单元文件示例 如果没有数据,则用“-”表示。

    campaignIdadgroupIdadgroupNamemaxPricenegativeWordsexactNegativeWordspausestatus
    35323854211789测试单元55.0否定关键词1||否定关机词2精确否定2||精确否定1||精确否定3false33

    4、关键词文件示例 如果没有数据,则用“-”表示。

    campaignIdadgroupIdkeywordIdkeywordpricepcDestinationUrlmobileDestinationUrlmatchTypepausestatusqualitytempMobileQuality
    35931654287741330610563鲜花0.1--1false441101

    5、创意文件示例 如果没有数据,则用“-”表示。

    campaignIdadgroupIdcreativeIdtitledescription1description2pcDestinationUrlpcDisplayUrlmobileDestinationUrlmobileDisplayUrlpausestatustemp
    33886354201305132475681{鲜花快递} 2011情人节2小时送达,北京五环内免运费,24小时在线订花服务专业的{鲜花快递}服务----false531

    6、计算机推广子链文件示例 如果没有数据,则用“-”表示。

    campaignId adgroupId SublinkId Pause status temp description1 destinationUrl1 description2 destinationUrl2 Description3 destinationUrl3 Description4 destinationUrl4 Description5 destinationUrl5
    338863 54201305 132475681 False 63 1 十一手机疯抢 http://www.baidu.xom/shouji 十一图书疯抢 http://www.baidu.xom/book 十一电脑疯抢 http://www.baidu.xom/computer - - - -

    7、移动推广子链文件示例 如果没有数据,则用“-”表示。

    campaignId adgroupId mobileSublinkId pause status temp description1 destinationUrl1 description2 destinationUrl2 Description3 destinationUrl3 Description4 destinationUrl4
    128863 55201305 782475681 False 63 0 十一手机疯抢 http://www.baidu.xom/shouji 十一图书疯抢 http://www.baidu.xom/book 十一电脑疯抢 http://www.baidu.xom/computer - -

    8、推广电话文件示例 如果没有数据,则用“-”表示。

    campaignId adgroupId phoneId phoneNum pause status
    128863 55201305 782475681 400-800-8888 False 73

    9、商桥移动咨询文件示例 如果没有数据,则用“-”表示。

    campaignId adgroupId bridgeId pause status
    128863 55201305 982475681 False 83

    10、动态创意文件示例 如果没有数据,则用“-”表示。

    campaignId adgroupId dynCreativeId bindingType title url murl pause status
    128863 55201305 210022135 5十一手机疯抢 http://www.baidu.xom/shouji http://m.baidu.xom/shouji false 91

    getAllChangedObjects

    通过该接口获取完整账户下,或者指定计划ID下的有变化的物料信息。该接口为异步接口,返回请求的结果文件ID。

    输入信息(getAllChangedObjectsRequest)

    属性名类型说明限制
    startTimedatetime更新的起始时间必填;最早可以查询到上个月1号,例如现在是9月10日,则startTime最早只能到8月1日,即查询8、9两个月
    campaignIdslong[]指定计划id范围,
    获取该范围下所有变化的对象,
    如为空,则获取该账户下所有的有变化的物料
    选填,默认为空 为空表示获取该账户下所有的有变化的物料
    includeTempboolean是否包含影子物料选填,
    默认值为true;
    true: 获取 ;
    false:不获取
    formatint文件格式选填,
    默认为1;
    0: zip的csv文件 ;
    1:Gzip的csv文件
    campaignFieldsString[]计划层级需要返回的数据列。
    若返回计划文件,文件中的计划都在计划层级有变化,
    对应operator标识1,2,3
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    adgroupFieldsString[]单元层级需要返回的数据列。
    若返回单元文件,
    文件中的单元都在单元层级有变化,
    对应operator标识4,5,6。
    说明:如果是删除了父计划,虽然其下单元也被相应删除,
    但该删除只会被统计到计划层级中(changedCampaignFile),
    不会出现在单元中(changedAdgroupFile)。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    keywordFieldsString[]关键词层级需要返回的数据列。
    若返回关键词文件,文件中的关键词都有变化,
    对应operator标识7,8,9;
    说明:如果是删除了父单元,虽然其下关键词也被相应删除,
    但该删除只会被统计到单元层级变化中(changedAdgroupFile),
    不会出现在关键词中(changedKeywordFile)。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    creativeFieldsString[]创意层级需要返回的数据列。
    若返回创意文件,文件中的创意都有变化,对应operator标识7,8,9 。
    说明:如果是删除了父单元,虽然其下创意也被相应删除,
    但该删除只会被统计到单元层级中(changedAdgroupFile),
    不会出现在创意中(changedCreativeFile)。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    sublinkFieldsString[]蹊径层级需要返回的数据列。
    若返回及指定要返回的新创意类型,文件中的新创意都有变化,
    对应operator标识10,11,12,13,14,15。
    说明:如果是删除了父单元,虽然其下新创意也被相应删除,
    但该删除只会被统计到单元层级中(changedAdgroupFile),不会出现在新创意中(changedSublinkFiles)。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    mobileSublinkFieldsString[]无线蹊径需要返回的数据列。
    若返回及指定要返回的新创意类型,文件中的新创意都有变化,
    对应operator标识10,11,12,13,14,15。
    说明:如果是删除了父单元,虽然其下新创意也被相应删除,
    但该删除只会被统计到单元层级中(changedAdgroupFile),
    不会出现在新创意中(changedMobileSublinkFiles)。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    phoneFieldsString[]电话层级需要返回的数据列。
    若返回电话文件,
    文件中的电话都有变化,对应operator标识16,17,18 。
    说明:如果是删除了父单元,虽然其下电话也被相应删除。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    bridgeFieldsString[]商桥层级需要返回的数据列。
    若返回商桥文件,文件中的商桥都有变化,对应operator标识19,20,21 。
    说明:如果是删除了父单元,
    虽然其下商桥也被相应删除,
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    dynamicCreativeFieldsString[]动态创意层级需要返回的数据列。
    若返回动态创意文件,文件中的动态创意都有变化,对应operator标识22,23,24 。
    说明:如果是删除了父单元,虽然其下动态创意也被相应删除,
    但该删除只会被统计到单元层级中(changedAdgroupFile),
    不会出现在动态创意中(changedDynamicCreativeFile)。
    选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    ecallFieldsString[]网页回呼层级需要返回的数据列选填,
    null/[]不返回文件;
    all获取所有字段(开放字段);
    有效列名请参见有效列表。
    mobileExtendInteger计划层级需要返回的数据列0或1,默认0,不获取

    返回信息(getAllChangedObjectsResponse)

    属性名类型说明限制
    fileIdString最近更新打包下载文件id选填

    说明: 1.一个username下只能处理1个getAllChangedObjects请求。当上一个getAllChangedObjects请求未处理完毕时,当前username发起新的请求会被服务器报错拒绝。参见错误代码901162。 2.下载为异步请求,需要根据FileId进行后续的文件生成状态查询和下载。

    代码示例

    • 请求 获取用户“所有计划”下“keyword、creative层级”的“指定物料列”:

      { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "startTime": start_time,, "keywordFields": ["price","status"], "creativeFields": ["pcDestinationUrl","pcDisplayUrl"] } }

    • 返回 返回用户添加的信息:

      { "header": { "desc": "success", "failures": [], "oprs": 1, "succ": 1, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { "data": [ { "fileId": "cc405142375a55dbc64a856e7f22ac76" } ] } }

    返回文件示例

    1、计划更新文件示例 如果没有数据,则用“-”表示。

    campaignIdcampaignNamebudgetregionTargetexcludeIpnegativeWordsexactNegativeWordsschedule(weekDay startHour endHour)budgetOfflineTime(time flag)showProbdevicepriceRatiopausestatusoperator
    359316示例56.0202.38.64.34鲜花-2**0**24||3**0**24||5**0**24-201.01false231||3

    说明:

    • 数据列schedule中的投放时段为复杂对象,其对象中的元素顺序为weekDay startHour endHour。
    • 数据列budgetOfflineTime中的投放时段为复杂对象,其对象中的元素顺序为time flag。

    2、单元更新文件示例

    campaignIdadgroupIdadgroupNamemaxPricenegativeWordsexactNegativeWordspausestatusoperator
    35323854211789测试单元55.0否定关键词1||否定关机词2精确否定2||精确否定1||精确否定3false334 || 6

    3、关键词更新文件示例

    如果没有数据,则用“-”表示。

    campaignIdadgroupIdkeywordIdkeywordpricepcDestinationUrlmobileDestinationUrlmatchTypepausestatusqualitytempoperatormobileQuality35931654287741330610563鲜花快递0.1-
    -1false441107||81

    说明: temp为标识列,用来区分该关键词是否为待审核列表中的词,待审核列表指的是该关键词进行了修改,修改后的词仍在审核中,还未生效。temp为1:在待审核列表中 temp为0:正常已生效的关键词。

    4、创意更新文件示例

    如果没有数据,则用“-”表示。

    campaignIdadgroupIdcreativeIdtitledescription1description2pcDestinationUrlpcDisplayUrlmobileDestinationUrlmobileDisplayUrlpausestatustempdevicePreferenceoperator
    33886354201305132475681{鲜花快递} 2011情人节2小时送达,北京五环内免运费专业的{鲜花快递}服务----false53117||9

    5、计算机推广子链更新文件示例

    campaignId adgroupId SublinkId pause status temp operator description1 destinationUrl1 description2 destinationUrl2 Description3 destinationUrl3 Description4 destinationUrl4 Description5 destinationUrl5
    338863 54201305 132475681 false 53 1 10 十一手机疯抢 http://www.baidu.xom/shouji 十一图书疯抢 http://www.baidu.xom/book 十一电脑疯抢 http://www.baidu.xom/computer - - - -

    6、移动推广子链更新文件示例

    campaignId adgroupId mobileSublinkId pause status temp operator description1 destinationUrl1 description2 destinationUrl2 Description3 destinationUrl3 Description4 destinationUrl4
    338863 54201305 132475681 False 63 1 13 十一手机疯抢 wap://www.baidu.xom/shouji 十一图书疯抢 wap://www.baidu.xom/book 十一电脑疯抢 wap://www.baidu.xom/computer - -

    说明: temp为标识列,用来区分该创意是否是影子。影子指的是该移动推广子链进行了修改,修改后的仍在审核中,还未生效。temp为1:影子 temp为0:本身移动推广子链描述数若不足4,则空列用“-”代替。

    7、推广电话更新文件示例

    campaignId adgroupId phoneId phoneNum pause status operator
    128863 55201305 782475681 400-800-8888 False 73 16

    8、商桥移动咨询更新文件示例

    campaignId adgroupId bridgeId pause status operator
    128863 55201305 982475681 False 83 19

    9、动态创意文件示例

    如果没有数据,则用“-”表示。

    campaignId adgroupId dynCreativeId bindingType title url murl pause status operator
    128863 55201305 210022135 5十一手机疯抢 http://www.baidu.xom/shouji http://m.baidu.xom/shouji false 91 22

    getFileStatus

    在调用getAllObejects、getAllChangedObjects接口后使用,以查询请求的文件是否已生成。

    输入信息(getFileStateRequest)

    属性名类型说明限制
    fileIdstringgetAllObejects、getAllChangedObjects的下载任务id必填

    返回信息(getFileStateResponse)

    属性名类型说明限制
    isGeneratedint文件任务状态检查1:等待中;
    2:处理中 ;
    3:处理成功;
    5:处理成功,部分文件下载失败;
    对于生成失败的文件返回null和对应的errorcode

    说明: 在获取getAllObejects、getAllChangedObjects下载url前,请调用此方法。待确认文件已生成后,再获取下载的url。

    getFilePath

    返回请求的文件下载地址。使用接口:getAllObjects,getAllChangedObjects 按照请求的下载文件顺序返回。

    输入信息(getFilePathRequest)

    属性名类型说明限制
    fileIdString处理任务id必填

    输出信息(getFilePathResponse)

    属性名类型说明限制
    filePathsFilePathType下载路径-

    注意: 该URL在1小时内有效,如果超时则需重新调用此方法,获取新的url。

    cancelDownload

    取消一个下载任务。

    输入信息(cancelDownloadRequest)

    属性名类型说明限制
    fileIdString处理任务id必填

    输出信息(cancelDownloadResponse)

    属性名类型说明限制
    isCanceledInteger处理结果3:处理成功;对于生成失败的文件返回null和对应的errorcode

    getChangedId

    获取账户内有变化的计划id,单元id,关键词id、创意id、新创意ID和动态创意ID(从指定时间到当前时间段内),各层级除计划层级返回的数据限制不超过两万条。

    输入信息(getChangedIdRequest)

    属性名类型说明限制
    startTimedatetime更新的起始时间必填;不能早于3个月以前,
    例如现在是9月10日,
    则startTime最早只能到7月1日,即查询7、8、9三个月
    campaignLevelBoolean是否获取计划层级有变化的ItemId;
    返回对象中对应operator标识为1,2,3
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    adgroupLevelBoolean是否获取单元层级有变化的ItemId;
    返回对象中对应operator标识为4,5,6
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    keywordLevelBoolean是否获取关键词层级有变化的ItemId;
    返回对象中对应operator标识为25,26,27
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    creativeLevelBoolean是否获取创意层级有变化的ItemId;
    返回对象中对应operator标识为7,8,9
    选填,默认值为true;
    true: 获取;
    false:不获取
    sublinkLevelboolean是否获取蹊径层级有变化的ItemId;
    返回对象中对应operator标识为10、11、12
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    mobileSublinkLevelboolean是否获取无线蹊径层级有变化的ItemId;
    返回对象中对应operator标识为13、14、15
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    phoneLevelboolean是否获取电话层级有变化的ItemId;
    返回对象中对应operator标识为16、17、18
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    bridgeLevelboolean是否获取商桥层级有变化的ItemId;
    返回对象中对应operator标识为19、20、21
    选填,
    默认值为true;
    true: 获取;
    false:不获取
    dynamicCreativeLevelboolean是否获取动态创意层级有变化的ItemId;
    返回对象中对应operator标识为22、23、24
    选填,
    默认值为true;
    true: 获取;
    false:不获取

    输出信息(getChangedIdResponse)

    属性名类型说明限制
    endTimedatetime当前时间点-
    changedCampaignIdsChangedItemIdType []计划id,仅返回计划层级有变化的id,
    变化范围涵盖operator 1-3
    -
    changedAdgroupIdsChangedItemIdType []单元id,仅返回单元层级有变化的id,
    变化范围涵盖operator 4-6
    返回的数据不超过2万条
    changedKeywordIdsChangedItemIdType[]关键词id,仅返回关键词层级有变化的id,
    变化范围涵盖operator 25-27
    返回的数据不超过2万条
    changedCreativeIdsChangedItemIdType[]创意id,仅返回创意层级有变化的id,
    变化范围涵盖operator 7-9
    返回的数据不超过2万条
    changedSublinkIdsChangedItemIdType []蹊径id,
    变化范围覆盖operator 10-12
    返回计算机推广子链和移动
    推广子链,数据不超过2万条
    changedMobileSublinkIdsChangedItemIdType []无线蹊径id,
    变化范围覆盖operator 13-15
    返回的数据不超过2万条
    changedPhoneIdsChangedItemIdType []电话id,
    变化范围覆盖operator 16-18
    返回的数据不超过2万条
    changedBridgeIdsChangedItemIdType []商桥id,
    变化范围覆盖operator 19-21
    返回的数据不超过2万条
    changedDynamicCreativeIdsChangedItemIdType []动态创意id,
    变化范围覆盖operator 22-24
    返回的数据不超过2万条

    代码示例

    • 请求

    获取单元层级和创意层级有变化的ItemId:

    {
    "header":{
    	"opUsername":"searchlab",   			//mcc操作员账户名称
        "opPassword":"*********"        		//mcc操作员账户密码
        "tgUsername":"searchlab", 
        "tgPassword":"*********", 
        "tgSubname":"searchlab",				//mcc被操作的账户
        "bceUser":"014df051fa131234a2a*****" 	//mcc类型的bceuser
    },
    "body":{
           	"startTime": "2015-07-11",
    		"campaignLevel":false,
            "adgroupLevel":true,
            "sublinkLevel":false,
       		"creativeLevel":true,
            "mobileSublinkLevel":false,
            "phoneLevel":false,
            "bridgeLevel":false,
            "dynamicCreativeLevel":false,
            "keywordLevel":false
      }
    }
    • 返回 单元层级和创意层级有变化的物料信息。

      { "header": { "desc": "success", "failures": [], "oprs": 2, "succ": 2, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { "endTime": "Jul 23, 2015 5:48:55 PM", "changedCreativeIds": [ { "campaignId": 27695849, "creativeId": 7227541536, "adgroupId": 1217626220, "operator": 7 }, ... ], "changedAdgroupIds": [ { "campaignId": 26781292, "adgroupId": 1156180129, "operator": 4 }, ... ] } }

    getChangedItemId

    获取从指定时间到当前时间段内有变化的物料id。各层级除计划层级返回的数据限制不超过两万条。

    输入信息(getChangedItemIdRequest)

    属性名类型说明限制
    startTimedatetime更新的起始时间必填;
    不能早于3个月以前,例如现在是9月10日,
    则startTime最早只能到7月1日,即查询7、8、9三个月
    itemTypeInteger物料类型必填字段:
    1: 计划;
    2 :单元;
    3 :创意;
    4:关键词;
    5:动态创意;
    6:蹊径;
    7:无线蹊径;
    8 : 商桥;
    9:电话。
    说明:各层级除计划类型外返回的
    数据限制不超过两万条。
    type int 指定的id数组为计划id还是单元id id不为空时必填,id为空时无论type填何值,
    均默认为获取全账户范围下的变化;
    3:表示指定id数组为计划id;
    5:表示指定id数组为单元id ;
    8 :计划+单元(仅对动态创意有效)
    ids long[] 指定的id数组 选填,为空表示获取全账户范围下的变化物料
    campaignLevelBoolean是否获取计划层级有变化的ItemId;
    返回对象中对应operator标识为1,2,3
    选填,默认值为true;true: 获取;false:不获取
    adgroupLevelBoolean是否获取单元层级有变化的ItemId;
    返回对象中对应operator标识为4,5,6
    选填,默认值为true;true: 获取;false:不获取
    keywordLevelBoolean是否获取关键词层级有变化的ItemId;
    返回对象中对应operator标识为25,26,27
    选填,默认值为true;true: 获取;false:不获取
    creativeLevelBoolean是否获取创意层级有变化的ItemId;
    返回对象中对应operator标识为7,8,9
    选填,默认值为true;true: 获取;false:不获取
    sublinkLevelboolean是否获取蹊径层级有变化的ItemId;
    返回对象中对应operator标识为10、11、12
    选填,默认值为false;true: 获取;false:不获取
    mobileSublinkLevelboolean是否获取无线蹊径层级有变化的ItemId;
    返回对象中对应operator标识为13、14、15
    选填,默认值为false;true: 获取;false:不获取
    phoneLevelboolean是否获取电话层级有变化的ItemId;
    返回对象中对应operator标识为16、17、18
    选填,默认值为false;true: 获取;false:不获取
    bridgeLevelboolean是否获取商桥层级有变化的ItemId;
    返回对象中对应operator标识为19、20、21
    选填,默认值为false;true: 获取;false:不获取
    dynamicCreativeLevelboolean是否获取动态创意层级有变化的ItemId;
    返回对象中对应operator标识为22、23、24
    选填,默认值为false;true: 获取;false:不获取

    输出信息(getChangedCampaignIdResponse)

    属性名类型说明限制
    endTimedatetime当前时间点-
    changedItemIdsChangedItemIdType[]--

    代码示例

    • 请求 获取有变化的电话id:

      { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "startTime": "2015-07-11", "itemType" :9, "campaignLevel":true, "adgroupLevel":true, "sublinkLevel":true, "creativeLevel":true, "mobileSublinkLevel":true, "phoneLevel":true, "bridgeLevel":true, "dynamicCreativeLevel":true, "keywordLevel":true } }

    • 返回 变化的电话信息:

      { "header": { "desc": "success", "failures": [], "oprs": 2, "succ": 2, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { "endTime": "Jul 23, 2015 5:48:55 PM", "changedItemIds": [ { "campaignId": 26462309, "adgroupId": 1149951729, "phoneId": 1277819024, "operator": 16 } ] } }

    getChangedScale

    获取完整账户下,或者指定计划ID下的变化物料规模,从而帮助用户决定后续的最近更新策略。当有变化的物料规模大于一定比例时,用户不妨选择整账户下载。

    注意: 变化物料仅指因用户操作发生的变化,即在历史操作记录中可以查询到的操作。而对于质量度,状态这些在系统内自动发生的改变不在统计范围内。

    输入信息(getChangedScaleRequest)

    属性名类型说明限制
    startTimedatetime更新的起始时间必填;
    最早可以查询到上个月1号,例如现在是9月10日,
    则startTime最早只能到8月1日,即查询8、9两个月
    campaignIdslong[]指定计划id范围,
    获取该范围下的变化物料规模
    选填,默认为空
    为空表示获取该账户下的变化占比
    changedCampaignScaleboolean是否统计划的变化规模。
    变化的计划是指campaignType本身属性有变化,
    不包含其下所属单元、关键词、创意的变化
    选填,默认值为true;
    true: 统计增、删、改过的ID数,当前ID总数;
    false:不统计增、删、改过的ID数,当前ID总数
    changedAdgroupScaleboolean是否统计单元的变化规模。
    变化的单元是指adgroupType本身属性有变化,
    不包含其下所属关键词、创意的变化
    选填,默认值为true;
    true: 统计;
    false:不统计
    changedKeywordScaleboolean是否统计关键词的变化规模。选填,默认值为true;
    true: 统计 ;
    false:不统计
    changedCreativeScaleboolean是否统计创意的变化规模。选填,默认值为true;
    true: 统计;
    false:不统计
    changedSublinkScaleboolean是否统计蹊径的变化规模。选填,默认值为true;
    true: 统计 ;
    false:不统计
    changedMoblieSublinkScaleboolean是否统计无线蹊径的变化规模。选填,默认值为true;
    true: 统计 ;
    false:不统计
    changedPhoneScaleboolean是否统计电话的变化规模。选填,默认值为true;
    true: 统计 ;
    false:不统计
    changedBridgeScaleboolean是否统计商桥的变化规模。选填,默认值为true;
    true: 统计;
    false:不统计
    changedDynamicCreativeScaleboolean是否统计动态创意的变化规模。选填,默认值为true;
    true: 统计 ;
    false:不统计

    返回信息(getChangedScaleResponse)

    属性名类型说明限制
    changedCampaignScalelong[]计划的变化规模返回数组包含两个元素:
    第1个元素表示发生了变化的计划ID数(包括被删除的)
    第2个元素表示现有的计划ID数
    changedAdgroupScalelong[]单元的变化规模。单元有变化是指adgroupType本身属性有变化,不包含其下所属关键词、创意的变化。
    注:删除单元的父计划时,虽然单元也被删除,
    但该删除只会被统计到计划层级变化中,不会被统计到单元的变化中
    返回数组包含两个元素:
    第1个元素表示发生了变化的单元ID数(包括被删除的)
    第2个元素表示现有的单元ID数
    changedKeywordScalelong[]关键词的变化规模 。
    注:删除关键词的父单元或父计划时,虽然关键词也会被相应删除,
    但该删除只会被统计到计划、单元层级的变化,而不会被统计到关键词的变化规模中
    返回数组包含两个元素:
    第1个元素表示发生了变化的关键词ID数(包括被删除的)
    第2个元素表示现有的关键词ID数
    changedCreativeScalelong[]创意的变化规模 。
    注:删除创意的父单元或父计划时,虽然创意也会被相应删除,
    但该删除只会被统计到计划、单元层级的变化中,而不会被统计到创意的变化规模中;
    返回数组包含两个元素:
    第1个元素表示发生了变化的创意ID数(包括被删除的);
    第2个元素表示现有的创意ID数
    changedSublinkScalelong[]蹊径的变化规模 。
    注:删除创意的父单元或父计划时,虽然创意也会被相应删除,
    但该删除只会被统计到计划、单元层级的变化中,而不会被统计到创意的变化规模中;
    返回数组包含两个元素:
    第1个元素表示发生了变化的蹊径ID数(包括被删除的);
    第2个元素表示现有的蹊径ID数
    changedMobileSublinkScalelong[]无线蹊径的变化规模 。
    注:删除创意的父单元或父计划时,虽然创意也会被相应删除,
    但该删除只会被统计到计划、单元层级的变化中,而不会被统计到创意的变化规模中;
    返回数组包含两个元素:
    第1个元素表示发生了变化的无线蹊径ID数(包括被删除的);
    第2个元素表示现有的无线蹊径ID数
    changedPhoneScalelong[]电话的变化规模 。
    注:删除创意的父单元或父计划时,虽然创意也会被相应删除,
    但该删除只会被统计到计划、单元层级的变化中,而不会被统计到创意的变化规模中;
    返回数组包含两个元素:
    第1个元素表示发生了变化的电话ID数(包括被删除的);
    第2个元素表示现有的电话ID数
    changedBridgeScalelong[]商桥的变化规模 。
    注:删除创意的父单元或父计划时,虽然创意也会被相应删除,
    但该删除只会被统计到计划、单元层级的变化中,而不会被统计到创意的变化规模中;
    返回数组包含两个元素:
    第1个元素表示发生了变化的商桥ID数(包括被删除的);
    第2个元素表示现有的商桥ID数
    changedDynamicCreativeScaleLong[]指定动态类型后,各个动态创意类型的变化规模 返回数组包含两个元素:
    第1个元素表示发生了变化的动态创意ID数(包括被删除的);
    第2个元素表示现有的动态创意ID数

    代码示例

    • 请求 获取有变化的动态创意物料规模:

      { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "startTime": "2015-07-11", "changedCampaignScale":false, "changedAdgroupScale":false, "changedSublinkScale":false, "changedCreativeScale":true, "changedMobileSublinkScale":false, "changedPhoneScale":false, "changedBridgeScale":false, "changedDynamicCreativeScale":true, "changedKeywordScale":false } }

    • 返回 创意和动态创意层级变化规模:

      { "header": { "desc": "success", "failures": [], "oprs": 2, "succ": 2, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { { "changedCreativeScale": [ 121, 22 ], "changedDynamicCreativeScale": [ 4, 0 ] } }

    有效列名

    请参考有效列名

    一篇
    AccountService
    一篇
    ReportService