| // Package customsearch provides access to the CustomSearch API. |
| // |
| // See https://developers.google.com/custom-search/v1/using_rest |
| // |
| // Usage example: |
| // |
| // import "google.golang.org/api/customsearch/v1" |
| // ... |
| // customsearchService, err := customsearch.New(oauthHttpClient) |
| package customsearch |
| |
| import ( |
| "bytes" |
| "encoding/json" |
| "errors" |
| "fmt" |
| "golang.org/x/net/context" |
| "google.golang.org/api/googleapi" |
| "io" |
| "net/http" |
| "net/url" |
| "strconv" |
| "strings" |
| ) |
| |
| // Always reference these packages, just in case the auto-generated code |
| // below doesn't. |
| var _ = bytes.NewBuffer |
| var _ = strconv.Itoa |
| var _ = fmt.Sprintf |
| var _ = json.NewDecoder |
| var _ = io.Copy |
| var _ = url.Parse |
| var _ = googleapi.Version |
| var _ = errors.New |
| var _ = strings.Replace |
| var _ = context.Background |
| |
| const apiId = "customsearch:v1" |
| const apiName = "customsearch" |
| const apiVersion = "v1" |
| const basePath = "https://www.googleapis.com/customsearch/" |
| |
| func New(client *http.Client) (*Service, error) { |
| if client == nil { |
| return nil, errors.New("client is nil") |
| } |
| s := &Service{client: client, BasePath: basePath} |
| s.Cse = NewCseService(s) |
| return s, nil |
| } |
| |
| type Service struct { |
| client *http.Client |
| BasePath string // API endpoint base URL |
| |
| Cse *CseService |
| } |
| |
| func NewCseService(s *Service) *CseService { |
| rs := &CseService{s: s} |
| return rs |
| } |
| |
| type CseService struct { |
| s *Service |
| } |
| |
| type Context struct { |
| Facets [][]*ContextFacetsItem `json:"facets,omitempty"` |
| |
| Title string `json:"title,omitempty"` |
| } |
| |
| type ContextFacetsItem struct { |
| Anchor string `json:"anchor,omitempty"` |
| |
| Label string `json:"label,omitempty"` |
| |
| Label_with_op string `json:"label_with_op,omitempty"` |
| } |
| |
| type Promotion struct { |
| BodyLines []*PromotionBodyLines `json:"bodyLines,omitempty"` |
| |
| DisplayLink string `json:"displayLink,omitempty"` |
| |
| HtmlTitle string `json:"htmlTitle,omitempty"` |
| |
| Image *PromotionImage `json:"image,omitempty"` |
| |
| Link string `json:"link,omitempty"` |
| |
| Title string `json:"title,omitempty"` |
| } |
| |
| type PromotionBodyLines struct { |
| HtmlTitle string `json:"htmlTitle,omitempty"` |
| |
| Link string `json:"link,omitempty"` |
| |
| Title string `json:"title,omitempty"` |
| |
| Url string `json:"url,omitempty"` |
| } |
| |
| type PromotionImage struct { |
| Height int64 `json:"height,omitempty"` |
| |
| Source string `json:"source,omitempty"` |
| |
| Width int64 `json:"width,omitempty"` |
| } |
| |
| type Query struct { |
| Count int64 `json:"count,omitempty"` |
| |
| Cr string `json:"cr,omitempty"` |
| |
| Cref string `json:"cref,omitempty"` |
| |
| Cx string `json:"cx,omitempty"` |
| |
| DateRestrict string `json:"dateRestrict,omitempty"` |
| |
| DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` |
| |
| ExactTerms string `json:"exactTerms,omitempty"` |
| |
| ExcludeTerms string `json:"excludeTerms,omitempty"` |
| |
| FileType string `json:"fileType,omitempty"` |
| |
| Filter string `json:"filter,omitempty"` |
| |
| Gl string `json:"gl,omitempty"` |
| |
| GoogleHost string `json:"googleHost,omitempty"` |
| |
| HighRange string `json:"highRange,omitempty"` |
| |
| Hl string `json:"hl,omitempty"` |
| |
| Hq string `json:"hq,omitempty"` |
| |
| ImgColorType string `json:"imgColorType,omitempty"` |
| |
| ImgDominantColor string `json:"imgDominantColor,omitempty"` |
| |
| ImgSize string `json:"imgSize,omitempty"` |
| |
| ImgType string `json:"imgType,omitempty"` |
| |
| InputEncoding string `json:"inputEncoding,omitempty"` |
| |
| Language string `json:"language,omitempty"` |
| |
| LinkSite string `json:"linkSite,omitempty"` |
| |
| LowRange string `json:"lowRange,omitempty"` |
| |
| OrTerms string `json:"orTerms,omitempty"` |
| |
| OutputEncoding string `json:"outputEncoding,omitempty"` |
| |
| RelatedSite string `json:"relatedSite,omitempty"` |
| |
| Rights string `json:"rights,omitempty"` |
| |
| Safe string `json:"safe,omitempty"` |
| |
| SearchTerms string `json:"searchTerms,omitempty"` |
| |
| SearchType string `json:"searchType,omitempty"` |
| |
| SiteSearch string `json:"siteSearch,omitempty"` |
| |
| SiteSearchFilter string `json:"siteSearchFilter,omitempty"` |
| |
| Sort string `json:"sort,omitempty"` |
| |
| StartIndex int64 `json:"startIndex,omitempty"` |
| |
| StartPage int64 `json:"startPage,omitempty"` |
| |
| Title string `json:"title,omitempty"` |
| |
| TotalResults int64 `json:"totalResults,omitempty,string"` |
| } |
| |
| type Result struct { |
| CacheId string `json:"cacheId,omitempty"` |
| |
| DisplayLink string `json:"displayLink,omitempty"` |
| |
| FileFormat string `json:"fileFormat,omitempty"` |
| |
| FormattedUrl string `json:"formattedUrl,omitempty"` |
| |
| HtmlFormattedUrl string `json:"htmlFormattedUrl,omitempty"` |
| |
| HtmlSnippet string `json:"htmlSnippet,omitempty"` |
| |
| HtmlTitle string `json:"htmlTitle,omitempty"` |
| |
| Image *ResultImage `json:"image,omitempty"` |
| |
| Kind string `json:"kind,omitempty"` |
| |
| Labels []*ResultLabels `json:"labels,omitempty"` |
| |
| Link string `json:"link,omitempty"` |
| |
| Mime string `json:"mime,omitempty"` |
| |
| Pagemap *ResultPagemap `json:"pagemap,omitempty"` |
| |
| Snippet string `json:"snippet,omitempty"` |
| |
| Title string `json:"title,omitempty"` |
| } |
| |
| type ResultImage struct { |
| ByteSize int64 `json:"byteSize,omitempty"` |
| |
| ContextLink string `json:"contextLink,omitempty"` |
| |
| Height int64 `json:"height,omitempty"` |
| |
| ThumbnailHeight int64 `json:"thumbnailHeight,omitempty"` |
| |
| ThumbnailLink string `json:"thumbnailLink,omitempty"` |
| |
| ThumbnailWidth int64 `json:"thumbnailWidth,omitempty"` |
| |
| Width int64 `json:"width,omitempty"` |
| } |
| |
| type ResultLabels struct { |
| DisplayName string `json:"displayName,omitempty"` |
| |
| Label_with_op string `json:"label_with_op,omitempty"` |
| |
| Name string `json:"name,omitempty"` |
| } |
| |
| type ResultPagemap struct { |
| } |
| |
| type Search struct { |
| Context *Context `json:"context,omitempty"` |
| |
| Items []*Result `json:"items,omitempty"` |
| |
| Kind string `json:"kind,omitempty"` |
| |
| Promotions []*Promotion `json:"promotions,omitempty"` |
| |
| Queries map[string][]Query `json:"queries,omitempty"` |
| |
| SearchInformation *SearchSearchInformation `json:"searchInformation,omitempty"` |
| |
| Spelling *SearchSpelling `json:"spelling,omitempty"` |
| |
| Url *SearchUrl `json:"url,omitempty"` |
| } |
| |
| type SearchSearchInformation struct { |
| FormattedSearchTime string `json:"formattedSearchTime,omitempty"` |
| |
| FormattedTotalResults string `json:"formattedTotalResults,omitempty"` |
| |
| SearchTime float64 `json:"searchTime,omitempty"` |
| |
| TotalResults int64 `json:"totalResults,omitempty,string"` |
| } |
| |
| type SearchSpelling struct { |
| CorrectedQuery string `json:"correctedQuery,omitempty"` |
| |
| HtmlCorrectedQuery string `json:"htmlCorrectedQuery,omitempty"` |
| } |
| |
| type SearchUrl struct { |
| Template string `json:"template,omitempty"` |
| |
| Type string `json:"type,omitempty"` |
| } |
| |
| // method id "search.cse.list": |
| |
| type CseListCall struct { |
| s *Service |
| q string |
| opt_ map[string]interface{} |
| } |
| |
| // List: Returns metadata about the search performed, metadata about the |
| // custom search engine used for the search, and the search results. |
| func (r *CseService) List(q string) *CseListCall { |
| c := &CseListCall{s: r.s, opt_: make(map[string]interface{})} |
| c.q = q |
| return c |
| } |
| |
| // C2coff sets the optional parameter "c2coff": Turns off the |
| // translation between zh-CN and zh-TW. |
| func (c *CseListCall) C2coff(c2coff string) *CseListCall { |
| c.opt_["c2coff"] = c2coff |
| return c |
| } |
| |
| // Cr sets the optional parameter "cr": Country restrict(s). |
| func (c *CseListCall) Cr(cr string) *CseListCall { |
| c.opt_["cr"] = cr |
| return c |
| } |
| |
| // Cref sets the optional parameter "cref": The URL of a linked custom |
| // search engine |
| func (c *CseListCall) Cref(cref string) *CseListCall { |
| c.opt_["cref"] = cref |
| return c |
| } |
| |
| // Cx sets the optional parameter "cx": The custom search engine ID to |
| // scope this search query |
| func (c *CseListCall) Cx(cx string) *CseListCall { |
| c.opt_["cx"] = cx |
| return c |
| } |
| |
| // DateRestrict sets the optional parameter "dateRestrict": Specifies |
| // all search results are from a time period |
| func (c *CseListCall) DateRestrict(dateRestrict string) *CseListCall { |
| c.opt_["dateRestrict"] = dateRestrict |
| return c |
| } |
| |
| // ExactTerms sets the optional parameter "exactTerms": Identifies a |
| // phrase that all documents in the search results must contain |
| func (c *CseListCall) ExactTerms(exactTerms string) *CseListCall { |
| c.opt_["exactTerms"] = exactTerms |
| return c |
| } |
| |
| // ExcludeTerms sets the optional parameter "excludeTerms": Identifies a |
| // word or phrase that should not appear in any documents in the search |
| // results |
| func (c *CseListCall) ExcludeTerms(excludeTerms string) *CseListCall { |
| c.opt_["excludeTerms"] = excludeTerms |
| return c |
| } |
| |
| // FileType sets the optional parameter "fileType": Returns images of a |
| // specified type. Some of the allowed values are: bmp, gif, png, jpg, |
| // svg, pdf, ... |
| func (c *CseListCall) FileType(fileType string) *CseListCall { |
| c.opt_["fileType"] = fileType |
| return c |
| } |
| |
| // Filter sets the optional parameter "filter": Controls turning on or |
| // off the duplicate content filter. |
| func (c *CseListCall) Filter(filter string) *CseListCall { |
| c.opt_["filter"] = filter |
| return c |
| } |
| |
| // Gl sets the optional parameter "gl": Geolocation of end user. |
| func (c *CseListCall) Gl(gl string) *CseListCall { |
| c.opt_["gl"] = gl |
| return c |
| } |
| |
| // Googlehost sets the optional parameter "googlehost": The local Google |
| // domain to use to perform the search. |
| func (c *CseListCall) Googlehost(googlehost string) *CseListCall { |
| c.opt_["googlehost"] = googlehost |
| return c |
| } |
| |
| // HighRange sets the optional parameter "highRange": Creates a range in |
| // form as_nlo value..as_nhi value and attempts to append it to query |
| func (c *CseListCall) HighRange(highRange string) *CseListCall { |
| c.opt_["highRange"] = highRange |
| return c |
| } |
| |
| // Hl sets the optional parameter "hl": Sets the user interface |
| // language. |
| func (c *CseListCall) Hl(hl string) *CseListCall { |
| c.opt_["hl"] = hl |
| return c |
| } |
| |
| // Hq sets the optional parameter "hq": Appends the extra query terms to |
| // the query. |
| func (c *CseListCall) Hq(hq string) *CseListCall { |
| c.opt_["hq"] = hq |
| return c |
| } |
| |
| // ImgColorType sets the optional parameter "imgColorType": Returns |
| // black and white, grayscale, or color images: mono, gray, and color. |
| func (c *CseListCall) ImgColorType(imgColorType string) *CseListCall { |
| c.opt_["imgColorType"] = imgColorType |
| return c |
| } |
| |
| // ImgDominantColor sets the optional parameter "imgDominantColor": |
| // Returns images of a specific dominant color: yellow, green, teal, |
| // blue, purple, pink, white, gray, black and brown. |
| func (c *CseListCall) ImgDominantColor(imgDominantColor string) *CseListCall { |
| c.opt_["imgDominantColor"] = imgDominantColor |
| return c |
| } |
| |
| // ImgSize sets the optional parameter "imgSize": Returns images of a |
| // specified size, where size can be one of: icon, small, medium, large, |
| // xlarge, xxlarge, and huge. |
| func (c *CseListCall) ImgSize(imgSize string) *CseListCall { |
| c.opt_["imgSize"] = imgSize |
| return c |
| } |
| |
| // ImgType sets the optional parameter "imgType": Returns images of a |
| // type, which can be one of: clipart, face, lineart, news, and photo. |
| func (c *CseListCall) ImgType(imgType string) *CseListCall { |
| c.opt_["imgType"] = imgType |
| return c |
| } |
| |
| // LinkSite sets the optional parameter "linkSite": Specifies that all |
| // search results should contain a link to a particular URL |
| func (c *CseListCall) LinkSite(linkSite string) *CseListCall { |
| c.opt_["linkSite"] = linkSite |
| return c |
| } |
| |
| // LowRange sets the optional parameter "lowRange": Creates a range in |
| // form as_nlo value..as_nhi value and attempts to append it to query |
| func (c *CseListCall) LowRange(lowRange string) *CseListCall { |
| c.opt_["lowRange"] = lowRange |
| return c |
| } |
| |
| // Lr sets the optional parameter "lr": The language restriction for the |
| // search results |
| func (c *CseListCall) Lr(lr string) *CseListCall { |
| c.opt_["lr"] = lr |
| return c |
| } |
| |
| // Num sets the optional parameter "num": Number of search results to |
| // return |
| func (c *CseListCall) Num(num int64) *CseListCall { |
| c.opt_["num"] = num |
| return c |
| } |
| |
| // OrTerms sets the optional parameter "orTerms": Provides additional |
| // search terms to check for in a document, where each document in the |
| // search results must contain at least one of the additional search |
| // terms |
| func (c *CseListCall) OrTerms(orTerms string) *CseListCall { |
| c.opt_["orTerms"] = orTerms |
| return c |
| } |
| |
| // RelatedSite sets the optional parameter "relatedSite": Specifies that |
| // all search results should be pages that are related to the specified |
| // URL |
| func (c *CseListCall) RelatedSite(relatedSite string) *CseListCall { |
| c.opt_["relatedSite"] = relatedSite |
| return c |
| } |
| |
| // Rights sets the optional parameter "rights": Filters based on |
| // licensing. Supported values include: cc_publicdomain, cc_attribute, |
| // cc_sharealike, cc_noncommercial, cc_nonderived and combinations of |
| // these. |
| func (c *CseListCall) Rights(rights string) *CseListCall { |
| c.opt_["rights"] = rights |
| return c |
| } |
| |
| // Safe sets the optional parameter "safe": Search safety level |
| func (c *CseListCall) Safe(safe string) *CseListCall { |
| c.opt_["safe"] = safe |
| return c |
| } |
| |
| // SearchType sets the optional parameter "searchType": Specifies the |
| // search type: image. |
| func (c *CseListCall) SearchType(searchType string) *CseListCall { |
| c.opt_["searchType"] = searchType |
| return c |
| } |
| |
| // SiteSearch sets the optional parameter "siteSearch": Specifies all |
| // search results should be pages from a given site |
| func (c *CseListCall) SiteSearch(siteSearch string) *CseListCall { |
| c.opt_["siteSearch"] = siteSearch |
| return c |
| } |
| |
| // SiteSearchFilter sets the optional parameter "siteSearchFilter": |
| // Controls whether to include or exclude results from the site named in |
| // the as_sitesearch parameter |
| func (c *CseListCall) SiteSearchFilter(siteSearchFilter string) *CseListCall { |
| c.opt_["siteSearchFilter"] = siteSearchFilter |
| return c |
| } |
| |
| // Sort sets the optional parameter "sort": The sort expression to apply |
| // to the results |
| func (c *CseListCall) Sort(sort string) *CseListCall { |
| c.opt_["sort"] = sort |
| return c |
| } |
| |
| // Start sets the optional parameter "start": The index of the first |
| // result to return |
| func (c *CseListCall) Start(start int64) *CseListCall { |
| c.opt_["start"] = start |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. |
| // See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *CseListCall) Fields(s ...googleapi.Field) *CseListCall { |
| c.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *CseListCall) Do() (*Search, error) { |
| var body io.Reader = nil |
| params := make(url.Values) |
| params.Set("alt", "json") |
| params.Set("q", fmt.Sprintf("%v", c.q)) |
| if v, ok := c.opt_["c2coff"]; ok { |
| params.Set("c2coff", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["cr"]; ok { |
| params.Set("cr", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["cref"]; ok { |
| params.Set("cref", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["cx"]; ok { |
| params.Set("cx", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["dateRestrict"]; ok { |
| params.Set("dateRestrict", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["exactTerms"]; ok { |
| params.Set("exactTerms", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["excludeTerms"]; ok { |
| params.Set("excludeTerms", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["fileType"]; ok { |
| params.Set("fileType", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["filter"]; ok { |
| params.Set("filter", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["gl"]; ok { |
| params.Set("gl", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["googlehost"]; ok { |
| params.Set("googlehost", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["highRange"]; ok { |
| params.Set("highRange", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["hl"]; ok { |
| params.Set("hl", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["hq"]; ok { |
| params.Set("hq", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["imgColorType"]; ok { |
| params.Set("imgColorType", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["imgDominantColor"]; ok { |
| params.Set("imgDominantColor", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["imgSize"]; ok { |
| params.Set("imgSize", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["imgType"]; ok { |
| params.Set("imgType", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["linkSite"]; ok { |
| params.Set("linkSite", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["lowRange"]; ok { |
| params.Set("lowRange", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["lr"]; ok { |
| params.Set("lr", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["num"]; ok { |
| params.Set("num", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["orTerms"]; ok { |
| params.Set("orTerms", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["relatedSite"]; ok { |
| params.Set("relatedSite", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["rights"]; ok { |
| params.Set("rights", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["safe"]; ok { |
| params.Set("safe", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["searchType"]; ok { |
| params.Set("searchType", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["siteSearch"]; ok { |
| params.Set("siteSearch", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["siteSearchFilter"]; ok { |
| params.Set("siteSearchFilter", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["sort"]; ok { |
| params.Set("sort", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["start"]; ok { |
| params.Set("start", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "v1") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("GET", urls, body) |
| googleapi.SetOpaque(req.URL) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *Search |
| if err := json.NewDecoder(res.Body).Decode(&ret); err != nil { |
| return nil, err |
| } |
| return ret, nil |
| // { |
| // "description": "Returns metadata about the search performed, metadata about the custom search engine used for the search, and the search results.", |
| // "httpMethod": "GET", |
| // "id": "search.cse.list", |
| // "parameterOrder": [ |
| // "q" |
| // ], |
| // "parameters": { |
| // "c2coff": { |
| // "description": "Turns off the translation between zh-CN and zh-TW.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "cr": { |
| // "description": "Country restrict(s).", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "cref": { |
| // "description": "The URL of a linked custom search engine", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "cx": { |
| // "description": "The custom search engine ID to scope this search query", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "dateRestrict": { |
| // "description": "Specifies all search results are from a time period", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "exactTerms": { |
| // "description": "Identifies a phrase that all documents in the search results must contain", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "excludeTerms": { |
| // "description": "Identifies a word or phrase that should not appear in any documents in the search results", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "fileType": { |
| // "description": "Returns images of a specified type. Some of the allowed values are: bmp, gif, png, jpg, svg, pdf, ...", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "filter": { |
| // "description": "Controls turning on or off the duplicate content filter.", |
| // "enum": [ |
| // "0", |
| // "1" |
| // ], |
| // "enumDescriptions": [ |
| // "Turns off duplicate content filter.", |
| // "Turns on duplicate content filter." |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "gl": { |
| // "description": "Geolocation of end user.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "googlehost": { |
| // "description": "The local Google domain to use to perform the search.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "highRange": { |
| // "description": "Creates a range in form as_nlo value..as_nhi value and attempts to append it to query", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "hl": { |
| // "description": "Sets the user interface language.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "hq": { |
| // "description": "Appends the extra query terms to the query.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "imgColorType": { |
| // "description": "Returns black and white, grayscale, or color images: mono, gray, and color.", |
| // "enum": [ |
| // "color", |
| // "gray", |
| // "mono" |
| // ], |
| // "enumDescriptions": [ |
| // "color", |
| // "gray", |
| // "mono" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "imgDominantColor": { |
| // "description": "Returns images of a specific dominant color: yellow, green, teal, blue, purple, pink, white, gray, black and brown.", |
| // "enum": [ |
| // "black", |
| // "blue", |
| // "brown", |
| // "gray", |
| // "green", |
| // "pink", |
| // "purple", |
| // "teal", |
| // "white", |
| // "yellow" |
| // ], |
| // "enumDescriptions": [ |
| // "black", |
| // "blue", |
| // "brown", |
| // "gray", |
| // "green", |
| // "pink", |
| // "purple", |
| // "teal", |
| // "white", |
| // "yellow" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "imgSize": { |
| // "description": "Returns images of a specified size, where size can be one of: icon, small, medium, large, xlarge, xxlarge, and huge.", |
| // "enum": [ |
| // "huge", |
| // "icon", |
| // "large", |
| // "medium", |
| // "small", |
| // "xlarge", |
| // "xxlarge" |
| // ], |
| // "enumDescriptions": [ |
| // "huge", |
| // "icon", |
| // "large", |
| // "medium", |
| // "small", |
| // "xlarge", |
| // "xxlarge" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "imgType": { |
| // "description": "Returns images of a type, which can be one of: clipart, face, lineart, news, and photo.", |
| // "enum": [ |
| // "clipart", |
| // "face", |
| // "lineart", |
| // "news", |
| // "photo" |
| // ], |
| // "enumDescriptions": [ |
| // "clipart", |
| // "face", |
| // "lineart", |
| // "news", |
| // "photo" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "linkSite": { |
| // "description": "Specifies that all search results should contain a link to a particular URL", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "lowRange": { |
| // "description": "Creates a range in form as_nlo value..as_nhi value and attempts to append it to query", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "lr": { |
| // "description": "The language restriction for the search results", |
| // "enum": [ |
| // "lang_ar", |
| // "lang_bg", |
| // "lang_ca", |
| // "lang_cs", |
| // "lang_da", |
| // "lang_de", |
| // "lang_el", |
| // "lang_en", |
| // "lang_es", |
| // "lang_et", |
| // "lang_fi", |
| // "lang_fr", |
| // "lang_hr", |
| // "lang_hu", |
| // "lang_id", |
| // "lang_is", |
| // "lang_it", |
| // "lang_iw", |
| // "lang_ja", |
| // "lang_ko", |
| // "lang_lt", |
| // "lang_lv", |
| // "lang_nl", |
| // "lang_no", |
| // "lang_pl", |
| // "lang_pt", |
| // "lang_ro", |
| // "lang_ru", |
| // "lang_sk", |
| // "lang_sl", |
| // "lang_sr", |
| // "lang_sv", |
| // "lang_tr", |
| // "lang_zh-CN", |
| // "lang_zh-TW" |
| // ], |
| // "enumDescriptions": [ |
| // "Arabic", |
| // "Bulgarian", |
| // "Catalan", |
| // "Czech", |
| // "Danish", |
| // "German", |
| // "Greek", |
| // "English", |
| // "Spanish", |
| // "Estonian", |
| // "Finnish", |
| // "French", |
| // "Croatian", |
| // "Hungarian", |
| // "Indonesian", |
| // "Icelandic", |
| // "Italian", |
| // "Hebrew", |
| // "Japanese", |
| // "Korean", |
| // "Lithuanian", |
| // "Latvian", |
| // "Dutch", |
| // "Norwegian", |
| // "Polish", |
| // "Portuguese", |
| // "Romanian", |
| // "Russian", |
| // "Slovak", |
| // "Slovenian", |
| // "Serbian", |
| // "Swedish", |
| // "Turkish", |
| // "Chinese (Simplified)", |
| // "Chinese (Traditional)" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "num": { |
| // "default": "10", |
| // "description": "Number of search results to return", |
| // "format": "uint32", |
| // "location": "query", |
| // "type": "integer" |
| // }, |
| // "orTerms": { |
| // "description": "Provides additional search terms to check for in a document, where each document in the search results must contain at least one of the additional search terms", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "q": { |
| // "description": "Query", |
| // "location": "query", |
| // "required": true, |
| // "type": "string" |
| // }, |
| // "relatedSite": { |
| // "description": "Specifies that all search results should be pages that are related to the specified URL", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "rights": { |
| // "description": "Filters based on licensing. Supported values include: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived and combinations of these.", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "safe": { |
| // "default": "off", |
| // "description": "Search safety level", |
| // "enum": [ |
| // "high", |
| // "medium", |
| // "off" |
| // ], |
| // "enumDescriptions": [ |
| // "Enables highest level of safe search filtering.", |
| // "Enables moderate safe search filtering.", |
| // "Disables safe search filtering." |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "searchType": { |
| // "description": "Specifies the search type: image.", |
| // "enum": [ |
| // "image" |
| // ], |
| // "enumDescriptions": [ |
| // "custom image search" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "siteSearch": { |
| // "description": "Specifies all search results should be pages from a given site", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "siteSearchFilter": { |
| // "description": "Controls whether to include or exclude results from the site named in the as_sitesearch parameter", |
| // "enum": [ |
| // "e", |
| // "i" |
| // ], |
| // "enumDescriptions": [ |
| // "exclude", |
| // "include" |
| // ], |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "sort": { |
| // "description": "The sort expression to apply to the results", |
| // "location": "query", |
| // "type": "string" |
| // }, |
| // "start": { |
| // "description": "The index of the first result to return", |
| // "format": "uint32", |
| // "location": "query", |
| // "type": "integer" |
| // } |
| // }, |
| // "path": "v1", |
| // "response": { |
| // "$ref": "Search" |
| // } |
| // } |
| |
| } |