Registers a datafeed configuration with your Merchant Center account. Try it now.
Request
HTTP request
POST https://www.googleapis.com/content/v2.1/merchantId/datafeeds
Parameters
| 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. |
Authorization
This request requires authorization with the following scope:
| 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 | |||
contentType |
string |
The type of data feed. For product inventory feeds, only feeds for local stores, not online stores, are supported.
Acceptable values are:
|
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 |
| 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:
|
writable |
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):
|
writable |
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 |
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.