開発者ガイドの概要

Amazon Ads APIの概要

ストア

このインターフェースを使用すると、ストア情報をリクエストおよび取得できます。スポンサーブランド広告キャンペーンの作成、 ストアのURL情報の取得、ストアのアセット登録に使用できます。

メソッド URL ユースケース
GET /v2/stores 広告主に登録されているすべてのストアのストア情報を一覧表示します。

操作

listStores

GET /v2/stores

特定の広告主のストアのリストを取得します。

レスポンス

ステータスコード レスポンスオブジェクト
200 - success StoreInfoResponseのリスト
401 - unauthorized Error
404 - campaign not found Error

レスポンスの例

[
  {
    コード "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"
      }
    ]
  }
]

リソースの表現

ストアページ情報

{
    "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