createMedia

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/aplus/2020-11-01/media

创建媒体资源记录。mediaType 字段决定要创建的资源类型。

此操作是幂等的；如果资源或配对已存在且元数据相同，此操作将返回包含现有数据的 200 响应。创建新资源或配对时返回 201。如果资源或配对已存在但元数据字段不同，则返回 409。

如果提供了 uploadDestinationId，则会在任何后续处理之前将其解析为 mediaId。通过 uploadDestinationId 引用资源的请求与随后使用所得 mediaId 的请求被视为引用同一身份。

使用计划：

速率（每秒请求数）	突发
10	10

x-amzn-RateLimit-Limit 响应头会在可用时返回应用于所请求操作的使用计划速率限制。上表列出了此操作的默认速率和突发值。业务需求需要更高吞吐量的销售合作伙伴可能会看到高于此处所示的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 的使用计划和速率限制。

请求参数

Body 参数application/json必填

示例

{
    "mediaType": "VIDEO",
    "uploadDestinationId": "aplus-media-library-service-media-upload/a1b2c3d4-e5f6-7890-abcd-ef1234567890.mp4",
    "mediaId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "title": "Product Thumbnail",
    "descriptions": [
        {
            "locale": "en-US",
            "value": "A demonstration of the product features and benefits."
        }
    ],
    "relatedMedia": [
        {
            "associationType": "VALUE_ADD_SERVICE",
            "title": "Product Demo Video",
            "media": {
                "mediaType": "VIDEO",
                "uploadDestinationId": "aplus-media-library-service-media-upload/7ae2d3b1-00d0-4626-a2b6-5de81e1af0d4.jpg",
                "mediaId": "c3d4e5f6-a7b8-9012-cdef-234567890123",
                "title": "Product Thumbnail"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/aplus/2020-11-01/media' \
--header 'Content-Type: application/json' \
--data '{
    "mediaType": "VIDEO",
    "uploadDestinationId": "aplus-media-library-service-media-upload/a1b2c3d4-e5f6-7890-abcd-ef1234567890.mp4",
    "mediaId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "title": "Product Thumbnail",
    "descriptions": [
        {
            "locale": "en-US",
            "value": "A demonstration of the product features and benefits."
        }
    ],
    "relatedMedia": [
        {
            "associationType": "VALUE_ADD_SERVICE",
            "title": "Product Demo Video",
            "media": {
                "mediaType": "VIDEO",
                "uploadDestinationId": "aplus-media-library-service-media-upload/7ae2d3b1-00d0-4626-a2b6-5de81e1af0d4.jpg",
                "mediaId": "c3d4e5f6-a7b8-9012-cdef-234567890123",
                "title": "Product Thumbnail"
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

成功。媒体资源已存在，且元数据相同。

Headers

Bodyapplication/json

示例

{
    "warnings": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ],
    "mediaId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "mediaType": "VIDEO",
    "title": "productDemoVideo.mp4",
    "descriptions": [
        {
            "locale": "en-US",
            "value": "A demonstration of the product features and benefits."
        }
    ],
    "status": [
        "PENDING_PROCESSING"
    ],
    "mediaUrl": "https://m.media-amazon.com/images/S/aplus-media-library-service-media/b2c3d4e5-f6a7-8901-bcde-f12345678901.mp4",
    "issues": [
        {
            "code": "INVALID_INPUT",
            "message": "The provided input is invalid.",
            "severity": "ERROR"
        }
    ],
    "relatedMedia": [
        {
            "associationType": "VALUE_ADD_SERVICE",
            "title": "Product Demo Video",
            "status": [
                "PENDING_PROCESSING"
            ],
            "issues": [
                {
                    "code": "INVALID_INPUT",
                    "message": "The provided input is invalid.",
                    "severity": "ERROR"
                }
            ],
            "media": {}
        }
    ]
}

🟢201成功

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409

🟠410记录不存在

🟠429

🔴500服务器错误

🔴503服务器故障

修改于 2026-10-16 14:40:01

postContentDocumentSuspendSubmission

getMedia