Google Base - Reviews

Google Base Home

About Google Base

Help Center

Program Policies

Bulk Upload Instructions

Contact Us


Overview > Select Item Type > Create Bulk Upload > Register Bulk Upload > Submit Bulk Upload

Creating your bulk upload

We accept bulk uploads in five formats, including tab-delimited and four XML formats: RSS 2.0, RSS 1.0, Atom 1.0, and Atom 0.3. If you're uncertain about which format you should use, please see our bulk upload format page.

We've provided sample files to illustrate how your bulk upload file should be formatted. You can download a sample in any of these formats, and use it as a template for your own bulk upload file. For tab-delimited, the sample is available as both a text file (.txt) and a Microsoft Excel spreadsheet (.xls).

Tab-delimited RSS 1.0 RSS 2.0 Atom 0.3 Atom 1.0
Sample (.txt)
Sample (.xls)
Sample Sample Sample Sample

Whichever format you choose, you'll need to provide information about your reviews in the form of attributes. Organizing your content into attributes will enable people to search for it on Google Base. We've listed the required attributes below.

Once you've created a file with the set of attributes which best describe your reviews, you can register your bulk upload.

 
Attributes

Required attributes
You are required to include these attributes for all of the items in your bulk upload file. If you do not have information available for an attribute, you may leave it out, but keep in mind that including as many attributes as possible will increase your items' exposure in search results.

Additional attributes
You're also welcome to include any other information you have available. Our full list of attributes may contain other attributes relevant to your reviews. If you have additional information that does not fit our pre-defined attributes, you can also use custom attributes. Learn more about creating custom attributes here.

AdWords advertising attributes (optional)
By including specific advertising attributes in your bulk upload file, you can create Google AdWords ads to help increase traffic to your Google Base items. Google AdWords is an advertising program that allows you to run highly targeted cost-per-click (CPC) regardless of your budget.

With Google AdWords, you only pay when someone clicks on your ad, and you have complete control of how much you are willing to spend per day and per click. Ads for your Google Base items will be displayed along with search results on Google, as well as on sites in the Google Search Network. Learn more about Google AdWords.

The AdWords attributes for your bulk upload files are defined here. In addition to using these, you must already have an AdWords account connected to the Google Account you're using on Google Base, and your bulk upload file must be in the tab-delimited format. Learn more about using the advertising attributes.

 
Attribute Definitions

author
The author of the review.
Format:
Text.
Tab-delimited example:
John Steinbeck
XML example:
<g:author>John Steinbeck</g:author>
 
description
Text describing the review. Don't 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.
Format:
Text, up to a maximum length of 65,536 characters.
Tab-delimited example:
Read about Google Earth and its many features.
XML example:
<description>Read about Google Earth and its many features.</description>
 
expiration_date
The date that a review listing expires.
Format:
ISO 8601 format: YYYY-MM-DD.
Tab-delimited example:
2006-12-20
XML example:
<g:expiration_date>2006-12-20</g:expiration_date>
 
id
A unique alphanumeric identifier for the review - 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.
Format:
Text.
Tab-delimited example:
01flx
XML example:
<g:id>01flx</g:id>
 
image_link
The URL of an associated image for the review. Use your full-sized images; do not use 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.com/image1.jpg,http://www.example.com/image2.jpg
XML example:
<g:image_link>http://www.example.com/image1.jpg</g:image_link>
<g:image_link>http://www.example.com/image2.jpg</g:image_link>
 
link
The URL of the web page associated with the review. 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.com/asp/sp.asp?cat=12&id;=1030
XML example:
<link>http://www.example.com/asp/sp.asp?cat=12&amp;id=1030</link>
 
location
The location of the item reviewed.
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:
1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA
XML example:
<g:location>1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA</g:location>
 
name_of_item_reviewed
The name of the item being reviewed.
Format:
Text.
Tab-delimited example:
Google Earth
XML example:
<g:name_of_item_reviewed>Google Earth</g:name_of_item_reviewed>
 
publish_date
The date the review was published.
Format:
ISO 8601 format: YYYY-MM-DD.
Tab-delimited example:
2005-12-20
XML example:
<g:publish_date>2005-12-20</g:publish_date>
 
rating
The rating of the item reviewed.
Format:
Text.
Tab-delimited example:
5 stars
XML example:
<g:rating>5 stars</g:rating>
 
review_type
The category of the item being reviewed.
Format:
Text.
Tab-delimited example:
product
XML example:
<g:review_type>product</g:review_type>
 
reviewer_type
The type of rating being provided.
Format:
Acceptable values are: editorial (a review written by a member of your staff) or user (a review written by a user of your site).
Tab-delimited example:
editorial
XML example:
<g:reviewer_type>editorial</g:reviewer_type>
 
title
The name or title of the review.
Format:
Text. Maximum length of 80 characters. Commas are allowed.
Tab-delimited example:
Google Earth - Explore the World from your PC
XML example:
<title>Google Earth - Explore the World from your PC</title>
 
url_of_item_reviewed
The web page of the item being reviewed.
Format:
URL. (Must include the http:// portion.)
Tab-delimited example:
http://earth.google.com
XML example:
<g:url_of_item_reviewed>http://earth.google.com</g:url_of_item_reviewed>

> Register Bulk Upload


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