Merchant API

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

• REST 資源：report_v1beta.accounts.reports
• REST 資源：quota_v1beta.accounts.quotas
• REST 資源：promotion_v1beta.accounts.promotions
• REST 資源：products_v1beta.accounts.productInputs
• REST 資源：products_v1beta.accounts.products
• REST 資源：notification_v1beta.accounts.notificationsubscriptions
• REST 資源：lfp_v1beta.accounts.lfpInventories
• REST 資源：lfp_v1beta.accounts.lfpSales
• REST 資源：lfp_v1beta.accounts.lfpStores
• REST 資源：inventoryories_v1beta.accounts.products.localInventories
• REST 資源：inventoryories_v1beta.accounts.products.regionalInventories
• REST 資源：datasources_v1beta.accounts.dataSources
• REST 資源：conversion_v1beta.accounts.conversionSources
• REST 資源：accounts_v1beta.accounts
• REST 資源：accounts_v1beta.accounts.businessIdentity
• REST 資源：accounts_v1beta.accounts.businessInfo
• REST 資源：accounts_v1beta.accounts.emailpreferences
• REST 資源：accounts_v1beta.accounts.homepage
• REST 資源：accounts_v1beta.accounts.issues
• REST 資源：accounts_v1beta.accounts.onlineReturnPolicies
• REST 資源：accounts_v1beta.accounts.programs
• REST 資源：accounts_v1beta.accounts.regions
• REST 資源：accounts_v1beta.accounts.shippingSettings
• REST 資源：accounts_v1beta.accounts.termsOfServiceAgreementStates
• REST 資源：accounts_v1beta.accounts.users
• REST 資源：accounts_v1beta.termsOfService

服務：merchantapi.googleapis.com

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

探索文件

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

• https://merchantapi.googleapis.com/$discovery/rest?version=reports_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=quota_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=promotions_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=products_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=notifications_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=lfp_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=inventories_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=datasources_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=conversions_v1beta
• https://merchantapi.googleapis.com/$discovery/rest?version=accounts_v1beta

服務端點

服務端點是指定 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 帳戶擷取帳戶。
list	GET /accounts/v1beta/accounts 個 列出呼叫使用者可存取的帳戶，且符合要求的限制 (例如頁面大小或篩選條件)。
listSubaccounts	GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts 個 列出指定多重客戶帳戶的所有子帳戶。
patch	PATCH /accounts/v1beta/{account.name=accounts/*} 個 可更新不限類型的帳戶：獨立、MCA 或子帳戶。

REST 資源：accounts_v1beta.accounts.businessIdentity

方法
getBusinessIdentity	GET /accounts/v1beta/{name=accounts/*/businessIdentity} 個 擷取帳戶的商家身分。
updateBusinessIdentity	PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity} 個 更新帳戶的商家身分。

REST 資源：accounts_v1beta.accounts.businessInfo

方法
getBusinessInfo	GET /accounts/v1beta/{name=accounts/*/businessInfo} 個 擷取帳戶的商家資訊。
updateBusinessInfo	PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo} 個 更新帳戶的商家資訊。

REST 資源：accounts_v1beta.accounts.emailpreferences

方法
getEmailPreferences	GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences} 個 傳回 Merchant Center 帳戶使用者的電子郵件接收設定。
updateEmailPreferences	PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences} 個 更新 Merchant Center 帳戶使用者的電子郵件接收設定。

REST 資源：accounts_v1beta.accounts.homepage

方法
claim	POST /accounts/v1beta/{name=accounts/*/homepage}:claim 個 聲明商店首頁的擁有權。
getHomepage	GET /accounts/v1beta/{name=accounts/*/homepage} 個 擷取商店首頁。
unclaim	POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim 個 取消聲明商店首頁的擁有權。
updateHomepage	PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage} 個 更新商店的首頁。

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

方法
getShippingSettings	GET /accounts/v1beta/{name=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 帳戶使用者。
list	GET /accounts/v1beta/{parent=accounts/*}/users 個 列出 Merchant Center 帳戶的所有使用者。
patch	PATCH /accounts/v1beta/{user.name=accounts/*/users/*} 個 更新 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 的最新版本。