Merchant Accounts API 版本資訊

2026 年 10 月 26 日當週

  • 釐清 accounts.homepage.unclaim 方法和 Homepage 資源 claimed 欄位的說明文件。如果帳戶從進階帳戶繼承首頁擁有權聲明，unclaim 會傳回成功回應，但首頁仍會維持已聲明擁有權的狀態。如果帳戶本身免於聲明版權，unclaim 會傳回 FAILED_PRECONDITION 錯誤。

2026 年 9 月 28 日當週

  • LoyaltyPrograms 服務 Alpha 版推出，可用於管理會員方案。這項功能僅開放給特定商家使用。詳情請參閱會員方案總覽。

  • 在 accounts 資源中新增唯讀 home_page_uri 欄位，用於傳回商店首頁的 URI。

2026 年 8 月 3 日當週

  • 在帳戶服務資源中，新增「ucp_checkout_management」做為服務類型。注意：UCP 結帳功能僅開放部分商家使用。
  • 新增「ucp-integration」計畫支援 (有限存取權)。
  • 新增「ucp_integration」服務條款類型的支援。

2026 年 6 月 29 日當週

  • 推出帳戶清單端點中使用的 access 篩選器。這項功能可讓您根據存取層級篩選帳戶，可能的值為 DIRECT、INDIRECT 和 ALL。預設行為是傳回您有權存取的所有帳戶。詳情請參閱「篩選可存取的帳戶」。

2026 年 4 月 20 日當週

  • 在 accounts.programs 資源說明中，將 youtube-affiliate 新增至可用計畫名稱清單。
  • 啟用 YouTube Shopping 聯盟計畫的計畫 API。開放給早鳥測試者。

2026 年 4 月 6 日當週

  • 在核准狀態中新增 WAITING 狀態。如果是購物比較服務 (CSS)，WAITING 是 PENDING 和 ESTABLISHED 之間的過渡狀態。如果原 CSS 需要時間執行必要清理作業，才會將帳戶完全轉移至新 CSS，就會使用這個狀態。

2026 年 3 月 16 日當週

  • 在 Accounts API 中推出 CreateTestAccount 方法。開發人員可以透過程式輔助方式，建立在類似沙箱的隔離環境中運作的專屬測試帳戶，提供安全的空間來開發及測試整合。

2025 年 11 月 17 日當週

  • CreateAndConfigureAccountRequest 現在提供新服務，可在設定帳戶時進行設定。必須指定 AccountAggregation、AccountManagement 和 ComparisonShopping 其中之一。此外，您也可以指定任意數量的 ProductsManagement 和 CampaignsManagement 服務。不過，這類服務不得有兩個服務供應商和外部帳戶 ID 相同。

  • AccountsService.CreateAndConfigure 方法現在提供設定，可控制是否要傳送驗證電子郵件。

  • CreateAndConfigureAccountRequest.AddAccountService 現在有 external_account_id 欄位 (AccountService 資源已有這個欄位)。可與 CampaignsManagement 和 ProductsManagement 服務一起指定。

  • 在 AccountService 資源中新增 ComparisonShopping 服務。詳情請參閱 https://support.google.com/merchants/answer/12653197。

  • 現在可以在建立帳戶時，使用 CreateAndConfigureAccountRequest 中的 setAlias 欄位設定關係別名。

  • 在 UserService 中新增 VerifySelf 方法，可將代表撥號使用者的 User 資源狀態從 PENDING 更新為 VERIFIED。

  • 在 Regions API 的 Region 酬載中推出新的 radius_area 欄位，讓商家能使用半徑區域建立區域。

2025 年 11 月 10 日當週

  • 發布 Services API 的 v1alpha 版本。
  • 在 Services API 的 CampaignManagement 酬載中推出新的 product_filters 欄位，讓商家根據商家產品屬性的某些條件式篩選，只與 Google Ads 帳戶共用部分動態饋給。這項功能僅開放給許可清單中的少數商家。

2025 年 8 月 25 日當週

  • Regions API 新增了批次方法：
    • BatchCreateRegions：允許在單一要求中建立多個區域。
    • BatchUpdateRegions：可在單一要求中更新多個區域。
    • BatchDeleteRegions：可透過單一要求，依名稱刪除多個區域。

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 日當週

  • 更新程式 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 日當週

  • externalAccountId 篩選器已於 2024 年 12 月 2 日當週宣布淘汰，目前已無法使用。也就是說，現在只能在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 包含 CreateAndConfigureAccountRequest 內容中不需要的 parent 欄位。

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 日當週

改善 Accounts 子 API 各種資源的說明文件，例如 User、Homepage、BusinessInfo 等。

2024 年 10 月 21 日當週

改善更新要求中 update_mask 欄位的說明文件，明確指出哪些欄位支援更新。

在 ShippingSettings 資源的外部文件中，新增 Google 商家說明中心連結，列出支援的電信業者

2024 年 10 月 14 日當週

在 AccountsService.CreateAndConfigureAccountRequest.AddAccountService 中將 provider 標示為REQUIRED。

在 Accounts 子 API 中，將 update_mask 設為選用 (例如商家身分、商家資訊、首頁等)，並追溯套用至 ConversionSources 資源。

在 ClaimHomepageRequest 中新增 overwrite 參數。

2024 年 9 月 30 日當週

推出「Accounts.delete」方法的「force」參數。

2024 年 9 月 23 日當週

在 RetrieveLatestTermsOfServiceRequest 中將 region_code 和 kind 標示為 REQUIRED。

2024 年 9 月 16 日當週

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

2024 年 8 月 12 日當週

在 BusinessInfo 資源中新增 korean_business_registration_number 欄位。

2024 年 5 月 27 日當週

Accounts 子 API Beta 版推出