• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<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="bigquerydatatransfer_v1.html">BigQuery Data Transfer Service API</a> . <a href="bigquerydatatransfer_v1.projects.html">projects</a> . <a href="bigquerydatatransfer_v1.projects.dataSources.html">dataSources</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#checkValidCreds">checkValidCreds(name, body, x__xgafv=None)</a></code></p>
79<p class="firstline">Returns true if valid credentials exist for the given data source and</p>
80<p class="toc_element">
81  <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
82<p class="firstline">Retrieves a supported data source and returns its settings,</p>
83<p class="toc_element">
84  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
85<p class="firstline">Lists supported data sources and returns their settings,</p>
86<p class="toc_element">
87  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
88<p class="firstline">Retrieves the next page of results.</p>
89<h3>Method Details</h3>
90<div class="method">
91    <code class="details" id="checkValidCreds">checkValidCreds(name, body, x__xgafv=None)</code>
92  <pre>Returns true if valid credentials exist for the given data source and
93requesting user.
94
95Args:
96  name: string, The data source in the form:
97`projects/{project_id}/dataSources/{data_source_id}` (required)
98  body: object, The request body. (required)
99    The object takes the form of:
100
101{ # A request to determine whether the user has valid credentials. This method
102      # is used to limit the number of OAuth popups in the user interface. The
103      # user id is inferred from the API call context.
104      # If the data source has the Google+ authorization type, this method
105      # returns false, as it cannot be determined whether the credentials are
106      # already valid merely based on the user id.
107  }
108
109  x__xgafv: string, V1 error format.
110    Allowed values
111      1 - v1 error format
112      2 - v2 error format
113
114Returns:
115  An object of the form:
116
117    { # A response indicating whether the credentials exist and are valid.
118    "hasValidCreds": True or False, # If set to `true`, the credentials exist and are valid.
119  }</pre>
120</div>
121
122<div class="method">
123    <code class="details" id="get">get(name, x__xgafv=None)</code>
124  <pre>Retrieves a supported data source and returns its settings,
125which can be used for UI rendering.
126
127Args:
128  name: string, The field will contain name of the resource requested, for example:
129`projects/{project_id}/dataSources/{data_source_id}` (required)
130  x__xgafv: string, V1 error format.
131    Allowed values
132      1 - v1 error format
133      2 - v2 error format
134
135Returns:
136  An object of the form:
137
138    { # Represents data source metadata. Metadata is sufficient to
139      # render UI and request proper OAuth tokens.
140    "scopes": [ # Api auth scopes for which refresh token needs to be obtained. Only valid
141        # when `client_id` is specified. Ignored otherwise. These are scopes needed
142        # by a data source to prepare data and ingest them into BigQuery,
143        # e.g., https://www.googleapis.com/auth/bigquery
144      "A String",
145    ],
146    "helpUrl": "A String", # Url for the help document for this data source.
147    "displayName": "A String", # User friendly data source name.
148    "name": "A String", # Data source resource name.
149    "dataRefreshType": "A String", # Specifies whether the data source supports automatic data refresh for the
150        # past few days, and how it's supported.
151        # For some data sources, data might not be complete until a few days later,
152        # so it's useful to refresh data automatically.
153    "authorizationType": "A String", # Indicates the type of authorization.
154    "description": "A String", # User friendly data source description string.
155    "clientId": "A String", # Data source client id which should be used to receive refresh token.
156        # When not supplied, no offline credentials are populated for data transfer.
157    "statusUpdateDeadlineSeconds": 42, # The number of seconds to wait for a status update from the data source
158        # before BigQuery marks the transfer as failed.
159    "manualRunsDisabled": True or False, # Disables backfilling and manual run scheduling
160        # for the data source.
161    "defaultSchedule": "A String", # Default data transfer schedule.
162        # Examples of valid schedules include:
163        # `1st,3rd monday of month 15:30`,
164        # `every wed,fri of jan,jun 13:15`, and
165        # `first sunday of quarter 00:00`.
166    "dataSourceId": "A String", # Data source id.
167    "defaultDataRefreshWindowDays": 42, # Default data refresh window on days.
168        # Only meaningful when `data_refresh_type` = `SLIDING_WINDOW`.
169    "supportsMultipleTransfers": True or False, # Indicates whether the data source supports multiple transfers
170        # to different BigQuery targets.
171    "supportsCustomSchedule": True or False, # Specifies whether the data source supports a user defined schedule, or
172        # operates on the default schedule.
173        # When set to `true`, user can override default schedule.
174    "parameters": [ # Data source parameters.
175      { # Represents a data source parameter with validation rules, so that
176          # parameters can be rendered in the UI. These parameters are given to us by
177          # supported data sources, and include all needed information for rendering
178          # and validation.
179          # Thus, whoever uses this api can decide to generate either generic ui,
180          # or custom data source specific forms.
181        "displayName": "A String", # Parameter display name in the user interface.
182        "description": "A String", # Parameter description.
183        "validationDescription": "A String", # Description of the requirements for this field, in case the user input does
184            # not fulfill the regex pattern or min/max values.
185        "fields": [ # When parameter is a record, describes child fields.
186          # Object with schema name: DataSourceParameter
187        ],
188        "required": True or False, # Is parameter required.
189        "allowedValues": [ # All possible values for the parameter.
190          "A String",
191        ],
192        "maxValue": 3.14, # For integer and double values specifies maxminum allowed value.
193        "minValue": 3.14, # For integer and double values specifies minimum allowed value.
194        "repeated": True or False, # Can parameter have multiple values.
195        "recurse": True or False, # If set to true, schema should be taken from the parent with the same
196            # parameter_id. Only applicable when parameter type is RECORD.
197        "validationRegex": "A String", # Regular expression which can be used for parameter validation.
198        "validationHelpUrl": "A String", # URL to a help document to further explain the naming requirements.
199        "paramId": "A String", # Parameter identifier.
200        "type": "A String", # Parameter type.
201        "immutable": True or False, # Cannot be changed after initial creation.
202      },
203    ],
204    "transferType": "A String", # Transfer type. Currently supports only batch transfers,
205        # which are transfers that use the BigQuery batch APIs (load or
206        # query) to ingest the data.
207  }</pre>
208</div>
209
210<div class="method">
211    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
212  <pre>Lists supported data sources and returns their settings,
213which can be used for UI rendering.
214
215Args:
216  parent: string, The BigQuery project id for which data sources should be returned.
217Must be in the form: `projects/{project_id}` (required)
218  pageToken: string, Pagination token, which can be used to request a specific page
219of `ListDataSourcesRequest` list results. For multiple-page
220results, `ListDataSourcesResponse` outputs
221a `next_page` token, which can be used as the
222`page_token` value to request the next page of list results.
223  x__xgafv: string, V1 error format.
224    Allowed values
225      1 - v1 error format
226      2 - v2 error format
227  pageSize: integer, Page size. The default page size is the maximum value of 1000 results.
228
229Returns:
230  An object of the form:
231
232    { # Returns list of supported data sources and their metadata.
233    "nextPageToken": "A String", # The next-pagination token. For multiple-page list results,
234        # this token can be used as the
235        # `ListDataSourcesRequest.page_token`
236        # to request the next page of list results.
237        # @OutputOnly
238    "dataSources": [ # List of supported data sources and their transfer settings.
239      { # Represents data source metadata. Metadata is sufficient to
240          # render UI and request proper OAuth tokens.
241        "scopes": [ # Api auth scopes for which refresh token needs to be obtained. Only valid
242            # when `client_id` is specified. Ignored otherwise. These are scopes needed
243            # by a data source to prepare data and ingest them into BigQuery,
244            # e.g., https://www.googleapis.com/auth/bigquery
245          "A String",
246        ],
247        "helpUrl": "A String", # Url for the help document for this data source.
248        "displayName": "A String", # User friendly data source name.
249        "name": "A String", # Data source resource name.
250        "dataRefreshType": "A String", # Specifies whether the data source supports automatic data refresh for the
251            # past few days, and how it's supported.
252            # For some data sources, data might not be complete until a few days later,
253            # so it's useful to refresh data automatically.
254        "authorizationType": "A String", # Indicates the type of authorization.
255        "description": "A String", # User friendly data source description string.
256        "clientId": "A String", # Data source client id which should be used to receive refresh token.
257            # When not supplied, no offline credentials are populated for data transfer.
258        "statusUpdateDeadlineSeconds": 42, # The number of seconds to wait for a status update from the data source
259            # before BigQuery marks the transfer as failed.
260        "manualRunsDisabled": True or False, # Disables backfilling and manual run scheduling
261            # for the data source.
262        "defaultSchedule": "A String", # Default data transfer schedule.
263            # Examples of valid schedules include:
264            # `1st,3rd monday of month 15:30`,
265            # `every wed,fri of jan,jun 13:15`, and
266            # `first sunday of quarter 00:00`.
267        "dataSourceId": "A String", # Data source id.
268        "defaultDataRefreshWindowDays": 42, # Default data refresh window on days.
269            # Only meaningful when `data_refresh_type` = `SLIDING_WINDOW`.
270        "supportsMultipleTransfers": True or False, # Indicates whether the data source supports multiple transfers
271            # to different BigQuery targets.
272        "supportsCustomSchedule": True or False, # Specifies whether the data source supports a user defined schedule, or
273            # operates on the default schedule.
274            # When set to `true`, user can override default schedule.
275        "parameters": [ # Data source parameters.
276          { # Represents a data source parameter with validation rules, so that
277              # parameters can be rendered in the UI. These parameters are given to us by
278              # supported data sources, and include all needed information for rendering
279              # and validation.
280              # Thus, whoever uses this api can decide to generate either generic ui,
281              # or custom data source specific forms.
282            "displayName": "A String", # Parameter display name in the user interface.
283            "description": "A String", # Parameter description.
284            "validationDescription": "A String", # Description of the requirements for this field, in case the user input does
285                # not fulfill the regex pattern or min/max values.
286            "fields": [ # When parameter is a record, describes child fields.
287              # Object with schema name: DataSourceParameter
288            ],
289            "required": True or False, # Is parameter required.
290            "allowedValues": [ # All possible values for the parameter.
291              "A String",
292            ],
293            "maxValue": 3.14, # For integer and double values specifies maxminum allowed value.
294            "minValue": 3.14, # For integer and double values specifies minimum allowed value.
295            "repeated": True or False, # Can parameter have multiple values.
296            "recurse": True or False, # If set to true, schema should be taken from the parent with the same
297                # parameter_id. Only applicable when parameter type is RECORD.
298            "validationRegex": "A String", # Regular expression which can be used for parameter validation.
299            "validationHelpUrl": "A String", # URL to a help document to further explain the naming requirements.
300            "paramId": "A String", # Parameter identifier.
301            "type": "A String", # Parameter type.
302            "immutable": True or False, # Cannot be changed after initial creation.
303          },
304        ],
305        "transferType": "A String", # Transfer type. Currently supports only batch transfers,
306            # which are transfers that use the BigQuery batch APIs (load or
307            # query) to ingest the data.
308      },
309    ],
310  }</pre>
311</div>
312
313<div class="method">
314    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
315  <pre>Retrieves the next page of results.
316
317Args:
318  previous_request: The request for the previous page. (required)
319  previous_response: The response from the request for the previous page. (required)
320
321Returns:
322  A request object that you can call 'execute()' on to request the next
323  page. Returns None if there are no more items in the collection.
324    </pre>
325</div>
326
327</body></html>