API Reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

Resource types

  1. Accounts
  2. Accountstatuses
  3. Accounttax
  4. Datafeeds
  5. Datafeedstatuses
  6. Inventory
  7. Orders
  8. Products
  9. Productstatuses
  10. Shippingsettings

Accounts

For Accounts Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
authinfo GET  /accounts/authinfo Returns information about the authenticated user.
claimwebsite POST  /merchantId/accounts/accountId/claimwebsite Claims the website of a Merchant Center sub-account.
custombatch POST  /accounts/batch Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.
delete DELETE  /merchantId/accounts/accountId Deletes a Merchant Center sub-account.
get GET  /merchantId/accounts/accountId Retrieves a Merchant Center account.
insert POST  /merchantId/accounts Creates a Merchant Center sub-account.
list GET  /merchantId/accounts Lists the sub-accounts in your Merchant Center account.
patch PATCH  /merchantId/accounts/accountId Updates a Merchant Center account. This method supports patch semantics.
update PUT  /merchantId/accounts/accountId Updates a Merchant Center account.

Accountstatuses

For Accountstatuses Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /accountstatuses/batch
get GET  /merchantId/accountstatuses/accountId Retrieves the status of a Merchant Center account.
list GET  /merchantId/accountstatuses Lists the statuses of the sub-accounts in your Merchant Center account.

Accounttax

For Accounttax Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /accounttax/batch Retrieves and updates tax settings of multiple accounts in a single request.
get GET  /merchantId/accounttax/accountId Retrieves the tax settings of the account.
list GET  /merchantId/accounttax Lists the tax settings of the sub-accounts in your Merchant Center account.
patch PATCH  /merchantId/accounttax/accountId Updates the tax settings of the account. This method supports patch semantics.
update PUT  /merchantId/accounttax/accountId Updates the tax settings of the account.

Datafeeds

For Datafeeds Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /datafeeds/batch
delete DELETE  /merchantId/datafeeds/datafeedId Deletes a datafeed configuration from your Merchant Center account.
get GET  /merchantId/datafeeds/datafeedId Retrieves a datafeed configuration from your Merchant Center account.
insert POST  /merchantId/datafeeds Registers a datafeed configuration with your Merchant Center account.
list GET  /merchantId/datafeeds Lists the datafeeds in your Merchant Center account.
patch PATCH  /merchantId/datafeeds/datafeedId Updates a datafeed configuration of your Merchant Center account. This method supports patch semantics.
update PUT  /merchantId/datafeeds/datafeedId Updates a datafeed configuration of your Merchant Center account.

Datafeedstatuses

For Datafeedstatuses Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /datafeedstatuses/batch
get GET  /merchantId/datafeedstatuses/datafeedId Retrieves the status of a datafeed from your Merchant Center account.
list GET  /merchantId/datafeedstatuses Lists the statuses of the datafeeds in your Merchant Center account.

Inventory

For Inventory Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /inventory/batch Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products.
set POST  /merchantId/inventory/storeCode/products/productId Updates price and availability of a product in your Merchant Center account.

Orders

For Orders Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
acknowledge POST  /merchantId/orders/orderId/acknowledge Marks an order as acknowledged.
advancetestorder POST  /merchantId/testorders/orderId/advance Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment".
cancel POST  /merchantId/orders/orderId/cancel Cancels all line items in an order, making a full refund.
cancellineitem POST  /merchantId/orders/orderId/cancelLineItem Cancels a line item, making a full refund.
createtestorder POST  /merchantId/testorders Sandbox only. Creates a test order.
custombatch POST  /orders/batch Retrieves or modifies multiple orders in a single request.
get GET  /merchantId/orders/orderId Retrieves an order from your Merchant Center account.
getbymerchantorderid GET  /merchantId/ordersbymerchantid/merchantOrderId Retrieves an order using merchant order id.
gettestordertemplate GET  /merchantId/testordertemplates/templateName Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox.
list GET  /merchantId/orders Lists the orders in your Merchant Center account.
refund POST  /merchantId/orders/orderId/refund Initiates a full or partial reversal on the payment instrument.
returnlineitem POST  /merchantId/orders/orderId/returnLineItem Returns a line item.
shiplineitems POST  /merchantId/orders/orderId/shipLineItems Marks line item(s) as shipped.
updatemerchantorderid POST  /merchantId/orders/orderId/updateMerchantOrderId Updates the merchant order ID for a given order.
updateshipment POST  /merchantId/orders/orderId/updateShipment Updates a shipment's status, carrier, and/or tracking ID.

Products

For Products Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /products/batch Retrieves, inserts, and deletes multiple products in a single request.
delete DELETE  /merchantId/products/productId Deletes a product from your Merchant Center account.
get GET  /merchantId/products/productId Retrieves a product from your Merchant Center account.
insert POST  /merchantId/products Uploads a product to your Merchant Center account. If an item with the same channel, contentLanguage, offerId, and targetCountry already exists, this method updates that entry.
list GET  /merchantId/products Lists the products in your Merchant Center account.

Productstatuses

For Productstatuses Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /productstatuses/batch Gets the statuses of multiple products in a single request.
get GET  /merchantId/productstatuses/productId Gets the status of a product from your Merchant Center account.
list GET  /merchantId/productstatuses Lists the statuses of the products in your Merchant Center account.

Shippingsettings

For Shippingsettings Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/content/v2, unless otherwise noted
custombatch POST  /shippingsettings/batch Retrieves and updates the shipping settings of multiple accounts in a single request.
get GET  /merchantId/shippingsettings/accountId Retrieves the shipping settings of the account.
getsupportedcarriers GET  /merchantId/supportedCarriers Retrieves supported carriers and carrier services for an account.
list GET  /merchantId/shippingsettings Lists the shipping settings of the sub-accounts in your Merchant Center account.
patch PATCH  /merchantId/shippingsettings/accountId Updates the shipping settings of the account. This method supports patch semantics.
update PUT  /merchantId/shippingsettings/accountId Updates the shipping settings of the account.

Send feedback about...

Content API for Shopping