Content API for Shopping から配送設定を移行する

ShippingSettings リソースを使用すると、アカウントとその アカウントに関連付けられているすべての子アカウントの配送設定を取得して更新できます。アカウントの配送設定を追加または管理する方法について詳しくは、配送設定の概要をご覧ください。

Merchant API を使用して配送設定情報を読み取るには、次のリクエストを使用します。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

{ACCOUNT_ID} は、 Merchant Center アカウントの一意の識別子に置き換えます。

Merchant API を使用して配送設定情報を更新するには、次のリクエストを使用します。

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

詳しくは、メソッド: accounts.shippingSettings.insert をご覧ください。

Content API for Shopping と Merchant API の比較

Content API for Shopping と Accounts サブ API の配送設定リソースの比較例を以下に示します。

	Content API	Merchant API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
識別子	{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

Content API for Shopping と比較して、Accounts サブ API の配送設定リソースが大幅に更新された点は次のとおりです。

1. Merchant API ユーザーは、同じ動作にするために、 {NAME} フィールドに accounts/{ACCOUNT_ID}/shippingSettings を入力する必要があります。
2. Merchant API では、地域グループなどのカスタム エリアに対する読み取り / 書き込みオペレーションはサポートされていません。地域グループなどのカスタム エリアは、地域サービスを使用してのみ読み取りまたは書き込みが可能です。
3. Merchant API の 1 つのサービスで、複数の配送国をサポートしています。
4. Merchant API には、Content API の shippingsettings.list メソッドとは異なり、配送設定のリスト メソッドはありません。

新たにサポートされるフィールド

Accounts サブ API の配送設定リソースでは、Content API for Shopping と比較して次の新しいフィールドがサポートされています。

1. warehouses: 在庫を保管して処理するフルフィルメント倉庫に関する情報を提供します。
2. ポイント プログラム: Merchant API ユーザーは、ポイント プログラム情報を配送設定に入力できます。
3. Etag: Etag は、複数のユーザーが Merchant API と Merchant Center UI を使用して同時に配送設定を更新しようとした場合に発生する非同期の問題を解決するために設計されています。

名前が変更されたフィールド

Accounts サブ API の配送設定リソースでは、次のフィールドの名前が変更されました。

Content API for Shopping	配送設定リソース	説明
service	services	1 つの配送サービス。
service.name	services.serviceName	Merchant Center アカウント内で一意である必要がある、サービスの自由形式の名前。
service.deliveryCountry	services.deliveryCountries	配送サービスが適用される国の CLDR 地域コード。
service.currency	services.currencyCode	このサービスが適用される通貨の CLDR コード。
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	注文のお届けにかかる最短の営業日数。たとえば、0 は当日配達、1 は翌日配達を意味します。
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	注文のお届けにかかる最長の営業日数。
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	注文が発送されるまでの最短の営業日数。
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	注文が発送されるまでの最長の営業日数。
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	受付終了時間のタイムゾーン識別子。
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	郵便番号グループの名前。
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	商品の配送日数ラベル。
service.rate_group	services.rateGroups	送料レート グループの定義。
service.rate_group.subtable	services.rateGroups.subtables	サブテーブルのリスト。
service.rate_group.carrier_rate	services.rateGroups.carrierRates	運送業者料金のリスト。
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	同じ最低注文値を共有する店舗コードセットのリスト。

削除されたメソッド

shippingsettings.custombatch を使用して、1 つのリクエストで複数のアカウントの配送設定を取得して 更新することはできません。

削除されたフィールド

Content API for Shopping の次のフィールドは、Merchant API では削除されています。Merchant API には、これらのフィールドの代替手段はありません。

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Rate_group
  • single_value_alternative_list

メソッド

Content API for Shopping と配送設定リソースのメソッドの比較を以下に示します。

メソッド	Content API for Shopping	Merchant API
customBatch	はい	×
get	○	○
update	○	いいえ
insert	いいえ	○
list	○	×
getSupportedCarrier	はい	×
getSupportedHolidays	はい	いいえ