def test_get_google_ads_field_field_headers():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(), )
# Any value that is part of the HTTP/1.1 URI should be sent as
# a field header. Set these to a non-empty value.
request = google_ads_field_service.GetGoogleAdsFieldRequest()
request.resource_name = 'resource_name/value'
# Mock the actual call within the gRPC stub, and fake the request.
with mock.patch.object(type(client.transport.get_google_ads_field),
'__call__') as call:
call.return_value = google_ads_field.GoogleAdsField()
client.get_google_ads_field(request)
# Establish that the underlying gRPC stub method was called.
assert len(call.mock_calls) == 1
_, args, _ = call.mock_calls[0]
assert args[0] == request
# Establish that the field header was sent.
_, _, kw = call.mock_calls[0]
assert (
'x-goog-request-params',
'resource_name=resource_name/value',
) in kw['metadata']
def test_search_google_ads_fields(
transport: str = 'grpc',
request_type=google_ads_field_service.SearchGoogleAdsFieldsRequest):
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(),
transport=transport,
)
# Everything is optional in proto3 as far as the runtime is concerned,
# and we are mocking out the actual API, so just send an empty request.
request = request_type()
# Mock the actual call within the gRPC stub, and fake the request.
with mock.patch.object(type(client.transport.search_google_ads_fields),
'__call__') as call:
# Designate an appropriate return value for the call.
call.return_value = google_ads_field_service.SearchGoogleAdsFieldsResponse(
next_page_token='next_page_token_value',
total_results_count=2077,
)
response = client.search_google_ads_fields(request)
# Establish that the underlying gRPC stub method was called.
assert len(call.mock_calls) == 1
_, args, _ = call.mock_calls[0]
assert args[
0] == google_ads_field_service.SearchGoogleAdsFieldsRequest()
# Establish that the response is the type that we expect.
assert isinstance(response, pagers.SearchGoogleAdsFieldsPager)
assert response.next_page_token == 'next_page_token_value'
assert response.total_results_count == 2077
def test_get_google_ads_field(
transport: str = 'grpc',
request_type=google_ads_field_service.GetGoogleAdsFieldRequest):
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(),
transport=transport,
)
# Everything is optional in proto3 as far as the runtime is concerned,
# and we are mocking out the actual API, so just send an empty request.
request = request_type()
# Mock the actual call within the gRPC stub, and fake the request.
with mock.patch.object(type(client.transport.get_google_ads_field),
'__call__') as call:
# Designate an appropriate return value for the call.
call.return_value = google_ads_field.GoogleAdsField(
resource_name='resource_name_value',
category=google_ads_field_category.GoogleAdsFieldCategoryEnum.
GoogleAdsFieldCategory.UNKNOWN,
data_type=google_ads_field_data_type.GoogleAdsFieldDataTypeEnum.
GoogleAdsFieldDataType.UNKNOWN,
)
response = client.get_google_ads_field(request)
# Establish that the underlying gRPC stub method was called.
assert len(call.mock_calls) == 1
_, args, _ = call.mock_calls[0]
assert args[0] == google_ads_field_service.GetGoogleAdsFieldRequest()
# Establish that the response is the type that we expect.
assert isinstance(response, google_ads_field.GoogleAdsField)
assert response.resource_name == 'resource_name_value'
assert response.category == google_ads_field_category.GoogleAdsFieldCategoryEnum.GoogleAdsFieldCategory.UNKNOWN
assert response.data_type == google_ads_field_data_type.GoogleAdsFieldDataTypeEnum.GoogleAdsFieldDataType.UNKNOWN
def test_parse_common_project_path():
expected = {
"project": "nautilus",
}
path = GoogleAdsFieldServiceClient.common_project_path(**expected)
# Check that the path construction is reversible.
actual = GoogleAdsFieldServiceClient.parse_common_project_path(path)
assert expected == actual
def test_parse_common_folder_path():
expected = {
"folder": "nudibranch",
}
path = GoogleAdsFieldServiceClient.common_folder_path(**expected)
# Check that the path construction is reversible.
actual = GoogleAdsFieldServiceClient.parse_common_folder_path(path)
assert expected == actual
def test_parse_google_ads_field_path():
expected = {
"google_ads_field": "clam",
}
path = GoogleAdsFieldServiceClient.google_ads_field_path(**expected)
# Check that the path construction is reversible.
actual = GoogleAdsFieldServiceClient.parse_google_ads_field_path(path)
assert expected == actual
def test_parse_common_organization_path():
expected = {
"organization": "mussel",
}
path = GoogleAdsFieldServiceClient.common_organization_path(**expected)
# Check that the path construction is reversible.
actual = GoogleAdsFieldServiceClient.parse_common_organization_path(path)
assert expected == actual
def test_parse_common_billing_account_path():
expected = {
"billing_account": "octopus",
}
path = GoogleAdsFieldServiceClient.common_billing_account_path(**expected)
# Check that the path construction is reversible.
actual = GoogleAdsFieldServiceClient.parse_common_billing_account_path(
path)
assert expected == actual
def test_search_google_ads_fields_flattened_error():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(), )
# Attempting to call a method with both a request object and flattened
# fields is an error.
with pytest.raises(ValueError):
client.search_google_ads_fields(
google_ads_field_service.SearchGoogleAdsFieldsRequest(),
query='query_value',
)
def test_get_google_ads_field_flattened_error():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(), )
# Attempting to call a method with both a request object and flattened
# fields is an error.
with pytest.raises(ValueError):
client.get_google_ads_field(
google_ads_field_service.GetGoogleAdsFieldRequest(),
resource_name='resource_name_value',
)
def test_google_ads_field_service_client_from_service_account_file():
creds = ga_credentials.AnonymousCredentials()
with mock.patch.object(service_account.Credentials,
'from_service_account_file') as factory:
factory.return_value = creds
client = GoogleAdsFieldServiceClient.from_service_account_file(
"dummy/file/path.json")
assert client.transport._credentials == creds
client = GoogleAdsFieldServiceClient.from_service_account_json(
"dummy/file/path.json")
assert client.transport._credentials == creds
assert client.transport._host == 'googleads.googleapis.com:443'
def test_common_billing_account_path():
billing_account = "whelk"
expected = "billingAccounts/{billing_account}".format(
billing_account=billing_account, )
actual = GoogleAdsFieldServiceClient.common_billing_account_path(
billing_account)
assert expected == actual
def test_google_ads_field_service_host_with_port():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(),
client_options=client_options.ClientOptions(
api_endpoint='googleads.googleapis.com:8000'),
)
assert client.transport._host == 'googleads.googleapis.com:8000'
def test_google_ads_field_path():
google_ads_field = "squid"
expected = "googleAdsFields/{google_ads_field}".format(
google_ads_field=google_ads_field, )
actual = GoogleAdsFieldServiceClient.google_ads_field_path(
google_ads_field)
assert expected == actual
def test_google_ads_field_service_auth_adc():
# If no credentials are provided, we should use ADC credentials.
with mock.patch.object(google.auth, 'default') as adc:
adc.return_value = (ga_credentials.AnonymousCredentials(), None)
GoogleAdsFieldServiceClient()
adc.assert_called_once_with(
scopes=('https://www.googleapis.com/auth/adwords', ))
def test_transport_grpc_default():
# A client should use the gRPC transport by default.
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(), )
assert isinstance(
client.transport,
transports.GoogleAdsFieldServiceGrpcTransport,
)
def test_get_google_ads_field_flattened():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(), )
# Mock the actual call within the gRPC stub, and fake the request.
with mock.patch.object(type(client.transport.get_google_ads_field),
'__call__') as call:
# Designate an appropriate return value for the call.
call.return_value = google_ads_field.GoogleAdsField()
# Call the method with a truthy value for each flattened field,
# using the keyword arguments to the method.
client.get_google_ads_field(resource_name='resource_name_value', )
# Establish that the underlying call was made with the expected
# request object values.
assert len(call.mock_calls) == 1
_, args, _ = call.mock_calls[0]
assert args[0].resource_name == 'resource_name_value'
def test_credentials_transport_error():
# It is an error to provide credentials and a transport instance.
transport = transports.GoogleAdsFieldServiceGrpcTransport(
credentials=ga_credentials.AnonymousCredentials(), )
with pytest.raises(ValueError):
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(),
transport=transport,
)
def test_google_ads_field_service_client_from_service_account_info():
creds = ga_credentials.AnonymousCredentials()
with mock.patch.object(service_account.Credentials,
'from_service_account_info') as factory:
factory.return_value = creds
info = {"valid": True}
client = GoogleAdsFieldServiceClient.from_service_account_info(info)
assert client.transport._credentials == creds
assert client.transport._host == 'googleads.googleapis.com:443'
def test_search_google_ads_fields_pager():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials, )
# Mock the actual call within the gRPC stub, and fake the request.
with mock.patch.object(type(client.transport.search_google_ads_fields),
'__call__') as call:
# Set the response to a series of pages.
call.side_effect = (
google_ads_field_service.SearchGoogleAdsFieldsResponse(
results=[
google_ads_field.GoogleAdsField(),
google_ads_field.GoogleAdsField(),
google_ads_field.GoogleAdsField(),
],
next_page_token='abc',
),
google_ads_field_service.SearchGoogleAdsFieldsResponse(
results=[],
next_page_token='def',
),
google_ads_field_service.SearchGoogleAdsFieldsResponse(
results=[
google_ads_field.GoogleAdsField(),
],
next_page_token='ghi',
),
google_ads_field_service.SearchGoogleAdsFieldsResponse(results=[
google_ads_field.GoogleAdsField(),
google_ads_field.GoogleAdsField(),
], ),
RuntimeError,
)
metadata = ()
pager = client.search_google_ads_fields(request={})
assert pager._metadata == metadata
results = [i for i in pager]
assert len(results) == 6
assert all(
isinstance(i, google_ads_field.GoogleAdsField) for i in results)
def test_client_withDEFAULT_CLIENT_INFO():
client_info = gapic_v1.client_info.ClientInfo()
with mock.patch.object(transports.GoogleAdsFieldServiceTransport,
'_prep_wrapped_messages') as prep:
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials(),
client_info=client_info,
)
prep.assert_called_once_with(client_info)
with mock.patch.object(transports.GoogleAdsFieldServiceTransport,
'_prep_wrapped_messages') as prep:
transport_class = GoogleAdsFieldServiceClient.get_transport_class()
transport = transport_class(
credentials=ga_credentials.AnonymousCredentials(),
client_info=client_info,
)
prep.assert_called_once_with(client_info)
def test_common_location_path():
project = "scallop"
location = "abalone"
expected = "projects/{project}/locations/{location}".format(
project=project,
location=location,
)
actual = GoogleAdsFieldServiceClient.common_location_path(
project, location)
assert expected == actual
def test_google_ads_field_service_client_client_options_from_dict():
with mock.patch(
'google.ads.googleads.v4.services.services.google_ads_field_service.transports.GoogleAdsFieldServiceGrpcTransport.__init__'
) as grpc_transport:
grpc_transport.return_value = None
client = GoogleAdsFieldServiceClient(
client_options={'api_endpoint': 'squid.clam.whelk'})
grpc_transport.assert_called_once_with(
ssl_channel_credentials=None,
credentials=None,
host="squid.clam.whelk",
client_info=transports.base.DEFAULT_CLIENT_INFO,
)
def test_search_google_ads_fields_pages():
client = GoogleAdsFieldServiceClient(
credentials=ga_credentials.AnonymousCredentials, )
# Mock the actual call within the gRPC stub, and fake the request.
with mock.patch.object(type(client.transport.search_google_ads_fields),
'__call__') as call:
# Set the response to a series of pages.
call.side_effect = (
google_ads_field_service.SearchGoogleAdsFieldsResponse(
results=[
google_ads_field.GoogleAdsField(),
google_ads_field.GoogleAdsField(),
google_ads_field.GoogleAdsField(),
],
next_page_token='abc',
),
google_ads_field_service.SearchGoogleAdsFieldsResponse(
results=[],
next_page_token='def',
),
google_ads_field_service.SearchGoogleAdsFieldsResponse(
results=[
google_ads_field.GoogleAdsField(),
],
next_page_token='ghi',
),
google_ads_field_service.SearchGoogleAdsFieldsResponse(results=[
google_ads_field.GoogleAdsField(),
google_ads_field.GoogleAdsField(),
], ),
RuntimeError,
)
pages = list(client.search_google_ads_fields(request={}).pages)
for page_, token in zip(pages, ['abc', 'def', 'ghi', '']):
assert page_.raw_page.next_page_token == token
def test__get_default_mtls_endpoint():
api_endpoint = "example.googleapis.com"
api_mtls_endpoint = "example.mtls.googleapis.com"
sandbox_endpoint = "example.sandbox.googleapis.com"
sandbox_mtls_endpoint = "example.mtls.sandbox.googleapis.com"
non_googleapi = "api.example.com"
assert GoogleAdsFieldServiceClient._get_default_mtls_endpoint(None) is None
assert GoogleAdsFieldServiceClient._get_default_mtls_endpoint(
api_endpoint) == api_mtls_endpoint
assert GoogleAdsFieldServiceClient._get_default_mtls_endpoint(
api_mtls_endpoint) == api_mtls_endpoint
assert GoogleAdsFieldServiceClient._get_default_mtls_endpoint(
sandbox_endpoint) == sandbox_mtls_endpoint
assert GoogleAdsFieldServiceClient._get_default_mtls_endpoint(
sandbox_mtls_endpoint) == sandbox_mtls_endpoint
assert GoogleAdsFieldServiceClient._get_default_mtls_endpoint(
non_googleapi) == non_googleapi
def test_google_ads_field_service_client_mtls_env_auto(use_client_cert_env):
# This tests the endpoint autoswitch behavior. Endpoint is autoswitched to the default
# mtls endpoint, if GOOGLE_API_USE_CLIENT_CERTIFICATE is "true" and client cert exists.
# Check the case client_cert_source is provided. Whether client cert is used depends on
# GOOGLE_API_USE_CLIENT_CERTIFICATE value.
with mock.patch.dict(
os.environ,
{"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env}):
options = client_options.ClientOptions(
client_cert_source=client_cert_source_callback)
with mock.patch(
'google.ads.googleads.v4.services.services.google_ads_field_service.transports.GoogleAdsFieldServiceGrpcTransport.__init__'
) as grpc_transport:
ssl_channel_creds = mock.Mock()
with mock.patch('grpc.ssl_channel_credentials',
return_value=ssl_channel_creds):
grpc_transport.return_value = None
client = GoogleAdsFieldServiceClient(client_options=options)
if use_client_cert_env == "false":
expected_ssl_channel_creds = None
expected_host = client.DEFAULT_ENDPOINT
else:
expected_ssl_channel_creds = ssl_channel_creds
expected_host = client.DEFAULT_MTLS_ENDPOINT
grpc_transport.assert_called_once_with(
ssl_channel_credentials=expected_ssl_channel_creds,
credentials=None,
host=expected_host,
client_info=transports.base.DEFAULT_CLIENT_INFO,
)
# Check the case ADC client cert is provided. Whether client cert is used depends on
# GOOGLE_API_USE_CLIENT_CERTIFICATE value.
with mock.patch.dict(
os.environ,
{"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env}):
with mock.patch(
'google.ads.googleads.v4.services.services.google_ads_field_service.transports.GoogleAdsFieldServiceGrpcTransport.__init__'
) as grpc_transport:
with mock.patch(
'google.auth.transport.grpc.SslCredentials.__init__',
return_value=None):
with mock.patch(
'google.auth.transport.grpc.SslCredentials.is_mtls',
new_callable=mock.PropertyMock) as is_mtls_mock:
with mock.patch(
'google.auth.transport.grpc.SslCredentials.ssl_credentials',
new_callable=mock.PropertyMock
) as ssl_credentials_mock:
if use_client_cert_env == "false":
is_mtls_mock.return_value = False
ssl_credentials_mock.return_value = None
expected_host = client.DEFAULT_ENDPOINT
expected_ssl_channel_creds = None
else:
is_mtls_mock.return_value = True
ssl_credentials_mock.return_value = mock.Mock()
expected_host = client.DEFAULT_MTLS_ENDPOINT
expected_ssl_channel_creds = ssl_credentials_mock.return_value
grpc_transport.return_value = None
client = GoogleAdsFieldServiceClient()
grpc_transport.assert_called_once_with(
ssl_channel_credentials=expected_ssl_channel_creds,
credentials=None,
host=expected_host,
client_info=transports.base.DEFAULT_CLIENT_INFO,
)
# Check the case client_cert_source and ADC client cert are not provided.
with mock.patch.dict(
os.environ,
{"GOOGLE_API_USE_CLIENT_CERTIFICATE": use_client_cert_env}):
with mock.patch(
'google.ads.googleads.v4.services.services.google_ads_field_service.transports.GoogleAdsFieldServiceGrpcTransport.__init__'
) as grpc_transport:
with mock.patch(
'google.auth.transport.grpc.SslCredentials.__init__',
return_value=None):
with mock.patch(
'google.auth.transport.grpc.SslCredentials.is_mtls',
new_callable=mock.PropertyMock) as is_mtls_mock:
is_mtls_mock.return_value = False
grpc_transport.return_value = None
client = GoogleAdsFieldServiceClient()
grpc_transport.assert_called_once_with(
ssl_channel_credentials=None,
credentials=None,
host=client.DEFAULT_ENDPOINT,
client_info=transports.base.DEFAULT_CLIENT_INFO,
)
def test_common_project_path():
project = "winkle"
expected = "projects/{project}".format(project=project, )
actual = GoogleAdsFieldServiceClient.common_project_path(project)
assert expected == actual
def test_transport_instance():
# A client may be instantiated with a custom transport instance.
transport = transports.GoogleAdsFieldServiceGrpcTransport(
credentials=ga_credentials.AnonymousCredentials(), )
client = GoogleAdsFieldServiceClient(transport=transport)
assert client.transport is transport
def test_common_organization_path():
organization = "cuttlefish"
expected = "organizations/{organization}".format(
organization=organization, )
actual = GoogleAdsFieldServiceClient.common_organization_path(organization)
assert expected == actual
def test_common_folder_path():
folder = "oyster"
expected = "folders/{folder}".format(folder=folder, )
actual = GoogleAdsFieldServiceClient.common_folder_path(folder)
assert expected == actual