1.

旧PA-APIのOperation is missing|要求形式と移行先の確認

▶

Operation is missingは、ここに残す旧XML形式の要求で操作指定が不足した例です。現在のCreators APIや旧PA-API 5へOperationという同じパラメータを足すだけでは解決しません。まず呼出先とAPI世代を確認します。

旧PA-APIと後継Creators APIの世代と認証の違い

対象APIと提供状況を先に確認

2026年10月確認。PA-API 5も公式の廃止案内の対象です。旧キーの変更や再試行だけで利用を再開する案内ではありません。現在の連携はCreators APIの移行ガイドを確認し、専用資格情報とOAuth、要求/応答の変更を照合します。一般AWSサービスの署名/SDKと混用しないでください。

親のエラー一覧から他の個別症状を選択できます。以下の旧サンプルを現行APIの完成実装や実通信済みの例とは扱いません。

最初に確認する3点

  1. 送信先のホスト・パス・HTTPメソッドを確認する。旧onca/xmlのQuery要求と、JSON要求を混ぜない。
  2. 旧コードの保守なら、生成前の変数だけでなく送信直前の非秘密項目を確認する。署名付きURL全体は公開しない。
  3. 現在の導入は公式のCreators API資料へ進む。操作指定の追加で署名・利用資格・サービス提供状況まで正常になるとは扱わない。

署名項目不足はSignature不足の記事、署名の計算内容との不一致はSignatureDoesNotMatchの記事で分けて確認できます。

この記事の要点
  • Error 400 : Bad Request Parameter Operation is missing は Amazon Product Advertising API のパラメータ不足エラー
  • 旧XML/Query形式のOperationと、別世代のSearchItems等の操作を混同しない
  • PA-API 5.0 では JSON POST 形式に変更、Operation は HTTP ヘッダ X-Amz-Target に
  • 対処の前に提供状況を確認。旧SDKのインストールや署名の変更だけで廃止APIは復活しない
  • 4.0も5.0も旧API。現在の連携はCreators APIの公式移行資料を確認

このエラーの概要

Amazon Product Advertising API(PA-API、商品検索 API)を呼び出した際に返るエラー:

HTTP/1.1 400 Bad Request
<?xml version="1.0"?>
<ItemSearchErrorResponse xmlns="http://ecs.amazonaws.com/doc/2013-08-01/">
  <Error>
    <Code>AWS.MissingParameters</Code>
    <Message>Your request is missing required parameters. Required parameters
    include Operation.</Message>
  </Error>
</ItemSearchErrorResponse>

上のXML例は旧形式の必須Operation不足を示します。保存済みコードでは、URL生成後のクエリに操作指定があるか、空値・誤記・二重符号化等で失われていないかを確認します。すべてのAPI世代が同じOperationパラメータを要求する、という意味ではありません。

PA-API 4.0 と 5.0 の違い

項目PA-API 4.0(廃止)PA-API 5.0(旧)
提供状況旧4.05.0も廃止案内対象
形式GET + URL クエリPOST + JSON body
Operation 指定クエリパラメータHTTP ヘッダ X-Amz-Target
Operation 例ItemSearch / ItemLookup / BrowseNodeLookupSearchItems / GetItems / GetVariations / GetBrowseNodes
署名v2AWS Signature v4
レスポンスXMLJSON

旧対処1: PA-API 5.0への移行例(現在の導入先ではない)

下のComposer/pip/npmコマンドは旧記事の原資料で、実行を勧めません。 配布名・現行対応・動作を検証していません。現在の導入はCreators APIの公式SDK資料を確認し、5.0を新しい移行先としないでください:

# PHP
composer require amzn/paapi5-php-sdk

# Python
pip install paapi5-python-sdk

# Node.js
npm install paapi5-nodejs-sdk

# Java は Maven リポジトリから paapi5-java-sdk

旧対処2: PHPのSearchItems例(未実行の保守資料)

次の旧SDKコードは未実行です。null参照、通信失敗、本文内エラー等を網羅せず、生のレスポンスを画面に出す処理もそのまま使わないでください。現在の完成実装と扱いません。

<?php
require_once 'vendor/autoload.php';

use Amazon\ProductAdvertisingAPI\v1\ApiException;
use Amazon\ProductAdvertisingAPI\v1\Configuration;
use Amazon\ProductAdvertisingAPI\v1\api\DefaultApi;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\PartnerType;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsResource;

$config = new Configuration();
$config->setAccessKey('YOUR_ACCESS_KEY');
$config->setSecretKey('YOUR_SECRET_KEY');
$config->setHost('webservices.amazon.co.jp');
$config->setRegion('us-west-2');

$apiInstance = new DefaultApi(new GuzzleHttp\Client(), $config);

$request = new SearchItemsRequest();
$request->setPartnerTag('your-22');
$request->setPartnerType(PartnerType::ASSOCIATES);
$request->setKeywords('Python 入門');
$request->setSearchIndex('Books');
$request->setItemCount(10);
$request->setResources([
    SearchItemsResource::ITEM_INFOTITLE,
    SearchItemsResource::OFFERSLISTINGSPRICE,
    SearchItemsResource::IMAGESPRIMARYLARGE,
]);

try {
    $response = $apiInstance->searchItems($request);
    foreach ($response->getSearchResult()->getItems() as $item) {
        echo $item->getItemInfo()->getTitle()->getDisplayValue() . PHP_EOL;
    }
} catch (ApiException $e) {
    echo 'Error: ' . $e->getResponseBody();
}

対処3: 生 HTTP で呼ぶ場合(参考、SDK 推奨)

次のHTTP断片は旧PA-API 5の比較用です。固定日時・省略Authorizationを含み、送信できる完成例ではありません。X-Amz-Targetやパスの旧仕様をCreators APIへ流用しません:

POST /paapi5/searchitems HTTP/1.1
Host: webservices.amazon.co.jp
Content-Type: application/json; charset=UTF-8
X-Amz-Date: 20260515T120000Z
X-Amz-Target: com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems
Authorization: AWS4-HMAC-SHA256 Credential=...

{
  "Keywords": "Python 入門",
  "SearchIndex": "Books",
  "ItemCount": 10,
  "PartnerTag": "your-22",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.co.jp",
  "Resources": [
    "ItemInfo.Title",
    "Offers.Listings.Price"
  ]
}

PA-API 5.0 で使える Operation 一覧

Operation (X-Amz-Target)用途旧 PA-API 4 名
SearchItemsキーワード / カテゴリで検索ItemSearch
GetItemsASIN 指定で詳細取得(最大 10 個)ItemLookup
GetVariationsバリエーション(色 / サイズ)取得—
GetBrowseNodesカテゴリ階層取得BrowseNodeLookup

よくある原因と対処

下は旧APIの対照表です。旧ドキュメントのURLも現在は廃止案内へ転送される場合があり、現行の入力値一覧ではありません。Creators APIの操作・項目名を公式移行資料で確認してください。

症状原因対処
Operation is missing4.0 形式で呼んでいる / Operation 未設定旧形式の要求と提供状況を確認。5.0 SDKへ移すだけでは現在の解決にならない
InvalidParameterValueSearchIndex / ItemId 不正有効値を 公式ドキュメントで確認
InvalidSignature署名計算ミスSDK 使用、手動署名はしない
TooManyRequests (429)レート制限売上による TPS 上限、リトライ + バックオフ
AccessDeniedAssociate 未承認 / 売上 0廃止と現在の対象APIの利用資格を確認。売上件数だけで原因を断定しない

FAQ

Q: PA-API 4.0 をまだ使えるか?
A: 旧4.0を現在の導入先にはしません。返るHTTP状態を常に400/410と断定せず、5.0も廃止案内対象であることを確認してください。

Q: 売上 0 でも開発できる?
A: 「30日以内3件」だけでAPI停止を断定しません。現在の参加/利用資格・検証手段はアソシエイト・セントラルと公式資料で確認します。提供を確認できていないSandboxを導入先として勧めず、保存済み応答やモックで入力/失敗を先に検査します。

Q: 日本 Amazon と米国 Amazon で同じキーは使える?
A: アソシエイト ID はマーケットプレイスごとに別。Host も webservices.amazon.co.jp / webservices.amazon.com と分けます。

関連エラー

  • The request signature we calculated does not match — 署名ミス、SDK 利用推奨
  • AssociateTag not found — PartnerTag 誤り、コンソールで確認
  • InvalidParameterValue: ItemIds — ASIN が無効 / 商品削除済
子ページ

子ページはありません

同階層のページ
  1. Error 400 : Bad Request Parameter Operation is missing
  2. MissingParameter. The request must contain the parameter Signature.
  3. RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
  4. SignatureDoesNotMatch. The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details.
  5. failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable

最近更新/作成されたページ