# Set up a Google Shopping API

There are two ways with which you can create Google Shopping Ads in Google Merchant Center: you can either [export a feed](/list-advertise/google/list-items-on-google-shopping/set-up-a-google-shopping-feed.md) or send your products via an API. This article covers the Google Shopping API.

***

### Before you start <a href="#id-01jmhtpqh8hhzc7ea3e8mvzzmf" id="id-01jmhtpqh8hhzc7ea3e8mvzzmf"></a>

**You'll need**

* A [Google Merchant Center account](https://support.google.com/merchants/answer/188924?hl=en\&sjid=9925308023770440011-EU)
* A target country enabled in Google Merchant Center (Set at 'Countries' in **Data sources > \[your source] > Data source setup** in Google Merchant Center)

**Good to know**

* If you see a failed API error, your Google Shopping connection may have expired. To fix this, reconnect your channel to your Google account.&#x20;
* EAN codes aren’t mandatory for Google Shopping. If you’re sending EANs to Google, you can create a rule to exclude products with invalid EANs to avoid errors.
* Product data that uses decimal values using commas (,) aren't accepted. If your data uses commas, you'll need to change them to decimal points (.).&#x20;

{% stepper %}
{% step %}

### Create your Google Shopping API

1. In Channable, go to **Projects** > **\[Your project]** > **Channels.**
2. Click **+ Create Channel > Google Shopping > API**.
3. Click **Next** to confirm your selection.
4. &#x20;Fill in your channel settings:
   * For **Name**, give your channel a descriptive name.
   * For **Unique ID per item**, select the field containing your product ids.
   * For **Google Merchant Center ID**, enter your [Google Merchant Center ID](https://support.google.com/paymentscenter/answer/7163092?hl=en).
   * For **Country**, select the country you want to list in.
   * For **Language**, select the language your product data is in.&#x20;
   * For **Use master rule group**, select a master rule group to apply to your channel (if you have one).
5. Click **Save**.
   {% endstep %}

{% step %}

### Categorize your products <a href="#h_01hy3d918ceywpf46yj5cf60r2" id="h_01hy3d918ceywpf46yj5cf60r2"></a>

1. In **\[your Google Shopping channel]**, go to the **Categories** step.
2. Map (assign) categories for all items.
   {% endstep %}

{% step %}

### Create rules <a href="#h_01k8r8et8k49h991f4an53c0zw" id="h_01k8r8et8k49h991f4an53c0zw"></a>

When your product data is incomplete or doesn’t match the format that Google requires, you can use rules to make improvements.&#x20;

1. Create rules to optimize your products and meet Google Shopping's listing requirements.

{% hint style="success" %}
**Tip:** Use our rule templates to quickly set up rules.
{% endhint %}

{% hint style="warning" %}
**Important:** Don't create any rules to exclude out of stock products. Google uses availability status to indicate whether a product is out of stock.&#x20;
{% endhint %}
{% endstep %}

{% step %}

### Map shared attributes <a href="#h_01k8r8et8kcy6gv59c1p25henr" id="h_01k8r8et8kcy6gv59c1p25henr"></a>

The **Build** step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

{% hint style="success" %}
**Tip:** Hover over for more information about the attribute, accepted values, and an example.&#x20;
{% endhint %}

1. Go to the **Build** step.
2. Map attributes marked as required by marketplace ().
3. Map any remaining attributes that are relevant for your business.
4. Click **Save**.

#### **Detailed information about required attributes** <a href="#h_01k8r3btqd21fhsabfv21h0a7w" id="h_01k8r3btqd21fhsabfv21h0a7w"></a>

**Items section**

* **Availability:** Select the field that indicates your product's stock status&#x20;
* **Title:** Select the field that contains product titles&#x20;
* **Description:** Select the field that contains your product descriptions
* **Link:**
* **Brand:** Select the field that contains the product's brand
* **Condition:** Select the field that indicates your product's condition
  * If the same condition applies to all your products, click the dropdown > **Static values** and select the condition type.
* **Channel:** Select the field containing information on where you house your product's inventory data.&#x20;
  * If your inventory is all housed locally/online, click the dropdown > **Static values** and select the location type.
* **Currency:** Select the field containing information on the currency you're selling your products in.&#x20;
  * If you're selling in the same currency for all products, click the dropdown > **Static values** and select the currency.
* **Price:** Select the field containing your product prices.

  **Note:** Decimal values using commas (,) aren't accepted. If your data uses commas, you'll need to change them to decimal points (.).&#x20;
  {% endstep %}

{% step %}

### Connect to Google Merchant Center <a href="#h_01hy3d918dgz1e9sgg7cxd9w6m" id="h_01hy3d918dgz1e9sgg7cxd9w6m"></a>

Once you have finished setting up your product listings, you can send them to your Google Merchant Center:

1. In **\[your Google Shopping API]**, go to **Settings**.
2. At **Linked seller account**, click **Select seller account**.&#x20;
3. Click **+ Connect a new account** to add a new seller account.
   1. For **Label**: Name your connection
4. We'll redirect you to Google to log in with your credentials and accept permissions.
   {% endstep %}

{% step %}

### Activate your API <a href="#h_01k8tcc2hbbg22yvvycm4910xd" id="h_01k8tcc2hbbg22yvvycm4910xd"></a>

1. Activate your project if you haven't done so already (**Settings > Activate Project > Save**)
2. In the **Settings** step of **\[your Google Shopping API]**, click **Activate API**.
3. Click **Save**.
4. Click **Run now** to send your listings to Google Shopping.
   {% endstep %}

{% step %}

### Review and fix listing errors <a href="#h_01j35h130qvdf03xj50b02adjv" id="h_01j35h130qvdf03xj50b02adjv"></a>

Go to the **Result** step and click on the **Feedback** tab. This page displays all possible processing errors your product data has at a given moment.&#x20;

#### **Resolving errors** <a href="#h_01k8r8dqkckp5peq77mmdev91f" id="h_01k8r8dqkckp5peq77mmdev91f"></a>

1. In **Description**, click on the error name. This takes you to an overview of the products with that error.
2. In **ID**, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.
   1. If the error is a mapping error, click **View in build** to be directed to the attribute you need to map/re-map, which is highlighted in blue.
   2. For more information about the attribute and its accepted values, hover over .
3. Resolve the error.
4. Repeat for remaining errors. When you're ready, run your channel again by clicking **Run now**.

You can check your successfully listed products in the **Successful** tab.&#x20;
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/google/list-items-on-google-shopping/set-up-a-google-shopping-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.