customsearch

package
v0.30.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 4, 2020 License: BSD-3-Clause Imports: 15 Imported by: 75

Documentation

Overview

Package customsearch provides access to the Custom Search API.

For product documentation, see: https://developers.google.com/custom-search/v1/introduction

Creating a client

Usage example: 

import "google.golang.org/api/customsearch/v1"
...
ctx := context.Background()
customsearchService, err := customsearch.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication.

For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: 

customsearchService, err := customsearch.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource: 

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
customsearchService, err := customsearch.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See https://godoc.org/google.golang.org/api/option/ for details on options.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type CseListCall 

type CseListCall struct {
	// contains filtered or unexported fields
}

func (*CseListCall) C2coff 

func (c *CseListCall) C2coff(c2coff string) *CseListCall

C2coff sets the optional parameter "c2coff": Enables or disables [Simplified and Traditional Chinese Search](https://developers.google.com/custom-search/docs/xml_r esults#chineseSearch).

The default value for this parameter is 0 (zero), meaning that the feature is enabled. Supported values are:

* `1`: Disabled

* `0`: Enabled (default)

func (*CseListCall) Context 

func (c *CseListCall) Context(ctx context.Context) *CseListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*CseListCall) Cr 

func (c *CseListCall) Cr(cr string) *CseListCall

Cr sets the optional parameter "cr": Restricts search results to documents originating in a particular country. You may use [Boolean operators](https://developers.google.com/custom-search/docs/x ml_results_appendices#booleanOperators) in the cr parameter's value.

Google Search determines the country of a document by analyzing:

* the top-level domain (TLD) of the document's URL

* the geographic location of the Web server's IP address

See the [Country Parameter Values](https://developers.google.com/custom-search/docs/xml _results_appendices#countryCollections) page for a list of valid values for this parameter.

func (*CseListCall) Cx 

func (c *CseListCall) Cx(cx string) *CseListCall

Cx sets the optional parameter "cx": The Programmable Search Engine ID to use for this request.

func (*CseListCall) DateRestrict 

func (c *CseListCall) DateRestrict(dateRestrict string) *CseListCall

DateRestrict sets the optional parameter "dateRestrict": Restricts results to URLs based on date. Supported values include:

* `d[number]`: requests results from the specified number of past days.

* `w[number]`: requests results from the specified number of past weeks.

* `m[number]`: requests results from the specified number of past months.

* `y[number]`: requests results from the specified number of past years.

func (*CseListCall) Do 

func (c *CseListCall) Do(opts ...googleapi.CallOption) (*Search, error)

Do executes the "search.cse.list" call. Exactly one of *Search or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Search.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*CseListCall) ExactTerms 

func (c *CseListCall) ExactTerms(exactTerms string) *CseListCall

ExactTerms sets the optional parameter "exactTerms": Identifies a phrase that all documents in the search results must contain.

func (*CseListCall) ExcludeTerms 

func (c *CseListCall) ExcludeTerms(excludeTerms string) *CseListCall

ExcludeTerms sets the optional parameter "excludeTerms": Identifies a word or phrase that should not appear in any documents in the search results.

func (*CseListCall) Fields 

func (c *CseListCall) Fields(s ...googleapi.Field) *CseListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*CseListCall) FileType 

func (c *CseListCall) FileType(fileType string) *CseListCall

FileType sets the optional parameter "fileType": Restricts results to files of a specified extension. A list of file types indexable by Google can be found in Search Console [Help Center](https://support.google.com/webmasters/answer/35287).

func (*CseListCall) Filter 

func (c *CseListCall) Filter(filter string) *CseListCall

Filter sets the optional parameter "filter": Controls turning on or off the duplicate content filter.

* See [Automatic Filtering](https://developers.google.com/custom-search/docs /xml_results#automaticFiltering) for more information about Google's search results filters. Note that host crowding filtering applies only to multi-site searches.

* By default, Google applies filtering to all search results to improve the quality of those results.

Acceptable values are:

* `0`: Turns off duplicate content filter.

* `1`: Turns on duplicate content filter.

func (*CseListCall) Gl 

func (c *CseListCall) Gl(gl string) *CseListCall

Gl sets the optional parameter "gl": Geolocation of end user.

* The `gl` parameter value is a two-letter country code. The `gl` parameter boosts search results whose country of origin matches the parameter value. See the [Country Codes](https://developers.google.com/custom-search/docs/xml_r esults_appendices#countryCodes) page for a list of valid values.

* Specifying a `gl` parameter value should lead to more relevant results. This is particularly true for international customers and, even more specifically, for customers in English- speaking countries other than the United States.

func (*CseListCall) Googlehost 

func (c *CseListCall) Googlehost(googlehost string) *CseListCall

Googlehost sets the optional parameter "googlehost": **Deprecated**. Use the `gl` parameter for a similar effect.

The local Google domain (for example, google.com, google.de, or google.fr) to use to perform the search.

func (*CseListCall) Header 

func (c *CseListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*CseListCall) HighRange 

func (c *CseListCall) HighRange(highRange string) *CseListCall

HighRange sets the optional parameter "highRange": Specifies the ending value for a search range.

* Use `lowRange` and `highRange` to append an inclusive search range of `lowRange...highRange` to the query.

func (*CseListCall) Hl 

func (c *CseListCall) Hl(hl string) *CseListCall

Hl sets the optional parameter "hl": Sets the user interface language.

* Explicitly setting this parameter improves the performance and the quality of your search results.

* See the [Interface Languages](https://developers.google.com/custom-search/docs /xml_results#wsInterfaceLanguages) section of [Internationalizing Queries and Results Presentation](https://developers.google.com/custom-search/docs /xml_results#wsInternationalizing) for more information, and (Supported Interface Languages)[https://developers.google.com/custom-search/docs/ xml_results_appendices#interfaceLanguages] for a list of supported languages.

func (*CseListCall) Hq 

func (c *CseListCall) Hq(hq string) *CseListCall

Hq sets the optional parameter "hq": Appends the specified query terms to the query, as if they were combined with a logical AND operator.

func (*CseListCall) IfNoneMatch 

func (c *CseListCall) IfNoneMatch(entityTag string) *CseListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*CseListCall) ImgColorType 

func (c *CseListCall) ImgColorType(imgColorType string) *CseListCall

ImgColorType sets the optional parameter "imgColorType": Returns black and white, grayscale, transparent, or color images. Acceptable values are:

* "color"

* "gray"

* "mono": black and white

* "trans": transparent background

Possible values: 

"imgColorTypeUndefined"
"mono"
"gray"
"color"
"trans"

func (*CseListCall) ImgDominantColor 

func (c *CseListCall) ImgDominantColor(imgDominantColor string) *CseListCall

ImgDominantColor sets the optional parameter "imgDominantColor": Returns images of a specific dominant color. Acceptable values are:

* "black"

* "blue"

* "brown"

* "gray"

* "green"

* "orange"

* "pink"

* "purple"

* "red"

* "teal"

* "white"

* "yellow"

Possible values: 

"imgDominantColorUndefined"
"black"
"blue"
"brown"
"gray"
"green"
"orange"
"pink"
"purple"
"red"
"teal"
"white"
"yellow"

func (*CseListCall) ImgSize 

func (c *CseListCall) ImgSize(imgSize string) *CseListCall

ImgSize sets the optional parameter "imgSize": Returns images of a specified size. Acceptable values are:

* "huge"

* "icon"

* "large"

* "medium"

* "small"

* "xlarge"

* "xxlarge"

Possible values: 

"imgSizeUndefined"
"HUGE"
"ICON"
"LARGE"
"MEDIUM"
"SMALL"
"XLARGE"
"XXLARGE"

func (*CseListCall) ImgType 

func (c *CseListCall) ImgType(imgType string) *CseListCall

ImgType sets the optional parameter "imgType": Returns images of a type. Acceptable values are:

* "clipart"

* "face"

* "lineart"

* "stock"

* "photo"

* "animated"

Possible values: 

"imgTypeUndefined"
"clipart"
"face"
"lineart"
"stock"
"photo"
"animated"

func (*CseListCall) LinkSite 

func (c *CseListCall) LinkSite(linkSite string) *CseListCall

LinkSite sets the optional parameter "linkSite": Specifies that all search results should contain a link to a particular URL.

func (*CseListCall) LowRange 

func (c *CseListCall) LowRange(lowRange string) *CseListCall

LowRange sets the optional parameter "lowRange": Specifies the starting value for a search range. Use `lowRange` and `highRange` to append an inclusive search range of `lowRange...highRange` to the query.

func (*CseListCall) Lr 

func (c *CseListCall) Lr(lr string) *CseListCall

Lr sets the optional parameter "lr": Restricts the search to documents written in a particular language (e.g., `lr=lang_ja`).

Acceptable values are:

* "lang_ar": Arabic

* "lang_bg": Bulgarian

* "lang_ca": Catalan

* "lang_cs": Czech

* "lang_da": Danish

* "lang_de": German

* "lang_el": Greek

* "lang_en": English

* "lang_es": Spanish

* "lang_et": Estonian

* "lang_fi": Finnish

* "lang_fr": French

* "lang_hr": Croatian

* "lang_hu": Hungarian

* "lang_id": Indonesian

* "lang_is": Icelandic

* "lang_it": Italian

* "lang_iw": Hebrew

* "lang_ja": Japanese

* "lang_ko": Korean

* "lang_lt": Lithuanian

* "lang_lv": Latvian

* "lang_nl": Dutch

* "lang_no": Norwegian

* "lang_pl": Polish

* "lang_pt": Portuguese

* "lang_ro": Romanian

* "lang_ru": Russian

* "lang_sk": Slovak

* "lang_sl": Slovenian

* "lang_sr": Serbian

* "lang_sv": Swedish

* "lang_tr": Turkish

* "lang_zh-CN": Chinese (Simplified)

* "lang_zh-TW": Chinese (Traditional)

func (*CseListCall) Num 

func (c *CseListCall) Num(num int64) *CseListCall

Num sets the optional parameter "num": Number of search results to return.

* Valid values are integers between 1 and 10, inclusive.

func (*CseListCall) OrTerms 

func (c *CseListCall) OrTerms(orTerms string) *CseListCall

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 (*CseListCall) Q added in v0.22.0 

func (c *CseListCall) Q(q string) *CseListCall

Q sets the optional parameter "q": Query

func (*CseListCall) RelatedSite 

func (c *CseListCall) RelatedSite(relatedSite string) *CseListCall

RelatedSite sets the optional parameter "relatedSite": Specifies that all search results should be pages that are related to the specified URL.

func (*CseListCall) Rights 

func (c *CseListCall) Rights(rights string) *CseListCall

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. See [typical combinations](https://wiki.creativecommons.org/wiki/CC_Search _integration).

func (*CseListCall) Safe 

func (c *CseListCall) Safe(safe string) *CseListCall

Safe sets the optional parameter "safe": Search safety level. Acceptable values are:

* "active": Enables SafeSearch filtering.

* "off": Disables SafeSearch filtering. (default)

Possible values: 

"safeUndefined"
"active"
"high"
"medium"
"off"

func (*CseListCall) SearchType 

func (c *CseListCall) SearchType(searchType string) *CseListCall

SearchType sets the optional parameter "searchType": Specifies the search type: `image`. If unspecified, results are limited to webpages.

Acceptable values are:

* "image": custom image search.

Possible values: 

"searchTypeUndefined"
"image"

func (*CseListCall) SiteSearch 

func (c *CseListCall) SiteSearch(siteSearch string) *CseListCall

SiteSearch sets the optional parameter "siteSearch": Specifies a given site which should always be included or excluded from results (see `siteSearchFilter` parameter, below).

func (*CseListCall) SiteSearchFilter 

func (c *CseListCall) SiteSearchFilter(siteSearchFilter string) *CseListCall

SiteSearchFilter sets the optional parameter "siteSearchFilter": Controls whether to include or exclude results from the site named in the `siteSearch` parameter.

Acceptable values are:

* "e": exclude

* "i": include

Possible values: 

"siteSearchFilterUndefined"
"e"
"i"

func (*CseListCall) Sort 

func (c *CseListCall) Sort(sort string) *CseListCall

Sort sets the optional parameter "sort": The sort expression to apply to the results. The sort parameter specifies that the results be sorted according to the specified expression i.e. sort by date. [Example: sort=date](https://developers.google.com/custom-search /docs/structured_search#sort-by-attribute).

func (*CseListCall) Start 

func (c *CseListCall) Start(start int64) *CseListCall

Start sets the optional parameter "start": The index of the first result to return. The default number of results per page is 10, so `&start=11` would start at the top of the second page of results. **Note**: The JSON API will never return more than 100 results, even if more than 100 documents match the query, so setting the sum of `start + num` to a number greater than 100 will produce an error. Also note that the maximum value for `num` is 10.

type CseService 

type CseService struct {
	Siterestrict *CseSiterestrictService
	// contains filtered or unexported fields
}

func NewCseService 

func NewCseService(s *Service) *CseService

func (*CseService) List 

func (r *CseService) List() *CseListCall

List: Returns metadata about the search performed, metadata about the engine used for the search, and the search results.

type CseSiterestrictListCall 

type CseSiterestrictListCall struct {
	// contains filtered or unexported fields
}

func (*CseSiterestrictListCall) C2coff 

func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall

C2coff sets the optional parameter "c2coff": Enables or disables [Simplified and Traditional Chinese Search](https://developers.google.com/custom-search/docs/xml_r esults#chineseSearch).

The default value for this parameter is 0 (zero), meaning that the feature is enabled. Supported values are:

* `1`: Disabled

* `0`: Enabled (default)

func (*CseSiterestrictListCall) Context 

func (c *CseSiterestrictListCall) Context(ctx context.Context) *CseSiterestrictListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*CseSiterestrictListCall) Cr 

func (c *CseSiterestrictListCall) Cr(cr string) *CseSiterestrictListCall

Cr sets the optional parameter "cr": Restricts search results to documents originating in a particular country. You may use [Boolean operators](https://developers.google.com/custom-search/docs/x ml_results_appendices#booleanOperators) in the cr parameter's value.

Google Search determines the country of a document by analyzing:

* the top-level domain (TLD) of the document's URL

* the geographic location of the Web server's IP address

See the [Country Parameter Values](https://developers.google.com/custom-search/docs/xml _results_appendices#countryCollections) page for a list of valid values for this parameter.

func (*CseSiterestrictListCall) Cx 

func (c *CseSiterestrictListCall) Cx(cx string) *CseSiterestrictListCall

Cx sets the optional parameter "cx": The Programmable Search Engine ID to use for this request.

func (*CseSiterestrictListCall) DateRestrict 

func (c *CseSiterestrictListCall) DateRestrict(dateRestrict string) *CseSiterestrictListCall

DateRestrict sets the optional parameter "dateRestrict": Restricts results to URLs based on date. Supported values include:

* `d[number]`: requests results from the specified number of past days.

* `w[number]`: requests results from the specified number of past weeks.

* `m[number]`: requests results from the specified number of past months.

* `y[number]`: requests results from the specified number of past years.

func (*CseSiterestrictListCall) Do 

func (c *CseSiterestrictListCall) Do(opts ...googleapi.CallOption) (*Search, error)

Do executes the "search.cse.siterestrict.list" call. Exactly one of *Search or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Search.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*CseSiterestrictListCall) ExactTerms 

func (c *CseSiterestrictListCall) ExactTerms(exactTerms string) *CseSiterestrictListCall

ExactTerms sets the optional parameter "exactTerms": Identifies a phrase that all documents in the search results must contain.

func (*CseSiterestrictListCall) ExcludeTerms 

func (c *CseSiterestrictListCall) ExcludeTerms(excludeTerms string) *CseSiterestrictListCall

ExcludeTerms sets the optional parameter "excludeTerms": Identifies a word or phrase that should not appear in any documents in the search results.

func (*CseSiterestrictListCall) Fields 

func (c *CseSiterestrictListCall) Fields(s ...googleapi.Field) *CseSiterestrictListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*CseSiterestrictListCall) FileType 

func (c *CseSiterestrictListCall) FileType(fileType string) *CseSiterestrictListCall

FileType sets the optional parameter "fileType": Restricts results to files of a specified extension. A list of file types indexable by Google can be found in Search Console [Help Center](https://support.google.com/webmasters/answer/35287).

func (*CseSiterestrictListCall) Filter 

func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall

Filter sets the optional parameter "filter": Controls turning on or off the duplicate content filter.

* See [Automatic Filtering](https://developers.google.com/custom-search/docs /xml_results#automaticFiltering) for more information about Google's search results filters. Note that host crowding filtering applies only to multi-site searches.

* By default, Google applies filtering to all search results to improve the quality of those results.

Acceptable values are:

* `0`: Turns off duplicate content filter.

* `1`: Turns on duplicate content filter.

func (*CseSiterestrictListCall) Gl 

func (c *CseSiterestrictListCall) Gl(gl string) *CseSiterestrictListCall

Gl sets the optional parameter "gl": Geolocation of end user.

* The `gl` parameter value is a two-letter country code. The `gl` parameter boosts search results whose country of origin matches the parameter value. See the [Country Codes](https://developers.google.com/custom-search/docs/xml_r esults_appendices#countryCodes) page for a list of valid values.

* Specifying a `gl` parameter value should lead to more relevant results. This is particularly true for international customers and, even more specifically, for customers in English- speaking countries other than the United States.

func (*CseSiterestrictListCall) Googlehost 

func (c *CseSiterestrictListCall) Googlehost(googlehost string) *CseSiterestrictListCall

Googlehost sets the optional parameter "googlehost": **Deprecated**. Use the `gl` parameter for a similar effect.

The local Google domain (for example, google.com, google.de, or google.fr) to use to perform the search.

func (*CseSiterestrictListCall) Header 

func (c *CseSiterestrictListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*CseSiterestrictListCall) HighRange 

func (c *CseSiterestrictListCall) HighRange(highRange string) *CseSiterestrictListCall

HighRange sets the optional parameter "highRange": Specifies the ending value for a search range.

* Use `lowRange` and `highRange` to append an inclusive search range of `lowRange...highRange` to the query.

func (*CseSiterestrictListCall) Hl 

func (c *CseSiterestrictListCall) Hl(hl string) *CseSiterestrictListCall

Hl sets the optional parameter "hl": Sets the user interface language.

* Explicitly setting this parameter improves the performance and the quality of your search results.

* See the [Interface Languages](https://developers.google.com/custom-search/docs /xml_results#wsInterfaceLanguages) section of [Internationalizing Queries and Results Presentation](https://developers.google.com/custom-search/docs /xml_results#wsInternationalizing) for more information, and (Supported Interface Languages)[https://developers.google.com/custom-search/docs/ xml_results_appendices#interfaceLanguages] for a list of supported languages.

func (*CseSiterestrictListCall) Hq 

func (c *CseSiterestrictListCall) Hq(hq string) *CseSiterestrictListCall

Hq sets the optional parameter "hq": Appends the specified query terms to the query, as if they were combined with a logical AND operator.

func (*CseSiterestrictListCall) IfNoneMatch 

func (c *CseSiterestrictListCall) IfNoneMatch(entityTag string) *CseSiterestrictListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*CseSiterestrictListCall) ImgColorType 

func (c *CseSiterestrictListCall) ImgColorType(imgColorType string) *CseSiterestrictListCall

ImgColorType sets the optional parameter "imgColorType": Returns black and white, grayscale, transparent, or color images. Acceptable values are:

* "color"

* "gray"

* "mono": black and white

* "trans": transparent background

Possible values: 

"imgColorTypeUndefined"
"mono"
"gray"
"color"
"trans"

func (*CseSiterestrictListCall) ImgDominantColor 

func (c *CseSiterestrictListCall) ImgDominantColor(imgDominantColor string) *CseSiterestrictListCall

ImgDominantColor sets the optional parameter "imgDominantColor": Returns images of a specific dominant color. Acceptable values are:

* "black"

* "blue"

* "brown"

* "gray"

* "green"

* "orange"

* "pink"

* "purple"

* "red"

* "teal"

* "white"

* "yellow"

Possible values: 

"imgDominantColorUndefined"
"black"
"blue"
"brown"
"gray"
"green"
"orange"
"pink"
"purple"
"red"
"teal"
"white"
"yellow"

func (*CseSiterestrictListCall) ImgSize 

func (c *CseSiterestrictListCall) ImgSize(imgSize string) *CseSiterestrictListCall

ImgSize sets the optional parameter "imgSize": Returns images of a specified size. Acceptable values are:

* "huge"

* "icon"

* "large"

* "medium"

* "small"

* "xlarge"

* "xxlarge"

Possible values: 

"imgSizeUndefined"
"HUGE"
"ICON"
"LARGE"
"MEDIUM"
"SMALL"
"XLARGE"
"XXLARGE"

func (*CseSiterestrictListCall) ImgType 

func (c *CseSiterestrictListCall) ImgType(imgType string) *CseSiterestrictListCall

ImgType sets the optional parameter "imgType": Returns images of a type. Acceptable values are:

* "clipart"

* "face"

* "lineart"

* "stock"

* "photo"

* "animated"

Possible values: 

"imgTypeUndefined"
"clipart"
"face"
"lineart"
"stock"
"photo"
"animated"

func (*CseSiterestrictListCall) LinkSite 

func (c *CseSiterestrictListCall) LinkSite(linkSite string) *CseSiterestrictListCall

LinkSite sets the optional parameter "linkSite": Specifies that all search results should contain a link to a particular URL.

func (*CseSiterestrictListCall) LowRange 

func (c *CseSiterestrictListCall) LowRange(lowRange string) *CseSiterestrictListCall

LowRange sets the optional parameter "lowRange": Specifies the starting value for a search range. Use `lowRange` and `highRange` to append an inclusive search range of `lowRange...highRange` to the query.

func (*CseSiterestrictListCall) Lr 

func (c *CseSiterestrictListCall) Lr(lr string) *CseSiterestrictListCall

Lr sets the optional parameter "lr": Restricts the search to documents written in a particular language (e.g., `lr=lang_ja`).

Acceptable values are:

* "lang_ar": Arabic

* "lang_bg": Bulgarian

* "lang_ca": Catalan

* "lang_cs": Czech

* "lang_da": Danish

* "lang_de": German

* "lang_el": Greek

* "lang_en": English

* "lang_es": Spanish

* "lang_et": Estonian

* "lang_fi": Finnish

* "lang_fr": French

* "lang_hr": Croatian

* "lang_hu": Hungarian

* "lang_id": Indonesian

* "lang_is": Icelandic

* "lang_it": Italian

* "lang_iw": Hebrew

* "lang_ja": Japanese

* "lang_ko": Korean

* "lang_lt": Lithuanian

* "lang_lv": Latvian

* "lang_nl": Dutch

* "lang_no": Norwegian

* "lang_pl": Polish

* "lang_pt": Portuguese

* "lang_ro": Romanian

* "lang_ru": Russian

* "lang_sk": Slovak

* "lang_sl": Slovenian

* "lang_sr": Serbian

* "lang_sv": Swedish

* "lang_tr": Turkish

* "lang_zh-CN": Chinese (Simplified)

* "lang_zh-TW": Chinese (Traditional)

func (*CseSiterestrictListCall) Num 

func (c *CseSiterestrictListCall) Num(num int64) *CseSiterestrictListCall

Num sets the optional parameter "num": Number of search results to return.

* Valid values are integers between 1 and 10, inclusive.

func (*CseSiterestrictListCall) OrTerms 

func (c *CseSiterestrictListCall) OrTerms(orTerms string) *CseSiterestrictListCall

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 (*CseSiterestrictListCall) Q added in v0.26.0 

func (c *CseSiterestrictListCall) Q(q string) *CseSiterestrictListCall

Q sets the optional parameter "q": Query

func (*CseSiterestrictListCall) RelatedSite 

func (c *CseSiterestrictListCall) RelatedSite(relatedSite string) *CseSiterestrictListCall

RelatedSite sets the optional parameter "relatedSite": Specifies that all search results should be pages that are related to the specified URL.

func (*CseSiterestrictListCall) Rights 

func (c *CseSiterestrictListCall) Rights(rights string) *CseSiterestrictListCall

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. See [typical combinations](https://wiki.creativecommons.org/wiki/CC_Search _integration).

func (*CseSiterestrictListCall) Safe 

func (c *CseSiterestrictListCall) Safe(safe string) *CseSiterestrictListCall

Safe sets the optional parameter "safe": Search safety level. Acceptable values are:

* "active": Enables SafeSearch filtering.

* "off": Disables SafeSearch filtering. (default)

Possible values: 

"safeUndefined"
"active"
"high"
"medium"
"off"

func (*CseSiterestrictListCall) SearchType 

func (c *CseSiterestrictListCall) SearchType(searchType string) *CseSiterestrictListCall

SearchType sets the optional parameter "searchType": Specifies the search type: `image`. If unspecified, results are limited to webpages.

Acceptable values are:

* "image": custom image search.

Possible values: 

"searchTypeUndefined"
"image"

func (*CseSiterestrictListCall) SiteSearch 

func (c *CseSiterestrictListCall) SiteSearch(siteSearch string) *CseSiterestrictListCall

SiteSearch sets the optional parameter "siteSearch": Specifies a given site which should always be included or excluded from results (see `siteSearchFilter` parameter, below).

func (*CseSiterestrictListCall) SiteSearchFilter 

func (c *CseSiterestrictListCall) SiteSearchFilter(siteSearchFilter string) *CseSiterestrictListCall

SiteSearchFilter sets the optional parameter "siteSearchFilter": Controls whether to include or exclude results from the site named in the `siteSearch` parameter.

Acceptable values are:

* "e": exclude

* "i": include

Possible values: 

"siteSearchFilterUndefined"
"e"
"i"

func (*CseSiterestrictListCall) Sort 

func (c *CseSiterestrictListCall) Sort(sort string) *CseSiterestrictListCall

Sort sets the optional parameter "sort": The sort expression to apply to the results. The sort parameter specifies that the results be sorted according to the specified expression i.e. sort by date. [Example: sort=date](https://developers.google.com/custom-search /docs/structured_search#sort-by-attribute).

func (*CseSiterestrictListCall) Start 

func (c *CseSiterestrictListCall) Start(start int64) *CseSiterestrictListCall

Start sets the optional parameter "start": The index of the first result to return. The default number of results per page is 10, so `&start=11` would start at the top of the second page of results. **Note**: The JSON API will never return more than 100 results, even if more than 100 documents match the query, so setting the sum of `start + num` to a number greater than 100 will produce an error. Also note that the maximum value for `num` is 10.

type CseSiterestrictService 

type CseSiterestrictService struct {
	// contains filtered or unexported fields
}

func NewCseSiterestrictService 

func NewCseSiterestrictService(s *Service) *CseSiterestrictService

func (*CseSiterestrictService) List 

func (r *CseSiterestrictService) List() *CseSiterestrictListCall

List: Returns metadata about the search performed, metadata about the engine used for the search, and the search results. Uses a small set of url patterns.

type Promotion 

type Promotion struct {
	// BodyLines: An array of block objects for this promotion. See [Google
	// WebSearch
	// Protocol
	// reference](https://developers.google.com/custom-sea
	// rch/docs/xml_results)
	// for more information.
	BodyLines []*PromotionBodyLines `json:"bodyLines,omitempty"`

	// DisplayLink: An abridged version of this search's result URL, e.g.
	// www.example.com.
	DisplayLink string `json:"displayLink,omitempty"`

	// HtmlTitle: The title of the promotion, in HTML.
	HtmlTitle string `json:"htmlTitle,omitempty"`

	// Image: Image belonging to a promotion.
	Image *PromotionImage `json:"image,omitempty"`

	// Link: The URL of the promotion.
	Link string `json:"link,omitempty"`

	// Title: The title of the promotion.
	Title string `json:"title,omitempty"`

	// ForceSendFields is a list of field names (e.g. "BodyLines") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "BodyLines") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

Promotion: Promotion result.

func (*Promotion) MarshalJSON 

func (s *Promotion) MarshalJSON() ([]byte, error)

type PromotionBodyLines 

type PromotionBodyLines struct {
	// HtmlTitle: The block object's text in HTML, if it has text.
	HtmlTitle string `json:"htmlTitle,omitempty"`

	// Link: The anchor text of the block object's link, if it has a link.
	Link string `json:"link,omitempty"`

	// Title: The block object's text, if it has text.
	Title string `json:"title,omitempty"`

	// Url: The URL of the block object's link, if it has one.
	Url string `json:"url,omitempty"`

	// ForceSendFields is a list of field names (e.g. "HtmlTitle") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "HtmlTitle") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

PromotionBodyLines: Block object belonging to a promotion.

func (*PromotionBodyLines) MarshalJSON 

func (s *PromotionBodyLines) MarshalJSON() ([]byte, error)

type PromotionImage 

type PromotionImage struct {
	// Height: Image height in pixels.
	Height int64 `json:"height,omitempty"`

	// Source: URL of the image for this promotion link.
	Source string `json:"source,omitempty"`

	// Width: Image width in pixels.
	Width int64 `json:"width,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Height") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Height") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

PromotionImage: Image belonging to a promotion.

func (*PromotionImage) MarshalJSON 

func (s *PromotionImage) MarshalJSON() ([]byte, error)

type Result 

type Result struct {
	// CacheId: Indicates the ID of Google's cached version of the search
	// result.
	CacheId string `json:"cacheId,omitempty"`

	// DisplayLink: An abridged version of this search result’s URL, e.g.
	// www.example.com.
	DisplayLink string `json:"displayLink,omitempty"`

	// FileFormat: The file format of the search result.
	FileFormat string `json:"fileFormat,omitempty"`

	// FormattedUrl: The URL displayed after the snippet for each search
	// result.
	FormattedUrl string `json:"formattedUrl,omitempty"`

	// HtmlFormattedUrl: The HTML-formatted URL displayed after the snippet
	// for each search result.
	HtmlFormattedUrl string `json:"htmlFormattedUrl,omitempty"`

	// HtmlSnippet: The snippet of the search result, in HTML.
	HtmlSnippet string `json:"htmlSnippet,omitempty"`

	// HtmlTitle: The title of the search result, in HTML.
	HtmlTitle string `json:"htmlTitle,omitempty"`

	// Image: Image belonging to a custom search result.
	Image *ResultImage `json:"image,omitempty"`

	// Kind: A unique identifier for the type of current object. For this
	// API, it is
	// `customsearch#result.`
	Kind string `json:"kind,omitempty"`

	// Labels: Encapsulates all information about
	// [refinement
	// labels](https://developers.google.com/custom-search/docs/x
	// ml_results).
	Labels []*ResultLabels `json:"labels,omitempty"`

	// Link: The full URL to which the search result is pointing,
	// e.g.
	// http://www.example.com/foo/bar.
	Link string `json:"link,omitempty"`

	// Mime: The MIME type of the search result.
	Mime string `json:"mime,omitempty"`

	// Pagemap:
	// Contains
	// [PageMap](https://developers.google.com/custom-search/docs/st
	// ructured_data#pagemaps)
	// information for this search result.
	Pagemap googleapi.RawMessage `json:"pagemap,omitempty"`

	// Snippet: The snippet of the search result, in plain text.
	Snippet string `json:"snippet,omitempty"`

	// Title: The title of the search result, in plain text.
	Title string `json:"title,omitempty"`

	// ForceSendFields is a list of field names (e.g. "CacheId") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "CacheId") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

Result: A custom search result.

func (*Result) MarshalJSON 

func (s *Result) MarshalJSON() ([]byte, error)

type ResultImage 

type ResultImage struct {
	// ByteSize: The size of the image, in pixels.
	ByteSize int64 `json:"byteSize,omitempty"`

	// ContextLink: A URL pointing to the webpage hosting the image.
	ContextLink string `json:"contextLink,omitempty"`

	// Height: The height of the image, in pixels.
	Height int64 `json:"height,omitempty"`

	// ThumbnailHeight: The height of the thumbnail image, in pixels.
	ThumbnailHeight int64 `json:"thumbnailHeight,omitempty"`

	// ThumbnailLink: A URL to the thumbnail image.
	ThumbnailLink string `json:"thumbnailLink,omitempty"`

	// ThumbnailWidth: The width of the thumbnail image, in pixels.
	ThumbnailWidth int64 `json:"thumbnailWidth,omitempty"`

	// Width: The width of the image, in pixels.
	Width int64 `json:"width,omitempty"`

	// ForceSendFields is a list of field names (e.g. "ByteSize") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "ByteSize") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ResultImage: Image belonging to a custom search result.

func (*ResultImage) MarshalJSON 

func (s *ResultImage) MarshalJSON() ([]byte, error)

type ResultLabels 

type ResultLabels struct {
	// DisplayName: The display name of a refinement label. This is the name
	// you should
	// display in your user interface.
	DisplayName string `json:"displayName,omitempty"`

	// LabelWithOp: Refinement label and the associated refinement
	// operation.
	LabelWithOp string `json:"label_with_op,omitempty"`

	// Name: The name of a refinement label, which you can use to refine
	// searches.
	// Don't display this in your user interface; instead, use displayName.
	Name string `json:"name,omitempty"`

	// ForceSendFields is a list of field names (e.g. "DisplayName") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DisplayName") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ResultLabels: Refinement label associated with a custom search result.

func (*ResultLabels) MarshalJSON 

func (s *ResultLabels) MarshalJSON() ([]byte, error)
type Search struct {
	// Context: Metadata and refinements associated with the given search
	// engine,
	// including:
	//
	// * The name of the search engine that was used for the query.
	//
	// *   A set of
	// [facet
	// objects](https://developers.google.com/custom-search/docs/refin
	// ements#create)
	// (refinements) you can use for refining a search.
	Context googleapi.RawMessage `json:"context,omitempty"`

	// Items: The current set of custom search results.
	Items []*Result `json:"items,omitempty"`

	// Kind: Unique identifier for the type of current object. For this API,
	// it is
	// customsearch#search.
	Kind string `json:"kind,omitempty"`

	// Promotions: The set
	// of
	// [promotions](https://developers.google.com/custom-search/docs/promo
	// tions).
	// Present only if the custom search engine's configuration files define
	// any
	// promotions for the given query.
	Promotions []*Promotion `json:"promotions,omitempty"`

	// Queries: Query metadata for the previous, current, and next pages of
	// results.
	Queries *SearchQueries `json:"queries,omitempty"`

	// SearchInformation: Metadata about a search operation.
	SearchInformation *SearchSearchInformation `json:"searchInformation,omitempty"`

	// Spelling: Spell correction information for a query.
	Spelling *SearchSpelling `json:"spelling,omitempty"`

	// Url: OpenSearch template and URL.
	Url *SearchUrl `json:"url,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Context") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Context") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

Search: Response to a custom search request.

func (*Search) MarshalJSON 

func (s *Search) MarshalJSON() ([]byte, error)

type SearchQueries added in v0.22.0 

type SearchQueries struct {
	// NextPage: Metadata representing the next page of results, if
	// applicable.
	NextPage []*SearchQueriesNextPage `json:"nextPage,omitempty"`

	// PreviousPage: Metadata representing the previous page of results, if
	// applicable.
	PreviousPage []*SearchQueriesPreviousPage `json:"previousPage,omitempty"`

	// Request: Metadata representing the current request.
	Request []*SearchQueriesRequest `json:"request,omitempty"`

	// ForceSendFields is a list of field names (e.g. "NextPage") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "NextPage") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

SearchQueries: Query metadata for the previous, current, and next pages of results.

func (*SearchQueries) MarshalJSON added in v0.22.0 

func (s *SearchQueries) MarshalJSON() ([]byte, error)

type SearchQueriesNextPage added in v0.22.0 

type SearchQueriesNextPage struct {
	// Count: Number of search results returned in this set.
	Count int64 `json:"count,omitempty"`

	// Cr: Restricts search results to documents originating in a
	// particular
	// country. You may use
	// [Boolean
	// operators](https://developers.google.com/custom-search/docs/x
	// ml_results#booleanOperators)
	// in the `cr` parameter's value.
	//
	// Google WebSearch determines the country of a document by analyzing
	// the
	// following:
	//
	// * The top-level domain (TLD) of the document's URL.
	//
	// * The geographic location of the web server's IP address.
	//
	// See [Country (cr)
	// Parameter
	// Values](https://developers.google.com/custom-search/docs/xml
	// _results#countryCollections)
	// for a list of valid values for this parameter.
	Cr string `json:"cr,omitempty"`

	// Cx: The identifier of an engine created using the Programmable Search
	// Engine
	// [Control Panel](https://programmablesearchengine.google.com/). This
	// is a
	// custom property not defined in the OpenSearch spec. This parameter
	// is
	// **required**.
	Cx string `json:"cx,omitempty"`

	// DateRestrict: Restricts results to URLs based on date. Supported
	// values include:
	//
	// * `d[number]`: requests results from the specified number of past
	// days.
	//
	// * `w[number]`: requests results from the specified number of past
	// weeks.
	//
	// * `m[number]`: requests results from the specified number of past
	// months.
	//
	// * `y[number]`: requests results from the specified number of past
	// years.
	DateRestrict string `json:"dateRestrict,omitempty"`

	// DisableCnTwTranslation: Enables or disables the [Simplified and
	// Traditional
	// Chinese
	// Search](https://developers.google.com/custom-search/docs/xml_r
	// esults#chineseSearch)
	// feature.
	//
	// Supported values are:
	//
	// * `0`: enabled (default)
	//
	// * `1`: disabled
	DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"`

	// ExactTerms: Identifies a phrase that all documents in the search
	// results must
	// contain.
	ExactTerms string `json:"exactTerms,omitempty"`

	// ExcludeTerms: Identifies a word or phrase that should not appear in
	// any documents in
	// the search results.
	ExcludeTerms string `json:"excludeTerms,omitempty"`

	// FileType: Restricts results to files of a specified extension.
	// Filetypes supported
	// by Google include:
	//
	// * Adobe Portable Document Format (`pdf`)
	//
	// * Adobe PostScript (`ps`)
	//
	// * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`,
	// `wku`)
	//
	// * Lotus WordPro (`lwp`)
	//
	// * Macwrite (`mw`)
	//
	// * Microsoft Excel (`xls`)
	//
	// * Microsoft PowerPoint (`ppt`)
	//
	// * Microsoft Word (`doc`)
	//
	// * Microsoft Works (`wks`, `wps`, `wdb`)
	//
	// * Microsoft Write (`wri`)
	//
	// * Rich Text Format (`rtf`)
	//
	// * Shockwave Flash (`swf`)
	//
	// * Text (`ans`, `txt`).
	//
	// Additional filetypes may be added in the future. An up-to-date list
	// can
	// always be found in Google's [file
	// type
	// FAQ](https://support.google.com/webmasters/answer/35287).
	FileType string `json:"fileType,omitempty"`

	// Filter: Activates or deactivates the automatic filtering of Google
	// search
	// results. See
	// [Automatic
	// Filtering](https://developers.google.com/custom-search/docs
	// /xml_results#automaticFiltering)
	// for more information about Google's search results filters. Valid
	// values
	// for this parameter are:
	//
	// * `0`: Disabled
	//
	// * `1`: Enabled (default)
	//
	// **Note**: By default, Google applies filtering to all search results
	// to
	// improve the quality of those results.
	Filter string `json:"filter,omitempty"`

	// Gl: Boosts search results whose country of origin matches the
	// parameter
	// value. See
	// [Country
	// Codes](https://developers.google.com/custom-search/docs/xml_r
	// esults#countryCodes)
	// for a list of valid values.
	//
	// Specifying a `gl` parameter value in WebSearch requests should
	// improve
	// the relevance of results. This is particularly true for
	// international
	// customers and, even more specifically, for customers in
	// English-speaking
	// countries other than the United States.
	Gl string `json:"gl,omitempty"`

	// GoogleHost: Specifies the Google domain (for example, google.com,
	// google.de, or
	// google.fr) to which the search should be limited.
	GoogleHost string `json:"googleHost,omitempty"`

	// HighRange: Specifies the ending value for a search range. Use
	// `cse:lowRange` and
	// `cse:highrange` to append an inclusive search range
	// of
	// `lowRange...highRange` to the query.
	HighRange string `json:"highRange,omitempty"`

	// Hl: Specifies the interface language (host language) of your user
	// interface.
	// Explicitly setting this parameter improves the performance and
	// the
	// quality of your search results.
	//
	// See the
	// [Interface
	// Languages](https://developers.google.com/custom-search/docs
	// /xml_results#wsInterfaceLanguages)
	// section of [Internationalizing Queries and
	// Results
	// Presentation](https://developers.google.com/custom-search/docs
	// /xml_results#wsInternationalizing)
	// for more information, and [Supported
	// Interface
	// Languages](https://developers.google.com/custom-search/docs/
	// xml_results_appendices#interfaceLanguages)
	// for a list of supported languages.
	Hl string `json:"hl,omitempty"`

	// Hq: Appends the specified query terms to the query, as if they were
	// combined
	// with a logical `AND` operator.
	Hq string `json:"hq,omitempty"`

	// ImgColorType: Restricts results to images of a specified color type.
	// Supported values
	//   are:
	//
	// * `mono` (black and white)
	//
	// * `gray` (grayscale)
	//
	// * `color` (color)
	ImgColorType string `json:"imgColorType,omitempty"`

	// ImgDominantColor: Restricts results to images with a specific
	// dominant color. Supported
	// values are:
	//
	// * `red`
	//
	// * `orange`
	//
	// * `yellow`
	//
	// * `green`
	//
	// * `teal`
	//
	// * `blue`
	//
	// * `purple`
	//
	// * `pink`
	//
	// * `white`
	//
	// * `gray`
	//
	// * `black`
	//
	// * `brown`
	ImgDominantColor string `json:"imgDominantColor,omitempty"`

	// ImgSize: Restricts results to images of a specified size. Supported
	// values are:
	//
	// * `icon` (small)
	//
	// * `small | medium | large | xlarge` (medium)
	//
	// * `xxlarge` (large)
	//
	// * `huge` (extra-large)
	ImgSize string `json:"imgSize,omitempty"`

	// ImgType: Restricts results to images of a specified type. Supported
	// values are:
	//
	// * `clipart` (Clip art)
	//
	// * `face` (Face)
	//
	// * `lineart` (Line drawing)
	//
	// * `photo` (Photo)
	//
	// * `animated` (Animated)
	//
	// * `stock` (Stock)
	ImgType string `json:"imgType,omitempty"`

	// InputEncoding: The character encoding supported for search requests.
	InputEncoding string `json:"inputEncoding,omitempty"`

	// Language: The language of the search results.
	Language string `json:"language,omitempty"`

	// LinkSite: Specifies that all results should contain a link to a
	// specific URL.
	LinkSite string `json:"linkSite,omitempty"`

	// LowRange: Specifies the starting value for a search range. Use
	// `cse:lowRange` and
	// `cse:highrange` to append an inclusive search range
	// of
	// `lowRange...highRange` to the query.
	LowRange string `json:"lowRange,omitempty"`

	// 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. You can also use the
	// [Boolean
	// OR](https://developers.google.com/custom-search/docs/xml_resu
	// lts#BooleanOrqt)
	// query term for this type of query.
	OrTerms string `json:"orTerms,omitempty"`

	// OutputEncoding: The character encoding supported for search results.
	OutputEncoding string `json:"outputEncoding,omitempty"`

	// RelatedSite: Specifies that all search results should be pages that
	// are related to the
	// specified URL. The parameter value should be a URL.
	RelatedSite string `json:"relatedSite,omitempty"`

	// Rights: Filters based on licensing. Supported values include:
	//
	// * `cc_publicdomain`
	//
	// * `cc_attribute`
	//
	// * `cc_sharealike`
	//
	// * `cc_noncommercial`
	//
	// * `cc_nonderived`
	Rights string `json:"rights,omitempty"`

	// Safe: Specifies the
	// [SafeSearch
	// level](https://developers.google.com/custom-search/docs/xm
	// l_results#safeSearchLevels)
	// used for filtering out adult results. This is a custom property
	// not
	// defined in the OpenSearch spec. Valid parameter values are:
	//
	// * "off": Disable SafeSearch
	//
	// * "active": Enable SafeSearch
	Safe string `json:"safe,omitempty"`

	// SearchTerms: The search terms entered by the user.
	SearchTerms string `json:"searchTerms,omitempty"`

	// SearchType: Allowed values are `web` or `image`. If unspecified,
	// results are limited
	// to webpages.
	SearchType string `json:"searchType,omitempty"`

	// SiteSearch: Restricts results to URLs from a specified site.
	SiteSearch string `json:"siteSearch,omitempty"`

	// SiteSearchFilter: Specifies whether to include or exclude results
	// from the site named in
	// the `sitesearch` parameter. Supported values are:
	//
	// * `i`: include content from site
	//
	// * `e`: exclude content from site
	SiteSearchFilter string `json:"siteSearchFilter,omitempty"`

	// Sort: Specifies that results should be sorted according to the
	// specified
	// expression. For example, sort by date.
	Sort string `json:"sort,omitempty"`

	// StartIndex: The index of the current set of search results into the
	// total set of
	// results, where the index of the first result is 1.
	StartIndex int64 `json:"startIndex,omitempty"`

	// StartPage: The page number of this set of results, where the page
	// length is set by
	// the `count` property.
	StartPage int64 `json:"startPage,omitempty"`

	// Title: A description of the query.
	Title string `json:"title,omitempty"`

	// TotalResults: Estimated number of total search results. May not be
	// accurate.
	TotalResults int64 `json:"totalResults,omitempty,string"`

	// ForceSendFields is a list of field names (e.g. "Count") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Count") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

SearchQueriesNextPage: Custom search request metadata.

func (*SearchQueriesNextPage) MarshalJSON added in v0.22.0 

func (s *SearchQueriesNextPage) MarshalJSON() ([]byte, error)

type SearchQueriesPreviousPage added in v0.22.0 

type SearchQueriesPreviousPage struct {
	// Count: Number of search results returned in this set.
	Count int64 `json:"count,omitempty"`

	// Cr: Restricts search results to documents originating in a
	// particular
	// country. You may use
	// [Boolean
	// operators](https://developers.google.com/custom-search/docs/x
	// ml_results#booleanOperators)
	// in the `cr` parameter's value.
	//
	// Google WebSearch determines the country of a document by analyzing
	// the
	// following:
	//
	// * The top-level domain (TLD) of the document's URL.
	//
	// * The geographic location of the web server's IP address.
	//
	// See [Country (cr)
	// Parameter
	// Values](https://developers.google.com/custom-search/docs/xml
	// _results#countryCollections)
	// for a list of valid values for this parameter.
	Cr string `json:"cr,omitempty"`

	// Cx: The identifier of an engine created using the Programmable Search
	// Engine
	// [Control Panel](https://programmablesearchengine.google.com/). This
	// is a
	// custom property not defined in the OpenSearch spec. This parameter
	// is
	// **required**.
	Cx string `json:"cx,omitempty"`

	// DateRestrict: Restricts results to URLs based on date. Supported
	// values include:
	//
	// * `d[number]`: requests results from the specified number of past
	// days.
	//
	// * `w[number]`: requests results from the specified number of past
	// weeks.
	//
	// * `m[number]`: requests results from the specified number of past
	// months.
	//
	// * `y[number]`: requests results from the specified number of past
	// years.
	DateRestrict string `json:"dateRestrict,omitempty"`

	// DisableCnTwTranslation: Enables or disables the [Simplified and
	// Traditional
	// Chinese
	// Search](https://developers.google.com/custom-search/docs/xml_r
	// esults#chineseSearch)
	// feature.
	//
	// Supported values are:
	//
	// * `0`: enabled (default)
	//
	// * `1`: disabled
	DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"`

	// ExactTerms: Identifies a phrase that all documents in the search
	// results must
	// contain.
	ExactTerms string `json:"exactTerms,omitempty"`

	// ExcludeTerms: Identifies a word or phrase that should not appear in
	// any documents in
	// the search results.
	ExcludeTerms string `json:"excludeTerms,omitempty"`

	// FileType: Restricts results to files of a specified extension.
	// Filetypes supported
	// by Google include:
	//
	// * Adobe Portable Document Format (`pdf`)
	//
	// * Adobe PostScript (`ps`)
	//
	// * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`,
	// `wku`)
	//
	// * Lotus WordPro (`lwp`)
	//
	// * Macwrite (`mw`)
	//
	// * Microsoft Excel (`xls`)
	//
	// * Microsoft PowerPoint (`ppt`)
	//
	// * Microsoft Word (`doc`)
	//
	// * Microsoft Works (`wks`, `wps`, `wdb`)
	//
	// * Microsoft Write (`wri`)
	//
	// * Rich Text Format (`rtf`)
	//
	// * Shockwave Flash (`swf`)
	//
	// * Text (`ans`, `txt`).
	//
	// Additional filetypes may be added in the future. An up-to-date list
	// can
	// always be found in Google's [file
	// type
	// FAQ](https://support.google.com/webmasters/answer/35287).
	FileType string `json:"fileType,omitempty"`

	// Filter: Activates or deactivates the automatic filtering of Google
	// search
	// results. See
	// [Automatic
	// Filtering](https://developers.google.com/custom-search/docs
	// /xml_results#automaticFiltering)
	// for more information about Google's search results filters. Valid
	// values
	// for this parameter are:
	//
	// * `0`: Disabled
	//
	// * `1`: Enabled (default)
	//
	// **Note**: By default, Google applies filtering to all search results
	// to
	// improve the quality of those results.
	Filter string `json:"filter,omitempty"`

	// Gl: Boosts search results whose country of origin matches the
	// parameter
	// value. See
	// [Country
	// Codes](https://developers.google.com/custom-search/docs/xml_r
	// esults#countryCodes)
	// for a list of valid values.
	//
	// Specifying a `gl` parameter value in WebSearch requests should
	// improve
	// the relevance of results. This is particularly true for
	// international
	// customers and, even more specifically, for customers in
	// English-speaking
	// countries other than the United States.
	Gl string `json:"gl,omitempty"`

	// GoogleHost: Specifies the Google domain (for example, google.com,
	// google.de, or
	// google.fr) to which the search should be limited.
	GoogleHost string `json:"googleHost,omitempty"`

	// HighRange: Specifies the ending value for a search range. Use
	// `cse:lowRange` and
	// `cse:highrange` to append an inclusive search range
	// of
	// `lowRange...highRange` to the query.
	HighRange string `json:"highRange,omitempty"`

	// Hl: Specifies the interface language (host language) of your user
	// interface.
	// Explicitly setting this parameter improves the performance and
	// the
	// quality of your search results.
	//
	// See the
	// [Interface
	// Languages](https://developers.google.com/custom-search/docs
	// /xml_results#wsInterfaceLanguages)
	// section of [Internationalizing Queries and
	// Results
	// Presentation](https://developers.google.com/custom-search/docs
	// /xml_results#wsInternationalizing)
	// for more information, and [Supported
	// Interface
	// Languages](https://developers.google.com/custom-search/docs/
	// xml_results_appendices#interfaceLanguages)
	// for a list of supported languages.
	Hl string `json:"hl,omitempty"`

	// Hq: Appends the specified query terms to the query, as if they were
	// combined
	// with a logical `AND` operator.
	Hq string `json:"hq,omitempty"`

	// ImgColorType: Restricts results to images of a specified color type.
	// Supported values
	//   are:
	//
	// * `mono` (black and white)
	//
	// * `gray` (grayscale)
	//
	// * `color` (color)
	ImgColorType string `json:"imgColorType,omitempty"`

	// ImgDominantColor: Restricts results to images with a specific
	// dominant color. Supported
	// values are:
	//
	// * `red`
	//
	// * `orange`
	//
	// * `yellow`
	//
	// * `green`
	//
	// * `teal`
	//
	// * `blue`
	//
	// * `purple`
	//
	// * `pink`
	//
	// * `white`
	//
	// * `gray`
	//
	// * `black`
	//
	// * `brown`
	ImgDominantColor string `json:"imgDominantColor,omitempty"`

	// ImgSize: Restricts results to images of a specified size. Supported
	// values are:
	//
	// * `icon` (small)
	//
	// * `small | medium | large | xlarge` (medium)
	//
	// * `xxlarge` (large)
	//
	// * `huge` (extra-large)
	ImgSize string `json:"imgSize,omitempty"`

	// ImgType: Restricts results to images of a specified type. Supported
	// values are:
	//
	// * `clipart` (Clip art)
	//
	// * `face` (Face)
	//
	// * `lineart` (Line drawing)
	//
	// * `photo` (Photo)
	//
	// * `animated` (Animated)
	//
	// * `stock` (Stock)
	ImgType string `json:"imgType,omitempty"`

	// InputEncoding: The character encoding supported for search requests.
	InputEncoding string `json:"inputEncoding,omitempty"`

	// Language: The language of the search results.
	Language string `json:"language,omitempty"`

	// LinkSite: Specifies that all results should contain a link to a
	// specific URL.
	LinkSite string `json:"linkSite,omitempty"`

	// LowRange: Specifies the starting value for a search range. Use
	// `cse:lowRange` and
	// `cse:highrange` to append an inclusive search range
	// of
	// `lowRange...highRange` to the query.
	LowRange string `json:"lowRange,omitempty"`

	// 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. You can also use the
	// [Boolean
	// OR](https://developers.google.com/custom-search/docs/xml_resu
	// lts#BooleanOrqt)
	// query term for this type of query.
	OrTerms string `json:"orTerms,omitempty"`

	// OutputEncoding: The character encoding supported for search results.
	OutputEncoding string `json:"outputEncoding,omitempty"`

	// RelatedSite: Specifies that all search results should be pages that
	// are related to the
	// specified URL. The parameter value should be a URL.
	RelatedSite string `json:"relatedSite,omitempty"`

	// Rights: Filters based on licensing. Supported values include:
	//
	// * `cc_publicdomain`
	//
	// * `cc_attribute`
	//
	// * `cc_sharealike`
	//
	// * `cc_noncommercial`
	//
	// * `cc_nonderived`
	Rights string `json:"rights,omitempty"`

	// Safe: Specifies the
	// [SafeSearch
	// level](https://developers.google.com/custom-search/docs/xm
	// l_results#safeSearchLevels)
	// used for filtering out adult results. This is a custom property
	// not
	// defined in the OpenSearch spec. Valid parameter values are:
	//
	// * "off": Disable SafeSearch
	//
	// * "active": Enable SafeSearch
	Safe string `json:"safe,omitempty"`

	// SearchTerms: The search terms entered by the user.
	SearchTerms string `json:"searchTerms,omitempty"`

	// SearchType: Allowed values are `web` or `image`. If unspecified,
	// results are limited
	// to webpages.
	SearchType string `json:"searchType,omitempty"`

	// SiteSearch: Restricts results to URLs from a specified site.
	SiteSearch string `json:"siteSearch,omitempty"`

	// SiteSearchFilter: Specifies whether to include or exclude results
	// from the site named in
	// the `sitesearch` parameter. Supported values are:
	//
	// * `i`: include content from site
	//
	// * `e`: exclude content from site
	SiteSearchFilter string `json:"siteSearchFilter,omitempty"`

	// Sort: Specifies that results should be sorted according to the
	// specified
	// expression. For example, sort by date.
	Sort string `json:"sort,omitempty"`

	// StartIndex: The index of the current set of search results into the
	// total set of
	// results, where the index of the first result is 1.
	StartIndex int64 `json:"startIndex,omitempty"`

	// StartPage: The page number of this set of results, where the page
	// length is set by
	// the `count` property.
	StartPage int64 `json:"startPage,omitempty"`

	// Title: A description of the query.
	Title string `json:"title,omitempty"`

	// TotalResults: Estimated number of total search results. May not be
	// accurate.
	TotalResults int64 `json:"totalResults,omitempty,string"`

	// ForceSendFields is a list of field names (e.g. "Count") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Count") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

SearchQueriesPreviousPage: Custom search request metadata.

func (*SearchQueriesPreviousPage) MarshalJSON added in v0.22.0 

func (s *SearchQueriesPreviousPage) MarshalJSON() ([]byte, error)

type SearchQueriesRequest added in v0.22.0 

type SearchQueriesRequest struct {
	// Count: Number of search results returned in this set.
	Count int64 `json:"count,omitempty"`

	// Cr: Restricts search results to documents originating in a
	// particular
	// country. You may use
	// [Boolean
	// operators](https://developers.google.com/custom-search/docs/x
	// ml_results#booleanOperators)
	// in the `cr` parameter's value.
	//
	// Google WebSearch determines the country of a document by analyzing
	// the
	// following:
	//
	// * The top-level domain (TLD) of the document's URL.
	//
	// * The geographic location of the web server's IP address.
	//
	// See [Country (cr)
	// Parameter
	// Values](https://developers.google.com/custom-search/docs/xml
	// _results#countryCollections)
	// for a list of valid values for this parameter.
	Cr string `json:"cr,omitempty"`

	// Cx: The identifier of an engine created using the Programmable Search
	// Engine
	// [Control Panel](https://programmablesearchengine.google.com/). This
	// is a
	// custom property not defined in the OpenSearch spec. This parameter
	// is
	// **required**.
	Cx string `json:"cx,omitempty"`

	// DateRestrict: Restricts results to URLs based on date. Supported
	// values include:
	//
	// * `d[number]`: requests results from the specified number of past
	// days.
	//
	// * `w[number]`: requests results from the specified number of past
	// weeks.
	//
	// * `m[number]`: requests results from the specified number of past
	// months.
	//
	// * `y[number]`: requests results from the specified number of past
	// years.
	DateRestrict string `json:"dateRestrict,omitempty"`

	// DisableCnTwTranslation: Enables or disables the [Simplified and
	// Traditional
	// Chinese
	// Search](https://developers.google.com/custom-search/docs/xml_r
	// esults#chineseSearch)
	// feature.
	//
	// Supported values are:
	//
	// * `0`: enabled (default)
	//
	// * `1`: disabled
	DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"`

	// ExactTerms: Identifies a phrase that all documents in the search
	// results must
	// contain.
	ExactTerms string `json:"exactTerms,omitempty"`

	// ExcludeTerms: Identifies a word or phrase that should not appear in
	// any documents in
	// the search results.
	ExcludeTerms string `json:"excludeTerms,omitempty"`

	// FileType: Restricts results to files of a specified extension.
	// Filetypes supported
	// by Google include:
	//
	// * Adobe Portable Document Format (`pdf`)
	//
	// * Adobe PostScript (`ps`)
	//
	// * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`,
	// `wku`)
	//
	// * Lotus WordPro (`lwp`)
	//
	// * Macwrite (`mw`)
	//
	// * Microsoft Excel (`xls`)
	//
	// * Microsoft PowerPoint (`ppt`)
	//
	// * Microsoft Word (`doc`)
	//
	// * Microsoft Works (`wks`, `wps`, `wdb`)
	//
	// * Microsoft Write (`wri`)
	//
	// * Rich Text Format (`rtf`)
	//
	// * Shockwave Flash (`swf`)
	//
	// * Text (`ans`, `txt`).
	//
	// Additional filetypes may be added in the future. An up-to-date list
	// can
	// always be found in Google's [file
	// type
	// FAQ](https://support.google.com/webmasters/answer/35287).
	FileType string `json:"fileType,omitempty"`

	// Filter: Activates or deactivates the automatic filtering of Google
	// search
	// results. See
	// [Automatic
	// Filtering](https://developers.google.com/custom-search/docs
	// /xml_results#automaticFiltering)
	// for more information about Google's search results filters. Valid
	// values
	// for this parameter are:
	//
	// * `0`: Disabled
	//
	// * `1`: Enabled (default)
	//
	// **Note**: By default, Google applies filtering to all search results
	// to
	// improve the quality of those results.
	Filter string `json:"filter,omitempty"`

	// Gl: Boosts search results whose country of origin matches the
	// parameter
	// value. See
	// [Country
	// Codes](https://developers.google.com/custom-search/docs/xml_r
	// esults#countryCodes)
	// for a list of valid values.
	//
	// Specifying a `gl` parameter value in WebSearch requests should
	// improve
	// the relevance of results. This is particularly true for
	// international
	// customers and, even more specifically, for customers in
	// English-speaking
	// countries other than the United States.
	Gl string `json:"gl,omitempty"`

	// GoogleHost: Specifies the Google domain (for example, google.com,
	// google.de, or
	// google.fr) to which the search should be limited.
	GoogleHost string `json:"googleHost,omitempty"`

	// HighRange: Specifies the ending value for a search range. Use
	// `cse:lowRange` and
	// `cse:highrange` to append an inclusive search range
	// of
	// `lowRange...highRange` to the query.
	HighRange string `json:"highRange,omitempty"`

	// Hl: Specifies the interface language (host language) of your user
	// interface.
	// Explicitly setting this parameter improves the performance and
	// the
	// quality of your search results.
	//
	// See the
	// [Interface
	// Languages](https://developers.google.com/custom-search/docs
	// /xml_results#wsInterfaceLanguages)
	// section of [Internationalizing Queries and
	// Results
	// Presentation](https://developers.google.com/custom-search/docs
	// /xml_results#wsInternationalizing)
	// for more information, and [Supported
	// Interface
	// Languages](https://developers.google.com/custom-search/docs/
	// xml_results_appendices#interfaceLanguages)
	// for a list of supported languages.
	Hl string `json:"hl,omitempty"`

	// Hq: Appends the specified query terms to the query, as if they were
	// combined
	// with a logical `AND` operator.
	Hq string `json:"hq,omitempty"`

	// ImgColorType: Restricts results to images of a specified color type.
	// Supported values
	//   are:
	//
	// * `mono` (black and white)
	//
	// * `gray` (grayscale)
	//
	// * `color` (color)
	ImgColorType string `json:"imgColorType,omitempty"`

	// ImgDominantColor: Restricts results to images with a specific
	// dominant color. Supported
	// values are:
	//
	// * `red`
	//
	// * `orange`
	//
	// * `yellow`
	//
	// * `green`
	//
	// * `teal`
	//
	// * `blue`
	//
	// * `purple`
	//
	// * `pink`
	//
	// * `white`
	//
	// * `gray`
	//
	// * `black`
	//
	// * `brown`
	ImgDominantColor string `json:"imgDominantColor,omitempty"`

	// ImgSize: Restricts results to images of a specified size. Supported
	// values are:
	//
	// * `icon` (small)
	//
	// * `small | medium | large | xlarge` (medium)
	//
	// * `xxlarge` (large)
	//
	// * `huge` (extra-large)
	ImgSize string `json:"imgSize,omitempty"`

	// ImgType: Restricts results to images of a specified type. Supported
	// values are:
	//
	// * `clipart` (Clip art)
	//
	// * `face` (Face)
	//
	// * `lineart` (Line drawing)
	//
	// * `photo` (Photo)
	//
	// * `animated` (Animated)
	//
	// * `stock` (Stock)
	ImgType string `json:"imgType,omitempty"`

	// InputEncoding: The character encoding supported for search requests.
	InputEncoding string `json:"inputEncoding,omitempty"`

	// Language: The language of the search results.
	Language string `json:"language,omitempty"`

	// LinkSite: Specifies that all results should contain a link to a
	// specific URL.
	LinkSite string `json:"linkSite,omitempty"`

	// LowRange: Specifies the starting value for a search range. Use
	// `cse:lowRange` and
	// `cse:highrange` to append an inclusive search range
	// of
	// `lowRange...highRange` to the query.
	LowRange string `json:"lowRange,omitempty"`

	// 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. You can also use the
	// [Boolean
	// OR](https://developers.google.com/custom-search/docs/xml_resu
	// lts#BooleanOrqt)
	// query term for this type of query.
	OrTerms string `json:"orTerms,omitempty"`

	// OutputEncoding: The character encoding supported for search results.
	OutputEncoding string `json:"outputEncoding,omitempty"`

	// RelatedSite: Specifies that all search results should be pages that
	// are related to the
	// specified URL. The parameter value should be a URL.
	RelatedSite string `json:"relatedSite,omitempty"`

	// Rights: Filters based on licensing. Supported values include:
	//
	// * `cc_publicdomain`
	//
	// * `cc_attribute`
	//
	// * `cc_sharealike`
	//
	// * `cc_noncommercial`
	//
	// * `cc_nonderived`
	Rights string `json:"rights,omitempty"`

	// Safe: Specifies the
	// [SafeSearch
	// level](https://developers.google.com/custom-search/docs/xm
	// l_results#safeSearchLevels)
	// used for filtering out adult results. This is a custom property
	// not
	// defined in the OpenSearch spec. Valid parameter values are:
	//
	// * "off": Disable SafeSearch
	//
	// * "active": Enable SafeSearch
	Safe string `json:"safe,omitempty"`

	// SearchTerms: The search terms entered by the user.
	SearchTerms string `json:"searchTerms,omitempty"`

	// SearchType: Allowed values are `web` or `image`. If unspecified,
	// results are limited
	// to webpages.
	SearchType string `json:"searchType,omitempty"`

	// SiteSearch: Restricts results to URLs from a specified site.
	SiteSearch string `json:"siteSearch,omitempty"`

	// SiteSearchFilter: Specifies whether to include or exclude results
	// from the site named in
	// the `sitesearch` parameter. Supported values are:
	//
	// * `i`: include content from site
	//
	// * `e`: exclude content from site
	SiteSearchFilter string `json:"siteSearchFilter,omitempty"`

	// Sort: Specifies that results should be sorted according to the
	// specified
	// expression. For example, sort by date.
	Sort string `json:"sort,omitempty"`

	// StartIndex: The index of the current set of search results into the
	// total set of
	// results, where the index of the first result is 1.
	StartIndex int64 `json:"startIndex,omitempty"`

	// StartPage: The page number of this set of results, where the page
	// length is set by
	// the `count` property.
	StartPage int64 `json:"startPage,omitempty"`

	// Title: A description of the query.
	Title string `json:"title,omitempty"`

	// TotalResults: Estimated number of total search results. May not be
	// accurate.
	TotalResults int64 `json:"totalResults,omitempty,string"`

	// ForceSendFields is a list of field names (e.g. "Count") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Count") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

SearchQueriesRequest: Custom search request metadata.

func (*SearchQueriesRequest) MarshalJSON added in v0.22.0 

func (s *SearchQueriesRequest) MarshalJSON() ([]byte, error)

type SearchSearchInformation 

type SearchSearchInformation struct {
	// FormattedSearchTime: The time taken for the server to return search
	// results, formatted
	// according to locale style.
	FormattedSearchTime string `json:"formattedSearchTime,omitempty"`

	// FormattedTotalResults: The total number of search results, formatted
	// according to locale style.
	FormattedTotalResults string `json:"formattedTotalResults,omitempty"`

	// SearchTime: The time taken for the server to return search results.
	SearchTime float64 `json:"searchTime,omitempty"`

	// TotalResults: The total number of search results returned by the
	// query.
	TotalResults string `json:"totalResults,omitempty"`

	// ForceSendFields is a list of field names (e.g. "FormattedSearchTime")
	// to unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "FormattedSearchTime") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

SearchSearchInformation: Metadata about a search operation.

func (*SearchSearchInformation) MarshalJSON 

func (s *SearchSearchInformation) MarshalJSON() ([]byte, error)

func (*SearchSearchInformation) UnmarshalJSON 

func (s *SearchSearchInformation) UnmarshalJSON(data []byte) error

type SearchSpelling 

type SearchSpelling struct {
	// CorrectedQuery: The corrected query.
	CorrectedQuery string `json:"correctedQuery,omitempty"`

	// HtmlCorrectedQuery: The corrected query, formatted in HTML.
	HtmlCorrectedQuery string `json:"htmlCorrectedQuery,omitempty"`

	// ForceSendFields is a list of field names (e.g. "CorrectedQuery") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "CorrectedQuery") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

SearchSpelling: Spell correction information for a query.

func (*SearchSpelling) MarshalJSON 

func (s *SearchSpelling) MarshalJSON() ([]byte, error)

type SearchUrl 

type SearchUrl struct {
	// Template: The actual
	// [OpenSearch
	// template](http://www.opensearch.org/specifications/opensea
	// rch/1.1#opensearch_url_template_syntax)
	// for this API.
	Template string `json:"template,omitempty"`

	// Type: The MIME type of the OpenSearch URL template for the Custom
	// Search JSON
	// API.
	Type string `json:"type,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Template") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Template") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

SearchUrl: OpenSearch template and URL.

func (*SearchUrl) MarshalJSON 

func (s *SearchUrl) MarshalJSON() ([]byte, error)

type Service 

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Cse *CseService
	// contains filtered or unexported fields
}

func New deprecated 

func New(client *http.Client) (*Service, error)

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

func NewService added in v0.3.0 

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.