blob: 579499c283c7cb78adbbe1d0755e8e7b0f5bc193 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="cloudsearch_v1.html">Cloud Search API</a> . <a href="cloudsearch_v1.query.html">query</a> . <a href="cloudsearch_v1.query.sources.html">sources</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#list">list(requestOptions_timeZone=None, pageToken=None, requestOptions_debugOptions_enableDebugging=None, requestOptions_searchApplicationId=None, requestOptions_languageCode=None, x__xgafv=None)</a></code></p>
79<p class="firstline">Returns list of sources that user can use for Search and Suggest APIs.</p>
80<p class="toc_element">
81 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
82<p class="firstline">Retrieves the next page of results.</p>
83<h3>Method Details</h3>
84<div class="method">
85 <code class="details" id="list">list(requestOptions_timeZone=None, pageToken=None, requestOptions_debugOptions_enableDebugging=None, requestOptions_searchApplicationId=None, requestOptions_languageCode=None, x__xgafv=None)</code>
86 <pre>Returns list of sources that user can use for Search and Suggest APIs.
87
Dan O'Mearadd494642020-05-01 07:42:23 -070088**Note:** This API requires a standard end user account to execute.
89A service account can't perform Query API requests directly; to use a
90service account to perform queries, set up [G Suite domain-wide delegation
91of
92authority](https://developers.google.com/cloud-search/docs/guides/delegation/).
93
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070094Args:
95 requestOptions_timeZone: string, Current user's time zone id, such as "America/Los_Angeles" or
96"Australia/Sydney". These IDs are defined by
97[Unicode Common Locale Data Repository (CLDR)](http://cldr.unicode.org/)
98project, and currently available in the file
Dan O'Mearadd494642020-05-01 07:42:23 -070099[timezone.xml](http://unicode.org/repos/cldr/trunk/common/bcp47/timezone.xml).
100This field is used to correctly interpret date and time queries.
101If this field is not specified, the default time zone (UTC) is used.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700102 pageToken: string, Number of sources to return in the response.
103 requestOptions_debugOptions_enableDebugging: boolean, If you are asked by Google to help with debugging, set this field.
104Otherwise, ignore this field.
Dan O'Mearadd494642020-05-01 07:42:23 -0700105 requestOptions_searchApplicationId: string, The ID generated when you create a search application using the
106[admin console](https://support.google.com/a/answer/9043922).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700107 requestOptions_languageCode: string, The BCP-47 language code, such as "en-US" or "sr-Latn".
108For more information, see
109http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
110For translations.
111
Dan O'Mearadd494642020-05-01 07:42:23 -0700112Set this field using the language set in browser or for the page. In the
113event that the user's language preference is known, set this field to the
114known user language.
115
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700116When specified, the documents in search results are biased towards the
117specified language.
Dan O'Mearadd494642020-05-01 07:42:23 -0700118
119The suggest API does not use this parameter. Instead, suggest autocompletes
120only based on characters in the query.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700121 x__xgafv: string, V1 error format.
122 Allowed values
123 1 - v1 error format
124 2 - v2 error format
125
126Returns:
127 An object of the form:
128
129 { # List sources response.
130 "nextPageToken": "A String",
131 "sources": [
132 { # List of sources that the user can search using the query API.
133 "source": { # Defines sources for the suggest/search APIs. # Name of the source
134 "predefinedSource": "A String", # Predefined content source for Google Apps.
135 "name": "A String", # Source name for content indexed by the
136 # Indexing API.
137 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700138 "operators": [ # List of all operators applicable for this source.
139 { # The definition of a operator that can be used in a Search/Suggest request.
140 "enumValues": [ # Potential list of values for the opeatror field. This field is only filled
141 # when we can safely enumerate all the possible values of this operator.
142 "A String",
143 ],
144 "displayName": "A String", # Display name of the operator
145 "greaterThanOperatorName": "A String", # Indicates the operator name that can be used to isolate the property using
146 # the greater-than operator.
147 "isReturnable": True or False, # Will the property associated with this facet be returned as part of search
148 # results.
149 "lessThanOperatorName": "A String", # Indicates the operator name that can be used to isolate the property using
150 # the less-than operator.
151 "isRepeatable": True or False, # Indicates if multiple values can be set for this property.
152 "isFacetable": True or False, # Can this operator be used to get facets.
Dan O'Mearadd494642020-05-01 07:42:23 -0700153 "isSuggestable": True or False, # Can get suggestions for this field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700154 "type": "A String", # Type of the operator.
155 "operatorName": "A String", # The name of the operator.
156 "isSortable": True or False, # Can this operator be used to sort results.
Dan O'Mearadd494642020-05-01 07:42:23 -0700157 "objectType": "A String", # Name of the object corresponding to the operator. This field is only filled
158 # for schema-specific operators, and is unset for common operators.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700159 },
160 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700161 "displayName": "A String", # Display name of the data source.
162 "shortName": "A String", # A short name or alias for the source. This value can be used with the
163 # 'source' operator.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700164 },
165 ],
166 }</pre>
167</div>
168
169<div class="method">
170 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
171 <pre>Retrieves the next page of results.
172
173Args:
174 previous_request: The request for the previous page. (required)
175 previous_response: The response from the request for the previous page. (required)
176
177Returns:
178 A request object that you can call 'execute()' on to request the next
179 page. Returns None if there are no more items in the collection.
180 </pre>
181</div>
182
183</body></html>