2025 年 7 月 1 日當週
- 推出 CheckoutSettings 資源,方便 API 使用者建立、更新、刪除及取得 checkoutSettings。
2025 年 5 月 26 日當週
現在可以依
capabilities
篩選帳戶。目前唯一可能的值為CAN_UPLOAD_PRODUCTS
。這個篩選器可讓您擷取能夠上傳產品的帳戶。也就是說,您現在可以在帳戶層級使用下列子句:capabilities:CAN_UPLOAD_PRODUCTS
-capabilities:CAN_UPLOAD_PRODUCTS
NOT capabilities:CAN_UPLOAD_PRODUCTS
詳情請參閱篩選指南。
推出唯讀存取權。具備唯讀存取權的使用者可以查看商家資料,但無法修改。
2025 年 5 月 19 日當週
- 更新 Program API 的說明文件,移除有關
Enable
/Disable
方法僅限管理員使用的錯誤陳述。
2025 年 5 月 12 日當週
- 推出線上退貨政策資源,方便 API 使用者建立、更新及刪除退貨政策。
- 推出 OmnichannelSettingsService 和 OmnichannelSetting 資源,方便 API 使用者管理全通路體驗。
- 推出 LfpProvidersService 和 LfpProvider 資源,方便 API 使用者管理本機動態饋給合作關係。
- 推出 GbpAccountsService 和 GbpAccount 資源,方便 API 使用者管理 Google 商家檔案。
- 在 AccountService 中啟動服務類型 LocalListingManagement,連結用於店面商品目錄廣告或免費區域產品資訊的商家群組。
2025 年 4 月 28 日當週
- 推出 AccountService 和 AccountRelationship 資源,方便 API 使用者管理關係,並為服務供應商建立服務。
2025 年 4 月 14 日當週
TermsOfServiceService.AcceptTermsOfService
現在會傳回已接受的TermsOfServiceAgremeentState
,並包裝在回應類型中。TermsOfServiceService.AcceptTermsOfService
動作的動詞現在是POST
(原為GET
)。明確指出
AccountsService.ListSubAccounts
必須使用accounts/...
格式 (而非providers/...
) 呼叫,以免這個方法超出accounts
範圍 (也就是GET accounts/123:listSubAccounts
而非GET providers/123:listSubAccounts
)。
2025 年 3 月 31 日當週
如要篩選帳戶,我們已在 2024 年 12 月 2 日當週宣布淘汰
externalAccountId
篩選器,目前已無法使用。也就是說,現在只能在service
層級依externalAccountId
進行篩選。relationship(externalAccountId = "foo")
等篩選器將無法再運作,必須改用relationship(service(externalAccountId = "foo"))
表示。在
AccountsService
文件中明確指出無法建立獨立帳戶。
2025 年 3 月 3 日當週
- accounts.onlineReturnPolicies#SeasonalOverride
已重構,可提升清楚度和一致性。新版政策內容包括:
- 欄位重新命名:
begin
現已改名為start_date
。end
現已改名為end_date
。
- 移除欄位:
- 已移除已淘汰的
policy
欄位。
- 已移除已淘汰的
- 開發人員應更新程式碼,以反映這些變更。
推出 AutomaticImprovements
服務,可用於管理下列項目:
詳情請參閱「啟用自動改善功能」。
2025 年 2 月 17 日當週
從帳戶篩選器中移除 callerHasAccessToProviderFilter()
述詞。
2025 年 2 月 10 日當週
改善
AccountsService.List
方法的說明文件。這個方法會傳回使用者可存取的所有帳戶,而不只是獨立帳戶。所有 RPC 方法的預設期限都已設為 10 分鐘。
在
accounts.programs
資源說明中新增可用方案名稱清單。User.accessRights
現在是REQUIRED
,會影響UserService.Create
和AccountsService.CreateAndConfigure
方法。
2025 年 1 月 27 日當週
AccountsService.ListAccounts
(和遞移性 AccountsService.ListSubAccounts
) 現在會以最終一致性的方式傳回帳戶,而不是強式讀取。
2025 年 1 月 20 日當週
CreateAndConfigureAccountRequest
的 users
欄位已淘汰,請改用新的 user
。參照的 CreateUserRequest
包含 parent
欄位,但 CreateAndConfigureAccountRequest
的內容並不需要這個欄位。
2025 年 1 月 6 日當週
CreateUserRequest
訊息的 user
欄位現已正確標示為 OPTIONAL
。
傳回錯誤中的 domain
欄位現在會填入 merchantapi.googleapis.com
,而非 global
2024 年 12 月 2 日當週
如要篩選帳戶,請將 externalAccountId
述詞從 relationship
層級移至 service
層級。因此,篩選器 relationship(externalAccountId = "foo")
現在必須寫成 relationship(service(externalAccountId = "foo"))
。為了確保回溯相容性,系統仍支援舊格式,但舊格式已遭淘汰,近期內會擲回錯誤。所有說明文件只會提及新格式。
2024 年 11 月 18 日當週
CreateAndConfigureAccountRequest.service.provider
欄位中的供應商現在也可以是 providers/GOOGLE_ADS
或 providers/GOOGLE_BUSINESS_PROFILE
。其他帳戶應稱為 providers/123
(而非 accounts/123
)。這表示該欄位不再註解為帳戶參照。不過,您仍可使用 accounts/123
等帳戶名稱,以確保回溯相容性。
ListSubAccountsRequest
中的供應器現在應採用 providers/123
形式,但為了顧及回溯相容性,仍可使用 accounts/123
。
2024 年 11 月 4 日當週
在 BusinessIdentity
資源中標記 promotions_consent
REQUIRED
(來自 OPTIONAL
)。這只會影響更新方法。在此澄清,您無法將 promotions_consent
更新為 UNSPECIFIED
。這項操作原本就無法進行,但現在錯誤訊息會提供更詳細的說明,且欄位已正確註解。
2024 年 10 月 28 日當週
改善帳戶子 API 各項資源的說明文件,例如 User
、Homepage
、BusinessInfo
等。
2024 年 10 月 21 日當週
改善更新要求中 update_mask
欄位的說明文件,明確指出支援更新的欄位。
在 ShippingSettings
資源的外部文件中,新增支援的電信業者 Google 商家說明中心連結
2024 年 10 月 14 日當週
在 AccountsService.CreateAndConfigureAccountRequest.AddAccountService
中將 provider
標示為 REQUIRED
。
在整個帳戶子 API 中,將 update_mask
設為選用 (例如商家身分、商家資訊、首頁等),並追溯適用於 ConversionSources
資源。
已將 overwrite
參數新增至 ClaimHomepageRequest
。
2024 年 9 月 30 日當週
推出「Accounts.delete」方法的「force」參數。
2024 年 9 月 23 日當週
將 region_code
和 kind
標示為 REQUIRED
。RetrieveLatestTermsOfServiceRequest
2024 年 9 月 16 日當週
已將 time_zone
參數的類型變更為 ListAccountIssuesRequest
中的字串
2024 年 8 月 12 日當週
在 BusinessInfo
資源中加入 korean_business_registration_number
欄位。
2024 年 5 月 27 日當週
推出 Accounts 子 API Beta 版