Sign in

Google Base Help



Google Help › Google Base Help › Submitting to Google Base › Data feeds › Data feed instructions › Google Base - Attribute List  

Google Base - Attribute List

Print

Google Base Attributes

Here is a complete list of all attributes defined by Google Base, grouped by item type. You can also create your own attributes, if none of the following are appropriate. You can learn more about custom attributes here.

All

The following attributes can be used in any item type (if applicable).

description
Text describing the item. Do not include promotional or boilerplate text, such as "Free shipping!" or "Click here now!" We search over this text when matching user queries to your item. Please make sure you include the same item description available on your website in the description field in your data feed.
Format:
Text, up to a maximum length of 10,000 characters. Ideally, greater than 15 characters and three words.
Tab-delimited example:
The purpose of this course is to help you gain familiarity with a broad array of techniques, facts, theories and research results in human resource management (HR).
XML example:
<description>The purpose of this course is to help you gain familiarity with a broad array of techniques, facts, theories and research results in human resource management (HR).</description>

expiration_date
The date that the item listing expires or that information about this item is going to change.
Format:
ISO 8601 format: YYYY-MM-DD. Note: all dates and times are in PST (GMT -8).
Tab-delimited example:
2006-12-20
XML example:
<g:expiration_date>2006-12-20</g:expiration_date>

id
A unique alphanumeric identifier for the 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 data feed. Each item must retain the same id in subsequent feeds.
Format:
Text.
Tab-delimited example:
01flx
XML example:
<g:id>01flx</g:id>

image_link
The URL of an associated image for the item. Use your full-sized images, not thumbnail images. If you do not have an image available, leave the attribute blank. Do not include logos or an image that says, "Image not available."
Format:
URL. (Must include the http:// portion.) Up to 10 URLs can be included. For tab-delimited, separate each URL by a comma. For XML, include each URL as a separate <image_link> attribute.
Tab-delimited example:
http://www.example.co.uk/image1.jpg,http://www.example.co.uk/image2.jpg
XML example:
<g:image_link>http://www.example.co.uk/image1.jpg</g:image_link>
<g:image_link>http://www.example.co.uk/image2.jpg</g:image_link>

link
The URL of the web page associated with the item. This should not forward to another URL; it must point directly to the target page. The domain name may not be an IP address.
Format:
URL. (Must include the http:// portion.)
Tab-delimited example:
http://www.example.co.uk/asp/sp.asp?cat=12&id=1030
XML example:
<link>http://www.example.co.uk/asp/sp.asp?cat=12&amp;id=1030</link>

location
The location of the item.
Format:
Addresses should be formatted as: street, city, state, postal code, country. Each location element should be separated by a comma. Locations are validated through Google Maps.
Tab-delimited example:
76 Buckingham Palace Road, London, SW1W 9TQ, United Kingdom
XML example:
<g:location>76 Buckingham Palace Road, London, SW1W 9TQ, United Kingdom</g:location>

payment_accepted
The acceptable payment methods for this item.
Format:
Acceptable values are: Cash, Check, Visa, MasterCard, AmericanExpress, Discover, and WireTransfer. You may include as many methods as you accept. For tab-delimited, separate each payment method by a comma. For XML, include each payment method as a separate <payment_accepted> attribute.
Tab-delimited example:
Cash,Discover,Visa
XML example:
<g:payment_accepted>Cash</g:payment_accepted>
<g:payment_accepted>Discover</g:payment_accepted>
<g:payment_accepted>Visa</g:payment_accepted>

payment_notes
Additional instructions to explain a payment policy. If you are accepting Google Checkout on your website, you may include that information here.
Format:
Text.
Tab-delimited example:
Cash only for local orders.
XML example:
<g:payment_notes>Cash only for local orders.</g:payment_notes>

pickup
Information about whether or not the item is available for pickup.
Format:
Acceptable values are: true or false.
Tab-delimited example:
true
XML example:
<g:pickup>true</g:pickup>

price
The price for the item. The price must be inclusive of any value added tax (VAT) charged upon checkout.
Note: Only fixed prices are allowed. Variably-priced items, such as auction items, are not permitted.
Format:
Number.
Tab-delimited example:
25.00
XML example:
<g:price>25.00</g:price>

price_type
The type of pricing for the item.
Format:
Acceptable values are: negotiable or starting.
Tab-delimited example:
negotiable
XML example:
<g:price_type>negotiable</g:price_type>

quantity
The number of items available.
Format:
Number. Indicate a value of 0 for out-of-stock items.
Tab-delimited example:
3
XML example:
<g:quantity>3</g:quantity>

title
The name or title of the item.
Format:
Text. Suggested maximum length of 70 characters.
Tab-delimited example:
Human resources management
XML example:
<title>Human resources management</title>

Events and Activities

event_date_range
Information on the date and time an event will take place.
Format:
ISO 8601 format: YYYY-MM-DDThh:mm:ss. (Times are based on the 24-hour clock.) This can either be a start date or a date range. For tab-delimited, if a range of dates is included, separate the start and end dates by a forward slash. For XML, two sub-attributes are included in this attribute: <start> and <end>. Note: all dates and times are in PST (GMT -8).
Tab-delimited example:
2006-12-20T23:00:00/2006-12-21T08:30:00
XML example:
<g:event_date_range><g:start>2006-12-20T14:00:00</g:start> <g:end>2006-12-20T19:00:00</g:end></g:event_date_range>

event_type
The type of event.
Format:
Text. Appropriate values include: concert, sporting event, etc.
Tab-delimited example:
concert
XML example:
<g:event_type>concert</g:event_type>

performer
The individual or group performing at the event.
Format:
Text.
Tab-delimited example:
Dave Matthews Band
XML example:
<g:performer>Dave Matthews Band</g:performer>

venue_description
Text describing the venue hosting the event.
Format:
Text.
Tab-delimited example:
Spacious outdoor amphitheatre with plenty of seating.
XML example:
<g:venue_description>Spacious outdoor amphitheatre with plenty of seating.</g:venue_description>

venue_name
The name of the venue hosting the event.
Format:
Text.
Tab-delimited example:
Shoreline Amphitheatre
XML example:
<g:venue_name>Shoreline Amphitheatre</g:venue_name>

venue_type
The type of venue hosting the event.
Format:
Text.
Tab-delimited example:
concert theater
XML example:
<g:venue_type>concert theater</g:venue_type>

venue_website
The home page of the venue hosting the event.
Format:
URL. (Must include the http:// portion.)
Tab-delimited example:
http://www.example.co.uk/venue_page.html
XML example:
<g:venue_website>http://www.example.co.uk/venue_page.html</g:venue_website>

Housing

agent
Individual who is negotiating and arranging the real estate sale.
Format:
Text.
Tab-delimited example:
Sue Smith
XML example:
<g:agent>Sue Smith</g:agent>

area
The interior area of a property.
Format:
Number and unit.
Tab-delimited example:
1000 square m.
XML example:
<g:area>1000 square m.</g:area>

bathrooms
The number of bathrooms.
Format:
Number.
Tab-delimited example:
2.5
XML example:
<g:bathrooms>2.5</g:bathrooms>

bedrooms
The number of bedrooms.
Format:
Number.
Tab-delimited example:
4
XML example:
<g:bedrooms>4</g:bedrooms>

broker
Real estate broker responsible for a property.
Format:
Text.
Tab-delimited example:
Acme Real Estate
XML example:
<g:broker>Acme Real Estate</g:broker>

feature
A feature or amenity of a property.
Format:
Text.
Tab-delimited example:
Cathedral ceilings
XML example:
<g:feature>Cathedral ceilings</g:feature>

hoa_dues
The monthly dues paid to a homeowners association.
Format:
Number.
Tab-delimited example:
400
XML example:
<g:hoa_dues>400</g:hoa_dues>

latitude
The precise latitude of the listing. Provide only if known accurately. If blank, a Google geocoder will be used on the address in the location attribute.
Format:
Number (decimal permitted).
Tab-delimited example:
23.433334
XML example:
<g:latitude>23.433334</g:latitude>

longitude
The precise longitude of the listing. Provide only if known accurately. If blank, a Google geocoder will be used on the address in the location attribute.
Format:
Number (decimal permitted).
Tab-delimited example:
-91.412324
XML example:
<g:longitude>-91.412324</g:longitude>

listing_status
The status of a property listing.
Format:
Text. Appropriate values include: active, offer, contract, closed, and withdrawn.
Tab-delimited example:
active
XML example:
<g:listing_status>active</g:listing_status>

listing_type
The type of transaction for this listing.
Format:
Text. Appropriate values include:
  • foreclosure: Purchase of a foreclosed property.
  • for rent: Rental of a whole housing unit offered by landlord by the month or year.
  • for sale: Purchase of an existing property.
  • new home: Purchase of a build-to-order home that has not been built yet.
  • room for rent: Shared rental of a housing unit.
  • sublet: Rental of a whole housing unit offered by tenant for a period shorter than the lease.
Tab-delimited example:
for sale
XML example:
<g:listing_type>for sale</g:listing_type>

lot_size
Size of a property's lot.
Format:
Number and unit.
Tab-delimited example:
43560 square m.
XML example:
<g:lot_size>43560 square m.</g:lot_size>

mls_listing_id
The unique ID assigned to this listing by a Multiple Listing Service.
Format:
Text.
Tab-delimited example:
246812
XML example:
<g:mls_listing_id>246812</g:mls_listing_id>

mls_name
The name of the Multiple Listing Service where a property is listed.
Format:
Text.
Tab-delimited example:
Acme MLS
XML example:
<g:mls_name>Acme MLS</g:mls_name>

model
The name that describes the floorplan of a property.
Format:
Text.
Tab-delimited example:
Classic Comfort AS-1234
XML example:
<g:model>Classic Comfort AS-1234</g:model>

open_house_date_range
Information about the date and time an open house will take place.
Format:
ISO 8601 format: YYYY-MM-DDThh:mm:ss. (Times are based on the 24-hour clock.) This can either be a start date or a date range. For tab-delimited, if a range of dates is included, separate the start and end dates by a forward slash. For XML, two sub-attributes are included in this attribute: <start> and <end>. Note: all dates and times are in the local timezone of the property being listed.
Tab-delimited example:
2006-12-10T00:00:01/2006-12-16T23:59:59
XML example:
<g:open_house_date_range><g:start>2006-12-10T00:00:01</g:start> <g:end>2006-12-16T23:59:59</g:end></g:open_house_date_range>

parking
Number of parking places.
Format:
Number
Tab-delimited example:
1
XML example:
<g:parking>1</g:parking>

property_taxes
The property taxes for the property.
Format:
Number.
Tab-delimited example:
500.00
XML example:
<g:property_taxes>500.00</g:property_taxes>

property_type
A description of the physical property and any shared ownership.
Format:
Text. Appropriate values include: apartment, commercial, condo, coop, farm, flat, land, manufactured, multifamily, ranch, single family, tic, and townhouse.
Tab-delimited example:
flat
XML example:
<g:property_type>flat</g:property_type>

provider_class
The type of data provider reponsible for the bulk upload.
Format:
Acceptable values are: agent, aggregator, broker, franchisor, homebuilder, mls, other, and publisher.
Tab-delimited example:
broker
XML example:
<g:provider_class>broker</g:provider_class>

school
A school that services the property.
Format:
Text.
Tab-delimited example:
Union High School
XML example:
<g:school>Union High School</g:school>

school_district
The school district the property is in.
Format:
Text.
Tab-delimited example:
Union School District
XML example:
<g:school_district>Union School District</g:school_district>

style
The architectural style of a property.
Format:
Text. Appropriate values include: Cape Cod, Colonial, Craftsman, Gothic, Prairie, Ranch, Split Level, Tudor, and Victorian Queen Anne.
Tab-delimited example:
Colonial
XML example:
<g:style>Colonial</g:style>

video_link
The URL of an associated YouTube video for the item.
Format:
URL. (Must include the http:// portion.) Up to 10 URLs can be included. For tab-delimited, separate each URL with a comma. For XML, include each URL as a separate video_link attribute.
Example:
http://www.youtube.com/watch?v=SVvx13dpTEA

year
The model year or year built.
Format:
Year, in four digits: YYYY.
Tab-delimited example:
2005
XML example:
<g:year>2005</g:year>

zoning
The zoning of the property.
Format:
Text. Appropriate values include: agricultural, commercial, industrial, recreational, residential, unincorporated.
Tab-delimited example:
residential
XML example:
<g:zoning>residential</g:zoning>

Jobs

education
The level of education required for the employment position.
Format:
Text.
Tab-delimited example:
PhD
XML example:
<g:education>PhD</g:education>

employer
The company providing employment.
Format:
Text.
Tab-delimited example:
Google Inc.
XML example:
<g:employer>Google Inc.</g:employer>

immigration_status
The legal residency requirements for the employment position.
Format:
Text.
Tab-delimited example:
permanent resident
XML example:
<g:immigration_status>permanent resident</g:immigration_status>

job_function
The function of the employment position.
Format:
Text.
Tab-delimited example:
Product manager
XML example:
<g:job_function>Product manager</g:job_function>

job_industry
The industry of the employment position.
Format:
Text.
Tab-delimited example:
Government
XML example:
<g:job_industry>Government</g:job_industry>

job_type
The type of employment position.
Format:
Text. Appropriate values include: full-time, part-time, and contractor, etc.
Tab-delimited example:
contractor
XML example:
<g:job_type>contractor</g:job_type>

publish_date
The date the job was published.
Format:
ISO 8601 format: YYYY-MM-DD. Note: all dates and times are in PST (GMT -8).
Tab-delimited example:
2005-12-20
XML example:
<g:publish_date>2005-12-20</g:publish_date>

salary
The salary for this position.
Format:
Number. Non-numeric values such as £ symbols are not acceptable.
Tab-delimited example:
55000
XML example:
<g:salary>55000</g:salary>

salary_type
The type of salary associated with the employment position.
Format:
Accepted values are: starting and negotiable. The default is starting.
Tab-delimited example:
negotiable
XML example:
<g:salary_type>negotiable</g:salary_type>

Vehicles

colour
The colour of the vehicle.
Format:
Text.
Tab-delimited example:
red
XML example:
<g:colour>red</g:colour>

condition
The condition of the vehicle. Appropriate values include: new, used, and refurbished.
Format:
Text.
Tab-delimited example:
new
XML example:
<g:condition>new</g:condition>

make
The vehicle manufacturer.
Format:
Text.
Tab-delimited example:
Honda
XML example:
<g:make>Honda</g:make>

mileage
The current mileage of the vehicle.
Format:
Number.
Tab-delimited example:
17000
XML example:
<g:mileage>17000</g:mileage>

model
The vehicle model.
Format:
Text.
Tab-delimited example:
Camry
XML example:
<g:model>Camry</g:model>

vehicle_type
The type of vehicle.
Format:
Text. Appropriate values include: car, motorcycle, scooter, etc.
Tab-delimited example:
car
XML example:
<g:vehicle_type>car</g:vehicle_type>

vin
Vehicle Identification Number.
Format:
Text.
Tab-delimited example:
1M8GDM9AXKP042788
XML example:
<g:vin>1M8GDM9AXKP042788</g:vin>

year
The model year or year built.
Format:
Year, in four digits: YYYY.
Tab-delimited example:
2003
XML example:
<g:year>2003</g:year>

Was this information helpful?

Tell us how we're doing: please answer a few questions about your experience to help us to improve our Help Centre.

Google Base - Contacting Us - Help with other Google products -

©2010 Google - Google Home - Privacy Policy - Terms of Service