Merchant API

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

服務:merchantapi.googleapis.com

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

探索文件

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

服務端點

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

  • https://merchantapi.googleapis.com

REST 資源:reviews_v1beta.accounts.merchantReviews

方法
delete DELETE /reviews/v1beta/{name=accounts/*/merchantReviews/*}
刪除商家評論。
get GET /reviews/v1beta/{name=accounts/*/merchantReviews/*}
取得商家評論。
insert POST /reviews/v1beta/{parent=accounts/*}/merchantReviews:insert
為 Merchant Center 帳戶插入評論。
list GET /reviews/v1beta/{parent=accounts/*}/merchantReviews
列出商家評論。

REST 資源:reviews_v1beta.accounts.productReviews

方法
delete DELETE /reviews/v1beta/{name=accounts/*/productReviews/*}
刪除產品評論。
get GET /reviews/v1beta/{name=accounts/*/productReviews/*}
取得產品評論。
insert POST /reviews/v1beta/{parent=accounts/*}/productReviews:insert
插入產品評論。
list GET /reviews/v1beta/{parent=accounts/*}/productReviews
列出產品評論。

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 資源:datasources_v1beta.accounts.dataSources.fileUploads

方法
get GET /datasources/v1beta/{name=accounts/*/dataSources/*/fileUploads/*}
取得最新上傳的資料來源檔案。

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/*}
更新帳戶,不論帳戶類型為獨立帳戶、多重客戶帳戶或子帳戶。

REST 資源:accounts_v1beta.accounts.autofeedSettings

方法
getAutofeedSettings GET /accounts/v1beta/{name=accounts/*/autofeedSettings}
擷取帳戶的自動動態饋給設定。
updateAutofeedSettings PATCH /accounts/v1beta/{autofeedSettings.name=accounts/*/autofeedSettings}
更新帳戶的自動動態饋給設定。

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 的最新版本。