beautypg.com

Requesting meta tag values – Google Search Appliance Protocol Reference User Manual

Page 42

background image

Google Search Appliance: Search Protocol Reference

Request Format

42

At search time, if the encoded value of the search attribute (requiredfields, partialfields, inmeta)
plus the attr:value is greater than 121, then the search won't produce any results. For example, the
following meta tag value is not searchable because the encoded value of the search attribute plus the
combination of attr:value is greater than 121 characters:

content="12345678901234567890123456789012345678901234567890123456789012345678901
2345678901234567890123456789012345678901234567890"/>

In the following example, the term 1234 would be searchable using a partialfields or inmeta request, as
the attr:value meets the 121 character limit:

This section describes the following methods of using meta data:

Requesting meta tag values using the getfields parameter (see “Requesting Meta Tag Values” on
page 42)

Filtering by meta tags using the requiredfields or partialfields parameters (see “Filtering by
Meta Tags” on page 43)

“Using inmeta to Filter by Meta Tags” on page 47

Requesting Meta Tag Values

Use the getfields parameter in a search request to specify meta tag values to return with the search
results. The search engine returns only meta tag information for results that actually contain the meta
tags. The search for meta tags is case-insensitive. Use only whole words in the getfields parameter,
not partial words or word “stems.” There are limits to the number of characters returned for each meta
tag when using getfields. The character limits include the meta tag name and content. These are the
limits:

For Latin characters: name + value = 1500 characters; chars_AND_name <= 1500/2

For characters in multibyte languages (Japanese, Chinese, and Korean): 500 characters

Usage

GET /search?q=[search term]&output=xml&client=test&site=test&getfields=[meta tag
name]

Example

The following search request returns the first 10 results that match the query “books” in the “test”
collection:

GET /
search?q=books&output=xml&client=[test]&site=[test]&getfields=author.title.keywo
rds