Skip to main content

Google Shopping Connector

Google Shopping The Google Content API for Shopping can be used to manage and automate Google Merchant Center account management.

Connections

OAuth2

OAuth2 Connection

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

InputCommentsDefault
ScopesSpace delimited listing of scopes. https://developers.google.com/identity/protocols/oauth2/scopes#contenthttps://www.googleapis.com/auth/content
Client IDThe Google Content app's Client Identifier.
Client SecretThe Google Content app's Client Secret.

Triggers

PubSub Notification

PubSub Notification Trigger Settings

Actions

Batch Local Inventory

Updates local inventory for multiple products or regions in a single request.

InputCommentsDefault
Connection
Entries for Batch RequestEntries

Batch Product

Retrieves, inserts, and deletes multiple products in a single request.

InputCommentsDefault
Connection
Entries for Batch RequestEntries

Batch Regional Inventory

Updates regional inventory for multiple products or regions in a single request.

InputCommentsDefault
Connection
Entries for Batch RequestEntries

Cancel Order

Cancels all line items in an order, making a full refund.

InputCommentsDefault
Connection
Merchant IdThe 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.
Order IdThe ID of the order.
Operation IdThe ID of the operation. Unique across all operations for a given order.
ReasonThe reason for the cancellation.
Reason TextThe explanation of the reason.

Create Account

Creates a Merchant Center sub-account.

InputCommentsDefault
Connection
Merchant IdThe 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.
NameDisplay name for the account.
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
Website UrlThe merchant's website.
Adult ContentIndicates whether the merchant sells adult content.false
Seller IdClient-specific, locally-unique, internal ID for the child account.
UserUsers with access to the account. Every account (except for subaccounts) must have at least one admin user.
Youtube Channel LinksLinked YouTube channels that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
Google My Business LinkThe Business Profile which is linked or in the process of being linked with the Merchant Center account.
Business InformationThe business information of the account.
Automatic ImprovementsThe automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately.
Ads LinksLinked Ads accounts that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected either in the Ads interface or through the Google Ads API. To delete an active link, or to cancel a link request, remove it from the list.
Css IdID of CSS the account belongs to
Label IdsManually created label IDs that are assigned to the account by CSS.["000xxx"]
Account ManagementControls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'.
Automatic Label IdsAutomatically created label IDs that are assigned to the account by CSS Center.["000xxx"]
Conversion SettingsSettings for conversion tracking.

Create Order Return

Create return in your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Order IdThe ID of the order.
Operation IdThe ID of the operation. Unique across all operations for a given order.
Line ItemsThe list of line items to return.
Return Method TypeThe way of the package being returned.

Create Product

Uploads a product to your Merchant Center account. If an item with the same channel, contentLanguage, offerId, and targetCountry already exists, this method updates that entry.

InputCommentsDefault
Connection
Merchant IdThe 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.
Feed IdThe Content API Supplemental Feed ID. If present then product deletion applies to the data in a supplemental feed. If absent, entire product will be deleted.
Offer IdRequired. 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 LanguageThe two-letter ISO 639-1 language code for the item.
Target CountryThe CLDR territory code for the item's country of sale.
External Seller IdRequired for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
ChannelThe item's channel (online or local).
Feed LabelFeed 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 (-).
TitleTitle of the item.
DescriptionDescription of the item.
LinkURL directly linking to your item's page on your website.
Image LinkURL of an image of the item.
Additional Image LinksAdditional URLs of images of the item.["000xxx"]
Lifestyle Image LinksAdditional URLs of lifestyle images of the item. Used to explicitly identify images that showcase your item in a real-world context.["000xxx"]
Expiration DateDate 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.
AdultShould be set to true if the item is targeted towards adults.false
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
BrandBrand of the item.
ColorColor of the item.
Google Product CategoryGoogle'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.
GTINGlobal Trade Item Number (GTIN) of the item.
Item Group IdShared identifier for all variants of the same product.
MaterialThe material of which the item is made.
MPNManufacturer Part Number (MPN) of the item.
PatternThe item's pattern (for example, polka dots).
PricePrice of the item.
Sale PriceAdvertised sale price of the item.
Sale Price Effective DateDate range during which the item is on sale
Product HeightThe height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
Product LengthThe length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
Product WidthThe width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
Product WeightThe weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
ShippingArray of shipping rules.
Shipping WeightWeight of the item for shipping.
SizesSize 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"]
TaxesArray with tax information.
Custom AttributesA 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 ExistsDate range during which the item is on salefalse
InstallmentNumber and amount of installments to pay for an item.
MultipackThe number of identical products in a merchant-defined multipack.
Custom Label 0Custom Label 0 for custom grouping of items in a Shopping campaign.
Custom Label 1Custom Label 1 for custom grouping of items in a Shopping campaign.
Custom Label 2Custom Label 2 for custom grouping of items in a Shopping campaign.
Custom Label 3Custom Label 3 for custom grouping of items in a Shopping campaign.
Custom Label 4Custom Label 4 for custom grouping of items in a Shopping campaign.
Is BundleWhether 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 LinkURL for the mobile-optimized version of your item's landing page.
Availability DateThe day a pre-ordered product becomes available for delivery, in ISO 8601 format.
Shipping LabelThe shipping label of the product, used to group product in account-level shipping rules.
Unit Pricing MeasureThe measure and dimension of an item.
Unit Pricing Base MeasureThe preference of the denominator of the unit price.
Shipping LengthLength of the item for shipping.
Shipping WidthWidth of the item for shipping.
Shipping HeightHeight of the item for shipping.
Display Ads IdAn identifier for an item for dynamic remarketing campaigns.
Display Ads Similar IdsAdvertiser-specified recommendations.["000xxx"]
Display Ads TitleTitle of an item for dynamic remarketing campaigns.
Display Ads LinkURL directly to your item's landing page for dynamic remarketing campaigns.
Display Ads ValueOffer margin for dynamic remarketing campaigns.
Sell On Google QuantityThe quantity of the product that is available for selling on Google. Supported only for online products.
Promotion IdsThe unique ID of a promotion.["000xxx"]
Max Handling TimeMaximal product handling time (in business days).
Min Handling TimeMinimal product handling time (in business days).
Cost Of Goods SoldCost of goods sold. Used for gross profit reporting.
SourceThe source of the offer, that is, how the offer was created.
Included DestinationsThe 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 DestinationsThe 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 GroupingUsed to group items in an arbitrary way. Only for CPA%, discouraged otherwise.
Ads LabelsSimilar to adsGrouping, but only works on CPC.["000xxx"]
Ads RedirectAllows advertisers to override the item URL when the product is shown within the context of Product Ads.
Product TypesCategories of the item (formatted as in product data specification).["000xxx"]
Age GroupTarget age group of the item.
AvailabilityAvailability status of the item.
ConditionCondition or state of the item.
GenderTarget gender of the item.
Size SystemSystem in which the size is specified. Recommended for apparel items.
Size TypeThe cut of the item. Recommended for apparel items.
Additional Size TypeAdditional cut of the item. Used together with sizeType to represent combined size types for apparel items.
Energy Efficiency ClassThe energy efficiency class as defined in EU directive 2010/30/EU.
Min Energy Efficiency ClassThe energy efficiency class as defined in EU directive 2010/30/EU.
Max Energy Efficiency ClassThe energy efficiency class as defined in EU directive 2010/30/EU.
Tax CategoryThe energy efficiency class as defined in EU directive 2010/30/EU.
Transit Time LabelThe transit time label of the product, used to group product in account-level transit time tables.
Shopping Ads Excluded Countriesproducts.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 MethodThe pick up option for the item.
Pickup SlaItem store pickup timeline.
Link TemplateURL template for merchant hosted local storefront.
Mobile Link TemplateURL template for merchant hosted local storefront optimized for mobile devices.
Product DetailsTechnical specification or additional product details.
Product HighlightsBullet points describing the most relevant highlights of a product.["000xxx"]
Subscription CostNumber of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
Canonical LinkURL for the canonical version of your item's landing page.
PausePublication of this item should be temporarily paused.

Delete Account

Deletes a Merchant Center sub-account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Account IdThe ID of the account.

Delete Product

Deletes a product from your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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 IdThe REST ID of the product.
Feed IdThe Content API Supplemental Feed ID. If present then product deletion applies to the data in a supplemental feed. If absent, entire product will be deleted.

Get Account

Retrieves a Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Account IdThe ID of the account.
ViewControls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'.

Get Order

Retrieves an order from your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Order IdThe ID of the order.

Get Order Return

Retrieves an order return from your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Return IdMerchant order return ID generated by Google.

Get Product

Retrieves a product from your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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 IdThe REST ID of the product.

Get PubSub Notification Settings

Retrieves a Merchant Center account's pubsub notification settings.

InputCommentsDefault
Connection
Merchant IdThe 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.

List Accounts

Lists the sub-accounts in your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Max ResultsThe maximum number of accounts to return in the response, used for paging.
Page TokenThe token returned by the previous request.
ViewControls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'.
LabelIf view is set to 'css', only return accounts that are assigned label with given ID.
NameIf set, only the accounts with the given name (case sensitive) will be returned.

List Orders

Lists the orders in your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Max ResultsThe maximum number of accounts to return in the response, used for paging.
Page TokenThe token returned by the previous request.
StatusesObtains orders that match any of the specified statuses. Note that active is a shortcut for pendingShipment and partiallyShipped, and completed is a shortcut for shipped, partiallyDelivered, delivered, partiallyReturned, returned, and canceled.["000xxx"]
Placed Date StartObtains orders placed after this date (inclusively), in ISO 8601 format.
Placed Date EndObtains orders placed before this date (inclusively), in ISO 8601 format.
PauseOrder results by placement date in descending or ascending order.
AcknowledgedObtains orders that match the acknowledgement status. When set to true, obtains orders that have been acknowledged. When false, obtains orders that have not been acknowledged.false

List Orders Returns

Lists order returns in your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Max ResultsThe maximum number of accounts to return in the response, used for paging.
PauseOrder results by placement date in descending or ascending order.
Created Start DateObtains order returns created after this date (inclusively), in ISO 8601 format.
Created End DateObtains order returns created before this date (inclusively), in ISO 8601 format.
Page TokenThe token returned by the previous request.
Shipment TypesObtains order returns that match any shipment type provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment types.["000xxx"]
Shipment StatusObtains order returns that match any shipment status provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment statuses.["000xxx"]
Shipment StatesObtains order returns that match any shipment state provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment states.["000xxx"]
AcknowledgedObtains orders that match the acknowledgement status. When set to true, obtains orders that have been acknowledged. When false, obtains orders that have not been acknowledged.false
Google Order IdsObtains order returns with the specified order ids. If this parameter is provided, createdStartDate, createdEndDate, shipmentType, shipmentStatus, shipmentState and acknowledged parameters must be not set. Note: if googleOrderId and shipmentTrackingNumber parameters are provided, the obtained results will include all order returns that either match the specified order id or the specified tracking number.["000xxx"]
Shipping Tracking NumbersObtains order returns with the specified tracking numbers. If this parameter is provided, createdStartDate, createdEndDate, shipmentType, shipmentStatus, shipmentState and acknowledged parameters must be not set. Note: if googleOrderId and shipmentTrackingNumber parameters are provided, the obtained results will include all order returns that either match the specified order id or the specified tracking number.["000xxx"]

List Products

Lists the products in your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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.
Max ResultsThe maximum number of accounts to return in the response, used for paging.
Page TokenThe token returned by the previous request.

Process Order Return

Processes return in your Merchant Center account

InputCommentsDefault
Connection
Merchant IdThe 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.
Return IdMerchant order return ID generated by Google.
Operation IdThe ID of the operation. Unique across all operations for a given order.
Return ItemsThe list of items to return.
Full Charge Return Shipping CostOption to charge the customer return shipping cost.false
Refund Shipping FeeRefunds for original shipping fee.

Raw Request

Send raw HTTP request to Google Content Shopping

InputCommentsDefault
Connection
API VersionThe API version to use. This is used to construct the base URL for the request.v2.1
URLInput the path only (/{merchantId}/accounts), The base URL is already included (https://shoppingcontent.googleapis.com/content/{version}). For example, to connect to https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts, only /{merchantId}/accounts is entered in this field.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Debug RequestEnabling this flag will log out the current request.false
Retry Delay (ms)The delay in milliseconds between retries.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type.false
Max Retry CountThe maximum number of retries to attempt.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries.false

Update Account

Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.

InputCommentsDefault
Connection
Merchant IdThe 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.
Account IdThe ID of the account.
NameDisplay name for the account.
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
Website UrlThe merchant's website.
Adult ContentIndicates whether the merchant sells adult content.false
Seller IdClient-specific, locally-unique, internal ID for the child account.
UserUsers with access to the account. Every account (except for subaccounts) must have at least one admin user.
Youtube Channel LinksLinked YouTube channels that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
Google My Business LinkThe Business Profile which is linked or in the process of being linked with the Merchant Center account.
Business InformationThe business information of the account.
Automatic ImprovementsThe automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately.
Ads LinksLinked Ads accounts that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected either in the Ads interface or through the Google Ads API. To delete an active link, or to cancel a link request, remove it from the list.
Css IdID of CSS the account belongs to
Label IdsManually created label IDs that are assigned to the account by CSS.["000xxx"]
Account ManagementControls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'.
Automatic Label IdsAutomatically created label IDs that are assigned to the account by CSS Center.["000xxx"]
Conversion SettingsSettings for conversion tracking.

Update Product

Updates an existing product in your Merchant Center account. Only updates attributes provided in the request.

InputCommentsDefault
Connection
Merchant IdThe 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 IdThe REST ID of the product.
Offer IdRequired. 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 LanguageThe two-letter ISO 639-1 language code for the item.
Target CountryThe CLDR territory code for the item's country of sale.
External Seller IdRequired for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
ChannelThe item's channel (online or local).
Feed LabelFeed 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 (-).
TitleTitle of the item.
DescriptionDescription of the item.
LinkURL directly linking to your item's page on your website.
Image LinkURL of an image of the item.
Additional Image LinksAdditional URLs of images of the item.["000xxx"]
Lifestyle Image LinksAdditional URLs of lifestyle images of the item. Used to explicitly identify images that showcase your item in a real-world context.["000xxx"]
Expiration DateDate 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.
AdultShould be set to true if the item is targeted towards adults.false
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
BrandBrand of the item.
ColorColor of the item.
Google Product CategoryGoogle'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.
GTINGlobal Trade Item Number (GTIN) of the item.
Item Group IdShared identifier for all variants of the same product.
MaterialThe material of which the item is made.
MPNManufacturer Part Number (MPN) of the item.
PatternThe item's pattern (for example, polka dots).
PricePrice of the item.
Sale PriceAdvertised sale price of the item.
Sale Price Effective DateDate range during which the item is on sale
Product HeightThe height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
Product LengthThe length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
Product WidthThe width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
Product WeightThe weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
ShippingArray of shipping rules.
Shipping WeightWeight of the item for shipping.
SizesSize 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"]
TaxesArray with tax information.
Custom AttributesA 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 ExistsDate range during which the item is on salefalse
InstallmentNumber and amount of installments to pay for an item.
MultipackThe number of identical products in a merchant-defined multipack.
Custom Label 0Custom Label 0 for custom grouping of items in a Shopping campaign.
Custom Label 1Custom Label 1 for custom grouping of items in a Shopping campaign.
Custom Label 2Custom Label 2 for custom grouping of items in a Shopping campaign.
Custom Label 3Custom Label 3 for custom grouping of items in a Shopping campaign.
Custom Label 4Custom Label 4 for custom grouping of items in a Shopping campaign.
Is BundleWhether 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 LinkURL for the mobile-optimized version of your item's landing page.
Availability DateThe day a pre-ordered product becomes available for delivery, in ISO 8601 format.
Shipping LabelThe shipping label of the product, used to group product in account-level shipping rules.
Unit Pricing MeasureThe measure and dimension of an item.
Unit Pricing Base MeasureThe preference of the denominator of the unit price.
Shipping LengthLength of the item for shipping.
Shipping WidthWidth of the item for shipping.
Shipping HeightHeight of the item for shipping.
Display Ads IdAn identifier for an item for dynamic remarketing campaigns.
Display Ads Similar IdsAdvertiser-specified recommendations.["000xxx"]
Display Ads TitleTitle of an item for dynamic remarketing campaigns.
Display Ads LinkURL directly to your item's landing page for dynamic remarketing campaigns.
Display Ads ValueOffer margin for dynamic remarketing campaigns.
Sell On Google QuantityThe quantity of the product that is available for selling on Google. Supported only for online products.
Promotion IdsThe unique ID of a promotion.["000xxx"]
Max Handling TimeMaximal product handling time (in business days).
Min Handling TimeMinimal product handling time (in business days).
Cost Of Goods SoldCost of goods sold. Used for gross profit reporting.
SourceThe source of the offer, that is, how the offer was created.
Included DestinationsThe 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 DestinationsThe 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 GroupingUsed to group items in an arbitrary way. Only for CPA%, discouraged otherwise.
Ads LabelsSimilar to adsGrouping, but only works on CPC.["000xxx"]
Ads RedirectAllows advertisers to override the item URL when the product is shown within the context of Product Ads.
Product TypesCategories of the item (formatted as in product data specification).["000xxx"]
Age GroupTarget age group of the item.
AvailabilityAvailability status of the item.
ConditionCondition or state of the item.
GenderTarget gender of the item.
Size SystemSystem in which the size is specified. Recommended for apparel items.
Size TypeThe cut of the item. Recommended for apparel items.
Additional Size TypeAdditional cut of the item. Used together with sizeType to represent combined size types for apparel items.
Energy Efficiency ClassThe energy efficiency class as defined in EU directive 2010/30/EU.
Min Energy Efficiency ClassThe energy efficiency class as defined in EU directive 2010/30/EU.
Max Energy Efficiency ClassThe energy efficiency class as defined in EU directive 2010/30/EU.
Tax CategoryThe energy efficiency class as defined in EU directive 2010/30/EU.
Transit Time LabelThe transit time label of the product, used to group product in account-level transit time tables.
Shopping Ads Excluded Countriesproducts.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 MethodThe pick up option for the item.
Pickup SlaItem store pickup timeline.
Link TemplateURL template for merchant hosted local storefront.
Mobile Link TemplateURL template for merchant hosted local storefront optimized for mobile devices.
Product DetailsTechnical specification or additional product details.
Product HighlightsBullet points describing the most relevant highlights of a product.["000xxx"]
Subscription CostNumber of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
Canonical LinkURL for the canonical version of your item's landing page.
PausePublication of this item should be temporarily paused.
Update MaskThe 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.

Update Product Local Inventory

Updates the local inventory of a product in your Merchant Center account.

InputCommentsDefault
Connection
Merchant IdThe 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 IdThe REST ID of the product.
Store CodeStore code of this local inventory resource.
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
PricePrice of the item.
Sale PriceAdvertised sale price of the item.
Sale Price Effective DateDate range during which the item is on sale
AvailabilityAvailability status of the item.
QuantityQuantity of the product. Must be nonnegative.
Pickup MethodThe pick up option for the item.
Pickup SlaItem store pickup timeline.
Instore Product LocationIn-store product location.
Custom AttributesA 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).

Update Product Regional Inventory

Updates the regional inventory of a product in your Merchant Center account. If a regional inventory with the same region ID already exists, this method updates that entry.

InputCommentsDefault
Connection
Merchant IdThe 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 IdThe REST ID of the product.
Region IdThe ID uniquely identifying each region.
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
PricePrice of the item.
Sale PriceAdvertised sale price of the item.
Sale Price Effective DateDate range during which the item is on sale
AvailabilityAvailability status of the item.
Custom AttributesA 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).

Update PubSub Notification

Register a Merchant Center account for pubsub notifications. Note that cloud topic name shouldn't be provided as part of the request.

InputCommentsDefault
Connection
Merchant IdThe 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.
KindIdentifies what kind of resource this is. Value: the fixed string 'content#account'.
Cloud Topic NameCloud pub/sub topic to which notifications are sent (read-only).
Registered EventsList of event types.["000xxx"]