2025 年 8 月 18 日
Content API は非推奨となり、2026 年 8 月にシャットダウンされます。Merchant API に移行する
2025 年 6 月 19 日
製品サービス
Product リソース
インドでの最大小売価格（MRP）の指定を可能にするため、maximum_retail_price フィールドを追加しました。
販売者サポート サービス
2025 年 5 月 26 日
アカウント サービス
アカウントに読み取り専用ユーザーを追加できるようになりました。
2025 年 4 月 14 日
アカウント サービス
今後、この要件は不要になるため、accounttax サービスは非推奨になりました。
2025 年 3 月 17 日
注文関連サービス
注文関連の API のシャットダウンの一環として、次のサービスは非推奨になりました。
accounts.verifyphonenumberreturnpolicy
その他のサービス
このエンドポイントは不要になったため、非推奨にできます。
pubsubnotificationsettings
2025 年 2 月 10 日
prerendered_out_of_court_dispute_settlement フィールドを ProductIssue と AccountIssue に追加しました。
RenderProductIssuesResponse と RenderAccountIssuesResponse の alternate_dispute_resolution フィールドを非推奨にしました。
2024 年 12 月 12 日
製品サービス
sustainability_incentives フィールドを追加しました。このフィールドでは、商品の税額控除や価格割引などの持続可能性に関するインセンティブを指定できます。フィールド値が指定されていない場合、その商品はサステナビリティ インセンティブの対象になりません。
2024 年 11 月 15 日
製品サービス
LoyaltyProgram に、利用資格を指定する shipping_label フィールドを追加しました。このフィールドに値がある場合、この特典にはロイヤリティ配送特典があります。フィールド値が指定されていない場合、そのアイテムは指定されたポイント プログラムのレベルのポイント プログラムの配送方法の対象外となります。
2024 年 10 月 30 日
決済関連サービス
決済関連 API のシャットダウンの一環として、次のサービスは非推奨となります。
settlementreportssettlementtranscations
決済関連 API のシャットダウンは、以前にシャットダウンされた BuyOnGoogle プログラムと注文関連 API に関連しています。
前述のサービスへの呼び出しは、Service was not found on the server レスポンスで失敗することが想定されます。
2024 年 10 月 16 日
UpdateConversionSourceRequest の update_mask が OPTIONAL になりました。更新マスクが指定されていない場合、空でない値を持つすべてのフィールドが更新されます。
2024 年 8 月 26 日（当初の予定より早くなります）
注文関連サービス
注文関連の API のシャットダウンの一環として、次のサービスは非推奨になりました。
orderinvoicesorderreportsorderreturnsorderreturns.labelsorders
前述のサービスへの呼び出しは、Service was not found on the server レスポンスで失敗することが想定されます。
OrderTrackingSignals サービスは非推奨ではなく、引き続き利用できます。
2024 年 8 月 10 日
「Google で購入」サービス
Google で購入 API のサービス終了に伴い、BuyOnGoogleProgramService 内のすべてのメソッドは service was not found on the server で失敗します。
2024 年 7 月 19 日
製品サービス
member_price_effective_date フィールドを追加しました。この更新により、ロイヤリティ メンバー価格が有効な日付範囲を指定できるようになります（該当する場合）。フィールド値が指定されていない場合、メンバー価格は常に有効です。
2024 年 5 月 20 日
製品サービス
LoyaltyPrograms を追加しました。このアップデートにより、1 つの商品に対して、異なるポイント、価格などの複数のレベルを提供できるようになります。このフィールドは、単数形の LoyaltyProgram フィールドの代わりに使用する必要があります。
レポート サービス
MerchantPerformanceView
テーブルの非推奨の「Google で購入」の指標。この更新後、Google で購入の指標を取得すると 0 が返されます。これは、過去の日付の履歴値にも適用されます。
詳しくは、「Google で購入」のサポート終了をご覧ください。
2024 年 5 月 13 日
製品サービス
Product リソース
認証フィールドの変更: 認証機関が認証コードや番号を発行しない場合でも、ユーザーが認証情報をアップロードできるように、認証値（クラス、レベル、グレードとも呼ばれます）を提供するため、ProductCertification フィールドに certificationValue を追加しました。
詳細については、プロダクト ガイドをご覧ください。
2024 年 5 月 6 日
レポート サービス
PriceInsightsProductView テーブルに有効性バケットを追加しました。有効性は、価格変更のメリットが特に大きい商品を示します。この評価では、セール価格を調整することで予測されるパフォーマンスの向上と、現在の価格と提案価格の差額が考慮されます。
2024 年 4 月 24 日
製品サービス
Product リソース
分割払い用のオプションの downpayment フィールドと creditType フィールドを追加しました。
downpaymentは、購入者が最初に 1 回だけ支払う金額を提供します。creditTypeは、分割払いのタイプ（financeまたはlease）を指定します。このフィールドは車両広告にのみ適用されます。
2024 年 4 月 11 日
製品サービス
Product リソース
- 商品レベルの送料に送料無料の基準額属性（
FreeShippingThreshold）を追加しました。この属性を使用すると、送料が無料になる商品の最低価格を入力できます。 LoyaltyPointsの公開設定を変更しました
2024 年 4 月 10 日
製品サービス
Product リソース
LoyaltyProgram を追加しました
2024 年 4 月 9 日
製品サービス
Product リソース
AI が生成した商品のタイトルと説明を提供するために、structuredTitle と structuredDescription を追加しました。
2024 年 4 月 3 日
販売者サポート サービス
パートナーが新しいタイプのアクション（BuiltInUserInputAction）をリクエストできる user_input_action_option フィールドを追加しました。このアクションを使用すると、パートナーは販売者向けの複雑なセルフサービス機能を、Merchant Center にリダイレクトするのではなく、アプリケーション内で直接構築できます。
BuiltInUserInputAction に新しい TriggerAction メソッドを追加しました。このメソッドにアクセスするには、[What is the issue/question?]（問題 / 質問の内容）で Shopping API サポート フォームから許可リストのリクエストを送信してください。
2024 年 3 月 27 日
製品サービス
Product リソース
「自動割引」プロジェクトと「動的プロモーション」プロジェクトに AutoPricingMinPrice を保護機能として追加しました。これにより、販売者の商品の割引によって商品価格がこの値を下回ることがなくなります。これにより、提案の価値と収益性が維持されます。
2024 年 3 月 15 日
検索とショッピングでの「Google で購入」を終了します。orders.list と orders.get を使用して、2024 年 10 月 31 日まで既存の注文を引き続き表示できます。
2024 年 3 月 8 日
レポート サービス
Reports サービスに TopicTrendsView レポートを追加しました。
詳しくは、レポート ガイドをご覧ください。
2024 年 3 月 6 日
レポート サービス
商品のクリックの可能性のバケットとランクを追加しました。
詳しくは、レポート ガイドをご覧ください。
2024 年 2 月 19 日
ConversionSources サービス
以下の値を有効なコンバージョン ソースとして削除しました。
CROSS_CHANNEL_FIRST_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_CHANNEL_TIME_DECAY
ルックバック ウィンドウの日数として 60 と 90 のオプションを削除し、40 を有効なオプションとして追加しました。
2024 年 1 月 17 日
POS サービス
PosStore の matching_status_hint フィールドに新しい値を追加しました。これにより、ユーザーはストアのマッチングが失敗した理由についてより詳細な情報を得ることができます。
2024 年 1 月 11 日
アカウント サービス
link メソッドのリンクタイプとサービスとしてそれぞれ localProductManager と localProductManagement を追加しました。これらのリンクにより、ローカル商品データを管理する目的でアカウントをリンクできます。
2023 年 11 月 29 日
販売者サポート サービス
Merchant Center で実行する必要がある身元確認用の外部アクション タイプ VERIFY_IDENTITY_IN_MERCHANT_CENTER を追加しました。
POS サービス
PosStore に matching_status フィールドと matching_status_hint フィールドを追加しました。これにより、ユーザーは POS 店舗と Google ビジネス プロフィールの店舗のマッチング ステータスを確認し、問題が発生した場合は解決のヒントを得ることができます。
2023 年 11 月 15 日
repricingrules エンドポイントと repricingrules.repricingreports エンドポイントはサポートされなくなりました。
2023 年 11 月 1 日
Shipping Settings サービス
shipment_type=pickup はサポートされなくなります。
2023 年 10 月 18 日
アカウント サービス
販売者が特定の消費者の価値観を自己識別できる Business Identity フィールドを追加しました。
2023 年 10 月 10 日
配送設定サービスの新しい配送タイプとして Collection Point を追加しました。集荷所への配送は、自宅に直接配送するのではなく、外部の提携拠点（UPS アクセス ポイントなど）に商品を配送するサービスです（販売者が所有していないなど）。
2023 年 9 月 18 日
ローカル在庫広告の設定サービス
ユーザーがオムニチャネル エクスペリエンス（店舗詳細ページと受け取りの設定など）を設定できるように、setOmnichannelExperience メソッドを追加しました。現時点では、この設定を有効にするために信頼できる POS プロバイダを利用しているユーザーのみが対象となります。
2023 年 9 月 7 日
「Google で購入」サービスの終了
GetBuyOnGoogleProgramStastus メソッドに新しい DEPRECATED ステータスを追加します。このような状態からプログラムを再開または一時停止することはできません。
2023 年 9 月 4 日
販売者サポート サービス
アカウント単位で解決する必要がある商品に関する問題について、FIX_ACCOUNT_ISSUE の組み込みアクションを追加しました。国内当局からの正当性を伝えるために使用される SHOW_ADDITIONAL_CONTENT 組み込みアクションを追加しました。
2023 年 8 月 28 日
プロモーション サービス
Promotions サービスの list メソッドへのアクセスを制限付きからすべてに変更しました。
2023 年 8 月 22 日
販売者サポート サービス
販売者サポート サービスを開始しました。このサービスでは、アカウントの問題やプロダクトの問題に関するサポート コンテンツを提供しています。
2023 年 8 月 4 日
レポート サービス
レポート サービスに競合他社の競合視認性レポートを追加しました。
詳しくは、レポート ガイドをご覧ください。
2023 年 7 月 25 日
POS サービス
インベントリ リソース
pickup_method フィールドと pickup_sla フィールドを追加して、販売者が在庫とともに受け取り情報を送信できるようにします。
2023 年 7 月 14 日
レポート サービス
レポート サービスに競合視認性レポートを追加しました。
詳しくは、レポート ガイドをご覧ください。
2023 年 7 月 7 日
製品サービス
Product リソース
3D モデル画像の URL を提供する virtualModelLink を追加しました。
2023 年 7 月 4 日
製品サービス
Product リソース
certifications フィールドを追加して、商品認証を提供します。たとえば、EU の EPREL データベースに基づく商品の省エネ ラベリングなどです。
2023 年 6 月 26 日
Shipping Settings サービス
ローカル フルフィルメント
販売者が n 日の地域配達に設定された配送サービスを利用している場合に、n+1 日の地域配達の表示をオプトアウトできるように、no_delivery_post_cutoff フィールドを追加しました。
2023 年 5 月 29 日
プロモーション サービス
Promotions サービスの list メソッドを追加しました。
レコメンデーション サービス
Recommendations サービスの ReportInteraction メソッドでインタラクションの破棄を有効にします。
2023 年 5 月 9 日
Cloud Retail のリンク先
Cloud Retail の追加プロパティ
クラウド小売業の追加プロパティ フィールドを追加します。これは、Cloud Retail の宛先を使用しているお客様が使用することを目的とした繰り返しフィールドです。このフィールドを使用すると、クラウド小売プログラムを使用する際に利用できるようになります。これは、Google Cloud Retail プロダクト モデルの属性フィールドにマッピングされます。
2023 年 5 月 22 日
プロモーション サービス
Promotions サービスの list メソッドを追加しました。
2023 年 4 月 11 日
Shipping Settings サービス
ローカル フルフィルメント
新しい配送設定を作成する販売者向けに、ローカル配送の配送オプションを追加しました。新しい storeConfig フィールドで、ローカル店舗の設定を構成できます。これには、ローカル配送を提供する店舗のサービス半径、締め切り時間、店舗コードが含まれます。
4 月 3 日
レコメンデーション サービス
レコメンデーション サービスをリリースしました。このサービスでは、販売アカウントのパフォーマンスを改善する方法が提案され、販売者が有用な推奨事項をクリックしたことを報告できます。
2023 年 2 月 20 日
アカウント サービス
アカウント リソース
Accounts リソースに新しいセクション Account.ConversionSettings を追加しました。
ConversionSources サービス
コンバージョンの発生元の管理をサポートするコンバージョンの発生元サービス（Merchant Center の [コンバージョン設定] セクションの一部）を追加しました。
2023 年 2 月 16 日
Shipping Settings サービス
店舗コードの検証
店舗コードが検証されるようになり、配送設定が更新される前に、店舗コードが販売者に属していることが確認されます。
ローカル在庫広告の販売者の確認
送料の設定を更新する前に、販売者 ID が登録されているプログラムが検証されるようになりました。販売者は次のいずれかのプログラムに参加している必要があります。
LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLELOCAL_INVENTORY_ADS
2023 年 2 月 9 日
プロモーション サービス
ローカル contentLanguage サポートにより、プロモーション サービスを 6 つの追加の targetCountry オプションに拡大しました。
BRESNLJPITKR
2023 年 1 月 12 日
製品サービス
Product リソース
使用イメージ画像の URL を提供する lifestyleImageLinks を追加しました。
2022 年 11 月 24 日
プロモーション サービス
Promotions.PromotionStatus セクションに新しいフィールド `promotionStatus` を追加しました。読み取り専用のフィールドです。
2022 年 11 月 15 日
レポート サービス
レポート サービスにマーケット インサイト レポートを追加しました。
これで、レポート サービスに対して次のクエリを実行できます。
BestSellersProductClusterViewテーブルとBestSellersBrandViewテーブルを使用するベストセラー レポート。PriceCompetitivenessProductViewテーブルを使用した価格競争力レポート。PriceInsightsProductViewテーブルを使用した価格分析レポート。
詳しくは、レポート ガイドをご覧ください。
2022 年 11 月 7 日
Datafeeds Service
Datafeeds サービスに feedLabel のサポートを追加しました。
2022 年 9 月 14 日
任意の文字列を受け入れるように feedLabel を更新しました。
2022 年 8 月 9 日
商品に feedLabel を追加しました。
targetCountry の代わりに feedLabel を使用して、特典 ID の国を指定できるようになりました。特典 ID は online:language:feedLabel:offerId として構築されるようになりました。
下位互換性を維持するため、既存のフィードの feedLabel に targetCountry の値が自動的に入力されています。
targetCountry を非推奨にしました。
グローバルな商品情報をサポートするため、Content API for Shopping では targetCountry フィールドが非推奨になりました。代わりに、shipping フィールドを使用して対象国を指定することをおすすめします。
targetCountry に、feedLabel で指定した値が自動的に入力されるようになりました。
詳しくは、ブログ投稿の Content API for Shopping でフィードラベルが対象国に代わるをご覧ください。
2021 年 12 月 8 日
アカウント サービス
アカウント リソース
アカウント リソースに新しいセクション Account.AutomaticImprovements を追加しました。
この新しいセクションでは、商品アイテムの自動更新、画像と配送設定の改善が可能になります。
2021 年 10 月 25 日
プロモーション サービス
Promotion API に Get Promotion を追加しました。
2021 年 10 月 11 日
Shipping Settings API
ShippingSettings リソースに新しい warehouse フィールドを追加しました。これにより、販売者は WarehouseBasedDeliveryTime で使用できる倉庫を管理できます。
WarehouseBasedDeliveryTime に新しい warehouseName フィールドを追加して、倉庫名で倉庫を参照できるようにしました。
2021 年 10 月 4 日
アカウント サービス
アカウント リソース
Accounts.BusinessInformation セクションに新しいフィールド「phone_verification_status」を追加しました。読み取り専用のフィールドで、Accounts.VerifyPhoneNumber によって設定されます。
2021 年 9 月 13 日
BuyOnGooglePrograms サービス
BuyOnGoogleProgramStatus リソース
BuyOnGooglePrograms.BuyOnProgramStatus リソースに、オンライン販売チャネル、ビジネスモデル、カスタマー サービス電話番号を表す新しいフィールドを追加しました。
新しい UpdateBuyOnGoogleProgramStatus メソッド
拡張された BuyOnGooglePrograms.BuyOnProgramStatus リソースを更新できる新しい UpdateBuyOnGoogleProgramStatus メソッドを追加しました。
2021 年 9 月 6 日
アカウント サービス
アカウント リソース
Accounts.BusinessInformation セクションに新しいフィールド「korean_business_registration_number」を追加しました。このフィールドは、明示的に空の文字列に設定された場合にのみクリアされます。
2021 年 8 月 30 日
プロモーション サービス
プロモーションの挿入が可能な新しいプロモーション サービスを追加しました。
注文サービス
発送前に資金を確保する新しいメソッド orders/captureOrder を追加しました。
新規注文のキャンセル理由 FAILED_TO_CAPTURE_FUNDS
製品サービス
Product リソース
商品のサイズと重量を提供するために、productLength、productHeight、productWidth、productWeight を追加しました。
2021 年 8 月 9 日
RepricingRule サービス
RepricingRule のタイプ
RepricingRuleType フィールドの新しい列挙値。
TYPE_SALES_VOLUME_BASED と TYPE_COMPETITIVE_PRICE を追加しました。
2021 年 5 月 17 日
Order Returns Label Service
CreateReturnRequest に新しい product_id フィールドを追加しました。販売者は、返品する商品を特定するために product_id または line_item_id のいずれかを指定できます。
製品サービス
既存のプロダクトを更新する新しいメソッドを追加しました。商品全体ではなく、更新が必要なフィールドのみを指定して商品を更新できます。
2021 年 5 月 3 日
Order Returns Label Service
販売者が管理する返品（MMR）のラベルをアップロードする新しいメソッドを追加しました。新しい orderreturns.labels.create を使用すると、返品ラベルをアップロードしてお客様と共有できます。
2021 年 4 月 26 日
Shipping Settings API
DeliveryTime に新しい warehouseBasedDeliveryTimes フィールドを追加し、倉庫の所在地と選択した運送業者のサービスに基づいて推定お届け日を計算する配送サービスをサポートします。
CarriersCarrier オブジェクトに新しい eddServices フィールドを追加し、推定お届け日の計算に適用できるサービスの名前を返します。
2021 年 4 月 12 日
製品サービス
Product リソース
商品ごとに最大 2 つのサイズタイプをサポートする新しい additionalSizeType フィールド。
送料フィールドの変更: ProductShipping に minHandlingTime、maxHandlingTime、minTransitTime、maxTransitTime を追加し、オファーレベルの配送予定を提供します。
2021 年 1 月 28 日
アカウント サービス
AccountLabel リソースと Account リソースに自動ラベルのサポートを追加しました。詳しくは、CSS ラベル管理ガイドの CSS ラベルの種類をご覧ください。
2020 年 10 月 5 日
CSSES サービス
CSS リソース
CSS ドメインに関する情報を取得してラベルを割り当てるための新しい csses サービスを追加しました。AccountLabel リソースを使用して、CSS グループレベルのラベルを作成して一覧表示できるようになりました。詳しくは、CSS ラベルの管理をご覧ください。
2020 年 8 月 24 日
製品サービス
Products リソース
特定の国での広告掲載から特典を除外するための新しい shoppingAdsExcludedCountries フィールド。
Productstatuses リソース
destinationStatuses オブジェクトに新しい approvedCountries、pendingCountries、disapprovedCountries フィールドが追加されました。これにより、targetCountry を超える特典ステータス情報を提供できます。
新しい itemLevelIssues.applicableCountries フィールド。
2020 年 8 月 10 日
アカウント サービス
CSS Center の Merchant Center アカウント ラベルを管理するための新しい AccountLabel リソースを追加しました。CSS Center ユーザーは、accounts.list、accounts.get、accounts.updatelabels のメソッドを使用して、Merchant Center アカウントを一覧表示し、ラベルを割り当てることもできるようになりました。詳しくは、CSS ラベルの管理をご覧ください。
2020 年 6 月 19 日
製品サービス
Product リソース
新しいフィールド
新しい productDetails、productHighlights、subscriptionCost、canonicalLink フィールド。
2020 年 6 月 2 日
注文サービス
返品なしで払い戻しを開始する新しい方法を追加しました。新しい orders.refunditem と orders.refundorder を使用すると、お客様が返品していない注文についても払い戻しを開始できます。
2020 年 4 月 27 日
Orderreturns サービス
新しいメソッド acknowledge と process、読み取りメソッド（list、get）用の新しいフィルタとフィールドを追加しました。
Google マイビジネスのリンク
GMB アカウント ID を使用して Merchant Center アカウントを GMB アカウントにリンクする機能を追加しました。
2020 年 4 月 14 日
Settlement Report API
決済レポートを取得するための新しいサービスを追加しました。
2020 年 3 月 9 日
ローカル在庫 API
ローカル在庫データを送信するための新しいサービスを追加しました。
2020 年 3 月 2 日
Pub/Sub 通知設定 API
pubsub 通知の設定を管理する新しいサービスを追加しました。
2019 年 12 月 3 日
製品サービス
マルチクライアント アカウントの補助 Content API フィードのサポートが追加されました。
2019 年 9 月 11 日
注文サービス
注文と対応するサンドボックス機能で、集荷配送のサポートを追加しました。
2019 年 8 月 14 日
新しいサービス
「Google で購入」に新しい Returnpolicy サービスと Returnaddress サービスを追加しました。
注文サービス
注文リソース
新しいフィールド
新しい quantityUndeliverable フィールド。
2019 年 8 月 7 日
注文サービス
注文リソース
新しいフィールド
Order リソースに新しい loyaltyInfo フィールドと invoiceReceivingEmail フィールドを追加しました。
2019 7 月 1 日
製品サービス
商品サービスに Content API 補助フィードのサポートが追加されました。
2019 年 6 月 11 日
注文サービス
Order リソースと TestOrder リソース
価格調整の追加
プロモーションの適用によって生じた元の明細項目の価格と税金の調整を含む新しい lineItem[].adjustments フィールドを追加しました。
2019 年 2 月 14 日
このバージョンでの変更点
ドライランのサポート終了
パラメータ dryRun が v2.1 から削除されました。これはすべての API 呼び出しに適用されます。
PATCH メソッドのサポート終了
次のサービスでは patch メソッドがサポートされなくなりました。
- アカウント
- Accounttax
- データフィード
- Liasettings
- Shippingsettings
HTTP BATCH メソッドの削除
v2.1 からすべての HTTP BATCH メソッドが削除されました。代わりに customBatch を使用してください。影響を受けるサービスは次のとおりです。
- アカウント
- Accountstatuses
- データフィード
- Datafeedstatuses
- Liasettings
- Orderreports
- 順位
- プロダクト
- Productstatuses
- Shippingsettings
アカウント サービス
更新
リクエストの businessInformation フィールドと googleMyBusinessLink フィールドは、Content API v2 の初回リリース後に導入されました。そのため、これらの 2 つのフィールドに情報が入力されていない場合、販売者が update を使用して誤って情報を削除しないようにするための保護機能が用意されています。
v2 では、これらのフィールドを削除するには、空の本文（{}）で明示的に指定する必要があります。v2.1 では、空の本文を指定した場合、またはフィールドを指定しなかった場合、フィールドは削除されます。
アカウント リソース
AdWords -> Google Ads へのブランド変更
AdWords が Google 広告に移行したことに伴い、AdWords 関連の以下のフィールドの名前が変更されました。
adwordsLinks->adsLinksadwordsLinks.adwordsId->adsLinks.adsId
サポートが終了したフィールドと値の削除
非推奨のフィールド reviewsUrl が削除されました。また、adsLinks、googleMyBusinessLink、youtubeChannelLinks のリンク ステータス inactive が削除されました。
Accountstatuses サービス
AccountStatus リソース
dataQualityIssues の削除
これらは itemLevelIssues に置き換えられました。
データフィード サービス
データフィードのリソース
サポートが終了したフィールドの削除
contentLanguage、targetCountry、intendedDestinations の各フィールドが削除され、targets の country、language、includedDestinations、excludedDestinations に置き換えられました。
商品在庫の更新の削除
タイプ product inventory update のフィードが削除されました。
在庫サービス
v2 の inventory サービスは削除され、v2.1 の 2 つの新機能に置き換えられました。
- 商品の部分的な更新には、新しい補助フィードを使用します。
- ローカル商品の更新には、新しい
localinventoryサービスを使用します。
注文サービス
CancelLineItem
リクエストの amount、amountPretax、amountTax フィールドが削除されました。払い戻し額が自動的に計算されるようになりました。
CustomBatch
CustomBatch が v2.1 から削除されました。
InStoreRefundLineItem
フィールド amountPretax と amountTax がそれぞれ priceAmount と taxAmount に置き換えられました。priceAmount フィールドは、注文の場所に応じて税抜きまたは税込みになります。
払い戻し
このメソッドは削除されました。returnRefundLineItem を代わりに使用してください。
ReturnLineItem
このメソッドは削除されました。代わりに、払い戻し額を指定せずに returnRefundLineItem を使用します。
ReturnRefundLineItem
フィールド amountPretax と amountTax がそれぞれ priceAmount と taxAmount に置き換えられました。priceAmount フィールドは、注文の場所に応じて税抜きまたは税込みになります。
ShipLineItem
リクエストの carrier、shipmentId、trackingId の各フィールドが shipmentInfos に移動しました。
Order リソースと TestOrder リソース
新しいプロモーション フォーマット
v2.1 に新しいプロモーション フォーマットが追加されました。プロモーションを含むテスト注文は作成できません。
サポートが終了したフィールドの削除
フィールド paymentMethod が削除され、billingAddress と predefinedBillingAddress がそれぞれ Order と TestOrder のトップレベル フィールドになりました。
さらに、customer.explicitMarketingPreference を削除し、Order と TestOrder の両方で customer.marketingRightsInfo に置き換えました。
非推奨のフィールド customer.email が削除されました。
Order リソースの promotions フィールドの形式が変更されました。
Orderpayments サービス
このサービスは v2.1 で削除されました。
製品サービス
insert からのレスポンスには、次の属性のみが含まれます。
channelcontentLanguageidofferIdtargetCountry
致命的でない警告とエラーはレスポンスで返されなくなりました。これにより、フィードルールやその他の高度なフィード管理機能との統合が強化されます。
挿入された商品を get または list で取得できるようになるまでに数分の遅延が発生するようになりました。
返されるオファー ID が入力オファー ID と同じであることは保証されなくなりました。
商品挿入前に価格が検証されるようになりました。値文字列で使用できるのは、+、-、.、数字（0～9）のみです。カンマは使用できなくなりました。
Product リソース
CustomGroups が再帰的な customAttributes に置き換えられました
以前は、v2 で同じカスタム グループにカスタム属性を追加することで、カスタム属性をグループ化できました。カスタム属性は v2.1 で再帰的になったため、カスタム グループは不要になりました。
カスタム属性には、元の value フィールドに加えて groupValues フィールドが追加されました。これらのフィールドのいずれか 1 つだけを設定する必要があります。つまり、両方を同時に設定したり、両方とも省略したりすることはできません。
販売者は v2 と v2.1 を切り替える可能性があるため、v2 ではカスタム グループの最大レベル数が 2 であるため表現できない、再帰的なカスタム属性を持つ商品が存在する可能性があります。この場合、カスタム属性グループは切り捨てられます。
customAttributes のタイプと単位の削除
v2.1 では、カスタム属性に type と unit が含まれなくなります。代わりに、単位は value に追加され（存在する場合）、型は自動的に検出されます。たとえば、v2.1 では value として「1.23 EUR」や「5.6 cm」を使用します。
ProductTypes は productType と additionalProductTypes に優先します
以前は、商品タイプは 2 つのフィールドに保存されていました。最初のタイプは単数形のフィールド productType に、残りは繰り返しフィールド additionalProductTypes に保存されていました。v2.1 では、2 つのフィールドが単一の繰り返しフィールド productTypes に置き換えられました。
宛先属性が includedDestinations と excludedDestinations に置き換えられました
v2 では、宛先は宛先名とインテントのペアのリストとして、繰り返しフィールド destinations に入力されていました。このフィールドは、includedDestinations と excludedDestinations の 2 つの繰り返しフィールドに置き換えられました。デフォルトで有効になっているリンク先は includedDestinations. に含める必要はありません。これにより、フィードのリンク先オーバーライドの構成と一致します。
AdWords 関連のフィールド名の変更
AdWords が Google 広告に移行したことに伴い、AdWords 関連の以下のフィールドの名前が変更されました。
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
サポートが終了したフィールドの削除
サポートが終了した次のフィールドが削除されました。
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
Productstatuses サービス
Get と List
product 属性が includeAttributes パラメータとともに削除されました。ステータスに対応する商品の属性を取得するには、Products サービスと新しい productId フィールドの値を使用します。
リスト
パラメータ includeInvalidInsertedItems が削除されました。すべての商品が有効かどうかに関係なく返されるようになりました。つまり、includeInvalidInsertedItems が常に true に設定されているかのように list が動作するようになりました。
ProductStatus リソース
DestinationsStatuses
destinationStatuses のフィールド intention、approvalStatus、approvalPending が status に置き換えられました。status は、approved、disapproved、pending のいずれかになる文字列です。
dataQualityIssues の削除
これらは itemLevelIssues に置き換えられました。