Package google.shopping.merchant.accounts.v1beta

string

必要欄位。服務條款版本的資源名稱。格式：termsOfService/{version}

string

必要欄位。接受《服務條款》的帳戶。

string

必要欄位。根據 CLDR 定義的區域代碼。如果條款僅適用於特定國家/地區，則為該國家/地區；如果適用於全球，則為 001。

string

已接受的 termsOfService。

string

接受邀請的帳戶。這可以是帳戶本身，或是子帳戶的話，則為 MCA 帳戶。

Date

設定後，系統會指出已接受的 TermsOfService 僅在該日期 (世界標準時間) 結束前有效。屆時必須接受新的政策。您可以在「Required」訊息中找到必要的 TermsOfService 資訊。

string

ID。帳戶的資源名稱。格式：accounts/{account}

int64

僅供輸出。帳戶 ID。

string

必要欄位。使用者可解讀的帳戶名稱。詳情請參閱「商店名稱」和「商家名稱」。

bool

這個帳戶是否含有成人內容。

bool

僅供輸出。是否為測試帳戶。

TimeZone

必要欄位。帳戶時區。

在寫入時，time_zone 會同時設定 reporting_time_zone 和 display_time_zone。

對於讀取作業，time_zone 一律會傳回 display_time_zone。如果您的帳戶中沒有 display_time_zone，time_zone 會是空白。

string

必要欄位。帳戶的 BCP-47 語言代碼，例如 en-US 或 sr-Latn。

string

ID。帳戶問題的資源名稱。格式：accounts/{account}/issues/{id}

string

問題的本地化標題。

Severity

問題的整體嚴重程度。

ImpactedDestination

這個問題對各種目的地的影響。

string

問題的其他本地化詳細資料。

string

連結至 Merchant Center 說明中心，提供有關問題的更多資訊和修正方式。

Impact

各區域對指定目的地的 (負面) 影響。

ReportingContextEnum

受影響的報表內容。

string

這個問題適用的 CLDR 區域代碼。

Severity

問題對目的地和區域的影響程度。

string

地址的街道層級部分。例如 111w 31st Street。

string

必要欄位。城市、鄉鎮或社區。也可能包含從屬地區或次區域 (例如社區或郊區)。

string

必要欄位。國家/地區的最上層行政區劃分。例如加州 (「CA」) 或魁北克省 (「QC」)。

string

必要欄位。郵遞區號 (例如「94043」)。

string

必要欄位。CLDR 國家/地區代碼 (例如「US」)。

string

ID。自動動態饋給設定的資源名稱。格式：accounts/{account}/autofeedSettings。

bool

必要欄位。啟用或停用指定帳戶的自動動態饋給產品檢索功能。自動動態饋給帳戶必須符合特定條件，您可以透過 eligible 欄位進行檢查。帳戶不得是市集。第一次啟用自動動態饋給時，產品通常會立即顯示。重新啟用後，產品最多可能需要 24 小時才會顯示。

bool

僅供輸出。判斷商家是否符合自動動態饋給的註冊資格。

Weekday

必要欄位。正常營業日。不得留空。

string

ID。商家身分的資源名稱。格式：accounts/{account}/businessIdentity

PromotionsConsent

必要欄位。身分屬性是否可用於促銷活動。

IdentityAttribute

選用設定。指定商家是否自認為黑人經營的商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。

IdentityAttribute

選用設定。指定商家是否為女性經營。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。

IdentityAttribute

選用設定。指定商家是否為退伍軍人經營的商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。

IdentityAttribute

選用設定。指定商家是否自認為拉丁裔經營的商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集或市集賣家。

IdentityAttribute

選用設定。指定商家是否自認為小型商家。這個選用欄位僅適用於商家，且商家所在國家/地區必須設為 US。也不適用於市集。

IdentityDeclaration

必要欄位。此屬性的身分宣告。

string

ID。商家資訊的資源名稱。格式：accounts/{account}/businessInfo

PostalAddress

選用設定。商家地址。僅支援 region_code、address_lines、postal_code、administrative_area 和 locality 欄位。系統會忽略所有其他欄位。

PhoneNumber

僅供輸出。商家電話號碼。

PhoneVerificationState

僅供輸出。商家電話驗證狀態。

CustomerService

選用設定。商家的客戶服務。

string

選用設定。10 位數的韓國商業登記號碼，以連字號分隔，格式為 XXX-XX-XXXXX。

string

必要欄位。運送業者費率的名稱。每個費率群組的名稱皆不得重複。

string

必要欄位。電信服務，例如 "UPS" 或 "Fedex"。

string

必要欄位。電信服務，例如 "ground" 或 "2 days"。

string

必要欄位。這個運送公司費率的運送起點。

string

選用設定。以小數表示的運費乘數。可為負數。例如 "5.4" 會將費率提高 5.4%，"-3" 則會將費率調降 3%。

Price

選用設定。加總運費調節係數。可為負數。舉例來說，{ "amount_micros": 1, "currency_code" : "USD" } 會將費率提高 $1 美元，{ "amount_micros": -3, "currency_code" : "USD" } 則會將費率降低 $3 美元。

string

必要欄位。要聲明的首頁名稱。格式：accounts/{account}/homepage

bool

選用設定。如果設為 true，這個選項會移除要求網站上的任何現有聲明，並以提出要求的帳戶聲明取代。

Account

必要欄位。要建立的帳戶。

CreateUserRequest

選用設定。要新增至帳戶的使用者。

這個欄位已淘汰，API 從 Beta 版改版後就不會存在。請改用 user 欄位。

AddUser

選用設定。要新增至帳戶的使用者。

AddAccountService

必要欄位。在建立帳戶時，系統會初始化要建立的帳戶與供應商帳戶之間的帳戶服務。您必須提供至少一項這類服務。目前這兩者中必須有一個是 account_aggregation，也就是說，您只能透過這個方法建立子帳戶，而不能建立獨立帳戶。可能會提供額外的 account_management 或 product_management 服務。

AccountAggregation

供應商是帳戶的集結網站業者。服務類型「Account Aggregation」的酬載。

string

必要欄位。服務供應商。指的是 providers/123 等帳戶或知名服務供應商 (providers/GOOGLE_ADS 或 providers/GOOGLE_BUSINESS_PROFILE 之一) 的參照。

string

必要欄位。使用者的電子郵件地址 (例如 john.doe@gmail.com)。

User

選用設定。所要新增使用者的詳細資料。目前只能指定存取權。

string

必要欄位。要建立區域的帳戶。格式：accounts/{account}

string

必要欄位。區域的 ID，在同一帳戶的所有區域中不重複。

Region

必要欄位。要建立的區域。

string

必要欄位。系統將為使用者建立的帳戶資源名稱。格式：accounts/{account}

string

必要欄位。使用者的電子郵件地址 (例如 john.doe@gmail.com)。

User

選用設定。要建立的使用者。

string

選用設定。可找到客戶服務的 URI。

string

選用設定。可用於聯絡客戶服務的電子郵件地址。

PhoneNumber

選用設定。可撥打至客戶服務部門的電話號碼。

int32

必要欄位。截止時間的指定小時，訂單必須在這個時間前下單，才能在當天處理。

int32

必要欄位。訂單截止時間的最後幾分鐘，訂單必須在這個時間前下單，才能在當天處理。

string

必要欄位。時區 ID，例如「Europe/Zurich」。

string

必要欄位。要刪除的帳戶名稱。格式：accounts/{account}

bool

選用設定。如果設為 true，即使帳戶為其他帳戶提供服務或已處理優惠，系統仍會刪除該帳戶。

string

必要欄位。要刪除的區域名稱。格式：accounts/{account}/regions/{region}

string

必要欄位。要刪除的使用者名稱。格式：accounts/{account}/users/{email}

您也可以使用 me 而非 accounts/{account}/users/me 中的電子郵件地址，刪除呼叫端對應的使用者。

WarehouseBasedDeliveryTime

選用設定。表示系統應根據所選貨運公司的設定，為每個倉庫 (出貨地點) 計算運送時間。設定後，[delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應再設定其他運送時間相關欄位。

int32

運送過程中所需的最短工作天數。0 代表當天到貨，1 代表次日到貨。必須設定 min_transit_days、max_transit_days 或 transit_time_table，但不能同時設定。

int32

運送過程中所需的最長工作天數。0 代表當天到貨，1 代表次日到貨。必須大於或等於 min_transit_days。

CutoffTime

工作天截止時間定義。如果未設定，截止時間預設為太平洋標準時間上午 8 點。

int32

訂單出貨前所需的最少工作天數。0 代表當天出貨，1 代表次日出貨。請同時設定或不設定「min_handling_days」和「max_handling_days」。

int32

訂單出貨前所需的最大工作天數。0 代表當天出貨，1 代表次日出貨。必須大於或等於 min_handling_days。請同時設定或不設定「min_handling_days」和「max_handling_days」。

TransitTable

運送時間表格：根據列和欄維度，計算運送所需的工作天數。您可以設定 min_transit_days、max_transit_days 或 transit_time_table，但不能同時設定兩者。

BusinessDayConfig

訂單可處理的工作天數。如未提供，系統會假設週一至週五為工作日。

BusinessDayConfig

訂單可能處於運送中的工作天數。如未提供，系統會假設週一至週五為工作日。

string

必要欄位。要為指定帳戶停用參與的計畫名稱。格式：accounts/{account}/programs/{program}

int64

距離的整數值。

Unit

單位可能因國家/地區而異，因此參數化為英里和公里。

string

ID。EmailPreferences 的名稱。端點僅支援已驗證的使用者。

OptInState

選用設定。有關新功能、提示和最佳做法的最新消息。

string

必要欄位。指定帳戶可參與的計畫名稱。格式：accounts/{account}/programs/{program}

string

必要欄位。要擷取的帳戶名稱。格式：accounts/{account}

string

必要欄位。自動動態饋給設定的資源名稱。格式：accounts/{account}/autofeedSettings

string

必要欄位。商家身分的資源名稱。格式：accounts/{account}/businessIdentity

string

必要欄位。商家資訊的資源名稱。格式：accounts/{account}/businessInfo

string

必要欄位。EmailPreferences 資源的名稱。格式：accounts/{account}/users/{email}/emailPreferences

string

必要欄位。要擷取的首頁名稱。格式：accounts/{account}/homepage

string

必要欄位。要擷取的退貨政策名稱。格式：accounts/{account}/onlineReturnPolicies/{return_policy}

string

必要欄位。要擷取的節目名稱。格式：accounts/{account}/programs/{program}

string

必要欄位。要擷取的區域名稱。格式：accounts/{account}/regions/{region}

string

必要欄位。要擷取的運送設定名稱。格式：accounts/{account}/shippingsetting

string

必要欄位。服務條款版本的資源名稱。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} ID 格式為：{TermsOfServiceKind}-{country}

string

必要欄位。服務條款版本的資源名稱。格式：termsOfService/{version}

string

必要欄位。要擷取的使用者名稱。格式：accounts/{account}/users/{email}

您也可以使用 me 來擷取與呼叫端相對應的使用者，而非 accounts/{account}/users/me 中的電子郵件地址。

Price

必要欄位。包含訂單價格上限的清單。只要將價格 amount_micros = -1，最後價格的值即可設為無限。例如 [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] 代表標頭「<= $10", "<= $500" 和 "> $500"。服務中的所有價格都必須使用相同的貨幣。不得空白。必須為正數，但 -1 除外。只有在所有其他欄位都未設定時，才能設定此欄位。

Weight

必要欄位。包含訂單重量上限的清單。只要將價格 amount_micros = -1，最後一個權重值就能設為無限。例如 [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] 代表標頭「<= 10kg", "<= 50kg" 和 "> 50kg"。服務中的所有重量都必須使用相同的單位。不得空白。必須為正數，但 -1 除外。只有在所有其他欄位未設定時，才能設定此欄位。

string

必要欄位。包含項目上限數量的清單。最後一個值可以是 "infinity"。例如 ["10", "50", "infinity"] 代表標頭「<= 10 個項目」、「<= 50 個項目」和「> 50 個項目」。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。

string

必要欄位。郵政區域名稱清單。最後一個值可以是 "all other locations"。範例：["zone 1", "zone 2", "all other locations"]。所指的郵遞區號群組必須與服務的運送國家/地區相符。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。

LocationIdSet

必要欄位。地區 ID 集合的清單。不得空白。只有在所有其他欄位未設定時，才能設定此欄位。

string

ID。商店首頁的資源名稱。格式：accounts/{account}/homepage

bool

僅供輸出。是否已聲明首頁的擁有權。請參閱 https://support.google.com/merchants/answer/176793。

string

必要欄位。商店首頁的 URI (通常是網址)。

string

必要欄位。要插入此產品的帳戶。格式：accounts/{account}

ShippingSettings

必要欄位。帳戶的新版本。

string

必要欄位。這個問題集合的父項。格式：accounts/{account}

int32

選用設定。要傳回的問題數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 位使用者。許可的最大值為 100；超出的數值將一律指定為 100

string

選用設定。從先前 ListAccountIssues 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccountIssues 的所有其他參數須與提供網頁權杖的呼叫相符。

string

選用設定。回應中的各項問題會包含使用指定語言撰寫的欄位，方便人類閱讀。格式為 BCP-47，例如 en-US 或 sr-Latn。如未提供值，系統會使用 en-US。

string

選用設定。IANA 時區，用於將時間轉換為使用者可讀取的欄位。例如「America/Los_Angeles」。如未設定，系統會使用「America/Los_Angeles」。

AccountIssue

指定帳戶的問題。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

int32

選用設定。要傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 250 個帳戶。許可的最大值為 500；超出的數值將一律指定為 500。

string

選用設定。從先前 ListAccounts 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccounts 的所有其他參數須與提供網頁權杖的呼叫相符。

string

選用設定。只會傳回符合篩選器的帳戶。詳情請參閱篩選器語法參考資料。

Account

與 ListAccountsRequest 相符的帳戶。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

string

必要欄位。要列出退貨政策的商家帳戶。格式：accounts/{account}

int32

選用設定。要傳回的 OnlineReturnPolicy 資源數量上限。如果指定商家的退貨政策數量少於 pageSize，服務傳回的數量會少於這個值。預設值為 10。最大值為 100；如果指定的值高於最大值，pageSize 預設為最大值

string

選用設定。從先前 ListOnlineReturnPolicies 呼叫收到的網頁權杖。提供頁面符記即可擷取後續網頁。

進行分頁時，提供至 ListOnlineReturnPolicies 的所有其他參數須與提供網頁權杖的呼叫相符。在先前要求的回應中，權杖會以 nextPageToken 的形式傳回。

OnlineReturnPolicy

擷取的退貨政策。

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

string

必要欄位。要擷取所有計畫的帳戶名稱。格式：accounts/{account}

int32

選用設定。單一回應中傳回的節目數量上限。如果未指定 (或 0)，系統會使用預設大小 1000。許可的最大值為 1000；超出的數值將一律指定為 1000。

string

選用設定。接收自先前 ListPrograms 呼叫的續行權杖。提供此項目即可擷取後續網頁。

Program

指定帳戶的計畫。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

string

必要欄位。要列出地區的帳戶。格式：accounts/{account}

int32

選用設定。要傳回的區域數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個區域。許可的最大值為 1000；超出的數值將一律指定為 1000。

string

選用設定。從先前 ListRegions 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListRegions 的所有其他參數須與提供網頁權杖的呼叫相符。

Region

指定商家的區域。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

string

必要欄位。匯總服務供應商。格式：providers/{providerId}

int32

選用設定。要傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 250 個帳戶。許可的最大值為 500；超出的數值將一律指定為 500。

string

選用設定。從先前 ListAccounts 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccounts 的所有其他參數須與提供網頁權杖的呼叫相符。

Account

指定家長帳戶是匯入帳戶的帳戶。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

string

必要欄位。擁有此使用者集合的父項。格式：accounts/{account}

int32

選用設定。要傳回的使用者人數上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 位使用者。許可的最大值為 100；超出的數值將一律指定為 100

string

選用設定。從先前 ListUsers 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListUsers 的所有其他參數須與提供網頁權杖的呼叫相符。

User

指定帳戶中的使用者。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

string

必要欄位。非空白的地區 ID 清單。這些位置都必須是相同的位置類型 (例如州/省)。

StoreCodeSetWithMov

必要欄位。共用相同最低訂單價值 (MOV) 的商店代碼組合清單。至少需要兩個集合，且最後一個集合必須為空白，代表「MOV for all other stores」。每個商家代碼只能出現在所有集合中一次。服務中的所有價格都必須使用相同的貨幣。

string

選用設定。專屬商店代碼清單，或用於萬用設定的空白值。

Price

指定商店的最低訂單價值。

string

ID。OnlineReturnPolicy 資源的名稱。格式：accounts/{account}/onlineReturnPolicies/{return_policy}

string

僅供輸出。Google 產生的退貨政策 ID。

string

必要欄位。不可變動。這個欄位代表退貨政策的使用者定義標籤，請注意，同一個國家/地區的不同退貨政策中，不得使用相同的標籤。除非產品指定特定標籤屬性，否則政策會自動標示為「預設」。如要為特定產品群組指派自訂退貨政策，請按照「退貨政策標籤」中的說明操作。標籤長度上限為 50 個半形字元。

string

必要欄位。不可變動。退貨政策適用的銷售國家/地區。值必須是有效的 2 個字母 ISO 3166 代碼。

Policy

退貨政策。

SeasonalOverride

選用設定。針對特定時間間隔內下單的一般政策，提供覆寫值。

RestockingFee

適用於所有退貨原因類別的重新進貨費用。如果未設定值，系統會將其視為免費的補貨費。

ReturnMethod

消費者可用來退回商品的退貨方式。除非退貨政策類型為 noReturns，否則這個值不得空白。

ItemCondition

除非退貨政策類型為「noReturns」，否則接受的退貨商品狀態不得為空白。

ReturnShippingFee

退貨運費。只有在客戶需要下載及列印退貨標籤時，才應設定這項屬性。

string

必要欄位。退貨政策的 URI。Google 可使用這項資訊對政策進行健全性檢查。必須是有效的網址。

bool

這個欄位可指定商家是否只接受瑕疵產品的退貨，且為必要欄位。

int32

這個欄位可指定商家處理退款所需的天數，為選用欄位。

bool

這個欄位用來指定商家是否允許消費者換貨，為必填欄位。

Type

政策類型。

int64

商品送達後可退回的天數，其中 1 天定義為送達時間戳記後的 24 小時。NUMBER_OF_DAYS_AFTER_DELIVERY 退貨時必填。

Price

固定的重新進貨費用。

int32

總價格的百分比，以百萬分之一為單位。15,000,000 代表系統會收取總價的 15%。

Type

必要欄位。退貨運費類型。

Price

固定退貨運費金額。這個值只適用於類型為 FIXED 的情況。如果類型為 FIXED 且未設定這個值，我們會將退貨運費視為免費。

string

必要欄位。在 Merchant Center 中顯示此季節性覆寫值的名稱。

Date

必要欄位。定義此季節性替代政策的適用日期範圍。開始和結束日期都包含在內，且應採用日期小數格式，例如 20250115。季節性替代政策的日期不得重疊。

Date

必填。季節性替代政策的結束日期 (含此日期)。

Policy

必要欄位。指定日期範圍的退貨政策。

string

ID。程式的資源名稱。格式：accounts/{account}/programs/{program}

string

僅供輸出。說明這項計畫的 Merchant Center 說明頁面網址。

State

僅供輸出。帳戶在計畫中的參與狀態。

string

僅供輸出。帳戶積極參與計畫的區域。我們將「有效區域」定義為已符合所有影響該區域的計畫規定的區域。

區域代碼由 CLDR 定義。這個值可以是指特定國家/地區 (指的是該計畫僅適用於該國家/地區)，或是 001 (指的是該計畫適用於全球)。

Requirement

僅供輸出。帳戶尚未符合的條件，導致無法參與計畫。

string

僅供輸出。需求名稱。

string

僅供輸出。說明規定的說明頁面網址。

string

僅供輸出。目前受這項規定未滿足的區域。

區域代碼由 CLDR 定義。這個值可以是指特定國家/地區 (指的是該計畫僅適用於該國家/地區)，或是 001 (指的是該計畫適用於全球)。

string

必要欄位。運送標籤清單，定義這個費率群組適用的產品。這是一個不相容的條件：只要其中一個標籤相符，系統就會套用費率群組。只有服務的最後一個費率群組可以為空白。

Table

選用設定。main_table 參照的子表清單。必須設定 main_table 才可設定。

CarrierRate

選用設定。可由 main_table 或 single_value 參照的電信費率清單。

Value

費率群組的值 (例如固定費率 $10 美元)。只有在未設定 main_table 和 subtables 時才能設定。

Table

當 single_value 無法充分表達時，定義費率群組的表格。只有在未設定 single_value 時才能設定。

string

選用設定。費率群組名稱。如果已設定，則運送服務中不得重複。

string

ID。區域的資源名稱。格式：accounts/{account}/regions/{region}

PostalCodeArea

選用設定。定義區域範圍的郵遞區號清單。

GeoTargetArea

選用設定。定義區域範圍的地理目標清單。

BoolValue

僅供輸出。指出區域是否可用於區域商品目錄設定。

BoolValue

僅供輸出。指出該區域是否可用於運送服務設定。

string

選用設定。區域的顯示名稱。

int64

必要欄位。非空白的地區 ID 清單。這些位置都必須屬於相同的位置類型 (例如州/省)。

string

必要欄位。CLDR 地域代碼，或郵遞區號群組適用的國家/地區。

PostalCodeRange

必要欄位。郵遞區號範圍。

string

必要欄位。郵遞區號或前置碼* 的格式模式，表示定義區域範圍的包含下限。範例值：94108、9410*、9*。

string

選用設定。郵遞區號或 prefix* 形式的模式，表示定義區域範圍的上限。長度必須與 postalCodeRangeBegin 相同：如果 postalCodeRangeBegin 是郵遞區號，postalCodeRangeEnd 也必須是郵遞區號；如果 postalCodeRangeBegin 是模式，postalCodeRangeEnd 也必須是模式，且前置碼長度相同。選用：如果未設定，則該區域的定義為與 postalCodeRangeBegin 相符的所有郵遞區號。

string

需要接受的 termsOfService。

string

服務條款檔案的完整網址。這個欄位與 TermsOfService.file_uri 相同，只是為了方便起見而新增。

string

必要欄位。要取得「TermsOfServiceAgreementState」的帳戶。格式：accounts/{account}

string

必要欄位。根據 CLDR 定義的區域代碼。如果條款僅適用於特定國家/地區，則為該國家/地區；如果適用於全球，則為 001。

TermsOfServiceKind

必要欄位。這個服務條款版本適用的類型。

Value

必要欄位。組成該列的儲存格清單。在二維表格中，必須與 columnHeaders 的長度相同；在單維表格中，長度為 1。

string

必要欄位。服務適用的國家/地區的 CLDR 地域代碼。

RateGroup

選用設定。運送費率群組定義。只有最後一個群組可以有空白的 applicable_shipping_labels，代表「其他所有內容」。其他 applicable_shipping_labels 不得重疊。

LoyaltyProgram

選用設定。這項運送服務僅適用於哪些會員方案？

string

必要欄位。服務的自由格式名稱。在目標帳戶中不得重複。

bool

必要欄位。布林值，用於公開運送服務的有效狀態。

string

這項服務適用的貨幣 CLDR 代碼。必須與費率群組中的價格相符。

DeliveryTime

必要欄位。從下單到產品送達的各個環節所花費的時間。

ShipmentType

這項服務運送訂單的地區類型。

Price

這項服務的最低訂單價值。如果已設定，表示顧客必須至少消費這個金額。服務中的所有價格都必須使用相同的貨幣。無法與 minimum_order_value_table 一同設定。

MinimumOrderValueTable

下表列出自取出貨類型每間商店的最低訂單價值。無法與 minimum_order_value 一併設定。

StoreConfig

產品運送商店清單。這項設定僅適用於店面運送貨件類型。

LoyaltyProgramTiers

選用設定。這項運送服務的會員方案等級。

string

你在 Merchant Center 會員方案中所設定的會員方案標籤。Google 會根據這項子屬性將你的會員方案對應至符合資格的商品。

string

等級標籤 [tier_label] 子屬性可用於區分不同會員等級的商品層級福利。你也會在 Merchant Center 會員方案中設定這項屬性值；即使會員方案只有 1 個等級，變更資料來源時你也必須提供這個屬性值。

string

選用設定。提供當地運送服務的商店代碼清單。如果為空白，則 all_stores 必須為 true。

StoreServiceType

指出商家列出的所有商店或特定商店是否提供本地運送服務。

CutoffConfig

當天結束的店面運送相關設定。

Distance

最大運送範圍半徑。這項屬性僅適用於店面運送貨件類型。

LocalCutoffTime

當天店面到貨服務結束的時間。

int64

僅適用於當地出貨服務。以商店打烊前幾小時的數量代表截止時間。與 local_cutoff_time 互斥。

bool

如果商家已將運送服務設為 n 天店到府運送，就能選擇不顯示 n+1 天店到府運送。舉例來說，如果運送服務定義為當天到貨，且已超過截止時間，將這個欄位設為 true 會導致計算的運送服務費率傳回 NO_DELIVERY_POST_CUTOFF。在同一個範例中，將這個欄位設為 false 會導致計算出的運送時間為一天。這項功能僅適用於店面商品交付。

int64

當天處理的店到宅配訂單必須在指定時間前下單。

int64

訂單必須在當天處理的訂單截止時間前下單，才能在當天處理。

string

ID。運送設定的資源名稱。格式：accounts/{account}/shippingSetting

Service

選用設定。目標帳戶的服務清單。

Warehouse

選用設定。可在 services 中參照的倉庫清單。

string

必要欄位。這個欄位可用於避免非同步問題。請確認在呼叫「get」和「insert」之間，運送設定資料不會變更。使用者應採取下列步驟：

1. 在建立初始運送設定時，將 etag 欄位設為空字串。

2. 初始建立後，請先呼叫 get 方法取得 etag 和目前的運送設定資料，再呼叫 insert。

3. 修改為所需的運送設定資訊。

4. 使用從步驟 2 取得的 etag，搭配所需的運送設定資訊呼叫插入方法。

5. 如果在步驟 2 和步驟 4 之間，運送設定資料有變更，插入要求會失敗，因為每次運送設定資料變更時，etag 都會變更。使用者應使用新的 etag 重複執行步驟 2 至 4。

Row

必要欄位。構成資料表的資料列清單。必須與 row_headers 的長度相同。

string

資料表名稱。子表格為必填，主表格則會忽略。

Headers

必要欄位。表格列的標題。

Headers

表格欄的標題。選用：如果未設定，則資料表只有一個維度。

string

ID。服務條款版本的資源名稱。格式：termsOfService/{version}

string

根據 CLDR 定義的區域代碼。這可能是適用條款僅適用於該國家/地區的國家/地區，或是 001，當相同的 TermsOfService 可在任何國家/地區簽署時。不過請注意，在簽署適用於全球的服務條款時，您仍須提供特定國家/地區 (應為商家業務所在國家/地區或參與計畫的國家/地區)。

TermsOfServiceKind

這個服務條款版本適用的類型。

bool

這個服務條款版本是否為外部版本。外部服務條款版本只能透過外部程序同意，商家不得直接透過 UI 或 API 同意。

string

服務條款檔案的 URI，需要向簽署使用者顯示。

string

ID。服務條款版本的資源名稱。格式：accounts/{account}/termsOfServiceAgreementState/{identifier} ID 格式為：{TermsOfServiceKind}-{country} 例如：MERCHANT_CENTER-US

string

根據 https://cldr.unicode.org/ 定義的區碼。這是目前狀態適用的國家/地區。

TermsOfServiceKind

與特定版本相關聯的服務條款類型。

Accepted

已接受的這類服務條款，以及相關聯的 region_code

Required

必要的服務條款

string

必要欄位。區域名稱清單 Region.name。最後一個值可以是 "all other locations"。範例：["zone 1", "zone 2", "all other locations"]。所指的郵遞區號群組必須與服務的運送國家/地區相符。

string

必要欄位。運送時間標籤清單。最後一個值可以是 "all other labels"。範例：["food", "electronics", "all other labels"]。

TransitTimeRow

必要欄位。如果只有一個 postal_code_group_names 或 transit_time_labels 維度集，則會有多個資料列，每個資料列都包含該維度的一個值。如果有兩個維度，每個資料列都會對應至 postal_code_group_names，而資料欄 (值) 則會對應至 transit_time_labels。

TransitTimeValue

必要欄位。運送時間範圍 (最小至最大)，以工作天為單位。

int32

最短運送時間範圍 (以工作天為單位)。0 代表當天到貨，1 代表次日到貨。

int32

必須大於或等於 min_transit_days。

string

必要欄位。要取消宣稱的首頁名稱。格式：accounts/{account}/homepage

Account

必要欄位。帳戶的新版本。

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

• account_name
• adult_content
• language_code
• time_zone

AutofeedSettings

必要欄位。新版自動動態饋給設定。

FieldMask

必要欄位。要更新的欄位清單。

BusinessIdentity

必要欄位。商家身分的最新版本。

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

• black_owned
• latino_owned
• promotions_consent
• small_business
• veteran_owned
• women_owned

BusinessInfo

必要欄位。新版商家資訊。

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

• address
• customer_service
• korean_business_registration_number

EmailPreferences

必要欄位。要更新的電子郵件接收設定。

FieldMask

必要欄位。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

• news_and_tips

Homepage

必要欄位。新版首頁。

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

• uri

Region

必要欄位。更新後的區域。

FieldMask

選用設定。以半形逗號分隔的欄位遮罩，用於指定要更新的欄位。範例："displayName,postalCodeArea.regionCode"。

User

必要欄位。使用者的新版本。

使用 me 來表示自己的電子郵件地址，例如 accounts/{account}/users/me。

FieldMask

選用設定。要更新的欄位清單。

系統支援下列欄位 (snake_case 和 lowerCamelCase 皆適用)：

• access_rights

string

ID。使用者的資源名稱。格式：accounts/{account}/user/{email}

使用 me 來表示自己的電子郵件地址，例如 accounts/{account}/users/me。

State

僅供輸出。使用者的狀態。

AccessRight

選用設定。使用者擁有的存取權。

bool

如果為 true，則表示產品無法運送。設定時必須設為 true，且只能在所有其他欄位未設定的情況下設定。

Price

固定費率。只有在所有其他欄位未設定時，才能設定此欄位。

string

以小數表示的價格百分比 (例如 "5.4")。只有在未設定所有其他欄位時，才能設定此欄位。

string

運送公司費率的名稱，指的是同一個費率群組中定義的運送公司費率。只有在所有其他欄位未設定時，才能設定此欄位。

string

子表格的名稱。只能在表格儲存格中設定 (例如，不能用於單一值)，且只有在所有其他欄位都未設定的情況下才能設定。

string

必要欄位。倉庫名稱。在帳戶中不得重複。

Address

必要欄位。倉庫的運送地址。

WarehouseCutoffTime

必要欄位。訂單可接受及開始處理的最後時間。後續訂單會在隔天處理。時間會根據倉庫的郵遞區號計算。

int64

必要欄位。這個倉庫包裝及出貨商品所需的天數。這是在倉庫層級，但可以根據商品屬性，在商品層級覆寫。

BusinessDayConfig

倉庫的工作天數。如果未設定，預設值為週一至週五。

string

必要欄位。載具，例如 "UPS" 或 "Fedex"。支援的電信業者

string

必要欄位。電信服務，例如 "ground" 或 "2 days"。服務名稱必須列在 eddSupportedServices 清單中。

string

必要欄位。倉儲名稱。這個值應與 [warehouse][ShippingSetting.warehouses.name] 相符

int32

必要欄位。截止時間的指定小時，即訂單必須在截止時間前下單，才能在當天由倉庫處理。小時以倉庫所在的時區為準。

int32

必要欄位。截止時間的最後幾分鐘，訂單必須在這個時間前下單，才能在當天由倉庫處理。分鐘是以倉庫所在時區為準。