Merchant API

Programmatically manage your Merchant Center accounts.

Service: merchantapi.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://merchantapi.googleapis.com

REST Resource: reports_v1beta.accounts.reports

Methods
search POST /reports/v1beta/{parent=accounts/*}/reports:search
Retrieves a report defined by a search query.

REST Resource: quota_v1beta.accounts.quotas

Methods
list GET /quota/v1beta/{parent=accounts/*}/quotas
Lists the daily call quota and usage per group for your Merchant Center account.

REST Resource: notifications_v1beta.accounts.notificationsubscriptions

Methods
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Creates a notification subscription for a merchant.
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Deletes a notification subscription for a merchant.
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Gets notification subscriptions for an account.
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Gets all the notification subscriptions for a merchant.
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
Updates an existing notification subscription for a merchant.

REST Resource: lfp_v1beta.accounts.lfpInventories

Methods
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
Inserts a LfpInventory resource for the given target merchant account.

REST Resource: lfp_v1beta.accounts.lfpSales

Methods
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
Inserts a LfpSale for the given merchant.

REST Resource: lfp_v1beta.accounts.lfpStores

Methods
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
Deletes a store for a target merchant.
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
Retrieves information about a store.
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
Inserts a store for the target merchant.
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
Lists the stores of the target merchant, specified by the filter in ListLfpStoresRequest.

REST Resource: inventories_v1beta.accounts.products.localInventories

Methods
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
Deletes the specified LocalInventory from the given product in your merchant account.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
Inserts a LocalInventory resource to a product in your merchant account.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
Lists the LocalInventory resources for the given product in your merchant account.

REST Resource: inventories_v1beta.accounts.products.regionalInventories

Methods
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
Deletes the specified RegionalInventory resource from the given product in your merchant account.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
Inserts a RegionalInventory to a given product in your merchant account.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
Lists the RegionalInventory resources for the given product in your merchant account.

REST Resource: conversions_v1beta.accounts.conversionSources

Methods
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
Creates a new conversion source.
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
Archives an existing conversion source.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
Fetches a conversion source.
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
Retrieves the list of conversion sources the caller has access to.
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
Updates information of an existing conversion source.
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
Re-enables an archived conversion source.