アセットの管理

キャンペーンを管理する際、既存のアセットに新しいバージョンの作成が必要となる場合があります。

アセットの検索

GET /assetsとPOST /assets/searchを使用して、以前に作成されたアセットを取得できます。

GET /assets

GET /assetsは、assetIdクエリパラメーターに基づき1つのアセットを返します。

curl --location 'https://advertising-api.amazon.com/assets?assetId=amzn1.assetlibrary.xxxxxxxxxx' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx'

POST /assets/search

POST /assets/searchを使用すると、タグ、ASIN、キャンペーン、作成日、サイズなどですべてのアセットを検索できます。

プロファイルに関連付けられているアセットをすべて表示するには、リクエストボディを空欄のままにします。

curl --location 'https://advertising-api.amazon.com/assets/search' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxx' \
--header 'Content-Type: text/plain' \
--data '{}'

さまざまな条件で絞り込むことも可能です。全オプションについては、APIリファレンスをご覧ください。

curl --location 'https://advertising-api.amazon.com/assets/search' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--data '{
  "filterCriteria": {
    "valueFilters": [
      {
        "values": [
          "IMAGE"
        ],
        "valueField": "ASSET_TYPE"
      }
    ],
    "rangeFilters": [
      {
        "ranges": [
          {
            "start": "1",
            "end": "5000"
          }
        ],
        "rangeField": "SIZE"
      }
    ]
  },
  "sortCriteria": {
    "field": "CREATED_TIME",
    "order": "ASC"
  }
}'

アセットの更新

アセットを更新するたびに、そのアセットの新しいバージョンが作成されます。更新されたアセットには、同じassetIdの末尾にバージョンが追加されます。

新しいバージョンの作成手順は、「アセットの作成」で説明されている手順と同様です。まず、アップロードURLを作成し、アセットをアップロードします。手順3では、更新するアセットのassetIdをversionInfoで指定します。

注

アップロードするファイルには、現在のバージョンのファイルとは異なる名称を設定する必要があります。ファイルが同じ場合は、既存のassetIdとバージョンが返されます。新しいバージョンは、新しいファイルがアップロードされたときにのみ生成されます。

リクエストの例

curl --location 'https://advertising-api.amazon.com/assets/register' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Content-Type: text/plain' \
--data '{
  "url": "https://al-na-9d5791cf-3faf.s3.amazonaws.com/xxxxxxxxx",
  "name": "My asset",
  "assetType": "IMAGE",
  "assetSubTypeList": [
    "LOGO"
  ],
  "versionInfo": {
    "linkedAssetId": "amzn1.assetlibrary.asset1.xxxxxxx"
  }
}

レスポンスの例

{
 "assetId": "amzn1.assetlibrary.asset1.xxxxxxxx",
 "failedSpecChecks": [],
 "programPolicyValidationsList": **null**,
 "versionId": "version_v2"
}

その後、assetIdとversionIdの組み合わせをクリエイティブの一部として使用できます（例：amzn1.assetlibrary.asset1.xxxxxxxx:version_v2）