VehicleSearch

[重要] 重要

利用率低下により、このオペレーションおよび関連レスポンスグループは2010年07月25日をもってサポート終了となっておりますので、ご利用にならないようご注意ください。

説明

VehicleSearch は、指定した年式、メーカー、モデル、装備の値に一致する全ての自動車を返します。リクエストには、これらのパラメータを1つまたは複数指定できます。パラメータ数が多いほど結果が絞り込まれます。通常、VehicleSearch リクエストは繰り返して使用します。まず年式を指定してメーカーを取得します。次に年式とメーカーを指定してモデルを取得し、さらに年式、メーカー、モデルを指定して装備を取得します。

このオペレーションでは、BedId, BedName, BodyStyleId, BodyStyleName, BrakesId, BrakesName, DriveTypeId, DriveTypeName, EngineId, EngineName, MakeId および MakeName など、自動車の全てのオプションも返します。全オプションの一覧については後述します。これらの全てのパラメータを、他の自動車関連のオペレーションを使用した以降のリクエストで使用することで、結果を絞り込むことができます。

利用可能なサイト

US サイト

リクエストパラメータ

名前説明必須
MakeId

自動車メーカーを一意に識別する識別子。メーカー (make) とは、Ford や General Motors などの自動車メーカーです。

タイプ: 正の整数

デフォルト: なし

有効な値: 有効な ID

制約事項: モデルを取得するには Year も指定します。

制約事項
ModelId

自動車のモデルを一意に識別する識別子。

タイプ: 正の整数

デフォルト: なし

有効な値: 有効な ID

制約事項: 装備 (trim) を取得するにはYearMakeId も指定します。

制約事項
TrimId

自動車の装備を一意に識別する識別子。

タイプ: 正の整数

デフォルト: なし

有効な値: 有効な ID

制約事項: VehicleOptionsレスポンスグループを使用する際に必須。

制約事項
Year

部品が使用できる自動車の年式。

タイプ: 文字列

デフォルト: なし

有効な値: VehicleSearch で返される4桁の年。

制約事項: リクエストに MakeId を含む場合や、 VehicleSearch を使用して MakeId を検索する場合に必須。

制約事項
ResponseGroup

返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。

タイプ: 文字列

デフォルト: VehicleYears

有効な値: VehicleYears | VehicleMakes | VehicleModels | VehicleTrims | VehicleOptions

いいえ

VehicleSearch には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

2001年式の全ての自動車メーカーを検索する。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=VehicleSearch
Version=2008-08-19&
Year=2001&
ResponseGroup=VehicleMakes

このリクエストに対するレスポンスをレスポンス例に示します。

レスポンス例

次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。

<VehicleSearchResponse>
  	<VehicleMakes>
    	<VehicleMake>
      <MakeName>AM General</MakeName>
      <MakeId>44</MakeId>
    </VehicleMake>
    	<VehicleMake>
      <MakeName>Acura</MakeName>
      <MakeId>58</MakeId>
    </VehicleMake>
    	<VehicleMake>
      <MakeName>Aston Martin</MakeName>
      <MakeId>77</MakeId>
    </VehicleMake>
    ...
  </VehicleMakes>
</VehicleSearchResponse>

関連オペレーション