docs: update generated docs (#981)
diff --git a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html
index b96dc1d..a533996 100644
--- a/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html
+++ b/docs/dyn/bigquerydatatransfer_v1.projects.transferConfigs.html
@@ -80,7 +80,7 @@
<p class="firstline">Returns the runs Resource.</p>
<p class="toc_element">
- <code><a href="#create">create(parent, body=None, versionInfo=None, authorizationCode=None, serviceAccountName=None, x__xgafv=None)</a></code></p>
+ <code><a href="#create">create(parent, body=None, authorizationCode=None, serviceAccountName=None, versionInfo=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a new data transfer configuration.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
@@ -89,7 +89,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Returns information about a data transfer config.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, pageSize=None, dataSourceIds=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, dataSourceIds=None, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">Returns information about all data transfers in the project.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -105,7 +105,7 @@
<p class="firstline">Start manual transfer runs to be executed now with schedule_time equal to</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="create">create(parent, body=None, versionInfo=None, authorizationCode=None, serviceAccountName=None, x__xgafv=None)</code>
+ <code class="details" id="create">create(parent, body=None, authorizationCode=None, serviceAccountName=None, versionInfo=None, x__xgafv=None)</code>
<pre>Creates a new data transfer configuration.
Args:
@@ -128,7 +128,6 @@
# for just [today-1].
# Only valid if the data source supports the feature. Set the value to 0
# to use the default value.
- "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"scheduleOptions": { # Options customizing the data transfer schedule. # Options customizing the data transfer schedule.
"endTime": "A String", # Defines time to stop scheduling transfer runs. A transfer run cannot be
# scheduled at or after the end time. The end time can be changed at any
@@ -144,7 +143,10 @@
# StartManualTransferRuns API. When automatic scheduling is disabled, the
# TransferConfig.schedule field will be ignored.
},
+ "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"state": "A String", # Output only. State of the most recently updated transfer run.
+ "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
+ "destinationDatasetId": "A String", # The BigQuery target dataset id.
"name": "A String", # The resource name of the transfer config.
# Transfer config names have the form of
# `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
@@ -152,8 +154,6 @@
# CreateTransferConfigRequest along with project_id and region. If config_id
# is not provided, usually a uuid, even though it is not guaranteed or
# required, will be generated for config_id.
- "destinationDatasetId": "A String", # The BigQuery target dataset id.
- "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
"notificationPubsubTopic": "A String", # Pub/Sub topic where notifications will be sent after transfer runs
# associated with this transfer config finish.
"params": { # Data transfer specific parameters.
@@ -169,6 +169,7 @@
"nextRunTime": "A String", # Output only. Next time when data transfer will run.
"disabled": True or False, # Is this config disabled. When set to true, no runs are scheduled
# for a given transfer.
+ "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
"schedule": "A String", # Data transfer schedule.
# If the data source does not support a custom schedule, this should be
# empty. If it is empty, the default value for the data source will be
@@ -181,15 +182,8 @@
# See more explanation about the format here:
# https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
# NOTE: the granularity should be at least 8 hours, or less frequent.
- "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
}
- versionInfo: string, Optional version info. If users want to find a very recent access token,
-that is, immediately after approving access, users have to set the
-version_info claim in the token request. To obtain the version_info, users
-must use the "none+gsession" response type. which be return a
-version_info back in the authorization response which be be put in a JWT
-claim in the token request.
authorizationCode: string, Optional OAuth2 authorization code to use with this transfer configuration.
This is required if new credentials are needed, as indicated by
`CheckValidCreds`.
@@ -210,6 +204,12 @@
be created with this service account credentials. It requires that
requesting user calling this API has permissions to act as this service
account.
+ versionInfo: string, Optional version info. If users want to find a very recent access token,
+that is, immediately after approving access, users have to set the
+version_info claim in the token request. To obtain the version_info, users
+must use the "none+gsession" response type. which be return a
+version_info back in the authorization response which be be put in a JWT
+claim in the token request.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -230,7 +230,6 @@
# for just [today-1].
# Only valid if the data source supports the feature. Set the value to 0
# to use the default value.
- "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"scheduleOptions": { # Options customizing the data transfer schedule. # Options customizing the data transfer schedule.
"endTime": "A String", # Defines time to stop scheduling transfer runs. A transfer run cannot be
# scheduled at or after the end time. The end time can be changed at any
@@ -246,7 +245,10 @@
# StartManualTransferRuns API. When automatic scheduling is disabled, the
# TransferConfig.schedule field will be ignored.
},
+ "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"state": "A String", # Output only. State of the most recently updated transfer run.
+ "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
+ "destinationDatasetId": "A String", # The BigQuery target dataset id.
"name": "A String", # The resource name of the transfer config.
# Transfer config names have the form of
# `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
@@ -254,8 +256,6 @@
# CreateTransferConfigRequest along with project_id and region. If config_id
# is not provided, usually a uuid, even though it is not guaranteed or
# required, will be generated for config_id.
- "destinationDatasetId": "A String", # The BigQuery target dataset id.
- "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
"notificationPubsubTopic": "A String", # Pub/Sub topic where notifications will be sent after transfer runs
# associated with this transfer config finish.
"params": { # Data transfer specific parameters.
@@ -271,6 +271,7 @@
"nextRunTime": "A String", # Output only. Next time when data transfer will run.
"disabled": True or False, # Is this config disabled. When set to true, no runs are scheduled
# for a given transfer.
+ "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
"schedule": "A String", # Data transfer schedule.
# If the data source does not support a custom schedule, this should be
# empty. If it is empty, the default value for the data source will be
@@ -283,7 +284,6 @@
# See more explanation about the format here:
# https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
# NOTE: the granularity should be at least 8 hours, or less frequent.
- "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
}</pre>
</div>
@@ -344,7 +344,6 @@
# for just [today-1].
# Only valid if the data source supports the feature. Set the value to 0
# to use the default value.
- "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"scheduleOptions": { # Options customizing the data transfer schedule. # Options customizing the data transfer schedule.
"endTime": "A String", # Defines time to stop scheduling transfer runs. A transfer run cannot be
# scheduled at or after the end time. The end time can be changed at any
@@ -360,7 +359,10 @@
# StartManualTransferRuns API. When automatic scheduling is disabled, the
# TransferConfig.schedule field will be ignored.
},
+ "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"state": "A String", # Output only. State of the most recently updated transfer run.
+ "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
+ "destinationDatasetId": "A String", # The BigQuery target dataset id.
"name": "A String", # The resource name of the transfer config.
# Transfer config names have the form of
# `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
@@ -368,8 +370,6 @@
# CreateTransferConfigRequest along with project_id and region. If config_id
# is not provided, usually a uuid, even though it is not guaranteed or
# required, will be generated for config_id.
- "destinationDatasetId": "A String", # The BigQuery target dataset id.
- "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
"notificationPubsubTopic": "A String", # Pub/Sub topic where notifications will be sent after transfer runs
# associated with this transfer config finish.
"params": { # Data transfer specific parameters.
@@ -385,6 +385,7 @@
"nextRunTime": "A String", # Output only. Next time when data transfer will run.
"disabled": True or False, # Is this config disabled. When set to true, no runs are scheduled
# for a given transfer.
+ "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
"schedule": "A String", # Data transfer schedule.
# If the data source does not support a custom schedule, this should be
# empty. If it is empty, the default value for the data source will be
@@ -397,25 +398,24 @@
# See more explanation about the format here:
# https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
# NOTE: the granularity should be at least 8 hours, or less frequent.
- "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, pageSize=None, dataSourceIds=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, dataSourceIds=None, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>Returns information about all data transfers in the project.
Args:
parent: string, Required. The BigQuery project id for which data sources
should be returned: `projects/{project_id}` or
`projects/{project_id}/locations/{location_id}` (required)
+ dataSourceIds: string, When specified, only configurations of requested data sources are returned. (repeated)
pageToken: string, Pagination token, which can be used to request a specific page
of `ListTransfersRequest` list results. For multiple-page
results, `ListTransfersResponse` outputs
a `next_page` token, which can be used as the
`page_token` value to request the next page of list results.
pageSize: integer, Page size. The default page size is the maximum value of 1000 results.
- dataSourceIds: string, When specified, only configurations of requested data sources are returned. (repeated)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -438,7 +438,6 @@
# for just [today-1].
# Only valid if the data source supports the feature. Set the value to 0
# to use the default value.
- "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"scheduleOptions": { # Options customizing the data transfer schedule. # Options customizing the data transfer schedule.
"endTime": "A String", # Defines time to stop scheduling transfer runs. A transfer run cannot be
# scheduled at or after the end time. The end time can be changed at any
@@ -454,7 +453,10 @@
# StartManualTransferRuns API. When automatic scheduling is disabled, the
# TransferConfig.schedule field will be ignored.
},
+ "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"state": "A String", # Output only. State of the most recently updated transfer run.
+ "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
+ "destinationDatasetId": "A String", # The BigQuery target dataset id.
"name": "A String", # The resource name of the transfer config.
# Transfer config names have the form of
# `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
@@ -462,8 +464,6 @@
# CreateTransferConfigRequest along with project_id and region. If config_id
# is not provided, usually a uuid, even though it is not guaranteed or
# required, will be generated for config_id.
- "destinationDatasetId": "A String", # The BigQuery target dataset id.
- "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
"notificationPubsubTopic": "A String", # Pub/Sub topic where notifications will be sent after transfer runs
# associated with this transfer config finish.
"params": { # Data transfer specific parameters.
@@ -479,6 +479,7 @@
"nextRunTime": "A String", # Output only. Next time when data transfer will run.
"disabled": True or False, # Is this config disabled. When set to true, no runs are scheduled
# for a given transfer.
+ "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
"schedule": "A String", # Data transfer schedule.
# If the data source does not support a custom schedule, this should be
# empty. If it is empty, the default value for the data source will be
@@ -491,7 +492,6 @@
# See more explanation about the format here:
# https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
# NOTE: the granularity should be at least 8 hours, or less frequent.
- "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
},
],
"nextPageToken": "A String", # Output only. The next-pagination token. For multiple-page list results,
@@ -543,7 +543,6 @@
# for just [today-1].
# Only valid if the data source supports the feature. Set the value to 0
# to use the default value.
- "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"scheduleOptions": { # Options customizing the data transfer schedule. # Options customizing the data transfer schedule.
"endTime": "A String", # Defines time to stop scheduling transfer runs. A transfer run cannot be
# scheduled at or after the end time. The end time can be changed at any
@@ -559,7 +558,10 @@
# StartManualTransferRuns API. When automatic scheduling is disabled, the
# TransferConfig.schedule field will be ignored.
},
+ "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"state": "A String", # Output only. State of the most recently updated transfer run.
+ "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
+ "destinationDatasetId": "A String", # The BigQuery target dataset id.
"name": "A String", # The resource name of the transfer config.
# Transfer config names have the form of
# `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
@@ -567,8 +569,6 @@
# CreateTransferConfigRequest along with project_id and region. If config_id
# is not provided, usually a uuid, even though it is not guaranteed or
# required, will be generated for config_id.
- "destinationDatasetId": "A String", # The BigQuery target dataset id.
- "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
"notificationPubsubTopic": "A String", # Pub/Sub topic where notifications will be sent after transfer runs
# associated with this transfer config finish.
"params": { # Data transfer specific parameters.
@@ -584,6 +584,7 @@
"nextRunTime": "A String", # Output only. Next time when data transfer will run.
"disabled": True or False, # Is this config disabled. When set to true, no runs are scheduled
# for a given transfer.
+ "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
"schedule": "A String", # Data transfer schedule.
# If the data source does not support a custom schedule, this should be
# empty. If it is empty, the default value for the data source will be
@@ -596,7 +597,6 @@
# See more explanation about the format here:
# https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
# NOTE: the granularity should be at least 8 hours, or less frequent.
- "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
}
updateMask: string, Required. Required list of fields to be updated in this request.
@@ -647,7 +647,6 @@
# for just [today-1].
# Only valid if the data source supports the feature. Set the value to 0
# to use the default value.
- "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"scheduleOptions": { # Options customizing the data transfer schedule. # Options customizing the data transfer schedule.
"endTime": "A String", # Defines time to stop scheduling transfer runs. A transfer run cannot be
# scheduled at or after the end time. The end time can be changed at any
@@ -663,7 +662,10 @@
# StartManualTransferRuns API. When automatic scheduling is disabled, the
# TransferConfig.schedule field will be ignored.
},
+ "dataSourceId": "A String", # Data source id. Cannot be changed once data transfer is created.
"state": "A String", # Output only. State of the most recently updated transfer run.
+ "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
+ "destinationDatasetId": "A String", # The BigQuery target dataset id.
"name": "A String", # The resource name of the transfer config.
# Transfer config names have the form of
# `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
@@ -671,8 +673,6 @@
# CreateTransferConfigRequest along with project_id and region. If config_id
# is not provided, usually a uuid, even though it is not guaranteed or
# required, will be generated for config_id.
- "destinationDatasetId": "A String", # The BigQuery target dataset id.
- "userId": "A String", # Deprecated. Unique ID of the user on whose behalf transfer is done.
"notificationPubsubTopic": "A String", # Pub/Sub topic where notifications will be sent after transfer runs
# associated with this transfer config finish.
"params": { # Data transfer specific parameters.
@@ -688,6 +688,7 @@
"nextRunTime": "A String", # Output only. Next time when data transfer will run.
"disabled": True or False, # Is this config disabled. When set to true, no runs are scheduled
# for a given transfer.
+ "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
"schedule": "A String", # Data transfer schedule.
# If the data source does not support a custom schedule, this should be
# empty. If it is empty, the default value for the data source will be
@@ -700,7 +701,6 @@
# See more explanation about the format here:
# https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
# NOTE: the granularity should be at least 8 hours, or less frequent.
- "updateTime": "A String", # Output only. Data transfer modification time. Ignored by server on input.
}</pre>
</div>
@@ -720,10 +720,10 @@
The object takes the form of:
{ # A request to schedule transfer runs for a time range.
- "endTime": "A String", # Required. End time of the range of transfer runs. For example,
- # `"2017-05-30T00:00:00+00:00"`.
"startTime": "A String", # Required. Start time of the range of transfer runs. For example,
# `"2017-05-25T00:00:00+00:00"`.
+ "endTime": "A String", # Required. End time of the range of transfer runs. For example,
+ # `"2017-05-30T00:00:00+00:00"`.
}
x__xgafv: string, V1 error format.
@@ -768,23 +768,23 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
+ "updateTime": "A String", # Output only. Last time the data transfer run state was updated.
"schedule": "A String", # Output only. Describes the schedule of this transfer run if it was
# created as part of a regular schedule. For batch transfer runs that are
# scheduled manually, this is empty.
# NOTE: the system might choose to delay the schedule depending on the
# current load, so `schedule_time` doesn't always match this.
- "updateTime": "A String", # Output only. Last time the data transfer run state was updated.
"runTime": "A String", # For batch transfer runs, specifies the date and time of the data should be
# ingested.
},
@@ -809,14 +809,14 @@
{ # A request to start manual transfer runs.
"requestedTimeRange": { # A specification for a time range, this will request transfer runs with # Time range for the transfer runs that should be started.
# run_time between start_time (inclusive) and end_time (exclusive).
- "endTime": "A String", # End time of the range of transfer runs. For example,
- # `"2017-05-30T00:00:00+00:00"`. The end_time must not be in the future.
- # Creates transfer runs where run_time is in the range betwen start_time
- # (inclusive) and end_time (exlusive).
"startTime": "A String", # Start time of the range of transfer runs. For example,
# `"2017-05-25T00:00:00+00:00"`. The start_time must be strictly less than
# the end_time. Creates transfer runs where run_time is in the range betwen
# start_time (inclusive) and end_time (exlusive).
+ "endTime": "A String", # End time of the range of transfer runs. For example,
+ # `"2017-05-30T00:00:00+00:00"`. The end_time must not be in the future.
+ # Creates transfer runs where run_time is in the range betwen start_time
+ # (inclusive) and end_time (exlusive).
},
"requestedRunTime": "A String", # Specific run_time for a transfer run to be started. The
# requested_run_time must not be in the future.
@@ -864,23 +864,23 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
+ "updateTime": "A String", # Output only. Last time the data transfer run state was updated.
"schedule": "A String", # Output only. Describes the schedule of this transfer run if it was
# created as part of a regular schedule. For batch transfer runs that are
# scheduled manually, this is empty.
# NOTE: the system might choose to delay the schedule depending on the
# current load, so `schedule_time` doesn't always match this.
- "updateTime": "A String", # Output only. Last time the data transfer run state was updated.
"runTime": "A String", # For batch transfer runs, specifies the date and time of the data should be
# ingested.
},