updateMedia - Amazon Selling Partner API (SP-API)-中文

更新现有媒体资源的元数据。mediaId 路径参数用于标识目标资源。若要更新视频与图片配对的标题，请将 associatedMediaId 作为查询参数提供。若要更新视频级描述或独立图片的标题，请省略 associatedMediaId。

每个请求只能更新标题或描述之一，不能同时更新。描述按语言区域进行更新插入（upsert）；仅修改提供的语言区域，请求中未包含的现有语言区域会被保留。

响应包含完整的统一 Media 结构。提供 associatedMediaId 时，relatedMedia 仅包含指定的配对。未提供 associatedMediaId 时，relatedMedia 包含所有受影响的配对。

使用计划：

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

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

请求参数

Path 参数

Query 参数

Body 参数application/json必填

示例

{
    "title": "Updated Product Demo Video",
    "descriptions": [
        {
            "locale": "en-US",
            "value": "A demonstration of the product features and benefits."
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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": {}
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠410记录不存在

🟠429

🔴500服务器错误

🔴503服务器故障