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 の主な更新内容を示します。
- Merchant API ユーザーは、同じ動作を実現するために、{NAME} フィールドに
accounts/{ACCOUNT_ID}/shippingSettings
を指定する必要があります。 - Merchant API は、位置情報グループなどのカスタム領域に対する読み取り / 書き込みオペレーションをサポートしていません。地域グループなどのカスタム領域は、リージョン サービスを使用してのみ読み取りまたは書き込みを行うことができます。
- Merchant API と Content API for Shopping では、
WarehouseBasedDeliveryTime
の設定方法が異なります。Merchant API を使用している場合は、shippingsettings.warehouses
で倉庫情報を定義する必要があります。各配送サービスは、warehouseBaseDeliveryTime
の倉庫名を使用して倉庫を参照できます。 - Merchant API の 1 つのサービスは、複数の配送国をサポートしています。
サポートされる新しいフィールド
Merchant Shipping settings API は、Content API for Shopping と比較して、次の新しいフィールドをサポートしています。
- 倉庫: 在庫の保管と処理を行うフルフィルメント ウェアハウスに関する情報を提供します。
- ポイント プログラム: Merchant API ユーザーは、送料設定にポイント プログラム情報を入力できます。
- 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 |
はい | いいえ |