Merchant API

以程式輔助方式管理 Merchant Center 帳戶。

服務：merchantapi.googleapis.com

如要呼叫這項服務，建議您使用 Google 提供的用戶端程式庫。如果應用程式需要使用您自己的程式庫呼叫這項服務，請在發出 API 要求時使用下列資訊。

探索文件

探索文件是一種機器可解讀的規格，用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式，以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。此服務提供下列探索文件：

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點，且下方的 URI 皆以此服務端點為基準：

  • https://merchantapi.googleapis.com

REST 資源：reports_v1beta.accounts.reports

方法
search POST /reports/v1beta/{parent=accounts/*}/reports:search
擷取搜尋查詢定義的報表。

REST 資源：quota_v1beta.accounts.quotas

方法
list GET /quota/v1beta/{parent=accounts/*}/quotas
列出 Merchant Center 帳戶每個群組的每日呼叫配額和用量。

REST 資源：promotions_v1beta.accounts.promotions

方法
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
從 Merchant Center 帳戶擷取促銷活動。
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
為 Merchant Center 帳戶插入促銷活動。
list GET /promotions/v1beta/{parent=accounts/*}/promotions
在 Merchant Center 帳戶中列出促銷活動。

REST 資源：products_v1beta.accounts.productInputs

方法
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
從 Merchant Center 帳戶中刪除產品輸入內容。
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
將產品輸入內容上傳至 Merchant Center 帳戶。

REST 資源：products_v1beta.accounts.products

方法
get GET /products/v1beta/{name=accounts/*/products/*}
從 Merchant Center 帳戶擷取已處理的產品。
list GET /products/v1beta/{parent=accounts/*}/products
列出 Merchant Center 帳戶中處理過的產品。

REST 資源：notifications_v1beta.accounts.notificationsubscriptions

方法
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
為商家建立通知訂閱。
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
刪除商家的通知訂閱。
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
取得帳戶的通知訂閱。
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
取得商家的所有通知訂閱項目。
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
更新商家現有的通知訂閱項目。

REST 資源：lfp_v1beta.accounts.lfpInventories

方法
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
為指定目標商家帳戶插入 LfpInventory 資源。

REST 資源：lfp_v1beta.accounts.lfpSales

方法
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
為指定商家插入 LfpSale。

REST 資源：lfp_v1beta.accounts.lfpStores

方法
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
刪除目標商家的商店。
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
擷取商店資訊。
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
插入目標商家的商店。
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
列出目標商家的商店，由 ListLfpStoresRequest 中的篩選器指定。

REST 資源：inventories_v1beta.accounts.products.localInventories

方法
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
從商家帳戶中的指定產品中刪除指定的LocalInventory。
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
在商家帳戶中的產品插入 LocalInventory 資源。
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
列出商家帳戶中特定產品的 LocalInventory 資源。

REST 資源：inventories_v1beta.accounts.products.regionalInventories

方法
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
從商家帳戶中的特定產品中刪除指定的 RegionalInventory 資源。
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
將 RegionalInventory 插入商家帳戶中的特定產品。
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
列出商家帳戶中特定產品的 RegionalInventory 資源。

REST 資源：datasources_v1beta.accounts.dataSources

方法
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
為指定帳戶建立新的資料來源設定。
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
刪除 Merchant Center 帳戶中的資料來源。
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
能立即擷取 Merchant Center 帳戶中的資料來源的資料 (即使是擷取時間表以外)。
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
擷取指定帳戶的資料來源設定。
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
列出指定帳戶的資料來源設定。
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
更新現有的資料來源設定。

REST 資源：conversions_v1beta.accounts.conversionSources

方法
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
建立新的轉換來源。
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
封存現有的轉換來源。
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
擷取轉換來源。
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
擷取呼叫端可存取的轉換來源清單。
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
更新現有轉換來源的資訊。
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
重新啟用已封存的轉換來源。

REST 資源：accounts_v1beta.accounts

方法
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
建立具有額外設定的獨立 Merchant Center 帳戶。
delete DELETE /accounts/v1beta/{name=accounts/*}
刪除指定帳戶，不論類型為何：獨立、MCA 或子帳戶。
get GET /accounts/v1beta/{name=accounts/*}
從 Merchant Center 帳戶擷取帳戶。
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
擷取帳戶的商家身分。
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
擷取帳戶的商家資訊。
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
擷取商店首頁。
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
擷取運送設定資訊。
list GET /accounts/v1beta/accounts
列出發出呼叫的使用者可存取的帳戶，且符合要求限制 (例如頁面大小或篩選器)。
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
列出特定多重客戶帳戶的所有子帳戶。
patch PATCH /accounts/v1beta/{account.name=accounts/*}
可更新不限類型的帳戶：獨立、MCA 或子帳戶。
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
更新帳戶的商家身分。
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
更新帳戶的商家資訊。
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
更新商店的首頁。

REST 資源：accounts_v1beta.accounts.accounttax

方法
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
傳回符合 GetAccountTaxRequest 條件的稅務規則
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
系統只會在 Merchant Center 帳戶中列出子帳戶的稅金設定。
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
更新帳戶的稅金設定。

REST 資源：accounts_v1beta.accounts.homepage

方法
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
聲明商店首頁。
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
取消聲明商店首頁的擁有權。

REST 資源：accounts_v1beta.accounts.issues

方法
list GET /accounts/v1beta/{parent=accounts/*}/issues
列出 Merchant Center 帳戶的所有帳戶問題。

REST 資源：accounts_v1beta.accounts.onlineReturnPolicies

方法
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
取得現有的退貨政策。
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
列出所有現有的退貨政策。

REST 資源：accounts_v1beta.accounts.programs

方法
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
停止參與帳戶的特定計畫。
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
允許參與帳戶的特定計畫。
get GET /accounts/v1beta/{name=accounts/*/programs/*}
擷取帳戶的特定計畫。
list GET /accounts/v1beta/{parent=accounts/*}/programs
擷取帳戶的所有計畫。

REST 資源：accounts_v1beta.accounts.regions

方法
create POST /accounts/v1beta/{parent=accounts/*}/regions
在 Merchant Center 帳戶中建立區域定義。
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
從 Merchant Center 帳戶中刪除區域定義。
get GET /accounts/v1beta/{name=accounts/*/regions/*}
擷取 Merchant Center 帳戶中定義的區域。
list GET /accounts/v1beta/{parent=accounts/*}/regions
列出 Merchant Center 帳戶中的區域。
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
在 Merchant Center 帳戶中更新區域定義。

REST 資源：accounts_v1beta.accounts.shippingSettings

方法
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
將商家的運送設定替換為要求運送設定。

REST 資源：accounts_v1beta.accounts.termsOfServiceAgreementStates

方法
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
傳回服務條款協議的狀態。
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
擷取應用程式服務條款的協議狀態。

REST 資源：accounts_v1beta.accounts.users

方法
create POST /accounts/v1beta/{parent=accounts/*}/users
建立 Merchant Center 帳戶使用者。
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
刪除 Merchant Center 帳戶使用者。
get GET /accounts/v1beta/{name=accounts/*/users/*}
擷取 Merchant Center 帳戶使用者。
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
傳回 Merchant Center 帳戶使用者的電子郵件接收設定。
list GET /accounts/v1beta/{parent=accounts/*}/users
列出 Merchant Center 帳戶的所有使用者。
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
更新 Merchant Center 帳戶使用者。
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
更新 Merchant Center 帳戶使用者的電子郵件接收設定。

REST 資源：accounts_v1beta.termsOfService

方法
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
接受 TermsOfService。
get GET /accounts/v1beta/{name=termsOfService/*}
擷取與指定版本相關聯的 TermsOfService。
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
針對特定 kind 和 region_code 擷取最新版 TermsOfService。