private GoogleAdsServiceSettings(GoogleAdsServiceSettings existing) : base(existing)
{
gax::GaxPreconditions.CheckNotNull(existing, nameof(existing));
SearchSettings = existing.SearchSettings;
MutateSettings = existing.MutateSettings;
OnCopy(existing);
}
/// <summary>
/// Constructs a client wrapper for the GoogleAdsService service, with the specified gRPC client and settings.
/// </summary>
/// <param name="grpcClient">The underlying gRPC client.</param>
/// <param name="settings">The base <see cref="GoogleAdsServiceSettings"/> used within this client </param>
public GoogleAdsServiceClientImpl(GoogleAdsService.GoogleAdsServiceClient grpcClient, GoogleAdsServiceSettings settings)
{
GrpcClient = grpcClient;
GoogleAdsServiceSettings effectiveSettings = settings ?? GoogleAdsServiceSettings.GetDefault();
gaxgrpc::ClientHelper clientHelper = new gaxgrpc::ClientHelper(effectiveSettings);
_callSearch = clientHelper.BuildApiCall <SearchGoogleAdsRequest, SearchGoogleAdsResponse>(
GrpcClient.SearchAsync, GrpcClient.Search, effectiveSettings.SearchSettings);
_callMutate = clientHelper.BuildApiCall <MutateGoogleAdsRequest, MutateGoogleAdsResponse>(
GrpcClient.MutateAsync, GrpcClient.Mutate, effectiveSettings.MutateSettings);
Modify_ApiCall(ref _callSearch);
Modify_SearchApiCall(ref _callSearch);
Modify_ApiCall(ref _callMutate);
Modify_MutateApiCall(ref _callMutate);
OnConstruction(grpcClient, effectiveSettings, clientHelper);
}
partial void OnConstruction(GoogleAdsService.GoogleAdsServiceClient grpcClient, GoogleAdsServiceSettings effectiveSettings, gaxgrpc::ClientHelper clientHelper);
partial void OnCopy(GoogleAdsServiceSettings existing);
/// <summary>
/// Creates a <see cref="GoogleAdsServiceClient"/> 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="GoogleAdsServiceSettings"/>.</param>
/// <returns>The created <see cref="GoogleAdsServiceClient"/>.</returns>
public static GoogleAdsServiceClient Create(grpccore::CallInvoker callInvoker, GoogleAdsServiceSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(callInvoker, nameof(callInvoker));
grpccore::Interceptors.Interceptor interceptor = settings?.Interceptor;
if (interceptor != null)
{
callInvoker = grpccore::Interceptors.CallInvokerExtensions.Intercept(callInvoker, interceptor);
}
GoogleAdsService.GoogleAdsServiceClient grpcClient = new GoogleAdsService.GoogleAdsServiceClient(callInvoker);
return(new GoogleAdsServiceClientImpl(grpcClient, settings));
}
/// <summary>
/// Creates a <see cref="GoogleAdsServiceClient"/> 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="GoogleAdsServiceSettings"/>.</param>
/// <returns>The created <see cref="GoogleAdsServiceClient"/>.</returns>
public static GoogleAdsServiceClient Create(grpccore::Channel channel, GoogleAdsServiceSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(channel, nameof(channel));
return(Create(new grpccore::DefaultCallInvoker(channel), settings));
}
/// <summary>
/// Synchronously creates a <see cref="GoogleAdsServiceClient"/>, 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.V0.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.
/// GoogleAdsServiceClient client = GoogleAdsServiceClient.Create();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Ads.GoogleAds.V0.Services;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// GoogleAdsServiceClient.DefaultEndpoint.Host, GoogleAdsServiceClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// GoogleAdsServiceClient client = GoogleAdsServiceClient.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="GoogleAdsServiceSettings"/>.</param>
/// <returns>The created <see cref="GoogleAdsServiceClient"/>.</returns>
public static GoogleAdsServiceClient Create(gaxgrpc::ServiceEndpoint endpoint = null, GoogleAdsServiceSettings settings = null)
{
grpccore::Channel channel = s_channelPool.GetChannel(endpoint ?? DefaultEndpoint);
return(Create(channel, settings));
}
/// <summary>
/// Asynchronously creates a <see cref="GoogleAdsServiceClient"/>, 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.V0.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.
/// GoogleAdsServiceClient client = await GoogleAdsServiceClient.CreateAsync();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Ads.GoogleAds.V0.Services;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// GoogleAdsServiceClient.DefaultEndpoint.Host, GoogleAdsServiceClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// GoogleAdsServiceClient client = GoogleAdsServiceClient.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="GoogleAdsServiceSettings"/>.</param>
/// <returns>The task representing the created <see cref="GoogleAdsServiceClient"/>.</returns>
public static async stt::Task <GoogleAdsServiceClient> CreateAsync(gaxgrpc::ServiceEndpoint endpoint = null, GoogleAdsServiceSettings settings = null)
{
grpccore::Channel channel = await s_channelPool.GetChannelAsync(endpoint ?? DefaultEndpoint).ConfigureAwait(false);
return(Create(channel, settings));
}