產品說明頁面的詳盡產品資料

產品說明頁面 (PDP) 提供產品的功能與優點，方便購物者透過 Buy on Google 完成交易。您可以透過 Content API for Shopping 上傳豐富的產品資料，藉此建立豐富的 PDP。豐富的產品資料包含產品的功能和優點、產品子類及產品圖片的相關資訊。

提供多媒體產品資料的其他好處包括：

• 提供更詳細的產品說明以協助消費者找到符合需求的產品，藉此提升產品曝光率
• 提供準確的產品資訊，讓消費者在購物決策過程中更有把握，贏得他們的信任
• 向客戶清楚說明產品的價值，進而提升轉換率

本指南說明如何在使用 products.insert 方法建立產品時，透過 Content API 上傳豐富的產品資料。以下各節提供部分要求主體，包含構成豐富產品資料的 products 資源屬性。如需完整的 JSON 要求，請參閱範例：使用 products.insert 上傳豐富的產品資料。

注意： 如要進一步瞭解內容豐富的產品說明頁面，包括如何在 Merchant Center 中新增豐富的產品資料，請參閱「為 Buy on Google 建立內容豐富的產品說明頁面」。

產品 ID 屬性

產品的 id 屬性 (又稱為 REST ID) 是專屬 ID，衍生自您為 channel、contentLanauge、feedLabel 和 offerId 屬性提供的值。例如：online:en:US:1111111111。針對豐富的產品資料，請在所有產品 ID 屬性中加入值：

• channel：「online」或「local」
• contentLanguage：由兩個字母組成的語言代碼，例如「en」或「fr」
• feedLabel：由兩個字母組成的語言代碼，例如「US」或「FR」
• offerId：商家提供的專屬 ID 字串

要求範例

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

產品名稱

在 title 屬性中列出品牌、性別、尺寸和顏色等重要產品詳細資料，可協助消費者快速判斷自己查看的是正確的產品。如需產品名稱的其他規範和規定，請參閱名稱：定義。

要求範例

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

產品說明

透過 description 屬性提供豐富的產品說明，有助於以不適用規格和圖片的方式，向客戶介紹產品。如需產品說明的其他規範和規定，請參閱說明：定義。

注意： Google 可能會根據產品專屬全球交易品項識別碼的比對結果調整產品說明的格式。

要求範例

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

產品圖片

透過 imageLink 和 additionalImageLinks 屬性提供產品圖片，讓產品說明頁面更豐富。建議您提供多張高畫質圖片，從不同角度和情境呈現產品。如需瞭解產品圖片的其他規範和規定，請參閱 image_link：定義。

要求範例

"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"
  ]

產品子類

您可以使用 itemGroupId 屬性為類似產品的子類定義產品群組，有關產品分組方式和時機的指南，以及相關規定和最佳做法，請參閱 item_group_id：定義。

要求範例

"itemGroupId": "pixels"

產品特色

產品說明頁面上的「產品亮點」專區會在主要產品圖片旁邊，顯示簡短的產品項目符號清單，使用 productHighlights 屬性為產品亮點的部分提供商品清單。建議您提供至少五個產品亮點。如需瞭解產品亮點的其他規範和規定，請參閱 product_highlights：定義。

注意： Google 可能會根據產品的專屬全球交易品項識別碼，修改產品亮點專區的內容。

要求範例

"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、attributeName 和 attributeValue 屬性。建議您至少提供六個產品詳細資料。如需產品詳細資料的其他指南和規定，請參閱 product_detail：定義。

注意： 提供的產品詳細資料必須與產品的全球交易品項識別碼詳細資料相符。

要求範例

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

專屬產品 ID (全球交易品項識別碼、品牌、製造商零件編號)

Google 會使用專屬產品 ID 識別產品。強烈建議您為每項產品提供全球交易品項識別碼值。如未提供全球交易品項識別碼，請務必同時提供 品牌 和 MPN 的值，方便我們識別您的產品。如要進一步瞭解 ID 類型，請參閱「專屬產品 ID 簡介」一文。

注意： Google ID 也會用來將產品與評論資料 (如有) 進行比對。如要進一步瞭解如何提供評論資料，請參閱「產品評分提交選項」一文。

要求範例

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

範例：使用 products.insert 上傳豐富的產品資料

以下 JSON 範例顯示要求 products.insert 呼叫以上傳豐富的產品資料的要求範例。

警告： 根據預設，如果呼叫 products.insert 以更新現有產品，系統會將所有產品資料替換成要求主體中提供的欄位。如要進一步瞭解如何在不替換現有產品資料的情況下更新產品，請參閱補充動態饋給。

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"
}