@86d-app/google-shopping

The Modern Foundation for Commerce

X · LinkedIn

This project is under active development and is not ready for production use. Please proceed with caution. Use at your own risk.

Documentation: 86d.app/docs/modules/google-shopping

Google Shopping Module

Integrates your 86d store with Google Merchant Center for product feed management, feed submission tracking, order handling, and feed diagnostics. Supports Google Shopping product data specifications including GTIN, MPN, brand, condition, and availability.

Installation

npm install @86d-app/google-shopping

Usage

import googleShopping from "@86d-app/google-shopping";

const module = googleShopping({
  merchantId: "your-merchant-id",
  apiKey: "your-api-key",
  targetCountry: "US",
  contentLanguage: "en",
});

Configuration

Option	Type	Default	Description
merchantId	string	-	Google Merchant Center ID
apiKey	string	-	Google API key
targetCountry	string	"US"	Target country code
contentLanguage	string	"en"	Content language

Store Endpoints

Method	Path	Description
POST	/google-shopping/webhooks	Receive Google Shopping webhook events

Admin Endpoints

Method	Path	Description
GET	/admin/google-shopping/feed-items	List all feed items
POST	/admin/google-shopping/feed-items/create	Create a feed item
GET	/admin/google-shopping/feed-items/:id	Get a specific feed item
POST	/admin/google-shopping/feed-items/:id/update	Update a feed item
POST	/admin/google-shopping/feed-items/:id/delete	Delete a feed item
POST	/admin/google-shopping/submit	Submit product feed
GET	/admin/google-shopping/submissions	List feed submissions
GET	/admin/google-shopping/orders	List orders
POST	/admin/google-shopping/orders/:id/status	Update order status
GET	/admin/google-shopping/stats	Get channel statistics
GET	/admin/google-shopping/diagnostics	Get feed diagnostics

Controller API

interface GoogleShoppingController extends ModuleController {
  createFeedItem(params: { localProductId: string; title: string; price: number; link: string; imageLink: string; ... }): Promise<ProductFeedItem>;
  updateFeedItem(id: string, params: Partial<ProductFeedItem>): Promise<ProductFeedItem | null>;
  deleteFeedItem(id: string): Promise<boolean>;
  getFeedItem(id: string): Promise<ProductFeedItem | null>;
  getFeedItemByProduct(localProductId: string): Promise<ProductFeedItem | null>;
  listFeedItems(params?: { status?; take?; skip? }): Promise<ProductFeedItem[]>;
  submitFeed(): Promise<FeedSubmission>;
  getLastSubmission(): Promise<FeedSubmission | null>;
  listSubmissions(params?: { take?; skip? }): Promise<FeedSubmission[]>;
  receiveOrder(params: { googleOrderId: string; items: unknown[]; ... }): Promise<ChannelOrder>;
  getOrder(id: string): Promise<ChannelOrder | null>;
  updateOrderStatus(id: string, status: OrderStatus, trackingNumber?, carrier?): Promise<ChannelOrder | null>;
  listOrders(params?: { status?; take?; skip? }): Promise<ChannelOrder[]>;
  getChannelStats(): Promise<ChannelStats>;
  getDiagnostics(): Promise<FeedDiagnostics>;
}

Types

• ProductFeedItem -- Product feed entry with Google-specific fields (googleCategory, condition, availability, GTIN, MPN, brand) and disapproval tracking
• ChannelOrder -- Order from Google Shopping with cost breakdown (subtotal, shippingCost, tax, total) and carrier tracking
• FeedSubmission -- Feed submission record tracking approved/disapproved product counts
• FeedDiagnostics -- Aggregated status breakdown and disapproval reason frequency

Notes

• Feed item statuses: active, pending, disapproved, expiring
• Feed item conditions: new, refurbished, used
• Availability values: in-stock, out-of-stock, preorder
• Order statuses include returned in addition to the standard set
• Admin page appears under the Sales group with the Search icon