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 帳戶擷取帳戶。
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
針對特定 kindregion_code 擷取 TermsOfService 的最新版本。