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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

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

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

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

Content API for Shopping と Merchant API の比較

Content API for Shopping と Merchant Shipping settings API の比較の例を次に示します。

	Content API	販売者 API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
識別子	{accountId}/shippingsettings/{accountId}	{name}

Content API for Shopping と比較した Merchant Shipping settings API の主な更新内容は次のとおりです。

1. Merchant API を使用している場合は、同じ動作にするために accounts/{accountId}/shippingSettings を {name} フィールドに入力する必要があります。
2. Merchant API では、地域グループなどのカスタム領域に対する読み取り / 書き込みオペレーションはサポートされていません。地域グループなどのカスタムエリアの読み取りと書き込みは、地域サービスを使用した場合にのみ行えます。
3. Merchant API と Content API for Shopping では、WarehouseBasedDeliveryTime の設定方法が異なります。Merchant API を使用している場合は、shippingsettings.warehouses で倉庫情報を定義する必要があります。これにより、各配送サービスは warehouseBaseDeliveryTime の倉庫名を使用して倉庫を参照できるようになります。
4. Merchant API の 1 つのサービスで複数の配送国に対応。

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

Merchant Shipping Settings API では、Content API for Shopping と比較して、次の新しいフィールドがサポートされています。

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

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

Merchant API では、以下のフィールドの名前が変更されました。

Content API for Shopping	販売者の配送設定 API	説明
service	services	単一の配送サービス。
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 回のリクエストで複数のアカウントの配送設定を取得および更新することはできません。

非推奨のフィールド

Merchant API では、以下のフィールドのサポートが終了しました。Merchant API では、これらのフィールドに対応する代替手段は用意されていません。

Content API for Shopping	販売者 API
postal_code_group	region
service Pickup_service Eligibility Scheduling_channel Delivery_time Holiday_cutoff Min_scheduling_time_in_days Max_scheduling_time_in_days Scheduling_business_day_config Rate_group |service: Pickup_service - Eligibility - Scheduling_channel - Delivery_time - Holiday_cutoff - Min_scheduling_time_in_days - Max_scheduling_time_in_days - Scheduling_business_day_config - Rate_group - single_value_alternative_list メソッド Content API for Shopping と Merchant Shipping settings API のメソッドの比較を以下に示します。 メソッド Content API for Shopping 販売者 API customBatch ○ × get ○ ○ update ○ × 挿入 × ○ getSupportedCarrier ○ × getSupportedHolidays ○ ×