Google Shopping Connector
Manage products, inventory, and orders in Google Merchant Center.
Connections
OAuth2
OAuth2 Connection
To connect to Google Shopping (Content API for Shopping), create an OAuth 2.0 application in the Google Cloud Console and configure the required scopes.
For more information about Google's OAuth 2.0 implementation, refer to the Google Identity Platform documentation.
Prerequisites
- A Google Cloud account with access to the Google API Console
- A Google Cloud project (create one if needed)
- Billing enabled on the project (required for some API features)
Setup Steps
- Navigate to the Google API Console and select or create a project.
- Enable the Content API for Shopping:
- Navigate to APIs & Services > Library
- Search for "Content API for Shopping"
- Select the API and click Enable
- Configure the OAuth consent screen:
- Navigate to APIs & Services > OAuth consent screen
- Select the appropriate user type (Internal for organization-only access or External for public access)
- Fill in the required fields:
- App name: Enter the application or company name
- User support email: Provide a support contact email
- Developer contact information: Add contact details
- Click Save and Continue
- Add OAuth scopes:
- Click Add or Remove Scopes
- Search for "Content API for Shopping"
- Select the following scope:
https://www.googleapis.com/auth/content- View and manage data for Google Shopping
- Click Update and then Save and Continue
- Create OAuth 2.0 credentials:
- Navigate to APIs & Services > Credentials
- Click Create Credentials and select OAuth client ID
- Under Application type, select Web application
- Enter a name for the OAuth client
- Under Authorized redirect URIs, click Add URI and enter:
https://oauth2.integrations.acme.com/callback - Click Create
- Copy the generated Client ID and Client Secret - these values will be used to configure the connection.
To retrieve the Client ID and Secret later, navigate to APIs & Services > Credentials and select the OAuth 2.0 client from the OAuth 2.0 Client IDs section.
Configure the Connection
-
Enter the Client ID and Client Secret from the OAuth 2.0 client
-
For Scopes, use the following value:
https://www.googleapis.com/auth/content- Refer to the Google Content API OAuth scopes documentation for additional scope information
Publishing the OAuth Consent Screen
For production use with external users, the OAuth consent screen must be verified and published by Google. During development and testing, the app can remain in "Testing" mode with a limited number of test users. Refer to Google's OAuth consent screen documentation for publishing requirements.
Testing with Limited Users
While the app is in "Testing" mode, only users added to the test users list can authenticate. Add test users in the OAuth consent screen configuration under Test users.
This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.
| Input | Comments | Default |
|---|---|---|
| Scopes | Space delimited listing of scopes. https://developers.google.com/identity/protocols/oauth2/scopes#content | https://www.googleapis.com/auth/content |
| Client ID | The Google Content app's Client Identifier. | |
| Client Secret | The Google Content app's Client Secret. |
Triggers
Pub/Sub Webhook
Receive push notifications from Google Cloud Pub/Sub for Merchant Center events such as order status changes. Requires a Pub/Sub topic registered with the Content API and a push subscription configured to forward messages to this endpoint.
Actions
Batch Local Inventory
Updates local inventory for multiple products or regions in a single request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Entries for Batch Request | Array of batch entry objects for updating local inventory (in-store product availability and pricing) across multiple stores or products. Each entry must include batchId, merchantId, method, storeCode, and inventory data. See batch request documentation for structure details. |
Batch Product
Retrieves, inserts, and deletes multiple products in a single request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Entries for Batch Request | Array of batch entry objects for performing multiple product operations (get, insert, update, delete) in a single API call. Each entry must include batchId, merchantId, method, and relevant product data. See batch request documentation for structure details. |
Batch Regional Inventory
Updates regional inventory for multiple products or regions in a single request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Entries for Batch Request | Array of batch entry objects for updating regional inventory (availability and pricing for specific geographic regions). Each entry must include batchId, merchantId, method, regionId, and inventory data. See batch request documentation for structure details. |
Cancel Order (Deprecated)
Cancels all line items in an order, making a full refund. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Order Id | The Google-generated order ID. Found in the Merchant Center Orders dashboard or returned when listing orders. This ID is used to retrieve, update, or manage specific order details. | |
| Operation Id | The ID of the operation. Unique across all operations for a given order. | |
| Reason | The reason for the cancellation. | |
| Reason Text | The explanation of the reason. |
Create Account
Creates a Merchant Center sub-account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Name | Display name for the account. | |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Website Url | The merchant's website. | |
| Adult Content | When true, indicates the merchant sells adult content. | false |
| Seller Id | Client-specific, locally-unique, internal ID for the child account. | |
| User | Users with access to the account. Every account (except for subaccounts) must have at least one admin user. | |
| Youtube Channel Links | Linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list. | |
| Google My Business Link | The Business Profile which is linked or in the process of being linked with the Merchant Center account. | |
| Business Information | The business information of the account. | |
| Automatic Improvements | The automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately. | |
| Ads Links | Linked Ads accounts that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected either in the Ads interface or through the Google Ads API. To delete an active link, or to cancel a link request, remove it from the list. | |
| Css Id | ID of the CSS (Comparison Shopping Service) that the account belongs to. CSS is a program allowing third-party shopping comparison services to display product listings. Only applicable for CSS-managed accounts. | |
| Label Ids | Manually created label IDs that are assigned to the account by CSS. | |
| Account Management | Specifies whether account management is manual or automatic. | |
| Automatic Label Ids | Automatically created label IDs that are assigned to the account by CSS Center. | |
| Conversion Settings | Settings for conversion tracking. |
Create Order Return (Deprecated)
Create return in your Merchant Center account. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Order Id | The Google-generated order ID. Found in the Merchant Center Orders dashboard or returned when listing orders. This ID is used to retrieve, update, or manage specific order details. | |
| Operation Id | The ID of the operation. Unique across all operations for a given order. | |
| Line Items | The list of line items to return. | |
| Return Method Type | The way of the package being returned. |
Create Product
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.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Feed Id | The Content API Supplemental Feed ID. If present then product deletion applies to the data in a supplemental feed. If absent, entire product will be deleted. | |
| Offer Id | A unique identifier for the item. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. Only valid unicode characters are accepted. | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| Target Country | The CLDR territory code for the item's country of sale. | |
| External Seller Id | Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account. | |
| Channel | The sales channel for this product. 'online' for products sold through your website with shipping, 'local' for products available at physical store locations for local pickup or in-store purchase. Part of the product ID format. | |
| Feed Label | Feed label for the item. Either targetCountry or feedLabel is required. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). | |
| Title | Title of the product. Should be descriptive and include key attributes like brand, product type, and distinguishing features. Maximum 150 characters recommended for optimal display in search results. | |
| Description | Detailed description of the product including materials, features, care instructions, and benefits. Should provide comprehensive information to help customers make purchasing decisions. Maximum 5,000 characters. | |
| Link | URL directly linking to your item's page on your website. | |
| Image Link | URL of an image of the item. | |
| Additional Image Links | Additional URLs of images of the item. | |
| Lifestyle Image Links | Additional URLs of lifestyle images of the item. Used to explicitly identify images that showcase your item in a real-world context. | |
| Expiration Date | Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in productstatuses as googleExpirationDate and might be earlier if expirationDate is too far in the future. | |
| Adult | When true, indicates the item is targeted towards adults. | false |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Brand | Brand name of the product manufacturer or designer. Required for products with GTIN unless the product is custom-made or a media item (books, movies, music). Maximum 70 characters. | |
| Color | Primary color of the product. Use standardized color names (e.g., 'Blue', 'Navy Blue', 'Red') for consistency. For variants with multiple colors, create separate products with the same itemGroupId. Maximum 100 characters. | |
| Google Product Category | Google's category of the item (see Google product taxonomy). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API. | |
| GTIN | Global Trade Item Number (GTIN) of the item. | |
| Item Group Id | Shared identifier for all variants of the same product. | |
| Material | Primary material composition of the product (e.g., Cotton, Polyester, Leather, Wood). Particularly important for apparel, home goods, and furniture. Can include multiple materials separated by slashes (e.g., 'Cotton/Polyester'). Maximum 200 characters. | |
| MPN | Manufacturer Part Number (MPN) of the item. | |
| Pattern | Visual pattern or print design on the product (e.g., Solid, Striped, Polka Dots, Plaid, Floral). Most relevant for apparel, home textiles, and decorative items. Maximum 100 characters. | |
| Price | Price of the product as an object with 'value' (as string) and 'currency' (ISO 4217 code). This is the regular price before any discounts. Required for online products unless they are out of stock. | |
| Sale Price | Discounted sale price as an object with 'value' (as string) and 'currency' (ISO 4217 code). Must be lower than the regular price. Use with salePriceEffectiveDate to specify when the sale is active. | |
| Sale Price Effective Date | Date range during which the item is on sale | |
| Product Height | The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). | |
| Product Length | The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). | |
| Product Width | The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). | |
| Product Weight | The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive). | |
| Shipping | Array of product-specific shipping rules that override account-level settings. Each rule can specify price, country, region, service class, and handling/transit times. Use this to define unique shipping costs for oversized items, expedited shipping, or region-specific rates. | |
| Shipping Weight | Weight of the item for shipping. | |
| Sizes | Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same itemGroupId value | |
| Taxes | Array of product-specific tax rules that override account-level settings. Each rule defines the tax rate, applicable country/region, whether to tax shipping, and location identifiers. Use this for products with unique tax requirements (e.g., reduced rates for essential goods). | |
| Custom Attributes | A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (for example, { 'name': 'size type', 'value': 'regular' }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions). | |
| Identifier Exists | When true, indicates that an identifier (GTIN, MPN, or brand) exists for the product. Set to false for custom or handmade products. | false |
| Installment | Number and amount of installments to pay for an item. | |
| Multipack | The number of identical products in a merchant-defined multipack. | |
| Custom Label 0 | Custom Label 0 for custom grouping of items in a Shopping campaign. | |
| Custom Label 1 | Custom Label 1 for custom grouping of items in a Shopping campaign. | |
| Custom Label 2 | Custom Label 2 for custom grouping of items in a Shopping campaign. | |
| Custom Label 3 | Custom Label 3 for custom grouping of items in a Shopping campaign. | |
| Custom Label 4 | Custom Label 4 for custom grouping of items in a Shopping campaign. | |
| Is Bundle | When true, indicates the item is a merchant-defined bundle (a custom grouping of different products sold for a single price). | false |
| Mobile Link | URL for the mobile-optimized version of your item's landing page. | |
| Availability Date | The day a pre-ordered product becomes available for delivery, in ISO 8601 format. | |
| Shipping Label | The shipping label of the product, used to group product in account-level shipping rules. | |
| Unit Pricing Measure | The measure and dimension of an item. | |
| Unit Pricing Base Measure | The preference of the denominator of the unit price. | |
| Shipping Length | Length of the item for shipping. | |
| Shipping Width | Width of the item for shipping. | |
| Shipping Height | Height of the item for shipping. | |
| Display Ads Id | An identifier for an item for dynamic remarketing campaigns. | |
| Display Ads Similar Ids | Advertiser-specified recommendations. | |
| Display Ads Title | Title of an item for dynamic remarketing campaigns. | |
| Display Ads Link | URL directly to your item's landing page for dynamic remarketing campaigns. | |
| Display Ads Value | Offer margin for dynamic remarketing campaigns. | |
| Sell On Google Quantity | The quantity of the product that is available for selling on Google. Supported only for online products. | |
| Promotion Ids | The unique ID of a promotion. | |
| Max Handling Time | Maximal product handling time (in business days). | |
| Min Handling Time | Minimal product handling time (in business days). | |
| Cost Of Goods Sold | Cost of goods sold. Used for gross profit reporting. | |
| Source | The source of the offer, that is, how the offer was created. | |
| Included Destinations | The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in excludedDestinations. | |
| Excluded Destinations | The list of destinations to exclude for this target (corresponds to cleared check boxes in Merchant Center). Products that are excluded from all destinations for more than 7 days are automatically deleted. | |
| Ads Grouping | Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. | |
| Ads Labels | Similar to adsGrouping, but only works on CPC. | |
| Ads Redirect | Allows advertisers to override the item URL when the product is shown within the context of Product Ads. | |
| Product Types | Categories of the item (formatted as in product data specification). | |
| Age Group | Target age group of the item. | |
| Availability | Current availability status of the product. Valid values: 'in stock' (available for immediate purchase), 'out of stock' (temporarily unavailable), 'preorder' (available for advance orders), 'backorder' (can be ordered but delayed delivery). | |
| Condition | Physical condition of the product. Valid values: 'new' (brand new, unopened), 'refurbished' (professionally restored to working condition), 'used' (previously owned or opened). Required for all products. | |
| Gender | Target gender of the item. | |
| Size System | System in which the size is specified. Recommended for apparel items. | |
| Size Type | The cut of the item. Recommended for apparel items. | |
| Additional Size Type | Additional cut of the item. Used together with sizeType to represent combined size types for apparel items. | |
| Energy Efficiency Class | The energy efficiency class as defined in EU directive 2010/30/EU. | |
| Min Energy Efficiency Class | The energy efficiency class as defined in EU directive 2010/30/EU. | |
| Max Energy Efficiency Class | The energy efficiency class as defined in EU directive 2010/30/EU. | |
| Tax Category | The tax category of the product. | |
| Transit Time Label | The transit time label of the product, used to group product in account-level transit time tables. | |
| Shopping Ads Excluded Countries | products.list of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in MC feed settings. | |
| Pickup Method | The pick up option for the item. | |
| Pickup Sla | Item store pickup timeline. | |
| Link Template | URL template for merchant hosted local storefront. | |
| Mobile Link Template | URL template for merchant hosted local storefront optimized for mobile devices. | |
| Product Details | Technical specification or additional product details. | |
| Product Highlights | Bullet points describing the most relevant highlights of a product. | |
| Subscription Cost | Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract. | |
| Canonical Link | URL for the canonical version of your item's landing page. | |
| Pause | Publication of this item should be temporarily paused. |
Delete Account
Deletes a Merchant Center sub-account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Account Id | The Merchant Center account ID. For single merchant accounts, this is the same as merchantId. For multi-client accounts, this represents a specific sub-account ID. Found in Merchant Center settings. |
Delete Product
Deletes a product from your Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Product Id | The REST ID of the product in format channel:contentLanguage:targetCountry:offerId (e.g., online:en:US:1234567890). This is automatically generated when a product is created and must be used for updates, deletes, and retrievals. | |
| Feed Id | The Content API Supplemental Feed ID. If present then product deletion applies to the data in a supplemental feed. If absent, entire product will be deleted. |
Get Account
Retrieves a Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Account Id | The Merchant Center account ID. For single merchant accounts, this is the same as merchantId. For multi-client accounts, this represents a specific sub-account ID. Found in Merchant Center settings. | |
| View | Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'. |
Get Order (Deprecated)
Retrieves an order from your Merchant Center account. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Order Id | The Google-generated order ID. Found in the Merchant Center Orders dashboard or returned when listing orders. This ID is used to retrieve, update, or manage specific order details. |
Get Order Return (Deprecated)
Retrieves an order return from your Merchant Center account. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Return Id | Google-generated merchant order return ID. Found in Merchant Center under Orders > Returns or returned when listing order returns. Used to retrieve, update, or process return details. |
Get Product
Retrieves a product from your Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Product Id | The REST ID of the product in format channel:contentLanguage:targetCountry:offerId (e.g., online:en:US:1234567890). This is automatically generated when a product is created and must be used for updates, deletes, and retrievals. |
Get PubSub Notification Settings
Retrieves a Merchant Center account's pubsub notification settings.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. |
List Accounts
Lists the sub-accounts in your Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Max Results | The maximum number of accounts to return in the response, used for paging. | |
| Page Token | The token returned by the previous request's nextPageToken field. Used to retrieve the next page of results when pagination is required. Leave empty for the first request. | |
| View | Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'. | |
| Label | If view is set to 'css', only return accounts that are assigned label with given ID. | |
| Name | If set, only the accounts with the given name (case sensitive) will be returned. | |
| Fetch All | When true, fetches all pages of results using pagination. | false |
List Orders (Deprecated)
Lists the orders in your Merchant Center account. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Max Results | The maximum number of accounts to return in the response, used for paging. | |
| Page Token | The token returned by the previous request's nextPageToken field. Used to retrieve the next page of results when pagination is required. Leave empty for the first request. | |
| Statuses | Obtains orders that match any of the specified statuses. Note: 'active' is a shortcut for pendingShipment and partiallyShipped; 'completed' is a shortcut for shipped, delivered, returned, and canceled. | |
| Placed Date Start | Obtains orders placed after this date (inclusively), in ISO 8601 format. | |
| Placed Date End | Obtains orders placed before this date (inclusively), in ISO 8601 format. | |
| Order By | Order results by placement date in descending or ascending order. | |
| Acknowledged | When true, filters for orders that have been acknowledged. When false, filters for orders that have not been acknowledged. | false |
| Fetch All | When true, fetches all pages of results using pagination. | false |
List Orders Returns (Deprecated)
Lists order returns in your Merchant Center account. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Max Results | The maximum number of accounts to return in the response, used for paging. | |
| Order By | Order results by placement date in descending or ascending order. | |
| Created Start Date | Obtains order returns created after this date (inclusively), in ISO 8601 format. | |
| Created End Date | Obtains order returns created before this date (inclusively), in ISO 8601 format. | |
| Page Token | The token returned by the previous request's nextPageToken field. Used to retrieve the next page of results when pagination is required. Leave empty for the first request. | |
| Shipment Types | Obtains order returns that match any shipment type provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment types. | |
| Shipment Status | Obtains order returns that match any shipment status provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment statuses. | |
| Shipment States | Obtains order returns that match any shipment state provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment states. | |
| Acknowledged | When true, filters for orders that have been acknowledged. When false, filters for orders that have not been acknowledged. | false |
| Google Order Ids | Obtains order returns with the specified order ids. If this parameter is provided, createdStartDate, createdEndDate, shipmentType, shipmentStatus, shipmentState and acknowledged parameters must be not set. Note: if googleOrderId and shipmentTrackingNumber parameters are provided, the obtained results will include all order returns that either match the specified order id or the specified tracking number. | |
| Shipping Tracking Numbers | Obtains order returns with the specified tracking numbers. If this parameter is provided, createdStartDate, createdEndDate, shipmentType, shipmentStatus, shipmentState and acknowledged parameters must be not set. Note: if googleOrderId and shipmentTrackingNumber parameters are provided, the obtained results will include all order returns that either match the specified order id or the specified tracking number. | |
| Fetch All | When true, fetches all pages of results using pagination. | false |
List Products
Lists the products in your Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Max Results | The maximum number of accounts to return in the response, used for paging. | |
| Page Token | The token returned by the previous request's nextPageToken field. Used to retrieve the next page of results when pagination is required. Leave empty for the first request. | |
| Fetch All | When true, fetches all pages of results using pagination. | false |
Process Order Return (Deprecated)
Processes return in your Merchant Center account. This action is deprecated as Google is retiring the Orders endpoints in the Content API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Return Id | Google-generated merchant order return ID. Found in Merchant Center under Orders > Returns or returned when listing order returns. Used to retrieve, update, or process return details. | |
| Operation Id | The ID of the operation. Unique across all operations for a given order. | |
| Return Items | The list of items to return. | |
| Full Charge Return Shipping Cost | When true, the customer will be charged for return shipping costs. | false |
| Refund Shipping Fee | Refunds for original shipping fee. |
Raw Request
Send raw HTTP request to Google Content Shopping
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| API Version | The API version to use. This is used to construct the base URL for the request. | v2.1 |
| URL | Input the path only (/{merchantId}/accounts), The base URL is already included (https://shoppingcontent.googleapis.com/content/{version}). For example, to connect to https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts, only /{merchantId}/accounts is entered in this field. | |
| Method | The HTTP method to use. | |
| Data | The HTTP body payload to send to the URL. | |
| Form Data | The Form Data to be sent as a multipart form upload. | |
| File Data | File Data to be sent as a multipart form upload. | |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Header | A list of headers to send with the request. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Timeout | The maximum time that a client will await a response to its request | |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Update Account
Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Account Id | The Merchant Center account ID. For single merchant accounts, this is the same as merchantId. For multi-client accounts, this represents a specific sub-account ID. Found in Merchant Center settings. | |
| Name | Display name for the account. | |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Website Url | The merchant's website. | |
| Adult Content | When true, indicates the merchant sells adult content. | false |
| Seller Id | Client-specific, locally-unique, internal ID for the child account. | |
| User | Users with access to the account. Every account (except for subaccounts) must have at least one admin user. | |
| Youtube Channel Links | Linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list. | |
| Google My Business Link | The Business Profile which is linked or in the process of being linked with the Merchant Center account. | |
| Business Information | The business information of the account. | |
| Automatic Improvements | The automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately. | |
| Ads Links | Linked Ads accounts that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected either in the Ads interface or through the Google Ads API. To delete an active link, or to cancel a link request, remove it from the list. | |
| Css Id | ID of the CSS (Comparison Shopping Service) that the account belongs to. CSS is a program allowing third-party shopping comparison services to display product listings. Only applicable for CSS-managed accounts. | |
| Label Ids | Manually created label IDs that are assigned to the account by CSS. | |
| Account Management | Specifies whether account management is manual or automatic. | |
| Automatic Label Ids | Automatically created label IDs that are assigned to the account by CSS Center. | |
| Conversion Settings | Settings for conversion tracking. |
Update Product
Updates an existing product in your Merchant Center account. Only updates attributes provided in the request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Product Id | The REST ID of the product in format channel:contentLanguage:targetCountry:offerId (e.g., online:en:US:1234567890). This is automatically generated when a product is created and must be used for updates, deletes, and retrievals. | |
| Offer Id | A unique identifier for the item. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. Only valid unicode characters are accepted. | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| Target Country | The CLDR territory code for the item's country of sale. | |
| External Seller Id | Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account. | |
| Channel | The sales channel for this product. 'online' for products sold through your website with shipping, 'local' for products available at physical store locations for local pickup or in-store purchase. Part of the product ID format. | |
| Feed Label | Feed label for the item. Either targetCountry or feedLabel is required. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). | |
| Title | Title of the product. Should be descriptive and include key attributes like brand, product type, and distinguishing features. Maximum 150 characters recommended for optimal display in search results. | |
| Description | Detailed description of the product including materials, features, care instructions, and benefits. Should provide comprehensive information to help customers make purchasing decisions. Maximum 5,000 characters. | |
| Link | URL directly linking to your item's page on your website. | |
| Image Link | URL of an image of the item. | |
| Additional Image Links | Additional URLs of images of the item. | |
| Lifestyle Image Links | Additional URLs of lifestyle images of the item. Used to explicitly identify images that showcase your item in a real-world context. | |
| Expiration Date | Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in productstatuses as googleExpirationDate and might be earlier if expirationDate is too far in the future. | |
| Adult | When true, indicates the item is targeted towards adults. | false |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Brand | Brand name of the product manufacturer or designer. Required for products with GTIN unless the product is custom-made or a media item (books, movies, music). Maximum 70 characters. | |
| Color | Primary color of the product. Use standardized color names (e.g., 'Blue', 'Navy Blue', 'Red') for consistency. For variants with multiple colors, create separate products with the same itemGroupId. Maximum 100 characters. | |
| Google Product Category | Google's category of the item (see Google product taxonomy). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API. | |
| GTIN | Global Trade Item Number (GTIN) of the item. | |
| Item Group Id | Shared identifier for all variants of the same product. | |
| Material | Primary material composition of the product (e.g., Cotton, Polyester, Leather, Wood). Particularly important for apparel, home goods, and furniture. Can include multiple materials separated by slashes (e.g., 'Cotton/Polyester'). Maximum 200 characters. | |
| MPN | Manufacturer Part Number (MPN) of the item. | |
| Pattern | Visual pattern or print design on the product (e.g., Solid, Striped, Polka Dots, Plaid, Floral). Most relevant for apparel, home textiles, and decorative items. Maximum 100 characters. | |
| Price | Price of the product as an object with 'value' (as string) and 'currency' (ISO 4217 code). This is the regular price before any discounts. Required for online products unless they are out of stock. | |
| Sale Price | Discounted sale price as an object with 'value' (as string) and 'currency' (ISO 4217 code). Must be lower than the regular price. Use with salePriceEffectiveDate to specify when the sale is active. | |
| Sale Price Effective Date | Date range during which the item is on sale | |
| Product Height | The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). | |
| Product Length | The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). | |
| Product Width | The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). | |
| Product Weight | The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive). | |
| Shipping | Array of product-specific shipping rules that override account-level settings. Each rule can specify price, country, region, service class, and handling/transit times. Use this to define unique shipping costs for oversized items, expedited shipping, or region-specific rates. | |
| Shipping Weight | Weight of the item for shipping. | |
| Sizes | Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same itemGroupId value | |
| Taxes | Array of product-specific tax rules that override account-level settings. Each rule defines the tax rate, applicable country/region, whether to tax shipping, and location identifiers. Use this for products with unique tax requirements (e.g., reduced rates for essential goods). | |
| Custom Attributes | A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (for example, { 'name': 'size type', 'value': 'regular' }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions). | |
| Identifier Exists | When true, indicates that an identifier (GTIN, MPN, or brand) exists for the product. Set to false for custom or handmade products. | false |
| Installment | Number and amount of installments to pay for an item. | |
| Multipack | The number of identical products in a merchant-defined multipack. | |
| Custom Label 0 | Custom Label 0 for custom grouping of items in a Shopping campaign. | |
| Custom Label 1 | Custom Label 1 for custom grouping of items in a Shopping campaign. | |
| Custom Label 2 | Custom Label 2 for custom grouping of items in a Shopping campaign. | |
| Custom Label 3 | Custom Label 3 for custom grouping of items in a Shopping campaign. | |
| Custom Label 4 | Custom Label 4 for custom grouping of items in a Shopping campaign. | |
| Is Bundle | When true, indicates the item is a merchant-defined bundle (a custom grouping of different products sold for a single price). | false |
| Mobile Link | URL for the mobile-optimized version of your item's landing page. | |
| Availability Date | The day a pre-ordered product becomes available for delivery, in ISO 8601 format. | |
| Shipping Label | The shipping label of the product, used to group product in account-level shipping rules. | |
| Unit Pricing Measure | The measure and dimension of an item. | |
| Unit Pricing Base Measure | The preference of the denominator of the unit price. | |
| Shipping Length | Length of the item for shipping. | |
| Shipping Width | Width of the item for shipping. | |
| Shipping Height | Height of the item for shipping. | |
| Display Ads Id | An identifier for an item for dynamic remarketing campaigns. | |
| Display Ads Similar Ids | Advertiser-specified recommendations. | |
| Display Ads Title | Title of an item for dynamic remarketing campaigns. | |
| Display Ads Link | URL directly to your item's landing page for dynamic remarketing campaigns. | |
| Display Ads Value | Offer margin for dynamic remarketing campaigns. | |
| Sell On Google Quantity | The quantity of the product that is available for selling on Google. Supported only for online products. | |
| Promotion Ids | The unique ID of a promotion. | |
| Max Handling Time | Maximal product handling time (in business days). | |
| Min Handling Time | Minimal product handling time (in business days). | |
| Cost Of Goods Sold | Cost of goods sold. Used for gross profit reporting. | |
| Source | The source of the offer, that is, how the offer was created. | |
| Included Destinations | The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in excludedDestinations. | |
| Excluded Destinations | The list of destinations to exclude for this target (corresponds to cleared check boxes in Merchant Center). Products that are excluded from all destinations for more than 7 days are automatically deleted. | |
| Ads Grouping | Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. | |
| Ads Labels | Similar to adsGrouping, but only works on CPC. | |
| Ads Redirect | Allows advertisers to override the item URL when the product is shown within the context of Product Ads. | |
| Product Types | Categories of the item (formatted as in product data specification). | |
| Age Group | Target age group of the item. | |
| Availability | Current availability status of the product. Valid values: 'in stock' (available for immediate purchase), 'out of stock' (temporarily unavailable), 'preorder' (available for advance orders), 'backorder' (can be ordered but delayed delivery). | |
| Condition | Physical condition of the product. Valid values: 'new' (brand new, unopened), 'refurbished' (professionally restored to working condition), 'used' (previously owned or opened). Required for all products. | |
| Gender | Target gender of the item. | |
| Size System | System in which the size is specified. Recommended for apparel items. | |
| Size Type | The cut of the item. Recommended for apparel items. | |
| Additional Size Type | Additional cut of the item. Used together with sizeType to represent combined size types for apparel items. | |
| Energy Efficiency Class | The energy efficiency class as defined in EU directive 2010/30/EU. | |
| Min Energy Efficiency Class | The energy efficiency class as defined in EU directive 2010/30/EU. | |
| Max Energy Efficiency Class | The energy efficiency class as defined in EU directive 2010/30/EU. | |
| Tax Category | The tax category of the product. | |
| Transit Time Label | The transit time label of the product, used to group product in account-level transit time tables. | |
| Shopping Ads Excluded Countries | products.list of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in MC feed settings. | |
| Pickup Method | The pick up option for the item. | |
| Pickup Sla | Item store pickup timeline. | |
| Link Template | URL template for merchant hosted local storefront. | |
| Mobile Link Template | URL template for merchant hosted local storefront optimized for mobile devices. | |
| Product Details | Technical specification or additional product details. | |
| Product Highlights | Bullet points describing the most relevant highlights of a product. | |
| Subscription Cost | Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract. | |
| Canonical Link | URL for the canonical version of your item's landing page. | |
| Pause | Publication of this item should be temporarily paused. | |
| Update Mask | Comma-separated list of product attributes to update. Attributes in the mask without values will be deleted. Only top-level attributes can be updated. |
Update Product Local Inventory
Updates the local inventory of a product in your Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Product Id | The REST ID of the product in format channel:contentLanguage:targetCountry:offerId (e.g., online:en:US:1234567890). This is automatically generated when a product is created and must be used for updates, deletes, and retrievals. | |
| Store Code | Store code that identifies a specific physical retail location. This code is defined when configuring stores in Merchant Center under Settings > Business information > Store codes. Used for local inventory management. | |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Price | Price of the product as an object with 'value' (as string) and 'currency' (ISO 4217 code). This is the regular price before any discounts. Required for online products unless they are out of stock. | |
| Sale Price | Discounted sale price as an object with 'value' (as string) and 'currency' (ISO 4217 code). Must be lower than the regular price. Use with salePriceEffectiveDate to specify when the sale is active. | |
| Sale Price Effective Date | Date range during which the item is on sale | |
| Availability | Current availability status of the product. Valid values: 'in stock' (available for immediate purchase), 'out of stock' (temporarily unavailable), 'preorder' (available for advance orders), 'backorder' (can be ordered but delayed delivery). | |
| Quantity | Quantity of the product. Must be nonnegative. | |
| Pickup Method | The pick up option for the item. | |
| Pickup Sla | Item store pickup timeline. | |
| Instore Product Location | In-store product location. | |
| Custom Attributes | A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (for example, { 'name': 'size type', 'value': 'regular' }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions). |
Update Product Regional Inventory
Updates the regional inventory of a product in your Merchant Center account. If a regional inventory with the same region ID already exists, this method updates that entry.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Product Id | The REST ID of the product in format channel:contentLanguage:targetCountry:offerId (e.g., online:en:US:1234567890). This is automatically generated when a product is created and must be used for updates, deletes, and retrievals. | |
| Region Id | The numeric ID identifying a specific geographic region defined in Merchant Center. Regions are configured under Settings > Shipping and returns and can represent custom geographic areas for regional inventory and pricing. | |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Price | Price of the product as an object with 'value' (as string) and 'currency' (ISO 4217 code). This is the regular price before any discounts. Required for online products unless they are out of stock. | |
| Sale Price | Discounted sale price as an object with 'value' (as string) and 'currency' (ISO 4217 code). Must be lower than the regular price. Use with salePriceEffectiveDate to specify when the sale is active. | |
| Sale Price Effective Date | Date range during which the item is on sale | |
| Availability | Current availability status of the product. Valid values: 'in stock' (available for immediate purchase), 'out of stock' (temporarily unavailable), 'preorder' (available for advance orders), 'backorder' (can be ordered but delayed delivery). | |
| Custom Attributes | A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (for example, { 'name': 'size type', 'value': 'regular' }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions). |
Update PubSub Notification
Register a Merchant Center account for pubsub notifications. Note that cloud topic name shouldn't be provided as part of the request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Merchant Id | The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. | |
| Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
| Cloud Topic Name | Cloud pub/sub topic to which notifications are sent (read-only). | |
| Registered Events | List of event types. |