2024 年 4 月 11 日
LoyaltyPoints の公開設定を変更しました
2024 年 4 月 10 日
LoyaltyProgram を追加しました
2024 年 4 月 9 日
製品サービス
商品リソース
structuredTitle と structuredDescription を追加し、AI 生成の商品のタイトルと説明を指定できるようにしました。
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 日
レポート サービス
TopicTrendsView レポートを Reports サービスに追加しました。
詳しくは、レポートガイドをご覧ください。
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 日
配送設定サービス
shipment_type=pickup のサポートは終了しました。
2023 年 10 月 18 日
アカウント サービス
Business Identity フィールドを追加しました。これにより、販売者が特定の消費者の値で自己識別できるようになりました。
2023 年 10 月 10 日
配送設定サービスの新しい配送タイプとして Collection Point を追加しました。集荷所への配送は、第三者（販売者以外など）が提供するサービスで、自宅に直接配送するのではなく、サードパーティの関係会社（UPS Access Points など）に商品を配送します。
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 メソッドを追加しました。
推奨事項サービス
おすすめサービスの ReportInteraction メソッドで、インタラクションの消去を有効にします。
2023 年 5 月 9 日
Cloud 小売の宛先
Cloud Retail の追加プロパティ
Cloud Retail の追加プロパティ フィールドを追加します。これは、Cloud Retail の宛先を使用するお客様が使用する繰り返しフィールドです。このフィールドを使用すると、Cloud Retail プログラムを使用するときに使用できるようになります。これは、Google Cloud Retail 商品モデルの属性フィールドにマッピングされます。
2023 年 5 月 22 日
プロモーション サービス
Promotions サービスに list メソッドを追加しました。
2023 年 4 月 11 日
配送設定サービス
ローカル フルフィルメント
販売者が新しい配送設定を作成するため、ローカル配送のフルフィルメント オプションを追加しました。ローカル店舗の設定は、新しい storeConfig フィールドで構成できます。これには、ローカル配送を提供している店舗のサービス提供範囲、受付終了時間、店舗コードが含まれます。
4 月 3 日
おすすめサービス
レコメンデーション サービスをリリースしました。このサービスは、販売アカウントのパフォーマンスを改善するための推奨方法を提供し、有用な推奨事項に対する販売者のクリックをレポートできるようにします。
2023 年 2 月 20 日
アカウント サービス
アカウント リソース
新しいセクション Account.ConversionSettings を Accounts リソースに追加しました。
ConversionSources サービス
コンバージョンの発生元の管理をサポートするコンバージョンの発生元サービス（Merchant Center のコンバージョン設定セクションの一部）を追加しました。
2023 年 2 月 16 日
配送設定サービス
店舗コードの検証
配送設定を更新する前に、店舗コードが販売者に属していることが検証されるようになりました。
ローカル在庫広告の販売者確認
販売者 ID が登録されているプログラムは、配送設定が更新される前に検証されるようになりました。販売者は次のいずれかのプログラムに参加している必要があります。
LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLELOCAL_INVENTORY_ADS
2023 年 2 月 9 日
プロモーション サービス
プロモーション サービスが、contentLanguage ローカル サポートを含む 6 つの targetCountry オプションに拡張されました。
BRESNLJPITKR
2023 年 1 月 12 日
製品サービス
商品リソース
商品使用イメージ画像の URL を提供する lifestyleImageLinks を追加しました。
2022 年 11 月 24 日
プロモーション サービス
Promotions.PromotionStatus セクションに、新しいフィールド「promotionStatus」を追加しました。これは読み取り専用のフィールドです。
2022 年 11 月 15 日
レポート サービス
マーケット インサイト レポートをレポート サービスに追加しました。
Reports サービスで次のクエリを実行できるようになりました。
BestSellersProductClusterViewテーブルとBestSellersBrandViewテーブルを使用したベストセラー レポート。PriceCompetitivenessProductViewテーブルを使用した価格競争力レポート。PriceInsightsProductViewテーブルを使用した価格分析レポート。
詳しくは、レポートガイドをご覧ください。
2022 年 11 月 7 日
Datafeeds サービス
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 フィールドを使用して対象国を指定することをおすすめします。
feedLabel で指定した値が targetCountry に自動的に入力されるようになりました。
詳しくは、Content API for Shopping における対象国のフィードラベルの置き換えに関するブログ投稿をご覧ください。
2021 年 12 月 8 日
アカウント サービス
アカウント リソース
アカウント リソースに新しいセクション Account.AutomaticImprovements を追加しました。
この新しいセクションでは、商品アイテムの自動更新、画像と配送設定の改善を行うことができます。
2021 年 10 月 25 日
プロモーション サービス
Promotion API に Get Promotion を追加。
2021 年 10 月 11 日
送料設定 API
販売者が WarehouseBasedDeliveryTime で使用できる倉庫を管理できるように、ShippingSettings リソースに新しい warehouse フィールドを追加しました。
ウェアハウス名で warehouse を参照するように、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 サービス
料金変更ルールのタイプ
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 日
送料設定 API
DeliveryTime に新しい warehouseBasedDeliveryTimes フィールドを追加しました。これにより、倉庫の所在地と選択された運送サービスに基づいて配送予定日を計算できます。
CarriersCarrier オブジェクトの新しい eddServices フィールドによって、配送予定日の計算に適用されるサービスの名前が返されます。
2021 年 4 月 12 日
製品サービス
商品リソース
商品ごとに最大 2 つのサイズタイプをサポートする新しい additionalSizeType フィールド。
送料フィールドの変更: minHandlingTime、maxHandlingTime、minTransitTime、maxTransitTime を ProductShipping に追加し、商品レベルの配送予定を指定できるようにしました。
2021 年 1 月 28 日
アカウント サービス
AccountLabel リソースと Account リソースに自動ラベルのサポートを追加しました。詳しくは、CSS ラベル管理ガイドの CSS ラベルのタイプをご覧ください。
2020 年 10 月 5 日
CSSES サービス
CSS リソース
CSS ドメインに関する情報を取得してラベルを割り当てるための新しい csses サービスを追加しました。これで、AccountLabel リソースは、CSS グループレベルのラベルの作成と一覧表示にも使用できるようになりました。詳しくは、CSS ラベル管理をご覧ください。
2020 年 8 月 24 日
製品サービス
プロダクト リソース
新しい shoppingAdsExcludedCountries フィールドを使用して、特定の国での広告からオファーを除外できます。
Productstatuses リソース
destinationStatuses オブジェクトの新しい approvedCountries、pendingCountries、disapprovedCountries フィールド。targetCountry 以外のオファー ステータス情報を提供します。
新しい itemLevelIssues.applicableCountries フィールド。
2020 年 8 月 10 日
アカウント サービス
CSS Center の Merchant Center アカウント ラベルを管理するための新しい AccountLabel リソースを追加しました。CSS Center のユーザーは、Merchant Center アカウントを一覧表示し、accounts.list、accounts.get、accounts.updatelabels メソッドを使用してラベルを割り当てることもできるようになりました。詳しくは、CSS ラベルの管理をご覧ください。
2020 年 6 月 19 日
製品サービス
商品リソース
新しいフィールド
新しい productDetails、productHighlights、subscriptionCost、canonicalLink フィールド。
2020 年 6 月 2 日
注文サービス
返品なしで払い戻しを開始する新しいメソッドを追加しました。新しい orders.refunditem と orders.refundorder を使用すると、顧客から返品されなかった注文であっても払い戻しを開始できます。
2020 年 4 月 27 日
Orderreturns サービス
新しいメソッド acknowledge と process、読み取りメソッドの新しいフィルタとフィールド（list、get）を追加しました。
GMB のリンク設定
GMB アカウント ID を使用して、Merchant Center アカウントを GMB アカウントにリンクできるようになりました。
2020 年 4 月 14 日
Settlement Report API
決済レポートを取得するための新しいサービスを追加しました。
2020 年 3 月 9 日
Local Inventory API
ローカル在庫データを送信するための新しいサービスを追加しました。
2020 年 3 月 2 日
Pub/Sub 通知設定 API
pubsub 通知の設定を管理するための新しいサービスを追加しました。
2019 年 12 月 3 日
製品サービス
マルチクライアント アカウントの Content API 補助フィードのサポートを追加しました。
2019 年 9 月 11 日
注文サービス
注文の店舗受け取りと、対応するサンドボックス機能のサポートを追加しました。
2019 年 8 月 14 日
新しいサービス
「Google で購入」向けの新しい返品に関するポリシーと返品先住所のサービスを追加しました。
注文サービス
リソースを注文
新しいフィールド
新しい quantityUndeliverable フィールド。
2019 年 8 月 7 日
注文サービス
リソースを注文
新しいフィールド
Order リソースに新しい loyaltyInfo フィールドと invoiceReceivingEmail フィールドを追加しました。
2019 7 月 1 日
製品サービス
Products サービスに追加された Content API 補助フィードのサポート。
2019 年 6 月 11 日
注文サービス
注文と TestOrder のリソース
価格調整の追加
新しい lineItem[].adjustments フィールドを追加しました。これには、プロモーションの適用によって生じる元の広告申込情報の価格と税金に対する調整が含まれます。
2019 年 2 月 14 日
このバージョンでの変更点
ドライランのサポートは終了しました
パラメータ dryRun は v2.1 から削除されました。これは、すべての API 呼び出しに適用されます。
パッチメソッドのサポート終了
次のサービスは patch メソッドのサポートを終了しました。
- アカウント
- Accounttax
- データフィード
- リア設定
- 送料設定
HTTP BATCH メソッドの削除
すべての HTTP BATCH メソッドが v2.1 から削除されました。代わりに customBatch を使用してください。影響を受けるサービスは次のとおりです。
- アカウント
- アカウントのステータス
- データフィード
- データフィードのステータス
- リア設定
- 注文レポート
- 順位
- プロダクト
- 商品のステータス
- 送料設定
アカウント サービス
更新
リクエストの businessInformation フィールドと googleMyBusinessLink フィールドは、Content API v2 の初回リリース後に導入されました。このため、update を使用してこれら 2 つのフィールドの情報が提供されない場合、販売者が誤ってその情報を削除しないようにするための安全措置があります。
v2 でこれらのフィールドを削除するには、販売者がこれらのフィールドを明示的に空の本文（{}）で指定する必要があります。v2.1 では、空の本文を指定した場合、または指定しなかった場合、フィールドは削除されます。
アカウント リソース
AdWords から Google 広告のリブランディング
AdWords から Google 広告への名称変更に伴い、次の AdWords 関連フィールドの名前が変更されました。
adwordsLinks->adsLinksadwordsLinks.adwordsId->adsLinks.adsId
サポートが終了したフィールドと値の削除
非推奨のフィールド reviewsUrl が削除されました。さらに、adsLinks、googleMyBusinessLink、youtubeChannelLinks のリンク ステータス inactive が削除されました。
Accountstatuses サービス
AccountStatus リソース
dataQualityIssues の削除
これらは itemLevelIssues に置き換わりました。
Datafeed サービス
データフィード リソース
非推奨フィールドの削除
フィールド contentLanguage、targetCountry、intendedDestinations が削除され、targets で country、language、includedDestinations、excludedDestinations に置き換えられました。
商品在庫（更新）の削除
product inventory update タイプのフィードは削除されました。
在庫サービス
v2.1 では、v2 inventory サービスが削除され、次の 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 に移動しました。
注文と TestOrder のリソース
新しいプロモーションのフォーマット
v2.1 には新しいプロモーション形式が導入されています。プロモーションを使用してテスト注文を作成することはできません。
非推奨フィールドの削除
フィールド paymentMethod が削除され、billingAddress と predefinedBillingAddress がそれぞれ Order と TestOrder の最上位フィールドになりました。
さらに、Order と TestOrder の両方で、customer.explicitMarketingPreference が削除され、customer.marketingRightsInfo に置き換えられました。
非推奨のフィールド customer.email が削除されました。
Order リソースの promotions フィールドの形式が変更されました。
Orderpayments サービス
このサービスは v2.1 から削除されました。
製品サービス
insert からのレスポンスには、次の属性のみが含まれます。
channelcontentLanguageidofferIdtargetCountry
致命的でない警告とエラーはレスポンスで返さなくなりました。これにより、フィードのルールなどの高度なフィード管理機能との統合を強化できます。
挿入された商品を 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 に置き換えられました。
掲載先属性が includeDestinations と excludeDestinations に置き換えられる
デスティネーションは、v2 の繰り返しフィールド destinations に、デスティネーション名とインテントのペアのリストとして入力されていました。このフィールドは、includedDestinations と excludedDestinations の 2 つの繰り返しフィールドに置き換えられました。デフォルトで有効になっている掲載先を includedDestinations. に含める必要はありません。これは、フィードの掲載先のオーバーライドの設定と一致します。
AdWords 関連フィールドの名称変更
AdWords から Google 広告への名称変更に伴い、次の AdWords 関連フィールドの名前が変更されました。
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
非推奨フィールドの削除
以下の非推奨のフィールドが削除されました。
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
Productstatuses サービス
get と list
product 属性は、includeAttributes パラメータとともに削除されました。ステータスに対応する商品の属性を取得するには、Products サービスと新しい productId フィールドの値を使用します。
List
パラメータ includeInvalidInsertedItems が削除されました。商品が有効かどうかにかかわらず、すべての商品が返されるようになりました。つまり、list は、includeInvalidInsertedItems が常に true に設定されているかのように動作します。
ProductStatus リソース
DestinationsStatuses
destinationStatuses のフィールド intention、approvalStatus、approvalPending が status に置き換えられました。これは、approved、disapproved、pending のいずれかを指定できる文字列です。
dataQualityIssues の削除
これらは itemLevelIssues に置き換わりました。