Google Shopping - Merchant API voor Magento 2
Test out this module for Free
Google Shopping - Merchant API
Check your email
We've sent a confirmation link. Click it to spin up your demo.
Setting up your demo...
This usually takes a few minutes. You can close this modal or wait for the result — we'll also send you an email when it's ready.
You're in the queue
Position: #
All demo slots are currently in use. You'll receive an email as soon as your demo is ready.
Your demo is ready!
Verloopt:
Credentials have also been sent to your email.
Er ging iets mis
We couldn't set up your demo. Please try again or contact support.
This module requires:


Google Merchant API-koppeling voor Magento 2
Productwijzigingen binnen enkele minuten in Google Merchant Center
De extensie Google Shopping - Merchant API koppelt Magento 2 rechtstreeks aan Google Merchant Center via de officiële Google Merchant API. Verandert er in Magento een prijs, voorraad of attribuut, dan stuurt de extensie dat ene product naar Google en wacht niet op de volgende keer dat de feed wordt opgehaald.
Prijs- en voorraadwijzigingen gaan elke 2 minuten de wachtrij in, andere productwijzigingen elke 5 minuten. Zo blijft de productdata achter je Google Shopping-campagnes gelijk aan je winkel, ook tijdens een actie of als de voorraad opraakt.
Het is een uitbreiding op de Google Shopping Feed-extensie en gebruikt dezelfde attribuutkoppelingen en productfilters. De feed blijft je complete basis, de API regelt wat er tussendoor verandert.

Directe koppeling met de Merchant API
REST-verzoeken naar de officiële Google Merchant API met een Google-serviceaccount, zonder externe Google-bibliotheken.
Prijs en voorraad elke 2 minuten
Een aparte inventory-sync zet wijzigingen in prijs, actieprijs en beschikbaarheid elke 2 minuten in de wachtrij.
Alleen wat is gewijzigd
Een indexer markeert gewijzigde producten en een hashcontrole slaat de API-call over als de data gelijk is aan de laatste sync.
Werkt samen met de feed-extensie
Attribuutkoppelingen, filters en Offer ID komen uit Google Shopping Feed, zodat feed en API hetzelfde product bijwerken.
Ingericht per store view
Elke store view heeft een eigen API-datasource, doelland en contenttaal.
Status, batches en logs
Een status per product, een overzicht van elke syncbatch, debuglogging en CLI-commando's laten zien wat is verstuurd en wat is mislukt.
Van productwijziging naar Google Merchant Center in enkele minuten
De extensie voegt een eigen indexer toe, "Google Shopping API Product", die een product markeert zodra de data verandert. Die indexer kijkt naar de producttabellen zelf: productgegevens en attributen, voorraad, website- en categoriekoppeling, staffelprijzen en de mediagalerij.
- De indexer markeert het gewijzigde product.
- De cron zet gemarkeerde producten in de wachtrij: prijs- en voorraadwijzigingen elke 2 minuten, volledige productupdates elke 5 minuten, tot de "Batch Size" (10 tot 1000, standaard 100) per store view per run.
- Twee queue consumers sturen de updates naar de Merchant API.
- Voordat er een call uitgaat, wordt een hash van de verse data vergeleken met de laatst gesynchroniseerde versie. Is er niets veranderd, dan gaat er geen API-call uit.
"Auto Sync Enabled" staat standaard uit, dus er verlaat niets de winkel tot je het aanzet. Een nachtelijke controle om 02:00 pakt producten op die nieuw zijn in je feedselectie. Producten die uit de feed zijn verdwenen, worden alleen uit Merchant Center verwijderd als "Delete Products Not in Feed" op "Yes" staat; de standaard is "No".
Volledige sync en inventory-sync
Een volledige sync stuurt alle productdata uit je feedkoppeling. Een inventory-sync stuurt alleen prijs, actieprijs, de looptijd van de actieprijs en beschikbaarheid: een kleine payload voor de wijzigingen die het vaakst voorkomen.


Merchant API of Google Shopping Feed: wat is het verschil?
De Google Shopping Feed-extensie schrijft je catalogus naar een XML-bestand dat Google volgens een schema ophaalt, bijvoorbeeld dagelijks of elk uur. Dat is een stevige basis, maar een prijs die je om 10:00 aanpast, komt pas bij de volgende keer ophalen bij Google aan.
Deze extensie voegt een directe koppeling toe. Die wacht niet tot Google iets ophaalt, maar stuurt het ene product dat is gewijzigd zelf naar Merchant Center.
- Google Shopping Feed: de volledige catalogus in één bestand, opgehaald volgens een schema, in een file-datasource in Merchant Center.
- Merchant API: één call per gewijzigd product, elke 2 of 5 minuten in de wachtrij gezet, in een API-datasource in Merchant Center.
Het is een koppeling die bijna realtime werkt, niet een die op de seconde reageert. Updates lopen via de Magento-cron en de message queue, zodat een grote import in batches wordt verwerkt en niet in één keer.
Beide routes gebruiken dezelfde Offer ID, afkomstig uit de id-koppeling in de feedinstellingen, zodat Google één product ziet. Laat de feed draaien als vangnet voor de volledige catalogus en laat de API afhandelen wat er tussendoor verandert. De extensie vereist Google Shopping Feed 2.12.0 of hoger.
Verbinden met een Google-serviceaccount
Vul de "Merchant ID" van je Merchant Center-account in en plak het sleutelbestand van een Google Cloud-serviceaccount in "Service Account JSON". De sleutel wordt versleuteld opgeslagen in de Magento-configuratie. Met een testknop onder de velden controleer je de verbinding voordat je iets aanzet.
De extensie praat met merchantapi.googleapis.com via de eigen HTTP-client van Magento. Er zijn dus geen externe Google-bibliotheken om te installeren of bij te houden.
"Enable Module" staat standaard uit. Zet het op "Yes" zodra de verbindingstest slaagt.


Actuele prijzen en voorraad in je Google Shopping-campagnes
Shopping-campagnes tonen de prijs en beschikbaarheid die Google in Merchant Center heeft staan. Start er een actie of raakt een product uitverkocht, dan is elk uur dat Google nog de oude waarde heeft een uur waarin je advertentie en je productpagina niet overeenkomen.
Daar is de inventory-sync voor. Een wijziging in prijs, actieprijs, actieperiode of beschikbaarheid staat binnen 2 minuten in de wachtrij en gaat als kleine update met alleen die velden naar Google. Staat de indexer op "Update on Save", dan herkent de extensie een opslag waarbij alleen prijsvelden zijn geraakt en kiest hij zelf deze lichtere route.
De extensie maakt of beheert geen campagnes of biedingen. Hij houdt de productdata waar ze op draaien actueel.
Eén API-datasource per store view
Elke store view krijgt een eigen datasource in Merchant Center, zodat je vanuit één Magento-installatie meerdere landen en talen bedient. De tabel "API Data Sources" in de groep "Data Source" toont elke store view met de datasource, de status en de knoppen "Test" en "Configure".
"Configure" brengt je naar de store view, waar je instelt:
- "Status": zet de sync voor deze store view aan of uit.
- "API Data Source ID": het numerieke ID van de API-datasource. Maak die aan in Merchant Center via Products > Feeds > Add data source > API.
- "Feed Label (Target Country)": het land waarvoor de producten bedoeld zijn.
- "Content Language": de taal van de productcontent.


Synchronisatiestatus per product in de Magento-admin
Onder "Marketing" > "Google Shopping API" > "Products" zie je elk product per store view met SKU, Offer ID, status, foutmelding en het moment van de laatste sync. Een product is Pending, Queued, Synced, Error, Pending Delete of Disabled, dus met één filter zie je wat nog aandacht nodig heeft.
"Initialize Products" laadt de producten uit je feedselectie in de grid. Daarna werk je met massa-acties:
- "Sync to Google (Full)" en "Sync Inventory (Price/Stock)": verstuur de geselecteerde producten zelf.
- "Flag for Full Update" en "Flag for Inventory Update": markeer ze voor de volgende cronrun.
- "Disable Sync" en "Enable Sync": houd losse producten buiten de sync of haal ze terug.
Sync Batches en nieuwe pogingen
"Sync Batches", in hetzelfde menu, legt elke run vast: de store view, het type (Product of Inventory), het aantal producten, hoeveel er zijn gelukt en mislukt, de duur en de begin- en eindtijd. Met "Retry Failed" verstuur je de mislukte producten van een batch opnieuw.
Tijdelijke problemen handelt de extensie zelf af. Bij een rate limit (HTTP 429) of een serverfout (5xx) probeert hij het maximaal 3 keer, met na elke poging een langere pauze.
Een product dat dan nog mislukt, krijgt de status Error met de melding van Google. Je herstelt de data en synchroniseert het opnieuw vanuit de grid.


Debuglogging en CLI-commando's
Zet "Debug Mode" aan in de groep "Debug & Logging" en elk API-verzoek en elk antwoord wordt naar debug.log geschreven. Fouten gaan altijd naar error.log, ook als debug mode uit staat. Beide logs open je vanuit de configuratie. De syncregels die de extensie bewaart, worden elke nacht opgeschoond volgens "Log Retention (Days)", standaard 30.
Er zijn zes CLI-commando's: googleshopping:api:initialize, googleshopping:api:sync, googleshopping:api:sync-check, googleshopping:api:status, googleshopping:api:test en googleshopping:api:test-connection.
Het sync-commando accepteert --store, --limit, --product-id voor één product, --inventory voor alleen prijs en voorraad, --force om de wijzigingscontrole over te slaan en --dry-run om te zien wat er verstuurd zou worden zonder een API-call te doen.
Google Shopping - Merchant API voor Magento 2: technische details voor developers en winkeleigenaren
De voordelen voor developers
- Eigen indexer
googleshopping_api_productmet mview-subscriptions op de tabellen voor producten, EAV, voorraad, websites, categorieën, staffelprijzen en mediagalerij. - Twee queue consumers,
googleshopping.product.syncengoogleshopping.inventory.sync, op dedb-connection, dus een message broker zoals RabbitMQ is niet nodig. De consumers moeten wel draaien, bijvoorbeeld via de Magento-cron. - Een REST-client op de eigen HTTP-client van Magento, gericht op
merchantapi.googleapis.com, zonder externe Google-bibliotheken. - Wijzigingsdetectie met aparte hashes voor de volledige productdata en voor de inventoryvelden.
- Maximaal 3 pogingen met een oplopende pauze bij HTTP 429 en 5xx.
- Zes CLI-commando's onder
googleshopping:api:, met--dry-runen--forceop het sync-commando. - Alleen backend: de module voegt niets toe aan de storefront en werkt dus met elk thema hetzelfde.
- Vereist PHP 8.1 of hoger en
magmodules/m2-googleshopping2.12.0 of hoger.
Goed om te weten voor winkeleigenaren
- Dit is een uitbreiding. Je hebt de Google Shopping Feed-extensie nodig; je productselectie en attribuutkoppelingen komen daarvandaan.
- Je hebt een Google Merchant Center-account, een Google Cloud-serviceaccount en één API-datasource per store view nodig.
- "Enable Module" en "Auto Sync Enabled" staan standaard uit. Er wordt niets verstuurd tot je beide aanzet.
- Prijs- en voorraadwijzigingen gaan elke 2 minuten de wachtrij in, andere productwijzigingen elke 5 minuten.
- Producten worden alleen uit Merchant Center verwijderd als "Delete Products Not in Feed" op "Yes" staat.
- Elk product toont zijn syncstatus in de admin, en bij een mislukt product staat de foutmelding van Google.
Houd Google Merchant Center gelijk met je Magento 2-catalogus
Voeg de Merchant API-koppeling toe aan je Google Shopping Feed en stuur prijs-, voorraad- en productwijzigingen binnen enkele minuten naar Google, in plaats van bij de volgende keer dat de feed wordt opgehaald.
Voor de installatie heb je een Merchant ID, een sleutel van een serviceaccount en één datasource per store view nodig.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de Google Shopping - Merchant API-extensie voor Magento 2. We hebben ons best gedaan om je te helpen met de installatie, configuratie en probleemoplossing. Als je het antwoord dat je zocht niet kunt vinden, kun je ons altijd een bericht sturen via dit formulier.
Installatieartikelen
Installatie met Composer (aanbevolen)Configuratie
Google Cloud Serviceaccount InstellenWijzigingslogboek 0.9.0 is uitgebracht op 3 March 2026
Onze plug-ins worden regelmatig bijgewerkt om compatibiliteit met de nieuwste Magento-versie te garanderen.
-
Features:
- Real-time product synchronization with Google Merchant Center via the Content API as an alternative to XML feed delivery.
- Dual sync paths: full product updates or inventory-only updates (price/stock) for higher throughput.
- Hash-based change detection to skip unnecessary API calls when product data has not changed.
- Queue-driven batch processing using Magento message queue (db connection) with configurable batch sizes (10–1000).
- Mview indexer subscribed to relevant catalog and inventory tables to automatically flag changed products.
- Cron-based publishers: product sync every 5 minutes, inventory sync every 2 minutes, daily sync check at 2 AM, and log cleanup at 3 AM.
- Google Service Account authentication with JWT-based OAuth2 token exchange without external libraries.
- Per-product error tracking with automatic retries after configurable hours.
- Admin product grid with sync status, last synced timestamp, error messages, and bulk actions (sync, flag, enable/disable, delete).
- Admin batch grid with batch progress, success/error counts, processing time, and retry capability.
- Real-time log stream viewer in admin.
- Selftest and version check following Magmodules module standards. CLI Commands:
- googleshopping:api:initialize — Populate sync table based on base module product filters.
- googleshopping:api:sync — Manually sync products (all or by ID).
- googleshopping:api:sync-check — Detect missing or removed products compared to Google.
- googleshopping:api:test-connection — Validate Google API credentials.
- googleshopping:api:status — Display sync statistics per store. Configuration:
- Per-store configuration for data source, feed label, and content language.
- Encrypted storage of service account JSON credentials.
- Auto-sync toggle, batch size configuration, retry interval (hours), and log retention (days).
- Test Connection button in admin configuration.
- All store-scoped fields support canRestore="1".
- Module is disabled by default after installation. Architecture:
- Built as add-on for magmodules/m2-googleshopping (>=2.12.0), reusing product data layer, attribute mapping, and filters.
- Added 4 custom database tables: mm_google_product, mm_google_product_log, mm_google_batch, mm_google_batch_item.
- Full ACL coverage for products, sync, batches, and logs.
- Comprehensive debug and error logging with database audit trail. Minimum requirements:
- Magento 2.3.x
- PHP 8.1
100% Ongecodeerde codekwaliteit gegarandeerd.
Kwaliteit
Goedgekeurd, compatibel en getest

Magento Cloud Ondersteuning
Deze extensie is volledig compatibel met Adobe Commerce Cloud (Magento Cloud). Het werkt met het read-only filesystem, de build- en deploy-pipeline en cloud-specifieke caching-lagen.
Er is geen extra configuratie of workaround nodig voor cloud-omgevingen. De extensie gaat op dezelfde manier om met static content deployment en configuratiebeheer als bij on-premise installaties.

Privé Composer Repo
Na aankoop krijg je toegang tot een prive Composer-repository met persoonlijke credentials. Installeer en update de extensie met een enkel composer-commando, net als elke andere dependency.
Je Composer-credentials zijn beschikbaar in je accountdashboard. Updates worden gepubliceerd zodra een nieuwe versie beschikbaar is, zodat je altijd toegang hebt tot de laatste versie.