Batch register uploaded assets

POST

/assets/batchRegister

最后修改时间：2026-08-27 23:21:02

责任人：未设置

这是一个异步 API，为客户端提供其批量注册请求的标识符。他们需要通过使用该标识符调用 GET /assets/batchRegister/{requestId} API 来检查其请求的状态。

请求参数

Header 参数

Body 参数application/vnd.assetsbatchregisterrequest.v1+json必填

示例

{
    "assetDetailsList": [
        {
            "asinList": [
                "string"
            ],
            "assetSubTypeList": [
                "LOGO"
            ],
            "assetType": "IMAGE",
            "associatedPrograms": [
                {
                    "metadata": {
                        "dspAdvertiserId": "string"
                    },
                    "programName": "A_PLUS"
                }
            ],
            "name": "string",
            "otherMetadata": {
                "property1": "string",
                "property2": "string"
            },
            "skipAssetSubTypesDetection": true,
            "tagList": [
                "string"
            ],
            "url": "string",
            "versionInfo": {
                "linkedAssetId": "string",
                "versionNotes": "string"
            }
        }
    ],
    "batchRegistrationContext": {
        "assetSourceInfo": {
            "assetSourceId": "AMAZON_CREATIVE_SERVICES",
            "assetSourceMetadata": {
                "key": "String upto length 50",
                "value": "String upto length 500"
            }
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/assets/batchRegister' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Content-Type: application/vnd.assetsbatchregisterrequest.v1+json' \
--data '{
    "assetDetailsList": [
        {
            "asinList": [
                "string"
            ],
            "assetSubTypeList": [
                "LOGO"
            ],
            "assetType": "IMAGE",
            "associatedPrograms": [
                {
                    "metadata": {
                        "dspAdvertiserId": "string"
                    },
                    "programName": "A_PLUS"
                }
            ],
            "name": "string",
            "otherMetadata": {
                "property1": "string",
                "property2": "string"
            },
            "skipAssetSubTypesDetection": true,
            "tagList": [
                "string"
            ],
            "url": "string",
            "versionInfo": {
                "linkedAssetId": "string",
                "versionNotes": "string"
            }
        }
    ],
    "batchRegistrationContext": {
        "assetSourceInfo": {
            "assetSourceId": "AMAZON_CREATIVE_SERVICES",
            "assetSourceMetadata": {
                "key": "String upto length 50",
                "value": "String upto length 500"
            }
        }
    }
}'

返回响应

🟢200成功

application/vnd.assetsbatchregisterresponse.v1+json

批量注册请求的标识符。

Bodyapplication/vnd.assetsbatchregisterresponse.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429

🔴500服务器错误

修改于 2026-08-27 23:21:02

Retrieve an asset

Retrieves status of the batch asset registration request, uniquely identified by requestId.