A product description page (PDP) teaches shoppers about your product's features and benefits before they complete their purchase with Buy on Google. 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,
feedLabel, 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"contentLanguage: The two-letter language code, such as "en" or "fr"feedLabel: The two-letter language code, such as "US" or "FR"offerId: A unique identifier string provided by the merchant
Sample request
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "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.
Sample request
"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.
Sample request
"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.
Sample request
"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.
Sample request
"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.
Sample request
"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.
Sample request
"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.
Sample request
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Example: Upload rich product data with products.insert
The following JSON sample shows an example of a request for a products.insert
call for uploading rich product data.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
{
"channel": "online",
"contentLanguage": "en",
"offerId": "pixel4",
"targetCountry": "US",
"feedLabel": "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"
}