Datafeeds: insert

Requires authorization

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

Request

HTTP request

POST https://www.googleapis.com/content/v2/merchantId/datafeeds

Parameters

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

Authorization

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

Scope
https://www.googleapis.com/auth/content

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"
writable
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.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"
writable
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

Response

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