Class ApiCall<TRequest, TResponse> (4.4.0)

public sealed class ApiCall<TRequest, TResponse> where TRequest : class, IMessage<TRequest> where TResponse : class, IMessage<TResponse>

Bridge between an RPC method (with synchronous and asynchronous variants) and higher level abstractions, applying call settings as required.

Inheritance

object > ApiCall<TRequest, TResponse>

Inherited Members

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

Namespace

Google.Api.Gax.Grpc

Assembly

Google.Api.Gax.Grpc.dll

Type Parameters
Name	Description
`TRequest`	RPC request type
`TResponse`	RPC response type

Properties

BaseCallSettings

public CallSettings BaseCallSettings { get; }

The base CallSettings for this API call; these can be further overridden by providing a CallSettings to Async(TRequest, CallSettings) or Sync(TRequest, CallSettings).

Property Value
Type	Description
`CallSettings`

Methods

Async(TRequest, CallSettings)

public Task<TResponse> Async(TRequest request, CallSettings perCallCallSettings)

Performs an RPC call asynchronously.

Parameters
Name	Description
`request`	`TRequest` The RPC request.
`perCallCallSettings`	`CallSettings` The call settings to apply to this specific call, overriding defaults where necessary.

Returns
Type	Description
`Task`	A task representing the asynchronous operation. The result of the completed task will be the RPC response.

Sync(TRequest, CallSettings)

public TResponse Sync(TRequest request, CallSettings perCallCallSettings)

Performs an RPC call synchronously.

Parameters
Name	Description
`request`	`TRequest` The RPC request.
`perCallCallSettings`	`CallSettings` The call settings to apply to this specific call, overriding defaults where necessary.

Returns
Type	Description
`TResponse`	The RPC response.

WithCallSettingsOverlay(Func<TRequest, CallSettings>)

public ApiCall<TRequest, TResponse> WithCallSettingsOverlay(Func<TRequest, CallSettings> callSettingsOverlayFn)

Constructs a new ApiCall<TRequest, TResponse> that applies an overlay to the underlying CallSettings. If a value exists in both the original and the overlay, the overlay takes priority.

Parameter
Name	Description
`callSettingsOverlayFn`	`FuncCallSettings` Function that builds the overlay CallSettings.

Returns
Type	Description
`ApiCall`	A new ApiCall<TRequest, TResponse> with the overlay applied.

WithExtractedGoogleRequestParam(RoutingHeaderExtractor<TRequest>)

public ApiCall<TRequest, TResponse> WithExtractedGoogleRequestParam(RoutingHeaderExtractor<TRequest> extractor)

Constructs a new ApiCall<TRequest, TResponse> that applies an x-goog-request-params header to each request, using the RoutingHeaderExtractor<TRequest>.

Parameter
Name	Description
`extractor`	`RoutingHeaderExtractor` The RoutingHeaderExtractor<TRequest> that extracts the value of the routing header from a request.

Returns
Type	Description
`ApiCall`	A new ApiCall<TRequest, TResponse> which applies the header on each request.

Remarks

Values produced by the function are URL-encoded.

WithGoogleRequestParam(string, Func<TRequest, string>)

public ApiCall<TRequest, TResponse> WithGoogleRequestParam(string parameterName, Func<TRequest, string> valueSelector)

Constructs a new ApiCall<TRequest, TResponse> that applies an x-goog-request-params header to each request, using the specified parameter name and a value derived from the request.

Parameters
Name	Description
`parameterName`	`string` The parameter name in the header. Must not be null.
`valueSelector`	`Funcstring` A function to call on each request, to determine the value to specify in the header. The parameter must not be null, but may return null.

Returns
Type	Description
`ApiCall`	A new ApiCall<TRequest, TResponse> which applies the header on each request.