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

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

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

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

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

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

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

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

Content API for Shopping と Merchant API の比較

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

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

次のリストに、Content API for Shopping と比較した Merchant Shipping settings API の主な更新内容を示します。

1. Merchant API ユーザーは、同じ動作を実現するために、{NAME} フィールドに accounts/{ACCOUNT_ID}/shippingSettings を指定する必要があります。
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	Merchant Shipping settings API	説明
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	締め切り時間のタイムゾーン ID。
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 の次のフィールドは、Merchant API で非推奨になりました。Merchant API には、これらのフィールドの代替手段はありません。

• postal_code_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	Merchant API
customBatch	はい	いいえ
get	○	○
update	○	いいえ
insert	×	○
getSupportedCarrier	○	いいえ
getSupportedHolidays	はい	いいえ