sell_on_google_quantity: Definition

Use the sell_on_google_quantity attribute to let customers know the total number of items available to sell on Google of a particular product.

Google will take this value into account and decrement it with each item sold. For example, if you specify "12" for a given product and a user orders two products, Google knows that the next order on Shopping Actions can only hold up to ten units of that same product.

When to use

Highly recommended for all products.

Use the sell_on_google_quantity attribute to indicate which quantity of a product is available to sell on Google. Use the availability attribute to indicate the status of the product, such in stock or out of stock. Make sure that the information given in both attributes is up to date to ensure that your shopping ads are displayed as desired. For example, if a product is marked as out of stock, it may not display even if the sell_on_google_quantity amount is greater than zero. 

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type	Number
Supported values	Any integer, including 0
Repeated field	No

File format	Example value
Text feeds	50
XML feeds	<g:sell_on_google_quantity>50</g:sell_on_google_quantity>

If you choose to use the Content API to add this attribute, you’ll need to use the custom attributes feature.

File format	Example entry
Content API (JSON)	"customAttributes": [     {       "name": "sell_on_google_quantity",       "value": "10"     }   ]

For information on formatting, see the Content API for Shopping.

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products.

Minimum requirements

These are the requirements you'll need to meet to show your product data on surfaces across Google. If you don't follow these requirements, we'll disapprove your product and let you know on the Diagnostics page of your Merchant Center account. 

• Share frequent and accurate available quantity with Google using sell_on_google_quantity feed attribute.
• Google may limit the maximum daily orders for products that do not share accurate available quantity using the sell_on_google_quantity feed attribute.

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

• Provide the most up-to-date data. Availability and prices of your items can change quite frequently. This feature works best when you update this attribute as frequently as possible by  making calls to the Product API or through a supplemental data feed.  Use the availability attribute if you want to mark a product as out of stock. 

Examples

Product is available for sale on Google