eBayではAPIで商品を出品する際、商品状態をCondition IDで指定する必要があります。指定できるCondition IDはカテゴリーによって違います。
これまでSingle Trading Cardを出品する際は、Usedのみしか選ぶことができませんでしたが、
- 2023年夏より
Graded（鑑定機関による鑑定済み） orUngraded（鑑定無し）の2択に変更されます。 - 各Conditionに応じたコンディション詳細情報について、
ConditionDescriptorsを利用して提供する必要があります。
今回の変更に関する概要：Revamp your listings with new conditions
https://www.ebay.com/sellercenter/selling/selling-trading-cards
タイムライン
-
2023/10/23以降の新規出品は、
GradedorUngradedのみしか受け付けません。（現在、若干の猶予が与えられていますが、2023/12からはUsed(Condition ID: 3000)では出品できなくなります。） - 2024/01/22以後、現在出品している商品のReviseを行うためには、
GradedorUngradedが選択されている必要があります。
注意
つまりUsedのままでは、2024/01/22以後API,CSV,画面上で、価格や数量等を変更することができません。
対象カテゴリー
- Sports Memorabilia, Cards & Fan Shop > Sports Trading Cards > Trading Card Singles (CategoryID: 261328)
- Collectibles > Non-Sport Trading Cards > Trading Card Singles (CategoryID: 183050)
- Toys & Hobbies > Collectible Card Games > CCG Individual Cards (CategoryID: 183454)
新しいConditionID
- Graded(2750)
- Ungraded(4000)
ConditionDescriptorsとは
- Conditionよりも詳細な情報（例えば、鑑定機関やレーティングといった情報）です。
-
GradedorUngradedによって、提供できる詳細情報が変わります。 - Metadata API > getItemConditionPolicies を利用して、どのような情報が必要か、どのように指定したら良いか、それは必須かどうかを知ることができます。
Sample 2: Get the eBay category policies regarding item conditions with condition descriptors
サンプルでも表示されていますが、2023/12/03にCategoryID:261328にて取得した結果
{
"itemConditionPolicies": [
{
"categoryTreeId": "0",
"categoryId": "261328",
"itemConditionRequired": false,
"itemConditions": [
{
"conditionId": "2750",
"conditionDescription": "Graded",
"conditionHelpText": "Professionally graded",
"conditionDescriptors": [
{
"conditionDescriptorId": "27501",
"conditionDescriptorName": "Professional Grader",
"conditionDescriptorHelpText": "Select a grader",
"conditionDescriptorConstraint": {
"defaultConditionDescriptorValueId": "275010",
"cardinality": "SINGLE",
"mode": "SELECTION_ONLY",
"usage": "REQUIRED"
},
"conditionDescriptorValues": [
{
"conditionDescriptorValueId": "275010",
"conditionDescriptorValueName": "Professional Sports Authenticator (PSA)"
},
{
"conditionDescriptorValueId": "275011",
"conditionDescriptorValueName": "Beckett Collectors Club Grading (BCCG)"
},
{
"conditionDescriptorValueId": "275012",
"conditionDescriptorValueName": "Beckett Vintage Grading (BVG)"
},
{
"conditionDescriptorValueId": "275013",
"conditionDescriptorValueName": "Beckett Grading Services (BGS)"
},
{
"conditionDescriptorValueId": "275014",
"conditionDescriptorValueName": "Certified Sports Guaranty (CSG)"
},
{
"conditionDescriptorValueId": "275015",
"conditionDescriptorValueName": "Certified Guaranty Company (CGC)"
},
{
"conditionDescriptorValueId": "275016",
"conditionDescriptorValueName": "Sportscard Guaranty Corporation (SGC)"
},
{
"conditionDescriptorValueId": "275017",
"conditionDescriptorValueName": "K Sportscard Authentication (KSA)"
},
{
"conditionDescriptorValueId": "275018",
"conditionDescriptorValueName": "Gem Mint Authentication (GMA)"
},
{
"conditionDescriptorValueId": "275019",
"conditionDescriptorValueName": "Hybrid Grading Approach (HGA)"
},
{
"conditionDescriptorValueId": "2750110",
"conditionDescriptorValueName": "International Sports Authentication (ISA)"
},
{
"conditionDescriptorValueId": "2750112",
"conditionDescriptorValueName": "Gold Standard Grading (GSG)"
},
{
"conditionDescriptorValueId": "2750113",
"conditionDescriptorValueName": "Platin Grading Service (PGS)"
},
{
"conditionDescriptorValueId": "2750114",
"conditionDescriptorValueName": "MNT Grading (MNT)"
},
{
"conditionDescriptorValueId": "2750115",
"conditionDescriptorValueName": "Technical Authentication & Grading (TAG)"
},
{
"conditionDescriptorValueId": "2750116",
"conditionDescriptorValueName": "Rare Edition (Rare)"
},
{
"conditionDescriptorValueId": "2750117",
"conditionDescriptorValueName": "Revolution Card Grading (RCG)"
},
{
"conditionDescriptorValueId": "2750120",
"conditionDescriptorValueName": "Card Grading Australia (CGA)"
},
{
"conditionDescriptorValueId": "2750121",
"conditionDescriptorValueName": "Trading Card Grading (TCG)"
},
{
"conditionDescriptorValueId": "2750123",
"conditionDescriptorValueName": "Other"
}
]
},
{
"conditionDescriptorId": "27502",
"conditionDescriptorName": "Grade",
"conditionDescriptorHelpText": "Select a grade",
"conditionDescriptorConstraint": {
"defaultConditionDescriptorValueId": "275020",
"cardinality": "SINGLE",
"mode": "SELECTION_ONLY",
"usage": "REQUIRED",
"applicableToConditionDescriptorIds": [
"27501"
]
},
"conditionDescriptorValues": [
{
"conditionDescriptorValueId": "275020",
"conditionDescriptorValueName": "10",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275021",
"conditionDescriptorValueName": "9.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275019",
"2750112",
"2750113",
"2750114",
"2750116",
"2750117",
"2750120",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275022",
"conditionDescriptorValueName": "9",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275023",
"conditionDescriptorValueName": "8.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275024",
"conditionDescriptorValueName": "8",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275025",
"conditionDescriptorValueName": "7.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275026",
"conditionDescriptorValueName": "7",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275027",
"conditionDescriptorValueName": "6.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275028",
"conditionDescriptorValueName": "6",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "275029",
"conditionDescriptorValueName": "5.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275018",
"275019",
"2750110",
"2750112",
"2750114",
"2750115",
"2750116",
"2750117",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750210",
"conditionDescriptorValueName": "5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750211",
"conditionDescriptorValueName": "4.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275018",
"275019",
"2750110",
"2750112",
"2750114",
"2750115",
"2750116",
"2750117",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750212",
"conditionDescriptorValueName": "4",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750213",
"conditionDescriptorValueName": "3.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275018",
"275019",
"2750110",
"2750112",
"2750114",
"2750115",
"2750116",
"2750117",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750214",
"conditionDescriptorValueName": "3",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750215",
"conditionDescriptorValueName": "2.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275018",
"275019",
"2750110",
"2750112",
"2750114",
"2750115",
"2750116",
"2750117",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750216",
"conditionDescriptorValueName": "2",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750217",
"conditionDescriptorValueName": "1.5",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275018",
"275019",
"2750110",
"2750112",
"2750114",
"2750115",
"2750116",
"2750117",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750218",
"conditionDescriptorValueName": "1",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275011",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"275019",
"2750110",
"2750112",
"2750113",
"2750114",
"2750115",
"2750116",
"2750117",
"2750120",
"2750121",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750219",
"conditionDescriptorValueName": "Authentic",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275012",
"275013",
"275014",
"275015",
"275016",
"275017",
"275018",
"2750110",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750220",
"conditionDescriptorValueName": "Authentic Altered",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275010",
"275012",
"275013",
"275015",
"2750110",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750221",
"conditionDescriptorValueName": "Authentic - Trimmed",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275017",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750222",
"conditionDescriptorValueName": "Authentic - Colored",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275017",
"2750123"
]
}
]
},
{
"conditionDescriptorValueId": "2750223",
"conditionDescriptorValueName": "Sample",
"conditionDescriptorValueConstraints": [
{
"applicableToConditionDescriptorId": "27501",
"applicableToConditionDescriptorValueIds": [
"275015"
]
}
]
}
]
},
{
"conditionDescriptorId": "27503",
"conditionDescriptorName": "Certification Number",
"conditionDescriptorHelpText": "Enter certification number (recommended)",
"conditionDescriptorConstraint": {
"maxLength": 20,
"cardinality": "SINGLE",
"mode": "FREE_TEXT"
}
}
]
},
{
"conditionId": "3000",
"conditionDescription": "Used"
},
{
"conditionId": "4000",
"conditionDescription": "Ungraded",
"conditionHelpText": "Not in original packaging or professionally graded",
"conditionDescriptors": [
{
"conditionDescriptorId": "40001",
"conditionDescriptorName": "Card Condition",
"conditionDescriptorHelpText": "Select ungraded condition ",
"conditionDescriptorConstraint": {
"defaultConditionDescriptorValueId": "400010",
"cardinality": "SINGLE",
"mode": "SELECTION_ONLY",
"usage": "REQUIRED"
},
"conditionDescriptorValues": [
{
"conditionDescriptorValueId": "400010",
"conditionDescriptorValueName": "Near mint or better",
"conditionDescriptorValueHelpText": "Comparable to a fresh pack",
"conditionDescriptorValueAdditionalHelpText": [
"Minor corner and edge wear"
]
},
{
"conditionDescriptorValueId": "400011",
"conditionDescriptorValueName": "Excellent",
"conditionDescriptorValueHelpText": "Has clearly visible signs of wear",
"conditionDescriptorValueAdditionalHelpText": [
"Moderate edge chipping",
"Moderate surface scuffing",
"Fuzzy corners"
]
},
{
"conditionDescriptorValueId": "400012",
"conditionDescriptorValueName": "Very good",
"conditionDescriptorValueHelpText": "Has moderate-to-heavy damage all over",
"conditionDescriptorValueAdditionalHelpText": [
"Moderate discoloration",
"Moderate creasing",
"Moderate to heavy edge chipping",
"Rounding and soft corner"
]
},
{
"conditionDescriptorValueId": "400013",
"conditionDescriptorValueName": "Poor",
"conditionDescriptorValueHelpText": "Is extremely worn and displays flaws all over",
"conditionDescriptorValueAdditionalHelpText": [
"Heavily worn and rounded corners",
"Major creasing",
"Moderate discoloration",
"Major border wear"
]
}
]
}
]
}
]
}
]
}
つまり、これまでのItem Specificsとは別の設定になります。
2023/12時点でのrequired
-
Graded:Professional Grader(27501)及びGrade(27502) -
Ungraded:Card Condition(400010)
2023/12時点でのrecommended
-
Graded:Certification Number(27503)(この項目は、AdditionalInfo)
Condition指定の方法
AdditionalInfo以外は、Name:ValueのIDペアで指定します。
Trading API / Sell Feed API(LMSを利用する場合）
Inventory API
SDKを利用している人向け
下記の情報を参照し、最新のWSDLを以ってSDKを更新してください。
Java SDK - https://developer.ebay.com/support/kb-article?KBid=1361
.NET SDK - https://developer.ebay.com/support/kb-article?KBid=1034
リクエスト方法の例
以下の記事が分かりやすいです。
（私の投稿より簡潔に書かれており、おすすめ記事です）。