Google Shopping Connector
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.
Input | Comments | Default |
---|---|---|
Scopes | Space delimited listing of scopes. https://developers.google.com/identity/protocols/oauth2/scopes#content | https://www.googleapis.com/auth/content |
Client ID | The Google Content app's Client Identifier. | |
Client Secret | The 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.
Input | Comments | Default |
---|---|---|
Connection | ||
Entries for Batch Request | Entries |
Batch Product
Retrieves, inserts, and deletes multiple products in a single request.
Input | Comments | Default |
---|---|---|
Connection | ||
Entries for Batch Request | Entries |
Batch Regional Inventory
Updates regional inventory for multiple products or regions in a single request.
Input | Comments | Default |
---|---|---|
Connection | ||
Entries for Batch Request | Entries |
Cancel Order
Cancels all line items in an order, making a full refund.
Input | Comments | Default |
---|---|---|
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. | |
Order Id | The ID of the order. | |
Operation Id | The ID of the operation. Unique across all operations for a given order. | |
Reason | The reason for the cancellation. | |
Reason Text | The explanation of the reason. |
Create Account
Creates a Merchant Center sub-account.
Input | Comments | Default |
---|---|---|
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. | |
Name | Display name for the account. | |
Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
Website Url | The merchant's website. | |
Adult Content | Indicates whether the merchant sells adult content. | false |
Seller Id | Client-specific, locally-unique, internal ID for the child account. | |
User | Users with access to the account. Every account (except for subaccounts) must have at least one admin user. | |
Youtube Channel Links | Linked 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 Link | The Business Profile which is linked or in the process of being linked with the Merchant Center account. | |
Business Information | The business information of the account. | |
Automatic Improvements | The automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately. | |
Ads Links | Linked 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 Id | ID of CSS the account belongs to | |
Label Ids | Manually created label IDs that are assigned to the account by CSS. | ["000xxx"] |
Account Management | Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'. | |
Automatic Label Ids | Automatically created label IDs that are assigned to the account by CSS Center. | ["000xxx"] |
Conversion Settings | Settings for conversion tracking. |
Create Order Return
Create return in your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. | |
Order Id | The ID of the order. | |
Operation Id | The ID of the operation. Unique across all operations for a given order. | |
Line Items | The list of line items to return. | |
Return Method Type | The 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.
Input | Comments | Default |
---|---|---|
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. | |
Feed Id | The 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 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. |
Delete Account
Deletes a Merchant Center sub-account.
Input | Comments | Default |
---|---|---|
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. | |
Account Id | The ID of the account. |
Delete Product
Deletes a product from your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. | |
Feed Id | The 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.
Input | Comments | Default |
---|---|---|
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. | |
Account Id | The ID of the account. | |
View | Controls 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.
Input | Comments | Default |
---|---|---|
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. | |
Order Id | The ID of the order. |
Get Order Return
Retrieves an order return from your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. | |
Return Id | Merchant order return ID generated by Google. |
Get Product
Retrieves a product from your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. |
Get PubSub Notification Settings
Retrieves a Merchant Center account's pubsub notification settings.
Input | Comments | Default |
---|---|---|
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. |
List Accounts
Lists the sub-accounts in your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. | |
Max Results | The maximum number of accounts to return in the response, used for paging. | |
Page Token | The token returned by the previous request. | |
View | Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'. | |
Label | If view is set to 'css', only return accounts that are assigned label with given ID. | |
Name | If set, only the accounts with the given name (case sensitive) will be returned. |
List Orders
Lists the orders in your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. | |
Max Results | The maximum number of accounts to return in the response, used for paging. | |
Page Token | The token returned by the previous request. | |
Statuses | Obtains 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 Start | Obtains orders placed after this date (inclusively), in ISO 8601 format. | |
Placed Date End | Obtains orders placed before this date (inclusively), in ISO 8601 format. | |
Pause | Order results by placement date in descending or ascending order. | |
Acknowledged | Obtains 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.
Input | Comments | Default |
---|---|---|
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. | |
Max Results | The maximum number of accounts to return in the response, used for paging. | |
Pause | Order results by placement date in descending or ascending order. | |
Created Start Date | Obtains order returns created after this date (inclusively), in ISO 8601 format. | |
Created End Date | Obtains order returns created before this date (inclusively), in ISO 8601 format. | |
Page Token | The token returned by the previous request. | |
Shipment Types | Obtains 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 Status | Obtains 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 States | Obtains 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"] |
Acknowledged | Obtains 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 Ids | Obtains 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 Numbers | Obtains 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.
Input | Comments | Default |
---|---|---|
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. | |
Max Results | The maximum number of accounts to return in the response, used for paging. | |
Page Token | The token returned by the previous request. |
Process Order Return
Processes return in your Merchant Center account
Input | Comments | Default |
---|---|---|
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. | |
Return Id | Merchant order return ID generated by Google. | |
Operation Id | The ID of the operation. Unique across all operations for a given order. | |
Return Items | The list of items to return. | |
Full Charge Return Shipping Cost | Option to charge the customer return shipping cost. | false |
Refund Shipping Fee | Refunds for original shipping fee. |
Raw Request
Send raw HTTP request to Google Content Shopping
Input | Comments | Default |
---|---|---|
Connection | ||
API Version | The API version to use. This is used to construct the base URL for the request. | v2.1 |
URL | Input 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. | |
Method | The HTTP method to use. | |
Data | The HTTP body payload to send to the URL. | |
Form Data | The Form Data to be sent as a multipart form upload. | |
File Data | File Data to be sent as a multipart form upload. | |
File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
Query Parameter | A 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. | |
Header | A list of headers to send with the request. | |
Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
Timeout | The maximum time that a client will await a response to its request | |
Debug Request | Enabling this flag will log out the current request. | false |
Retry Delay (ms) | The delay in milliseconds between retries. | 0 |
Retry On All Errors | If true, retries on all erroneous responses regardless of type. | false |
Max Retry Count | The maximum number of retries to attempt. | 0 |
Use Exponential Backoff | Specifies 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.
Input | Comments | Default |
---|---|---|
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. | |
Account Id | The ID of the account. | |
Name | Display name for the account. | |
Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
Website Url | The merchant's website. | |
Adult Content | Indicates whether the merchant sells adult content. | false |
Seller Id | Client-specific, locally-unique, internal ID for the child account. | |
User | Users with access to the account. Every account (except for subaccounts) must have at least one admin user. | |
Youtube Channel Links | Linked 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 Link | The Business Profile which is linked or in the process of being linked with the Merchant Center account. | |
Business Information | The business information of the account. | |
Automatic Improvements | The automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately. | |
Ads Links | Linked 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 Id | ID of CSS the account belongs to | |
Label Ids | Manually created label IDs that are assigned to the account by CSS. | ["000xxx"] |
Account Management | Controls which fields will be populated. Acceptable values are: 'merchant' and 'css'. The default value is 'merchant'. | |
Automatic Label Ids | Automatically created label IDs that are assigned to the account by CSS Center. | ["000xxx"] |
Conversion Settings | Settings for conversion tracking. |
Update Product
Updates an existing product in your Merchant Center account. Only updates attributes provided in the request.
Input | Comments | Default |
---|---|---|
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. |
Update Product Local Inventory
Updates the local inventory of a product in your Merchant Center account.
Input | Comments | Default |
---|---|---|
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. | |
Store Code | Store code of this local inventory resource. | |
Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
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 | |
Availability | Availability status of the item. | |
Quantity | Quantity of the product. Must be nonnegative. | |
Pickup Method | The pick up option for the item. | |
Pickup Sla | Item store pickup timeline. | |
Instore Product Location | In-store product location. | |
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). |
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.
Input | Comments | Default |
---|---|---|
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. | |
Region Id | The ID uniquely identifying each region. | |
Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
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 | |
Availability | Availability status of the item. | |
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). |
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.
Input | Comments | Default |
---|---|---|
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. | |
Kind | Identifies what kind of resource this is. Value: the fixed string 'content#account'. | |
Cloud Topic Name | Cloud pub/sub topic to which notifications are sent (read-only). | |
Registered Events | List of event types. | ["000xxx"] |