索引
AccountIssueService
(介面)AccountsService
(介面)BusinessIdentityService
(介面)BusinessInfoService
(介面)EmailPreferencesService
(介面)HomepageService
(介面)OnlineReturnPolicyService
(介面)ProgramsService
(介面)RegionsService
(介面)ShippingSettingsService
(介面)TermsOfServiceAgreementStateService
(介面)TermsOfServiceService
(介面)UserService
(介面)AcceptTermsOfServiceRequest
(訊息)Accepted
(訊息)AccessRight
(列舉)Account
(訊息)AccountIssue
(訊息)AccountIssue.ImpactedDestination
(訊息)AccountIssue.ImpactedDestination.Impact
(訊息)AccountIssue.Severity
(列舉)Address
(訊息)BusinessDayConfig
(訊息)BusinessDayConfig.Weekday
(列舉)BusinessIdentity
(訊息)BusinessIdentity.IdentityAttribute
(訊息)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(列舉)BusinessIdentity.PromotionsConsent
(列舉)BusinessInfo
(訊息)CarrierRate
(訊息)ClaimHomepageRequest
(訊息)CreateAndConfigureAccountRequest
(訊息)CreateAndConfigureAccountRequest.AcceptTermsOfService
(訊息)CreateAndConfigureAccountRequest.AddAccountService
(訊息)CreateRegionRequest
(訊息)CreateUserRequest
(訊息)CustomerService
(訊息)CutoffTime
(訊息)DeleteAccountRequest
(訊息)DeleteRegionRequest
(訊息)DeleteUserRequest
(訊息)DeliveryTime
(訊息)DisableProgramRequest
(訊息)Distance
(訊息)Distance.Unit
(列舉)EmailPreferences
(訊息)EmailPreferences.OptInState
(列舉)EnableProgramRequest
(訊息)GetAccountRequest
(訊息)GetBusinessIdentityRequest
(訊息)GetBusinessInfoRequest
(訊息)GetEmailPreferencesRequest
(訊息)GetHomepageRequest
(訊息)GetOnlineReturnPolicyRequest
(訊息)GetProgramRequest
(訊息)GetRegionRequest
(訊息)GetShippingSettingsRequest
(訊息)GetTermsOfServiceAgreementStateRequest
(訊息)GetTermsOfServiceRequest
(訊息)GetUserRequest
(訊息)Headers
(訊息)Homepage
(訊息)InsertShippingSettingsRequest
(訊息)ListAccountIssuesRequest
(訊息)ListAccountIssuesResponse
(訊息)ListAccountsRequest
(訊息)ListAccountsResponse
(訊息)ListOnlineReturnPoliciesRequest
(訊息)ListOnlineReturnPoliciesResponse
(訊息)ListProgramsRequest
(訊息)ListProgramsResponse
(訊息)ListRegionsRequest
(訊息)ListRegionsResponse
(訊息)ListSubAccountsRequest
(訊息)ListSubAccountsResponse
(訊息)ListUsersRequest
(訊息)ListUsersResponse
(訊息)LocationIdSet
(訊息)MinimumOrderValueTable
(訊息)MinimumOrderValueTable.StoreCodeSetWithMov
(訊息)OnlineReturnPolicy
(訊息)OnlineReturnPolicy.ItemCondition
(列舉)OnlineReturnPolicy.Policy
(訊息)OnlineReturnPolicy.Policy.Type
(列舉)OnlineReturnPolicy.RestockingFee
(訊息)OnlineReturnPolicy.ReturnMethod
(列舉)OnlineReturnPolicy.ReturnShippingFee
(訊息)OnlineReturnPolicy.ReturnShippingFee.Type
(列舉)PhoneVerificationState
(列舉)Program
(訊息)Program.Requirement
(訊息)Program.State
(列舉)RateGroup
(訊息)Region
(訊息)Region.GeoTargetArea
(訊息)Region.PostalCodeArea
(訊息)Region.PostalCodeArea.PostalCodeRange
(訊息)Required
(訊息)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(訊息)RetrieveLatestTermsOfServiceRequest
(訊息)Row
(訊息)Service
(訊息)Service.LoyaltyProgram
(訊息)Service.LoyaltyProgram.LoyaltyProgramTiers
(訊息)Service.ShipmentType
(列舉)Service.StoreConfig
(訊息)Service.StoreConfig.CutoffConfig
(訊息)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(訊息)Service.StoreConfig.StoreServiceType
(列舉)ShippingSettings
(訊息)Table
(訊息)TermsOfService
(訊息)TermsOfServiceAgreementState
(訊息)TermsOfServiceKind
(列舉)TransitTable
(訊息)TransitTable.TransitTimeRow
(訊息)TransitTable.TransitTimeRow.TransitTimeValue
(訊息)UnclaimHomepageRequest
(訊息)UpdateAccountRequest
(訊息)UpdateBusinessIdentityRequest
(訊息)UpdateBusinessInfoRequest
(訊息)UpdateEmailPreferencesRequest
(訊息)UpdateHomepageRequest
(訊息)UpdateRegionRequest
(訊息)UpdateUserRequest
(訊息)User
(訊息)User.State
(列舉)Value
(訊息)Warehouse
(訊息)WarehouseBasedDeliveryTime
(訊息)WarehouseCutoffTime
(訊息)
AccountIssueService
用於支援 AccountIssueService
API 的服務。
ListAccountIssues |
---|
列出 Merchant Center 帳戶的所有帳戶問題。
|
AccountsService
支援 Accounts API 的服務。
CreateAndConfigureAccount |
---|
建立包含額外設定的獨立 Merchant Center 帳戶。將提出要求的使用者新增為新帳戶的管理員。
|
DeleteAccount |
---|
刪除指定帳戶,不論類型為何:獨立、MCA 或子帳戶。刪除 MCA 會導致其所有子帳戶遭到刪除。需要管理員存取權才能執行這個方法。
|
GetAccount |
---|
從 Merchant Center 帳戶擷取帳戶。插入、更新或刪除帳戶後,您所做的變更可能需要幾分鐘才會生效。
|
ListAccounts |
---|
列出呼叫使用者可存取的帳戶,且符合要求的限制 (例如頁面大小或篩選條件)。這項功能不僅列出 MCA 的子帳戶,通話使用者也能存取所有帳戶,包括其他 MCA、已連結帳戶和獨立帳戶等。
|
ListSubAccounts |
---|
列出指定多重客戶帳戶的所有子帳戶。這是便利的包裝函式,適用於更強大的
|
UpdateAccount |
---|
可更新不限類型的帳戶:獨立、MCA 或子帳戶。需要管理員存取權才能執行這個方法。
|
BusinessIdentityService
支援企業身分 API 的服務。
GetBusinessIdentity |
---|
擷取帳戶的商家身分。
|
UpdateBusinessIdentity |
---|
更新帳戶的商家身分。需要管理員存取權才能執行這個方法。
|
BusinessInfoService
支援 Business Information API 的服務。
GetBusinessInfo |
---|
擷取帳戶的商家資訊。
|
UpdateBusinessInfo |
---|
更新帳戶的商家資訊。需要管理員存取權才能執行這個方法。
|
EmailPreferencesService
用於支援 EmailPreferences
API 的服務。
這項服務僅允許擷取及更新已驗證使用者的電子郵件偏好設定。
GetEmailPreferences |
---|
傳回 Merchant Center 帳戶使用者的電子郵件接收設定。 請使用 name=accounts/*/users/me/emailPreferences 別名取得已驗證使用者的偏好設定。
|
UpdateEmailPreferences |
---|
更新 Merchant Center 帳戶使用者的電子郵件接收設定。MCA 使用者應指定 MCA 帳戶,而非 MCA 的子帳戶。 未明確在更新遮罩中選取的偏好設定不會更新。 此更新對於指定 UNCONFIRMED 加入狀態值無效。 請使用 name=accounts/*/users/me/emailPreferences 別名更新已驗證使用者的偏好設定。
|
HomepageService
支援商店首頁 API 的服務。
ClaimHomepage |
---|
聲明商店首頁的擁有權。需要管理員存取權才能執行這個方法。 如果首頁已聲明擁有權,系統就會重新檢查驗證狀態。除非商家符合聲明資格,不必聲明擁有權,因而不必通過驗證,然後傳回成功的回應。如果無法驗證擁有權,系統會傳回錯誤,但不會撤銷版權聲明。如果失敗,系統會傳回標準錯誤訊息:* PERMISSION_DENIED:使用者沒有這個 Merchant Center 帳戶的必要權限;* FAILED_PRECONDITION:- 帳戶不是 Merchant Center 帳戶;- Merchant Center 帳戶沒有首頁- 聲明版權失敗 (在這種情況下,錯誤訊息將包含更多詳細資料)。
|
GetHomepage |
---|
擷取商店首頁。
|
UnclaimHomepage |
---|
取消聲明商店首頁的擁有權。需要管理員存取權才能執行這個方法。
|
UpdateHomepage |
---|
更新商店的首頁。需要管理員存取權才能執行這個方法。
|
OnlineReturnPolicyService
這項服務協助商家管理商家懊悔退貨政策設定,並在廣告和免費產品資訊中提供退貨政策
計畫。這個 API 定義了下列資源模型:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
取得現有的退貨政策。
|
ListOnlineReturnPolicies |
---|
列出所有現有的退貨政策。
|
ProgramsService
計畫管理的服務。
計畫提供為商家帳戶新增功能的機制。常見的例子是「免費產品資訊」計畫,這項計畫可讓商家商店的產品免費在 Google 上顯示。
除了明確啟用或停用各項計畫的方法之外,這項服務還提供擷取商家參與所有可用計畫的方法。
DisableProgram |
---|
停止讓帳戶參與特定計畫。需要管理員存取權才能執行這個方法。
|
EnableProgram |
---|
允許帳戶參與特定計畫。需要管理員存取權才能執行這個方法。
|
GetProgram |
---|
擷取帳戶的特定程式。
|
ListPrograms |
---|
擷取帳戶的所有計畫。
|
RegionsService
管理區域設定。
這個 API 定義了下列資源模型:
Region
CreateRegion |
---|
在 Merchant Center 帳戶中建立區域定義。需要管理員存取權才能執行這個方法。
|
DeleteRegion |
---|
從 Merchant Center 帳戶中刪除區域定義。需要管理員存取權才能執行這個方法。
|
GetRegion |
---|
擷取 Merchant Center 帳戶中定義的區域。
|
ListRegions |
---|
列出 Merchant Center 帳戶中的區域。
|
UpdateRegion |
---|
在 Merchant Center 帳戶中更新區域定義。需要管理員存取權才能執行這個方法。
|
ShippingSettingsService
根據 Merchant API 方法取得方法呼叫運送設定資訊的服務。
GetShippingSettings |
---|
擷取運送設定資訊。
|
InsertShippingSettings |
---|
將商家的運送設定換成要求的運送設定。需要管理員存取權才能執行這個方法。
|
TermsOfServiceAgreementStateService
用於支援 TermsOfServiceAgreementState
API 的服務。
GetTermsOfServiceAgreementState |
---|
傳回服務條款協議的狀態。
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
擷取應用程式服務條款的協議狀態。
|
TermsOfServiceService
用於支援 TermsOfService
API 的服務。
AcceptTermsOfService |
---|
接受
|
GetTermsOfService |
---|
擷取與指定版本相關聯的
|
RetrieveLatestTermsOfService |
---|
針對特定
|
UserService
用來支援使用者 API 的服務。
CreateUser |
---|
建立 Merchant Center 帳戶使用者。需要管理員存取權才能執行這個方法。
|
DeleteUser |
---|
刪除 Merchant Center 帳戶使用者。需要管理員存取權才能執行這個方法。
|
GetUser |
---|
擷取 Merchant Center 帳戶使用者。
|
ListUsers |
---|
列出 Merchant Center 帳戶的所有使用者。
|
UpdateUser |
---|
更新 Merchant Center 帳戶使用者。需要管理員存取權才能執行這個方法。
|
AcceptTermsOfServiceRequest
AcceptTermsOfService
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。服務條款版本的資源名稱。格式: |
account |
必要欄位。接受《服務條款》的帳戶。 |
region_code |
必要欄位。CLDR 定義的區碼。指特定國家/地區專屬《服務條款》即為 001 的國家/地區。 |
已接受
說明系統接受的服務條款。
欄位 | |
---|---|
terms_of_service |
接受的 termsOfService。 |
accepted_by |
記錄接受資訊的帳戶。可以是帳戶本身;如果是子帳戶,則可輸入 MCA 帳戶。 |
valid_until |
設定後,代表接受的 TermsOfService 僅在此日期結束 (世界標準時間) 為止。你必須在上述日期前接受新的 PIN 碼。您可以在「必要」訊息中找到必要 TermsOfService 資訊。 |
AccessRight
。
列舉 | |
---|---|
ACCESS_RIGHT_UNSPECIFIED |
預設值。這個值未使用。 |
STANDARD |
標準存取權限。 |
ADMIN |
管理員權限。 |
PERFORMANCE_REPORTING |
具備這項權限的使用者可存取成效和洞察資料。 |
帳戶
擁有帳戶。
欄位 | |
---|---|
name |
ID。帳戶的資源名稱。格式: |
account_id |
僅供輸出。帳戶的 ID。 |
account_name |
|
adult_content |
此帳戶是否包含成人內容。 |
test_account |
僅供輸出。這是否為測試帳戶。 |
time_zone |
必要欄位。帳戶時區。 在寫入時, 對於讀取作業, |
language_code |
必要欄位。帳戶的 BCP-47 語言代碼,例如 |
AccountIssue
欄位 | |
---|---|
name |
ID。帳戶問題的資源名稱。格式: |
title |
問題的本地化標題。 |
severity |
問題的整體嚴重性。 |
impacted_destinations[] |
這個問題對多個目的地的影響。 |
detail |
關於問題的本地化詳細資料。 |
documentation_uri |
Merchant Center 說明中心連結,提供關於問題和修正方式的進一步資訊。 |
ImpactedDestination
問題對到達網頁的影響。
欄位 | |
---|---|
impacts[] |
對指定目的地多個區域的影響 (負數)。 |
reporting_context |
受影響的報表結構定義。 |
影響
問題對區域的影響。
欄位 | |
---|---|
region_code |
適用於這個問題的 CLDR 區域代碼。 |
severity |
問題在目的地和地區的嚴重性。 |
嚴重性
所有可能的問題嚴重性。
列舉 | |
---|---|
SEVERITY_UNSPECIFIED |
嚴重性不明。 |
CRITICAL |
原因會導致商品無法放送。 |
ERROR |
這個問題日後可能會影響優惠,或可能是商品有問題的指標。 |
SUGGESTION |
這個問題是可改善的建議。 |
地址
倉庫的運送地址。
欄位 | |
---|---|
street_address |
地址的街道層級。例如 |
city |
必要欄位。城市、鄉鎮或縣市。也可能包含附屬區域或鄉鎮市區 (例如社區或郊區)。 |
administrative_area |
必要欄位。國家/地區的頂層行政劃分。例如加州 (「CA」) 或魁北克省 (「QC」)。 |
postal_code |
必要欄位。郵遞區號 (例如「94043」)。 |
region_code |
必要欄位。CLDR 國家/地區代碼 (例如「US」)。 |
BusinessDayConfig
倉庫的工作天。
欄位 | |
---|---|
business_days[] |
必要欄位。一般工作天。不得留空。 |
平日
列舉 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
BusinessIdentity
商家身分相關資訊的收集。
欄位 | |
---|---|
name |
ID。商家身分的資源名稱。格式: |
promotions_consent |
選用設定。身分屬性是否可用於促銷活動。 |
black_owned |
選用設定。指明商家是否自稱為黑人。這個選填欄位僅適用於商家所在國家/地區設為「 |
women_owned |
選用設定。指明商家是否自稱為女性。這個選填欄位僅適用於商家所在國家/地區設為「 |
veteran_owned |
選用設定。指明商家是否自稱為退伍軍人。這個選填欄位僅適用於商家所在國家/地區設為「 |
latino_owned |
選用設定。指出商家是否自稱業主為拉丁裔。這個選填欄位僅適用於商家所在國家/地區設為「 |
small_business |
選用設定。指出商家是否自稱為小型企業。這個選填欄位僅適用於商家所在國家/地區設為「 |
IdentityAttribute
與身分屬性相關的所有資訊。
欄位 | |
---|---|
identity_declaration |
必要欄位。這個屬性的身分宣告。 |
IdentityDeclaration
所有與身分宣告相關的設定。
列舉 | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
此預設值表示未選取任何項目。 |
SELF_IDENTIFIES_AS |
表示帳戶可用屬性識別。 |
DOES_NOT_SELF_IDENTIFY_AS |
表示帳戶無法識別此屬性。 |
PromotionsConsent
所有與商家身分相關的促銷活動設定。
列舉 | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
此預設值表示未選取任何項目。 |
PROMOTIONS_CONSENT_GIVEN |
表示帳戶已同意將自己的商家身分用於促銷活動。 |
PROMOTIONS_CONSENT_DENIED |
表示帳戶未同意將商家身分用於促銷活動。 |
BusinessInfo
商家相關資訊集合。
欄位 | |
---|---|
name |
ID。商家資訊的資源名稱。格式: |
address |
選用設定。商家的地址。 |
phone |
僅供輸出。商家的電話號碼。 |
phone_verification_state |
僅供輸出。商家的電話驗證狀態。 |
customer_service |
選用設定。商家的客戶服務。 |
korean_business_registration_number |
選用設定。10 位數的韓國商業登記號碼,以破折號分隔,格式為:XXX-XX-XXXXX。 |
CarrierRate
main_table
或 single_value
可參照的貨運公司費率清單。
欄位 | |
---|---|
name |
必要欄位。貨運公司費率的名稱。每個費率群組的名稱不得重複。 |
carrier |
必要欄位。電信業者服務,例如 |
carrier_service |
必要欄位。電信業者服務,例如 |
origin_postal_code |
必要欄位。此貨運公司費率的運送起點。 |
percentage_adjustment |
選用設定。乘法調節係數,以十進位標記法的形式表示。可以是負數。舉例來說, |
flat_adjustment |
選用設定。附加運費調節係數。可以是負數。舉例來說, |
ClaimHomepageRequest
ClaimHomepage
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要聲明擁有權的首頁名稱。格式: |
CreateAndConfigureAccountRequest
CreateAndConfigureAccount
方法的要求訊息。
欄位 | |
---|---|
account |
必要欄位。要建立的帳戶。 |
users[] |
選用設定。要加進帳戶的使用者。 |
service[] |
必要欄位。在建立過程中,系統會初始化帳戶與供應商帳戶之間的帳戶服務。必須提供至少一項這類服務。目前僅支援 |
accept_terms_of_service |
選用設定。帳戶建立後會立即接受的《服務條款》(ToS)。 |
AcceptTermsOfService
參照服務條款資源。
欄位 | |
---|---|
name |
必要欄位。服務條款版本的資源名稱。 |
region_code |
必要欄位。CLDR 定義的區碼。這可能是適用於該國家/地區特別適用的《服務條款》的國家/地區, |
AddAccountService
建立帳戶服務時新增帳戶服務的其他操作說明。
欄位 | |
---|---|
聯集欄位 service_type 。目前僅支援「多重客戶」上層帳戶類型。service_type 只能採用下列其中一種設定: |
|
account_aggregation |
供應商為帳戶的集結網站。 |
provider |
選用設定。服務的供應商。格式: |
CreateRegionRequest
CreateRegion
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要建立區域的帳戶。格式: |
region_id |
必要欄位。區域 ID,需與同一帳戶的所有區域中重複。 |
region |
必要欄位。要建立的區域。 |
CreateUserRequest
CreateUser
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要建立使用者的帳戶資源名稱。格式: |
user_id |
必要欄位。使用者的電子郵件地址 (例如 |
user |
必要欄位。要建立的使用者。 |
CustomerService
客戶服務資訊。
欄位 | |
---|---|
uri |
選用設定。可以找到客戶服務的 URI。 |
email |
選用設定。可以聯絡到客戶服務的電子郵件地址。 |
phone |
選用設定。可以撥打客戶服務的電話號碼。 |
CutoffTime
「工作天」截止時間定義。
欄位 | |
---|---|
hour |
必要欄位。訂單必須在同一天完成處理的截止時間 (小時)。 |
minute |
必要欄位。訂單必須於同一天完成處理的截止時間 (分鐘)。 |
time_zone |
必要欄位。時區 ID,例如「歐洲/蘇黎世」。 |
DeleteAccountRequest
DeleteAccount
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要刪除的帳戶名稱。格式: |
DeleteRegionRequest
DeleteRegion
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要刪除的區域名稱。格式: |
DeleteUserRequest
DeleteUser
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要刪除的使用者名稱。格式: 您也可以使用 |
DeliveryTime
從訂購到產品出貨等各個面向所花費的時間。
欄位 | |
---|---|
warehouse_based_delivery_times[] |
選用設定。表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後,[運送時間][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應設定其他運送時間相關欄位。 |
min_transit_days |
運送過程中的最短工作天數。0 表示當天到貨服務,1 代表次日到貨。必須設定 |
max_transit_days |
運送過程中花費的最長工作天數。0 表示當天到貨服務,1 代表次日到貨。必須大於或等於 |
cutoff_time |
「工作天」截止時間定義。如未設定,截止時間會預設為太平洋標準時間上午 8 點。 |
min_handling_days |
訂單出貨前經過的最短工作天數。0 表示出貨當天,1 代表隔天出貨。 |
max_handling_days |
訂單出貨前所花費的最長工作天數。0 表示出貨當天,1 代表隔天出貨。必須大於或等於 |
transit_time_table |
運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。 |
handling_business_day_config |
訂單處理期間 (工作天)。如未提供,系統會預設採用星期一至星期五的工作天。 |
transit_business_day_config |
訂單可出貨的工作天。如未提供,系統會預設採用星期一至星期五的工作天。 |
DisableProgramRequest
停用 Program 方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。停用特定帳戶參與計畫的計畫名稱。格式: |
距離
最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。
欄位 | |
---|---|
value |
距離的整數值。 |
unit |
單位因國家/地區而異,參數則會調整為包含英里和公里。 |
單位
單位因國家/地區而異,參數則會調整為包含英里和公里。
列舉 | |
---|---|
UNIT_UNSPECIFIED |
未指定單位 |
MILES |
單位 (英里) |
KILOMETERS |
單位 (公里) |
EmailPreferences
使用者選擇接收 / 取消訂閱的通知類別。使用者無法取消訂閱,電子郵件接收設定不會包含強制公告。
欄位 | |
---|---|
name |
ID。EmailPreferences 的名稱,只有通過驗證的使用者支援這個端點。 |
news_and_tips |
選用設定。新功能、提示和最佳做法的最新消息。 |
OptInState
啟用電子郵件接收設定。
列舉 | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
未指定採用狀態。 |
OPTED_OUT |
使用者已選擇不接收這類電子郵件。 |
OPTED_IN |
使用者已選擇接收這類電子郵件。 |
UNCONFIRMED |
使用者已選擇接收這類電子郵件且確認電子郵件已寄出,但使用者尚未確認選擇加入 (僅適用於特定國家/地區)。 |
EnableProgramRequest
EnableProgram 方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。為特定帳戶啟用計畫的計畫名稱。格式: |
GetAccountRequest
GetAccount
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的帳戶名稱。格式: |
GetBusinessIdentityRequest
GetBusinessIdentity
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。商家身分的資源名稱。格式: |
GetBusinessInfoRequest
GetBusinessInfo
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。商家資訊的資源名稱。格式: |
GetEmailPreferencesRequest
GetEmailPreferences 方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。 |
GetHomepageRequest
GetHomepage
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的首頁名稱。格式: |
GetOnlineReturnPolicyRequest
GetOnlineReturnPolicy
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的退貨政策名稱。格式: |
GetProgramRequest
GetProgram 方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的程式名稱。格式: |
GetRegionRequest
GetRegion
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的區域名稱。格式: |
GetShippingSettingsRequest
GetShippingSetting
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的運送設定名稱。格式: |
GetTermsOfServiceAgreementStateRequest
GetTermsOfServiceAgreementState
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。服務條款版本的資源名稱。格式: |
GetTermsOfServiceRequest
GetTermsOfService
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。服務條款版本的資源名稱。格式: |
GetUserRequest
GetUser
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要擷取的使用者名稱。格式: 您也可以使用 |
標頭
表格的資料列或欄標題清單不得為空白。必須明確設定 prices
、weights
、num_items
、postal_code_group_names
或 location
其中之一。
欄位 | |
---|---|
prices[] |
必要欄位。包含訂單價格上限的清單。最終價格的值可以是無限的,只要設定 price amount_micros = -1 即可。舉例來說, |
weights[] |
必要欄位。包含訂單權重上限的清單。最後一個重量的值可以設定 price amount_micros = -1,以無限值。舉例來說, |
number_of_items[] |
必要欄位。包含項目數量上限的清單。最後一個值可以是 |
postal_code_group_names[] |
必要欄位。郵政群組名稱清單。最後一個值可以是 |
locations[] |
必要欄位。列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下,才能設定這些欄位。 |
首頁
商店首頁。
欄位 | |
---|---|
name |
ID。商店首頁的資源名稱。格式: |
claimed |
僅供輸出。是否聲明首頁的擁有權。詳情請參閱 https://support.google.com/merchants/answer/176793。 |
uri |
必要欄位。商店首頁的 URI (通常是網址)。 |
InsertShippingSettingsRequest
InsertShippingSetting
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要插入這項產品的帳戶。格式:accounts/{account} |
shipping_setting |
必要欄位。新版帳戶。 |
ListAccountIssuesRequest
ListAccountIssues
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。這個問題集合的父項。格式: |
page_size |
選用設定。要傳回的問題數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 50 位使用者。值的上限為 100;超過 100 個值會強制轉換為 100 |
page_token |
選用設定。屬於接收自前一個 進行分頁時,提供至 |
language_code |
選用設定。回覆中的問題會包含指定語言的人類可讀的欄位。格式為 BCP-47,例如 |
time_zone |
選用設定。用來將時間本地化至人類可讀欄位的 IANA 時區。例如「America/Los_Angeles」。如果不設定,「America/Los_Angeles」 |
ListAccountIssuesResponse
ListAccountIssues
方法的回應訊息。
欄位 | |
---|---|
account_issues[] |
指定帳戶的問題。 |
next_page_token |
可做為 |
ListAccountsRequest
ListAccounts
方法的要求訊息。
欄位 | |
---|---|
page_size |
選用設定。傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 250 個帳戶。值的上限為 500;系統會將超過 500 個值強制轉換為 500。 |
page_token |
選用設定。屬於接收自前一個 進行分頁時,提供至 |
filter |
|
ListAccountsResponse
ListAccounts
方法的回應訊息。
欄位 | |
---|---|
accounts[] |
與 |
next_page_token |
可做為 |
ListOnlineReturnPoliciesRequest
ListOnlineReturnPolicies
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要列出退貨政策的商家帳戶。格式: |
page_size |
選用設定。要傳回的 |
page_token |
選用設定。屬於接收自前一個 進行分頁時,提供至 |
ListOnlineReturnPoliciesResponse
ListOnlineReturnPolicies
方法的回應訊息。
欄位 | |
---|---|
online_return_policies[] |
擷取的退貨政策。 |
next_page_token |
可做為 |
ListProgramsRequest
ListPrograms 方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要擷取所有程式的帳戶名稱。格式: |
page_size |
選用設定。單次回應傳回的程式數量上限。如果未指定 (或 0),預設大小為 1000。許可的最大值是 1000;超過 1000 個值會強制轉換為 1000。 |
page_token |
選用設定。從先前的 |
ListProgramsResponse
ListPrograms 方法的回應訊息。
欄位 | |
---|---|
programs[] |
指定帳戶的計劃。 |
next_page_token |
可做為 |
ListRegionsRequest
ListRegions
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要列出所屬區域的帳戶。格式: |
page_size |
選用設定。要傳回的區域數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 50 個區域。許可的最大值是 1000;超過 1000 個值會強制轉換為 1000。 |
page_token |
選用設定。屬於接收自前一個 進行分頁時,提供至 |
ListRegionsResponse
ListRegions
方法的回應訊息。
欄位 | |
---|---|
regions[] |
指定商家的區域。 |
next_page_token |
可做為 |
ListSubAccountsRequest
ListSubAccounts
方法的要求訊息。
欄位 | |
---|---|
provider |
必要欄位。上層帳戶。格式: |
page_size |
選用設定。傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 250 個帳戶。值的上限為 500;系統會將超過 500 個值強制轉換為 500。 |
page_token |
選用設定。屬於接收自前一個 進行分頁時,提供至 |
ListSubAccountsResponse
ListSubAccounts
方法的回應訊息。
欄位 | |
---|---|
accounts[] |
指定上層帳戶為集結網站的帳戶。 |
next_page_token |
可做為 |
ListUsersRequest
ListUsers
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。這個使用者集合所屬的父項。格式: |
page_size |
選用設定。回訪者人數上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 50 位使用者。值的上限為 100;超過 100 個值會強制轉換為 100 |
page_token |
選用設定。屬於接收自前一個 進行分頁時,提供至 |
ListUsersResponse
ListUsers
方法的回應訊息。
欄位 | |
---|---|
users[] |
指定帳戶的使用者。 |
next_page_token |
可做為 |
LocationIdSet
列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下,才能設定這些欄位。
欄位 | |
---|---|
location_ids[] |
必要欄位。非空白的地區 ID 清單。它們必須是相同的位置類型 (例如州)。 |
MinimumOrderValueTable
取貨配送類型的個別商店最低訂單值表格。
欄位 | |
---|---|
store_code_set_with_movs[] |
必要欄位。共用相同最低訂單價值 (MOV) 的商店代碼集清單。至少需要兩個集合,且最後一個必須留空,表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。 |
StoreCodeSetWithMov
共用相同最低訂單價值的商店代碼組合清單。至少需要兩個集合,且最後一個必須留空,表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。
欄位 | |
---|---|
store_codes[] |
選用設定。不重複的商家代碼清單,或空白代表所有商家。 |
value |
指定商店的最低訂單價值。 |
OnlineReturnPolicy
線上退貨政策物件。這目前是用來代表廣告和免費產品資訊計畫的退貨政策。
欄位 | |
---|---|
name |
ID。 |
return_policy_id |
僅供輸出。Google 產生的退貨政策 ID。 |
label |
這個欄位代表退貨政策的專屬使用者定義標籤。請注意,同一個標籤不得用於同一國家/地區的不同退貨政策。除非產品指定了特定的標籤屬性,否則政策會自動標示為「default」。如要為特定產品群組指派自訂退貨政策,請按照退貨政策標籤中的指示操作。標籤的長度上限為 50 個半形字元。 |
countries[] |
適用退貨政策的銷售國家/地區。值必須是有效的雙字母 ISO 3166 代碼。 |
policy |
退貨政策。 |
restocking_fee |
適用於所有退貨原因類別的重新進貨費用。如未設定該值,我們會視為免費重新進貨費用。 |
return_methods[] |
消費者退回商品的方式。除非退貨政策的類型為 noReturns,否則這個值不得留空。 |
item_conditions[] |
可退貨的商品條件不得為空白,除非退貨政策的類型為「noReturns」。 |
return_shipping_fee |
退貨運費。請只在客戶需要下載及列印退貨單時時才設定。 |
return_policy_uri |
退貨政策 URI。供 Google 執行政策的例行檢查。必須提供有效網址。 |
accept_defective_only |
這個欄位可用來指定商家是否只接受瑕疵產品退貨,且這個欄位為必填欄位。 |
process_refund_days |
這個欄位會指定商家處理退款所需的天數,欄位則為選填。 |
accept_exchange |
這個欄位會指定商家是否允許客戶交換產品,這個欄位為必填欄位。 |
ItemCondition
可用的商品條件。
列舉 | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
預設值。這個值未使用。 |
NEW |
New. |
USED |
已使用。 |
政策
可用政策。
欄位 | |
---|---|
type |
政策類型。 |
days |
商品可在送達後退貨的天數,其中一天的定義為送達時間戳記後的 24 小時。 |
類型
退貨政策類型。
列舉 | |
---|---|
TYPE_UNSPECIFIED |
預設值。這個值未使用。 |
NUMBER_OF_DAYS_AFTER_DELIVERY |
退貨期限的天數。 |
NO_RETURNS |
無法退貨。 |
LIFETIME_RETURNS |
終身退貨。 |
RestockingFee
重新進貨費用。可以是固定費用或微百分比。
欄位 | |
---|---|
聯集欄位
|
|
fixed_fee |
固定重新進貨費用。 |
micro_percent |
總價的百分比 (以百萬分之一為單位)。15,000,000 代表系統會收取總價的 15%。 |
ReturnMethod
可用的傳回方法。
列舉 | |
---|---|
RETURN_METHOD_UNSPECIFIED |
預設值。這個值未使用。 |
BY_MAIL |
透過郵寄方式返回。 |
IN_STORE |
店內退貨。 |
AT_A_KIOSK |
返回資訊站。 |
ReturnShippingFee
退貨運費。這可以是固定費用或布林值,代表消費者要支付的實際運費。
欄位 | |
---|---|
type |
退貨運費類型。 |
fixed_fee |
固定退貨運費金額。只有在類型為 |
類型
退貨運費類型。
列舉 | |
---|---|
TYPE_UNSPECIFIED |
預設值。這個值未使用。 |
FIXED |
退貨運費是固定的值。 |
CUSTOMER_PAYING_ACTUAL_FEE |
消費者須支付實際退貨運費。 |
PhoneVerificationState
電話驗證狀態。
列舉 | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
預設值。這個值未使用。 |
PHONE_VERIFICATION_STATE_VERIFIED |
電話號碼已通過驗證。 |
PHONE_VERIFICATION_STATE_UNVERIFIED |
手機未經驗證 |
計畫
定義指定帳戶的特定計畫。
計畫提供為商家帳戶新增功能的機制。常見的例子是「免費產品資訊」計畫,這項計畫可讓商家商店的產品免費在 Google 上顯示。
欄位 | |
---|---|
name |
ID。方案的資源名稱。格式: |
documentation_uri |
僅供輸出。計畫的 Merchant Center 說明頁面網址。 |
state |
僅供輸出。計畫參與帳戶的參與狀態。 |
active_region_codes[] |
僅供輸出。帳戶正在參與計畫的區域。活躍區域是指符合所有影響區域的計畫要求。 區域代碼由 CLDR 定義。這是指這項計畫專為該國家/地區建立,或計畫適用於全球的 |
unmet_requirements[] |
僅供輸出。因影響計畫參與資格而尚未取得帳戶要求。 |
需求
定義參與計劃的指定要求。
欄位 | |
---|---|
title |
僅供輸出。要求名稱。 |
documentation_uri |
僅供輸出。說明規定的說明頁面網址。 |
affected_region_codes[] |
僅供輸出。目前受這項規定影響的區域不符合相關規定。 區域代碼由 CLDR 定義。這是指這項計畫專為該國家/地區建立,或計畫適用於全球的 |
州
帳戶可能的計畫參與狀態。
列舉 | |
---|---|
STATE_UNSPECIFIED |
預設值。這個值未使用。 |
NOT_ELIGIBLE |
這個帳戶不符合參與計畫的資格。 |
ELIGIBLE |
這個帳戶符合資格,可以參與計畫。 |
ENABLED |
該帳戶已啟用這項計畫。 |
RateGroup
運送費率群組定義。只有最後一個項目可以含有空白的 applicable_shipping_labels
,表示「其他」。其他applicable_shipping_labels
不得重疊。
欄位 | |
---|---|
applicable_shipping_labels[] |
必要欄位。運送標籤清單,用於定義這個費率群組適用的產品。這是假造:只有其中一個標籤必須相符,系統才能套用費率群組。只有服務的最後一個費率群組可以留空。 |
subtables[] |
選用設定。 |
carrier_rates[] |
選用設定。 |
single_value |
費率群組的值 (例如固定費率 $10 美元)。只有在未設定 |
main_table |
當 |
name |
選用設定。費率群組名稱。此設定在運送服務中不得重複。 |
區域
代表地理區域,可供您同時做為 RegionalInventory
和 ShippingSettings
服務的目標使用。您可以將區域定義為郵遞區號集合,而在某些國家/地區,則可使用預先定義的指定地理區域。詳情請參閱「設定區域 」一文。
欄位 | |
---|---|
name |
ID。區域的資源名稱。格式: |
postal_code_area |
選用設定。定義區域的郵遞區號清單。 |
geotarget_area |
選用設定。一組定義區域的指定地理區域。 |
regional_inventory_eligible |
僅供輸出。指出該區域是否符合使用區域商品目錄設定的資格。 |
shipping_eligible |
僅供輸出。指出該區域是否符合用於運送服務設定的資格。 |
display_name |
選用設定。區域的顯示名稱。 |
GeoTargetArea
一組定義區域的指定地理區域。
欄位 | |
---|---|
geotarget_criteria_ids[] |
必要欄位。非空白的地區 ID 清單。它們必須是相同的地點類型 (例如州/省)。 |
PostalCodeArea
定義區域的郵遞區號清單。注意:您可透過帳戶的 ShippingSettings.postalCodeGroups
資源存取所有使用郵遞區號定義的區域。
欄位 | |
---|---|
region_code |
必要欄位。CLDR 地域代碼,或郵遞區號群組適用的國家/地區。 |
postal_codes[] |
必要欄位。郵遞區號範圍。 |
PostalCodeRange
定義區域的郵遞區號範圍。
欄位 | |
---|---|
begin |
必要欄位。郵遞區號或表單前置字元* 的模式,用於表示該區域的定義範圍包含的下限值。範例值: |
end |
選用設定。郵遞區號或格式 |
必填
說明必須接受的服務條款。
欄位 | |
---|---|
terms_of_service |
需接受的 termsOfService。 |
tos_file_uri |
服務條款檔案的完整網址。這個欄位與 TermsOfService.file_uri 相同,只是為了方便起見,這裡新增。 |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
RetrieveForApplicationTermsOfServiceAgreementState
方法的要求訊息。
欄位 | |
---|---|
parent |
必要欄位。要取得《TermsOfServiceBindingmentState 格式》的帳戶: |
RetrieveLatestTermsOfServiceRequest
RetrieveLatestTermsOfService
方法的要求訊息。
欄位 | |
---|---|
region_code |
CLDR 定義的區碼。指特定國家/地區專屬《服務條款》即為 001 的國家/地區。 |
kind |
此服務條款版本的 Kind。 |
列
加入儲存格清單。
欄位 | |
---|---|
cells[] |
必要欄位。構成列的儲存格清單。二維資料表的長度必須與 |
服務
運送服務。
欄位 | |
---|---|
delivery_countries[] |
必要欄位。服務適用國家/地區的 CLDR 地域代碼。 |
rate_groups[] |
選用設定。運送費率群組定義。只有最後一個項目可以含有空白的 |
loyalty_programs[] |
選用設定。這項運送服務僅適用於特定會員方案。 |
service_name |
必要欄位。服務名稱 (形式不拘),在目標帳戶中不得重複。 |
active |
必要欄位。顯示運送服務有效狀態的布林值。 |
currency_code |
這項服務所適用貨幣的 CLDR 代碼。費率組中的價格必須和兩者相符。 |
delivery_time |
必要欄位。從訂購到產品出貨等各個面向所花費的時間。 |
shipment_type |
這項服務能運送訂單的目標地點類型。 |
minimum_order_value |
這項服務的最低訂單價值。指定時,表示客戶必須至少支付這個金額。一項服務中的所有價格都必須採用相同幣別。無法與 min_order_value_table 一起設定。 |
minimum_order_value_table |
取貨配送類型的個別商店最低訂單值表格。無法與 min_order_value 一起設定。 |
store_config |
產品的運送來源清單。這只適用於本地運送運送類型。 |
LoyaltyProgram
商家提供的會員方案。
欄位 | |
---|---|
loyalty_program_tiers[] |
選用設定。這項運送服務的會員方案等級。 |
program_label |
這是你在 Merchant Center 會員方案設定中設定的會員方案標籤。Google 會根據這項子屬性將你的會員方案對應至符合資格的商品。 |
LoyaltyProgramTiers
商家會員方案子集。
欄位 | |
---|---|
tier_label |
等級標籤 [tier_label] 子屬性可用於區分不同會員等級的商品層級福利。此外,Merchant Center 的會員方案設定中也會設定這項屬性值;即使會員方案只有 1 個階層,變更資料來源時,也必須提供這項屬性值。 |
ShipmentType
運送服務類型。
列舉 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
這項服務未指定運送類型。 |
DELIVERY |
這項服務會將訂單寄到消費者選擇的地址。 |
LOCAL_DELIVERY |
這項服務會將訂單寄到消費者選擇的地址。訂單商品會由附近的當地門市出貨。 |
COLLECTION_POINT |
這項服務會將訂單寄到消費者選擇的地址。訂單會從取貨地點出貨。 |
StoreConfig
產品的運送來源清單。這只適用於本地運送運送類型。
欄位 | |
---|---|
store_codes[] |
選用設定。提供當地交貨服務的商店代碼清單。如果留空,則 |
store_service_type |
表示這個商家列出的所有商店或特定商店是否提供本地到貨服務。 |
cutoff_config |
與當地配送相關的設定都會在當天結束。 |
service_radius |
最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。 |
CutoffConfig
與當地配送相關的設定都會在當天結束。
欄位 | |
---|---|
local_cutoff_time |
當天當地到貨的結束時間。 |
store_close_offset_hours |
僅限店面交車使用。以商店打烊前的時數表示截止時間。與 |
no_delivery_post_cutoff |
商家只要將運送服務設為本地到貨 n 天,即可選擇不顯示本地到貨 1 天以上。舉例來說,如果運送服務定義了當天到貨服務,且超過截止時間,將這個欄位設為 |
LocalCutoffTime
當天當地到貨的結束時間。
欄位 | |
---|---|
hour |
當地時間外送訂單必須在當天下單。 |
minute |
當地配送訂單 (分鐘) 必須於當天下單當天處理。 |
StoreServiceType
表示商家列出的商店或特定商店是否提供本地到貨服務。
列舉 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
未指定商店服務類型。 |
ALL_STORES |
表示這個商家列出的所有商店 (包括目前和未來商店) 是否提供店面運送。 |
SELECTED_STORES |
表示只有store_codes 中列出的商店可使用本地配送服務。 |
ShippingSettings
商家帳戶的 [運送設定](https://support.google.com/merchants/answer/6069284)。
欄位 | |
---|---|
name |
ID。運送設定的資源名稱。格式: |
services[] |
選用設定。目標帳戶的服務清單。 |
warehouses[] |
選用設定。可在 |
etag |
必要欄位。這個欄位可用於避免發生非同步問題。確認來電設定資料在接到來電與插入來電之間不會改變。使用者必須執行下列步驟:
|
資料表
當 single_value
不夠明確時,定義費率群組的資料表。
欄位 | |
---|---|
rows[] |
必要欄位。構成資料表的資料列清單。長度必須與 |
name |
資料表名稱。子資料表必填,主表格會忽略。 |
row_headers |
必要欄位。資料表中資料列的標題。 |
column_headers |
資料表中的資料欄標頭。選用:如未設定,表格就只會顯示一個維度。 |
TermsOfService
TermsOfService
。
欄位 | |
---|---|
name |
ID。服務條款版本的資源名稱。格式: |
region_code |
CLDR 定義的區碼。這可能是《服務條款》專門適用於該國家/地區的國家/地區,或是 |
kind |
此服務條款版本的 Kind。 |
external |
此服務條款版本是否為外部版本。外部服務條款版本只能透過外部程序達成,商家無法透過 UI 或 API 直接協議。 |
file_uri |
需要向簽署使用者顯示的服務條款檔案 URI。 |
TermsOfServiceAgreementState
這項資源代表指定帳戶的協議狀態和服務條款類型。狀態如下所示:
請注意,您可以同時顯示必填和接受兩種屬性。在這種情況下,accepted
服務條款的到期日為 valid_until 欄位中。您必須在 valid_until
前接受「required
」的服務條款,帳戶才能繼續簽訂有效協議。接受新的服務條款時,我們希望第三方顯示與指定服務條款協議相關的文字 (內含文字的檔案所在檔案的網址會在下方的「必要訊息」中新增為 tos_file_uri)。您只需在 TermsOfService 資源上呼叫接受,即可確實接受服務條款。
欄位 | |
---|---|
name |
ID。服務條款版本的資源名稱。格式: |
region_code |
由 https://cldr.unicode.org/ 定義的區碼這是指目前所適用的國家/地區。 |
terms_of_service_kind |
與特定版本相關的服務條款種類。 |
accepted |
這種類型接受的服務條款以及相關 region_code 的服務條款 |
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[] |
必要欄位。區域名稱清單 |
transit_time_labels[] |
必要欄位。運送時間標籤清單。最後一個值可以是 |
rows[] |
必要欄位。如果只有一組維度組合 |
TransitTimeRow
如果只有一組維度組合 postal_code_group_names
或 transit_time_labels
,則會有數個資料列,每個資料列都具有一個該維度的值。如果有兩個維度,則每列都會對應到 postal_code_group_names
,而欄 (值) 則對應到 transit_time_labels
。
欄位 | |
---|---|
values[] |
必要欄位。運送時間範圍 (最短至最長工作天)。 |
TransitTimeValue
運送時間範圍 (最短至最長工作天)。
欄位 | |
---|---|
min_transit_days |
最短運送時間範圍 (以工作天為單位)。0 表示當天到貨服務,1 代表次日到貨。 |
max_transit_days |
必須大於或等於 |
UnclaimHomepageRequest
UnclaimHomepage
方法的要求訊息。
欄位 | |
---|---|
name |
必要欄位。要取消聲明的首頁名稱。格式: |
UpdateAccountRequest
UpdateAccount
方法的要求訊息。
欄位 | |
---|---|
account |
必要欄位。新版帳戶。 |
update_mask |
必要欄位。正在更新的欄位清單。 |
UpdateBusinessIdentityRequest
UpdateBusinessIdentity
方法的要求訊息。
欄位 | |
---|---|
business_identity |
必要欄位。新版商家身分。 |
update_mask |
必要欄位。正在更新的欄位清單。 |
UpdateBusinessInfoRequest
UpdateBusinessInfo
方法的要求訊息。
欄位 | |
---|---|
business_info |
必要欄位。新版商家資訊。 |
update_mask |
必要欄位。正在更新的欄位清單。 |
UpdateEmailPreferencesRequest
UpdateEmailPreferences 方法的要求訊息。
欄位 | |
---|---|
email_preferences |
必要欄位。要更新的電子郵件接收設定。 |
update_mask |
必要欄位。正在更新的欄位清單。 |
UpdateHomepageRequest
UpdateHomepage
方法的要求訊息。
欄位 | |
---|---|
homepage |
必要欄位。新版首頁。 |
update_mask |
必要欄位。正在更新的欄位清單。 |
UpdateRegionRequest
UpdateRegion
方法的要求訊息。
欄位 | |
---|---|
region |
必要欄位。更新後的區域。 |
update_mask |
選用設定。以半形逗號分隔的欄位遮罩,用於指出要更新的欄位。範例: |
UpdateUserRequest
UpdateUser
方法的要求訊息。
欄位 | |
---|---|
user |
必要欄位。新版使用者。 使用 |
update_mask |
必要欄位。正在更新的欄位清單。 |
使用者
使用者。
欄位 | |
---|---|
name |
ID。使用者的資源名稱。格式: 使用 |
state |
僅供輸出。使用者的狀態。 |
access_rights[] |
選用設定。使用者擁有的存取權限。 |
州
使用者可能的狀態。
列舉 | |
---|---|
STATE_UNSPECIFIED |
預設值。這個值未使用。 |
PENDING |
使用者尚待確認。在這種狀態下,使用者必須先接受邀請,才能執行其他動作。 |
VERIFIED |
使用者已通過驗證。 |
值
費率群組的單一值,或是費率群組表格儲存格的值。必須明確設定 no_shipping
、flat_rate
、price_percentage
、carrier_rateName
、subtable_name
其中之一。
欄位 | |
---|---|
no_shipping |
如果值為 true,產品將無法出貨。設定時必須設為 true,且只有在其他欄位皆未設定的情況下才能設定。 |
flat_rate |
固定費率。只有在未設定所有其他欄位的情況下,才能設定這些欄位。 |
price_percentage |
以十進位標記法表示的價格百分比,例如 |
carrier_rate |
參照相同費率群組中定義的貨運公司費率的貨運公司費率名稱。只有在未設定所有其他欄位的情況下,才能設定這些欄位。 |
subtable |
子表格的名稱。只能在表格儲存格中設定 (例如不得為單一值),且只有在未設定所有其他欄位的情況下才能設定。 |
Warehouse
出貨倉庫,用於儲存及處理庫存。下一個代碼:7
欄位 | |
---|---|
name |
必要欄位。倉庫的名稱。在帳戶內不得重複。 |
shipping_address |
必要欄位。倉庫的運送地址。 |
cutoff_time |
必要欄位。訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。 |
handling_days |
必要欄位。從這個倉庫出貨及運送商品所需的天數。這是倉庫層級,但可根據商品屬性在商品層級覆寫。 |
business_day_config |
倉庫的工作天。如未設定,預設為星期一至星期五。 |
WarehouseBasedDeliveryTime
表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後,delivery_time
中不應設定其他運送時間相關欄位。
欄位 | |
---|---|
carrier |
必要欄位。電信業者,例如 |
carrier_service |
必要欄位。電信業者服務,例如 |
warehouse |
必要欄位。倉儲名稱。這應符合 [warehouse][ShippingSetting.warehouses.name] |
WarehouseCutoffTime
訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。
欄位 | |
---|---|
hour |
必要欄位。倉庫必須在同一天的訂單完成處理所需的截止時間。時數以倉庫時區為準。 |
minute |
必要欄位。倉庫必須在同一天提交訂單所需的處理時間,此為截止時間的分鐘數。分鐘數是以倉庫時區為準。 |