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

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: v2.1.orderreturns

Methods
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.

REST Resource: 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.
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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.

REST Resource: 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.