Core resources
| Resource | Description |
|---|
| Feed | An independently configured product data output. Each feed has its own rules, settings, column mappings, and published URL. Every shop has a primary feed and can create additional feeds for different languages or markets. |
| Extract | A snapshot of product data pulled from Shopify. Extracts are shared across all feeds — one extraction provides the source data that every feed transforms independently. |
| Run | The output of applying a feed’s transformations to an extract. The latest completed run determines the published feed file at the feed’s URL. |
Feed types
| Type | Description |
|---|
primary | The default feed created when you install the app. Every shop has exactly one primary feed. |
language | A translation feed for a specific locale (e.g., French, German). Uses Shopify’s product translation data to generate a localized feed. |
market | A feed targeting a specific market with independent product selection. Market feeds can include a different subset of products and apply different rules. |
Configuration resources
| Resource | Scope | Description |
|---|
| Rules | Per-feed | Transformation rules that modify product data before the feed is published. Rule types include set_value, exclude, and replace. |
| Settings | Per-feed | Feed generation options: SEO mode, variant handling, product ID format, quantity source, unpublished product inclusion. |
| Column Mappings | Per-feed | How source product fields from Shopify map to feed output columns (e.g., vendor → brand). |
| Extra Columns | Per-feed | Custom columns added to the feed beyond the standard Google Merchant Center fields. |
| Metafields | Shop-level | Configuration for which Shopify metafields to include in extracted product data. Shared across all feeds. |
Channel resources
| Resource | Scope | Description |
|---|
| Channel | Shop-level | An advertising platform connection (Google Merchant Center, Meta, etc.). Manages OAuth credentials and merchant account selection. |
| Datafeed | Per-feed | A publishing configuration that connects a specific feed to a channel. Each datafeed has its own fetch schedule and target markets. |
Pipeline
The data pipeline flows through three stages:
- Extract — Product data is pulled from Shopify into a shared source snapshot.
- Feed Transform — Each active feed applies its own rules, settings, and mappings to the extract data.
- Run — The transformed output is written to the feed’s published URL.
Shopify → Extract (shared) → Feed A → Run A → gmcfeed.txt
→ Feed B → Run B → gmcfeed-fr.txt
→ Feed C → Run C → gmcfeed-canada.txt
One extract produces one run per active feed. Extracts can be triggered via POST /v1/extracts.