本文档旨在帮助开发者解决在使用Amazon Advertising API创建关键词时遇到的422错误。该错误通常表示请求体中的数据格式不正确。本文将提供详细的解决方案，包括正确的请求数据格式和示例代码，以确保成功创建关键词。
在使用Amazon Advertising API创建关键词时，如果收到HTTP状态码422，表示请求体包含语义错误，服务器无法处理。 这通常是因为发送的数据格式不符合API的预期。 以下是解决此问题的详细步骤和注意事项：
问题分析
422错误通常表示您的请求体数据格式不正确。 在Amazon Advertising API中，创建关键词的请求需要特定的JSON格式。 常见的错误是将单个关键词数据直接作为JSON对象发送，而API期望的是一个包含关键词对象的数组。
解决方案
正确的做法是将关键词数据包装在一个数组中。 这样，API才能正确解析并创建关键词。
示例代码（PHP）
以下是一个修正后的PHP代码示例，展示了如何正确地构造请求体以创建关键词：
"111111111111", // 替换为你的 Campaign ID
"adGroupId" => "2222222222222", // 替换为你的 Ad Group ID
"state" => "enabled",
"keywordText" => "YetAnotherKeyword",
"matchType" => "broad",
"bid" => "0.05"
));
// 将PHP数组编码为JSON字符串
$data_string_json = json_encode($data_string);
curl_setopt($ch, CURLOPT_POSTFIELDS, $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;
?>关键修改点
注意事项
- Content-Type: 确保在请求头中设置了 Content-Type: application/json，告知服务器发送的是JSON数据。
- API Scope: 确保你的API Scope具有创建关键词的权限。
- 数据验证: 在发送请求之前，验证所有必需字段（如 campaignId, adGroupId, keywordText, matchType, bid）都已正确设置。
- 错误处理: 检查API返回的详细错误信息，以便更好地了解问题所在。Amazon Advertising API通常会在响应中提供更详细的错误描述。
- Bid值: 确保bid的值是有效的，且符合Amazon Advertising的规范。
总结
通过将关键词数据包装在数组中并确保使用正确的JSON格式，可以有效解决Amazon Advertising API创建关键词时遇到的422错误。 确保仔细检查请求头和数据格式，以及API返回的错误信息，以便快速定位和解决问题。 遵循这些步骤将有助于你成功地使用Amazon Advertising API创建关键词。
