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 の Shipping 設定リソースの比較例を次に示します。

	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 の Shipping settings リソースの主な更新内容を示しています。

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 の Shipping settings リソースで、次のフィールドの名前が変更されました。

Content API for Shopping	ShippingSettings リソース	説明
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 のメソッドと Shipping settings リソースの比較は次のとおりです。

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