メタデータ API（Metadata API）

メタデータ API には、さまざまな eBay マーケットプレイスに関する構成の詳細を取得する操作があります。マーケットプレイス情報に加えて、API には、販売者が eBay に商品を出品するのに役立つ情報を取得する操作もあります。

バージョン: v1.10.0

ベースURL: https://api.ebay.com/sell/metadata/v1

認証（OAuth スコープ）

この API では、エンドポイントに応じて以下の OAuth 2.0 スコープが使用されます。

リソース一覧

Metadata API は以下の 4 つのリソースカテゴリで構成されています。

marketplace — マーケットプレイスメタデータ

marketplace リソースは、マーケットプレイスのカテゴリに関するさまざまなポリシーとメタデータを提供します。

GET /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies

getAutomotivePartsCompatibilityPolicies — 指定されたマーケットプレイスのカテゴリに自動車部品の互換性アイテムをリストする方法を定義する eBay ポリシーを返します。

デフォルトでは、部品の互換性をサポートするすべてのカテゴリを返します。filter クエリパラメータで結果を制限できます。

注: eBay US マーケットプレイスのポリシーには EBAY_MOTORS_US を指定してください。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → AutomotivePartsCompatibilityPolicyResponse
• 204 — コンテンツなし
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

GET /marketplace/{marketplace_id}/get_category_policies

getCategoryPolicies — 指定されたマーケットプレイスのすべてのリーフカテゴリの eBay カテゴリポリシーメタデータを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → CategoryPoliciesResponse
• 204 — コンテンツなし
• 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_classified_ad_policies

getClassifiedAdPolicies — 指定されたマーケットプレイスのすべてのリーフカテゴリの eBay 分類広告ポリシーメタデータを返します。

注: このメソッドは eBay US Motors カテゴリ（EBAY_MOTORS_US）の分類広告をサポートしていません。eBay Motors Pro ユーザーの場合は getMotorsListingPolicies を使用してください。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ClassifiedAdPoliciesResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_currencies

getCurrencies — 指定されたマーケットプレイスでサポートされている通貨情報を返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → GetCurrenciesResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies

getExtendedProducerResponsibilityPolicies — eBay マーケットプレイスの拡張生産者責任（EPR）ポリシーを返します。

注: 拡張生産者責任 ID は出品レベルで設定されなくなったため、カテゴリレベルのメタデータは返されなくなりました。代わりに、販売者はアカウント設定で EPR を管理します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ExtendedProducerResponsibilityPolicyResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_hazardous_materials_labels

getHazardousMaterialsLabels — 指定された eBay マーケットプレイスの危険物ラベル情報（シグナルワード、ステートメント、ピクトグラム）を返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → HazardousMaterialDetailsResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_item_condition_policies

getItemConditionPolicies — eBay マーケットプレイスのアイテム状態メタデータ（サポートされるアイテム状態 ID、状態記述子など）を返します。

重要: Certified - Refurbished 対象のセラーは、認証コード付与フローで作成された OAuth トークンと sell.inventory スコープを使用する必要があります。

OAuth スコープ: api_scope, sell.inventory

レスポンス:

• 200 — 成功 → ItemConditionPolicyResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_listing_structure_policies

getListingStructurePolicies — 特定のマーケットプレイスのカテゴリで許可されている出品構造（バリエーションのある商品の出品可否など）を定義するポリシーを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ListingStructurePolicyResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_listing_type_policies

getListingTypePolicies — 指定されたマーケットプレイスのすべてのリーフカテゴリの eBay 出品タイプポリシーメタデータを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ListingTypePoliciesResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_motors_listing_policies

getMotorsListingPolicies — 指定されたマーケットプレイスのすべてのリーフカテゴリの eBay Motors ポリシーメタデータを返します。

注: eBay US Motors カテゴリのポリシー情報を返すには、EBAY_MOTORS_US を指定します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → MotorsListingPoliciesResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_negotiated_price_policies

getNegotiatedPricePolicies — 特定のマーケットプレイスのカテゴリでサポートされている交渉価格機能（ベストオファーなど）を定義するポリシーを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → NegotiatedPricePolicyResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_product_safety_labels

getProductSafetyLabels — 指定された eBay マーケットプレイスの製品安全ラベル情報（ステートメント、ピクトグラム）を返します。

注: EBAY_HK、EBAY_MY、EBAY_TW、EBAY_PH マーケットプレイスではサポートされていません。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ProductSafetyLabelsResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_regulatory_policies

getRegulatoryPolicies — eBay マーケットプレイスの規制ポリシーを返します。

注: EBAY_HK、EBAY_MY、EBAY_TW、EBAY_PH ではサポートされていません。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → RegulatoryPolicyResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_return_policies

getReturnPolicies — 特定のマーケットプレイスのカテゴリにリストするアイテムに返品ポリシーを含める必要があるかどうかを定義するポリシーと、国内および海外の返品ポリシーのガイドラインを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ReturnPolicyResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_shipping_policies

getShippingPolicies — 指定されたマーケットプレイスのすべてのリーフカテゴリの eBay 配送ポリシーメタデータを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ShippingPoliciesResponse
• 204 / 400 / 404 / 500

GET /marketplace/{marketplace_id}/get_site_visibility_policies

getSiteVisibilityPolicies — 指定されたマーケットプレイスのすべてのリーフカテゴリの eBay 国際サイト表示ポリシーメタデータを返します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → SiteVisibilityPoliciesResponse
• 204 / 400 / 404 / 500

compatibilities — 製品互換性

compatibilities リソースは、パーツの互換性に関するプロパティ名、プロパティ値、および仕様ベースの互換性情報を取得するために使用されます。すべてのメソッドは POST で、リクエストボディにフィルター条件を含めます。

POST /compatibilities/get_compatibilities_by_specification

getCompatibilitiesBySpecification — 指定された仕様に基づいて、パーツの互換性のあるアプリケーション名と値のペアをすべて取得します。

タイヤの寸法（セクション幅やリム直径など）などの仕様を specifications コンテナーで提供し、compatibilityPropertyFilters 配列で結果を制限できます。

OAuth スコープ: api_scope

リクエストボディ: SpecificationRequest

レスポンス:

• 200 — 成功 → SpecificationResponse
• 204 — コンテンツなし
• 400 / 401 / 500

POST /compatibilities/get_compatibility_property_names

getCompatibilityPropertyNames — 指定された互換性対応カテゴリの製品互換性プロパティ名を取得します。

OAuth スコープ: api_scope

リクエストボディ: PropertyNamesRequest

レスポンス:

• 200 — 成功 → PropertyNamesResponse
• 204 / 400 / 401 / 500

POST /compatibilities/get_compatibility_property_values

getCompatibilityPropertyValues — 指定されたカテゴリ内の単一のプロパティ名に関連付けられた製品互換性プロパティ値を取得します。

OAuth スコープ: api_scope

リクエストボディ: PropertyValuesRequest

レスポンス:

• 200 — 成功 → PropertyValuesResponse
• 204 / 400 / 401 / 500

POST /compatibilities/get_multi_compatibility_property_values

getMultiCompatibilityPropertyValues — 指定されたカテゴリ内の複数のプロパティ名に関連付けられた製品互換性プロパティ値を取得します。

OAuth スコープ: api_scope

リクエストボディ: MultiCompatibilityPropertyValuesRequest

レスポンス:

• 200 — 成功 → MultiCompatibilityPropertyValuesResponse
• 204 / 400 / 401 / 500

POST /compatibilities/get_product_compatibilities

getProductCompatibilities — 指定された商品の利用可能なすべてのアイテム互換性の詳細を取得します。

製品は productIdentifier（ePID、UPC 等）で指定します。dataset、datasetPropertyName、applicationPropertyFilter で結果を制限できます。

OAuth スコープ: api_scope

リクエストボディ: ProductRequest

レスポンス:

• 200 — 成功 → ProductResponse
• 204 / 400 / 401 / 500

shipping:marketplace — 配送メタデータ

shipping:marketplace リソースは、配送キャリア、配送サービス、配送先/除外先、取り扱い時間など、配送関連のメタデータを提供します。

GET /shipping/marketplace/{marketplace_id}/get_exclude_shipping_locations

getExcludeShippingLocations — 指定されたマーケットプレイスの配送除外先を取得します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ShippingExcludeLocationResponse
• 400 / 500

GET /shipping/marketplace/{marketplace_id}/get_handling_times

getHandlingTimes — 指定されたマーケットプレイスの取り扱い時間（ハンドリングタイム）を取得します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ShippingHandlingTimeResponse
• 400 / 500

GET /shipping/marketplace/{marketplace_id}/get_shipping_carriers

getShippingCarriers — 指定されたマーケットプレイスで利用可能な配送キャリアを取得します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ShippingCarrierResponse
• 400 / 500

GET /shipping/marketplace/{marketplace_id}/get_shipping_locations

getShippingLocations — 指定されたマーケットプレイスで利用可能な配送先を取得します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ShippingLocationResponse
• 400 / 500

GET /shipping/marketplace/{marketplace_id}/get_shipping_services

getShippingServices — 指定されたマーケットプレイスで利用可能な配送サービスを取得します。

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → ShippingServiceResponse
• 400 / 500

country — 売上税管轄区域

country リソースは、売上税管轄区域の情報を取得するために使用されます。

GET /country/{countryCode}/sales_tax_jurisdiction

getSalesTaxJurisdictions — 指定された国のすべての売上税管轄区域を取得します。

注: 売上税表は米国（EBAY_US）およびカナダ（EBAY_CA）のマーケットプレイスでのみ使用できます。米国では、eBay が全 50 州とワシントン DC の売上税を計算・徴収・納付しています。ただし、以下の米国領土では税率設定が可能です: AS, GU, MP, PW, VI

OAuth スコープ: api_scope

レスポンス:

• 200 — 成功 → SalesTaxJurisdictions
• 400 / 404 / 500

主要スキーマ定義

Metadata API で使用される主要なリクエスト/レスポンスのデータモデルです（全 86 スキーマのうち主要なものを掲載）。

互換性リクエスト/レスポンス

SpecificationRequest

SpecificationResponse

PropertyNamesRequest

PropertyNamesResponse

PropertyValuesRequest

PropertyValuesResponse

MultiCompatibilityPropertyValuesRequest

MultiCompatibilityPropertyValuesResponse

ProductRequest

ProductResponse

マーケットプレイスポリシーレスポンス（主要）

ItemConditionPolicyResponse

ItemConditionPolicy

ListingStructurePolicyResponse

ListingTypePoliciesResponse

NegotiatedPricePolicyResponse

ReturnPolicyResponse

ShippingPoliciesResponse

MotorsListingPoliciesResponse

SiteVisibilityPoliciesResponse

規制・安全レスポンス

ExtendedProducerResponsibilityPolicyResponse

HazardousMaterialDetailsResponse

ProductSafetyLabelsResponse

RegulatoryPolicyResponse

通貨・税金レスポンス

GetCurrenciesResponse

SalesTaxJurisdictions

配送メタデータレスポンス

ShippingCarrierResponse

ShippingServiceResponse

ShippingExcludeLocationResponse

ShippingLocationResponse

ShippingHandlingTimeResponse

共通スキーマ

ProductIdentifier

PropertyFilterInner

PaginationInput / Pagination

Error

エンドポイント一覧