Metadata API

Metadata API 概要 (Metadata API Overview)

Metadata API を使用すると、eBayカテゴリポリシーに関するメタデータ、消費税管轄区域に関する情報、および利用可能な危険物関連ラベル情報を取得できます。

カテゴリポリシー は、さまざまなeBayマーケットプレイスの特定のカテゴリに特定の商品を出品する方法に関するeBayのポリシーおよびガイドラインです。たとえば、バリエーションのある商品を出品する場合、どのカテゴリがマルチバリエーション出品をサポートしているかを知りたいでしょう。別の例として、さまざまなeBayカテゴリでどの商品の状態（コンディション）がサポートされているかを知りたい場合もあります。詳細については、「eBayマーケットプレイスおよびカテゴリIDのeBay出品ポリシーを取得する」を参照してください。

いくつかの国には 消費税管轄区域（sales tax jurisdictions） があり、管轄区域によって税率が異なる場合があります。Metadata APIを使用して税管轄区域のリストを取得し、それを使用して消費税テーブルを設定できます。詳細については、「消費税管轄区域を取得する」を参照してください。

セラーは、出品に 危険物関連ラベル 情報を追加する機能を持っています。詳細については、「販売フロー用の危険物ラベル情報を取得する」を参照してください。

技術概要 (Technical overview)

Metadata APIには、以下のリソースのメソッドが含まれています。

• marketplace
• compatibilities
• country

これらのリソースのメソッドを使用すると、さまざまなeBayマーケットプレイスに関連する構成詳細を取得したり、販売先の地域に関する情報を取得したり、部品適合性情報を取得したりできます。

ビジネスユースケース (Business use cases)

Metadata APIは、以下に概説するユースケースをサポートしています。

eBayマーケットプレイスおよびカテゴリIDのeBay出品ポリシーメタデータを取得する

各eBayマーケットプレイスには、さまざまなeBayカテゴリに商品を出品する方法を管理するポリシーがあります。marketplace リソースには、特定のマーケットプレイスのリーフカテゴリの出品ポリシーメタデータを取得できるいくつかの GET メソッドが含まれています。

• 自動車部品適合性商品ポリシーメタデータ (getAutomotivePartsCompatibilityPolicies)
• 拡大生産者責任（Extended Producer Responsibilities）ポリシーメタデータ (getExtendedProducerResponsibilityPolicies)
• 商品状態（コンディション）ポリシーメタデータ (getItemConditionPolicies)
• マルチバリエーション出品をサポートするカテゴリを取得 (getListingStructurePolicies)
• ベストオファーおよび関連機能をサポートするカテゴリを取得 (getNegotiatedPricePolicies)
• 国内および国際商品返品ポリシーメタデータを取得 (getReturnPolicies)
• 規制ポリシーをサポートする出品カテゴリに関するメタデータ (getRegulatoryPolicies)
• カテゴリポリシーメタデータ (getCategoryPolicies)
• クラシファイド広告ポリシーメタデータ (getClassifiedAdPolicies)
• 出品タイプポリシーメタデータ (getListingTypePolicies)
• モーターズポリシーメタデータ (getMotorsListingPolicies)
• 配送ポリシーメタデータ (getShippingPolicies)
• 国際サイト表示ポリシーメタデータ (getSiteVisibilityPolicies)

eBayマーケットプレイスの配送メタデータを取得する

各eBayマーケットプレイスには、異なる配送機能と制約があります。shipping:marketplace リソースには、指定されたマーケットプレイスの配送情報を取得できるいくつかの GET メソッドが含まれています。

• アラスカ/ハワイなど、指定されたマーケットプレイスで利用可能なセラー指定の除外配送地域 (getExcludeShippingLocations)
• 指定されたマーケットプレイスでサポートされているハンドリングタイム（出荷までの日数） (getHandlingTimes)
• UPSやFedExなど、指定されたマーケットプレイスでサポートされている配送業者 (getShippingCarriers)
• 北米や南米など、指定されたマーケットプレイスでサポートされている配送先 (getShippingLocations)
• UPS Groundなど、指定されたマーケットプレイスでサポートされている配送サービスとその詳細 (getShippingServices)

消費税管轄区域を取得する

カナダ (CA) と米国 (US) はどちらも、国内のさまざまな地域に対して異なる消費税管轄区域を定義しています。セラーは、消費税を請求する必要がある税管轄区域の税テーブルを設定することで、販売する商品の最終価格を計算するプロセスを容易にすることができます。

getSalesTaxJurisdictions メソッドを使用して、国のさまざまな消費税管轄区域の詳細を取得し、その後 Account API の sales_tax リソースのメソッドを使用して、消費税テーブルを設定および管理します。

米国消費税テーブル

eBayは現在、50州すべてとワシントンD.C.の顧客に発送される商品について、セラーに代わって消費税を計算、徴収、送金しています。セラーは、これらの管轄区域に対して税テーブルを使用して消費税率を指定することはできなくなりました。

ただし、セラーは引き続き消費税テーブルを使用して、以下の米国領土の税率を設定できます：アメリカ領サモア (AS)、グアム (GU)、北マリアナ諸島 (MP)、パラオ (PW)、および米領バージン諸島 (VI)。

カナダ消費税テーブル

セラーは、消費税テーブルを使用して、任意のまたはすべてのカナダの州に対して税率を設定および構成できます。

販売フロー用の危険物ラベル情報を取得する

危険物ラベル情報は取得可能であり、セラーはこれを使用して出品に危険物関連情報を追加できます（Specifying hazardous material related information を参照）。

getHazardousMaterialsLabels メソッドを使用して、指定されたeBayマーケットプレイスで利用可能な危険物ラベル情報の詳細を取得し、Trading APIの Add/Revise/Relist 系呼び出しの Regulatory コンテナを通じて出品に情報を追加します（例：AddItem）。

販売フロー用の製品安全ラベル情報を取得する

getProductSafetyLabels メソッドを使用して、指定されたeBayマーケットプレイスで利用可能な製品安全ラベル情報の詳細を取得します。以下のいずれかのAPIを通じて出品に情報を追加します：

• Inventory API: createOffer または updateOffer メソッドの productSafety コンテナを使用します（例：createOffer の regulatory.productSafety コンテナを使用）
• Trading API: Add/Revise/Relist 系呼び出しの Item.Regulatory.ProductSafety コンテナを使用します（例：AddItem）

デフォルト通貨を取得する

getCurrencies メソッドを使用して、リクエストで指定されたサイトに対してeBayシステムがサポートしているデフォルト通貨を取得します。

部品適合性情報を取得する

compatibilities リソースには、特定のカテゴリの部品適合性情報を返すいくつかのメソッドが含まれています。

• 提供された仕様に基づいて部品の適合アプリケーションを検索する (getCompatibilitiesBySpecification)
• 指定されたカテゴリの製品適合性プロパティ名を取得する (getCompatibilityPropertyNames)
• プロパティ名に関連付けられた製品適合性プロパティ値を取得する (getCompatibilityPropertyValues および getMultiCompatibilityPropertyValues)
• 指定された製品の利用可能なすべての商品適合性詳細を取得する (getProductCompatibilities)

Metadata APIの要件と制限 (Metadata API requirements and restrictions)

以下の表は、Metadata APIの各リソースでサポートされているマーケットプレイスをリストしています。