- リソース: ShippingSettings
- サービス
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Weekday
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Table
- ヘッダー
- 重量
- WeightUnit
- LocationIdSet
- 行
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- 距離
- 単位
- LoyaltyProgram
- LoyaltyProgramTiers
- ウェアハウス
- 住所
- WarehouseCutoffTime
- メソッド
リソース: ShippingSettings
販売者のアカウントの配送設定。
JSON 表現 |
---|
{ "name": string, "services": [ { object ( |
フィールド | |
---|---|
name |
ID。配送設定のリソース名。形式: |
services[] |
省略可。ターゲット アカウントのサービス リスト。 |
warehouses[] |
省略可。 |
etag |
必須。このフィールドは、非同期の問題を回避するために使用されます。get 呼び出しと insert 呼び出しの間で配送設定データが変更されていないことを確認します。お客様は次の手順を行う必要があります。
|
サービス
配送サービス。
JSON 表現 |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
フィールド | |
---|---|
delivery |
必須。サービスが適用される国の CLDR 地域コード。 |
rate |
省略可。送料グループの定義。空の |
loyalty |
省略可。この配送サービスが利用できるポイント プログラム。 |
service |
必須。サービスの自由形式の名前。ターゲット アカウント内で一意にする必要があります。 |
active |
必須。配送サービスのアクティブなステータスを公開するブール値。 |
currency |
このサービスが適用される通貨の CLDR コード。料金グループの料金と一致している必要があります。 |
delivery |
必須。注文から商品の配送までのさまざまな段階で費やされる時間。 |
shipment |
このサービスが注文を配送する場所のタイプ。 |
minimum |
このサービスの最低注文額。設定した場合、ユーザーは少なくともこの金額の購入が必要になります。1 つのサービス内のすべての価格は同じ通貨にする必要があります。minimumOrderValueTable と併用できません。 |
minimum |
集荷フルフィルメント タイプのストアごとの最小注文額の表。minimumOrderValue と同時に設定することはできません。 |
store |
商品の発送元となる店舗のリスト。これは、ローカル配送の配送タイプでのみ有効です。 |
DeliveryTime
注文から商品の配送までのさまざまな段階で費やされる時間。
JSON 表現 |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
フィールド | |
---|---|
warehouse |
省略可。選択した運送業者の設定に基づいて、倉庫(発送元)ごとにお届け日数を計算する必要があることを示します。設定する場合は、[delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] の他のお届け日数関連フィールドは設定しないでください。 |
min |
配送にかかる最短の営業日数。0 は当日配達、1 は翌日配達を意味します。 |
max |
配送にかかる最長の営業日数。0 は当日配達、1 は翌日配達を意味します。 |
cutoff |
営業日の締め切り時間の定義。設定しない場合、デフォルトの締め切り時間は午前 8 時(太平洋標準時)になります。 |
min |
注文が発送されるまでにかかる最小の営業日数。0 は当日発送、1 は翌日発送を意味します。「minHandlingDays」と「maxHandlingDays」は、同時に設定するか、どちらも設定しない必要があります。 |
max |
注文が発送されるまでの最長営業日数。0 は当日発送、1 は翌日発送を意味します。 |
transit |
お届け日数表: 行と列のディメンションに基づくお届けまでの営業日数。 |
handling |
注文を処理できる営業日。指定しない場合は、月曜日から金曜日の営業日とみなされます。 |
transit |
注文が配送される営業日数。指定しない場合は、月曜日から金曜日の営業日とみなされます。 |
CutoffTime
営業日の締め切り時間の定義。
JSON 表現 |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
フィールド | |
---|---|
hour |
必須。同日に処理されるように注文を完了する必要がある締め切り時間の午後時間。 |
minute |
必須。同日に処理されるように注文を完了する必要がある締め切り時間の分単位。 |
time |
必須。タイムゾーン ID。たとえば「Europe/Zurich」など。 |
TransitTable
お届け日数表: 行と列のディメンションに基づくお届けまでの営業日数。minTransitDays
、maxTransitDays
、transitTimeTable
のいずれかを設定できますが、両方は設定できません。
JSON 表現 |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
フィールド | |
---|---|
postal |
必須。リージョン名のリスト |
transit |
必須。お届け日数ラベルのリスト。最後の値は |
rows[] |
必須。 |
TransitTimeRow
postalCodeGroupNames
または transitTimeLabels
のディメンション セットが 1 つしかない場合、そのディメンションの値が 1 つの行に複数存在します。ディメンションが 2 つある場合、各行は postalCodeGroupNames
に対応し、列(値)は transitTimeLabels
に対応します。
JSON 表現 |
---|
{
"values": [
{
object ( |
フィールド | |
---|---|
values[] |
必須。お届け日数の範囲(最小 - 最大)(営業日数)。 |
TransitTimeValue
お届け日数の範囲(最小 - 最大)(営業日数)。
JSON 表現 |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
フィールド | |
---|---|
min |
最短の配送日数(営業日数)。0 は当日配達、1 は翌日配達を意味します。 |
max |
|
BusinessDayConfig
倉庫の営業日。
JSON 表現 |
---|
{
"businessDays": [
enum ( |
フィールド | |
---|---|
business |
必須。通常の営業日。空白にすることはできません。 |
平日
列挙型 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
選択した運送業者の設定に基づいて、倉庫(発送元)ごとにお届け日数を計算する必要があることを示します。設定する場合は、deliveryTime
の他の配送時間関連フィールドは設定しないでください。
JSON 表現 |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
フィールド | |
---|---|
carrier |
必須。携帯通信会社( |
carrier |
必須。携帯通信会社サービス( |
warehouse |
必須。ウェアハウス名。これは [warehouse][ShippingSetting.warehouses.name] と一致する必要があります。 |
RateGroup
送料グループの定義。空の applicableShippingLabels
を指定できるのは最後のみです。これは「その他すべて」を意味します。他の applicableShippingLabels
は重ならないようにしてください。
JSON 表現 |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
フィールド | |
---|---|
applicable |
必須。この料金グループが適用される商品を定義する送料ラベルのリスト。これは排他的論理演算です。料金グループを適用するには、ラベルのいずれか 1 つが一致している必要があります。空にできるのは、サービスの最後の料金グループの場合のみです。 |
subtables[] |
省略可。 |
carrier |
省略可。 |
single |
料金グループの値(例: 定額料金 10 米ドル)。 |
main |
|
name |
省略可。レートグループの名前。設定する場合は、配送サービス内で一意にする必要があります。 |
値
料金グループの単一の値、または料金グループ テーブルのセルの値。noShipping
、flatRate
、pricePercentage
、carrier_rateName
、subtable_name
のいずれか 1 つを設定する必要があります。
JSON 表現 |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
フィールド | |
---|---|
no |
true の場合、商品は配送できません。設定時に true にする必要があります。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
flat |
定額料金。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
price |
小数表記の数値で表される料金の割合(例: |
carrier |
同じレートグループで定義された運送業者レートを参照する運送業者レートの名前。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
subtable |
サブテーブルの名前。テーブルのセルにのみ設定できます(単一値には設定できません)。また、他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
表
singleValue
では十分に表現できない場合に、レートグループを定義するテーブル。
JSON 表現 |
---|
{ "rows": [ { object ( |
フィールド | |
---|---|
rows[] |
必須。テーブルを構成する行のリスト。 |
name |
テーブルの名前。サブテーブルでは必須ですが、メインテーブルでは無視されます。 |
row |
必須。テーブルの行のヘッダー。 |
column |
テーブルの列のヘッダー。省略可: 設定しない場合、テーブルにはディメンションが 1 つだけになります。 |
ヘッダー
テーブルの行または列のヘッダーの空ではないリスト。prices
、weights
、num_items
、postalCodeGroupNames
、location
のいずれか 1 つを設定する必要があります。
JSON 表現 |
---|
{ "prices": [ { object ( |
フィールド | |
---|---|
prices[] |
必須。注文価格の上限(税込み)のリスト。price amountMicros を -1 に設定すると、最終価格の値を無限大にすることができます。たとえば、 |
weights[] |
必須。注文重量の上限(含む)のリスト。price amountMicros を -1 に設定すると、最後の重みの値を無限にすることができます。たとえば、 |
number |
必須。項目数の上限(上限を含む)のリスト。最後の値は |
postal |
必須。郵便グループ名のリスト。最後の値は |
locations[] |
必須。位置情報 ID セットのリスト。空でないこと。他のすべてのフィールドが設定されていない場合にのみ設定できます。 |
重量
重量を文字列の値と単位で表します。
JSON 表現 |
---|
{
"unit": enum ( |
フィールド | |
---|---|
unit |
必須。重量の単位。有効な値は kg と lb です。 |
amount |
必須。重量(マイクロ単位の数値)。100 万マイクロが通貨の標準単位に相当します(例: 1 kg = 1000000 マイクロ)。このフィールドは、-1 に設定することで無限に設定することもできます。このフィールドは -1 と正の値のみをサポートします。 |
WeightUnit
重量の単位。
列挙型 | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
単位未指定 |
POUND |
lb 単位。 |
KILOGRAM |
kg 単位。 |
LocationIdSet
位置情報 ID セットのリスト。空でないこと。他のすべてのフィールドが設定されていない場合にのみ設定できます。
JSON 表現 |
---|
{ "locationIds": [ string ] } |
フィールド | |
---|---|
location |
必須。地域 ID の空でないリスト。すべて同じ場所のタイプ(都道府県など)にする必要があります。 |
行
セルのリストを指定します。
JSON 表現 |
---|
{
"cells": [
{
object ( |
フィールド | |
---|---|
cells[] |
必須。行を構成するセルのリスト。2 次元テーブルの場合は |
CarrierRate
mainTable
または singleValue
で参照できる携帯通信会社の料金のリスト。サポートされている運送業者は、https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only で定義されています。
JSON 表現 |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
フィールド | |
---|---|
name |
必須。運送業者の運賃の名前。レートグループごとに一意である必要があります。 |
carrier |
必須。携帯通信会社サービス( |
carrier |
必須。携帯通信会社サービス( |
origin |
必須。この運送業者の運賃の出発地。 |
percentage |
省略可。小数表記の数値として、配送料の乗数修飾子。負の値を指定できます。たとえば、 |
flat |
省略可。加算型の送料調整比。負の値を指定できます。たとえば、 |
ShipmentType
配送サービスの配送タイプ。
列挙型 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
このサービスでは配送タイプが指定されていません。 |
DELIVERY |
このサービスでは、お客様が指定した住所宛てに注文商品を発送します。 |
LOCAL_DELIVERY |
このサービスでは、お客様が指定した住所宛てに注文商品を発送します。注文した商品が近くの店舗から発送される。 |
COLLECTION_POINT |
このサービスでは、お客様が指定した住所宛てに注文商品を発送します。注文が集荷所から発送される。 |
MinimumOrderValueTable
集荷フルフィルメント タイプのストアごとの最小注文額の表。
JSON 表現 |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
フィールド | |
---|---|
store |
必須。同じ最低注文額(MOV)を共有するストアコードセットのリスト。少なくとも 2 つのセットが必要です。最後のセットは空にする必要があります。これは「他のすべてのストアに対して MOV」を意味します。各ストアコードは、すべてのセットで 1 回だけ使用できます。1 つのサービス内のすべての価格は同じ通貨にする必要があります。 |
StoreCodeSetWithMov
同じ最低注文額を共有するストアコードセットのリスト。少なくとも 2 つのセットが必要です。最後のセットは空にする必要があります。これは「他のすべてのストアに対して MOV」を意味します。各ストアコードは、すべてのセットで 1 回だけ使用できます。1 つのサービス内のすべての価格は同じ通貨にする必要があります。
JSON 表現 |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
フィールド | |
---|---|
store |
省略可。一意の店舗コードのリスト。カテゴリ全体を指定する場合は空白にします。 |
value |
指定された店舗の最低注文額。 |
StoreConfig
商品の発送元となる店舗のリスト。これは、ローカル配送の配送タイプでのみ有効です。
JSON 表現 |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
フィールド | |
---|---|
store |
省略可。地域配送を提供している店舗コードのリスト。空の場合は、 |
store |
この販売者が掲載しているすべての店舗、または一部の店舗で、地域内配送を提供しているかどうかを示します。 |
cutoff |
当日配達に関連する設定が終了します。 |
service |
配達可能な範囲(半径)。これは、ローカル配送の配送タイプでのみ必須です。 |
StoreServiceType
販売者が登録したすべての店舗、または一部の店舗で、地域内配達を提供しているかどうかを示します。
列挙型 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
店舗サービスタイプが指定されていません。 |
ALL_STORES |
この販売者が掲載しているすべての店舗(現在および今後)で、地域への配送を提供しているかどうかを示します。 |
SELECTED_STORES |
storeCodes にリストされている店舗のみがローカル配送の対象であることを示します。 |
CutoffConfig
当日配達に関連する設定が終了します。
JSON 表現 |
---|
{
"localCutoffTime": {
object ( |
フィールド | |
---|---|
local |
当日ローカル配達が終了する時間。 |
store |
ローカル配送のフルフィルメントでのみ有効です。閉店時間までの時間数で指定します。 |
no |
販売者は、n 日以内の配達に設定されている配送サービスを利用している場合、n+1 日以内の配達を表示しないようにオプトアウトできます。たとえば、配送サービスで当日配達が定義されていて、締め切りを過ぎている場合、このフィールドを |
LocalCutoffTime
当日ローカル配達が終了する時間。
JSON 表現 |
---|
{ "hour": string, "minute": string } |
フィールド | |
---|---|
hour |
当日配達の注文は、当日処理するために、この時間までに注文する必要があります。 |
minute |
当日配達の注文は、同日に処理されるように、午後 3 時までに注文する必要があります。 |
距離
配達可能な範囲(半径)。これは、ローカル配送の配送タイプでのみ必須です。
JSON 表現 |
---|
{
"value": string,
"unit": enum ( |
フィールド | |
---|---|
value |
距離の整数値。 |
unit |
単位は国によって異なる場合があります。マイルとキロメートルが含まれるようにパラメータ化されています。 |
ユニット
単位は国によって異なる場合があります。マイルとキロメートルが含まれるようにパラメータ化されています。
列挙型 | |
---|---|
UNIT_UNSPECIFIED |
単位が指定されていません |
MILES |
単位(マイル) |
KILOMETERS |
単位: キロメートル |
LoyaltyProgram
販売者が提供するポイント プログラム。
JSON 表現 |
---|
{
"loyaltyProgramTiers": [
{
object ( |
フィールド | |
---|---|
loyalty |
省略可。この配送サービスのポイント プログラムの階層。 |
program |
これは、Merchant Center のポイント プログラム設定で設定するポイント プログラム ラベルです。このサブ属性を使用すると、貴社のポイント プログラムが対象の商品にマッピングされます。 |
LoyaltyProgramTiers
販売者ポイント プログラムのサブセット。
JSON 表現 |
---|
{ "tierLabel": string } |
フィールド | |
---|---|
tier |
階層ラベル [tierLabel] サブ属性は、商品単位の特典を階層間で区別します。この値は Merchant Center のプログラム設定でも設定されます。ポイント プログラムに階層が 1 つしかない場合でも、データソース変更の際は必須です。 |
倉庫
フルフィルメント ウェアハウス: 在庫を保管して処理します。
JSON 表現 |
---|
{ "name": string, "shippingAddress": { object ( |
フィールド | |
---|---|
name |
必須。ウェアハウスの名前。アカウント内で一意にする必要があります。 |
shipping |
必須。倉庫の発送先住所。 |
cutoff |
必須。注文を受け付け、処理を開始できる最遅の時間。その後の注文は翌日に処理されます。所要時間は倉庫の郵便番号に基づきます。 |
handling |
必須。この倉庫で商品を梱包して発送するまでにかかる日数。これは倉庫単位ですが、商品アイテムの属性に基づいて商品単位でオーバーライドできます。 |
business |
倉庫の営業日。設定しない場合、デフォルトは月曜日から金曜日になります。 |
住所
倉庫の発送先住所。
JSON 表現 |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
フィールド | |
---|---|
street |
住所の番地部分。例: |
city |
必須。市、町、コミューン。郵便区画または地域の下位区分(町内や郊外など)も含めることができます。 |
administrative |
必須。国の最上位の行政区分。たとえば、カリフォルニア州(「CA」)やケベック州(「QC」)などです。 |
postal |
必須。郵便番号(例: 94043)。 |
region |
必須。CLDR 国コード(「US」など)。 |
WarehouseCutoffTime
注文を受け付け、処理を開始できる最遅の時間。その後の注文は翌日に処理されます。所要時間は倉庫の郵便番号に基づきます。
JSON 表現 |
---|
{ "hour": integer, "minute": integer } |
フィールド | |
---|---|
hour |
必須。倉庫で当日中に処理されるように注文を完了する必要がある締め切り時間(時)。時間は倉庫のタイムゾーンに基づいています。 |
minute |
必須。倉庫で当日中に処理されるように注文を完了する必要がある締め切り時間(分単位)。分は倉庫のタイムゾーンに基づいています。 |
メソッド |
|
---|---|
|
配送設定情報を取得します。 |
|
販売者の配送設定を、配送リクエストの設定に置き換えます。 |