跳到主要内容
推广与变现

关键词状态修改

您通过本接口可以批量修改同类型关键词的状态。

  • 请求地址:请根据您的就近区域进行选择

    亚非拉:https://ads-dra.cloud.huawei.com/ads/v1/promotion/keywords/status/update

    俄罗斯:https://ads-drru.cloud.huawei.ru/ads/v1/promotion/keywords/status/update

    欧洲:https://ads-dre.cloud.huawei.com/ads/v1/promotion/keywords/status/update

  • 请求方法POST

  • 请求参数:

    参数名称类型是否必选描述
    keyword_idslong[]关键词id列表,最多100个。
    keyword_typestring关键词类型,详见关键词类型
    statusstring关键词操作状态,详见关键词状态操作类型
    • 请求示例

      POST /ads/v1/promotion/keywords/status/update

      HTTP/1.1

      Accept:application/json

      Content-Type:application/json

      Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soYIZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=

      {
      "keyword_ids": [
      302844,
      403232
      ],
      "keyword_type": "KEYWORD",
      "status": "KEYWORD_STATUS_DELETE"
      }
    • 响应字段

      参数名称类型描述
      codestring返回码。
      messagestring返回描述。
      dataStruct1[]失败时返回的错误信息列表,如果无错误则不返回该数据。

      data(Struct1)定义

      参数名称类型描述
      keyword_idlong更新失败的关键词ID。
      error_codestring错误码。
      error_messagestring失败提示信息。
    • 应答示例

      HTTPS/1.1 200 OK

      {
      "code": "200",
      "data": [
      {
      "keyword_id": 2121,
      "error_code": 1122002008,
      "error_message": "无效的关键词id"
      },
      {
      "keyword_id": 38103295,
      "error_code": 1122002006,
      "error_message ": "不能删除全部关键词"
      },
      {
      "keyword_id": 38103296,
      "err_code": 1122002007,
      "error_msg": "关键词已删除"
      }
      ]
      }