商品仕様ガイド

mobile_link

形式: 文字列

モバイル向けに最適化された商品のページのURLです。ここでアイテムを購入できます。 モバイル端末を使用する利用者には、mobile_link属性で指定されたURLが表示されます。

URLは、RFCに準じて確認されます。 具体的には、「https」または「http」を含める必要があります。

サンプル値:

• https://lite.twttr.com/twtr_blue

additional_image_link

形式: 文字列

アイテムの画像を追加するには、additional_image_linkを使用します。 URLはコンマで区切る必要があります。 image_link属性で説明した仕様に従います。 画像は最大10点追加できます。

サンプル値:

• https://t.co/jeans_1.jpg, https://t.co/jeans_2.jpg, https://t.co/demin_jeans_3.jpg

google_product_category

形式: 文字列

Googleの商品カテゴリーに従った商品のカテゴリーです。 カテゴリーの分類パスまたはカテゴリーID番号を使用します。 このカテゴリーはTwitter利用者に表示される場合があります。

サンプル値:

• 電気製品 > テレビゲーム本体
• 1294

product_type

形式: 文字列

貴社で従来から使用している商品分類がある場合に、その分類で商品が属するカテゴリーです。 Google商品カテゴリー（google_product_category）を入力することもできます。 サブカテゴリーは " > " で区切ってつなげる必要があります。 > の前後にはスペースを入れる必要があります。 このカテゴリーはTwitter利用者に表示される場合があります。

サンプル値:

• 衣料品 > 男性用 > パンツ・ズボン > デニム

inventory

形式: 整数

0以上であることが必要です。

Twitterでの販売用に保有している、このアイテムの数量です。 これを含める場合、利用者に表示されるアイテムのavailabilityフィールドが「在庫あり」に設定されているときは、inventoryの値は1以上でなければなりません。 それ以外で、利用者に表示されるアイテムのavailabilityフィールドが「注文受付中」または「事前予約」に設定されているときは、この値は0以上にできます。

サンプル値:

• 10000
  

sale_price

形式: 文字列

0以上であることが必要です。

アイテムの割引後の単価です。 単価の形式は数値で、その後に3桁のISO通貨コード（ISO 4217標準）を続けます。価格と通貨の間にはスペースを入れます。 小数点にはピリオド（"."）を使用します。 sale_priceは、priceよりも低くする必要があります。

サンプル値:

• 89.99 USD
• 15.00 CAD

sale_price_effective_date

形式: 1つまたは2つのISO-8601形式の日付と時間

アイテムの販売期間です。販売を開始および終了する日付、時刻、タイムゾーンを含めます。 販売日が入力されていない場合、sale_priceを設定したアイテムは、その販売単価を削除するまで販売されます。

終了日を入れずに開始日だけを入力することもできます。この場合は、販売単価を削除するまでその販売単価で販売されます。

形式: YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00

開始日は終了日より前にする必要があります。

詳細な手順:

1. 開始日をYYYY-MM-DDの形式で入力します。
2. 開始日の後に "T" を入力します。
3. 開始時刻を24時間形式（00:00～23:59）で入力し、その後にUTCタイムゾーン（-12:00～+14:00）を入力します。
4. "/" を入力し、同じ形式でアイテムの販売終了日時を入力します。

以下の例は、PSTタイムゾーン（-08:00）を使用しています。

サンプル値:

• 2020-06-28T09:00-08:00/2020-07-28T23:59-08:00

item_group_id

形式: 文字列

最大文字数: 100

item_group_id属性を使用して、商品のバリエーションをグループにまとめます。 バリエーションは、商品のサイズ、色、年齢層、性別などの詳細のみが異なる類似のアイテムのグループです。 このフィールドは、商品にバリエーションがある場合は必須です。

サンプル値:

• twtrshoes1234_12

性別

形式: 文字列

アイテムのサイズ設定の性別を指定します。 以下のリストの指定可能な値から1つ選択します。

指定可能な値:

• 女性
• 男性
• ユニセックス

color

形式: 文字列

最大文字数: 100

商品のメインカラーです。 1つ以上の単語を使ってカラーを表してください。 16進数コードは使用しないでください。

サンプル値:

• ブルー
• フォレストグリーン

size

形式: 文字列

最大文字数: 100

単語、略語、または数字で書かれたアイテムのサイズです。

サンプル値:

• ミディアム
• M
• 6

age_group

形式: 文字列

アイテムに関連付けられる年齢層です。 以下のリストの指定可能な値から1つ選択します。

指定可能な値:

• 大人
• 全年齢
• 10代
• 子供
• 幼児
• 乳児
• 新生児
  

custom_label

形式: 文字列

追加情報を含める最大5つのカスタムフィールド（custom_label_0、custom_label_1、custom_label_2、custom_label_3、custom_label_4）です。フィルターベースの商品セットを作成する場合に、この情報を使用してアイテムをフィルターで絞り込むことができます。

たとえば、カスタムラベルフィールドを使用して、サマーセールに含めるすべての商品を指定し、それらの商品をフィルターで絞り込んで商品セットにまとめることができます。 これらのフィールドでは、文字列値がサポートされています。

例:

• ホリデーセール