リリースノート(v2.1)

2025 年 8 月 18 日

Content API は非推奨となり、2026 年 8 月にシャットダウンされます。Merchant API に移行する

2025 年 6 月 19 日

製品サービス

Product Resource

インドでの最大小売価格(MRP)の指定を可能にするため、maximum_retail_price フィールドを追加しました。

販売者サポート サービス

2025 年 5 月 26 日

アカウント サービス

アカウントに読み取り専用ユーザーを追加できるようになりました。

2025 年 4 月 14 日

アカウント サービス

今後、この要件は不要になるため、accounttax サービスは非推奨になりました。

2025 年 3 月 17 日

注文関連の API のシャットダウンの一環として、次のサービスは非推奨になりました。

  • accounts.verifyphonenumber
  • returnpolicy

その他のサービス

このエンドポイントは不要になったため、非推奨にできます。

  • 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 のシャットダウンの一環として、次のサービスは非推奨となります。

  • settlementreports
  • settlementtranscations

決済関連 API のシャットダウンは、以前にシャットダウンされた BuyOnGoogle プログラムと注文関連 API に関連しています。

前述のサービスへの呼び出しは、Service was not found on the server レスポンスで失敗することが想定されます。

2024 年 10 月 16 日

UpdateConversionSourceRequest の update_mask が OPTIONAL になりました。更新マスクが指定されていない場合、空でない値を持つすべてのフィールドが更新されます。

2024 年 8 月 26 日(当初の予定より早くなります)

注文関連の API のシャットダウンの一環として、次のサービスは非推奨になりました。

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

前述のサービスへの呼び出しは、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 Resource

認証フィールドの変更: 認証機関が認証コードや番号を発行しない場合でも、ユーザーが認証情報をアップロードできるように、認証値(クラス、レベル、グレードとも呼ばれます)を提供するため、ProductCertification フィールドに certificationValue を追加しました。

詳細については、プロダクト ガイドをご覧ください。

2024 年 5 月 6 日

レポート サービス

PriceInsightsProductView テーブルに有効性バケットを追加しました。有効性は、価格変更のメリットが特に大きい商品を示します。この評価では、セール価格を調整することで予測されるパフォーマンスの向上と、現在の価格と提案価格の差額が考慮されます。

2024 年 4 月 24 日

製品サービス

Product Resource

分割払い用のオプションの downpayment フィールドと creditType フィールドを追加しました。

  • downpayment は、購入者が最初に 1 回だけ支払う金額を提供します。
  • creditType は、分割払いのタイプ(finance または lease)を指定します。このフィールドは車両広告にのみ適用されます。

2024 年 4 月 11 日

製品サービス

Product Resource

  • 商品レベルの送料に送料無料の基準額属性(FreeShippingThreshold)を追加しました。この属性を使用すると、送料が無料になる商品の最低価格を入力できます。
  • LoyaltyPoints の公開設定を変更しました

2024 年 4 月 10 日

製品サービス

Product Resource

LoyaltyProgram を追加しました

2024 年 4 月 9 日

製品サービス

Product Resource

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 Resource

「自動割引」プロジェクトと「動的プロモーション」プロジェクトに 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_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_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 Resource

3D モデル画像の URL を提供する virtualModelLink を追加しました。

2023 年 7 月 4 日

製品サービス

Product Resource

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_GOOGLE
  • LOCAL_INVENTORY_ADS

2023 年 2 月 9 日

プロモーション サービス

ローカル contentLanguage サポートにより、プロモーション サービスを 6 つの追加の targetCountry オプションに拡大しました。

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

2023 年 1 月 12 日

製品サービス

Product Resource

使用イメージ画像の URL を指定するために lifestyleImageLinks を追加しました。

2022 年 11 月 24 日

プロモーション サービス

Promotions.PromotionStatus セクションに新しいフィールド `promotionStatus` を追加しました。読み取り専用のフィールドです。

2022 年 11 月 15 日

レポート サービス

レポート サービスにマーケット インサイト レポートを追加しました。

これで、レポート サービスに対して次のクエリを実行できます。

詳しくは、レポート ガイドをご覧ください。

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 Resource

商品のサイズと重量を提供するために、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 Resource

商品ごとに最大 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 Resource

新しいフィールド

新しい 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 関連の以下のフィールドの名前が変更されました。

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.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 からのレスポンスには、次の属性のみが含まれます。

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

致命的でない警告とエラーはレスポンスで返されなくなりました。これにより、フィードルールやその他の高度なフィード管理機能との統合が強化されます。

挿入された商品を get または list で取得できるようになるまでに数分の遅延が発生するようになりました。

返されるオファー ID が入力オファー ID と同じであることは保証されなくなりました。

商品挿入前に価格が検証されるようになりました。値文字列で使用できるのは、+、-、.、数字(0~9)のみです。カンマは使用できなくなりました。

Product Resource

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 が Google 広告に移行したことに伴い、AdWords 関連の以下のフィールドの名前が変更されました。

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
サポートが終了したフィールドの削除

サポートが終了した次のフィールドが削除されました。

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses サービス

Get と List

product 属性が includeAttributes パラメータとともに削除されました。ステータスに対応する商品の属性を取得するには、Products サービスと新しい productId フィールドの値を使用します。

リスト

パラメータ includeInvalidInsertedItems が削除されました。すべての商品が有効かどうかに関係なく返されるようになりました。つまり、includeInvalidInsertedItems が常に true に設定されているかのように list が動作するようになりました。

ProductStatus リソース

DestinationsStatuses

destinationStatuses のフィールド intention、approvalStatus、approvalPending が status に置き換えられました。status は、approved、disapproved、pending のいずれかになる文字列です。

dataQualityIssues の削除

これらは itemLevelIssues に置き換えられました。