Datafeeds: insert

Registers a datafeed configuration with your Merchant Center account. Try it now.


HTTP request



Parameter name Value Description
Path parameters
merchantId unsigned long The ID of the account that manages the datafeed. This account cannot be a multi-client account.


This request requires authorization with the following scope:


Request body

In the request body, supply a Datafeeds resource with the following properties:

Property name Value Description Notes
Required Properties
contentType string The type of data feed. For product inventory feeds, only feeds for local stores, not online stores, are supported.

Acceptable values are:
  • "local products"
  • "product inventory"
  • "products"
fileName string The filename of the feed. All feeds must have a unique file name. writable
name string A descriptive name of the data feed. writable
Optional Properties
attributeLanguage string The two-letter ISO 639-1 language in which the attributes are defined in the data feed. writable
fetchSchedule nested object Fetch schedule for the feed file. writable
fetchSchedule.dayOfMonth unsigned integer The day of the month the feed file should be fetched (1-31). writable
fetchSchedule.fetchUrl string The URL where the feed file can be fetched. Google Merchant Center will support automatic scheduled uploads using the HTTP, HTTPS, FTP, or SFTP protocols, so the value will need to be a valid link using one of those four protocols. writable
fetchSchedule.hour unsigned integer The hour of the day the feed file should be fetched (0-23). writable
fetchSchedule.password string An optional password for fetch_url. writable
fetchSchedule.paused boolean Whether the scheduled fetch is paused or not. writable
fetchSchedule.timeZone string Time zone used for schedule. UTC by default. E.g., "America/Los_Angeles". writable
fetchSchedule.username string An optional user name for fetch_url. writable
fetchSchedule.weekday string The day of the week the feed file should be fetched.

Acceptable values are:
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
format nested object Format of the feed file. writable
targets[] list The targets this feed should apply to (country, language, destinations). writable
targets[].country string The country where the items in the feed will be included in the search index, represented as a CLDR territory code. writable
targets[].excludedDestinations[] list The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). writable
targets[].includedDestinations[] list The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in excludedDestinations.

List of supported destinations (if available to the account):
  • DisplayAds
  • Shopping
  • ShoppingActions
  • SurfacesAcrossGoogle
targets[].language string The two-letter ISO 639-1 language of the items in the feed. Must be a valid language for targets[].country. writable


If successful, this method returns a Datafeeds resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.