Google Shopping Connector
Google Merchant Center lets merchants manage the product listings, inventory, and account settings that power Shopping ads and free listings. This component enables uploading products, managing local and regional inventory, configuring notification subscriptions, and managing Merchant Center accounts.
The component supports two API generations side by side:
- Google Merchant API actions (labeled (Merchant v1)) are current and should be used for all new automations.
- Content API for Shopping v2.1 actions (labeled (Legacy v2.1)) are legacy and retained for existing flows; Google is shutting this API down on August 18, 2026.
For migration steps, affected actions, and their Merchant API replacements, refer to the migration instructions in the OAuth 2.0 connection setup.
API Documentation
This component was built using the Google Merchant API and the legacy Content API for Shopping v2.1.
Connections
OAuth 2.0
Authenticate using OAuth 2.0.
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
App Verification
Google requires OAuth apps that request access to user data to pass a verification review before being deployed at scale. This process ensures the app complies with Google's API Services User Data Policy, accurately represents its functionality, and handles user data responsibly.
Google OAuth apps pass through three stages before they are ready for production use.
Testing (unpublished): The app is only accessible to users manually added as test users in the OAuth consent screen. Up to 100 test users are allowed. All other users receive an error. This is the expected state during initial development.
Published, unverified: After publishing the app, all Google users can authenticate. However, for sensitive scopes, users see a "This app isn't verified" warning. Users can proceed by clicking Advanced → Go to [app name] (unsafe), but this warning reduces trust and may be blocked by organizations with strict Google Workspace policies.
Verified: Google has reviewed and approved the app. No warning is shown. Verification is required before deploying to production users.
Publishing the App
Publishing is required before any users outside the test list can authenticate:
- In the Google Cloud Console, navigate to APIs & Services → OAuth consent screen
- Click PUBLISH APP and confirm
Requesting Verification
The scopes used by this component are classified as sensitive by Google. Submitting for verification removes the "This app isn't verified" warning:
- On the OAuth consent screen, click Prepare for verification
- Provide a privacy policy URL, authorized domain, and app logo
- Submit for review. Google typically responds within several weeks
Refer to Google's OAuth consent screen documentation for the full verification requirements.
Migrating to the Merchant API
Google is replacing the Content API for Shopping with the Merchant API, its official successor. The Content API for Shopping will be sunset on August 18, 2026, after which the v2.1-based actions built on the Content API will stop working. Migrate any flows that use v2.1 (Content API) actions to their Merchant API (v1) equivalents before that date. Refer to the Merchant API migration guide for detailed guidance.
Merchants who need more time can apply for extended access to the Content API for Shopping using the request form linked from the Merchant API migration guide.
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-separated OAuth permission scopes. See Google Content API scopes documentation for available scopes. | https://www.googleapis.com/auth/content |
| Client ID | The Client ID from your Google Cloud Console OAuth 2.0 credentials. Navigate to APIs & Services > Credentials to find this value. | |
| Client Secret | The Client Secret from your Google Cloud Console OAuth 2.0 credentials. Keep this value secure. |
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 (Legacy v2.1)
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 Local Inventory (Merchant v1)
Upserts local inventory for multiple stores of a product in parallel, replacing the removed Content API custombatch and returning a per-item result list.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. | |
| Inventory Entries | Array of inventory objects to upsert for the product. Local entries must include storeCode; regional entries must include region. Items are submitted as parallel inserts. |
Batch Product (Legacy v2.1)
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 (Legacy v2.1)
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. |
Batch Regional Inventory (Merchant v1)
Upserts regional inventory for multiple regions of a product in parallel, replacing the removed Content API custombatch and returning a per-item result list.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. | |
| Inventory Entries | Array of inventory objects to upsert for the product. Local entries must include storeCode; regional entries must include region. Items are submitted as parallel inserts. |
Batch Upsert Products (Merchant v1)
Upserts multiple product inputs in parallel, replacing the removed Content API custombatch with bounded parallel inserts and returning a per-item result list.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Data Source | The API data source that owns the product input. Accepts a data source id or a full resource name (e.g. accounts/123/dataSources/456). Product writes require a data source of type API. | |
| Product Inputs | Array of product input objects to upsert. Each entry must include offerId, contentLanguage, feedLabel, and an attributes object. Items are submitted as parallel inserts. |
Cancel Order (Legacy v2.1)
Cancels all line items in an order, making a full refund.
| 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 (Legacy v2.1)
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 account's business details, including physical address, phone number, customer service contacts, and business registration numbers. | |
| 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 Account (Merchant v1)
Creates and configures a new Merchant Center account, requiring at least one service relationship (e.g. account aggregation under your advanced account).
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account Name | Human-readable business name of the Merchant Center account. | |
| Service | Account service relationships to establish. At least one is required. For a sub-account under an advanced (aggregator) account, choose Account Aggregation and set the provider to the aggregator account resource name (e.g. accounts/123456789). | |
| Service Type | The type of service relationship to establish. | |
| Provider | Reference to the provider account, e.g. "providers/123" or "accounts/123456789". | |
| External Account ID | The external account identifier for the service. | |
| Adult Content | When true, indicates the merchant sells adult content. | false |
| Time Zone ID | The account's IANA time zone id for display and reporting (e.g. "America/Los_Angeles"). | |
| Language Code | The account's BCP-47 language code, used for display and reporting (e.g. en-US). | |
| Users | Users with access to the account. Every account (except for subaccounts) must have at least one admin user. | |
| Email Address | The email address of the user. | |
| Admin | Whether the user has admin access. | false |
| Order Manager | Whether the user can manage orders. | false |
| Payments Manager | Whether the user can manage payment settings. | false |
| Payments Analyst | Whether the user can view payment information. | false |
| Reporting Manager | Whether the user can manage reporting. | false |
Create Notification Subscription (Merchant v1)
Creates a notification subscription for a Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Registered Event | The event the subscription is registered for. | PRODUCT_STATUS_CHANGE |
| Callback URI | The URL where notifications will be delivered via HTTPS POST. | |
| Target Account | Subscribe to notifications for a single sub-account (e.g. accounts/123456789). Leave empty to subscribe for all managed accounts instead. | |
| All Managed Accounts | When true, subscribe to notifications for all sub-accounts of the calling account. Ignored when a Target Account is provided. | true |
Create Order Return (Legacy v2.1)
Creates a return in the 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. | |
| 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 (Legacy v2.1)
Uploads a product to the Merchant Center account, updating any existing item with the same channel, contentLanguage, offerId, and targetCountry.
| 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 for a marketplace uploading products for various sellers to a multi-seller account. | |
| Channel | The sales channel for this product. 'online' for products sold through the merchant 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 the item's page on the merchant 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 the 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 | |
| Dimensions | Physical dimensions of the product: length, width, height, and weight. | |
| 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 Height | The height 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. | |
| 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 the 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 Dimensions | Physical dimensions of the item for shipping: length, width, height, and weight. | |
| Shipping Length | Length of the item for shipping. | |
| Shipping Width | Width of the item for shipping. | |
| Shipping Height | Height of the item for shipping. | |
| Shipping Weight | Weight 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 the 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 the item's landing page. | |
| Pause | Publication of this item should be temporarily paused. |
Create Product (Merchant v1)
Upserts a product input to the Merchant Center account, replacing any existing product input with the same offer id, content language and feed label.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Data Source | The API data source that owns the product input. Accepts a data source id or a full resource name (e.g. accounts/123/dataSources/456). Product writes require a data source of type API. | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. | |
| Attributes | The product attributes as a JSON object. Prices use the Merchant API format { amountMicros, currencyCode } (e.g. 15.99 USD = amountMicros "15990000"). | |
| 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). |
Delete Account (Legacy v2.1)
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 Account (Merchant v1)
Deletes a Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). |
Delete Product (Legacy v2.1)
Deletes a product from the 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. |
Delete Product (Merchant v1)
Deletes a product input from the Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Data Source | The API data source that owns the product input. Accepts a data source id or a full resource name (e.g. accounts/123/dataSources/456). Product writes require a data source of type API. | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. |
Get Account (Legacy v2.1)
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 Account (Merchant v1)
Retrieves a Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). |
Get Order (Legacy v2.1)
Retrieves an order from the 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. | |
| 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 (Legacy v2.1)
Retrieves an order return from the 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. | |
| 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 (Legacy v2.1)
Retrieves a product from the 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 Product (Merchant v1)
Retrieves a processed product from the Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. |
Get Pub/Sub Notification Settings (Legacy v2.1)
Retrieves a Merchant Center account's Pub/Sub 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 (Legacy v2.1)
Lists the sub-accounts in the 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. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Controls for paging through large result sets. | |
| 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. |
List Accounts (Merchant v1)
Lists the Merchant Center accounts accessible to the authenticated user.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Page Size | The maximum number of results to return per page. Ignored when Fetch All is enabled. | |
| 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. |
List Notification Subscriptions (Merchant v1)
Lists the notification subscriptions for a Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Page Size | The maximum number of results to return per page. Ignored when Fetch All is enabled. | |
| 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. |
List Orders (Legacy v2.1)
Lists the orders in the 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. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Controls for paging through large result sets. | |
| 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 |
List Orders Returns (Legacy v2.1)
Lists order returns in the 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. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Controls for paging through large result sets. | |
| 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. | |
| 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. | |
| 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. |
List Products (Legacy v2.1)
Lists the products in the 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. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Controls for paging through large result sets. | |
| 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. |
List Products (Merchant v1)
Lists the processed products in the Merchant Center account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Page Size | The maximum number of results to return per page. Ignored when Fetch All is enabled. | |
| 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. |
Process Order Return (Legacy v2.1)
Processes a return in the 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. | |
| 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 (Legacy v2.1)
Send a raw HTTP request to the Google Content API.
| 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 |
Raw Request (Merchant v1)
Send a raw HTTP request to the Google Merchant API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| URL | Input the path only, including the sub-API and version segment. The base URL (https://merchantapi.googleapis.com) is already included. For example, to call https://merchantapi.googleapis.com/accounts/v1/accounts/123456789, enter /accounts/v1/accounts/123456789. | |
| 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 (Legacy v2.1)
Updates a Merchant Center account, deleting any fields that are not provided 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 account's business details, including physical address, phone number, customer service contacts, and business registration numbers. | |
| 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 Account (Merchant v1)
Updates a Merchant Center account, using Update Mask to control which fields are applied.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Account Name | Human-readable business name of the Merchant Center account. | |
| Time Zone ID | The account's IANA time zone id for display and reporting (e.g. "America/Los_Angeles"). | |
| Language Code | The account's BCP-47 language code, used for display and reporting (e.g. en-US). | |
| Update Mask | Comma-separated list of fields to update (e.g. accountName,timeZone,languageCode). Fields omitted from the mask are left unchanged. |
Update Product (Legacy v2.1)
Updates an existing product in the Merchant Center account, only updating 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 for a marketplace uploading products for various sellers to a multi-seller account. | |
| Channel | The sales channel for this product. 'online' for products sold through the merchant 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 the item's page on the merchant 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 the 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 | |
| Dimensions | Physical dimensions of the product: length, width, height, and weight. | |
| 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 Height | The height 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. | |
| 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 the 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 Dimensions | Physical dimensions of the item for shipping: length, width, height, and weight. | |
| Shipping Length | Length of the item for shipping. | |
| Shipping Width | Width of the item for shipping. | |
| Shipping Height | Height of the item for shipping. | |
| Shipping Weight | Weight 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 the 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 the 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 (Legacy v2.1)
Updates the local inventory of a product in the 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 | The physical location of the product within the store, such as an aisle or shelf reference. | |
| 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 Local Inventory (Merchant v1)
Inserts or updates the local inventory of a product for a store, where inserting replaces an existing entry with the same store code.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. | |
| 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. | |
| Inventory | The inventory fields as a JSON object. Local supports availability, price, quantity, pickupMethod, pickupSla, instoreProductLocation, salePrice. Regional supports availability, price, salePrice, customAttributes. Prices use { amountMicros, currencyCode }. |
Update Product (Merchant v1)
Updates a product input in the Merchant Center account, using Update Mask to control which attributes are applied.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Data Source | The API data source that owns the product input. Accepts a data source id or a full resource name (e.g. accounts/123/dataSources/456). Product writes require a data source of type API. | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. | |
| Attributes | The product attributes as a JSON object. Prices use the Merchant API format { amountMicros, currencyCode } (e.g. 15.99 USD = amountMicros "15990000"). | |
| 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 Mask | Comma-separated list of fields to update (e.g. productAttributes.title,productAttributes.price). Fields omitted from the mask are left unchanged. |
Update Product Regional Inventory (Legacy v2.1)
Updates the regional inventory of a product in the Merchant Center account, updating any existing regional inventory with the same region ID.
| 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 Product Regional Inventory (Merchant v1)
Inserts or updates the regional inventory of a product for a region, where inserting replaces an existing entry with the same region.
| Input | Comments | Default |
|---|---|---|
| Connection | The Google Content Shopping connection to use. | |
| Account | The Merchant Center account. Accepts a numeric account ID (e.g. 123456789) or a full resource name (e.g. accounts/123456789). | |
| Content Language | The two-letter ISO 639-1 language code for the item. | |
| 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 (-). | |
| 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. | |
| Region | The geographic region id this regional inventory applies to, as defined in Merchant Center. | |
| Inventory | The inventory fields as a JSON object. Local supports availability, price, quantity, pickupMethod, pickupSla, instoreProductLocation, salePrice. Regional supports availability, price, salePrice, customAttributes. Prices use { amountMicros, currencyCode }. |
Update Pub/Sub Notification (Legacy v2.1)
Registers a Merchant Center account for Pub/Sub notifications, where cloud topic name should not 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. |