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 ユーザーは、同じ動作を実現するために accounts/{ACCOUNT_ID}/shippingSettings を {NAME} フィールドに入力する必要があります。
  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 締め切り時間のタイムゾーン 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 つのリクエストで複数のアカウントの配送設定を取得して更新することはできません。

削除されたフィールド

Merchant API では、Content API for Shopping の次のフィールドが削除されます。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 ○ いいえ
前へ
Migrate data sources management
次へ
Migrate conversion sources management