Content API for Shopping

Manage your product listings and accounts for Google Shopping

Service: shoppingcontent.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making 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 document:

Service endpoint

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

  • https://www.googleapis.com/content

v2.1.accounts

Methods
authinfo GET /content/v2.1/accounts/authinfo
Returns information about the authenticated user.
claimwebsite POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite
Claims the website of a Merchant Center sub-account.
custombatch POST /content/v2.1/accounts/batch
Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.
delete DELETE /content/v2.1/{merchantId}/accounts/{accountId}
Deletes a Merchant Center sub-account.
get GET /content/v2.1/{merchantId}/accounts/{accountId}
Retrieves a Merchant Center account.
insert POST /content/v2.1/{merchantId}/accounts
Creates a Merchant Center sub-account.
link POST /content/v2.1/{merchantId}/accounts/{accountId}/link

Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.

list GET /content/v2.1/{merchantId}/accounts
Lists the sub-accounts in your Merchant Center account.
listlinks GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks
Returns the list of accounts linked to your Merchant Center account.
update PUT /content/v2.1/{merchantId}/accounts/{accountId}
Updates a Merchant Center account.
updatelabels POST /content/v2.1/{merchantId}/accounts/{accountId}/updatelabels
Updates labels that are assigned to the Merchant Center account by CSS user.

v2.1.accounts.labels

Methods
create POST /content/v2.1/accounts/{accountId}/labels
Creates a new label, not assigned to any account.
delete DELETE /content/v2.1/accounts/{accountId}/labels/{labelId}
Deletes a label and removes it from all accounts to which it was assigned.
list GET /content/v2.1/accounts/{accountId}/labels
Lists the labels assigned to an account.
patch PATCH /content/v2.1/accounts/{accountId}/labels/{labelId}
Updates a label.

v2.1.accountstatuses

Methods
custombatch POST /content/v2.1/accountstatuses/batch
Retrieves multiple Merchant Center account statuses in a single request.
get GET /content/v2.1/{merchantId}/accountstatuses/{accountId}
Retrieves the status of a Merchant Center account.
list GET /content/v2.1/{merchantId}/accountstatuses
Lists the statuses of the sub-accounts in your Merchant Center account.

v2.1.accounttax

Methods
custombatch POST /content/v2.1/accounttax/batch
Retrieves and updates tax settings of multiple accounts in a single request.
get GET /content/v2.1/{merchantId}/accounttax/{accountId}
Retrieves the tax settings of the account.
list GET /content/v2.1/{merchantId}/accounttax
Lists the tax settings of the sub-accounts in your Merchant Center account.
update PUT /content/v2.1/{merchantId}/accounttax/{accountId}
Updates the tax settings of the account.

v2.1.datafeeds

Methods
custombatch POST /content/v2.1/datafeeds/batch
Deletes, fetches, gets, inserts and updates multiple datafeeds in a single request.
delete DELETE /content/v2.1/{merchantId}/datafeeds/{datafeedId}
Deletes a datafeed configuration from your Merchant Center account.
fetchnow POST /content/v2.1/{merchantId}/datafeeds/{datafeedId}/fetchNow
Invokes a fetch for the datafeed in your Merchant Center account.
get GET /content/v2.1/{merchantId}/datafeeds/{datafeedId}
Retrieves a datafeed configuration from your Merchant Center account.
insert POST /content/v2.1/{merchantId}/datafeeds
Registers a datafeed configuration with your Merchant Center account.
list GET /content/v2.1/{merchantId}/datafeeds
Lists the configurations for datafeeds in your Merchant Center account.
update PUT /content/v2.1/{merchantId}/datafeeds/{datafeedId}
Updates a datafeed configuration of your Merchant Center account.

v2.1.datafeedstatuses

Methods
custombatch POST /content/v2.1/datafeedstatuses/batch
Gets multiple Merchant Center datafeed statuses in a single request.
get GET /content/v2.1/{merchantId}/datafeedstatuses/{datafeedId}
Retrieves the status of a datafeed from your Merchant Center account.
list GET /content/v2.1/{merchantId}/datafeedstatuses
Lists the statuses of the datafeeds in your Merchant Center account.

v2.1.liasettings

Methods
custombatch POST /content/v2.1/liasettings/batch
Retrieves and/or updates the LIA settings of multiple accounts in a single request.
get GET /content/v2.1/{merchantId}/liasettings/{accountId}
Retrieves the LIA settings of the account.
getaccessiblegmbaccounts GET /content/v2.1/{merchantId}/liasettings/{accountId}/accessiblegmbaccounts
Retrieves the list of accessible Google My Business accounts.
list GET /content/v2.1/{merchantId}/liasettings
Lists the LIA settings of the sub-accounts in your Merchant Center account.
listposdataproviders GET /content/v2.1/liasettings/posdataproviders
Retrieves the list of POS data providers that have active settings for the all eiligible countries.
requestgmbaccess POST /content/v2.1/{merchantId}/liasettings/{accountId}/requestgmbaccess
Requests access to a specified Google My Business account.
requestinventoryverification POST /content/v2.1/{merchantId}/liasettings/{accountId}/requestinventoryverification/{country}
Requests inventory validation for the specified country.
setinventoryverificationcontact POST /content/v2.1/{merchantId}/liasettings/{accountId}/setinventoryverificationcontact
Sets the inventory verification contract for the specified country.
setposdataprovider POST /content/v2.1/{merchantId}/liasettings/{accountId}/setposdataprovider
Sets the POS data provider for the specified country.
update PUT /content/v2.1/{merchantId}/liasettings/{accountId}
Updates the LIA settings of the account.

v2.1.localinventory

Methods
custombatch POST /content/v2.1/localinventory/batch
Updates local inventory for multiple products or stores in a single request.
insert POST /content/v2.1/{merchantId}/products/{productId}/localinventory
Update the local inventory of a product in your Merchant Center account.

v2.1.orderinvoices

Methods
createchargeinvoice POST /content/v2.1/{merchantId}/orderinvoices/{orderId}/createChargeInvoice
Creates a charge invoice for a shipment group, and triggers a charge capture for orderinvoice enabled orders.
createrefundinvoice POST /content/v2.1/{merchantId}/orderinvoices/{orderId}/createRefundInvoice
Creates a refund invoice for one or more shipment groups, and triggers a refund for orderinvoice enabled orders.

v2.1.orderreports

Methods
listdisbursements GET /content/v2.1/{merchantId}/orderreports/disbursements
Retrieves a report for disbursements from your Merchant Center account.
listtransactions GET /content/v2.1/{merchantId}/orderreports/disbursements/{disbursementId}/transactions
Retrieves a list of transactions for a disbursement from your Merchant Center account.

v2.1.orderreturns

Methods
acknowledge POST /content/v2.1/{merchantId}/orderreturns/{returnId}/acknowledge
Acks an order return in your Merchant Center account.
get GET /content/v2.1/{merchantId}/orderreturns/{returnId}
Retrieves an order return from your Merchant Center account.
list GET /content/v2.1/{merchantId}/orderreturns
Lists order returns in your Merchant Center account.
process POST /content/v2.1/{merchantId}/orderreturns/{returnId}/process
Processes return in your Merchant Center account.

v2.1.orders

Methods
acknowledge POST /content/v2.1/{merchantId}/orders/{orderId}/acknowledge
Marks an order as acknowledged.
advancetestorder POST /content/v2.1/{merchantId}/testorders/{orderId}/advance
Sandbox only.
cancel POST /content/v2.1/{merchantId}/orders/{orderId}/cancel
Cancels all line items in an order, making a full refund.
cancellineitem POST /content/v2.1/{merchantId}/orders/{orderId}/cancelLineItem
Cancels a line item, making a full refund.
canceltestorderbycustomer POST /content/v2.1/{merchantId}/testorders/{orderId}/cancelByCustomer
Sandbox only.
createtestorder POST /content/v2.1/{merchantId}/testorders
Sandbox only.
createtestreturn POST /content/v2.1/{merchantId}/orders/{orderId}/testreturn
Sandbox only.
get GET /content/v2.1/{merchantId}/orders/{orderId}
Retrieves an order from your Merchant Center account.
getbymerchantorderid GET /content/v2.1/{merchantId}/ordersbymerchantid/{merchantOrderId}
Retrieves an order using merchant order ID.
gettestordertemplate GET /content/v2.1/{merchantId}/testordertemplates/{templateName}
Sandbox only.
instorerefundlineitem POST /content/v2.1/{merchantId}/orders/{orderId}/inStoreRefundLineItem
Deprecated.
list GET /content/v2.1/{merchantId}/orders
Lists the orders in your Merchant Center account.
refunditem POST /content/v2.1/{merchantId}/orders/{orderId}/refunditem
Issues a partial or total refund for items and shipment.
refundorder POST /content/v2.1/{merchantId}/orders/{orderId}/refundorder
Issues a partial or total refund for an order.
rejectreturnlineitem POST /content/v2.1/{merchantId}/orders/{orderId}/rejectReturnLineItem
Rejects return on an line item.
returnrefundlineitem POST /content/v2.1/{merchantId}/orders/{orderId}/returnRefundLineItem
Returns and refunds a line item.
setlineitemmetadata POST /content/v2.1/{merchantId}/orders/{orderId}/setLineItemMetadata
Sets (or overrides if it already exists) merchant provided annotations in the form of key-value pairs.
shiplineitems POST /content/v2.1/{merchantId}/orders/{orderId}/shipLineItems
Marks line item(s) as shipped.
updatelineitemshippingdetails POST /content/v2.1/{merchantId}/orders/{orderId}/updateLineItemShippingDetails
Updates ship by and delivery by dates for a line item.
updatemerchantorderid POST /content/v2.1/{merchantId}/orders/{orderId}/updateMerchantOrderId
Updates the merchant order ID for a given order.
updateshipment POST /content/v2.1/{merchantId}/orders/{orderId}/updateShipment
Updates a shipment's status, carrier, and/or tracking ID.

v2.1.pos

Methods
custombatch POST /content/v2.1/pos/batch
Batches multiple POS-related calls in a single request.
delete DELETE /content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode}
Deletes a store for the given merchant.
get GET /content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode}
Retrieves information about the given store.
insert POST /content/v2.1/{merchantId}/pos/{targetMerchantId}/store
Creates a store for the given merchant.
inventory POST /content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory
Submit inventory for the given merchant.
list GET /content/v2.1/{merchantId}/pos/{targetMerchantId}/store
Lists the stores of the target merchant.
sale POST /content/v2.1/{merchantId}/pos/{targetMerchantId}/sale
Submit a sale event for the given merchant.

v2.1.products

Methods
custombatch POST /content/v2.1/products/batch
Retrieves, inserts, and deletes multiple products in a single request.
delete DELETE /content/v2.1/{merchantId}/products/{productId}
Deletes a product from your Merchant Center account.
get GET /content/v2.1/{merchantId}/products/{productId}
Retrieves a product from your Merchant Center account.
insert POST /content/v2.1/{merchantId}/products
Uploads a product to your Merchant Center account.
list GET /content/v2.1/{merchantId}/products
Lists the products in your Merchant Center account.

v2.1.productstatuses

Methods
custombatch POST /content/v2.1/productstatuses/batch
Gets the statuses of multiple products in a single request.
get GET /content/v2.1/{merchantId}/productstatuses/{productId}
Gets the status of a product from your Merchant Center account.
list GET /content/v2.1/{merchantId}/productstatuses
Lists the statuses of the products in your Merchant Center account.

v2.1.pubsubnotificationsettings

Methods
get GET /content/v2.1/{merchantId}/pubsubnotificationsettings
Retrieves a Merchant Center account's pubsub notification settings.
update PUT /content/v2.1/{merchantId}/pubsubnotificationsettings
Register a Merchant Center account for pubsub notifications.

v2.1.regionalinventory

Methods
custombatch POST /content/v2.1/regionalinventory/batch
Updates regional inventory for multiple products or regions in a single request.
insert POST /content/v2.1/{merchantId}/products/{productId}/regionalinventory
Update the regional inventory of a product in your Merchant Center account.

v2.1.repricingrules

Methods
create POST /content/v2.1/{merchantId}/repricingrules
Creates a repricing rule for your Merchant Center account.
delete DELETE /content/v2.1/{merchantId}/repricingrules/{ruleId}
Deletes a repricing rule in your Merchant Center account.
get GET /content/v2.1/{merchantId}/repricingrules/{ruleId}
Retrieves a repricing rule from your Merchant Center account.
list GET /content/v2.1/{merchantId}/repricingrules
Lists the repricing rules in your Merchant Center account.
patch PATCH /content/v2.1/{merchantId}/repricingrules/{ruleId}
Updates a repricing rule in your Merchant Center account.

v2.1.returnaddress

Methods
custombatch POST /content/v2.1/returnaddress/batch
Batches multiple return address related calls in a single request.
delete DELETE /content/v2.1/{merchantId}/returnaddress/{returnAddressId}
Deletes a return address for the given Merchant Center account.
get GET /content/v2.1/{merchantId}/returnaddress/{returnAddressId}
Gets a return address of the Merchant Center account.
insert POST /content/v2.1/{merchantId}/returnaddress
Inserts a return address for the Merchant Center account.
list GET /content/v2.1/{merchantId}/returnaddress
Lists the return addresses of the Merchant Center account.

v2.1.returnpolicy

Methods
custombatch POST /content/v2.1/returnpolicy/batch
Batches multiple return policy related calls in a single request.
delete DELETE /content/v2.1/{merchantId}/returnpolicy/{returnPolicyId}
Deletes a return policy for the given Merchant Center account.
get GET /content/v2.1/{merchantId}/returnpolicy/{returnPolicyId}
Gets a return policy of the Merchant Center account.
insert POST /content/v2.1/{merchantId}/returnpolicy
Inserts a return policy for the Merchant Center account.
list GET /content/v2.1/{merchantId}/returnpolicy
Lists the return policies of the Merchant Center account.

v2.1.settlementreports

Methods
get GET /content/v2.1/{merchantId}/settlementreports/{settlementId}
Retrieves a settlement report from your Merchant Center account.
list GET /content/v2.1/{merchantId}/settlementreports
Retrieves a list of settlement reports from your Merchant Center account.

v2.1.settlementtransactions

Methods
list GET /content/v2.1/{merchantId}/settlementreports/{settlementId}/transactions
Retrieves a list of transactions for the settlement.

v2.1.shippingsettings

Methods
custombatch POST /content/v2.1/shippingsettings/batch
Retrieves and updates the shipping settings of multiple accounts in a single request.
get GET /content/v2.1/{merchantId}/shippingsettings/{accountId}
Retrieves the shipping settings of the account.
getsupportedcarriers GET /content/v2.1/{merchantId}/supportedCarriers
Retrieves supported carriers and carrier services for an account.
getsupportedholidays GET /content/v2.1/{merchantId}/supportedHolidays
Retrieves supported holidays for an account.
getsupportedpickupservices GET /content/v2.1/{merchantId}/supportedPickupServices
Retrieves supported pickup services for an account.
list GET /content/v2.1/{merchantId}/shippingsettings
Lists the shipping settings of the sub-accounts in your Merchant Center account.
update PUT /content/v2.1/{merchantId}/shippingsettings/{accountId}
Updates the shipping settings of the account.