eBayAPI出品：2023/10/23よりTrading Card出品時のCondition指定が変更になります

eBayではAPIで商品を出品する際、商品状態をCondition IDで指定する必要があります。指定できるCondition IDはカテゴリーによって違います。

これまでSingle Trading Cardを出品する際は、`Used`のみしか選ぶことができませんでしたが、
- **2023年夏より`Graded`（鑑定機関による鑑定済み） or `Ungraded`（鑑定無し）の2択に変更されます。**
- **各Conditionに応じたコンディション詳細情報について、`ConditionDescriptors`を利用して提供する必要があります。**

今回の変更に関する概要：Revamp your listings with new conditions
https://www.ebay.com/sellercenter/selling/selling-trading-cards


# タイムライン
- **2023/10/23以降の新規出品は、`Graded` or `Ungraded`のみしか受け付けません。**（現在、若干の猶予が与えられていますが、2023/12からは`Used`(Condition ID: 3000)では出品できなくなります。）
- **2024/01/22以後、現在出品している商品のReviseを行うためには、`Graded` or `Ungraded`が選択されている必要があります。**
:::note warn
注意
つまり`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よりも詳細な情報（例えば、鑑定機関やレーティングといった情報）です。
- `Graded` or `Ungraded`によって、提供できる詳細情報が変わります。
- Metadata API > [getItemConditionPolicies](https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getItemConditionPolicies) を利用して、どのような情報が必要か、どのように指定したら良いか、それは必須かどうかを知ることができます。

[Sample 2: Get the eBay category policies regarding item conditions with condition descriptors](https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getItemConditionPolicies#h2-samples)
<details><summary>サンプルでも表示されていますが、2023/12/03にCategoryID:261328にて取得した結果</summary>

```json
{
  "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"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
```
</details>

:::note info
つまり、これまでの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を利用する場合）

https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ConditionDescriptors

## Inventory API
https://developer.ebay.com/api-docs/sell/inventory/types/slr:ConditionDescriptor

# 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

# リクエスト方法の例
以下の記事が分かりやすいです。
（私の投稿より簡潔に書かれており、おすすめ記事です）。

https://qiita.com/kazuhiro0418/items/72f5aeb1a121d3c55fb5#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%96%B9%E6%B3%95