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 日
ProductIssue
と AccountIssue
に prerendered_out_of_court_dispute_settlement
フィールドを追加しました。
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 で購入」サービス
Buy on 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
メソッドを追加しました。このメソッドにアクセスするには、こちらのフォームにリクエストを送信してください。
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
フィールドを追加しました。これにより、ユーザーは Google ビジネス プロフィールの店舗と POS 店舗のマッチング ステータスを確認し、問題が発生した場合は解決のヒントを得ることができます。
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 日
プロモーション サービス
プロモーション サービスを 6 つの追加の targetCountry
オプションに拡大し、ローカル contentLanguage
サポートを提供します。
BR
ES
NL
JP
IT
KR
2023 年 1 月 12 日
製品サービス
Product Resource
使用イメージ画像の 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 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 関連の以下のフィールドの名前が変更されました。
adwordsLinks
->adsLinks
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
のトップレベル フィールドになりました。
さらに、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 関連のフィールド名の変更
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
に置き換えられました。