Skip to main content

Google Shopping Component

Manage products, inventory, and orders in Google Merchant Center.

Component key: google-content-shopping

Changelog ↓

Description​

The Google Content API for Shopping is a RESTful service for managing product listings, inventory, and orders in Google Merchant Center. This component enables you to upload products, manage inventory levels, and handle orders and returns.

API Documentation​

This component was built using the Google Content API for Shopping v2.1.

Connections​

OAuth2​

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​

  1. Navigate to the Google API Console and select or create a project.
  2. Enable the Content API for Shopping:
    • Navigate to APIs & Services > Library
    • Search for "Content API for Shopping"
    • Select the API and click Enable
  3. 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
  4. 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
  5. 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.prismatic.io/callback
    • Click Create
  6. 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
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.

InputNotesExample
Authorize URL

The Authorization URL for Google Content.

https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
Client ID

The Google Content app's Client Identifier.

Client Secret

The Google Content app's Client Secret.

Scopes

Space delimited listing of scopes. https://developers.google.com/identity/protocols/oauth2/scopes#content

https://www.googleapis.com/auth/content
Token URL

The Token URL for Google Content.

https://oauth2.googleapis.com/token

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. | key: pubSubWebhook

A Google Shopping Pub/Sub notification webhook can be configured to send information to a flow's webhook URL when order events occur in Google Merchant Center.

This trigger receives webhook requests from Google Cloud Pub/Sub for manually configured push notification subscriptions. When an order is created or other registered events occur, Google publishes notifications to a configured Cloud Pub/Sub topic, which then pushes the notification to this trigger's webhook URL.

How It Works​

Google Shopping push notifications use Google Cloud Pub/Sub as the delivery mechanism:

  1. Register a Merchant Center account for push notifications using the Update PubSub Notification action
  2. Google returns a cloudTopicName that will receive event notifications
  3. Configure a Cloud Pub/Sub push subscription pointing to this trigger's webhook URL
  4. When events occur in the Merchant Center (order creation, etc.), Google publishes messages to the topic
  5. Cloud Pub/Sub delivers the messages to this trigger via HTTP POST

Configuration Requirements​

To use this trigger, configure the following components externally:

1. Create a Cloud Pub/Sub Topic

In the Google Cloud console:

  1. Navigate to Pub/Sub (Navigation Menu > More Products > Analytics > Pub/Sub)
  2. Click Topics > Create Topic
  3. Enter a Topic ID (example: merchant-notifications)
  4. Leave default values for remaining options
  5. Click Create

A new topic and default subscription are created.

2. Register the Merchant Center Account

Use the Update PubSub Notification action with:

  • Merchant ID: The Merchant Center account ID
  • Cloud Topic Name: Full topic name (example: projects/my-project/topics/merchant-notifications)
  • Registered Events: List of event types to monitor (example: ["OrderStatusChangeEvent"])

The action registers the merchant account with Google's push notification service.

3. Create a Push Subscription

In the Google Cloud console:

  1. Navigate to Pub/Sub > Subscriptions
  2. Click Create subscription
  3. Enter a Subscription ID (example: merchant-webhook-sub)
  4. Select the topic created in step 1
  5. For Delivery type, select Push
  6. Enter the Endpoint URL: Use this trigger's webhook URL from the integration instance
  7. Leave default values for remaining options
  8. Click Create

Cloud Pub/Sub will now push messages from the topic to this trigger's webhook URL.

Event Types​

The following event types can be registered for notifications:

  • OrderStatusChangeEvent - Triggered when an order status changes in Merchant Center

Additional event types may be available. Refer to the Content API for Shopping documentation for the complete list of supported events.

Notification Payload​

Cloud Pub/Sub delivers notifications as HTTP POST requests with a JSON payload containing:

{
  "message": {
    "data": "<base64-encoded-event-data>",
    "messageId": "message-id",
    "publishTime": "2024-01-15T10:30:00.123Z"
  },
  "subscription": "projects/my-project/subscriptions/merchant-webhook-sub"
}

The message.data field contains base64-encoded event information that can be decoded to access:

  • Event type
  • Merchant ID
  • Order details (for order events)
  • Timestamp
  • Additional event-specific data

Return Data​

The trigger returns the complete notification payload, including:

  • message - The Pub/Sub message object with encoded data
  • subscription - The subscription path that delivered the notification

Process the message.data field using a Base64 Decode action or custom code to extract event details.

Notes​

  • The trigger automatically responds with HTTP 200 to acknowledge receipt of notifications
  • Google Cloud Pub/Sub retries delivery if the endpoint is unreachable or returns an error
  • Subscriptions can be configured with message retention, retry policies, and expiration settings
  • The Get PubSub Notification Settings action retrieves current notification configuration for a merchant account
  • This trigger supports both webhook delivery and scheduled execution modes
  • Update PubSub Notification - Register a merchant account for push notifications and specify event types
  • Get PubSub Notification Settings - Retrieve current notification configuration for a merchant account

Additional Resources​

Actions​

Batch Local Inventory​

Updates local inventory for multiple products or regions in a single request. | key: batchLocalInventory

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

{
  "data": {
    "entries": [
      {
        "batchId": 1,
        "localinventory": {
          "storeCode": "STORE_001",
          "price": {
            "value": "29.99",
            "currency": "USD"
          },
          "availability": "in stock",
          "quantity": 50
        }
      },
      {
        "batchId": 2,
        "localinventory": {
          "storeCode": "STORE_002",
          "availability": "out of stock"
        }
      }
    ]
  }
}

Batch Product​

Retrieves, inserts, and deletes multiple products in a single request. | key: batchProduct

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

{
  "data": {
    "kind": "content#productsCustomBatchResponse",
    "entries": [
      {
        "batchId": 1,
        "product": {
          "kind": "content#product",
          "id": "online:en:US:1111111111",
          "offerId": "1111111111",
          "title": "Google Organic Cotton T-Shirt",
          "description": "Comfortable organic cotton t-shirt with Google logo. Available in multiple sizes and colors.",
          "link": "https://example.com/products/google-tshirt",
          "imageLink": "https://example.com/images/google-tshirt-primary.jpg",
          "additionalImageLinks": [
            "https://example.com/images/google-tshirt-back.jpg",
            "https://example.com/images/google-tshirt-detail.jpg"
          ],
          "contentLanguage": "en",
          "targetCountry": "US",
          "feedLabel": "US",
          "channel": "online",
          "expirationDate": "2025-12-31",
          "adult": false,
          "brand": "Google",
          "color": "Navy Blue",
          "googleProductCategory": "Apparel & Accessories > Clothing > Shirts & Tops",
          "gtin": "00012345678905",
          "itemGroupId": "google_tshirt_group",
          "material": "100% Organic Cotton",
          "mpn": "GOOG-TS-001",
          "pattern": "Solid",
          "price": {
            "value": "29.99",
            "currency": "USD"
          },
          "salePrice": {
            "value": "24.99",
            "currency": "USD"
          },
          "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
          "availability": "in stock",
          "availabilityDate": "2025-01-15",
          "condition": "new",
          "gender": "unisex",
          "ageGroup": "adult",
          "sizes": [
            "S",
            "M",
            "L",
            "XL"
          ],
          "sizeSystem": "US",
          "sizeType": "regular",
          "shipping": [
            {
              "country": "US",
              "service": "Standard",
              "price": {
                "value": "5.99",
                "currency": "USD"
              }
            }
          ],
          "shippingWeight": {
            "value": "0.5",
            "unit": "lb"
          },
          "shippingLength": {
            "value": "12",
            "unit": "in"
          },
          "shippingWidth": {
            "value": "10",
            "unit": "in"
          },
          "shippingHeight": {
            "value": "2",
            "unit": "in"
          },
          "shippingLabel": "standard",
          "taxes": [
            {
              "country": "US",
              "region": "CA",
              "rate": 7.25,
              "taxShip": true
            }
          ],
          "identifierExists": true,
          "customLabel0": "bestseller",
          "customLabel1": "organic",
          "customLabel2": "spring_2025",
          "customLabel3": null,
          "customLabel4": null,
          "productTypes": [
            "Apparel & Accessories",
            "Apparel & Accessories > Clothing",
            "Apparel & Accessories > Clothing > Shirts & Tops"
          ],
          "source": "api",
          "mobileLink": "https://m.example.com/products/google-tshirt",
          "unitPricingMeasure": {
            "value": 1,
            "unit": "ct"
          },
          "unitPricingBaseMeasure": {
            "value": 1,
            "unit": "ct"
          },
          "multipack": 1,
          "isBundle": false,
          "promotionIds": [
            "PROMO2025SPRING"
          ],
          "sellOnGoogleQuantity": 100,
          "maxHandlingTime": 3,
          "minHandlingTime": 1,
          "displayAdsId": "google_tshirt_ads",
          "displayAdsLink": "https://example.com/ads/google-tshirt",
          "displayAdsTitle": "Premium Organic Cotton T-Shirt",
          "displayAdsValue": 29.99,
          "displayAdsSimilarIds": [
            "similar_tshirt_001",
            "similar_tshirt_002"
          ],
          "costOfGoodsSold": {
            "value": "15.00",
            "currency": "USD"
          },
          "includedDestinations": [
            "Shopping"
          ],
          "excludedDestinations": [],
          "adsGrouping": "tshirts",
          "adsLabels": [
            "apparel",
            "cotton",
            "organic"
          ],
          "adsRedirect": "https://example.com/ads-redirect/google-tshirt",
          "pause": "ads",
          "canonicalLink": "https://example.com/products/google-tshirt",
          "productDetails": [
            {
              "sectionName": "Material",
              "attributeName": "Fabric",
              "attributeValue": "100% Organic Cotton"
            }
          ],
          "productHighlights": [
            "Made from 100% organic cotton",
            "Comfortable and breathable",
            "Machine washable"
          ]
        }
      },
      {
        "batchId": 2,
        "product": {
          "kind": "content#product",
          "id": "online:en:US:3333333333",
          "offerId": "3333333333",
          "title": "Google Cap",
          "contentLanguage": "en",
          "targetCountry": "US",
          "channel": "online"
        }
      }
    ]
  }
}

Batch Regional Inventory​

Updates regional inventory for multiple products or regions in a single request. | key: batchRegionalInventory

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

{
  "data": {
    "entries": [
      {
        "batchId": 1,
        "regionalInventory": {
          "regionId": "123456",
          "price": {
            "value": "29.99",
            "currency": "USD"
          },
          "availability": "in stock"
        }
      },
      {
        "batchId": 2,
        "regionalInventory": {
          "regionId": "654321",
          "availability": "out of stock"
        }
      }
    ]
  }
}

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. | key: cancelOrder

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

123456789
Operation Id

The ID of the operation. Unique across all operations for a given order.

OP-123456
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.

12345678901234567890
Reason

The reason for the cancellation.

Reason Text

The explanation of the reason.

Customer requested cancellation

{
  "data": {
    "kind": "content#ordersCancelResponse",
    "executionStatus": "executed"
  }
}

Create Account​

Creates a Merchant Center sub-account. | key: createAccount

InputNotesExample
Account Management

Specifies whether account management is manual or automatic.

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.

Adult Content

When true, indicates the merchant sells adult content.

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

Automatic Label Ids

Automatically created label IDs that are assigned to the account by CSS Center.

67890
Business Information

The business information of the account.

Connection

The Google Content Shopping connection to use.

Conversion Settings

Settings for conversion tracking.

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.

98765
Google My Business Link

The Business Profile which is linked or in the process of being linked with the Merchant Center account.

Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
Label Ids

Manually created label IDs that are assigned to the account by CSS.

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

123456789
Name

Display name for the account.

My Account Name
Seller Id

Client-specific, locally-unique, internal ID for the child account.

SELLER-12345
User

Users with access to the account. Every account (except for subaccounts) must have at least one admin user.

Website Url

The merchant's website.

https://www.example.com
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.

{
  "data": {
    "kind": "content#account",
    "id": "123456789",
    "name": "Example Merchant Store",
    "websiteUrl": "https://example.com",
    "adultContent": false,
    "businessInformation": {
      "address": {
        "country": "US",
        "locality": "Mountain View",
        "region": "CA",
        "streetAddress": "1600 Amphitheatre Parkway",
        "postalCode": "94043"
      },
      "phoneNumber": "+1-650-253-0000",
      "customerService": {
        "email": "support@example.com",
        "phoneNumber": "+1-650-253-0001",
        "url": "https://example.com/support"
      }
    },
    "users": [
      {
        "emailAddress": "admin@example.com",
        "admin": true
      },
      {
        "emailAddress": "manager@example.com",
        "admin": false
      }
    ],
    "youtubeChannelLinks": [
      {
        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "status": "active"
      }
    ],
    "googleMyBusinessLink": {
      "gmbAccountId": "1234567890",
      "gmbEmail": "business@example.com",
      "status": "active"
    },
    "automaticImprovements": {
      "imageImprovements": {
        "effectiveAllowAutomaticImprovements": true
      },
      "itemUpdates": {
        "effectiveAllowAutomaticItemUpdates": true
      },
      "shippingImprovements": {
        "effectiveAllowShippingImprovements": true
      }
    },
    "adsLinks": [
      {
        "adsId": "1234567890",
        "status": "active"
      }
    ],
    "cssId": "9876543210",
    "labelIds": [
      "123",
      "456",
      "789"
    ],
    "accountManagement": "manual",
    "automaticLabelIds": [
      "auto_123",
      "auto_456"
    ],
    "sellerId": "SELLER_001"
  }
}

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. | key: createOrderReturn

InputNotesExample
Connection

The Google Content Shopping connection to use.

Line Items

The list of line items to return.

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.

123456789
Operation Id

The ID of the operation. Unique across all operations for a given order.

OP-123456
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.

12345678901234567890
Return Method Type

The way of the package being returned.

SHIP_TO_MERCHANT

{
  "data": {
    "kind": "content#orderReturn",
    "returnId": "return_123456789",
    "orderId": "1234567890",
    "merchantId": "123456789",
    "creationDate": "2025-01-20T10:30:00.000Z",
    "returnShipment": {
      "state": "received",
      "shipmentId": "shipment_001",
      "shipmentTrackingInfos": [
        {
          "carrier": "UPS",
          "trackingNumber": "1Z999AA10123456784"
        }
      ]
    },
    "returnItems": [
      {
        "returnItemId": "return_item_001",
        "lineItemId": "line_item_001",
        "product": {
          "offerId": "1111111111",
          "title": "Google Organic Cotton T-Shirt"
        },
        "returnQuantity": 1,
        "returnReason": "SIZE_TOO_SMALL",
        "returnReasonDescription": "Item is too small",
        "state": "received"
      }
    ]
  }
}

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. | key: createProduct

InputNotesExample
Additional Image Links

Additional URLs of images of the item.

https://www.example.com/images/products/tshirt-blue-side.jpg
Additional Size Type

Additional cut of the item. Used together with sizeType to represent combined size types for apparel items.

tall
Ads Grouping

Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise.

GROUP-A
Ads Labels

Similar to adsGrouping, but only works on CPC.

LABEL-A
Ads Redirect

Allows advertisers to override the item URL when the product is shown within the context of Product Ads.

https://www.example.com/ads/tshirt-blue
Adult

When true, indicates the item is targeted towards adults.

false
Age Group

Target age group of the item.

adult
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).

in stock
Availability Date

The day a pre-ordered product becomes available for delivery, in ISO 8601 format.

2024-07-01
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.

ExampleBrand
Canonical Link

URL for the canonical version of your item's landing page.

https://www.example.com/products/tshirt-blue
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.

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.

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

new
Connection

The Google Content Shopping connection to use.

Content Language

The two-letter ISO 639-1 language code for the item.

en
Cost Of Goods Sold

Cost of goods sold. Used for gross profit reporting.

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

Custom Label 0

Custom Label 0 for custom grouping of items in a Shopping campaign.

Summer Collection
Custom Label 1

Custom Label 1 for custom grouping of items in a Shopping campaign.

Bestseller
Custom Label 2

Custom Label 2 for custom grouping of items in a Shopping campaign.

Clearance
Custom Label 3

Custom Label 3 for custom grouping of items in a Shopping campaign.

Premium
Custom Label 4

Custom Label 4 for custom grouping of items in a Shopping campaign.

Limited Edition
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.

100% organic cotton t-shirt with crew neck and short sleeves. Machine washable.
Display Ads Id

An identifier for an item for dynamic remarketing campaigns.

RMK-12345
Display Ads Link

URL directly to your item's landing page for dynamic remarketing campaigns.

https://www.example.com/products/tshirt-blue
Display Ads Similar Ids

Advertiser-specified recommendations.

SKU-67890
Display Ads Title

Title of an item for dynamic remarketing campaigns.

Men's Blue T-Shirt
Display Ads Value

Offer margin for dynamic remarketing campaigns.

10
Energy Efficiency Class

The energy efficiency class as defined in EU directive 2010/30/EU.

A++
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.

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

2024-12-31
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.

EXTERNAL-SELLER-789
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.

987654321
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 (-).

US-FEED-001
Gender

Target gender of the item.

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

Apparel & Accessories > Clothing > Shirts
GTIN

Global Trade Item Number (GTIN) of the item.

00012345678905
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
Image Link

URL of an image of the item.

https://www.example.com/images/products/tshirt-blue-main.jpg
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.

Shopping
Installment

Number and amount of installments to pay for an item.

Is Bundle

When true, indicates the item is a merchant-defined bundle (a custom grouping of different products sold for a single price).

false
Item Group Id

Shared identifier for all variants of the same product.

TSHIRT-GROUP-001
Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
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.

https://www.example.com/images/lifestyle/tshirt-lifestyle-1.jpg
Link

URL directly linking to your item's page on your website.

https://www.example.com/products/organic-cotton-tshirt-blue
Link Template

URL template for merchant hosted local storefront.

https://www.example.com/store/{store_code}/product/{product_id}
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.

Cotton
Max Energy Efficiency Class

The energy efficiency class as defined in EU directive 2010/30/EU.

A+++
Max Handling Time

Maximal product handling time (in business days).

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

123456789
Min Energy Efficiency Class

The energy efficiency class as defined in EU directive 2010/30/EU.

A+
Min Handling Time

Minimal product handling time (in business days).

1
Mobile Link

URL for the mobile-optimized version of your item's landing page.

https://m.example.com/products/organic-cotton-tshirt-blue
Mobile Link Template

URL template for merchant hosted local storefront optimized for mobile devices.

https://m.example.com/store/{store_code}/product/{product_id}
MPN

Manufacturer Part Number (MPN) of the item.

MPN-12345-A
Multipack

The number of identical products in a merchant-defined multipack.

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

SKU-12345
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.

Solid
Pause

Publication of this item should be temporarily paused.

Pickup Method

The pick up option for the item.

Pickup Sla

Item store pickup timeline.

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.

Product Details

Technical specification or additional product details.

Product Height

The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).

Product Highlights

Bullet points describing the most relevant highlights of a product.

Made from 100% organic cotton
Product Length

The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).

Product Types

Categories of the item (formatted as in product data specification).

Apparel & Accessories > Clothing > Shirts
Product Weight

The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).

Product Width

The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).

Promotion Ids

The unique ID of a promotion.

SUMMER2024
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

2024-11-01T00:00:00Z/2024-11-30T23:59:59Z
Sell On Google Quantity

The quantity of the product that is available for selling on Google. Supported only for online products.

100
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 Height

Height of the item for shipping.

Shipping Label

The shipping label of the product, used to group product in account-level shipping rules.

STANDARD-SHIPPING
Shipping Length

Length of the item for shipping.

Shipping Weight

Weight of the item for shipping.

Shipping Width

Width of the item for shipping.

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.

FR
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

M
Size System

System in which the size is specified. Recommended for apparel items.

US
Size Type

The cut of the item. Recommended for apparel items.

regular
Source

The source of the offer, that is, how the offer was created.

Subscription Cost

Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.

Target Country

The CLDR territory code for the item's country of sale.

US
Tax Category

The tax category of the product.

apparel
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).

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.

Men's Organic Cotton T-Shirt - Blue
Transit Time Label

The transit time label of the product, used to group product in account-level transit time tables.

STANDARD
Unit Pricing Base Measure

The preference of the denominator of the unit price.

Unit Pricing Measure

The measure and dimension of an item.

{
  "data": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "title": "Google Organic Cotton T-Shirt",
    "description": "Comfortable organic cotton t-shirt with Google logo. Available in multiple sizes and colors.",
    "link": "https://example.com/products/google-tshirt",
    "imageLink": "https://example.com/images/google-tshirt-primary.jpg",
    "additionalImageLinks": [
      "https://example.com/images/google-tshirt-back.jpg",
      "https://example.com/images/google-tshirt-detail.jpg"
    ],
    "contentLanguage": "en",
    "targetCountry": "US",
    "feedLabel": "US",
    "channel": "online",
    "expirationDate": "2025-12-31",
    "adult": false,
    "brand": "Google",
    "color": "Navy Blue",
    "googleProductCategory": "Apparel & Accessories > Clothing > Shirts & Tops",
    "gtin": "00012345678905",
    "itemGroupId": "google_tshirt_group",
    "material": "100% Organic Cotton",
    "mpn": "GOOG-TS-001",
    "pattern": "Solid",
    "price": {
      "value": "29.99",
      "currency": "USD"
    },
    "salePrice": {
      "value": "24.99",
      "currency": "USD"
    },
    "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
    "availability": "in stock",
    "availabilityDate": "2025-01-15",
    "condition": "new",
    "gender": "unisex",
    "ageGroup": "adult",
    "sizes": [
      "S",
      "M",
      "L",
      "XL"
    ],
    "sizeSystem": "US",
    "sizeType": "regular",
    "shipping": [
      {
        "country": "US",
        "service": "Standard",
        "price": {
          "value": "5.99",
          "currency": "USD"
        }
      }
    ],
    "shippingWeight": {
      "value": "0.5",
      "unit": "lb"
    },
    "shippingLength": {
      "value": "12",
      "unit": "in"
    },
    "shippingWidth": {
      "value": "10",
      "unit": "in"
    },
    "shippingHeight": {
      "value": "2",
      "unit": "in"
    },
    "shippingLabel": "standard",
    "taxes": [
      {
        "country": "US",
        "region": "CA",
        "rate": 7.25,
        "taxShip": true
      }
    ],
    "identifierExists": true,
    "customLabel0": "bestseller",
    "customLabel1": "organic",
    "customLabel2": "spring_2025",
    "customLabel3": null,
    "customLabel4": null,
    "productTypes": [
      "Apparel & Accessories",
      "Apparel & Accessories > Clothing",
      "Apparel & Accessories > Clothing > Shirts & Tops"
    ],
    "source": "api",
    "mobileLink": "https://m.example.com/products/google-tshirt",
    "unitPricingMeasure": {
      "value": 1,
      "unit": "ct"
    },
    "unitPricingBaseMeasure": {
      "value": 1,
      "unit": "ct"
    },
    "multipack": 1,
    "isBundle": false,
    "promotionIds": [
      "PROMO2025SPRING"
    ],
    "sellOnGoogleQuantity": 100,
    "maxHandlingTime": 3,
    "minHandlingTime": 1,
    "displayAdsId": "google_tshirt_ads",
    "displayAdsLink": "https://example.com/ads/google-tshirt",
    "displayAdsTitle": "Premium Organic Cotton T-Shirt",
    "displayAdsValue": 29.99,
    "displayAdsSimilarIds": [
      "similar_tshirt_001",
      "similar_tshirt_002"
    ],
    "costOfGoodsSold": {
      "value": "15.00",
      "currency": "USD"
    },
    "includedDestinations": [
      "Shopping"
    ],
    "excludedDestinations": [],
    "adsGrouping": "tshirts",
    "adsLabels": [
      "apparel",
      "cotton",
      "organic"
    ],
    "adsRedirect": "https://example.com/ads-redirect/google-tshirt",
    "pause": "ads",
    "canonicalLink": "https://example.com/products/google-tshirt",
    "productDetails": [
      {
        "sectionName": "Material",
        "attributeName": "Fabric",
        "attributeValue": "100% Organic Cotton"
      }
    ],
    "productHighlights": [
      "Made from 100% organic cotton",
      "Comfortable and breathable",
      "Machine washable"
    ]
  }
}

Delete Account​

Deletes a Merchant Center sub-account. | key: deleteAccount

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

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

123456789

{
  "data": {}
}

Delete Product​

Deletes a product from your Merchant Center account. | key: deleteProduct

InputNotesExample
Connection

The Google Content Shopping connection to use.

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.

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

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

online:en:US:1234567890

{
  "data": {}
}

Get Account​

Retrieves a Merchant Center account. | key: getAccount

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

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

123456789
View

Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'.

{
  "data": {
    "kind": "content#account",
    "id": "123456789",
    "name": "Example Merchant Store",
    "websiteUrl": "https://example.com",
    "adultContent": false,
    "businessInformation": {
      "address": {
        "country": "US",
        "locality": "Mountain View",
        "region": "CA",
        "streetAddress": "1600 Amphitheatre Parkway",
        "postalCode": "94043"
      },
      "phoneNumber": "+1-650-253-0000",
      "customerService": {
        "email": "support@example.com",
        "phoneNumber": "+1-650-253-0001",
        "url": "https://example.com/support"
      }
    },
    "users": [
      {
        "emailAddress": "admin@example.com",
        "admin": true
      },
      {
        "emailAddress": "manager@example.com",
        "admin": false
      }
    ],
    "youtubeChannelLinks": [
      {
        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "status": "active"
      }
    ],
    "googleMyBusinessLink": {
      "gmbAccountId": "1234567890",
      "gmbEmail": "business@example.com",
      "status": "active"
    },
    "automaticImprovements": {
      "imageImprovements": {
        "effectiveAllowAutomaticImprovements": true
      },
      "itemUpdates": {
        "effectiveAllowAutomaticItemUpdates": true
      },
      "shippingImprovements": {
        "effectiveAllowShippingImprovements": true
      }
    },
    "adsLinks": [
      {
        "adsId": "1234567890",
        "status": "active"
      }
    ],
    "cssId": "9876543210",
    "labelIds": [
      "123",
      "456",
      "789"
    ],
    "accountManagement": "manual",
    "automaticLabelIds": [
      "auto_123",
      "auto_456"
    ],
    "sellerId": "SELLER_001"
  }
}

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. | key: getOrder

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

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

12345678901234567890

{
  "data": {
    "kind": "content#order",
    "id": "1234567890",
    "merchantId": "123456789",
    "merchantOrderId": "ORDER_2025_001",
    "status": "delivered",
    "customer": {
      "fullName": "John Doe",
      "email": "john.doe@example.com",
      "marketingRightsInfo": {
        "marketingEmailAddress": "john.doe@example.com",
        "lastUpdatedTimestamp": "2025-01-15T10:30:00.000Z",
        "explicitMarketingPreference": "granted"
      }
    },
    "deliveryDetails": {
      "address": {
        "country": "US",
        "locality": "San Francisco",
        "region": "CA",
        "streetAddress": "123 Market St",
        "postalCode": "94105",
        "recipientName": "John Doe"
      },
      "phoneNumber": "+1-415-555-0123"
    },
    "netPriceAmount": {
      "value": "99.99",
      "currency": "USD"
    },
    "paymentMethod": {
      "type": "CREDIT_CARD",
      "lastFourDigits": "1234"
    },
    "placedDate": "2025-01-15T10:30:00.000Z",
    "billingAddress": {
      "country": "US",
      "locality": "San Francisco",
      "region": "CA",
      "streetAddress": "123 Market St",
      "postalCode": "94105",
      "recipientName": "John Doe"
    },
    "shippingOption": "Standard",
    "lineItems": [
      {
        "id": "line_item_001",
        "product": {
          "id": "online:en:US:1111111111",
          "title": "Google Organic Cotton T-Shirt",
          "price": {
            "value": "29.99",
            "currency": "USD"
          },
          "brand": "Google",
          "imageLink": "https://example.com/images/google-tshirt-primary.jpg"
        },
        "quantityOrdered": 2,
        "quantityShipped": 2,
        "quantityDelivered": 2,
        "shippingDetails": {
          "deliverByDate": "2025-01-22",
          "shipByDate": "2025-01-18",
          "method": {
            "methodName": "Standard",
            "carrier": "UPS"
          }
        }
      }
    ],
    "acknowledged": true,
    "promotions": [
      {
        "promotionId": "PROMO2025SPRING",
        "title": "Spring Sale 2025",
        "shortTitle": "Spring Sale",
        "priceValue": {
          "value": "5.00",
          "currency": "USD"
        }
      }
    ]
  }
}

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. | key: getOrderReturn

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

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

1234567890123456

{
  "data": {
    "kind": "content#orderReturn",
    "returnId": "return_123456789",
    "orderId": "1234567890",
    "merchantId": "123456789",
    "creationDate": "2025-01-20T10:30:00.000Z",
    "returnShipment": {
      "state": "received",
      "shipmentId": "shipment_001",
      "shipmentTrackingInfos": [
        {
          "carrier": "UPS",
          "trackingNumber": "1Z999AA10123456784"
        }
      ]
    },
    "returnItems": [
      {
        "returnItemId": "return_item_001",
        "lineItemId": "line_item_001",
        "product": {
          "offerId": "1111111111",
          "title": "Google Organic Cotton T-Shirt"
        },
        "returnQuantity": 1,
        "returnReason": "SIZE_TOO_SMALL",
        "returnReasonDescription": "Item is too small",
        "state": "received"
      }
    ]
  }
}

Get Product​

Retrieves a product from your Merchant Center account. | key: getProduct

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

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

online:en:US:1234567890

{
  "data": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "title": "Google Organic Cotton T-Shirt",
    "description": "Comfortable organic cotton t-shirt with Google logo. Available in multiple sizes and colors.",
    "link": "https://example.com/products/google-tshirt",
    "imageLink": "https://example.com/images/google-tshirt-primary.jpg",
    "additionalImageLinks": [
      "https://example.com/images/google-tshirt-back.jpg",
      "https://example.com/images/google-tshirt-detail.jpg"
    ],
    "contentLanguage": "en",
    "targetCountry": "US",
    "feedLabel": "US",
    "channel": "online",
    "expirationDate": "2025-12-31",
    "adult": false,
    "brand": "Google",
    "color": "Navy Blue",
    "googleProductCategory": "Apparel & Accessories > Clothing > Shirts & Tops",
    "gtin": "00012345678905",
    "itemGroupId": "google_tshirt_group",
    "material": "100% Organic Cotton",
    "mpn": "GOOG-TS-001",
    "pattern": "Solid",
    "price": {
      "value": "29.99",
      "currency": "USD"
    },
    "salePrice": {
      "value": "24.99",
      "currency": "USD"
    },
    "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
    "availability": "in stock",
    "availabilityDate": "2025-01-15",
    "condition": "new",
    "gender": "unisex",
    "ageGroup": "adult",
    "sizes": [
      "S",
      "M",
      "L",
      "XL"
    ],
    "sizeSystem": "US",
    "sizeType": "regular",
    "shipping": [
      {
        "country": "US",
        "service": "Standard",
        "price": {
          "value": "5.99",
          "currency": "USD"
        }
      }
    ],
    "shippingWeight": {
      "value": "0.5",
      "unit": "lb"
    },
    "shippingLength": {
      "value": "12",
      "unit": "in"
    },
    "shippingWidth": {
      "value": "10",
      "unit": "in"
    },
    "shippingHeight": {
      "value": "2",
      "unit": "in"
    },
    "shippingLabel": "standard",
    "taxes": [
      {
        "country": "US",
        "region": "CA",
        "rate": 7.25,
        "taxShip": true
      }
    ],
    "identifierExists": true,
    "customLabel0": "bestseller",
    "customLabel1": "organic",
    "customLabel2": "spring_2025",
    "customLabel3": null,
    "customLabel4": null,
    "productTypes": [
      "Apparel & Accessories",
      "Apparel & Accessories > Clothing",
      "Apparel & Accessories > Clothing > Shirts & Tops"
    ],
    "source": "api",
    "mobileLink": "https://m.example.com/products/google-tshirt",
    "unitPricingMeasure": {
      "value": 1,
      "unit": "ct"
    },
    "unitPricingBaseMeasure": {
      "value": 1,
      "unit": "ct"
    },
    "multipack": 1,
    "isBundle": false,
    "promotionIds": [
      "PROMO2025SPRING"
    ],
    "sellOnGoogleQuantity": 100,
    "maxHandlingTime": 3,
    "minHandlingTime": 1,
    "displayAdsId": "google_tshirt_ads",
    "displayAdsLink": "https://example.com/ads/google-tshirt",
    "displayAdsTitle": "Premium Organic Cotton T-Shirt",
    "displayAdsValue": 29.99,
    "displayAdsSimilarIds": [
      "similar_tshirt_001",
      "similar_tshirt_002"
    ],
    "costOfGoodsSold": {
      "value": "15.00",
      "currency": "USD"
    },
    "includedDestinations": [
      "Shopping"
    ],
    "excludedDestinations": [],
    "adsGrouping": "tshirts",
    "adsLabels": [
      "apparel",
      "cotton",
      "organic"
    ],
    "adsRedirect": "https://example.com/ads-redirect/google-tshirt",
    "pause": "ads",
    "canonicalLink": "https://example.com/products/google-tshirt",
    "productDetails": [
      {
        "sectionName": "Material",
        "attributeName": "Fabric",
        "attributeValue": "100% Organic Cotton"
      }
    ],
    "productHighlights": [
      "Made from 100% organic cotton",
      "Comfortable and breathable",
      "Machine washable"
    ]
  }
}

Get PubSub Notification Settings​

Retrieves a Merchant Center account's pubsub notification settings. | key: getPubSubNotification

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

123456789

{
  "data": {
    "kind": "content#pubsubnotificationsettings",
    "cloudTopicName": "projects/example-project/topics/merchant-notifications",
    "registeredEvents": [
      "PRODUCT_STATUS_CHANGE",
      "ORDER_PENDING_SHIPMENT",
      "ORDER_SHIPPED"
    ]
  }
}

List Accounts​

Lists the sub-accounts in your Merchant Center account. | key: listAccounts

InputNotesExample
Connection

The Google Content Shopping connection to use.

Fetch All

When true, fetches all pages of results using pagination.

false
Label

If view is set to 'css', only return accounts that are assigned label with given ID.

12345
Max Results

The maximum number of accounts to return in the response, used for paging.

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

123456789
Name

If set, only the accounts with the given name (case sensitive) will be returned.

My Account Name
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.

CAESBggBIAEoAQ
View

Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'.

{
  "data": {
    "kind": "content#accountsListResponse",
    "resources": [
      {
        "kind": "content#account",
        "id": "123456789",
        "name": "Example Merchant Store",
        "websiteUrl": "https://example.com",
        "adultContent": false,
        "businessInformation": {
          "address": {
            "country": "US",
            "locality": "Mountain View",
            "region": "CA",
            "streetAddress": "1600 Amphitheatre Parkway",
            "postalCode": "94043"
          },
          "phoneNumber": "+1-650-253-0000",
          "customerService": {
            "email": "support@example.com",
            "phoneNumber": "+1-650-253-0001",
            "url": "https://example.com/support"
          }
        },
        "users": [
          {
            "emailAddress": "admin@example.com",
            "admin": true
          },
          {
            "emailAddress": "manager@example.com",
            "admin": false
          }
        ],
        "youtubeChannelLinks": [
          {
            "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
            "status": "active"
          }
        ],
        "googleMyBusinessLink": {
          "gmbAccountId": "1234567890",
          "gmbEmail": "business@example.com",
          "status": "active"
        },
        "automaticImprovements": {
          "imageImprovements": {
            "effectiveAllowAutomaticImprovements": true
          },
          "itemUpdates": {
            "effectiveAllowAutomaticItemUpdates": true
          },
          "shippingImprovements": {
            "effectiveAllowShippingImprovements": true
          }
        },
        "adsLinks": [
          {
            "adsId": "1234567890",
            "status": "active"
          }
        ],
        "cssId": "9876543210",
        "labelIds": [
          "123",
          "456",
          "789"
        ],
        "accountManagement": "manual",
        "automaticLabelIds": [
          "auto_123",
          "auto_456"
        ],
        "sellerId": "SELLER_001"
      },
      {
        "kind": "content#account",
        "id": "987654321",
        "name": "Sub-Account Store",
        "websiteUrl": "https://sub.example.com",
        "adultContent": false
      }
    ],
    "nextPageToken": "CgwI5MSB3QYQ"
  }
}

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. | key: listOrders

InputNotesExample
Acknowledged

When true, filters for orders that have been acknowledged. When false, filters for orders that have not been acknowledged.

false
Connection

The Google Content Shopping connection to use.

Fetch All

When true, fetches all pages of results using pagination.

false
Max Results

The maximum number of accounts to return in the response, used for paging.

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

123456789
Order By

Order results by placement date in descending or ascending order.

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.

CAESBggBIAEoAQ
Placed Date End

Obtains orders placed before this date (inclusively), in ISO 8601 format.

2024-12-31T23:59:59Z
Placed Date Start

Obtains orders placed after this date (inclusively), in ISO 8601 format.

2024-01-01T00:00:00Z
Statuses

Obtains orders that match any of the specified statuses. <strong>Note:</strong> 'active' is a shortcut for pendingShipment and partiallyShipped; 'completed' is a shortcut for shipped, delivered, returned, and canceled.

active

{
  "data": {
    "kind": "content#ordersListResponse",
    "resources": [
      {
        "kind": "content#order",
        "id": "1234567890",
        "merchantId": "123456789",
        "merchantOrderId": "ORDER_2025_001",
        "status": "delivered",
        "customer": {
          "fullName": "John Doe",
          "email": "john.doe@example.com",
          "marketingRightsInfo": {
            "marketingEmailAddress": "john.doe@example.com",
            "lastUpdatedTimestamp": "2025-01-15T10:30:00.000Z",
            "explicitMarketingPreference": "granted"
          }
        },
        "deliveryDetails": {
          "address": {
            "country": "US",
            "locality": "San Francisco",
            "region": "CA",
            "streetAddress": "123 Market St",
            "postalCode": "94105",
            "recipientName": "John Doe"
          },
          "phoneNumber": "+1-415-555-0123"
        },
        "netPriceAmount": {
          "value": "99.99",
          "currency": "USD"
        },
        "paymentMethod": {
          "type": "CREDIT_CARD",
          "lastFourDigits": "1234"
        },
        "placedDate": "2025-01-15T10:30:00.000Z",
        "billingAddress": {
          "country": "US",
          "locality": "San Francisco",
          "region": "CA",
          "streetAddress": "123 Market St",
          "postalCode": "94105",
          "recipientName": "John Doe"
        },
        "shippingOption": "Standard",
        "lineItems": [
          {
            "id": "line_item_001",
            "product": {
              "id": "online:en:US:1111111111",
              "title": "Google Organic Cotton T-Shirt",
              "price": {
                "value": "29.99",
                "currency": "USD"
              },
              "brand": "Google",
              "imageLink": "https://example.com/images/google-tshirt-primary.jpg"
            },
            "quantityOrdered": 2,
            "quantityShipped": 2,
            "quantityDelivered": 2,
            "shippingDetails": {
              "deliverByDate": "2025-01-22",
              "shipByDate": "2025-01-18",
              "method": {
                "methodName": "Standard",
                "carrier": "UPS"
              }
            }
          }
        ],
        "acknowledged": true,
        "promotions": [
          {
            "promotionId": "PROMO2025SPRING",
            "title": "Spring Sale 2025",
            "shortTitle": "Spring Sale",
            "priceValue": {
              "value": "5.00",
              "currency": "USD"
            }
          }
        ]
      },
      {
        "kind": "content#order",
        "id": "0987654321",
        "merchantId": "123456789",
        "merchantOrderId": "ORDER_2025_002",
        "status": "shipped",
        "placedDate": "2025-01-16T14:20:00.000Z",
        "netPriceAmount": {
          "value": "149.99",
          "currency": "USD"
        }
      }
    ],
    "nextPageToken": "CgwI6MSB3QYQ"
  }
}

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. | key: listReturnsOrders

InputNotesExample
Acknowledged

When true, filters for orders that have been acknowledged. When false, filters for orders that have not been acknowledged.

false
Connection

The Google Content Shopping connection to use.

Created End Date

Obtains order returns created before this date (inclusively), in ISO 8601 format.

2024-12-31T23:59:59Z
Created Start Date

Obtains order returns created after this date (inclusively), in ISO 8601 format.

2024-01-01T00:00:00Z
Fetch All

When true, fetches all pages of results using pagination.

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.

12345678901234567890
Max Results

The maximum number of accounts to return in the response, used for paging.

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

123456789
Order By

Order results by placement date in descending or ascending order.

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.

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

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

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

1Z999AA10123456784
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.

STANDARD

{
  "data": {
    "kind": "content#orderreturnsListResponse",
    "resources": [
      {
        "kind": "content#orderReturn",
        "returnId": "return_123456789",
        "orderId": "1234567890",
        "merchantId": "123456789",
        "creationDate": "2025-01-20T10:30:00.000Z",
        "returnShipment": {
          "state": "received",
          "shipmentId": "shipment_001",
          "shipmentTrackingInfos": [
            {
              "carrier": "UPS",
              "trackingNumber": "1Z999AA10123456784"
            }
          ]
        },
        "returnItems": [
          {
            "returnItemId": "return_item_001",
            "lineItemId": "line_item_001",
            "product": {
              "offerId": "1111111111",
              "title": "Google Organic Cotton T-Shirt"
            },
            "returnQuantity": 1,
            "returnReason": "SIZE_TOO_SMALL",
            "returnReasonDescription": "Item is too small",
            "state": "received"
          }
        ]
      },
      {
        "kind": "content#orderReturn",
        "returnId": "return_987654321",
        "orderId": "0987654321",
        "merchantId": "123456789",
        "creationDate": "2025-01-21T15:45:00.000Z",
        "returnShipment": {
          "state": "pending"
        }
      }
    ],
    "nextPageToken": "CgwI7MSB3QYQ"
  }
}

List Products​

Lists the products in your Merchant Center account. | key: listProducts

InputNotesExample
Connection

The Google Content Shopping connection to use.

Fetch All

When true, fetches all pages of results using pagination.

false
Max Results

The maximum number of accounts to return in the response, used for paging.

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

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

CAESBggBIAEoAQ

{
  "data": {
    "kind": "content#productsListResponse",
    "resources": [
      {
        "kind": "content#product",
        "id": "online:en:US:1111111111",
        "offerId": "1111111111",
        "title": "Google Organic Cotton T-Shirt",
        "description": "Comfortable organic cotton t-shirt with Google logo. Available in multiple sizes and colors.",
        "link": "https://example.com/products/google-tshirt",
        "imageLink": "https://example.com/images/google-tshirt-primary.jpg",
        "additionalImageLinks": [
          "https://example.com/images/google-tshirt-back.jpg",
          "https://example.com/images/google-tshirt-detail.jpg"
        ],
        "contentLanguage": "en",
        "targetCountry": "US",
        "feedLabel": "US",
        "channel": "online",
        "expirationDate": "2025-12-31",
        "adult": false,
        "brand": "Google",
        "color": "Navy Blue",
        "googleProductCategory": "Apparel & Accessories > Clothing > Shirts & Tops",
        "gtin": "00012345678905",
        "itemGroupId": "google_tshirt_group",
        "material": "100% Organic Cotton",
        "mpn": "GOOG-TS-001",
        "pattern": "Solid",
        "price": {
          "value": "29.99",
          "currency": "USD"
        },
        "salePrice": {
          "value": "24.99",
          "currency": "USD"
        },
        "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
        "availability": "in stock",
        "availabilityDate": "2025-01-15",
        "condition": "new",
        "gender": "unisex",
        "ageGroup": "adult",
        "sizes": [
          "S",
          "M",
          "L",
          "XL"
        ],
        "sizeSystem": "US",
        "sizeType": "regular",
        "shipping": [
          {
            "country": "US",
            "service": "Standard",
            "price": {
              "value": "5.99",
              "currency": "USD"
            }
          }
        ],
        "shippingWeight": {
          "value": "0.5",
          "unit": "lb"
        },
        "shippingLength": {
          "value": "12",
          "unit": "in"
        },
        "shippingWidth": {
          "value": "10",
          "unit": "in"
        },
        "shippingHeight": {
          "value": "2",
          "unit": "in"
        },
        "shippingLabel": "standard",
        "taxes": [
          {
            "country": "US",
            "region": "CA",
            "rate": 7.25,
            "taxShip": true
          }
        ],
        "identifierExists": true,
        "customLabel0": "bestseller",
        "customLabel1": "organic",
        "customLabel2": "spring_2025",
        "customLabel3": null,
        "customLabel4": null,
        "productTypes": [
          "Apparel & Accessories",
          "Apparel & Accessories > Clothing",
          "Apparel & Accessories > Clothing > Shirts & Tops"
        ],
        "source": "api",
        "mobileLink": "https://m.example.com/products/google-tshirt",
        "unitPricingMeasure": {
          "value": 1,
          "unit": "ct"
        },
        "unitPricingBaseMeasure": {
          "value": 1,
          "unit": "ct"
        },
        "multipack": 1,
        "isBundle": false,
        "promotionIds": [
          "PROMO2025SPRING"
        ],
        "sellOnGoogleQuantity": 100,
        "maxHandlingTime": 3,
        "minHandlingTime": 1,
        "displayAdsId": "google_tshirt_ads",
        "displayAdsLink": "https://example.com/ads/google-tshirt",
        "displayAdsTitle": "Premium Organic Cotton T-Shirt",
        "displayAdsValue": 29.99,
        "displayAdsSimilarIds": [
          "similar_tshirt_001",
          "similar_tshirt_002"
        ],
        "costOfGoodsSold": {
          "value": "15.00",
          "currency": "USD"
        },
        "includedDestinations": [
          "Shopping"
        ],
        "excludedDestinations": [],
        "adsGrouping": "tshirts",
        "adsLabels": [
          "apparel",
          "cotton",
          "organic"
        ],
        "adsRedirect": "https://example.com/ads-redirect/google-tshirt",
        "pause": "ads",
        "canonicalLink": "https://example.com/products/google-tshirt",
        "productDetails": [
          {
            "sectionName": "Material",
            "attributeName": "Fabric",
            "attributeValue": "100% Organic Cotton"
          }
        ],
        "productHighlights": [
          "Made from 100% organic cotton",
          "Comfortable and breathable",
          "Machine washable"
        ]
      },
      {
        "kind": "content#product",
        "id": "online:en:US:2222222222",
        "offerId": "2222222222",
        "title": "Google Hoodie Sweatshirt",
        "description": "Cozy hoodie sweatshirt with Google branding",
        "link": "https://example.com/products/google-hoodie",
        "imageLink": "https://example.com/images/google-hoodie-primary.jpg",
        "contentLanguage": "en",
        "targetCountry": "US",
        "feedLabel": "US",
        "channel": "online",
        "brand": "Google",
        "color": "Charcoal Gray",
        "googleProductCategory": "Apparel & Accessories > Clothing > Outerwear > Hoodies",
        "gtin": "00012345678912",
        "price": {
          "value": "59.99",
          "currency": "USD"
        },
        "availability": "in stock",
        "condition": "new",
        "source": "api"
      }
    ],
    "nextPageToken": "CgwI4MSB3QYQ"
  }
}

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. | key: processOrderReturn

InputNotesExample
Connection

The Google Content Shopping connection to use.

Full Charge Return Shipping Cost

When true, the customer will be charged for return shipping costs.

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

123456789
Operation Id

The ID of the operation. Unique across all operations for a given order.

OP-123456
Refund Shipping Fee

Refunds for original shipping fee.

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.

1234567890123456
Return Items

The list of items to return.

{
  "data": {
    "kind": "content#orderreturnsProcessResponse",
    "executionStatus": "executed"
  }
}

Raw Request​

Send raw HTTP request to Google Content Shopping | key: rawRequest

InputNotesExample
Connection

The Google Content Shopping connection to use.

Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

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.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
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
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

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

/{merchantId}/accounts
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false
API Version

The API version to use. This is used to construct the base URL for the request.

v2.1

{
  "data": {
    "kind": "content#productsListResponse",
    "resources": [
      {
        "kind": "content#product",
        "id": "online:en:US:1111111111",
        "offerId": "1111111111",
        "title": "Example Product",
        "contentLanguage": "en",
        "targetCountry": "US"
      }
    ]
  }
}

Update Account​

Updates a Merchant Center account. Any fields that are not provided are deleted from the resource. | key: updateAccount

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

987654321
Account Management

Specifies whether account management is manual or automatic.

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.

Adult Content

When true, indicates the merchant sells adult content.

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

Automatic Label Ids

Automatically created label IDs that are assigned to the account by CSS Center.

67890
Business Information

The business information of the account.

Connection

The Google Content Shopping connection to use.

Conversion Settings

Settings for conversion tracking.

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.

98765
Google My Business Link

The Business Profile which is linked or in the process of being linked with the Merchant Center account.

Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
Label Ids

Manually created label IDs that are assigned to the account by CSS.

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

123456789
Name

Display name for the account.

My Account Name
Seller Id

Client-specific, locally-unique, internal ID for the child account.

SELLER-12345
User

Users with access to the account. Every account (except for subaccounts) must have at least one admin user.

Website Url

The merchant's website.

https://www.example.com
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.

{
  "data": {
    "kind": "content#account",
    "id": "123456789",
    "name": "Example Merchant Store - Updated",
    "websiteUrl": "https://shop.example.com",
    "adultContent": false,
    "businessInformation": {
      "address": {
        "country": "US",
        "locality": "Mountain View",
        "region": "CA",
        "streetAddress": "1600 Amphitheatre Parkway",
        "postalCode": "94043"
      },
      "phoneNumber": "+1-650-253-0000",
      "customerService": {
        "email": "support@example.com",
        "phoneNumber": "+1-650-253-0001",
        "url": "https://example.com/support"
      }
    },
    "users": [
      {
        "emailAddress": "admin@example.com",
        "admin": true
      },
      {
        "emailAddress": "manager@example.com",
        "admin": false
      }
    ],
    "youtubeChannelLinks": [
      {
        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "status": "active"
      }
    ],
    "googleMyBusinessLink": {
      "gmbAccountId": "1234567890",
      "gmbEmail": "business@example.com",
      "status": "active"
    },
    "automaticImprovements": {
      "imageImprovements": {
        "effectiveAllowAutomaticImprovements": true
      },
      "itemUpdates": {
        "effectiveAllowAutomaticItemUpdates": true
      },
      "shippingImprovements": {
        "effectiveAllowShippingImprovements": true
      }
    },
    "adsLinks": [
      {
        "adsId": "1234567890",
        "status": "active"
      }
    ],
    "cssId": "9876543210",
    "labelIds": [
      "123",
      "456",
      "789"
    ],
    "accountManagement": "manual",
    "automaticLabelIds": [
      "auto_123",
      "auto_456"
    ],
    "sellerId": "SELLER_001"
  }
}

Update Product​

Updates an existing product in your Merchant Center account. Only updates attributes provided in the request. | key: updateProduct

InputNotesExample
Additional Image Links

Additional URLs of images of the item.

https://www.example.com/images/products/tshirt-blue-side.jpg
Additional Size Type

Additional cut of the item. Used together with sizeType to represent combined size types for apparel items.

tall
Ads Grouping

Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise.

GROUP-A
Ads Labels

Similar to adsGrouping, but only works on CPC.

LABEL-A
Ads Redirect

Allows advertisers to override the item URL when the product is shown within the context of Product Ads.

https://www.example.com/ads/tshirt-blue
Adult

When true, indicates the item is targeted towards adults.

false
Age Group

Target age group of the item.

adult
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).

in stock
Availability Date

The day a pre-ordered product becomes available for delivery, in ISO 8601 format.

2024-07-01
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.

ExampleBrand
Canonical Link

URL for the canonical version of your item's landing page.

https://www.example.com/products/tshirt-blue
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.

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.

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

new
Connection

The Google Content Shopping connection to use.

Content Language

The two-letter ISO 639-1 language code for the item.

en
Cost Of Goods Sold

Cost of goods sold. Used for gross profit reporting.

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

Custom Label 0

Custom Label 0 for custom grouping of items in a Shopping campaign.

Summer Collection
Custom Label 1

Custom Label 1 for custom grouping of items in a Shopping campaign.

Bestseller
Custom Label 2

Custom Label 2 for custom grouping of items in a Shopping campaign.

Clearance
Custom Label 3

Custom Label 3 for custom grouping of items in a Shopping campaign.

Premium
Custom Label 4

Custom Label 4 for custom grouping of items in a Shopping campaign.

Limited Edition
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.

100% organic cotton t-shirt with crew neck and short sleeves. Machine washable.
Display Ads Id

An identifier for an item for dynamic remarketing campaigns.

RMK-12345
Display Ads Link

URL directly to your item's landing page for dynamic remarketing campaigns.

https://www.example.com/products/tshirt-blue
Display Ads Similar Ids

Advertiser-specified recommendations.

SKU-67890
Display Ads Title

Title of an item for dynamic remarketing campaigns.

Men's Blue T-Shirt
Display Ads Value

Offer margin for dynamic remarketing campaigns.

10
Energy Efficiency Class

The energy efficiency class as defined in EU directive 2010/30/EU.

A++
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.

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

2024-12-31
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.

EXTERNAL-SELLER-789
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 (-).

US-FEED-001
Gender

Target gender of the item.

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

Apparel & Accessories > Clothing > Shirts
GTIN

Global Trade Item Number (GTIN) of the item.

00012345678905
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
Image Link

URL of an image of the item.

https://www.example.com/images/products/tshirt-blue-main.jpg
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.

Shopping
Installment

Number and amount of installments to pay for an item.

Is Bundle

When true, indicates the item is a merchant-defined bundle (a custom grouping of different products sold for a single price).

false
Item Group Id

Shared identifier for all variants of the same product.

TSHIRT-GROUP-001
Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
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.

https://www.example.com/images/lifestyle/tshirt-lifestyle-1.jpg
Link

URL directly linking to your item's page on your website.

https://www.example.com/products/organic-cotton-tshirt-blue
Link Template

URL template for merchant hosted local storefront.

https://www.example.com/store/{store_code}/product/{product_id}
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.

Cotton
Max Energy Efficiency Class

The energy efficiency class as defined in EU directive 2010/30/EU.

A+++
Max Handling Time

Maximal product handling time (in business days).

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

123456789
Min Energy Efficiency Class

The energy efficiency class as defined in EU directive 2010/30/EU.

A+
Min Handling Time

Minimal product handling time (in business days).

1
Mobile Link

URL for the mobile-optimized version of your item's landing page.

https://m.example.com/products/organic-cotton-tshirt-blue
Mobile Link Template

URL template for merchant hosted local storefront optimized for mobile devices.

https://m.example.com/store/{store_code}/product/{product_id}
MPN

Manufacturer Part Number (MPN) of the item.

MPN-12345-A
Multipack

The number of identical products in a merchant-defined multipack.

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

SKU-12345
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.

Solid
Pause

Publication of this item should be temporarily paused.

Pickup Method

The pick up option for the item.

Pickup Sla

Item store pickup timeline.

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.

Product Details

Technical specification or additional product details.

Product Height

The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).

Product Highlights

Bullet points describing the most relevant highlights of a product.

Made from 100% organic cotton
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.

online:en:US:1234567890
Product Length

The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).

Product Types

Categories of the item (formatted as in product data specification).

Apparel & Accessories > Clothing > Shirts
Product Weight

The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).

Product Width

The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).

Promotion Ids

The unique ID of a promotion.

SUMMER2024
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

2024-11-01T00:00:00Z/2024-11-30T23:59:59Z
Sell On Google Quantity

The quantity of the product that is available for selling on Google. Supported only for online products.

100
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 Height

Height of the item for shipping.

Shipping Label

The shipping label of the product, used to group product in account-level shipping rules.

STANDARD-SHIPPING
Shipping Length

Length of the item for shipping.

Shipping Weight

Weight of the item for shipping.

Shipping Width

Width of the item for shipping.

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.

FR
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

M
Size System

System in which the size is specified. Recommended for apparel items.

US
Size Type

The cut of the item. Recommended for apparel items.

regular
Source

The source of the offer, that is, how the offer was created.

Subscription Cost

Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.

Target Country

The CLDR territory code for the item's country of sale.

US
Tax Category

The tax category of the product.

apparel
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).

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.

Men's Organic Cotton T-Shirt - Blue
Transit Time Label

The transit time label of the product, used to group product in account-level transit time tables.

STANDARD
Unit Pricing Base Measure

The preference of the denominator of the unit price.

Unit Pricing Measure

The measure and dimension of an item.

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.

title,salePrice

{
  "data": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "title": "Google Organic Cotton T-Shirt - Updated",
    "description": "Comfortable organic cotton t-shirt with Google logo. Available in multiple sizes and colors.",
    "link": "https://example.com/products/google-tshirt",
    "imageLink": "https://example.com/images/google-tshirt-primary.jpg",
    "additionalImageLinks": [
      "https://example.com/images/google-tshirt-back.jpg",
      "https://example.com/images/google-tshirt-detail.jpg"
    ],
    "contentLanguage": "en",
    "targetCountry": "US",
    "feedLabel": "US",
    "channel": "online",
    "expirationDate": "2025-12-31",
    "adult": false,
    "brand": "Google",
    "color": "Navy Blue",
    "googleProductCategory": "Apparel & Accessories > Clothing > Shirts & Tops",
    "gtin": "00012345678905",
    "itemGroupId": "google_tshirt_group",
    "material": "100% Organic Cotton",
    "mpn": "GOOG-TS-001",
    "pattern": "Solid",
    "price": {
      "value": "34.99",
      "currency": "USD"
    },
    "salePrice": {
      "value": "24.99",
      "currency": "USD"
    },
    "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
    "availability": "in stock",
    "availabilityDate": "2025-01-15",
    "condition": "new",
    "gender": "unisex",
    "ageGroup": "adult",
    "sizes": [
      "S",
      "M",
      "L",
      "XL"
    ],
    "sizeSystem": "US",
    "sizeType": "regular",
    "shipping": [
      {
        "country": "US",
        "service": "Standard",
        "price": {
          "value": "5.99",
          "currency": "USD"
        }
      }
    ],
    "shippingWeight": {
      "value": "0.5",
      "unit": "lb"
    },
    "shippingLength": {
      "value": "12",
      "unit": "in"
    },
    "shippingWidth": {
      "value": "10",
      "unit": "in"
    },
    "shippingHeight": {
      "value": "2",
      "unit": "in"
    },
    "shippingLabel": "standard",
    "taxes": [
      {
        "country": "US",
        "region": "CA",
        "rate": 7.25,
        "taxShip": true
      }
    ],
    "identifierExists": true,
    "customLabel0": "bestseller",
    "customLabel1": "organic",
    "customLabel2": "spring_2025",
    "customLabel3": null,
    "customLabel4": null,
    "productTypes": [
      "Apparel & Accessories",
      "Apparel & Accessories > Clothing",
      "Apparel & Accessories > Clothing > Shirts & Tops"
    ],
    "source": "api",
    "mobileLink": "https://m.example.com/products/google-tshirt",
    "unitPricingMeasure": {
      "value": 1,
      "unit": "ct"
    },
    "unitPricingBaseMeasure": {
      "value": 1,
      "unit": "ct"
    },
    "multipack": 1,
    "isBundle": false,
    "promotionIds": [
      "PROMO2025SPRING"
    ],
    "sellOnGoogleQuantity": 100,
    "maxHandlingTime": 3,
    "minHandlingTime": 1,
    "displayAdsId": "google_tshirt_ads",
    "displayAdsLink": "https://example.com/ads/google-tshirt",
    "displayAdsTitle": "Premium Organic Cotton T-Shirt",
    "displayAdsValue": 29.99,
    "displayAdsSimilarIds": [
      "similar_tshirt_001",
      "similar_tshirt_002"
    ],
    "costOfGoodsSold": {
      "value": "15.00",
      "currency": "USD"
    },
    "includedDestinations": [
      "Shopping"
    ],
    "excludedDestinations": [],
    "adsGrouping": "tshirts",
    "adsLabels": [
      "apparel",
      "cotton",
      "organic"
    ],
    "adsRedirect": "https://example.com/ads-redirect/google-tshirt",
    "pause": "ads",
    "canonicalLink": "https://example.com/products/google-tshirt",
    "productDetails": [
      {
        "sectionName": "Material",
        "attributeName": "Fabric",
        "attributeValue": "100% Organic Cotton"
      }
    ],
    "productHighlights": [
      "Made from 100% organic cotton",
      "Comfortable and breathable",
      "Machine washable"
    ]
  }
}

Update Product Local Inventory​

Updates the local inventory of a product in your Merchant Center account. | key: updateProductLocalInventory

InputNotesExample
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).

in stock
Connection

The Google Content Shopping connection to use.

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

Instore Product Location

In-store product location.

Aisle 5, Shelf B
Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
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.

123456789
Pickup Method

The pick up option for the item.

Pickup Sla

Item store pickup timeline.

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.

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.

online:en:US:1234567890
Quantity

Quantity of the product. Must be nonnegative.

50
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

2024-11-01T00:00:00Z/2024-11-30T23:59:59Z
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.

STORE-NYC-001

{
  "data": {
    "storeCode": "STORE_001",
    "price": {
      "value": "29.99",
      "currency": "USD"
    },
    "salePrice": {
      "value": "24.99",
      "currency": "USD"
    },
    "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
    "availability": "in stock",
    "quantity": 50,
    "pickupMethod": "buy",
    "pickupSla": "same day",
    "instoreProductLocation": "Aisle 5, Shelf 3"
  }
}

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. | key: updateProductRegionalInventory

InputNotesExample
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).

in stock
Connection

The Google Content Shopping connection to use.

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

Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
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.

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

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.

online:en:US:1234567890
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.

12345
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

2024-11-01T00:00:00Z/2024-11-30T23:59:59Z

{
  "data": {
    "regionId": "123456",
    "price": {
      "value": "29.99",
      "currency": "USD"
    },
    "salePrice": {
      "value": "24.99",
      "currency": "USD"
    },
    "salePriceEffectiveDate": "2025-01-15T00:00:00Z/2025-02-15T23:59:59Z",
    "availability": "in stock"
  }
}

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. | key: updatePubSubNotification

InputNotesExample
Cloud Topic Name

Cloud pub/sub topic to which notifications are sent (read-only).

projects/my-project/topics/my-topic
Connection

The Google Content Shopping connection to use.

Kind

Identifies what kind of resource this is. Value: the fixed string 'content#account'.

content#account
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.

123456789
Registered Events

List of event types.

product.create

{
  "data": {
    "kind": "content#pubsubnotificationsettings",
    "cloudTopicName": "projects/example-project/topics/merchant-notifications-updated",
    "registeredEvents": [
      "PRODUCT_STATUS_CHANGE",
      "ORDER_PENDING_SHIPMENT",
      "ORDER_SHIPPED",
      "ORDER_DELIVERED"
    ]
  }
}

Changelog​

2025-12-15​

Deprecated 7 Order actions as Google has retired the Orders endpoints in the Content API:

  • List Orders - Now marked as deprecated
  • Get Order - Now marked as deprecated
  • Cancel Order - Now marked as deprecated
  • List Orders Returns - Now marked as deprecated
  • Get Order Return - Now marked as deprecated
  • Create Order Return - Now marked as deprecated
  • Process Order Return - Now marked as deprecated