Regenerate bigquerydatatransfer client

Author: yoshi-code-bot

src/BigQueryDataTransfer/Resource/ProjectsDataSources.php

@@ -36,9 +36,12 @@ class ProjectsDataSources extends \Google\Service\Resource
    * Returns true if valid credentials exist for the given data source and
    * requesting user. (dataSources.checkValidCreds)
    *
-   * @param string $name Required. The data source in the form:
-   * `projects/{project_id}/dataSources/{data_source_id}` or
-   * `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`.
+   * @param string $name Required. The name of the data source. If you are using
+   * the regionless method, the location must be `US` and the name should be in
+   * the following form: * `projects/{project_id}/dataSources/{data_source_id}` If
+   * you are using the regionalized method, the name should be in the following
+   * form: *
+   * `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`
    * @param CheckValidCredsRequest $postBody
    * @param array $optParams Optional parameters.
    * @return CheckValidCredsResponse
@@ -53,9 +56,11 @@ public function checkValidCreds($name, CheckValidCredsRequest $postBody, $optPar
   /**
    * Retrieves a supported data source and returns its settings. (dataSources.get)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example: `projects/{project_id}/dataSources/{data_source_id}`
-   * or
+   * @param string $name Required. The name of the resource requested. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: * `projects/{project_id}/dataSources/{data_source_id}`
+   * If you are using the regionalized method, the name should be in the following
+   * form: *
    * `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`
    * @param array $optParams Optional parameters.
    * @return DataSource

src/BigQueryDataTransfer/Resource/ProjectsLocationsDataSources.php

@@ -36,9 +36,12 @@ class ProjectsLocationsDataSources extends \Google\Service\Resource
    * Returns true if valid credentials exist for the given data source and
    * requesting user. (dataSources.checkValidCreds)
    *
-   * @param string $name Required. The data source in the form:
-   * `projects/{project_id}/dataSources/{data_source_id}` or
-   * `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`.
+   * @param string $name Required. The name of the data source. If you are using
+   * the regionless method, the location must be `US` and the name should be in
+   * the following form: * `projects/{project_id}/dataSources/{data_source_id}` If
+   * you are using the regionalized method, the name should be in the following
+   * form: *
+   * `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`
    * @param CheckValidCredsRequest $postBody
    * @param array $optParams Optional parameters.
    * @return CheckValidCredsResponse
@@ -53,9 +56,11 @@ public function checkValidCreds($name, CheckValidCredsRequest $postBody, $optPar
   /**
    * Retrieves a supported data source and returns its settings. (dataSources.get)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example: `projects/{project_id}/dataSources/{data_source_id}`
-   * or
+   * @param string $name Required. The name of the resource requested. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: * `projects/{project_id}/dataSources/{data_source_id}`
+   * If you are using the regionalized method, the name should be in the following
+   * form: *
    * `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`
    * @param array $optParams Optional parameters.
    * @return DataSource

src/BigQueryDataTransfer/Resource/ProjectsLocationsTransferConfigs.php

@@ -91,9 +91,11 @@ public function create($parent, TransferConfig $postBody, $optParams = [])
    * Deletes a data transfer configuration, including any associated transfer runs
    * and logs. (transferConfigs.delete)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example: `projects/{project_id}/transferConfigs/{config_id}`
-   * or
+   * @param string $name Required. The name of the resource to delete. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: * `projects/{project_id}/transferConfigs/{config_id}`
+   * If you are using the regionalized method, the name should be in the following
+   * form: *
    * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param array $optParams Optional parameters.
    * @return BigquerydatatransferEmpty
@@ -108,9 +110,11 @@ public function delete($name, $optParams = [])
   /**
    * Returns information about a data transfer config. (transferConfigs.get)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example: `projects/{project_id}/transferConfigs/{config_id}`
-   * or
+   * @param string $name Required. The name of the resource requested. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: * `projects/{project_id}/transferConfigs/{config_id}`
+   * If you are using the regionalized method, the name should be in the following
+   * form: *
    * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param array $optParams Optional parameters.
    * @return TransferConfig
@@ -127,7 +131,10 @@ public function get($name, $optParams = [])
    * specified location. (transferConfigs.listProjectsLocationsTransferConfigs)
    *
    * @param string $parent Required. The BigQuery project id for which transfer
-   * configs should be returned: `projects/{project_id}` or
+   * configs should be returned. If you are using the regionless method, the
+   * location must be `US` and `parent` should be in the following form: *
+   * `projects/{project_id} If you are using the regionalized method, `parent`
+   * should be in the following form: *
    * `projects/{project_id}/locations/{location_id}`
    * @param array $optParams Optional parameters.
    *
@@ -211,9 +218,12 @@ public function patch($name, TransferConfig $postBody, $optParams = [])
    * range. DEPRECATED: use StartManualTransferRuns instead.
    * (transferConfigs.scheduleRuns)
    *
-   * @param string $parent Required. Transfer configuration name in the form:
-   * `projects/{project_id}/transferConfigs/{config_id}` or
-   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
+   * @param string $parent Required. Transfer configuration name. If you are using
+   * the regionless method, the location must be `US` and the name should be in
+   * the following form: * `projects/{project_id}/transferConfigs/{config_id}` If
+   * you are using the regionalized method, the name should be in the following
+   * form: *
+   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param ScheduleTransferRunsRequest $postBody
    * @param array $optParams Optional parameters.
    * @return ScheduleTransferRunsResponse
@@ -226,14 +236,20 @@ public function scheduleRuns($parent, ScheduleTransferRunsRequest $postBody, $op
     return $this->call('scheduleRuns', [$params], ScheduleTransferRunsResponse::class);
   }
   /**
-   * Start manual transfer runs to be executed now with schedule_time equal to
-   * current time. The transfer runs can be created for a time range where the
-   * run_time is between start_time (inclusive) and end_time (exclusive), or for a
-   * specific run_time. (transferConfigs.startManualRuns)
+   * Manually initiates transfer runs. You can schedule these runs in two ways: 1.
+   * For a specific point in time using the 'requested_run_time' parameter. 2. For
+   * a period between 'start_time' (inclusive) and 'end_time' (exclusive). If
+   * scheduling a single run, it is set to execute immediately (schedule_time
+   * equals the current time). When scheduling multiple runs within a time range,
+   * the first run starts now, and subsequent runs are delayed by 15 seconds each.
+   * (transferConfigs.startManualRuns)
    *
-   * @param string $parent Required. Transfer configuration name in the form:
-   * `projects/{project_id}/transferConfigs/{config_id}` or
-   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
+   * @param string $parent Required. Transfer configuration name. If you are using
+   * the regionless method, the location must be `US` and the name should be in
+   * the following form: * `projects/{project_id}/transferConfigs/{config_id}` If
+   * you are using the regionalized method, the name should be in the following
+   * form: *
+   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param StartManualTransferRunsRequest $postBody
    * @param array $optParams Optional parameters.
    * @return StartManualTransferRunsResponse

src/BigQueryDataTransfer/Resource/ProjectsLocationsTransferConfigsRuns.php

@@ -34,11 +34,13 @@ class ProjectsLocationsTransferConfigsRuns extends \Google\Service\Resource
   /**
    * Deletes the specified transfer run. (runs.delete)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example:
-   * `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or `project
-   * s/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_
-   * id}`
+   * @param string $name Required. The name of the resource requested. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: *
+   * `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` If you are
+   * using the regionalized method, the name should be in the following form: * `p
+   * rojects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs
+   * /{run_id}`
    * @param array $optParams Optional parameters.
    * @return BigquerydatatransferEmpty
    * @throws \Google\Service\Exception
@@ -52,11 +54,13 @@ public function delete($name, $optParams = [])
   /**
    * Returns information about the particular transfer run. (runs.get)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example:
-   * `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or `project
-   * s/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_
-   * id}`
+   * @param string $name Required. The name of the resource requested. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: *
+   * `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` If you are
+   * using the regionalized method, the name should be in the following form: * `p
+   * rojects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs
+   * /{run_id}`
    * @param array $optParams Optional parameters.
    * @return TransferRun
    * @throws \Google\Service\Exception
@@ -72,9 +76,11 @@ public function get($name, $optParams = [])
    * (runs.listProjectsLocationsTransferConfigsRuns)
    *
    * @param string $parent Required. Name of transfer configuration for which
-   * transfer runs should be retrieved. Format of transfer configuration resource
-   * name is: `projects/{project_id}/transferConfigs/{config_id}` or
-   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
+   * transfer runs should be retrieved. If you are using the regionless method,
+   * the location must be `US` and the name should be in the following form: *
+   * `projects/{project_id}/transferConfigs/{config_id}` If you are using the
+   * regionalized method, the name should be in the following form: *
+   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param array $optParams Optional parameters.
    *
    * @opt_param int pageSize Page size. The default page size is the maximum value

src/BigQueryDataTransfer/Resource/ProjectsLocationsTransferConfigsRunsTransferLogs.php

@@ -33,10 +33,13 @@ class ProjectsLocationsTransferConfigsRunsTransferLogs extends \Google\Service\R
    * Returns log messages for the transfer run.
    * (transferLogs.listProjectsLocationsTransferConfigsRunsTransferLogs)
    *
-   * @param string $parent Required. Transfer run name in the form:
-   * `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or `project
-   * s/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_
-   * id}`
+   * @param string $parent Required. Transfer run name. If you are using the
+   * regionless method, the location must be `US` and the name should be in the
+   * following form: *
+   * `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` If you are
+   * using the regionalized method, the name should be in the following form: * `p
+   * rojects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs
+   * /{run_id}`
    * @param array $optParams Optional parameters.
    *
    * @opt_param string messageTypes Message types to return. If not populated -

src/BigQueryDataTransfer/Resource/ProjectsTransferConfigs.php

@@ -91,9 +91,11 @@ public function create($parent, TransferConfig $postBody, $optParams = [])
    * Deletes a data transfer configuration, including any associated transfer runs
    * and logs. (transferConfigs.delete)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example: `projects/{project_id}/transferConfigs/{config_id}`
-   * or
+   * @param string $name Required. The name of the resource to delete. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: * `projects/{project_id}/transferConfigs/{config_id}`
+   * If you are using the regionalized method, the name should be in the following
+   * form: *
    * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param array $optParams Optional parameters.
    * @return BigquerydatatransferEmpty
@@ -108,9 +110,11 @@ public function delete($name, $optParams = [])
   /**
    * Returns information about a data transfer config. (transferConfigs.get)
    *
-   * @param string $name Required. The field will contain name of the resource
-   * requested, for example: `projects/{project_id}/transferConfigs/{config_id}`
-   * or
+   * @param string $name Required. The name of the resource requested. If you are
+   * using the regionless method, the location must be `US` and the name should be
+   * in the following form: * `projects/{project_id}/transferConfigs/{config_id}`
+   * If you are using the regionalized method, the name should be in the following
+   * form: *
    * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param array $optParams Optional parameters.
    * @return TransferConfig
@@ -127,7 +131,10 @@ public function get($name, $optParams = [])
    * specified location. (transferConfigs.listProjectsTransferConfigs)
    *
    * @param string $parent Required. The BigQuery project id for which transfer
-   * configs should be returned: `projects/{project_id}` or
+   * configs should be returned. If you are using the regionless method, the
+   * location must be `US` and `parent` should be in the following form: *
+   * `projects/{project_id} If you are using the regionalized method, `parent`
+   * should be in the following form: *
    * `projects/{project_id}/locations/{location_id}`
    * @param array $optParams Optional parameters.
    *
@@ -211,9 +218,12 @@ public function patch($name, TransferConfig $postBody, $optParams = [])
    * range. DEPRECATED: use StartManualTransferRuns instead.
    * (transferConfigs.scheduleRuns)
    *
-   * @param string $parent Required. Transfer configuration name in the form:
-   * `projects/{project_id}/transferConfigs/{config_id}` or
-   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
+   * @param string $parent Required. Transfer configuration name. If you are using
+   * the regionless method, the location must be `US` and the name should be in
+   * the following form: * `projects/{project_id}/transferConfigs/{config_id}` If
+   * you are using the regionalized method, the name should be in the following
+   * form: *
+   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param ScheduleTransferRunsRequest $postBody
    * @param array $optParams Optional parameters.
    * @return ScheduleTransferRunsResponse
@@ -226,14 +236,20 @@ public function scheduleRuns($parent, ScheduleTransferRunsRequest $postBody, $op
     return $this->call('scheduleRuns', [$params], ScheduleTransferRunsResponse::class);
   }
   /**
-   * Start manual transfer runs to be executed now with schedule_time equal to
-   * current time. The transfer runs can be created for a time range where the
-   * run_time is between start_time (inclusive) and end_time (exclusive), or for a
-   * specific run_time. (transferConfigs.startManualRuns)
+   * Manually initiates transfer runs. You can schedule these runs in two ways: 1.
+   * For a specific point in time using the 'requested_run_time' parameter. 2. For
+   * a period between 'start_time' (inclusive) and 'end_time' (exclusive). If
+   * scheduling a single run, it is set to execute immediately (schedule_time
+   * equals the current time). When scheduling multiple runs within a time range,
+   * the first run starts now, and subsequent runs are delayed by 15 seconds each.
+   * (transferConfigs.startManualRuns)
    *
-   * @param string $parent Required. Transfer configuration name in the form:
-   * `projects/{project_id}/transferConfigs/{config_id}` or
-   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
+   * @param string $parent Required. Transfer configuration name. If you are using
+   * the regionless method, the location must be `US` and the name should be in
+   * the following form: * `projects/{project_id}/transferConfigs/{config_id}` If
+   * you are using the regionalized method, the name should be in the following
+   * form: *
+   * `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
    * @param StartManualTransferRunsRequest $postBody
    * @param array $optParams Optional parameters.
    * @return StartManualTransferRunsResponse