Package google.shopping.merchant.accounts.v1beta

索引

AccountIssueService

用於支援 AccountIssueService API 的服務。

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

列出 Merchant Center 帳戶的所有帳戶問題。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

AccountTaxService

管理帳戶層級的稅金設定資料。

這個 API 定義了下列資源模型：

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

傳回與 GetAccountTaxRequest 條件相符的稅務規則

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

系統只會在 Merchant Center 帳戶中列出子帳戶的稅金設定。這個方法只能在多重客戶帳戶中呼叫，否則會傳回錯誤。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

更新帳戶的稅金設定。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

AccountsService

支援 Accounts API 的服務。

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

建立包含額外設定的獨立 Merchant Center 帳戶。將提出要求的使用者新增為新帳戶的管理員。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

刪除指定帳戶，不論類型為何：獨立、MCA 或子帳戶。刪除 MCA 會導致其所有子帳戶遭到刪除。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

從 Merchant Center 帳戶擷取帳戶。插入、更新或刪除帳戶後，您所做的變更可能需要幾分鐘才會生效。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

列出呼叫使用者可存取的帳戶，且符合要求的限制 (例如頁面大小或篩選條件)。這項功能不僅列出 MCA 的子帳戶，通話使用者也能存取所有帳戶，包括其他 MCA、已連結帳戶和獨立帳戶等。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

列出指定多重客戶帳戶的所有子帳戶。這是便利的包裝函式，適用於更強大的 ListAccounts 方法。這個方法會產生與使用以下篩選器呼叫 ListsAccounts 相同的結果：relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

可更新不限類型的帳戶：獨立、MCA 或子帳戶。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

BusinessIdentityService

支援企業身分 API 的服務。

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

擷取帳戶的商家身分。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

更新帳戶的商家身分。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

BusinessInfoService

支援 Business Information API 的服務。

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

擷取帳戶的商家資訊。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

更新帳戶的商家資訊。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

EmailPreferencesService

用於支援 EmailPreferences API 的服務。

這項服務僅允許擷取及更新已驗證使用者的電子郵件偏好設定。

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

傳回 Merchant Center 帳戶使用者的電子郵件接收設定。

請使用 name=accounts/*/users/me/emailPreferences 別名取得已驗證使用者的偏好設定。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

更新 Merchant Center 帳戶使用者的電子郵件接收設定。MCA 使用者應指定 MCA 帳戶，而非 MCA 的子帳戶。

未明確在更新遮罩中選取的偏好設定不會更新。

此更新對於指定 UNCONFIRMED 加入狀態值無效。

請使用 name=accounts/*/users/me/emailPreferences 別名更新已驗證使用者的偏好設定。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

HomepageService

支援商店首頁 API 的服務。

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

聲明商店首頁的擁有權。需要管理員存取權才能執行這個方法。

如果首頁已聲明擁有權，系統就會重新檢查驗證狀態。除非商家符合聲明資格，不必聲明擁有權，因而不必通過驗證，然後傳回成功的回應。如果無法驗證擁有權，系統會傳回錯誤，但不會撤銷版權聲明。假如發生錯誤，系統會傳回標準錯誤訊息：* PERMISSION_DENIED：使用者沒有這個 MC 帳戶所需的權限；* FAILED_PRECONDITION：- 這個帳戶不是 Merchant Center 帳戶；- Merchant Center 帳戶沒有首頁；聲明失敗 (在此情況下，錯誤訊息將包含更多詳細資料)。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

擷取商店首頁。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

取消聲明商店首頁的擁有權。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

更新商店的首頁。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

OnlineReturnPolicyService

這項服務協助商家管理商家懊悔退貨政策設定，並在廣告和免費產品資訊中提供退貨政策

計畫。這個 API 定義了下列資源模型：

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

取得現有的退貨政策。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

列出所有現有的退貨政策。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

ProgramsService

計畫管理的服務。

計畫提供為商家帳戶新增功能的機制。常見的例子是「免費產品資訊」計畫，這項計畫可讓商家商店的產品免費在 Google 上顯示。

除了明確啟用或停用各項計畫的方法之外，這項服務還提供擷取商家參與所有可用計畫的方法。

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

停止讓帳戶參與特定計畫。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

允許帳戶參與特定計畫。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

擷取帳戶的特定程式。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

擷取帳戶的所有計畫。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

RegionsService

管理區域設定。

這個 API 定義了下列資源模型：

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

在 Merchant Center 帳戶中建立區域定義。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

從 Merchant Center 帳戶中刪除區域定義。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

擷取 Merchant Center 帳戶中定義的區域。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

列出 Merchant Center 帳戶中的區域。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

在 Merchant Center 帳戶中更新區域定義。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

ShippingSettingsService

根據 Merchant API 方法取得方法呼叫運送設定資訊的服務。

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

擷取運送設定資訊。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

將商家的運送設定換成要求的運送設定。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

TermsOfServiceAgreementStateService

用於支援 TermsOfServiceAgreementState API 的服務。

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

傳回服務條款協議的狀態。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

擷取應用程式服務條款的協議狀態。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

TermsOfServiceService

用於支援 TermsOfService API 的服務。

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

接受 TermsOfService。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

擷取與指定版本相關聯的 TermsOfService。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

針對特定 kind 和 region_code 擷取最新版 TermsOfService。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

UserService

用來支援使用者 API 的服務。

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

建立 Merchant Center 帳戶使用者。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

刪除 Merchant Center 帳戶使用者。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
GetUser

rpc GetUser(GetUserRequest) returns (User)

擷取 Merchant Center 帳戶使用者。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

列出 Merchant Center 帳戶的所有使用者。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。
UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

更新 Merchant Center 帳戶使用者。需要管理員存取權才能執行這個方法。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。

AcceptTermsOfServiceRequest

AcceptTermsOfService 方法的要求訊息。

欄位
name

string

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

string

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

string

必要欄位。CLDR 定義的區碼。指特定國家/地區專屬《服務條款》即為 001 的國家/地區。

已接受

說明系統接受的服務條款。

欄位
terms_of_service

string

接受的 termsOfService。
accepted_by

string

記錄接受資訊的帳戶。可以是帳戶本身；如果是子帳戶，則可輸入 MCA 帳戶。
valid_until

Date

設定後，代表接受的 TermsOfService 僅在此日期結束 (世界標準時間) 為止。你必須在上述日期前接受新的 PIN 碼。您可以在「必要」訊息中找到必要 TermsOfService 資訊。

AccessRight

。

列舉
ACCESS_RIGHT_UNSPECIFIED 預設值。這個值未使用。
STANDARD 標準存取權限。
ADMIN 管理員權限。
PERFORMANCE_REPORTING 具備這項權限的使用者可存取成效和洞察資料。

帳戶

擁有帳戶。

欄位
name

string

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

int64

僅供輸出。帳戶的 ID。
account_name

string

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

bool

此帳戶是否包含成人內容。
test_account

bool

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

TimeZone

必要欄位。帳戶時區。

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

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

string

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

AccountIssue

AccountIssue。

欄位
name

string

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

string

問題的本地化標題。
severity

Severity

問題的整體嚴重性。
impacted_destinations[]

ImpactedDestination

這個問題對多個目的地的影響。
detail

string

關於問題的本地化詳細資料。
documentation_uri

string

Merchant Center 說明中心連結，提供關於問題和修正方式的進一步資訊。

ImpactedDestination

問題對到達網頁的影響。

欄位
impacts[]

Impact

對指定目的地多個區域的影響 (負數)。
reporting_context

ReportingContextEnum

受影響的報表結構定義。

影響

問題對區域的影響。

欄位
region_code

string

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

Severity

問題在目的地和地區的嚴重性。

嚴重性

所有可能的問題嚴重性。

列舉
SEVERITY_UNSPECIFIED 嚴重性不明。
CRITICAL 原因會導致商品無法放送。
ERROR 這個問題日後可能會影響優惠，或可能是商品有問題的指標。
SUGGESTION 這個問題是可改善的建議。

AccountTax

商家帳戶的稅金設定。所有方法都需要管理員角色。

欄位
name

string

ID。稅金設定的名稱。格式：「{account_tax.name=accounts/{account}}」
account

int64

僅供輸出。這些帳戶稅金設定所屬的帳戶 ID。
tax_rules[]

TaxRule

稅則規定。「定義各地區的稅務規定。如果沒有設定規則的區域，就不會顯示任何稅金。

地址

倉庫的運送地址。

欄位
street_address

string

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

string

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

string

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

string

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

string

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

BusinessDayConfig

倉庫的工作天。

欄位
business_days[]

Weekday

必要欄位。一般工作天。不得留空。

平日

列舉
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

商家身分相關資訊的收集。

欄位
name

string

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

IdentityAttribute

選用設定。指明商家是否自稱為黑人。這個選填欄位僅適用於商家所在國家/地區設為「US」的商家。但不適用於市集或市集賣家。
women_owned

IdentityAttribute

選用設定。指明商家是否自稱為女性。這個選填欄位僅適用於商家所在國家/地區設為「US」的商家。但不適用於市集或市集賣家。
veteran_owned

IdentityAttribute

選用設定。指明商家是否自稱為退伍軍人。這個選填欄位僅適用於商家所在國家/地區設為「US」的商家。但不適用於市集或市集賣家。
latino_owned

IdentityAttribute

選用設定。指出商家是否自稱業主為拉丁裔。這個選填欄位僅適用於商家所在國家/地區設為「US」的商家。但不適用於市集或市集賣家。
small_business

IdentityAttribute

選用設定。指出商家是否自稱為小型企業。這個選填欄位僅適用於商家所在國家/地區設為「US」的商家。也不適用於市集。

IdentityAttribute

與身分屬性相關的所有資訊。

欄位
identity_declaration

IdentityDeclaration

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

IdentityDeclaration

所有與身分宣告相關的設定。

列舉
IDENTITY_DECLARATION_UNSPECIFIED 此預設值表示未選取任何項目。
SELF_IDENTIFIES_AS 表示帳戶可用屬性識別。
DOES_NOT_SELF_IDENTIFY_AS 表示帳戶無法識別此屬性。

PromotionsConsent

所有與商家身分相關的促銷活動設定。

列舉

BusinessInfo

商家相關資訊集合。

欄位
name

string

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

PostalAddress

選用設定。商家的地址。
phone

PhoneNumber

選用設定。商家的電話號碼。
phone_verification_state

PhoneVerificationState

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

CustomerService

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

CarrierRate

main_table 或 single_value 可參照的貨運公司費率清單。

欄位
name

string

必要欄位。貨運公司費率的名稱。每個費率群組的名稱不得重複。
carrier

string

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

string

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

string

必要欄位。此貨運公司費率的運送起點。
percentage_adjustment

string

選用設定。乘法調節係數，以十進位標記法的形式表示。可以是負數。舉例來說，"5.4" 可將比率提高 5.4%，"-3" 則降低 3%。
flat_adjustment

Price

選用設定。附加運費調節係數。可以是負數。舉例來說，{ "amount_micros": 1, "currency_code" : "USD" } 會在稅率中加入 $1 美元，{ "amount_micros": -3, "currency_code" : "USD" } 則從稅率中移除 $3 美元。

ClaimHomepageRequest

ClaimHomepage 方法的要求訊息。

欄位
name

string

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

CreateAndConfigureAccountRequest

CreateAndConfigureAccount 方法的要求訊息。

欄位
account

Account

必要欄位。要建立的帳戶。
users[]

CreateUserRequest

選用設定。要加進帳戶的使用者。
service[]

AddAccountService

選用設定。如有指定，系統會在建立帳戶與提供者帳戶之間初始化帳戶服務。
accept_terms_of_service

AcceptTermsOfService

選用設定。帳戶建立後會立即接受的《服務條款》(ToS)。

AcceptTermsOfService

參照服務條款資源。

欄位
name

string

必要欄位。服務條款版本的資源名稱。
region_code

string

必要欄位。CLDR 定義的區碼。這可能是適用於該國家/地區特別適用的《服務條款》的國家/地區，或001適用於全球。

AddAccountService

建立帳戶服務時新增帳戶服務的其他操作說明。

欄位
聯集欄位 service_type。目前僅支援「多重客戶」上層帳戶類型。service_type 只能採用下列其中一種設定：
account_aggregation

Empty

供應商為帳戶的集結網站。
provider

string

選用設定。服務的供應商。格式：accounts/{account}

CreateRegionRequest

CreateRegion 方法的要求訊息。

欄位
parent

string

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

string

必要欄位。區域 ID，需與同一帳戶的所有區域中重複。
region

Region

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

CreateUserRequest

CreateUser 方法的要求訊息。

欄位
parent

string

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

string

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

User

必要欄位。要建立的使用者。

CustomerService

客戶服務資訊。

欄位
uri

string

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

string

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

PhoneNumber

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

CutoffTime

「工作天」截止時間定義。

欄位
hour

int32

必要欄位。訂單必須在同一天完成處理的截止時間 (小時)。
minute

int32

必要欄位。訂單必須在同一天完成處理的截止時間 (分鐘)。
time_zone

string

必要欄位。時區 ID，例如「歐洲/蘇黎世」。

DeleteAccountRequest

DeleteAccount 方法的要求訊息。

欄位
name

string

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

DeleteRegionRequest

DeleteRegion 方法的要求訊息。

欄位
name

string

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

DeleteUserRequest

DeleteUser 方法的要求訊息。

欄位
name

string

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

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

DeliveryTime

從訂購到產品出貨等各個面向所花費的時間。

欄位
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

選用設定。表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後，[運送時間][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應設定其他運送時間相關欄位。
min_transit_days

int32

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

int32

運送過程中花費的最長工作天數。0 表示當天到貨服務，1 代表次日到貨。必須大於或等於 min_transit_days。
cutoff_time

CutoffTime

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

int32

訂單出貨前經過的最短工作天數。0 表示出貨當天，1 代表隔天出貨。
max_handling_days

int32

訂單出貨前所花費的最長工作天數。0 表示出貨當天，1 代表隔天出貨。必須大於或等於 min_handling_days。
transit_time_table

TransitTable

運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。min_transit_days、max_transit_days 或 transit_time_table 都可以設定，但不能同時設定兩者。
handling_business_day_config

BusinessDayConfig

訂單處理期間 (工作天)。如未提供，系統會預設採用星期一至星期五的工作天。
transit_business_day_config

BusinessDayConfig

訂單可出貨的工作天。如未提供，系統會預設採用星期一至星期五的工作天。

DisableProgramRequest

停用 Program 方法的要求訊息。

欄位
name

string

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

距離

最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。

欄位
value

int64

距離的整數值。
unit

Unit

單位因國家/地區而異，參數則會調整為包含英里和公里。

Unit

單位因國家/地區而異，參數則會調整為包含英里和公里。

列舉
UNIT_UNSPECIFIED 未指定單位
MILES 單位 (英里)
KILOMETERS 單位 (公里)

EmailPreferences

使用者選擇接收 / 取消訂閱的通知類別。使用者無法取消訂閱，電子郵件接收設定不會包含強制公告。

欄位
name

string

ID。EmailPreferences 的名稱，只有通過驗證的使用者支援這個端點。
news_and_tips

OptInState

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

OptInState

啟用電子郵件接收設定。

列舉
OPT_IN_STATE_UNSPECIFIED 未指定採用狀態。
OPTED_OUT 使用者已選擇不接收這類電子郵件。
OPTED_IN 使用者已選擇接收這類電子郵件。
UNCONFIRMED 使用者已選擇接收這類電子郵件且確認電子郵件已寄出，但使用者尚未確認選擇加入 (僅適用於特定國家/地區)。

EnableProgramRequest

EnableProgram 方法的要求訊息。

欄位
name

string

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

GetAccountRequest

GetAccount 方法的要求訊息。

欄位
name

string

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

GetAccountTaxRequest

要求取得稅金設定

欄位
name

string

必要欄位。要擷取稅金設定的名稱

GetBusinessIdentityRequest

GetBusinessIdentity 方法的要求訊息。

欄位
name

string

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

GetBusinessInfoRequest

GetBusinessInfo 方法的要求訊息。

欄位
name

string

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

GetEmailPreferencesRequest

GetEmailPreferences 方法的要求訊息。

欄位
name

string

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

GetHomepageRequest

GetHomepage 方法的要求訊息。

欄位
name

string

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

GetOnlineReturnPolicyRequest

GetOnlineReturnPolicy 方法的要求訊息。

欄位
name

string

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

GetProgramRequest

GetProgram 方法的要求訊息。

欄位
name

string

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

GetRegionRequest

GetRegion 方法的要求訊息。

欄位
name

string

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

GetShippingSettingsRequest

GetShippingSetting 方法的要求訊息。

欄位
name

string

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

GetTermsOfServiceAgreementStateRequest

GetTermsOfServiceAgreementState 方法的要求訊息。

欄位
name

string

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

GetTermsOfServiceRequest

GetTermsOfService 方法的要求訊息。

欄位
name

string

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

GetUserRequest

GetUser 方法的要求訊息。

欄位
name

string

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

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

標頭

表格的資料列或欄標題清單不得為空白。必須明確設定 prices、weights、num_items、postal_code_group_names 或 location 其中之一。

欄位
prices[]

Price

必要欄位。包含訂單價格上限的清單。最終價格的值可以是無限的，只要設定 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 除外。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
weights[]

Weight

必要欄位。包含訂單權重上限的清單。最後一個重量的值可以設定 price amount_micros = -1，以無限值。舉例來說，[{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] 代表標頭「<= 10kg」、「<= 50kg」和 "> 50kg」。服務內的所有重量都必須具有相同的單位。不得空白。必須為正數，但 -1 除外。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
number_of_items[]

string

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

string

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

LocationIdSet

必要欄位。列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下，才能設定這些欄位。

首頁

商店首頁。

欄位
name

string

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

bool

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

string

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

InsertShippingSettingsRequest

InsertShippingSetting 方法的要求訊息。

欄位
parent

string

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

ShippingSettings

必要欄位。新版帳戶。

ListAccountIssuesRequest

ListAccountIssues 方法的要求訊息。

欄位
parent

string

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

int32

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

string

選用設定。屬於接收自前一個 ListAccountIssues 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

string

選用設定。回覆中的問題會包含指定語言的人類可讀的欄位。格式為 BCP-47，例如 en-US 或 sr-Latn。如未提供值，則會使用 en-US。
time_zone

TimeZone

選用設定。用來將時間本地化至人類可讀欄位的 IANA 時區。例如「America/Los_Angeles」。如未設定，則會使用「America/Los_Angeles」。

ListAccountIssuesResponse

ListAccountIssues 方法的回應訊息。

欄位
account_issues[]

AccountIssue

指定帳戶的問題。
next_page_token

string

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

ListAccountTaxRequest

要求只列出提出要求的商家所有子帳戶稅金設定。這個方法只能透過多重客戶帳戶呼叫，否則會傳回錯誤。

欄位
parent

string

必要欄位。負責收取帳戶稅金的母公司。格式：accounts/{account}
page_size

int32

回應中要傳回的稅金設定數量上限，用於分頁。
page_token

string

先前要求傳回的權杖。

ListAccountTaxResponse

回應帳戶稅金清單要求。 這個方法只能透過多重客戶帳戶呼叫，否則會傳回錯誤。

欄位
account_taxes[]

AccountTax

帳戶稅金設定頁面
next_page_token

string

用於擷取帳戶稅金設定下一頁的權杖。

ListAccountsRequest

ListAccounts 方法的要求訊息。

欄位
page_size

int32

選用設定。傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 250 個帳戶。最大值是 500；超過 500 的值將強制轉換成 500。
page_token

string

選用設定。屬於接收自前一個 ListAccounts 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

string

選用設定。選用篩選器，只傳回符合篩選條件的帳戶。

以下列舉幾個有效篩選器的範例：

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

帳戶層級的篩選器具有下列語意：

  • accountName這是指帳戶的「accountName」欄位。
  • relationship(...)表示此帳戶與其他帳戶有關係。在函式中，可進一步指定這個關係。

relationship 層級的篩選器具有下列語意：

  • providerId這是指與其他關係成員的帳戶數字 ID。舉例來說，如果篩選器應將篩選器限制在與帳戶 accounts/name/123 有關係的帳戶，則 providerId 應篩選為 providerId = 123。
  • callerHasAccessToProvider()這會限制最終帳戶，只有與另一個帳戶有關聯的帳戶，通話使用者也有權存取該關係的其他成員 (或供應商)。
  • externalAccountId是指為關係設定的外部帳戶 ID。
  • accountIdAlias這是指為關係設定的帳戶 ID 別名。
  • service(...) 是指在關係中提供的服務。注意：兩個帳戶之間的關係可包含多項服務。

service 層級的篩選器具有下列語意：

  • handshakeState 是指服務的握手狀態。建立服務後，有時需要取得對方關係 (或兩者) 的核准。因此，服務可以處於 PENDING 或 APPROVED 狀態。
  • type 是指服務類型。可能的值包括：
    • ACCOUNT_MANAGEMENT帳戶由供應商管理。
    • ACCOUNT_AGGREGATION 供應商為帳戶的集結網站。

這個篩選器遵循一部分 AIP 篩選器規格及其正式的 EBNF 文法。這個篩選器的文法更為嚴格且更詳細

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

其中包括：

  • 合併的每個欄位可能也只會出現一次 (例如在帳戶層級只能對 accountName 進行篩選一次，或者在各關係層級只能篩選出一次 providerId)。
  • 如為字串欄位 (例如 accountName 或 accountIdAlias)，您可以在 * 中納入查詢，以便表示 CONTAINS 運算子。舉例來說，accountName = "*foo*" 會傳回 accountName 包含 foo 的所有帳戶。或者，您可以使用 != 表示 NOT_CONTAINS 運算子。舉例來說，accountName != "*foo*" 會傳回 accountName 內「不含」 foo 的所有帳戶。注意：您可以使用 *** 搜尋 accountName 含有星號字元 * 的帳戶。
  • 系統會忽略多餘的空白。
  • 除了數值以外的所有值，必須用雙引號括住。
  • 如果使用分離，即使連接字元只有一個運算式，但兩端的連接都「必須」使用括號。除了函式叫用 (例如 relationship 或 service) 之外，其他區域都不得使用括號。這是為了清楚表示相互結合的強度大於邏輯規則。

ListAccountsResponse

ListAccounts 方法的回應訊息。

欄位
accounts[]

Account

與 ListAccountsRequest 相符的帳戶。
next_page_token

string

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

ListOnlineReturnPoliciesRequest

ListOnlineReturnPolicies 方法的要求訊息。

欄位
parent

string

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

int32

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

string

選用設定。屬於接收自前一個 ListOnlineReturnPolicies 呼叫的網頁權杖。提供頁面符記以擷取後續網頁。

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

ListOnlineReturnPoliciesResponse

ListOnlineReturnPolicies 方法的回應訊息。

欄位
online_return_policies[]

OnlineReturnPolicy

擷取的退貨政策。
next_page_token

string

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

ListProgramsRequest

ListPrograms 方法的要求訊息。

欄位
parent

string

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

int32

選用設定。單次回應傳回的程式數量上限。如果未指定 (或 0)，預設大小為 1000。許可的最大值為 1000；超出的數值將一律指定為 1000。
page_token

string

選用設定。從先前的 ListPrograms 呼叫接收的接續權杖。提供此項目即可擷取下一頁。

ListProgramsResponse

ListPrograms 方法的回應訊息。

欄位
programs[]

Program

指定帳戶的計劃。
next_page_token

string

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

ListRegionsRequest

ListRegions 方法的要求訊息。

欄位
parent

string

必要欄位。要列出所屬區域的帳戶。格式：accounts/{account}
page_size

int32

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

string

選用設定。屬於接收自前一個 ListRegions 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

ListRegionsResponse

ListRegions 方法的回應訊息。

欄位
regions[]

Region

指定商家的區域。
next_page_token

string

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

ListSubAccountsRequest

ListSubAccounts 方法的要求訊息。

欄位
provider

string

必要欄位。上層帳戶。格式：accounts/{account}
page_size

int32

選用設定。傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 250 個帳戶。最大值是 500；超過 500 的值將強制轉換成 500。
page_token

string

選用設定。屬於接收自前一個 ListAccounts 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

ListSubAccountsResponse

ListSubAccounts 方法的回應訊息。

欄位
accounts[]

Account

指定上層帳戶為集結網站的帳戶。
next_page_token

string

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

ListUsersRequest

ListUsers 方法的要求訊息。

欄位
parent

string

必要欄位。這個使用者集合所屬的父項。格式：「accounts/{account}」
page_size

int32

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

string

選用設定。屬於接收自前一個 ListUsers 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

ListUsersResponse

ListUsers 方法的回應訊息。

欄位
users[]

User

指定帳戶的使用者。
next_page_token

string

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

LocationIdSet

列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下，才能設定這些欄位。

欄位
location_ids[]

string

必要欄位。非空白的地區 ID 清單。它們必須是相同的位置類型 (例如州)。

MinimumOrderValueTable

取貨配送類型的個別商店最低訂單值表格。

欄位
store_code_set_with_movs[]

StoreCodeSetWithMov

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

StoreCodeSetWithMov

共用相同最低訂單價值的商店代碼組合清單。至少需要兩個集合，且最後一個必須留空，表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。

欄位
store_codes[]

string

選用設定。不重複的商家代碼清單，或空白代表所有商家。
value

Price

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

OnlineReturnPolicy

線上退貨政策物件。這目前是用來代表廣告和免費產品資訊計畫的退貨政策。

欄位
name

string

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

string

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

string

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

string

適用退貨政策的銷售國家/地區。值必須是有效的雙字母 ISO 3166 代碼。
policy

Policy

退貨政策。
restocking_fee

RestockingFee

適用於所有退貨原因類別的重新進貨費用。如未設定該值，我們會視為免費重新進貨費用。
return_methods[]

ReturnMethod

消費者退回商品的方式。除非退貨政策的類型為 noReturns，否則這個值不得留空。
item_conditions[]

ItemCondition

可退貨的商品條件不得為空白，除非退貨政策的類型為「noReturns」。
return_shipping_fee

ReturnShippingFee

退貨運費。請只在客戶需要下載及列印退貨單時時才設定。
return_policy_uri

string

退貨政策 URI。供 Google 執行政策的例行檢查。必須提供有效網址。
accept_defective_only

bool

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

int32

這個欄位會指定商家處理退款所需的天數，欄位則為選填。
accept_exchange

bool

這個欄位會指定商家是否允許客戶交換產品，這個欄位為必填欄位。

ItemCondition

可用的商品條件。

列舉
ITEM_CONDITION_UNSPECIFIED 預設值。這個值未使用。
NEW New.
USED 已使用。

政策

可用政策。

欄位
type

Type

政策類型。
days

int64

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

類型

退貨政策類型。

列舉
TYPE_UNSPECIFIED 預設值。這個值未使用。
NUMBER_OF_DAYS_AFTER_DELIVERY 退貨期限的天數。
NO_RETURNS 無法退貨。
LIFETIME_RETURNS 終身退貨。

RestockingFee

重新進貨費用。可以是固定費用或微百分比。

欄位

聯集欄位 type。

type 只能採用下列其中一種設定：
fixed_fee

Price

固定重新進貨費用。
micro_percent

int32

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

ReturnMethod

可用的傳回方法。

列舉
RETURN_METHOD_UNSPECIFIED 預設值。這個值未使用。
BY_MAIL 透過郵寄方式返回。
IN_STORE 店內退貨。
AT_A_KIOSK 返回資訊站。

ReturnShippingFee

退貨運費。這可以是固定費用或布林值，代表消費者要支付的實際運費。

欄位
type

Type

退貨運費類型。
fixed_fee

Price

固定退貨運費金額。只有在類型為 FIXED 時，才適用這個值。如果類型為 FIXED 且未設定這個值，系統會將退貨運費視為免費。

類型

退貨運費類型。

列舉
TYPE_UNSPECIFIED 預設值。這個值未使用。
FIXED 退貨運費是固定的值。
CUSTOMER_PAYING_ACTUAL_FEE 消費者須支付實際退貨運費。

PhoneVerificationState

電話驗證狀態。

列舉
PHONE_VERIFICATION_STATE_UNSPECIFIED 預設值。這個值未使用。
PHONE_VERIFICATION_STATE_VERIFIED 電話號碼已通過驗證。
PHONE_VERIFICATION_STATE_UNVERIFIED 手機未經驗證

計畫

定義指定帳戶的特定計畫。

計畫提供為商家帳戶新增功能的機制。常見的例子是「免費產品資訊」計畫，這項計畫可讓商家商店的產品免費在 Google 上顯示。

欄位
name

string

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

string

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

State

僅供輸出。計畫參與帳戶的參與狀態。
active_region_codes[]

string

僅供輸出。帳戶正在積極參與計畫的區域。活躍區域是指符合所有影響區域的計畫要求。

區域代碼由 CLDR 定義。這是指這項計畫專為該國家/地區建立，或計畫適用於全球的001。
unmet_requirements[]

Requirement

僅供輸出。因影響計畫參與資格而尚未取得帳戶要求。

需求

定義參與計劃的指定要求。

欄位
title

string

僅供輸出。要求名稱。
documentation_uri

string

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

string

僅供輸出。目前受這項規定影響的區域不符合相關規定。

區域代碼由 CLDR 定義。這是指這項計畫專為該國家/地區建立，或計畫適用於全球的001。

狀態

帳戶可能的計畫參與狀態。

列舉
STATE_UNSPECIFIED 預設值。這個值未使用。
NOT_ELIGIBLE 這個帳戶不符合參與計畫的資格。
ELIGIBLE 這個帳戶符合資格，可以參與計畫。
ENABLED 該帳戶已啟用這項計畫。

RateGroup

運送費率群組定義。只有最後一個項目可以含有空白的 applicable_shipping_labels，表示「其他」。其他applicable_shipping_labels不得重疊。

欄位
applicable_shipping_labels[]

string

必要欄位。運送標籤清單，用於定義這個費率群組適用的產品。這是假造：只有其中一個標籤必須相符，系統才能套用費率群組。只有服務的最後一個費率群組可以留空。
subtables[]

Table

選用設定。main_table 參照的子表格清單。只有在設定 main_table 時才能設定。
carrier_rates[]

CarrierRate

選用設定。main_table 或 single_value 可參照的貨運公司費率清單。
single_value

Value

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

Table

當 single_value 不夠明確時，定義費率群組的資料表。只有在未設定 single_value 時才能設定。
name

string

選用設定。費率群組名稱。此設定在運送服務中不得重複。

區域

代表地理區域，可供您同時做為 RegionalInventory 和 ShippingSettings 服務的目標使用。您可以將區域定義為郵遞區號集合，而在某些國家/地區，則可使用預先定義的指定地理區域。詳情請參閱「設定區域 」一文。

欄位
name

string

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

PostalCodeArea

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

GeoTargetArea

選用設定。一組定義區域的指定地理區域。
regional_inventory_eligible

BoolValue

僅供輸出。指出該區域是否符合使用區域商品目錄設定的資格。
shipping_eligible

BoolValue

僅供輸出。指出該區域是否符合用於運送服務設定的資格。
display_name

string

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

GeoTargetArea

一組定義區域的指定地理區域。

欄位
geotarget_criteria_ids[]

int64

必要欄位。非空白的地區 ID 清單。它們必須是相同的地點類型 (例如州/省)。

PostalCodeArea

定義區域的郵遞區號清單。注意：您可透過帳戶的 ShippingSettings.postalCodeGroups 資源存取所有使用郵遞區號定義的區域。

欄位
region_code

string

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

PostalCodeRange

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

PostalCodeRange

定義區域的郵遞區號範圍。

欄位
begin

string

必要欄位。郵遞區號或表單前置字元* 的模式，用於表示該區域的定義範圍包含的下限值。範例值：94108、9410*、9*。
end

string

選用設定。郵遞區號或格式 prefix* 的格式，用來表示用於定義區域範圍的包含上限。它的長度必須與 postalCodeRangeBegin 相同：如果 postalCodeRangeBegin 是郵遞區號，postalCodeRangeEnd 也必須為郵遞區號；如果 postalCodeRangeBegin 是模式，postalCodeRangeEnd 必須是相同前置字元長度的模式。選用：如未設定，則會將區域定義為符合 postalCodeRangeBegin 的所有郵遞區號。

需要

說明必須接受的服務條款。

欄位
terms_of_service

string

需接受的 termsOfService。
tos_file_uri

string

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

RetrieveForApplicationTermsOfServiceAgreementStateRequest

RetrieveForApplicationTermsOfServiceAgreementState 方法的要求訊息。

欄位
parent

string

必要欄位。要取得《TermsOfServiceBindingmentState 格式》的帳戶：accounts/{account}

RetrieveLatestTermsOfServiceRequest

RetrieveLatestTermsOfService 方法的要求訊息。

欄位
region_code

string

CLDR 定義的區碼。指特定國家/地區專屬《服務條款》即為 001 的國家/地區。
kind

TermsOfServiceKind

此服務條款版本的 Kind。

資料列

加入儲存格清單。

欄位
cells[]

Value

必要欄位。構成列的儲存格清單。二維資料表的長度必須與 columnHeaders 相同，單維資料表的長度須為 1。

服務

運送服務。

欄位
delivery_countries[]

string

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

RateGroup

選用設定。運送費率群組定義。只有最後一個項目可以含有空白的 applicable_shipping_labels，表示「其他」。其他applicable_shipping_labels不得重疊。
loyalty_programs[]

LoyaltyProgram

選用設定。這項運送服務僅適用於特定會員方案。
service_name

string

必要欄位。服務名稱 (形式不拘)，在目標帳戶中不得重複。
active

bool

必要欄位。顯示運送服務有效狀態的布林值。
currency_code

string

這項服務所適用貨幣的 CLDR 代碼。費率群組中的價格必須一致。
delivery_time

DeliveryTime

必要欄位。從訂購到產品出貨等各個面向所花費的時間。
shipment_type

ShipmentType

這項服務能運送訂單的目標地點類型。
minimum_order_value

Price

這項服務的最低訂單價值。指定時，表示客戶必須至少支付這個金額。一項服務中的所有價格都必須採用相同幣別。無法與 min_order_value_table 一起設定。
minimum_order_value_table

MinimumOrderValueTable

取貨配送類型的個別商店最低訂單值表格。無法與 min_order_value 一起設定。
store_config

StoreConfig

產品的運送來源清單。這只適用於本地運送運送類型。

LoyaltyProgram

商家提供的會員方案。

欄位
loyalty_program_tiers[]

LoyaltyProgramTiers

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

string

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

LoyaltyProgramTiers

商家會員方案子集。

欄位
tier_label

string

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

ShipmentType

運送服務類型。

列舉
SHIPMENT_TYPE_UNSPECIFIED 這項服務未指定運送類型。
DELIVERY 這項服務會將訂單寄到消費者選擇的地址。
LOCAL_DELIVERY 這項服務會將訂單寄到消費者選擇的地址。訂單商品會由附近的當地門市出貨。
COLLECTION_POINT 這項服務會將訂單寄到消費者選擇的地址。訂單會從取貨地點出貨。

StoreConfig

產品的運送來源清單。這只適用於本地運送運送類型。

欄位
store_codes[]

string

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

StoreServiceType

表示這個商家列出的所有商店或特定商店是否提供本地到貨服務。
cutoff_config

CutoffConfig

與當地配送相關的設定都會在當天結束。
service_radius

Distance

最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。

CutoffConfig

與當地配送相關的設定都會在當天結束。

欄位
local_cutoff_time

LocalCutoffTime

當天當地到貨的結束時間。
store_close_offset_hours

int64

僅限店面交車使用。以商店打烊前的時數表示截止時間。與 local_cutoff_time 互斥。
no_delivery_post_cutoff

bool

商家只要將運送服務設為本地到貨 n 天，即可選擇不顯示本地到貨 1 天以上。舉例來說，如果運送服務定義了當天到貨服務，且超過截止時間，將這個欄位設為 true，系統就會計算結果為 NO_DELIVERY_POST_CUTOFF 的運送服務費率。在相同的範例中，如果將這個欄位設為 false，計算的運送時間就是一天。這種提交方式僅適用於本地運送。

LocalCutoffTime

當天當地到貨的結束時間。

欄位
hour

int64

當地時間外送訂單必須在當天下單。
minute

int64

當地配送訂單 (分鐘) 必須於當天下單當天處理。

StoreServiceType

表示商家列出的商店或特定商店是否提供本地到貨服務。

列舉
STORE_SERVICE_TYPE_UNSPECIFIED 未指定商店服務類型。
ALL_STORES 表示這個商家列出的所有商店 (包括目前和未來商店) 是否提供店面運送。
SELECTED_STORES 表示只有store_codes中列出的商店可使用本地配送服務。

ShippingSettings

商家帳戶的 [運送設定](https://support.google.com/merchants/answer/6069284)。

欄位
name

string

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

Service

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

Warehouse

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

string

必要欄位。這個欄位可用於避免發生非同步問題。確認來電設定資料在接到來電與插入來電的時間不會改變。使用者必須執行下列步驟：

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

  2. 首次建立後，請呼叫 get 方法，在呼叫插入之前取得 eTag 和目前的運送設定資料。

  3. 想修改運送設定資訊。

  4. 使用步驟 2 取得的 etag 呼叫 insert 方法，並提供所需的運送設定資訊。

  5. 如果運送設定資料在步驟 2 到步驟 4 之間出現變動，每當運送設定資料變更時，eTag 就會變更，插入要求會失敗。使用者應使用新的 eTag 重複步驟 2 到 4。

資料表

當 single_value 不夠明確時，定義費率群組的資料表。

欄位
rows[]

Row

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

string

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

Headers

必要欄位。資料表中資料列的標題。
column_headers

Headers

資料表中的資料欄標頭。選用：如未設定，表格就只會顯示一個維度。

TaxRule

主要類型會議

微量百分比：100% = 1 000 000 和 1% = 10,000 不得為負數。

課稅關聯資訊和相關參數 (適用於送往單一稅務管理區域的訂單)。當商家在稅務管理員管理的領域內經營業務時，系統就會建立 Nexus 裝置 (只有美國各州支援關聯設定)。如果商家在美國州有課稅關聯，商家就必須向與運送目的地相關的所有稅務機關支付稅金。下一個 ID：8

欄位
region_code

string

適用這項規則的區域代碼
shipping_taxed

bool

完成設定後，送達該管理員所在地區時，運費就會課稅 (與產品相同)。只能設為不含類別的美國州別。
effective_time_period

Interval

必要欄位。這項規則的生效時間範圍。如果在清單所列的 Effective_time 中缺少時間長度，則會設為開放到未來。這段期間的開始時間不含時間值，但不包括結束時間。
聯集欄位 location。透過郵遞區號範圍或條件 ID 描述地區。location 只能是下列其中一項：
location_id

int64

適用此規則地區的 admin_id 或 requirements_id。
post_code_range

TaxPostalCodeRange

這項規則適用的郵遞區號範圍。
聯集欄位 rate_calculation。如何計算此管理員所在地區的外送稅率。只能設為美國州別。rate_calculation 只能是下列其中一項：
use_google_rate

bool

根據交貨地點而定的費率：如果商家與美國各州有課稅關聯，系統會新增管轄區與配送區域相比的稅率。
self_specified_rate_micros

int64

指定的固定費率，以微量為單位，其中 100% = 1_000_000。適用於以賣方所在地課稅的州。

TaxPostalCodeRange

定義區域的郵遞區號範圍。

欄位
start

string

必要欄位。郵遞區號範圍的開頭，同時也是範圍中的最小。
end

string

郵遞區號範圍的結尾。如未指定，會與 start 相同。

TermsOfService

TermsOfService。

欄位
name

string

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

string

CLDR 定義的區碼。這可能是《服務條款》專門適用於該國家/地區的國家/地區，或是001 (但同一個TermsOfService) 在任何國家/地區皆可登入。請注意，在簽署適用於全球的《服務條款》時，我們仍會要求你提供特定國家/地區 (必須為商家商家所在國家/地區或計畫參與國家/地區)。
kind

TermsOfServiceKind

此服務條款版本的 Kind。
external

bool

此服務條款版本是否為外部版本。外部服務條款版本只能透過外部程序達成，商家無法透過 UI 或 API 直接協議。
file_uri

string

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

TermsOfServiceAgreementState

這項資源代表指定帳戶的協議狀態和服務條款類型。狀態如下所示：

  • 如果商家已接受服務條款：系統會填入「已接受」，否則其中會留空
  • 如果商家必須簽署服務條款：系統會填入「必要」，否則系統會留空。

請注意，您可以同時顯示必填和接受兩種屬性。在這種情況下，accepted 服務條款的到期日為 valid_until 欄位中。您必須在 valid_until前接受「required」的服務條款，帳戶才能繼續簽訂有效協議。接受新的服務條款時，我們希望第三方顯示與指定服務條款協議相關的文字 (內含文字的檔案所在檔案的網址會在下方的「必要訊息」中新增為 tos_file_uri)。您只需在 TermsOfService 資源上呼叫接受，即可確實接受服務條款。

欄位
name

string

ID。服務條款版本的資源名稱。格式：accounts/{account}/termsOfServiceAgreementState/{identifier}
region_code

string

由 https://cldr.unicode.org/ 定義的區碼這是指目前所適用的國家/地區。
terms_of_service_kind

TermsOfServiceKind

與特定版本相關的服務條款種類。
accepted

Accepted

這種類型接受的服務條款以及相關 region_code 的服務條款
required

Required

必要的服務條款

TermsOfServiceKind

服務條款種類。

列舉
TERMS_OF_SERVICE_KIND_UNSPECIFIED 預設值。這個值未使用。
MERCHANT_CENTER Merchant Center 應用程式。

TransitTable

運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。min_transit_days、max_transit_days 或 transit_time_table 都可以設定，但不能同時設定兩者。

欄位
postal_code_group_names[]

string

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

string

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

TransitTimeRow

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

TransitTimeRow

如果只有一組維度組合 postal_code_group_names 或 transit_time_labels，則會有多個資料列，每個資料列都具有一個該維度的值。如果有兩個維度，則每列都會對應到 postal_code_group_names，而欄 (值) 則對應到 transit_time_labels。

欄位
values[]

TransitTimeValue

必要欄位。運送時間範圍 (最短至最長工作天)。

TransitTimeValue

運送時間範圍 (最短至最長工作天)。

欄位
min_transit_days

int32

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

int32

必須大於或等於 min_transit_days。

UnclaimHomepageRequest

UnclaimHomepage 方法的要求訊息。

欄位
name

string

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

UpdateAccountRequest

UpdateAccount 方法的要求訊息。

欄位
account

Account

必要欄位。新版帳戶。
update_mask

FieldMask

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

UpdateAccountTaxRequest

要求更新稅金設定

欄位
account_tax

AccountTax

必要欄位。要更新的稅金設定
update_mask

FieldMask

要更新的欄位清單

UpdateBusinessIdentityRequest

UpdateBusinessIdentity 方法的要求訊息。

欄位
business_identity

BusinessIdentity

必要欄位。新版商家身分。
update_mask

FieldMask

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

UpdateBusinessInfoRequest

UpdateBusinessInfo 方法的要求訊息。

欄位
business_info

BusinessInfo

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

FieldMask

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

UpdateEmailPreferencesRequest

UpdateEmailPreferences 方法的要求訊息。

欄位
email_preferences

EmailPreferences

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

FieldMask

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

UpdateHomepageRequest

UpdateHomepage 方法的要求訊息。

欄位
homepage

Homepage

必要欄位。新版首頁。
update_mask

FieldMask

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

UpdateRegionRequest

UpdateRegion 方法的要求訊息。

欄位
region

Region

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

FieldMask

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

UpdateUserRequest

UpdateUser 方法的要求訊息。

欄位
user

User

必要欄位。新版使用者。

您也可以使用 me (而非 accounts/{account}/users/me 中的名稱欄位) 來更新與呼叫者相對應的使用者。
update_mask

FieldMask

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

使用者

使用者。

欄位
name

string

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

State

僅供輸出。使用者的狀態。
access_rights[]

AccessRight

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

狀態

使用者可能的狀態。

列舉
STATE_UNSPECIFIED 預設值。這個值未使用。
PENDING 使用者尚待確認。在這種狀態下，使用者必須先接受邀請，才能執行其他動作。
VERIFIED 使用者已通過驗證。

價值

費率群組的單一值，或是費率群組表格儲存格的值。必須明確設定 no_shipping、flat_rate、price_percentage、carrier_rateName、subtable_name 其中之一。

欄位
no_shipping

bool

如果值為 true，產品將無法出貨。設定時必須設為 true，且只有在其他欄位皆未設定的情況下才能設定。
flat_rate

Price

固定費率。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
price_percentage

string

以十進位標記法 (例如 "5.4") 表示的價格百分比。只有在其他欄位未設定的情況下，才能設定。
carrier_rate

string

參照相同費率群組中定義的貨運公司費率的貨運公司費率名稱。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
subtable

string

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

Warehouse

出貨倉庫，用於儲存及處理庫存。下一個代碼：7

欄位
name

string

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

Address

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

WarehouseCutoffTime

必要欄位。訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。
handling_days

int64

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

BusinessDayConfig

倉庫的工作天。如未設定，預設為星期一至星期五。

WarehouseBasedDeliveryTime

表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後，delivery_time 中不應設定其他運送時間相關欄位。

欄位
carrier

string

必要欄位。電信業者，例如 "UPS" 或 "Fedex"。
carrier_service

string

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

string

必要欄位。倉儲名稱。這應符合 [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。

欄位
hour

int32

必要欄位。倉庫必須在同一天的訂單完成處理所需的截止時間。時數以倉庫時區為準。
minute

int32

必要欄位。倉庫必須在同一天提交訂單所需的處理時間，此為截止時間的分鐘數。分鐘數是以倉庫時區為準。