Merchant API

AI-generated Key Takeaways

• The Merchant Center API (merchantapi.googleapis.com) allows programmatic management of Merchant Center accounts.

• It provides functionalities for managing accounts, products, inventories, promotions, and more.

• Developers can use this API to automate tasks such as creating accounts, updating product information, managing inventory, and handling promotions.

• This API offers various services like AccountsService, ProductsService, and InventoriesService to interact with different aspects of a Merchant Center account.

• merchantapi.googleapis.com enables building RPC client stubs for streamlined interaction with the Merchant Center platform.

Programmatically manage your Merchant Center Accounts.

Service: merchantapi.googleapis.com

The Service name merchantapi.googleapis.com is needed to create RPC client stubs.

google.shopping.merchant.accounts.v1.AccountIssueService

Methods
ListAccountIssues	Lists all account issues of a Merchant Center account.

google.shopping.merchant.accounts.v1.AccountRelationshipsService

Methods
GetAccountRelationship	Retrieve an account relationship.
ListAccountRelationships	List account relationships for the specified account.
UpdateAccountRelationship	Updates the account relationship.

google.shopping.merchant.accounts.v1.AccountServicesService

Methods
ApproveAccountService	Approve an account service proposal.
GetAccountService	Retrieve an account service.
ListAccountServices	List account services for the specified accounts.
ProposeAccountService	Propose an account service.
RejectAccountService	Reject an account service (both proposed and approve services can be rejected).

google.shopping.merchant.accounts.v1.AccountsService

Methods
CreateAndConfigureAccount	Creates a Merchant Center account with additional configuration.
DeleteAccount	Deletes the specified account regardless of its type: standalone, advanced account or sub-account.
GetAccount	Retrieves an account from your Merchant Center account.
ListAccounts	Note: For the accounts.list method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID.
ListSubAccounts	List all sub-accounts for a given advanced account.
UpdateAccount	Updates an account regardless of its type: standalone, advanced account or sub-account.

google.shopping.merchant.accounts.v1.AutofeedSettingsService

Methods
GetAutofeedSettings	Retrieves the autofeed settings of an account.
UpdateAutofeedSettings	Updates the autofeed settings of an account.

google.shopping.merchant.accounts.v1.AutomaticImprovementsService

Methods
GetAutomaticImprovements	Retrieves the automatic improvements of an account.
UpdateAutomaticImprovements	Updates the automatic improvements of an account.

google.shopping.merchant.accounts.v1.BusinessIdentityService

Methods
GetBusinessIdentity	Retrieves the business identity of an account.
UpdateBusinessIdentity	Updates the business identity of an account.

google.shopping.merchant.accounts.v1.BusinessInfoService

Methods
GetBusinessInfo	Retrieves the business info of an account.
UpdateBusinessInfo	Updates the business info of an account.

google.shopping.merchant.accounts.v1.CheckoutSettingsService

Methods
CreateCheckoutSettings	Creates CheckoutSettings for the given merchant.
DeleteCheckoutSettings	Deletes CheckoutSettings and unenrolls merchant from Checkout program.
GetCheckoutSettings	Gets CheckoutSettings for the given merchant.
UpdateCheckoutSettings	Updates CheckoutSettings for the given merchant.

google.shopping.merchant.accounts.v1.DeveloperRegistrationService

Methods
GetAccountForGcpRegistration	Retrieves the merchant account that the calling GCP is registered with.
GetDeveloperRegistration	Retrieves a developer registration for a merchant.
RegisterGcp	Registers the GCP used for the API call to the shopping account passed in the request.
UnregisterGcp	Unregister the calling GCP from the calling shopping account.

google.shopping.merchant.accounts.v1.EmailPreferencesService

Methods
GetEmailPreferences	Returns the email preferences for a Merchant Center account user.
UpdateEmailPreferences	Updates the email preferences for a Merchant Center account user.

google.shopping.merchant.accounts.v1.GbpAccountsService

Methods
LinkGbpAccount	Link the specified merchant to a GBP account for all countries.
ListGbpAccounts	List the GBP accounts for a given merchant.

google.shopping.merchant.accounts.v1.HomepageService

Methods
ClaimHomepage	Claims a store's homepage.
GetHomepage	Retrieves a store's homepage.
UnclaimHomepage	Unclaims a store's homepage.
UpdateHomepage	Updates a store's homepage.

google.shopping.merchant.accounts.v1.LfpProvidersService

Methods
FindLfpProviders	Find the LFP provider candidates in a given country.
LinkLfpProvider	Link the specified merchant to a LFP provider for the specified country.

google.shopping.merchant.accounts.v1.OmnichannelSettingsService

Methods
CreateOmnichannelSetting	Create the omnichannel settings for a given merchant.
GetOmnichannelSetting	Get the omnichannel settings for a given merchant.
ListOmnichannelSettings	List all the omnichannel settings for a given merchant.
RequestInventoryVerification	Requests inventory verification for a given merchant in a given country.
UpdateOmnichannelSetting	Update the omnichannel setting for a given merchant in a given country.

google.shopping.merchant.accounts.v1.OnlineReturnPolicyService

Methods
CreateOnlineReturnPolicy	Creates a new return policy for a given business.
DeleteOnlineReturnPolicy	Deletes an existing return policy.
GetOnlineReturnPolicy	Gets an existing return policy for a given business.
ListOnlineReturnPolicies	Lists all existing return policies for a given business.

google.shopping.merchant.accounts.v1.ProgramsService

Methods
DisableProgram	Disable participation in the specified program for the account.
EnableProgram	Enable participation in the specified program for the account.
GetProgram	Retrieves the specified program for the account.
ListPrograms	Retrieves all programs for the account.

google.shopping.merchant.accounts.v1.RegionsService

Methods
BatchCreateRegions	Creates one or more regions in your Merchant Center account.
BatchDeleteRegions	Deletes multiple regions by name from your Merchant Center account.
BatchUpdateRegions	Updates one or more regions in your Merchant Center account.
CreateRegion	Creates a region definition in your Merchant Center account.
DeleteRegion	Deletes a region definition from your Merchant Center account.
GetRegion	Retrieves a region defined in your Merchant Center account.
ListRegions	Lists the regions in your Merchant Center account.
UpdateRegion	Updates a region definition in your Merchant Center account.

google.shopping.merchant.accounts.v1.ShippingSettingsService

Methods
GetShippingSettings	Retrieve shipping setting information.
InsertShippingSettings	Replace the shipping setting of a business with the request shipping setting.

google.shopping.merchant.accounts.v1.TermsOfServiceAgreementStateService

Methods
GetTermsOfServiceAgreementState	Returns the state of a terms of service agreement.
RetrieveForApplicationTermsOfServiceAgreementState	Retrieves the state of the agreement for the application terms of service.

google.shopping.merchant.accounts.v1.TermsOfServiceService

Methods
AcceptTermsOfService	Accepts a TermsOfService.
GetTermsOfService	Retrieves the TermsOfService associated with the provided version.
RetrieveLatestTermsOfService	Retrieves the latest version of the TermsOfService for a given kind and region_code.

google.shopping.merchant.accounts.v1.UserService

Methods
CreateUser	Creates a Merchant Center account user.
DeleteUser	Deletes a Merchant Center account user.
GetUser	Retrieves a Merchant Center account user.
ListUsers	Lists all users of a Merchant Center account.
UpdateUser	Updates a Merchant Center account user.

google.shopping.merchant.accounts.v1beta.AccountIssueService

Methods
ListAccountIssues	Lists all account issues of a Merchant Center account.

google.shopping.merchant.accounts.v1beta.AccountRelationshipsService

Methods
GetAccountRelationship	Retrieve an account relationship.
ListAccountRelationships	List account relationships for the specified account.
UpdateAccountRelationship	Updates the account relationship.

google.shopping.merchant.accounts.v1beta.AccountServicesService

Methods
ApproveAccountService	Approve an account service proposal.
GetAccountService	Retrieve an account service.
ListAccountServices	List account services for the specified accounts.
ProposeAccountService	Propose an account service.
RejectAccountService	Reject an account service (both proposed and approve services can be rejected).

google.shopping.merchant.accounts.v1beta.AccountsService

Methods
CreateAndConfigureAccount	Creates a Merchant Center account with additional configuration.
DeleteAccount	Deletes the specified account regardless of its type: standalone, advanced account or sub-account.
GetAccount	Retrieves an account from your Merchant Center account.
ListAccounts	Note: For the accounts.list method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID.
ListSubAccounts	List all sub-accounts for a given advanced account.
UpdateAccount	Updates an account regardless of its type: standalone, advanced account or sub-account.

google.shopping.merchant.accounts.v1beta.AutofeedSettingsService

Methods
GetAutofeedSettings	Retrieves the autofeed settings of an account.
UpdateAutofeedSettings	Updates the autofeed settings of an account.

google.shopping.merchant.accounts.v1beta.AutomaticImprovementsService

Methods
GetAutomaticImprovements	Retrieves the automatic improvements of an account.
UpdateAutomaticImprovements	Updates the automatic improvements of an account.

google.shopping.merchant.accounts.v1beta.BusinessIdentityService

Methods
GetBusinessIdentity	Retrieves the business identity of an account.
UpdateBusinessIdentity	Updates the business identity of an account.

google.shopping.merchant.accounts.v1beta.BusinessInfoService

Methods
GetBusinessInfo	Retrieves the business info of an account.
UpdateBusinessInfo	Updates the business info of an account.

google.shopping.merchant.accounts.v1beta.CheckoutSettingsService

Methods
CreateCheckoutSettings	Creates CheckoutSettings for the given merchant.
DeleteCheckoutSettings	Deletes CheckoutSettings and unenrolls merchant from Checkout program.
GetCheckoutSettings	Gets CheckoutSettings for the given merchant.
UpdateCheckoutSettings	Updates CheckoutSettings for the given merchant.

google.shopping.merchant.accounts.v1beta.DeveloperRegistrationService

Methods
GetAccountForGcpRegistration	Retrieves the merchant account that the calling GCP is registered with.
GetDeveloperRegistration	Retrieves a developer registration for a merchant.
RegisterGcp	Registers the GCP used for the API call to the shopping account passed in the request.
UnregisterGcp	Unregister the calling GCP from the calling shopping account.

google.shopping.merchant.accounts.v1beta.EmailPreferencesService

Methods
GetEmailPreferences	Returns the email preferences for a Merchant Center account user.
UpdateEmailPreferences	Updates the email preferences for a Merchant Center account user.

google.shopping.merchant.accounts.v1beta.GbpAccountsService

Methods
LinkGbpAccount	Link the specified merchant to a GBP account for all countries.
ListGbpAccounts	List the GBP accounts for a given merchant.

google.shopping.merchant.accounts.v1beta.HomepageService

Methods
ClaimHomepage	Claims a store's homepage.
GetHomepage	Retrieves a store's homepage.
UnclaimHomepage	Unclaims a store's homepage.
UpdateHomepage	Updates a store's homepage.

google.shopping.merchant.accounts.v1beta.LfpProvidersService

Methods
FindLfpProviders	Find the LFP provider candidates in a given country.
LinkLfpProvider	Link the specified merchant to a LFP provider for the specified country.

google.shopping.merchant.accounts.v1beta.OmnichannelSettingsService

Methods
CreateOmnichannelSetting	Create the omnichannel settings for a given merchant.
GetOmnichannelSetting	Get the omnichannel settings for a given merchant.
ListOmnichannelSettings	List all the omnichannel settings for a given merchant.
RequestInventoryVerification	Requests inventory verification for a given merchant in a given country.
UpdateOmnichannelSetting	Update the omnichannel setting for a given merchant in a given country.

google.shopping.merchant.accounts.v1beta.OnlineReturnPolicyService

Methods
CreateOnlineReturnPolicy	Creates a new return policy for a given business.
DeleteOnlineReturnPolicy	Deletes an existing return policy.
GetOnlineReturnPolicy	Gets an existing return policy for a given business.
ListOnlineReturnPolicies	Lists all existing return policies for a given business.
UpdateOnlineReturnPolicy	Updates an existing return policy for a given business.

google.shopping.merchant.accounts.v1beta.ProgramsService

Methods
DisableProgram	Disable participation in the specified program for the account.
EnableProgram	Enable participation in the specified program for the account.
GetProgram	Retrieves the specified program for the account.
ListPrograms	Retrieves all programs for the account.

google.shopping.merchant.accounts.v1beta.RegionsService

Methods
CreateRegion	Creates a region definition in your Merchant Center account.
DeleteRegion	Deletes a region definition from your Merchant Center account.
GetRegion	Retrieves a region defined in your Merchant Center account.
ListRegions	Lists the regions in your Merchant Center account.
UpdateRegion	Updates a region definition in your Merchant Center account.

google.shopping.merchant.accounts.v1beta.ShippingSettingsService

Methods
GetShippingSettings	Retrieve shipping setting information.
InsertShippingSettings	Replace the shipping setting of a business with the request shipping setting.

google.shopping.merchant.accounts.v1beta.TermsOfServiceAgreementStateService

Methods
GetTermsOfServiceAgreementState	Returns the state of a terms of service agreement.
RetrieveForApplicationTermsOfServiceAgreementState	Retrieves the state of the agreement for the application terms of service.

google.shopping.merchant.accounts.v1beta.TermsOfServiceService

Methods
AcceptTermsOfService	Accepts a TermsOfService.
GetTermsOfService	Retrieves the TermsOfService associated with the provided version.
RetrieveLatestTermsOfService	Retrieves the latest version of the TermsOfService for a given kind and region_code.

google.shopping.merchant.accounts.v1beta.UserService

Methods
CreateUser	Creates a Merchant Center account user.
DeleteUser	Deletes a Merchant Center account user.
GetUser	Retrieves a Merchant Center account user.
ListUsers	Lists all users of a Merchant Center account.
UpdateUser	Updates a Merchant Center account user.

google.shopping.merchant.conversions.v1.ConversionSourcesService

Methods
CreateConversionSource	Creates a new conversion source.
DeleteConversionSource	Archives an existing conversion source.
GetConversionSource	Fetches a conversion source.
ListConversionSources	Retrieves the list of conversion sources the caller has access to.
UndeleteConversionSource	Re-enables an archived conversion source.
UpdateConversionSource	Updates information of an existing conversion source.

google.shopping.merchant.conversions.v1beta.ConversionSourcesService

Methods
CreateConversionSource	Creates a new conversion source.
DeleteConversionSource	Archives an existing conversion source.
GetConversionSource	Fetches a conversion source.
ListConversionSources	Retrieves the list of conversion sources the caller has access to.
UndeleteConversionSource	Re-enables an archived conversion source.
UpdateConversionSource	Updates information of an existing conversion source.

google.shopping.merchant.datasources.v1.DataSourcesService

Methods
CreateDataSource	Creates the new data source configuration for the given account.
DeleteDataSource	Deletes a data source from your Merchant Center account.
FetchDataSource	Performs the data fetch immediately (even outside fetch schedule) on a data source from your Merchant Center Account.
GetDataSource	Retrieves the data source configuration for the given account.
ListDataSources	Lists the configurations for data sources for the given account.
UpdateDataSource	Updates the existing data source configuration.

google.shopping.merchant.datasources.v1.FileUploadsService

Methods
GetFileUpload	Gets the latest data source file upload.

google.shopping.merchant.datasources.v1beta.DataSourcesService

Methods
CreateDataSource	Creates the new data source configuration for the given account.
DeleteDataSource	Deletes a data source from your Merchant Center account.
FetchDataSource	Performs the data fetch immediately (even outside fetch schedule) on a data source from your Merchant Center Account.
GetDataSource	Retrieves the data source configuration for the given account.
ListDataSources	Lists the configurations for data sources for the given account.
UpdateDataSource	Updates the existing data source configuration.

google.shopping.merchant.datasources.v1beta.FileUploadsService

Methods
GetFileUpload	Gets the latest data source file upload.

google.shopping.merchant.inventories.v1.LocalInventoryService

Methods
DeleteLocalInventory	Deletes the specified LocalInventory from the given product in your merchant account.
InsertLocalInventory	Inserts a LocalInventory resource to a product in your merchant account.
ListLocalInventories	Lists the LocalInventory resources for the given product in your merchant account.

google.shopping.merchant.inventories.v1.RegionalInventoryService

Methods
DeleteRegionalInventory	Deletes the specified RegionalInventory resource from the given product in your merchant account.
InsertRegionalInventory	Inserts a RegionalInventory to a given product in your merchant account.
ListRegionalInventories	Lists the RegionalInventory resources for the given product in your merchant account.

google.shopping.merchant.inventories.v1beta.LocalInventoryService

Methods
DeleteLocalInventory	Deletes the specified LocalInventory from the given product in your merchant account.
InsertLocalInventory	Inserts a LocalInventory resource to a product in your merchant account.
ListLocalInventories	Lists the LocalInventory resources for the given product in your merchant account.

google.shopping.merchant.inventories.v1beta.RegionalInventoryService

Methods
DeleteRegionalInventory	Deletes the specified RegionalInventory resource from the given product in your merchant account.
InsertRegionalInventory	Inserts a RegionalInventory to a given product in your merchant account.
ListRegionalInventories	Lists the RegionalInventory resources for the given product in your merchant account.

google.shopping.merchant.issueresolution.v1.AggregateProductStatusesService

Methods
ListAggregateProductStatuses	Lists the AggregateProductStatuses resources for your merchant account.

google.shopping.merchant.issueresolution.v1.IssueResolutionService

Methods
RenderAccountIssues	Provide a list of business's account issues with an issue resolution content and available actions.
RenderProductIssues	Provide a list of issues for business's product with an issue resolution content and available actions.
TriggerAction	Start an action.

google.shopping.merchant.issueresolution.v1beta.AggregateProductStatusesService

Methods
ListAggregateProductStatuses	Lists the AggregateProductStatuses resources for your merchant account.

google.shopping.merchant.issueresolution.v1beta.IssueResolutionService

Methods
RenderAccountIssues	Provide a list of business's account issues with an issue resolution content and available actions.
RenderProductIssues	Provide a list of issues for business's product with an issue resolution content and available actions.
TriggerAction	Start an action.

google.shopping.merchant.lfp.v1.LfpInventoryService

Methods
InsertLfpInventory	Inserts a LfpInventory resource for the given target merchant account.

google.shopping.merchant.lfp.v1.LfpMerchantStateService

Methods
GetLfpMerchantState	Gets the LFP state of a merchant

google.shopping.merchant.lfp.v1.LfpSaleService

Methods
InsertLfpSale	Inserts a LfpSale for the given merchant.

google.shopping.merchant.lfp.v1.LfpStoreService

Methods
DeleteLfpStore	Deletes a store for a target merchant.
GetLfpStore	Retrieves information about a store.
InsertLfpStore	Inserts a store for the target merchant.
ListLfpStores	Lists the stores of the target merchant, specified by the filter in ListLfpStoresRequest.

google.shopping.merchant.lfp.v1beta.LfpInventoryService

Methods
InsertLfpInventory	Inserts a LfpInventory resource for the given target merchant account.

google.shopping.merchant.lfp.v1beta.LfpMerchantStateService

Methods
GetLfpMerchantState	Gets the LFP state of a merchant

google.shopping.merchant.lfp.v1beta.LfpSaleService

Methods
InsertLfpSale	Inserts a LfpSale for the given merchant.

google.shopping.merchant.lfp.v1beta.LfpStoreService

Methods
DeleteLfpStore	Deletes a store for a target merchant.
GetLfpStore	Retrieves information about a store.
InsertLfpStore	Inserts a store for the target merchant.
ListLfpStores	Lists the stores of the target merchant, specified by the filter in ListLfpStoresRequest.

google.shopping.merchant.mcp.devdocs.DevdocsMcpService

Methods
ForwardMcpMessage

google.shopping.merchant.notifications.v1.NotificationsApiService

Methods
CreateNotificationSubscription	Creates a notification subscription for a business.
DeleteNotificationSubscription	Deletes a notification subscription for a merchant.
GetNotificationSubscription	Gets notification subscriptions for an account.
ListNotificationSubscriptions	Gets all the notification subscriptions for a merchant.
UpdateNotificationSubscription	Updates an existing notification subscription for a merchant.

google.shopping.merchant.notifications.v1beta.NotificationsApiService

Methods
CreateNotificationSubscription	Creates a notification subscription for a business.
DeleteNotificationSubscription	Deletes a notification subscription for a merchant.
GetNotificationSubscription	Gets notification subscriptions for an account.
ListNotificationSubscriptions	Gets all the notification subscriptions for a merchant.
UpdateNotificationSubscription	Updates an existing notification subscription for a merchant.

google.shopping.merchant.ordertracking.v1.OrderTrackingSignalsService

Methods
CreateOrderTrackingSignal	Creates new order tracking signal.

google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignalsService

Methods
CreateOrderTrackingSignal	Creates new order tracking signal.

google.shopping.merchant.products.v1.ProductInputsService

Methods
DeleteProductInput	Deletes a product input from your Merchant Center account.
InsertProductInput	Uploads a product input to your Merchant Center account.
UpdateProductInput	Updates the existing product input in your Merchant Center account.

google.shopping.merchant.products.v1.ProductsService

Methods
GetProduct	Retrieves the processed product from your Merchant Center account.
ListProducts	Lists the processed products in your Merchant Center account.

google.shopping.merchant.products.v1beta.ProductInputsService

Methods
DeleteProductInput	Deletes a product input from your Merchant Center account.
InsertProductInput	Uploads a product input to your Merchant Center account.
UpdateProductInput	Updates the existing product input in your Merchant Center account.

google.shopping.merchant.products.v1beta.ProductsService

Methods
GetProduct	Retrieves the processed product from your Merchant Center account.
ListProducts	Lists the processed products in your Merchant Center account.

google.shopping.merchant.productstudio.v1alpha.ImageService

Methods
GenerateProductImageBackground	GenerateProductImageBackground generates a new image where the background of the original image is replaced by an AI generated scene based on provided product information and a text prompt.
RemoveProductImageBackground	RemoveProductImageBackground generates a new image where the background of the original image is removed.
UpscaleProductImage	UpscaleProductImage generates a new image where the resolution of the original image is enhanced.

google.shopping.merchant.productstudio.v1alpha.TextSuggestionsService

Methods
GenerateProductTextSuggestions	GenerateProductTextSuggestions generates a set of candidate text completions (e.g., product titles, descriptions) based on provided product information.

google.shopping.merchant.productstudio.v1alpha.VideosService

Methods

google.shopping.merchant.promotions.v1.PromotionsService

Methods
GetPromotion	Retrieves the promotion from your Merchant Center account.
InsertPromotion	Inserts a promotion for your Merchant Center account.
ListPromotions	Lists the promotions in your Merchant Center account.

google.shopping.merchant.promotions.v1beta.PromotionsService

Methods
GetPromotion	Retrieves the promotion from your Merchant Center account.
InsertPromotion	Inserts a promotion for your Merchant Center account.
ListPromotions	Lists the promotions in your Merchant Center account.

google.shopping.merchant.quota.v1.QuotaService

Methods
ListQuotaGroups	Lists the daily call quota and usage per group for your Merchant Center account.

google.shopping.merchant.quota.v1beta.QuotaService

Methods
ListQuotaGroups	Lists the daily call quota and usage per group for your Merchant Center account.

google.shopping.merchant.reports.v1.ReportService

Methods
Search	Retrieves a report defined by a search query.

google.shopping.merchant.reports.v1alpha.ReportService

Methods
Search	Retrieves a report defined by a search query.

google.shopping.merchant.reports.v1beta.ReportService

Methods
Search	Retrieves a report defined by a search query.

google.shopping.merchant.reviews.v1alpha.MerchantReviewsService

Methods
DeleteMerchantReview	Deletes merchant review.
GetMerchantReview	Gets a merchant review.
InsertMerchantReview	Inserts a review for your Merchant Center account.
ListMerchantReviews	Lists merchant reviews.

google.shopping.merchant.reviews.v1alpha.ProductReviewsService

Methods
DeleteProductReview	Deletes a product review.
GetProductReview	Gets a product review.
InsertProductReview	Inserts a product review.
ListProductReviews	Lists product reviews.

google.shopping.merchant.reviews.v1beta.MerchantReviewsService

Methods
DeleteMerchantReview	Deletes merchant review.
GetMerchantReview	Gets a merchant review.
InsertMerchantReview	Inserts a review for your Merchant Center account.
ListMerchantReviews	Lists merchant reviews.

google.shopping.merchant.reviews.v1beta.ProductReviewsService

Methods
DeleteProductReview	Deletes a product review.
GetProductReview	Gets a product review.
InsertProductReview	Inserts a product review.
ListProductReviews	Lists product reviews.