> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/google/list-items-on-google-shopping/set-up-a-google-shopping-api.md).

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

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> 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)

**Good to know**

* 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 (.).

{% 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. Fill in your channel settings:
   1. For **Name**, give your channel a descriptive name (like `Google Shopping API - UK`).
   2. For **Unique ID per item**, select the field containing your product ids.
   3. For **Google Merchant Center ID**, enter your [Google Merchant Center ID](https://support.google.com/paymentscenter/answer/7163092?hl=en).
   4. For **Country**, select the country you want to list in.
   5. For **Language**, select the language your product data is in.
   6. For **Feed label** (optional), create a label to add to all your products. If left empty, the country code will be used as the feed label.

{% hint style="info" %}
Your feed label must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-).
{% endhint %}

5. For **Master rules** (optional), select a master rule group to apply the same rules to this channel.
6. 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.

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

{% hint style="success" %}
Use [rule templates](/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules/rule-templates.md) to quickly set up rules.
{% endhint %}

{% hint style="warning" %}
Don't create any rules to exclude out of stock products. Google uses availability status to indicate whether a product is out of stock.
{% 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" %}
Hover over <i class="fa-circle-info">:circle-info:</i> for more information about the attribute, accepted values, and an example.
{% 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>

{% hint style="info" %}
For Google’s formatting requirements, see their [Product data specification guide](https://support.google.com/merchants/answer/7052112?hl=en).
{% endhint %}

<details>

<summary><strong>Attributes in Items section</strong></summary>

* **Availability:** Select the field that indicates your product's stock status
* **Title:** Select the field that contains product titles
* **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.
  * 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.
  * 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.

</details>

{% hint style="warning" %}
Decimal values using commas (,) aren't accepted. If your data uses commas, you'll need to change them to decimal points (.).
{% endhint %}
{% 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**.
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.

Each error includes a translated **Status**, **Description**, and, when available, **Solution**. If action is required, you also receive an email notification.

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

1. Review the **Status**, **Description**, and **Solution** for the specific error first.
2. Follow the solution shown for that error.
3. In **Description**, click on the error name. This takes you to an overview of the products with that error.
4. 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 .
5. Resolve the error.
6. Repeat for remaining errors. When you're ready, run your channel again by clicking **Run now**.

{% hint style="info" %}
Only renew your connection when the error status says **Invalid connection** and the solution says to renew it.
{% endhint %}

#### **Examples of actionable errors** <a href="#h_01kz2t5jwew0z2s1c9j13v8d5n" id="h_01kz2t5jwew0z2s1c9j13v8d5n"></a>

* **Invalid connection:** Renew the connection.
* **Invalid Feed Label:** Create a new Google Shopping API channel with a valid feed label.
* **Invalid Target country:** Create a new Google Shopping API channel with a valid target country.
* **Invalid Content language:** Create a new Google Shopping API channel with a valid content language.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.