Stay organized with collections
Save and categorize content based on your preferences.
The Local Feeds
Partnership program is a
way for retailers to participate in Local Inventory Ads and Free Local Listings
without having to create their own primary and local product inventory feeds.
Trusted data providers can provide sales or inventory data to Google on behalf
of retailers.
Prerequisites
To use the API methods in this section, establish your Local Inventory Ads (LIA)
or Free Local Listing (FLL) programs first. For more details, see Manage
omnichannel
settings.
Find available LFP providers
To retrieve all the available LFP providers in a country, use
lfpProviders.findLfpProviders.
packageshopping.merchant.samples.accounts.v1;// [START merchantapi_find_lfp_providers]importcom.google.api.gax.core.FixedCredentialsProvider;importcom.google.auth.oauth2.GoogleCredentials;importcom.google.shopping.merchant.accounts.v1.FindLfpProvidersRequest;importcom.google.shopping.merchant.accounts.v1.LfpProvider;importcom.google.shopping.merchant.accounts.v1.LfpProvidersServiceClient;importcom.google.shopping.merchant.accounts.v1.LfpProvidersServiceClient.FindLfpProvidersPagedResponse;importcom.google.shopping.merchant.accounts.v1.LfpProvidersServiceSettings;importcom.google.shopping.merchant.accounts.v1.OmnichannelSettingName;importshopping.merchant.samples.utils.Authenticator;importshopping.merchant.samples.utils.Config;/** This class demonstrates how to get the Lfp Providers for a given Merchant Center account */publicclassFindLfpProvidersSample{publicstaticvoidfindLfpProviders(Configconfig,StringregionCode)throwsException{// Obtains OAuth token based on the user's configuration.GoogleCredentialscredential=newAuthenticator().authenticate();// Creates service settings using the retrieved credentials.LfpProvidersServiceSettingslfpProvidersServiceSettings=LfpProvidersServiceSettings.newBuilder().setCredentialsProvider(FixedCredentialsProvider.create(credential)).build();// Gets the account ID from the config file.StringaccountId=config.getAccountId().toString();// Creates parent to identify the omnichannelSetting from which to list all Lfp Providers.Stringparent=OmnichannelSettingName.newBuilder().setAccount(accountId).setOmnichannelSetting(regionCode).build().toString();// Calls the API and catches and prints any network failures/errors.try(LfpProvidersServiceClientlfpProvidersServiceClient=LfpProvidersServiceClient.create(lfpProvidersServiceSettings)){FindLfpProvidersRequestrequest=FindLfpProvidersRequest.newBuilder().setParent(parent).build();System.out.println("Sending find LFP providers request:");FindLfpProvidersPagedResponseresponse=lfpProvidersServiceClient.findLfpProviders(request);intcount=0;// Iterates over all the entries in the response.for(LfpProviderlfpProvider:response.iterateAll()){System.out.println(lfpProvider);count++;}System.out.println(String.format("The following count of elements were returned: %d",count));}catch(Exceptione){System.out.println("An error has occurred: ");System.out.println(e);}}publicstaticvoidmain(String[]args)throwsException{Configconfig=Config.load();// The country you're targeting at.StringregionCode="{REGION_CODE}";findLfpProviders(config,regionCode);}}// [END merchantapi_find_lfp_providers]
Link an LFP provider
To build an LFP partnership, use lfpProviders.LinkLfpProvider:
{ACCOUNT_ID}: The unique identifier of your Merchant Center account
{LFP_PROVIDER}: The LFP provider ID returned in the previous step. For
example, it would be 12345 for LFP Provider 1.
{EXTERNAL_ACCOUNT_ID}: The external account ID by which the merchant is
known to the LFP provider.
This code sample shows how to link to an LFP provider:
packageshopping.merchant.samples.accounts.v1;// [START merchantapi_link_lfp_provider]importcom.google.api.gax.core.FixedCredentialsProvider;importcom.google.auth.oauth2.GoogleCredentials;importcom.google.shopping.merchant.accounts.v1.LfpProvidersServiceClient;importcom.google.shopping.merchant.accounts.v1.LfpProvidersServiceSettings;importcom.google.shopping.merchant.accounts.v1.LinkLfpProviderRequest;importshopping.merchant.samples.utils.Authenticator;/** This class demonstrates how to link the Lfp Providers for a given Merchant Center account */publicclassLinkLfpProviderSample{publicstaticvoidlinkLfpProvider(StringlfpProviderName,StringexternalAccountId)throwsException{// Obtains OAuth token based on the user's configuration.GoogleCredentialscredential=newAuthenticator().authenticate();// Creates service settings using the retrieved credentials.LfpProvidersServiceSettingslfpProvidersServiceSettings=LfpProvidersServiceSettings.newBuilder().setCredentialsProvider(FixedCredentialsProvider.create(credential)).build();// Calls the API and catches and prints any network failures/errors.try(LfpProvidersServiceClientlfpProvidersServiceClient=LfpProvidersServiceClient.create(lfpProvidersServiceSettings)){LinkLfpProviderRequestrequest=LinkLfpProviderRequest.newBuilder().setName(lfpProviderName).setExternalAccountId(externalAccountId).build();System.out.println("Sending link lfp provider request:");// Empty response returned on success.lfpProvidersServiceClient.linkLfpProvider(request);System.out.println(String.format("Successfully linked to LFP provider: %s",lfpProviderName));}catch(Exceptione){System.out.println("An error has occurred: ");System.out.println(e);}}publicstaticvoidmain(String[]args)throwsException{// The name of the lfp provider you want to link, returned from `lfpProviders.findLfpProviders`.// It's of the form// "accounts/{account_id}/omnichannelSettings/{omnichannel_settings}/lfpProviders/{lfp_provider}".StringlfpProviderName="{LFP_PROVIDER_NAME}";// External account ID by which this merchant is known to the LFP provider.StringexternalAccountId="{EXTERNAL_ACCOUNT_ID}";linkLfpProvider(lfpProviderName,externalAccountId);}}// [END merchantapi_link_lfp_provider]```YoucancheckyourLFPstatusbycalling`omnichannelSettings.get`andcheckingthe`LfpLink`field.TolearnmoreabouthowtouseLFP,see[LocalfeedspartnershipAPI](https://developers.google.com/merchant/api/guides/local-feeds-partnership/overview).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[],null,["# Manage Local Feeds Partnership (LFP) providers\n\nThe [Local Feeds\nPartnership](https://support.google.com/merchants/answer/7676652) program is a\nway for retailers to participate in Local Inventory Ads and Free Local Listings\nwithout having to create their own primary and local product inventory feeds.\nTrusted data providers can provide sales or inventory data to Google on behalf\nof retailers.\n\nPrerequisites\n-------------\n\nTo use the API methods in this section, establish your Local Inventory Ads (LIA)\nor Free Local Listing (FLL) programs first. For more details, see [Manage\nomnichannel\nsettings](/merchant/api/guides/accounts/manage-omnichannel-settings).\n\nFind available LFP providers\n----------------------------\n\nTo retrieve all the available LFP providers in a country, use\n`lfpProviders.findLfpProviders`. \n\n POST\n https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/omnichannelSettings/{REGION_CODE}/lfpProviders:find\n\nReplace the following:\n\n- `{ACCOUNT_ID}`: The unique identifier of your Merchant Center account\n- `{REGION_CODE}`: A Region code, from the list defined by the [Common Locale\n Data Repository (CLDR)](https://cldr.unicode.org/) project\n\nA sample successful response: \n\n 200 OK\n {\n \"lsfProviders\": [\n {\n \"name\": \"accounts/{ACCOUNT}/omnichannelSettings/{REGION_CODE}/lsfProviders/12345\",\n \"regionCode\": {REGION_CODE},\n \"displayName\": \"LFP Provider 1\"\n }, {\n \"name\": \"accounts/{ACCOUNT}/omnichannelSettings/{REGION_CODE}/lsfProviders/67890\",\n \"regionCode\": {REGION_CODE},\n \"displayName\": \"LFP Provider 6\"\n }\n ],\n \"nextPageToken\": 50\n }\n\nHere is a code sample: \n\n package shopping.merchant.samples.accounts.v1;\n\n // [START merchantapi_find_lfp_providers]\n import com.google.api.gax.core.FixedCredentialsProvider;\n import com.google.auth.oauth2.GoogleCredentials;\n import com.google.shopping.merchant.accounts.v1.FindLfpProvidersRequest;\n import com.google.shopping.merchant.accounts.v1.LfpProvider;\n import com.google.shopping.merchant.accounts.v1.LfpProvidersServiceClient;\n import com.google.shopping.merchant.accounts.v1.LfpProvidersServiceClient.FindLfpProvidersPagedResponse;\n import com.google.shopping.merchant.accounts.v1.LfpProvidersServiceSettings;\n import com.google.shopping.merchant.accounts.v1.OmnichannelSettingName;\n import shopping.merchant.samples.utils.Authenticator;\n import shopping.merchant.samples.utils.Config;\n\n /** This class demonstrates how to get the Lfp Providers for a given Merchant Center account */\n public class FindLfpProvidersSample {\n\n public static void findLfpProviders(Config config, String regionCode)\n throws Exception {\n\n // Obtains OAuth token based on the user's configuration.\n GoogleCredentials credential = new Authenticator().authenticate();\n\n // Creates service settings using the retrieved credentials.\n LfpProvidersServiceSettings lfpProvidersServiceSettings =\n LfpProvidersServiceSettings.newBuilder()\n .setCredentialsProvider(FixedCredentialsProvider.create(credential))\n .build();\n\n // Gets the account ID from the config file.\n String accountId = config.getAccountId().toString();\n // Creates parent to identify the omnichannelSetting from which to list all Lfp Providers.\n String parent =\n OmnichannelSettingName.newBuilder()\n .setAccount(accountId)\n .setOmnichannelSetting(regionCode)\n .build()\n .toString();\n\n // Calls the API and catches and prints any network failures/errors.\n try (LfpProvidersServiceClient lfpProvidersServiceClient =\n LfpProvidersServiceClient.create(lfpProvidersServiceSettings)) {\n FindLfpProvidersRequest request =\n FindLfpProvidersRequest.newBuilder().setParent(parent).build();\n\n System.out.println(\"Sending find LFP providers request:\");\n FindLfpProvidersPagedResponse response = lfpProvidersServiceClient.findLfpProviders(request);\n\n int count = 0;\n\n // Iterates over all the entries in the response.\n for (LfpProvider lfpProvider : response.iterateAll()) {\n System.out.println(lfpProvider);\n count++;\n }\n System.out.println(String.format(\"The following count of elements were returned: %d\", count));\n } catch (Exception e) {\n System.out.println(\"An error has occurred: \");\n System.out.println(e);\n }\n }\n\n public static void main(String[] args) throws Exception {\n Config config = Config.load();\n\n // The country you're targeting at.\n String regionCode = \"{REGION_CODE}\";\n\n findLfpProviders(config, regionCode);\n }\n }\n // [END merchantapi_find_lfp_providers]\n\nLink an LFP provider\n--------------------\n\nTo build an LFP partnership, use `lfpProviders.LinkLfpProvider`: \n\n POST\n https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/omnichannelSettings/{REGION_CODE}/lfpProviders/{LFP_PROVIDER}:linkLfpProvider\n {\n \"externalAccountId\": \"{EXTERNAL_ACCOUNT_ID}\",\n }\n\nReplace the following:\n\n- `{ACCOUNT_ID}`: The unique identifier of your Merchant Center account\n- `{LFP_PROVIDER}`: The LFP provider ID returned in the previous step. For example, it would be `12345` for LFP Provider 1.\n- `{EXTERNAL_ACCOUNT_ID}`: The external account ID by which the merchant is known to the LFP provider.\n\nThis code sample shows how to link to an LFP provider: \n\n package shopping.merchant.samples.accounts.v1;\n\n // [START merchantapi_link_lfp_provider]\n import com.google.api.gax.core.FixedCredentialsProvider;\n import com.google.auth.oauth2.GoogleCredentials;\n import com.google.shopping.merchant.accounts.v1.LfpProvidersServiceClient;\n import com.google.shopping.merchant.accounts.v1.LfpProvidersServiceSettings;\n import com.google.shopping.merchant.accounts.v1.LinkLfpProviderRequest;\n import shopping.merchant.samples.utils.Authenticator;\n\n /** This class demonstrates how to link the Lfp Providers for a given Merchant Center account */\n public class LinkLfpProviderSample {\n\n public static void linkLfpProvider(String lfpProviderName, String externalAccountId)\n throws Exception {\n\n // Obtains OAuth token based on the user's configuration.\n GoogleCredentials credential = new Authenticator().authenticate();\n\n // Creates service settings using the retrieved credentials.\n LfpProvidersServiceSettings lfpProvidersServiceSettings =\n LfpProvidersServiceSettings.newBuilder()\n .setCredentialsProvider(FixedCredentialsProvider.create(credential))\n .build();\n\n // Calls the API and catches and prints any network failures/errors.\n try (LfpProvidersServiceClient lfpProvidersServiceClient =\n LfpProvidersServiceClient.create(lfpProvidersServiceSettings)) {\n LinkLfpProviderRequest request =\n LinkLfpProviderRequest.newBuilder()\n .setName(lfpProviderName)\n .setExternalAccountId(externalAccountId)\n .build();\n\n System.out.println(\"Sending link lfp provider request:\");\n // Empty response returned on success.\n lfpProvidersServiceClient.linkLfpProvider(request);\n System.out.println(String.format(\"Successfully linked to LFP provider: %s\", lfpProviderName));\n } catch (Exception e) {\n System.out.println(\"An error has occurred: \");\n System.out.println(e);\n }\n }\n\n public static void main(String[] args) throws Exception {\n // The name of the lfp provider you want to link, returned from `lfpProviders.findLfpProviders`.\n // It's of the form\n // \"accounts/{account_id}/omnichannelSettings/{omnichannel_settings}/lfpProviders/{lfp_provider}\".\n String lfpProviderName = \"{LFP_PROVIDER_NAME}\";\n // External account ID by which this merchant is known to the LFP provider.\n String externalAccountId = \"{EXTERNAL_ACCOUNT_ID}\";\n\n linkLfpProvider(lfpProviderName, externalAccountId);\n }\n }\n // [END merchantapi_link_lfp_provider]\n\n ``` You can check your LFP status by calling `omnichannelSettings.get` and\n checking the `LfpLink` field.\n\n To learn more about how to use LFP, see [Local feeds partnership\n API](https://developers.google.com/merchant/api/guides/local-feeds-partnership/overview)."]]