/// <summary>
/// Creates a <see cref="AssetServiceClient"/> which uses the specified call invoker for remote operations.
/// </summary>
/// <param name="callInvoker">The <see cref="grpccore::CallInvoker"/> for remote operations. Must not be null.</param>
/// <param name="settings">Optional <see cref="AssetServiceSettings"/>.</param>
/// <returns>The created <see cref="AssetServiceClient"/>.</returns>
public static AssetServiceClient Create(grpccore::CallInvoker callInvoker, AssetServiceSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(callInvoker, nameof(callInvoker));
grpccore::Interceptors.Interceptor interceptor = settings?.Interceptor;
if (interceptor != null)
{
callInvoker = grpccore::Interceptors.CallInvokerExtensions.Intercept(callInvoker, interceptor);
}
AssetService.AssetServiceClient grpcClient = new AssetService.AssetServiceClient(callInvoker);
return(new AssetServiceClientImpl(grpcClient, settings));
}
/// <summary>
/// Constructs a client wrapper for the AssetService service, with the specified gRPC client and settings.
/// </summary>
/// <param name="grpcClient">The underlying gRPC client.</param>
/// <param name="settings">The base <see cref="AssetServiceSettings"/> used within this client </param>
public AssetServiceClientImpl(AssetService.AssetServiceClient grpcClient, AssetServiceSettings settings)
{
GrpcClient = grpcClient;
AssetServiceSettings effectiveSettings = settings ?? AssetServiceSettings.GetDefault();
gaxgrpc::ClientHelper clientHelper = new gaxgrpc::ClientHelper(effectiveSettings);
_callGetAsset = clientHelper.BuildApiCall <GetAssetRequest, gagvr::Asset>(
GrpcClient.GetAssetAsync, GrpcClient.GetAsset, effectiveSettings.GetAssetSettings);
_callMutateAssets = clientHelper.BuildApiCall <MutateAssetsRequest, MutateAssetsResponse>(
GrpcClient.MutateAssetsAsync, GrpcClient.MutateAssets, effectiveSettings.MutateAssetsSettings);
Modify_ApiCall(ref _callGetAsset);
Modify_GetAssetApiCall(ref _callGetAsset);
Modify_ApiCall(ref _callMutateAssets);
Modify_MutateAssetsApiCall(ref _callMutateAssets);
OnConstruction(grpcClient, effectiveSettings, clientHelper);
}
partial void OnConstruction(AssetService.AssetServiceClient grpcClient, AssetServiceSettings effectiveSettings, gaxgrpc::ClientHelper clientHelper);
partial void OnCopy(AssetServiceSettings existing);
/// <summary>
/// Creates a <see cref="AssetServiceClient"/> which uses the specified channel for remote operations.
/// </summary>
/// <param name="channel">The <see cref="grpccore::Channel"/> for remote operations. Must not be null.</param>
/// <param name="settings">Optional <see cref="AssetServiceSettings"/>.</param>
/// <returns>The created <see cref="AssetServiceClient"/>.</returns>
public static AssetServiceClient Create(grpccore::Channel channel, AssetServiceSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(channel, nameof(channel));
return(Create(new grpccore::DefaultCallInvoker(channel), settings));
}
/// <summary>
/// Synchronously creates a <see cref="AssetServiceClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary. See the example for how to use custom credentials.
/// </summary>
/// <example>
/// This sample shows how to create a client using default credentials:
/// <code>
/// using Google.Ads.GoogleAds.V1.Services;
/// ...
/// // When running on Google Cloud Platform this will use the project Compute Credential.
/// // Or set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of a JSON
/// // credential file to use that credential.
/// AssetServiceClient client = AssetServiceClient.Create();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Ads.GoogleAds.V1.Services;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// AssetServiceClient.DefaultEndpoint.Host, AssetServiceClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// AssetServiceClient client = AssetServiceClient.Create(channel);
/// ...
/// // Shutdown the channel when it is no longer required.
/// channel.ShutdownAsync().Wait();
/// </code>
/// </example>
/// <param name="endpoint">Optional <see cref="gaxgrpc::ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="AssetServiceSettings"/>.</param>
/// <returns>The created <see cref="AssetServiceClient"/>.</returns>
public static AssetServiceClient Create(gaxgrpc::ServiceEndpoint endpoint = null, AssetServiceSettings settings = null)
{
grpccore::Channel channel = s_channelPool.GetChannel(endpoint ?? DefaultEndpoint);
return(Create(channel, settings));
}
/// <summary>
/// Asynchronously creates a <see cref="AssetServiceClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary. See the example for how to use custom credentials.
/// </summary>
/// <example>
/// This sample shows how to create a client using default credentials:
/// <code>
/// using Google.Ads.GoogleAds.V1.Services;
/// ...
/// // When running on Google Cloud Platform this will use the project Compute Credential.
/// // Or set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of a JSON
/// // credential file to use that credential.
/// AssetServiceClient client = await AssetServiceClient.CreateAsync();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Ads.GoogleAds.V1.Services;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// AssetServiceClient.DefaultEndpoint.Host, AssetServiceClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// AssetServiceClient client = AssetServiceClient.Create(channel);
/// ...
/// // Shutdown the channel when it is no longer required.
/// await channel.ShutdownAsync();
/// </code>
/// </example>
/// <param name="endpoint">Optional <see cref="gaxgrpc::ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="AssetServiceSettings"/>.</param>
/// <returns>The task representing the created <see cref="AssetServiceClient"/>.</returns>
public static async stt::Task <AssetServiceClient> CreateAsync(gaxgrpc::ServiceEndpoint endpoint = null, AssetServiceSettings settings = null)
{
grpccore::Channel channel = await s_channelPool.GetChannelAsync(endpoint ?? DefaultEndpoint).ConfigureAwait(false);
return(Create(channel, settings));
}