Notification

In this help center, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure you're using the article for the Merchant Center version that applies to you. 

About the store feed specification

A custom icon for Merchant Center Classic Article Header.

This feed is only used to implement the local feeds partnership program.

The store feed maps your store codes to store addresses. If you don't provide this feed, you must match the store codes in your sales and inventory feeds to the store codes in the retailer's Google Business Profiles. This feed must be uploaded when you add new retailers or stores to the program.

Required field Description Type Example
Target customer ID
[target_customer_id]
The Merchant ID of the retailer Integer 112339909
Store code
[store_code]

The unique store identifier from point of sale (POS)/inventory data provider

Note: The store code attribute is case sensitive.

String "465278"
Store address [store_address] The postal address of the store corresponding to the store code String "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
Optional field Description Type Example
Store name
[store_name]

The merchant or store name

This field is recommended.

String "Store Mountain View"
Phone number
[phone_number]
The store phone number String Multiple formats are accepted, including international phone numbers.
Website URL
[website_url]
The website URL for the store or merchant String “http://acmestores.com/456/”

Google product category
[google_product_category]

The business type of the store

Choose the category that best represents your business using the list of common categories.

String “Bicycle Store”
Place ID
[place_id]

The Google Place ID of the store location

Use this field to provide a unique identifier to a store. It doesn’t need to match with a store address.

String “ChIJgUbEo8cfqokR5lP9_Wh_DaM”

Matching Status
[matching_status]

Output only. The matching status of POS store and Google Business Profile store.

Note that there is up to 48 hours propagation delay for changes in Merchant Center (e.g. creation of new account, accounts linking) and Google Business Profile (e.g. store address update) which may affect the matching status. In such cases, after a delay call pos.list to retrieve the updated matching status.

String

Possible values are:

  • "matched": The POS store is successfully matched with the Google Business Profile store.
  • "failed": The POS store is not matched with the Google Business Profile store. See matchingStatusHint for further details.

Matching Status Hint
[matching_status_hint]

Output only. The hint of why the matching has failed. This is only set when matchingStatus=failed. String

Possible values are:

  • "linked-store-not-found": There aren't any Google Business Profile stores available for matching.
  • Connect your Merchant Center account with the Google Business Profile account. Or add a new Google Business Profile store corresponding to the POS store.

  • "store-match-not-found": The provided POS store couldn't be matched to any of the connected Google Business Profile stores.
  • Merchant Center account is connected correctly and stores are available on Google Business Profile, but POS store location address does not match with Google Business Profile stores' addresses. Update POS store address or Google Business Profile store address to match correctly.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Main menu
1591555743998069487
true
Search Help Center
true
true
true
true
true
71525
false
false