Batch operations (v4beta1)

Cloud Talent Solution supports asynchronous batch operations, which allows you to put multiple API calls into a single HTTP request. The returned response type is google.longrunning.operation. The detailed status of the batch operation can be retrieved by calling the GetOperation method using the name field in google.longrunning.operation.

Using batching yields decreased latency in the API response time and higher throughput. Note that successfully receiving a batch API response indicates only that the batch request has been created. Actual data processing is done asynchronously. Batch operations created more than 30 days ago will be no longer accessible by the GetOperation method.

Each batch is limited to 200 requests.

Batch operation progress indicator

The google.longrunning.operation created by calling the batch create or update method falls under one of the following states:

  • STATE_UNSPECIFIED (the default value)
  • INITIALIZING
  • PROCESSING
  • SUCCEEDED
  • FAILED

In state INITIALIZING, success_count, failure_count, and total_count fields are set to 0. If the operation is in state PROCESSING the success_count and failure_count may increase. In state SUCCEEDED, success_count + failure_count is always equal to total_count, and success_count > 0. In state FAILED, success_count is always 0.