Full name: projects.locations.transferConfigs.startManualRuns
Manually initiates transfer runs. You can schedule these runs in two ways:
For a specific point in time using the 'requestedRunTime' parameter.
For a period between 'startTime' (inclusive) and 'endTime' (exclusive).
If scheduling a single run, it is set to execute immediately (scheduleTime 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.
HTTP request
POST https://bigquerydatatransfer.googleapis.com/v1/{parent=projects/*/locations/*/transferConfigs/*}:startManualRuns
Authorization requires the following IAM permission on the specified resource parent:
bigquery.transfers.update
Request body
The request body contains data with the following structure:
JSON representation
{// Union field time can be only one of the following:"requestedTimeRange": {object (TimeRange)},"requestedRunTime": string// End of list of possible types for union field time.}
Fields
Union field time. The requested time specification - this can be a time range or a specific run_time. time can be only one of the following:
A time_range start and end timestamp for historical data files or reports that are scheduled to be transferred by the scheduled transfer run. requestedTimeRange must be a past time and cannot include future time values.
A runTime timestamp for historical data files or reports that are scheduled to be transferred by the scheduled transfer run. requestedRunTime must be a past time and cannot include future time values.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[[["\u003cp\u003eThis webpage details how to initiate manual transfer runs for data transfer configurations, allowing for immediate execution with the current time as the schedule time.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePOST\u003c/code\u003e request to \u003ccode\u003ehttps://bigquerydatatransfer.googleapis.com/v1/{parent=projects/*/locations/*/transferConfigs/*}:startManualRuns\u003c/code\u003e is used to trigger these manual runs, with the \u003ccode\u003eparent\u003c/code\u003e parameter required in the URL path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body supports specifying either a time range (\u003ccode\u003erequestedTimeRange\u003c/code\u003e) or a specific run time (\u003ccode\u003erequestedRunTime\u003c/code\u003e) for the historical data to be transferred, which must be in the past.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to perform this action requires the \u003ccode\u003ebigquery.transfers.update\u003c/code\u003e IAM permission on the parent resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a \u003ccode\u003eStartManualTransferRunsResponse\u003c/code\u003e instance in the response body.\u003c/p\u003e\n"]]],[],null,["# Method: transferConfigs.startManualRuns\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n**Full name**: projects.locations.transferConfigs.startManualRuns\n\nManually initiates transfer runs. You can schedule these runs in two ways:\n\n1. For a specific point in time using the 'requestedRunTime' parameter.\n2. For a period between 'startTime' (inclusive) and 'endTime' (exclusive).\n\nIf scheduling a single run, it is set to execute immediately (scheduleTime 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.\n\n### HTTP request\n\n`POST https://bigquerydatatransfer.googleapis.com/v1/{parent=projects/*/locations/*/transferConfigs/*}:startManualRuns`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [StartManualTransferRunsResponse](/bigquery/docs/reference/datatransfer/rest/v1/StartManualTransferRunsResponse).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
