We will sunset v2 of the Content API on March 29th, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible. For more information, see Migrating to v2.1.

Uploading Rich Product Data for Product Description Pages

A product description page (PDP) teaches shoppers about your product's features and benefits before they complete their purchase on Shopping Actions. You can create rich PDPs by uploading rich product data via the Content API for Shopping. Rich product data includes information about the product's features and benefits, product variants, and product images.

Additional benefits of rich product data include:

  • Improving product discovery by providing more detailed product descriptions to help customers find products that meet their needs
  • Increasing customer trust by providing accurate product information that enables confident purchase decisions
  • Helping improve conversion by more clearly conveying the value of a product to customers

This guide explains how to use the Content API to upload rich product data when creating products using the products.insert method. The following sections provide partial request bodies containing the attributes for the products resource that make up rich product data. For a complete JSON request, see Example: Uploading rich product data using products.insert.

Product ID attributes

A product’s id attribute, also known as the REST ID, is a unique identifier that is derived from the values that you provide for the channel, contentLanauge, targetCountry, and offerId attributes. For example, online:en:US:1111111111. For rich product data, include values for all of the product ID attributes:

  • channel: "online" or "local"
  • contentLanauge: The two-letter language code, such as "en" or "fr"
  • targetCountry: The two-letter language code, such as "US" or "FR"
  • offerId: A unique identifier string provided by the merchant

Request sample

"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"offerId": "1111111111"

Product title

Putting key product details, such as information about brand, gender, size, and color, in the title attribute helps customers quickly determine whether they are looking at the right product. For additional guidelines and requirements for product titles, see title: Definition.

Request sample

"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"

Product description

A rich product description, provided via the description attribute, can help educate customers about the product in ways that specifications and images can’t. For additional guidelines and requirements for product descriptions, see description: Definition.

Request sample

"description": "The Google phone. MotionSense, an evolved camera, and the new
Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos.
Without the studio. Shoot without the flash. Capture rich detail and color, even
in the dark, with the next generation of Night Sight. Capture the cosmos. The
camera that can take photos of the Milky Way."

Product images

Enhance your product description pages by providing product images via the imageLink and additionalImageLinks attributes. We recommend providing multiple high-quality images showing the product from different angles and in different contexts. For additional guidelines and requirements for product images, see image_link: Definition.

Request sample

"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
    "https://example.com/gallery/500/image2.jpg",
    "https://example.com/gallery/500/image3.jpg",
    "https://example.com/gallery/500/image4.jpg",
    "https://example.com/gallery/500/image5.jpg"
  ]

Product variants

You can use the itemGroupId attribute to define product groups for variants of similar products. For guidelines on how and when to group products, as well as requirements and best practices, see item_group_id: Definition.

Request sample

"itemGroupId": "pixels"

Product highlights

The product highlights section on a product description page shows a short, bulleted list of product details next to the main product image. Use the productHighlights attribute to provide a list of items for the product highlights section. We recommend providing at least five product highlights. For additional guidelines and requirements for product highlights, see product_highlights: Definition.

Request sample

"productHighlights": [
    "6GB RAM lets you enjoy multitasking conveniently",
    "Touch screen feature offers user friendly interface",
    "Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
  ]

Product details

The product details section on a product description page shows additional product information below the product image (the layout may differ between desktop and mobile pages). Use the productDetails attribute to provide a list of product details objects, each of which includes a sectionName, attributeName, and attributeValue attribute. We recommend providing at least six product details. For additional guidelines and requirements for product details, see product_detail: Definition.

Request sample

  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ]

Unique product identifiers (GTIN, brand, MPN)

Google uses unique product identifiers to identify products. We strongly recommend providing a GTIN value for each of your products. If you do not provide a GTIN, you must provide values for both brand and MPN so that we can identify your product. For more information about identifier types, see About unique product identifiers.

Request sample

"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"

Example: Uploading rich product data using products.insert

The following JSON sample shows an example of a request for a products.insert call for uploading rich product data.

POST https://www.googleapis.com/content/v2.1/{merchantId}/products
{
  "channel": "online",
  "contentLanguage": "en",
  "offerId": "pixel4",
  "targetCountry": "US",
  "title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White",
  "description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.",
  "imageLink": "https://example.com/gallery/500/image1.jpg",
  "additionalImageLinks": [
    "https://example.com/gallery/500/image2.jpg",
    "https://example.com/gallery/500/image3.jpg",
    "https://example.com/gallery/500/image4.jpg",
    "https://example.com/gallery/500/image5.jpg"
  ],
  "brand": "Google",
  "googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones",
  "gtin": "842776114952",
  "mpn": "GA01188-US",
  "price": {
    "currency": "USD",
    "value": "549.99"
  },
  "salePrice": {
    "currency": "USD",
    "value": "549.99"
  },
  "productHighlights": [
    "6GB RAM lets you enjoy multitasking conveniently",
    "Touch screen feature offers user friendly interface",
    "Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
  ],
  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ],
  "availability": "in stock",
  "condition": "new",
  "includedDestinations": [
    "Shopping Actions"
  ],
  "excludedDestinations": [
    "Shopping Ads"
  ],
  "sellOnGoogleQuantity": 100,
  "shippingLabel": "US_Test"
}