Datafeeds: insert

Requires authorization

Registers a datafeed configuration with your Merchant Center account. This method can only be called for non-multi-client accounts. Try it now.


HTTP request



Parameter name Value Description
Path parameters
merchantId unsigned long
Optional query parameters
dryRun boolean Flag to run the request in dry-run mode.


This request requires authorization with the following scope (read more about authentication and authorization).


Request body

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

Property name Value Description Notes
Required Properties
contentLanguage string The two-letter ISO 639-1 language of the items in the feed. Must be a valid language for targetCountry. writable
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"
  • "product inventory update"
  • "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
targetCountry string The country where the items in the feed will be included in the search index, represented as a CLDR territory code. 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
intendedDestinations[] list The list of intended destinations (corresponds to checked check boxes in Merchant Center). 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.

Send feedback about...

Content API for Shopping