Google Base
 Google Base - XML attributes

Google Base Home

About Google Base

Help Center

Program Policies

Bulk Upload Instructions

Set 1: Simple-type attributes at <item> level

Note: Examples of some attributes include the “g:” prefix. This prefix is required when including these attributes in your bulk uploads.

actor
Details Actor featured in the video.
Example <g:actor>Charlie Chaplin</g:actor>
Attribute of Products
Content type string

age
Details Minimum age requirement for the event or the age of the individual in a People profiles bulk upload entry.
Example Acceptable:
<g:age>18</g:age>
Not acceptable:
<g:age>18 and over</g:age>
Attribute of Events, People profiles
Content type integer

agent
Details Individual who is negotiating and arranging the real estate sale.
Example <g:agent>Sue Smith</g:agent>
Attribute of Housing
Content type string

apparel_type
Details The type of apparel being offered. Skirt, pants, sleepwear, etc.
Example <g:apparel_type>sweater</g:apparel_type>
Attribute of Products
Content type string

area
Details The size of an area of real estate.
Example <g:area>1000</g:area>
Attribute of Housing
Content type intUnit

artist
Details Artist that created the work.
Example <g:artist>Vincent van Gogh</g:artist>
Attribute of Products
Content type string

author
Details Author of the item.
Example <g:author>John Steinbeck</g:author>
Attribute of Research Studies and Publications, News and Articles
Content type string

bathrooms
Details Number of bathrooms. Numeric values only.
Example Acceptable:
<g:bathrooms>2</g:bathrooms>
Not acceptable:
<g:bathrooms>2 bathrooms</g:bathrooms>
Attribute of Housing
Content type float

bedrooms
Details Number of bedrooms. Numeric values only.
Example Acceptable:
<g:bedrooms>3</g:bedrooms>
Not acceptable:
<g:bedrooms>3 bedrooms</g:bedrooms>
Attribute of Housing
Content type integer

brand
Details The brand name of an item.
Example <g:brand>Acme</g:brand>
Attribute of Products
Content type string

calories
Details The amount of calories in a recipe serving
Example <g:calories>280</g:calories>
Attribute of Recipes
Content type float

cholesterol
Details The amount of cholesterol in a recipe serving (listed in milligrams)
Example <g:cholesterol>9</g:cholesterol>
Attribute of Recipes
Content type float

color
Details Color of an item.
Example <g:color>Black</g:color>
Attribute of Products, Vehicles
Content type string

condition
Details Condition of the item. For example: new, used, or refurbished.
Example <g:condition>refurbished</g:condition>
Attribute of Products, Vehicles
Content type string

cooking_time
Details The amount of time a recipe requires to be cooked (in minutes)
Example <g:cooking_time>60</g:cooking_time>
Attribute of Recipes
Content type integer

course
Details The part of a meal a recipe belongs to
Example <g:course>main entree</g:course>
Attribute of Recipes
Content type string

course_number
Details ID code associated with a course.
Example <g:course_number>HIST-90A</g:course_number>
Attribute of Course schedules
Content type string

course_times
Details Time a class is in session.
Example <g:course_times>MWF 08:30 - 09:45</g:course_times>
Attribute of Course schedules
Content type string

cuisine
Details The style of cooking the recipe falls under
Example <g:cuisine>Italian</g:cuisine>
Attribute of Recipes
Content type string

currency
Details Currency of the price amount for an item. Values must be in ISO 4217 currency code format.
Example Acceptable:
<g:currency>USD</g:currency>
Not acceptable:
<g:currency>US Dollars</g:currency>
Attribute of Events, Housing, Products, Services, Travel, Vehicles
Content type currencyEnumeration

delivery_notes
Details Additional instructions to explain the item’s delivery process.
Example <g:delivery_notes>Items usually shipped within 24 hours.</g:delivery_notes>
Attribute of Events, Products, Reviews, Services, Travel, Vehicles, Wanted Ads.
Content type string

delivery_radius
Details The maximum distance you will deliver an item in any direction.
Example <g:delivery_radius>10</g:delivery_radius>
<g:delivery_radius>10km</g:delivery_radius>
Attribute of Events, Products, Reviews, Services, Travel, Vehicles, Wanted Ads.
Content type floatUnit

education
Details Level of education required for an employment position.
Example <g:education>PhD</g:education>
Attribute of Jobs
Content type string

employer
Details Company providing employment.
Example <g:employer>Google, Inc</g:employer>
Attribute of Jobs
Content type string

ethnicity
Details Ethnicity of the individual in the People profiles bulk upload entry.
Example <g:ethnicity>Latino</g:ethnicity>
Attribute of People profiles
Content type string

expiration_date
Details Date that the item expires in ISO 8601 format: YYYY-MM-DD
Example <g:expiration_date>2005-12-20</g:expiration_date>
Attribute of Research Studies and Publications, Events, Housing, Jobs, People profiles, Products, Services, Travel, Vehicles, Wanted Ads.
Content type date

expiration_date_time
Details Date and time that the item expires in ISO 8601 format: YYYY-MM-DDThh:mm:ss
Example <g:expiration_date_time>2005-12-05T11:59:59</g:expiration_date_time>
Attribute of Research Studies and Publications, Events, Housing, Jobs, People profiles, Products, Services, Travel, Vehicles, Wanted Ads.
Content type dateTime

fiber
Details The amount of fiber in a recipe serving (listed in grams)
Example <g:fiber>9</g:fiber>
Attribute of Recipes
Content type float

format
Details Format of the content.
Example <g:format>DVD</g:format>
<g:format>CD</g:format>
Attribute of Products
Content type string

from_location
Details Starting city and state/country of the trip.
Example Acceptable:
<g:from_location>San Francisco, CA</g:from_location>
<g:from_location>Paris, France</g:from_location>
Not acceptable:
<g:from_location> San Francisco International Airport</g:from_location>
Attribute of Travel
Content type location

gender
Details Gender of an individual in a People profiles bulk upload item. Acceptable values are “male,” “M,” “female,” or “F.”
Example <g:gender>female</g:gender>
Attribute of People profiles
Content type genderEnumeration

hoa_dues
Details Monthly dues paid to a homeowners association.
Example <g:hoa_dues>100</g:hoa_dues>
Attribute of Housing
Content type float

id
Details (RSS 1.0 only) Unique alphanumeric identifier for each item – e.g., your internal ID code.
IMPORTANT: Once you submit an item with a unique id, this identifier must not change when you send in a new bulk upload. Each item must retain the same id in subsequent bulk uploads.
Example <g:id>01flx</g:id>
Attribute of Research Studies and Publications, Events, Housing, Jobs, News and Articles, People profiles, Products, Reviews, Services, Travel, Vehicles, Wanted Ads.
Content type string

image_link
Details URL of an associated image if available online. Use your full-sized images; do not use thumbnail images. Up to ten image_links, all placed in between their own <image_link> and </image_link> attributes, can be included with each item. If you do not have an image available, do not include this attribute. Please do not include an image that says "Image not available." Relative URLs and logo images are not acceptable.
Example Acceptable:
<g:image_link>http://example.com/images/1006.jpg</g:image_link>
<g:image_link>http://example.com/i/6.jpg,http://example.com/i/9.jpg</g:image_link>
Not acceptable:
<g:image_link>/images/1006.jpg</g:image_link>
<g:image_link>example.com/images/1006.jpg</g:image_link>
Attribute of Research Studies and Publications, Events, Housing, Jobs, News and Articles, People profiles, Products, Reviews, Services, Travel, Vehicles, Wanted Ads.
Content type url

immigration_status
Details Legal residency requirements for an employment position.
Example <g:immigration_status>Permanent resident</g:immigration_status>
Attribute of Jobs
Content type string

interested_in
Details Interest of a person being profiled.
Example <g:interested_in>Long walks on the beach.</g:interested_in>
Attribute of People profiles
Content type string

isbn
Details A unique 10 or 13 digit number assigned to every printed book.
Example <g:isbn>0451524233</g:isbn>
Attribute of Products
Content type string

job_function
Details The function of an employment position.
Example <g:job_function>Product Manager</g:job_function>
Attribute of Jobs
Content type string

job_industry
Details The industry of an employment position.
Example <g:job_industry>Government</g:job_industry>
Attribute of Jobs
Content type string

job_type
Details Type of employment position. Example: Full-time, part-time, contractor, etc.
Example <g:job_type>contractor</g:job_type>
Attribute of Jobs
Content type string

label
Details A list of classifications the item may fall under. Up to ten user-selected labels, each placed in between their own <label> and </label> tags, can be included with each item. These attributes will be used to match your items to search queries. Each attribute value will be checked for policy compliance.
Example Acceptable:
For an automobile in a Vehicles information type:

<g:label>Leather</g:label>
<g:label>Power locks</g:label>
<g:label>sunroof</g:label>
<g:label>ABS</g:label>

For a concert in an Events information type:
<g:label>VIP</g:label>
<g:label>front row</g:label>
<g:label>backstage</g:label>
<g:label>KROCK 101.5</g:label>
<g:label>parking passes</g:label>

Not acceptable:
<g:label> leater, power locks, sunroof, ABS </g:label>
Attribute of Research Studies and Publications, Events, Housing, Jobs, News and Articles, People profiles, Products, Reviews, Services, Travel, Vehicles, Wanted Ads.
Content type string

listing_type
Details Information about whether or not a property is for sale or not. Acceptable values are "for sale" and "for rent."
Example Acceptable:
<g:listing_type>for sale</g:listing_type>
Attribute of Housing
Content type string

location
Details Can be formatted as either an address or latitude and longitude. Addresses should be formatted: street, city, state, postal code, and country, in that order. Note that not all these values are necessary (see examples below). Latitude and Longitude should be formatted: latitude,longitude.
Example Acceptable:
<g:location>1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA</g:location>
<g:location>Mountain View, CA, 94043</g:location>
<g:location>37.423130,-122.083706</g:location>
Not acceptable:
<g:location>1600 Amphitheatre Parkway, , CA, USA</g:location>
<g:location>corner of Market and 2nd, San Francisco, CA</g:location>
Attribute of Events, Housing, Jobs, People profiles, Products, Reviews, Services, Travel, Vehicles, Wanted Ads.
Content type location

make
Details The vehicle manufacturer.
Example <g:make>Honda</g:make>
Attribute of Vehicles
Content type string

main_ingredient
Details The defining component in a recipe
Example <g:main_ingredient>Tofu</g:main_ingredient>
Attribute of Recipes
Content type string

manufacturer
Details Company that manufactures the item.
Example <g:manufacturer>Acme, Inc</g:manufacturer>
Attribute of Products
Content type string

manufacturer_id
Details Unique product ID code assigned by its manufacturer.
Example <g:manufacturer_id>030779A</g:manufacturer_id>
Attribute of Products
Content type string

marital_status
Details Marital status of an individual in a People profiles bulk upload entry. For example -single, divorced, separated, widowed, married, or“in relationship.”
Example <g:marital_status>single</g:marital_status>
Attribute of People profiles
Content type string

megapixels
Details Resolution of a digital imaging device.
Example <g:megapixels>5.2 MP</g:megapixels>
Attribute of Products
Content type floatUnit

meal_type
Details A time or occasion a recipe is normally prepared for
Example <g:meal_type>breakfast</g:meal_type>
Attribute of Recipes
Content type string

memory
Details The amount of memory included in an item.
Example <g:memory>128 MB</g:memory>
Attribute of Products
Content type floatUnit
 
mileage
Details Current mileage of the vehicle.
Example <g:mileage>1700</g:mileage>
Attribute of Vehicles
Content type intUnit

model
Details The vehicle model.
Example <g:model>Camry</g:model>
Attribute of Vehicles
Content type string

model_number
Details Model number of the product.
Example <g:model_number>1924863</g:model_number>
Attribute of Products
Content type string

name_of_item_reviewed
Details The name of an item being reviewed.
Example <g:name_of_item_reviewed>Fleur de lys Restaurant</g:name_of_item_reviewed>
Attribute of Reviews
Content type string

news_source
Details The source of news content.
Example <g:news_source>Journal</g:news_source>
Attribute of News and Articles
Content type string

occupation
Details Industry the individual in a People profiles bulk upload is employed in.
Example <g:occupation>Sales</g:occupation>
Attribute of People profiles
Content type string

pages
Details The number of pages in the publication.
Example <g:pages>18</g:pages>
Attribute of Research Studies and Publications, News and Articles
Content type integer

payment_accepted
Details Acceptable payment methods for item purchases. Acceptable values are "Cash," "Check," "GoogleCheckout," "Visa," "MasterCard," "AmericanExpress," "Discover," or "WireTransfer." If you accept more than one method, include multiple instances of the <payment_accepted> attribute for each acceptable method.

NOTE: The "GoogleCheckout" payment option can only be specified if you meet all of the following requirements:
  1. You are selling a product or vehicle.
  2. You have registered for a Checkout account.
  3. Price values are included in each of your item details.
  4. The price value is between $1.00 and $1999.95.
  5. Quantity values are included in each of your item details.
Example Acceptable:
<g:payment_accepted>Cash</g:payment_accepted>
<g:payment_accepted>Check</g:payment_accepted>
Not acceptable:
<g:payment_accepted>Cash Check</g:payment_accepted>
Attribute of Events, Housing, Products, Services, Travel, Vehicles
Content type payment_acceptedEnumeration

payment_notes
Details Additional instructions to explain a payment policy.
Example <g:payment_notes>Cash only for local orders.</g:payment_notes>
Attribute of Events, Housing, Products, Services, Travel, Vehicles
Content type string

pickup
Details Information about whether or not an item is available for pick up. Acceptable values are "true and "false".
Example Acceptable:
<g:pickup>true</g:pickup>
Not acceptable:
<g:pickup>Not on Tuesdays</g:pickup>
Attribute of Products
Content type boolean

preparation_time
Details The amount of time a recipe requires to be prepared (in minutes)
Example <g:preparation_time>30</g:preparation_time>
Attribute of Recipes
Content type integer

price
Details Prices can be a single price, 0 (free), or blank if not applicable. Numeric values only. When used as a sub-attribute of <shipping>, the value included reflects the price of shipping.
Example Acceptable:
<g:price>5.95</g:price>
<g:price>0</g:price>
Not acceptable:
<g:price>5,95</g:price>
<g:price>5.00 – 10.00</g:price>
<g:price>100 or best offer</g:price>
<g:price>free</g:price>
Attribute of Events, Housing, Products, Services, Travel, Vehicles
Content type floatUnit

price_type
Details The type of pricing for the item. Acceptable values are “negotiable,” or “starting.” The default is “starting”
Example Acceptable:
<g:price_type>starting</g:price_type>
Not acceptable:
<g:price_type>100 OBO</g:price_type>
Attribute of Events, Housing, Products, Services, Travel, Vehicles
Content type price_typeEnumeration

processor_speed
Details The processor speed for the product.
Example <g:processor_speed>2</g:processor_speed>
Attribute of Products
Content type floatUnit

product_type
Details The type of product being offered. Toys, books, flowers, etc.
Example <g:product_type>electronics</g:product_type>
Attribute of Products
Content type string

property_type
Details Type of property: house, apartment, condominium, etc.
Example <g:property_type>house</g:property_type>
Attribute of Housing
Content type string

protein
Details The amount of protein in a recipe serving (listed in grams)
Example <g:protein>25</g:protein>
Attribute of Recipes
Content type float

publication_name
Details Name of the publication.
Example <g:publication_name> Journal of Appropriate Technology</g:publication_name>
Attribute of Research studies and publications
Content type string

publication_volume
Details Volume of the publication.
Example <g:publication_volume>VI</g:publication_volume>
Attribute of Research Studies and Publications
Content type string

publish_date
Details Date the item was published in ISO 8601 format: YYYY-MM-DD
Example <g:publish_date>2005-12-20</g:publish_date>
Attribute of Research Studies and Publications
Content type date

quantity
Details The number of units available for purchase.
Example Acceptable:
<g:quantity>18</g:quantity>
<g:quantity>0</g:quantity>
Not acceptable:
<g:quantity>out of stock</g:quantity>
Attribute of Events, Products, Services, Travel, Vehicles
Content type integer

rating
Details Rating of the product or service on a scale of 1-5, with 5 as the best. Numeric values only.
Example Acceptable:
<g:rating>4</g:rating>
Not acceptable:
<g:rating>good</g:rating>
Attribute of Reviews
Content type string

review_type
Details The category of the item being reviewed.
Example <g:review_type>toy</g:review_type>
<g:review_type>music</g:review_type>
<g:review_type>restaraunt</g:review_type>
Attribute of Reviews
Content type string

reviewer_type
Details The type of rating being provided: editorial (a review written by a member of your staff) or “user” ( a review written by a user of your site)
Example <g:reviewer_type>editorial</g:reviewer_type>
Attribute of Reviews
Content type string

salary
Details Salary for this position. Non-numeric values such as "$" symbols are not acceptable.
Example <g:salary>55000</g:salary>
Attribute of Jobs
Content type float

salary_type
Details The type of salary included. Accepted values are “starting” or “negotiable;” The default is “starting.”
Example <g:salary_type>negotiable</g:salary_type>
Attribute of Jobs
Content type salary_typeEnumeration

saturated_fat
Details The amount of saturated fat in a recipe serving (listed in grams)
Example <g:saturated_fat>3</g:saturated_fat>
Attribute of Recipes
Content type float

school_district
Details The school district the property is in.
Example <g:school_district>Union School District</g:school_district>
Attribute of Housing
Content type string

service_type
Details The type of service being offered. Web hosting, legal, gardening, etc.
Example <g:service_type>consulting</g:service_type>
Attribute of Housing
Content type string

servings
Details The total number of helpings in the finished recipe
Example <g:servings>6</g:servings>
Attribute of Recipe
Content type integer

sexual_orientation
Details Sexual orientation of an individual in a People profiles information type..
Example <g:sexual_orientation>straight</g:sexual_orientation>
Attribute of Personal
Content type string

size
Details Dimensions of the item, expressed in either two or three dimensions.
Example <g:size>12x10x4</g:size>
Attribute of Products
Content type string

sodium
Details The amount of sodium in a recipe serving (listed in milligrams)
Example <g:sodium>1010</g:sodium>
Attribute of Recipes
Content type float

subject
Details Topic of study for a course.
Example <g:subject>Trigonometry</g:subject>
Attribute of Course schedules
Content type string

tax_percent
Details Tax rate as a percentage.
Example <g:tax_percent>8.2</g:tax_percent>
Attribute of Products, Events
Content type percentType

tax_region
Details Geographical region a tax rate applies to.
Example <g:tax_region>California</g:tax_region>
Attribute of Product, Events,
Content type string

to_location
Details Destination city and state/country of the trip.
Example Acceptable:
<g:to_location>San Francisco, CA</g:to_location>
<g:to_location>Paris, France</g:to_location>
Not acceptable:
<g:to_location>San Francisco International Airport</g:to_location>
Attribute of Travel
Content type location

total_carbs
Details The amount of carbohydrates in a recipe serving (listed in grams)
Example <g:total_carbs>22</g:total_carbs>
Attribute of Recipes
Content type float

total_fat
Details The amount of fat in a recipe serving (listed in grams)
Example <g:total_fat>8</g:total_fat>
Attribute of Recipes
Content type float

university
Details Name of the school a class is offered at.
Example <g:university>Stanford</g:university>
Attribute of Course schedules
Content type string

upc
Details Product UPC code.
Example <g:upc>834721479305</g:upc>
Attribute of Products
Content type string

url_of_item_reviewed
Details The web page of an item being reviewed.
Example <g:url_of_item_reviewed>http://www.fleurdelyssf.com/</g:url_of_item_reviewed>
Attribute of Reviews
Content type url

vehicle_type
Details The type of vehicle: Car, motorcycle, scooter, etc.
Example <g:vehicle_type>truck</g:vehicle_type>
Attribute of Products
Content type string

vin
Details Vehicle Identification Number.
Example <g:vin>1M8GDM9AXKP042788</g:vin>
Attribute of Vehicles
Content type string

weight
Details Weight of the item.
Example <g:weight>5</g:weight>
Attribute of Products
Content type floatUnit

year
Details The four digit model year or year built. Format YYYY
Example Acceptable:
<g:year>2005</g:year>
Not acceptable:
<g:year>79</g:year>
<g:year>26</g:year>
Attribute of Housing, Vehicles
Content type year

[custom attribute]
Details Custom attributes allow you to include additional information about your item. You can include an unlimited number of custom attributes with types. Please see our Google Base Provider Module for details on formatting a custom attribute.


Set 2: Complex type attributes at <item> level

course_date_range
Details Date and time range a class is in session, in ISO 8601. Two sub-attributes are included in course_date_range attribute.
  • start = Start date and time of a trip in format YYYY-MM-DDThh:mm:ss
  • end = End date and time of a trip in format YYYY-MM-DDThh:mm:ss
Example <g:course_date_range>
<g:start>2005-12-20T09:30:01</g:start>
<g:end>2005-12-29T10:30:59</g:end>
</g:course_date_range>
Attribute of Course schedules
Content type dateTimeRange

event_date_range
Details Information on the date and time an event will take place, in ISO 8601 format. Two sub-attributes are included in the event_date_range attribute:
  • start = Date and time an event will begin in format YYYY-MM-DDThh:mm:ss
  • end = (Optional). Date and time an event will end, in format YYYY-MM-DDThh:mm:ss
Example <g:event_date_range>
<g:start>2005-12-20T14:00:00</g:start>
<g:end>2005-12-20T19:00:00</g:end>
</g:event_date_range>
Attribute of Events
Content type dateTimeRange

travel_date_range
Details Departure date and time of the trip in ISO 8601 format: YYYY-MM-DD,hh:mm:ss. Two sub-attributes are included in travel_date_range attribute.
  • start = Start date and time of a trip in format YYYY-MM-DDThh:mm:ss
  • end = End date and time of a trip in format YYYY-MM-DDThh:mm:ss
Example <g:travel_date_range>
<g:start>2005-12-20T06:00:00</g:start>
<g:end>2005-12-29T13:00:00</g:end>
</g:travel_date_range>
Attribute of Travel
Content type dateTimeRange

shipping
Details Shipping options available for an item. Up to 10 shipping options can be included for each item. Three sub-attributes are included in the shipping attribute:
  • service = The delivery speed for the shipment.
  • country = The country an item will ship to. Only acceptable values are ISO 3166 country codes.
  • price = the price of shipping. NOTE: This is a required value.
Example <g:shipping>
<g:country>US</g:country>
<g:service>Overnight</g:service>
<g:price>35.95</g:price>
</g:shipping>
Attribute of Products
Content type shippingType

o oo0

©2007 Google - Google Home - Google Base Home - Terms of Service - Privacy Policy
Program Policies - Google Base Blog