Merchant Accounts API 版本資訊

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.CreateAccountsService.CreateAndConfigure 方法。

2025 年 1 月 27 日當週

AccountsService.ListAccounts (和遞移性 AccountsService.ListSubAccounts) 現在會以最終一致性的方式傳回帳戶,而不是強式讀取。

2025 年 1 月 20 日當週

CreateAndConfigureAccountRequestusers 欄位已淘汰,請改用新的 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_ADSproviders/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 各項資源的說明文件,例如 UserHomepageBusinessInfo 等。

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_codekind 標示為 REQUIREDRetrieveLatestTermsOfServiceRequest

2024 年 9 月 16 日當週

已將 time_zone 參數的類型變更為 ListAccountIssuesRequest 中的字串

2024 年 8 月 12 日當週

BusinessInfo 資源中加入 korean_business_registration_number 欄位。

2024 年 5 月 27 日當週

推出 Accounts 子 API Beta 版