リリースノート（v2.1）

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 日

製品サービス

商品リソース

認定資格フィールドの変更: 認証値（クラス、レベル、成績とも呼ばれます）を指定するために、ProductCertification フィールドに certificationValue が追加されました。これにより、認証局が認証コードや認証番号を発行していない場合でも、ユーザーは認証情報をアップロードできます。

詳しくは、プロダクト ガイドをご覧ください。

2024 年 5 月 6 日

レポート サービス

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

2024 年 4 月 24 日

製品サービス

商品リソース

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

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

2024 年 4 月 11 日

製品サービス

商品リソース

  • 商品単位の送料に送料無料の基準額属性（FreeShippingThreshold）を追加しました。この属性を使用すると、送料を無料にするための商品の最小価格を入力できます。
  • LoyaltyPoints の公開設定を変更しました

2024 年 4 月 10 日

製品サービス

商品リソース

LoyaltyProgram を追加しました

2024 年 4 月 9 日

製品サービス

商品リソース

AI 生成の商品のタイトルと説明を提供する structuredTitle と structuredDescription を追加しました。

2024 年 4 月 3 日

販売者サポート サービス

パートナーが新しい種類のアクション（BuiltInUserInputAction）をリクエストできるようにする user_input_action_option フィールドを追加しました。このアクションにより、パートナーは販売者を Merchant Center にリダイレクトするのではなく、販売者向けの複雑なセルフサービス機能をアプリ内で直接構築できます。

BuiltInUserInputAction の新しい TriggerAction メソッドを追加しました。この方法にアクセスするには、こちらのフォームからリクエストを送信してください。

2024 年 3 月 27 日

製品サービス

商品リソース

「自動割引」プロジェクトと「動的プロモーション」プロジェクトに安全保護対策として AutoPricingMinPrice を追加しました。これにより、販売者のオファーの割引によって商品価格がこの値より低い値に下がらないようにしました。これにより、商品の価値と収益性を維持できます。

2024 年 3 月 15 日

検索とショッピングでの「Google で購入」のサポート終了既存の注文は、2024 年 10 月 31 日まで orders.list と orders.get を使用して引き続き表示できます。

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 日

配送設定サービス

shipment_type=pickup はサポートされなくなりました。

2023 年 10 月 18 日

アカウント サービス

販売者が特定の消費者価値を自己診断できるようにする Business Identity フィールドを追加しました。

2023 年 10 月 10 日

送料設定サービスの新しい配送タイプとして Collection Point を追加しました。集荷所への配送は、（販売者が所有していないなど）第三者が提供するサービスで、商品は購入者の自宅に直接配送されるのではなく、第三者の提携先の場所（UPS アクセス ポイントなど）に配送されます。

2023 年 9 月 18 日

ローカル在庫広告設定サービス

ユーザーがオムニチャネル エクスペリエンス（ローカル ストアフロントと集荷の設定）を設定できるように setOmnichannelExperience メソッドを追加しました。現時点では、このような設定を有効にできる信頼できる POS プロバイダを利用しているユーザーのみがこの機能を利用できます。

2023 年 9 月 7 日

「Google で購入」のサポート終了

新しい DEPRECATED ステータスを GetBuyOnGoogleProgramStastus メソッドに追加します。このような状態からプログラムを再開または一時停止することはできません。

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 日

製品サービス

商品リソース

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

2023 年 7 月 4 日

製品サービス

商品リソース

certifications フィールドを追加して、EU の EPREL データベースに基づく商品のエネルギー効率ラベルなど、商品認証を指定します。

2023 年 6 月 26 日

配送設定サービス

ローカル フルフィルメント

no_delivery_post_cutoff フィールドを追加しました。これにより、販売者は、配送サービスを n 日間の地域配達に設定している場合に、n+1 日間の地域配達の表示をオプトアウトできるようになりました。

2023 年 5 月 29 日

プロモーション サービス

Promotions サービスに list メソッドを追加しました。

レコメンデーション サービス

Recommendations サービスの ReportInteraction メソッドでインタラクションの閉じを有効にします。

2023 年 5 月 9 日

Cloud Retail のリンク先

Cloud Retail の追加プロパティ

cloud retail の追加プロパティ フィールドを追加します。これは、Cloud Retail のリンク先を使用するお客様が使用する繰り返しフィールドです。このフィールドは、クラウド リテール プログラムを使用する場合に使用できます。これは、Google Cloud Retail プロダクト モデルの attributes フィールドにマッピングされます。

2023 年 5 月 22 日

プロモーション サービス

Promotions サービスに list メソッドを追加しました。

2023 年 4 月 11 日

配送設定サービス

ローカル フルフィルメント

新しい送料設定を作成する販売者向けに、ローカル配送フルフィルメント オプションを追加しました。ローカル ショップの設定は、新しい storeConfig フィールドで構成できます。これには、ローカル配送に対応している店舗のサービス提供範囲、受付終了時間、店舗コードが含まれます。

4 月 3 日

最適化案サービス

最適化案サービスをリリースしました。このサービスでは、販売者のアカウントのパフォーマンスを改善するための方法が提案され、役立つ推奨事項に対する販売者のクリックを報告できます。

2023 年 2 月 20 日

アカウント サービス

アカウント リソース

Accounts リソースに新しいセクション Account.ConversionSettings を追加しました。

ConversionSources サービス

コンバージョンの発生元サービスが追加されました。このサービスは、コンバージョンの発生元（Merchant Center の [コンバージョン設定] セクションの一部）の管理をサポートします。

2023 年 2 月 16 日

配送設定サービス

店舗コードの検証

配送設定が更新される前に、店舗コードが販売者に属していることが確認されるようになりました。

ローカル在庫広告の販売者の確認

販売者 ID が登録されているプログラムが、送料設定の更新前に検証されるようになりました。販売者は、次のいずれかのプログラムに参加している必要があります。

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

2023 年 2 月 9 日

プロモーション サービス

プロモーション サービスを 6 つのtargetCountry オプションに拡張し、ローカル contentLanguage をサポートします。

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

2023 年 1 月 12 日

製品サービス

商品リソース

ライフスタイル画像の 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 を追加しました。

オファー ID の国を指定する際に、targetCountry の代わりに feedLabel を使用できるようになりました。オファー ID が online:language:feedLabel:offerId として作成されるようになりました。

feedLabel には、下位互換性を確保するため、既存のフィードに targetCountry 値が自動的に入力されています。

targetCountry を非推奨にしました。

グローバル特典をサポートするため、Content API for Shopping の targetCountry フィールドのサポートは終了しました。代わりに、shipping フィールドを使用して対象国を指定することをおすすめします。

feedLabel で指定した値が targetCountry に自動的に入力されます。

詳しくは、ブログ投稿「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

製品サービス

商品リソース

productLength、productHeight、productWidth、productWeight を追加して、商品のサイズと重量を指定できるようにしました。

2021 年 8 月 9 日

RepricingRule サービス

RepricingRule のタイプ

RepricingRuleType フィールドの新しい列挙値。

TYPE_SALES_VOLUME_BASED と TYPE_COMPETITIVE_PRICE を追加しました。

2021 年 5 月 17 日

返品ラベル注文サービス

CreateReturnRequest に新しい product_id フィールドを追加しました。販売者は、返す商品アイテムを識別するために product_id または line_item_id を指定できます。

製品サービス

既存の商品を更新する新しいメソッドを追加しました。商品全体ではなく、更新が必要なフィールドのみを指定して商品を更新できます。

2021 年 5 月 3 日

返品ラベル注文サービス

販売者が管理する返品（MMR）のラベルをアップロードする新しい方法を追加しました。新しい orderreturns.labels.create を使用すると、返品ラベルをアップロードしてお客様と共有できます。

2021 年 4 月 26 日

Shipping Settings API

DeliveryTime に新しい warehouseBasedDeliveryTimes フィールドを追加し、倉庫の場所と選択した運送業者のサービスに基づいて配送サービスのお届け日数の計算をサポートしました。

CarriersCarrier オブジェクトに新しい eddServices フィールドを追加し、配達予定日の計算に適用されるサービスの名前を返すようにしました。

2021 年 4 月 12 日

製品サービス

商品リソース

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

製品サービス

商品リソース

特定の国での広告掲載から商品を除外するための新しい shoppingAdsExcludedCountries フィールド。

Productstatuses リソース

destinationStatuses オブジェクトに、targetCountry 以外の特典ステータス情報を提供する新しい approvedCountries、pendingCountries、disapprovedCountries フィールド。

新しい itemLevelIssues.applicableCountries フィールド。

2020 年 8 月 10 日

アカウント サービス

CSS Center の Merchant Center アカウントラベルを管理するための新しい AccountLabel リソースを追加しました。CSS Center ユーザーは、accounts.list、accounts.get、accounts.updatelabels メソッドを使用して Merchant Center アカウントを一覧表示し、ラベルを割り当てることができるようになりました。詳細については、CSS ラベルの管理をご覧ください。

2020 年 6 月 19 日

製品サービス

商品リソース

新しいフィールド

新しい 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 日

Local inventory API

ローカル在庫データを送信するための新しいサービスを追加しました。

2020 年 3 月 2 日

Pubsub notification settings 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 メソッドがサポートされなくなりました。

  • アカウント
  • Accounttax
  • データフィード
  • Liasettings
  • Shippingsettings

HTTP BATCH メソッドの削除

すべての HTTP BATCH メソッドが v2.1 から削除されました。代わりに customBatch を使用してください。 影響を受けるサービスは次のとおりです。

  • アカウント
  • Accountstatuses
  • データフィード
  • データフィードのステータス
  • Liasettings
  • Orderreports
  • 順位
  • 商品
  • Productstatuses
  • 配送設定

アカウント サービス

更新

リクエストの businessInformation フィールドと googleMyBusinessLink フィールドは、Content API v2 の最初のリリース後に導入されました。そのため、これらの 2 つのフィールドに情報が指定されていない場合、販売者が update を使用してこれらのフィールドの情報を誤って削除しないように、安全保護対策が設けられています。

v2 の場合、販売者はこれらのフィールドに空の本文（{}）を明示的に指定して削除する必要があります。v2.1 では、空の本文を指定した場合、または本文を指定しなかった場合、フィールドは削除されます。

アカウント リソース

AdWords から Google 広告へのリブランディング

AdWords が Google 広告に変更されたことに伴い、AdWords 関連の以下のフィールドの名前が変更されました。

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
非推奨のフィールドと値の削除

サポートが終了したフィールド reviewsUrl は削除されました。また、adsLinks、googleMyBusinessLink、youtubeChannelLinks のリンク ステータス inactive が削除されました。

Accountstatuses サービス

AccountStatus リソース

dataQualityIssues の削除

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

Datafeed Service

データフィード リソース

非推奨のフィールドの削除

フィールド 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 の最上位フィールドになりました。

さらに、Order と TestOrder の両方で customer.explicitMarketingPreference が削除され、customer.marketingRightsInfo に置き換えられました。

非推奨のフィールド customer.email が削除されました。

Order リソースの promotions フィールドの形式が変更されました。

注文支払いサービス

このサービスは v2.1 から削除されました。

製品サービス

insert からのレスポンスには、次の属性のみが含まれます。

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

挿入された商品を get または list で取得できるようになるまでに数分かかるようになりました。

返される商品情報 ID が、入力された商品情報 ID と同じであるとは限りません。

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

商品リソース

CustomGroups を再帰型の customAttributes に置き換え

以前は、v2 で同じカスタム グループにカスタム属性を追加することで、カスタム属性をグループ化できました。v2.1 ではカスタム属性が再帰的になったため、カスタム グループは不要になりました。

カスタム属性には、元の value フィールドに加えて、追加の groupValues フィールドが追加されました。これらのフィールドは 1 つだけ設定する必要があります。つまり、同時に設定したり、どちらも設定しなかったりすることはできません。

販売者は v2 と v2.1 を切り替えることができるため、カスタム グループには最大 2 つのレベルがあるため、v2 では表現できない再帰カスタム属性を商品に含めることができます。この場合、カスタム属性グループは切り捨てられます。

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 に置き換わりました。