README

Google Merchant Sales Channel

It is a Google service that allows users to search for products on online shopping websites and compare prices between different vendors.

How Merchant Center works

1- Add your products to Google Merchant Center

If you use an e-commerce platform like Shopify or BigCommerce (Shopiroller 😄), you can link your store to add your products automatically. You can also choose to upload spreadsheets or add items individually.

2- Your products are shown for free in the Shopping tab

When customers search for your product offerings or directly about your business, your products can show up on a variety of Google websites and apps, such as Search, Maps, and YouTube.

3- Customers click to buy your products

When users click on your product, they are directed by Google to the product page on your website. If you have a physical store, you can also direct customers there.

Product data specification

Use the guide below to format your product information for Merchant Center.

https://support.google.com/merchants/answer/7052112?hl=tr&ref_topic=6324338&sjid=6198378702426312732-EU

Fields used in Shopiroller

No [id]

Compulsory

The unique identifier of your product.

Example A2B4

syntax Up to 50 characters


Title [title]

Compulsory

Your product name

Example Men's Woven T-Shirt

syntax Up to 150 characters


Description [description]

Description of your product

Compulsory

Example Made from 100% organic cotton, this classic men's woven t-shirt in red has a slim fit and a custom brand logo embroidered on the left chest. Machine wash in cold water; has been imported.

syntax Up to 5,000 characters


Your product's landing page

Compulsory

Example http://www.example.com/asp/sp.asp?cat=12&id=1030


URL of the main image of your product

Compulsory

Example http://www.example.com/picture1.jpg

Use an image of at least 100 x 100 pixels for non-clothing items. For clothing items, use an image of at least 250 x 250 pixels.


URL of an additional image for your product

Optional

Example http://www.example.com/picture1.jpg

syntax Up to 2,000 characters

You can add up to 10 product images using this feature multiple times.


Availability [availability]

Availability of your product

Compulsory

Example in_stock

Supported values

In stock [in_stock] Out of stock [out_of_stock] Pre-order [preorder] Future order [backorder]


price [price]

The price of your product

Compulsory

Example: 15.00 TRY


Discounted price [sale_price]

The discounted price of your product

Optional

Example: 15.00 TRY


Product type [product_type]

Optional

The product category you define for your product

Example Home > Women > Dresses > Maxi Dresses

syntax Up to 750 alphanumeric characters


brand [brand]

Brand name of your product

Mandatory (For all new products except film, book and music record brands)

Optional for all other products.

Example Google

syntax Up to 70 characters

Leave this field blank for unbranded items (e.g. a classic dress without a tag, general electronic accessories, etc.).


shipping [shipping]

Shipping cost of your product, shipping times, and locations where your product will be shipped.

syntax This feature uses the following sub-features:

Country [country] (Required) ISO 3166 country code Region [region] (Optional)

Creating the file containing category-based products

METHOD : GET

URL : /{v}/googleMerchantSettings//getProductsFile?categoryId=&countryIso2=

Fields

appId : Id information of the application categoryId : Selecting the products belonging to a certain category with the ID information countryIso2 : Bringing the product information according to a certain region (ISO2 ⇒ TR or EN etc.).

Response

{
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" version="2.0" xmlns="http://base.google.com/ns/1.0">
  <channel>
    <title>Elektrikçim</title>
    <link>https://google.com/</link>
    <item>
      <id>64abc3e785643e0638079c75</id>
      <title>Nokia 3310 Batarya Pil 3315 3410 3510 Orjinal Batarya Pil 1300 Mah APN-616-0666</title>
      <description>Nokia 3310 Batarya Pil 3315 3410 3510 Orjinal Batarya Pil 1300 Mah APN-616-0666</description>
      <link>https://google.com/telefon-nokia-3310-batarya-pil-3315-3410-3510-orjinal-batarya-pil-1300-mah-apn-616-0666</link>
      <availability>in_stock</availability>
      <price>199 TRY</price>
      <sale_price>186 TRY</sale_price>
      <product_type>Phone</product_type>
      <identifier_exists>no</identifier_exists>
      <shipping>
        <country>tr</country>
        <price>8 TRY</price>
      </shipping>
    </item>
    <item>
      <id>64a6d05685643e0638070c5f</id>
      <title>Samsung Galaxy A32 128 GB Beyaz Cep Telefonu (Samsung Türkiye Garantili)</title>
      <description>Samsung Galaxy A32 128 GB Beyaz Cep Telefonu (Samsung Türkiye Garantili)</description>
      <link>https://google.com/telefon-samsung-samsung-galaxy-a32-128-gb-beyaz-cep-telefonu-samsung-turkiye-garantili</link>
      <image_link>https://dev.content.cdn.shopiroller.com/f1082f06-2eff-43f7-9625-4c8fdccee6bb/images/06c75ad6-766d-495a-b030-3c8d366209a5.jpg</image_link>
      <additional_image_link>https://dev.content.cdn.shopiroller.com/f1082f06-2eff-43f7-9625-4c8fdccee6bb/images/d49cb3ae-5f89-437a-af68-75710a31d206.jpg</additional_image_link>
      <additional_image_link>https://dev.content.cdn.shopiroller.com/f1082f06-2eff-43f7-9625-4c8fdccee6bb/images/3013a90a-13f3-44a6-acf6-cfc1a5f78552.jpg</additional_image_link>
      <additional_image_link>https://dev.content.cdn.shopiroller.com/f1082f06-2eff-43f7-9625-4c8fdccee6bb/images/a4b6cc5d-d93d-4e46-93dc-639dc0f71e13.jpeg</additional_image_link>
      <availability>in_stock</availability>
      <price>23562 TRY</price>
      <sale_price>22563 TRY</sale_price>
      <product_type>Phone</product_type>
      <identifier_exists>no</identifier_exists>
    </item>
    <item>
      <id>64a6c99585643e0638070ae2</id>
      <title>Apple Yenilenmiş Iphone Se 2020 64 Gb Beyaz 64 Gb Beyaz A Grade 46-1</title>
      <description>Apple Yenilenmiş Iphone Se 2020 64 Gb Beyaz 64 Gb Beyaz A Grade 46-1</description>
      <link>https://google.com/telefon-apple-apple-yenilenmis-phone-se-2020-64-gb-beyaz-64-gb-beyaz-a-grade-46-1</link>
      <image_link>https://dev.content.cdn.shopiroller.com/f1082f06-2eff-43f7-9625-4c8fdccee6bb/images/f48fa850-462b-4ea2-846c-ec4f266777a0.jpg</image_link>
      <additional_image_link>https://dev.content.cdn.shopiroller.com/f1082f06-2eff-43f7-9625-4c8fdccee6bb/images/5e34d9db-b864-4045-8669-10a888cb7739.jpg</additional_image_link>
      <availability>in_stock</availability>
      <price>7500 TRY</price>
      <product_type>Phone</product_type>
      <identifier_exists>no</identifier_exists>
    </item>
  </channel>
</rss>
}

Exception Keys

WebSettingsNotFound : The case that the project (appId) does not have a website sales channel.