开发人员指南概述

亚马逊广告 API 概览

品牌旗舰店

使用此接口请求和检索品牌旗舰店信息。这可用于创建品牌推广活动、 提取品牌旗舰店 URL 信息，以及用于品牌旗舰店的素材注册。

方法 URL 使用案例
GET /v2/stores 列出某位广告主拥有的所有注册品牌旗舰店的品牌旗舰店信息。

操作

listStores

GET /v2/stores

检索给定广告主的品牌旗舰店列表。

响应

状态码 响应对象
200 - success StoreInfoResponse 列表
401 - unauthorized Error
404 - campaign not found Error

响应示例

[
  {
    "code": "SUCCESS",
    "entityId": "ENTITY6SICSOL71XVX",
    "storeName": "Test 1",
    "brandEntityId": "ENTITY6SICSOL71XVX",
    "storePageInfo": [
      {
        "storePageId": "75233FD4-DC27-4D39-A3AE-2DDBEE144AD2",
        "storePageUrl": "https://www.amazon.com/stores/page/75233FD4-DC27-4D39-A3AE-2DDBEE144AD2",
        "storePageName": "Home"
      },
      {
        "storePageId ": "75233FD4-DC27-4D39-A3AE-2DDBEE144AD3",
        "storePageUrl ": " https://www.amazon.com/stores/page/75233FD4-DC27-4D39-A3AE-2DDBEE144AD3",
        "storePageName ": "Subpage title"
      }
    ]
  }
]

资源表现

StorePageInfo

{
    "title": "StorePageInfo",
    "type": "object",
    "properties": {
        "storePageId": {
            "description": "The ID of the store.",
            "type": "string"
        },
        "storePageUrl": {
            "description": "The store url page.Can be used for SB campaigns as a possible landing page.",
            "type": "string"
        },
        "storePageName": {
            "description": "The page name.Defaults to Home for the main store page.",
            "type": "string"
        }
    }
}

StoreInfoResponse

{
    "title": "StoreInfoResponse",
    "type": "object",
    "properties": {
        "code": {
            "description": "The response code.",
            "type": "string"
        },
        "entityId": {
            "description": "The entity ID.",
            "type": "string"
        },
        "storeName": {
            "description": "The name of the store.",
            "type": "string"
        },
        "brandEntityId": {
            "description": "ID used in campaign creation and asset registration.",
            "type": "string"
        },
        "storePageInfo": {
            "description": "The information related to the store.",
            "type": "object",
            "$ref": "#StorePageInfo"
        }
    }
}

错误

请参阅开发人员说明中的错误响应对象。

Amazon Advertising logo