Amazon Advertising API：解决创建关键词时返回 422 错误

本文档旨在帮助开发者解决在使用 Amazon Advertising API 创建关键词时遇到的 422 错误。该错误通常表示请求体中的数据格式不正确。本文将通过示例代码，详细介绍如何正确构建请求体，避免此类错误，并提供一些调试建议。

在使用 Amazon Advertising API 创建关键词时，开发者可能会遇到 HTTP 状态码 422，表示请求体中的数据格式不符合 API 的预期。 这个问题通常出现在使用 POST 方法向 /v2/sp/keywords 端点发送请求时。

问题分析

422 错误通常意味着请求体中的 JSON 结构不正确。Amazon Advertising API 对于创建关键词的请求，期望接收一个包含关键词对象的数组，而不是单个关键词对象。

解决方案

正确的做法是将关键词对象放置在一个数组中。以下示例代码展示了如何修改 PHP 代码以解决这个问题。

示例代码 (PHP)

Amazon ML

Amazon AMZ机器学习平台

80

查看详情

<?php

$ch = curl_init();

$std_url = "YOUR_API_ENDPOINT"; // 替换为你的 API 端点
$accesstoken = "YOUR_ACCESS_TOKEN"; // 替换为你的 Access Token
$client = "YOUR_CLIENT_ID"; // 替换为你的 Client ID
$API_Scope = "YOUR_API_SCOPE"; // 替换为你的 API Scope

curl_setopt($ch, CURLOPT_URL, $std_url . "/v2/sp/keywords");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, true);

// 正确的请求体结构：关键词对象数组
$data_string = array(array(
    "campaignId" => "111111111111",
    "adGroupId" => "2222222222222",
    "state" => "enabled",
    "keywordText" => "YetAnotherKeyword",
    "matchType" => "broad",
    "bid" => "0.05"
));

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data_string)); // 确保将数组编码为 JSON 字符串

$headers = array();
$headers[] = "Content-Type: application/json";
$headers[] = ("Authorization: Bearer " . $accesstoken);
$headers[] = ("Amazon-Advertising-API-ClientId: " . $client);
$headers[] = ("Amazon-Advertising-API-Scope: " . $API_Scope);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
echo $result;

?>

代码解释：

1. 数组结构： 关键在于 $data_string 变量。它现在是一个包含单个数组元素的数组，该元素本身是一个包含关键词信息的关联数组。
2. JSON 编码： 使用 json_encode() 函数将 PHP 数组转换为 JSON 字符串。这是 Amazon Advertising API 所期望的格式。
3. 替换占位符： 务必将 YOUR_API_ENDPOINT、YOUR_ACCESS_TOKEN、YOUR_CLIENT_ID 和 YOUR_API_SCOPE 替换为你的实际值。

注意事项：

• Content-Type： 确保在请求头中设置 Content-Type: application/json，告诉 API 你发送的是 JSON 数据。
• 错误处理： 始终检查 curl_errno($ch) 的值，以确保请求没有发生错误。
• 数据验证： 在发送请求之前，验证所有必需的字段都已设置，并且具有正确的数据类型。 例如，campaignId 和 adGroupId 应该是字符串，而 bid 应该是数字。
• API 文档： 参考 Amazon Advertising API 的官方文档，了解最新的请求格式和参数要求。

调试建议：

• 打印请求体： 在发送请求之前，使用 var_dump($data_string) 或 print_r($data_string) 打印请求体，以确保其结构正确。
• 使用 Postman 或 Insomnia： 使用这些工具手动构建和发送 API 请求，可以更方便地调试请求体和请求头。
• 查看 API 响应： 仔细查看 API 返回的错误信息，通常会提供有关错误的更多详细信息。

总结

解决 Amazon Advertising API 返回的 422 错误的关键在于确保请求体中的 JSON 结构符合 API 的预期。 通过将关键词对象放置在一个数组中，并使用 json_encode() 函数将其编码为 JSON 字符串，可以避免此错误。 此外，请务必参考 API 文档，并仔细检查请求头和请求体中的所有字段。 遵循这些建议，可以有效地解决在使用 Amazon Advertising API 创建关键词时遇到的问题。

以上就是Amazon Advertising API：解决创建关键词时返回 422 错误的详细内容，更多请关注php中文网其它相关文章！