|
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134 |
- // 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 "google.golang.org/api/customsearch/v1"
-
- import (
- "bytes"
- "encoding/json"
- "errors"
- "fmt"
- context "golang.org/x/net/context"
- ctxhttp "golang.org/x/net/context/ctxhttp"
- gensupport "google.golang.org/api/gensupport"
- googleapi "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 _ = gensupport.MarshalJSON
- var _ = googleapi.Version
- var _ = errors.New
- var _ = strings.Replace
- var _ = context.Canceled
- var _ = ctxhttp.Do
-
- 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
- UserAgent string // optional additional User-Agent fragment
-
- Cse *CseService
- }
-
- func (s *Service) userAgent() string {
- if s.UserAgent == "" {
- return googleapi.UserAgent
- }
- return googleapi.UserAgent + " " + s.UserAgent
- }
-
- func NewCseService(s *Service) *CseService {
- rs := &CseService{s: s}
- rs.Siterestrict = NewCseSiterestrictService(s)
- return rs
- }
-
- type CseService struct {
- s *Service
-
- Siterestrict *CseSiterestrictService
- }
-
- func NewCseSiterestrictService(s *Service) *CseSiterestrictService {
- rs := &CseSiterestrictService{s: s}
- return rs
- }
-
- type CseSiterestrictService struct {
- s *Service
- }
-
- type Context struct {
- Facets [][]*ContextFacetsItem `json:"facets,omitempty"`
-
- Title string `json:"title,omitempty"`
-
- // ForceSendFields is a list of field names (e.g. "Facets") 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. "Facets") 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:"-"`
- }
-
- func (s *Context) MarshalJSON() ([]byte, error) {
- type NoMethod Context
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type ContextFacetsItem struct {
- Anchor string `json:"anchor,omitempty"`
-
- Label string `json:"label,omitempty"`
-
- LabelWithOp string `json:"label_with_op,omitempty"`
-
- // ForceSendFields is a list of field names (e.g. "Anchor") 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. "Anchor") 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:"-"`
- }
-
- func (s *ContextFacetsItem) MarshalJSON() ([]byte, error) {
- type NoMethod ContextFacetsItem
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- 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"`
-
- // 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:"-"`
- }
-
- func (s *Promotion) MarshalJSON() ([]byte, error) {
- type NoMethod Promotion
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type PromotionBodyLines struct {
- HtmlTitle string `json:"htmlTitle,omitempty"`
-
- Link string `json:"link,omitempty"`
-
- Title string `json:"title,omitempty"`
-
- 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:"-"`
- }
-
- func (s *PromotionBodyLines) MarshalJSON() ([]byte, error) {
- type NoMethod PromotionBodyLines
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type PromotionImage struct {
- Height int64 `json:"height,omitempty"`
-
- Source string `json:"source,omitempty"`
-
- 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:"-"`
- }
-
- func (s *PromotionImage) MarshalJSON() ([]byte, error) {
- type NoMethod PromotionImage
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type Query struct {
- Count int64 `json:"count,omitempty"`
-
- Cr string `json:"cr,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"`
-
- // 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:"-"`
- }
-
- func (s *Query) MarshalJSON() ([]byte, error) {
- type NoMethod Query
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- 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 map[string][]googleapi.RawMessage `json:"pagemap,omitempty"`
-
- Snippet string `json:"snippet,omitempty"`
-
- 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:"-"`
- }
-
- func (s *Result) MarshalJSON() ([]byte, error) {
- type NoMethod Result
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- 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"`
-
- // 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:"-"`
- }
-
- func (s *ResultImage) MarshalJSON() ([]byte, error) {
- type NoMethod ResultImage
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type ResultLabels struct {
- DisplayName string `json:"displayName,omitempty"`
-
- LabelWithOp string `json:"label_with_op,omitempty"`
-
- 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:"-"`
- }
-
- func (s *ResultLabels) MarshalJSON() ([]byte, error) {
- type NoMethod ResultLabels
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- 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"`
-
- // 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:"-"`
- }
-
- func (s *Search) MarshalJSON() ([]byte, error) {
- type NoMethod Search
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type SearchSearchInformation struct {
- FormattedSearchTime string `json:"formattedSearchTime,omitempty"`
-
- FormattedTotalResults string `json:"formattedTotalResults,omitempty"`
-
- SearchTime float64 `json:"searchTime,omitempty"`
-
- TotalResults int64 `json:"totalResults,omitempty,string"`
-
- // 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:"-"`
- }
-
- func (s *SearchSearchInformation) MarshalJSON() ([]byte, error) {
- type NoMethod SearchSearchInformation
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- func (s *SearchSearchInformation) UnmarshalJSON(data []byte) error {
- type NoMethod SearchSearchInformation
- var s1 struct {
- SearchTime gensupport.JSONFloat64 `json:"searchTime"`
- *NoMethod
- }
- s1.NoMethod = (*NoMethod)(s)
- if err := json.Unmarshal(data, &s1); err != nil {
- return err
- }
- s.SearchTime = float64(s1.SearchTime)
- return nil
- }
-
- type SearchSpelling struct {
- CorrectedQuery string `json:"correctedQuery,omitempty"`
-
- 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:"-"`
- }
-
- func (s *SearchSpelling) MarshalJSON() ([]byte, error) {
- type NoMethod SearchSpelling
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- type SearchUrl struct {
- Template string `json:"template,omitempty"`
-
- 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:"-"`
- }
-
- func (s *SearchUrl) MarshalJSON() ([]byte, error) {
- type NoMethod SearchUrl
- raw := NoMethod(*s)
- return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
- }
-
- // method id "search.cse.list":
-
- type CseListCall struct {
- s *Service
- urlParams_ gensupport.URLParams
- ifNoneMatch_ string
- ctx_ context.Context
- header_ http.Header
- }
-
- // 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, urlParams_: make(gensupport.URLParams)}
- c.urlParams_.Set("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.urlParams_.Set("c2coff", c2coff)
- return c
- }
-
- // Cr sets the optional parameter "cr": Country restrict(s).
- func (c *CseListCall) Cr(cr string) *CseListCall {
- c.urlParams_.Set("cr", cr)
- 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.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("fileType", fileType)
- return c
- }
-
- // Filter sets the optional parameter "filter": Controls turning on or
- // off the duplicate content filter.
- //
- // Possible values:
- // "0" - Turns off duplicate content filter.
- // "1" - Turns on duplicate content filter.
- func (c *CseListCall) Filter(filter string) *CseListCall {
- c.urlParams_.Set("filter", filter)
- return c
- }
-
- // Gl sets the optional parameter "gl": Geolocation of end user.
- func (c *CseListCall) Gl(gl string) *CseListCall {
- c.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("highRange", highRange)
- return c
- }
-
- // Hl sets the optional parameter "hl": Sets the user interface
- // language.
- func (c *CseListCall) Hl(hl string) *CseListCall {
- c.urlParams_.Set("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.urlParams_.Set("hq", hq)
- return c
- }
-
- // ImgColorType sets the optional parameter "imgColorType": Returns
- // black and white, grayscale, or color images: mono, gray, and color.
- //
- // Possible values:
- // "color" - color
- // "gray" - gray
- // "mono" - mono
- func (c *CseListCall) ImgColorType(imgColorType string) *CseListCall {
- c.urlParams_.Set("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.
- //
- // Possible values:
- // "black" - black
- // "blue" - blue
- // "brown" - brown
- // "gray" - gray
- // "green" - green
- // "pink" - pink
- // "purple" - purple
- // "teal" - teal
- // "white" - white
- // "yellow" - yellow
- func (c *CseListCall) ImgDominantColor(imgDominantColor string) *CseListCall {
- c.urlParams_.Set("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.
- //
- // Possible values:
- // "huge" - huge
- // "icon" - icon
- // "large" - large
- // "medium" - medium
- // "small" - small
- // "xlarge" - xlarge
- // "xxlarge" - xxlarge
- func (c *CseListCall) ImgSize(imgSize string) *CseListCall {
- c.urlParams_.Set("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.
- //
- // Possible values:
- // "clipart" - clipart
- // "face" - face
- // "lineart" - lineart
- // "news" - news
- // "photo" - photo
- func (c *CseListCall) ImgType(imgType string) *CseListCall {
- c.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("lowRange", lowRange)
- return c
- }
-
- // Lr sets the optional parameter "lr": The language restriction for the
- // search results
- //
- // Possible values:
- // "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 (c *CseListCall) Lr(lr string) *CseListCall {
- c.urlParams_.Set("lr", lr)
- return c
- }
-
- // Num sets the optional parameter "num": Number of search results to
- // return
- func (c *CseListCall) Num(num int64) *CseListCall {
- c.urlParams_.Set("num", fmt.Sprint(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.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("rights", rights)
- return c
- }
-
- // Safe sets the optional parameter "safe": Search safety level
- //
- // Possible values:
- // "high" - Enables highest level of safe search filtering.
- // "medium" - Enables moderate safe search filtering.
- // "off" (default) - Disables safe search filtering.
- func (c *CseListCall) Safe(safe string) *CseListCall {
- c.urlParams_.Set("safe", safe)
- return c
- }
-
- // SearchType sets the optional parameter "searchType": Specifies the
- // search type: image.
- //
- // Possible values:
- // "image" - custom image search
- func (c *CseListCall) SearchType(searchType string) *CseListCall {
- c.urlParams_.Set("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.urlParams_.Set("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
- //
- // Possible values:
- // "e" - exclude
- // "i" - include
- func (c *CseListCall) SiteSearchFilter(siteSearchFilter string) *CseListCall {
- c.urlParams_.Set("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.urlParams_.Set("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.urlParams_.Set("start", fmt.Sprint(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.urlParams_.Set("fields", googleapi.CombineFields(s))
- return c
- }
-
- // 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 (c *CseListCall) IfNoneMatch(entityTag string) *CseListCall {
- c.ifNoneMatch_ = entityTag
- return c
- }
-
- // 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 (c *CseListCall) Context(ctx context.Context) *CseListCall {
- c.ctx_ = ctx
- return c
- }
-
- // Header returns an http.Header that can be modified by the caller to
- // add HTTP headers to the request.
- func (c *CseListCall) Header() http.Header {
- if c.header_ == nil {
- c.header_ = make(http.Header)
- }
- return c.header_
- }
-
- func (c *CseListCall) doRequest(alt string) (*http.Response, error) {
- reqHeaders := make(http.Header)
- for k, v := range c.header_ {
- reqHeaders[k] = v
- }
- reqHeaders.Set("User-Agent", c.s.userAgent())
- if c.ifNoneMatch_ != "" {
- reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
- }
- var body io.Reader = nil
- c.urlParams_.Set("alt", alt)
- urls := googleapi.ResolveRelative(c.s.BasePath, "v1")
- urls += "?" + c.urlParams_.Encode()
- req, _ := http.NewRequest("GET", urls, body)
- req.Header = reqHeaders
- return gensupport.SendRequest(c.ctx_, c.s.client, req)
- }
-
- // 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 (c *CseListCall) Do(opts ...googleapi.CallOption) (*Search, error) {
- gensupport.SetOptions(c.urlParams_, opts...)
- res, err := c.doRequest("json")
- if res != nil && res.StatusCode == http.StatusNotModified {
- if res.Body != nil {
- res.Body.Close()
- }
- return nil, &googleapi.Error{
- Code: res.StatusCode,
- Header: res.Header,
- }
- }
- if err != nil {
- return nil, err
- }
- defer googleapi.CloseBody(res)
- if err := googleapi.CheckResponse(res); err != nil {
- return nil, err
- }
- ret := &Search{
- ServerResponse: googleapi.ServerResponse{
- Header: res.Header,
- HTTPStatusCode: res.StatusCode,
- },
- }
- target := &ret
- if err := gensupport.DecodeResponse(target, res); 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"
- // },
- // "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"
- // }
- // }
-
- }
-
- // method id "search.cse.siterestrict.list":
-
- type CseSiterestrictListCall struct {
- s *Service
- urlParams_ gensupport.URLParams
- ifNoneMatch_ string
- ctx_ context.Context
- header_ http.Header
- }
-
- // List: (Closed Beta API) Returns metadata about the search performed,
- // metadata about the custom search engine used for the search, and the
- // search results only for site-restrict cses.
- func (r *CseSiterestrictService) List(q string) *CseSiterestrictListCall {
- c := &CseSiterestrictListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
- c.urlParams_.Set("q", q)
- return c
- }
-
- // C2coff sets the optional parameter "c2coff": Turns off the
- // translation between zh-CN and zh-TW.
- func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall {
- c.urlParams_.Set("c2coff", c2coff)
- return c
- }
-
- // Cr sets the optional parameter "cr": Country restrict(s).
- func (c *CseSiterestrictListCall) Cr(cr string) *CseSiterestrictListCall {
- c.urlParams_.Set("cr", cr)
- return c
- }
-
- // Cx sets the optional parameter "cx": The custom search engine ID to
- // scope this search query
- func (c *CseSiterestrictListCall) Cx(cx string) *CseSiterestrictListCall {
- c.urlParams_.Set("cx", cx)
- return c
- }
-
- // DateRestrict sets the optional parameter "dateRestrict": Specifies
- // all search results are from a time period
- func (c *CseSiterestrictListCall) DateRestrict(dateRestrict string) *CseSiterestrictListCall {
- c.urlParams_.Set("dateRestrict", dateRestrict)
- return c
- }
-
- // ExactTerms sets the optional parameter "exactTerms": Identifies a
- // phrase that all documents in the search results must contain
- func (c *CseSiterestrictListCall) ExactTerms(exactTerms string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) ExcludeTerms(excludeTerms string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) FileType(fileType string) *CseSiterestrictListCall {
- c.urlParams_.Set("fileType", fileType)
- return c
- }
-
- // Filter sets the optional parameter "filter": Controls turning on or
- // off the duplicate content filter.
- //
- // Possible values:
- // "0" - Turns off duplicate content filter.
- // "1" - Turns on duplicate content filter.
- func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall {
- c.urlParams_.Set("filter", filter)
- return c
- }
-
- // Gl sets the optional parameter "gl": Geolocation of end user.
- func (c *CseSiterestrictListCall) Gl(gl string) *CseSiterestrictListCall {
- c.urlParams_.Set("gl", gl)
- return c
- }
-
- // Googlehost sets the optional parameter "googlehost": The local Google
- // domain to use to perform the search.
- func (c *CseSiterestrictListCall) Googlehost(googlehost string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) HighRange(highRange string) *CseSiterestrictListCall {
- c.urlParams_.Set("highRange", highRange)
- return c
- }
-
- // Hl sets the optional parameter "hl": Sets the user interface
- // language.
- func (c *CseSiterestrictListCall) Hl(hl string) *CseSiterestrictListCall {
- c.urlParams_.Set("hl", hl)
- return c
- }
-
- // Hq sets the optional parameter "hq": Appends the extra query terms to
- // the query.
- func (c *CseSiterestrictListCall) Hq(hq string) *CseSiterestrictListCall {
- c.urlParams_.Set("hq", hq)
- return c
- }
-
- // ImgColorType sets the optional parameter "imgColorType": Returns
- // black and white, grayscale, or color images: mono, gray, and color.
- //
- // Possible values:
- // "color" - color
- // "gray" - gray
- // "mono" - mono
- func (c *CseSiterestrictListCall) ImgColorType(imgColorType string) *CseSiterestrictListCall {
- c.urlParams_.Set("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.
- //
- // Possible values:
- // "black" - black
- // "blue" - blue
- // "brown" - brown
- // "gray" - gray
- // "green" - green
- // "pink" - pink
- // "purple" - purple
- // "teal" - teal
- // "white" - white
- // "yellow" - yellow
- func (c *CseSiterestrictListCall) ImgDominantColor(imgDominantColor string) *CseSiterestrictListCall {
- c.urlParams_.Set("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.
- //
- // Possible values:
- // "huge" - huge
- // "icon" - icon
- // "large" - large
- // "medium" - medium
- // "small" - small
- // "xlarge" - xlarge
- // "xxlarge" - xxlarge
- func (c *CseSiterestrictListCall) ImgSize(imgSize string) *CseSiterestrictListCall {
- c.urlParams_.Set("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.
- //
- // Possible values:
- // "clipart" - clipart
- // "face" - face
- // "lineart" - lineart
- // "news" - news
- // "photo" - photo
- func (c *CseSiterestrictListCall) ImgType(imgType string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) LinkSite(linkSite string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) LowRange(lowRange string) *CseSiterestrictListCall {
- c.urlParams_.Set("lowRange", lowRange)
- return c
- }
-
- // Lr sets the optional parameter "lr": The language restriction for the
- // search results
- //
- // Possible values:
- // "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 (c *CseSiterestrictListCall) Lr(lr string) *CseSiterestrictListCall {
- c.urlParams_.Set("lr", lr)
- return c
- }
-
- // Num sets the optional parameter "num": Number of search results to
- // return
- func (c *CseSiterestrictListCall) Num(num int64) *CseSiterestrictListCall {
- c.urlParams_.Set("num", fmt.Sprint(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 *CseSiterestrictListCall) OrTerms(orTerms string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) RelatedSite(relatedSite string) *CseSiterestrictListCall {
- c.urlParams_.Set("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 *CseSiterestrictListCall) Rights(rights string) *CseSiterestrictListCall {
- c.urlParams_.Set("rights", rights)
- return c
- }
-
- // Safe sets the optional parameter "safe": Search safety level
- //
- // Possible values:
- // "high" - Enables highest level of safe search filtering.
- // "medium" - Enables moderate safe search filtering.
- // "off" (default) - Disables safe search filtering.
- func (c *CseSiterestrictListCall) Safe(safe string) *CseSiterestrictListCall {
- c.urlParams_.Set("safe", safe)
- return c
- }
-
- // SearchType sets the optional parameter "searchType": Specifies the
- // search type: image.
- //
- // Possible values:
- // "image" - custom image search
- func (c *CseSiterestrictListCall) SearchType(searchType string) *CseSiterestrictListCall {
- c.urlParams_.Set("searchType", searchType)
- return c
- }
-
- // SiteSearch sets the optional parameter "siteSearch": Specifies all
- // search results should be pages from a given site
- func (c *CseSiterestrictListCall) SiteSearch(siteSearch string) *CseSiterestrictListCall {
- c.urlParams_.Set("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
- //
- // Possible values:
- // "e" - exclude
- // "i" - include
- func (c *CseSiterestrictListCall) SiteSearchFilter(siteSearchFilter string) *CseSiterestrictListCall {
- c.urlParams_.Set("siteSearchFilter", siteSearchFilter)
- return c
- }
-
- // Sort sets the optional parameter "sort": The sort expression to apply
- // to the results
- func (c *CseSiterestrictListCall) Sort(sort string) *CseSiterestrictListCall {
- c.urlParams_.Set("sort", sort)
- return c
- }
-
- // Start sets the optional parameter "start": The index of the first
- // result to return
- func (c *CseSiterestrictListCall) Start(start int64) *CseSiterestrictListCall {
- c.urlParams_.Set("start", fmt.Sprint(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 *CseSiterestrictListCall) Fields(s ...googleapi.Field) *CseSiterestrictListCall {
- c.urlParams_.Set("fields", googleapi.CombineFields(s))
- return c
- }
-
- // 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 (c *CseSiterestrictListCall) IfNoneMatch(entityTag string) *CseSiterestrictListCall {
- c.ifNoneMatch_ = entityTag
- return c
- }
-
- // 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 (c *CseSiterestrictListCall) Context(ctx context.Context) *CseSiterestrictListCall {
- c.ctx_ = ctx
- return c
- }
-
- // Header returns an http.Header that can be modified by the caller to
- // add HTTP headers to the request.
- func (c *CseSiterestrictListCall) Header() http.Header {
- if c.header_ == nil {
- c.header_ = make(http.Header)
- }
- return c.header_
- }
-
- func (c *CseSiterestrictListCall) doRequest(alt string) (*http.Response, error) {
- reqHeaders := make(http.Header)
- for k, v := range c.header_ {
- reqHeaders[k] = v
- }
- reqHeaders.Set("User-Agent", c.s.userAgent())
- if c.ifNoneMatch_ != "" {
- reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
- }
- var body io.Reader = nil
- c.urlParams_.Set("alt", alt)
- urls := googleapi.ResolveRelative(c.s.BasePath, "v1/siterestrict")
- urls += "?" + c.urlParams_.Encode()
- req, _ := http.NewRequest("GET", urls, body)
- req.Header = reqHeaders
- return gensupport.SendRequest(c.ctx_, c.s.client, req)
- }
-
- // 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 (c *CseSiterestrictListCall) Do(opts ...googleapi.CallOption) (*Search, error) {
- gensupport.SetOptions(c.urlParams_, opts...)
- res, err := c.doRequest("json")
- if res != nil && res.StatusCode == http.StatusNotModified {
- if res.Body != nil {
- res.Body.Close()
- }
- return nil, &googleapi.Error{
- Code: res.StatusCode,
- Header: res.Header,
- }
- }
- if err != nil {
- return nil, err
- }
- defer googleapi.CloseBody(res)
- if err := googleapi.CheckResponse(res); err != nil {
- return nil, err
- }
- ret := &Search{
- ServerResponse: googleapi.ServerResponse{
- Header: res.Header,
- HTTPStatusCode: res.StatusCode,
- },
- }
- target := &ret
- if err := gensupport.DecodeResponse(target, res); err != nil {
- return nil, err
- }
- return ret, nil
- // {
- // "description": "(Closed Beta API) Returns metadata about the search performed, metadata about the custom search engine used for the search, and the search results only for site-restrict cses.",
- // "httpMethod": "GET",
- // "id": "search.cse.siterestrict.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"
- // },
- // "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/siterestrict",
- // "response": {
- // "$ref": "Search"
- // }
- // }
-
- }
|