| Connection |
|
|
| Merchant Id |
The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. |
|
| Product Id |
The REST ID of the product. |
|
| Offer Id |
Required. A unique identifier for the item. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. Only valid unicode characters are accepted. See the products feed specification for details. Note: Content API methods that operate on products take the REST ID of the product, not this identifier. |
|
| Content Language |
The two-letter ISO 639-1 language code for the item. |
|
| Target Country |
The CLDR territory code for the item's country of sale. |
|
| External Seller Id |
Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account. |
|
| Channel |
The item's channel (online or local). |
|
| Feed Label |
Feed label for the item. Either targetCountry or feedLabel is required. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). |
|
| Title |
Title of the item. |
|
| Description |
Description of the item. |
|
| Link |
URL directly linking to your item's page on your website. |
|
| Image Link |
URL of an image of the item. |
|
| Additional Image Links |
Additional URLs of images of the item. |
["000xxx"] |
| Lifestyle Image Links |
Additional URLs of lifestyle images of the item. Used to explicitly identify images that showcase your item in a real-world context. |
["000xxx"] |
| Expiration Date |
Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in productstatuses as googleExpirationDate and might be earlier if expirationDate is too far in the future. |
|
| Adult |
Should be set to true if the item is targeted towards adults. |
false |
| Kind |
Identifies what kind of resource this is. Value: the fixed string 'content#account'. |
|
| Brand |
Brand of the item. |
|
| Color |
Color of the item. |
|
| Google Product Category |
Google's category of the item (see Google product taxonomy). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API. |
|
| GTIN |
Global Trade Item Number (GTIN) of the item. |
|
| Item Group Id |
Shared identifier for all variants of the same product. |
|
| Material |
The material of which the item is made. |
|
| MPN |
Manufacturer Part Number (MPN) of the item. |
|
| Pattern |
The item's pattern (for example, polka dots). |
|
| Price |
Price of the item. |
|
| Sale Price |
Advertised sale price of the item. |
|
| Sale Price Effective Date |
Date range during which the item is on sale |
|
| Product Height |
The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). |
|
| Product Length |
The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). |
|
| Product Width |
The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). |
|
| Product Weight |
The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive). |
|
| Shipping |
Array of shipping rules. |
|
| Shipping Weight |
Weight of the item for shipping. |
|
| Sizes |
Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same itemGroupId value |
["000xxx"] |
| Taxes |
Array with tax information. |
|
| Custom Attributes |
A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (for example, { 'name': 'size type', 'value': 'regular' }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions). |
|
| Identifier Exists |
Date range during which the item is on sale |
false |
| Installment |
Number and amount of installments to pay for an item. |
|
| Multipack |
The number of identical products in a merchant-defined multipack. |
|
| Custom Label 0 |
Custom Label 0 for custom grouping of items in a Shopping campaign. |
|
| Custom Label 1 |
Custom Label 1 for custom grouping of items in a Shopping campaign. |
|
| Custom Label 2 |
Custom Label 2 for custom grouping of items in a Shopping campaign. |
|
| Custom Label 3 |
Custom Label 3 for custom grouping of items in a Shopping campaign. |
|
| Custom Label 4 |
Custom Label 4 for custom grouping of items in a Shopping campaign. |
|
| Is Bundle |
Whether the item is a merchant-defined bundle. A bundle is a custom grouping of different products sold by a merchant for a single price. |
false |
| Mobile Link |
URL for the mobile-optimized version of your item's landing page. |
|
| Availability Date |
The day a pre-ordered product becomes available for delivery, in ISO 8601 format. |
|
| Shipping Label |
The shipping label of the product, used to group product in account-level shipping rules. |
|
| Unit Pricing Measure |
The measure and dimension of an item. |
|
| Unit Pricing Base Measure |
The preference of the denominator of the unit price. |
|
| Shipping Length |
Length of the item for shipping. |
|
| Shipping Width |
Width of the item for shipping. |
|
| Shipping Height |
Height of the item for shipping. |
|
| Display Ads Id |
An identifier for an item for dynamic remarketing campaigns. |
|
| Display Ads Similar Ids |
Advertiser-specified recommendations. |
["000xxx"] |
| Display Ads Title |
Title of an item for dynamic remarketing campaigns. |
|
| Display Ads Link |
URL directly to your item's landing page for dynamic remarketing campaigns. |
|
| Display Ads Value |
Offer margin for dynamic remarketing campaigns. |
|
| Sell On Google Quantity |
The quantity of the product that is available for selling on Google. Supported only for online products. |
|
| Promotion Ids |
The unique ID of a promotion. |
["000xxx"] |
| Max Handling Time |
Maximal product handling time (in business days). |
|
| Min Handling Time |
Minimal product handling time (in business days). |
|
| Cost Of Goods Sold |
Cost of goods sold. Used for gross profit reporting. |
|
| Source |
The source of the offer, that is, how the offer was created. |
|
| Included Destinations |
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. |
["000xxx"] |
| Excluded Destinations |
The list of destinations to exclude for this target (corresponds to cleared check boxes in Merchant Center). Products that are excluded from all destinations for more than 7 days are automatically deleted. |
["000xxx"] |
| Ads Grouping |
Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. |
|
| Ads Labels |
Similar to adsGrouping, but only works on CPC. |
["000xxx"] |
| Ads Redirect |
Allows advertisers to override the item URL when the product is shown within the context of Product Ads. |
|
| Product Types |
Categories of the item (formatted as in product data specification). |
["000xxx"] |
| Age Group |
Target age group of the item. |
|
| Availability |
Availability status of the item. |
|
| Condition |
Condition or state of the item. |
|
| Gender |
Target gender of the item. |
|
| Size System |
System in which the size is specified. Recommended for apparel items. |
|
| Size Type |
The cut of the item. Recommended for apparel items. |
|
| Additional Size Type |
Additional cut of the item. Used together with sizeType to represent combined size types for apparel items. |
|
| Energy Efficiency Class |
The energy efficiency class as defined in EU directive 2010/30/EU. |
|
| Min Energy Efficiency Class |
The energy efficiency class as defined in EU directive 2010/30/EU. |
|
| Max Energy Efficiency Class |
The energy efficiency class as defined in EU directive 2010/30/EU. |
|
| Tax Category |
The energy efficiency class as defined in EU directive 2010/30/EU. |
|
| Transit Time Label |
The transit time label of the product, used to group product in account-level transit time tables. |
|
| Shopping Ads Excluded Countries |
products.list of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in MC feed settings. |
["000xxx"] |
| Pickup Method |
The pick up option for the item. |
|
| Pickup Sla |
Item store pickup timeline. |
|
| Link Template |
URL template for merchant hosted local storefront. |
|
| Mobile Link Template |
URL template for merchant hosted local storefront optimized for mobile devices. |
|
| Product Details |
Technical specification or additional product details. |
|
| Product Highlights |
Bullet points describing the most relevant highlights of a product. |
["000xxx"] |
| Subscription Cost |
Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract. |
|
| Canonical Link |
URL for the canonical version of your item's landing page. |
|
| Pause |
Publication of this item should be temporarily paused. |
|
| Update Mask |
The comma-separated list of product attributes to be updated. Example: 'title,salePrice'. Attributes specified in the update mask without a value specified in the body will be deleted from the product. You must specify the update mask to delete attributes. Only top-level product attributes can be updated. If not defined, product attributes with set values will be updated and other attributes will stay unchanged. Only defined if the method is update. |
|