feat: Add initial test suite for advanced_operations examples

I've created the test infrastructure, including a `tests` directory, `__init__.py`,
and a `conftest.py` with a `mock_google_ads_client` fixture.

I've also generated placeholder test files for all 18 scripts in
`examples/advanced_operations`.

I've implemented basic tests for 13 of these scripts. These tests verify
that the main() function of each script can execute without unhandled
exceptions when provided with a mocked GoogleAdsClient and appropriate
mock arguments. This includes mocking service calls, enums, and
patching external utilities like uuid and requests.get.

Scripts with basic tests:
- add_ad_customizer.py
- add_ad_group_bid_modifier.py
- add_app_campaign.py
- add_bidding_data_exclusion.py
- add_bidding_seasonality_adjustment.py
- add_call_ad.py
- add_demand_gen_campaign.py
- add_display_upload_ad.py
- add_dynamic_page_feed_asset.py
- add_dynamic_search_ads.py
- add_performance_max_campaign.py
- add_responsive_search_ad_full.py
- add_smart_campaign.py

Further work is needed to implement tests for the remaining 5 scripts and
potentially enhance the existing tests with more specific assertions.

Author: google-labs-jules[bot]

examples/advanced_operations/tests/__init__.py

@@ -0,0 +1,31 @@
+import pytest
+from unittest.mock import MagicMock, PropertyMock
+
+@pytest.fixture
+def mock_google_ads_client():
+    """Fixture to mock the GoogleAdsClient."""
+    mock_client = MagicMock()
+
+    # Mock the get_service method
+    # This will return a new MagicMock for any service name requested
+    mock_client.get_service = MagicMock(return_value=MagicMock())
+
+    # Mock the get_type method
+    # This will return a new MagicMock for any type name requested
+    # We can refine this later if specific type behaviors are needed
+    mock_client.get_type = MagicMock(return_value=MagicMock())
+
+    # Mock the enums attribute
+    # This allows access like client.enums.SomeEnum.VALUE
+    # For now, we'll make it a MagicMock. If specific enums are needed,
+    # they can be added as properties to this mock_enums object.
+    mock_enums = MagicMock()
+    
+    # Example of mocking a specific enum if needed for a test:
+    # mock_campaign_status_enum = MagicMock()
+    # mock_campaign_status_enum.PAUSED = "PAUSED_ENUM_VALUE" # Or an int if that's what the API uses
+    # type(mock_enums).CampaignStatusEnum = PropertyMock(return_value=mock_campaign_status_enum)
+    
+    mock_client.enums = mock_enums
+
+    return mock_client

examples/advanced_operations/tests/conftest.py

@@ -0,0 +1,58 @@
+import pytest
+from unittest.mock import MagicMock
+
+# Assuming 'examples' is in the Python path or using relative imports
+# If 'examples' is not directly in PYTHONPATH, adjust the import accordingly.
+# For example, if the tests are run from the directory containing 'examples':
+from examples.advanced_operations.add_ad_customizer import main
+
+# If the above import doesn't work due to path issues, the test runner might
+# need to be configured, or sys.path might need adjustment in a conftest.py
+# or at the beginning of the test file. For now, we assume it works.
+
+def test_main_runs_successfully(mock_google_ads_client: MagicMock) -> None:
+    """Tests that the main function runs without raising an exception."""
+    mock_customer_id = "1234567890"
+    mock_ad_group_id = "0987654321"
+
+    # Configure mock service calls if they need to return specific structures
+    # For example, if a service call returns an object with a 'resource_name'
+    mock_customizer_attribute_service = mock_google_ads_client.get_service("CustomizerAttributeService")
+    mock_mutate_response = MagicMock()
+    mock_result = MagicMock()
+    mock_result.resource_name = "mock_resource_name_customizer_attr"
+    mock_mutate_response.results = [mock_result]
+    mock_customizer_attribute_service.mutate_customizer_attributes.return_value = mock_mutate_response
+
+    mock_ad_group_customizer_service = mock_google_ads_client.get_service("AdGroupCustomizerService")
+    mock_mutate_ad_group_customizers_response = MagicMock()
+    mock_ad_group_customizer_result = MagicMock()
+    mock_ad_group_customizer_result.resource_name = "mock_resource_name_ad_group_customizer"
+    mock_mutate_ad_group_customizers_response.results = [mock_ad_group_customizer_result]
+    mock_ad_group_customizer_service.mutate_ad_group_customizers.return_value = mock_mutate_ad_group_customizers_response
+    
+    mock_googleads_service = mock_google_ads_client.get_service("GoogleAdsService")
+    mock_googleads_service.ad_group_path.return_value = "mock/ad_group/path"
+
+    mock_ad_group_ad_service = mock_google_ads_client.get_service("AdGroupAdService")
+    mock_mutate_ad_group_ads_response = MagicMock()
+    mock_ad_group_ad_result = MagicMock()
+    mock_ad_group_ad_result.resource_name = "mock_resource_name_ad_group_ad"
+    mock_mutate_ad_group_ads_response.results = [mock_ad_group_ad_result]
+    mock_ad_group_ad_service.mutate_ad_group_ads.return_value = mock_mutate_ad_group_ads_response
+    
+    # Mock enums used by the script
+    mock_enums = mock_google_ads_client.enums
+    mock_enums.CustomizerAttributeTypeEnum.TEXT = "TEXT"
+    mock_enums.CustomizerAttributeTypeEnum.PRICE = "PRICE"
+    mock_enums.ServedAssetFieldTypeEnum.HEADLINE_1 = "HEADLINE_1"
+
+
+    try:
+        main(
+            mock_google_ads_client,
+            mock_customer_id,
+            mock_ad_group_id,
+        )
+    except Exception as e:
+        pytest.fail(f"main function raised an exception: {e}")

examples/advanced_operations/tests/test_add_ad_customizer.py

@@ -0,0 +1,45 @@
+import pytest
+from unittest.mock import MagicMock
+
+from examples.advanced_operations.add_ad_group_bid_modifier import main
+
+def test_main_runs_successfully(mock_google_ads_client: MagicMock) -> None:
+    """Tests that the main function runs without raising an exception."""
+    mock_customer_id = "1234567890"
+    mock_ad_group_id = "0987654321"
+    mock_bid_modifier_value = 1.5
+
+    # Mock services and their responses
+    mock_ad_group_service = mock_google_ads_client.get_service("AdGroupService")
+    mock_ad_group_service.ad_group_path.return_value = "customers/1234567890/adGroups/0987654321"
+
+    mock_ad_group_bm_service = mock_google_ads_client.get_service("AdGroupBidModifierService")
+    mock_mutate_response = MagicMock()
+    mock_result = MagicMock()
+    mock_result.resource_name = "mock_resource_name_ad_group_bid_modifier"
+    mock_mutate_response.results = [mock_result]
+    mock_ad_group_bm_service.mutate_ad_group_bid_modifiers.return_value = mock_mutate_response
+
+    # Mock enums
+    mock_device_enum = MagicMock()
+    mock_device_enum.MOBILE = "MOBILE_DEVICE" # Or actual enum value if known/needed
+    mock_google_ads_client.enums.DeviceEnum = mock_device_enum
+    
+    # Mock types
+    # The get_type method in conftest returns a MagicMock by default.
+    # We can configure its "create" attribute if necessary, but often not needed
+    # if the "create" object is just passed to a service method.
+    # mock_ad_group_bid_modifier_operation = mock_google_ads_client.get_type("AdGroupBidModifierOperation")
+    # If specific attributes on ad_group_bid_modifier (the .create object) were accessed directly
+    # in the script before being passed to the service, we'd mock them here.
+    # e.g. mock_ad_group_bid_modifier_operation.create.some_attribute = "some_value"
+
+    try:
+        main(
+            mock_google_ads_client,
+            mock_customer_id,
+            mock_ad_group_id,
+            mock_bid_modifier_value,
+        )
+    except Exception as e:
+        pytest.fail(f"main function raised an exception: {e}")

examples/advanced_operations/tests/test_add_ad_group_bid_modifier.py

@@ -0,0 +1,97 @@
+import pytest
+from unittest.mock import MagicMock, patch
+
+from examples.advanced_operations.add_app_campaign import main
+
+@patch("examples.advanced_operations.add_app_campaign.uuid4", return_value=MagicMock(hex="testuuid"))
+def test_main_runs_successfully(mock_uuid4: MagicMock, mock_google_ads_client: MagicMock) -> None:
+    """Tests that the main function runs without raising an exception."""
+    mock_customer_id = "1234567890"
+
+    # --- Mock service responses ---
+    # CampaignBudgetService
+    mock_budget_service = mock_google_ads_client.get_service("CampaignBudgetService")
+    mock_budget_response = MagicMock()
+    mock_budget_result = MagicMock()
+    mock_budget_result.resource_name = "customers/1234567890/campaignBudgets/budget_testuuid"
+    mock_budget_response.results = [mock_budget_result]
+    mock_budget_service.mutate_campaign_budgets.return_value = mock_budget_response
+
+    # CampaignService
+    mock_campaign_service = mock_google_ads_client.get_service("CampaignService")
+    mock_campaign_response = MagicMock()
+    mock_campaign_result = MagicMock()
+    mock_campaign_result.resource_name = "customers/1234567890/campaigns/campaign_testuuid"
+    mock_campaign_response.results = [mock_campaign_result]
+    mock_campaign_service.mutate_campaigns.return_value = mock_campaign_response
+
+    # GeoTargetConstantService
+    mock_geo_service = mock_google_ads_client.get_service("GeoTargetConstantService")
+    mock_geo_service.geo_target_constant_path.side_effect = lambda x: f"geoTargetConstants/{x}"
+
+    # GoogleAdsService (for language_constant_path)
+    mock_googleads_service = mock_google_ads_client.get_service("GoogleAdsService")
+    mock_googleads_service.language_constant_path.side_effect = lambda x: f"languageConstants/{x}"
+
+    # CampaignCriterionService
+    mock_campaign_criterion_service = mock_google_ads_client.get_service("CampaignCriterionService")
+    mock_criterion_response = MagicMock()
+    # Simulate multiple results for campaign criteria
+    mock_criterion_result_loc1 = MagicMock()
+    mock_criterion_result_loc1.resource_name = "criterion_loc1"
+    mock_criterion_result_loc2 = MagicMock()
+    mock_criterion_result_loc2.resource_name = "criterion_loc2"
+    mock_criterion_result_lang1 = MagicMock()
+    mock_criterion_result_lang1.resource_name = "criterion_lang1"
+    mock_criterion_result_lang2 = MagicMock()
+    mock_criterion_result_lang2.resource_name = "criterion_lang2"
+    mock_criterion_response.results = [
+        mock_criterion_result_loc1, 
+        mock_criterion_result_loc2,
+        mock_criterion_result_lang1,
+        mock_criterion_result_lang2
+    ]
+    mock_campaign_criterion_service.mutate_campaign_criteria.return_value = mock_criterion_response
+
+    # AdGroupService
+    mock_ad_group_service = mock_google_ads_client.get_service("AdGroupService")
+    mock_ad_group_response = MagicMock()
+    mock_ad_group_result = MagicMock()
+    mock_ad_group_result.resource_name = "customers/1234567890/adGroups/adgroup_testuuid"
+    mock_ad_group_response.results = [mock_ad_group_result]
+    mock_ad_group_service.mutate_ad_groups.return_value = mock_ad_group_response
+
+    # AdGroupAdService
+    mock_ad_group_ad_service = mock_google_ads_client.get_service("AdGroupAdService")
+    mock_ad_group_ad_response = MagicMock()
+    mock_ad_group_ad_result = MagicMock()
+    mock_ad_group_ad_result.resource_name = "customers/1234567890/adGroupAds/ad_testuuid"
+    mock_ad_group_ad_response.results = [mock_ad_group_ad_result]
+    mock_ad_group_ad_service.mutate_ad_group_ads.return_value = mock_ad_group_ad_response
+
+    # --- Mock enums used by the script ---
+    mock_enums = mock_google_ads_client.enums
+    mock_enums.BudgetDeliveryMethodEnum.STANDARD = "STANDARD"
+    mock_enums.CampaignStatusEnum.PAUSED = "PAUSED"
+    mock_enums.AdvertisingChannelTypeEnum.MULTI_CHANNEL = "MULTI_CHANNEL"
+    mock_enums.AdvertisingChannelSubTypeEnum.APP_CAMPAIGN = "APP_CAMPAIGN"
+    mock_enums.AppCampaignAppStoreEnum.GOOGLE_APP_STORE = "GOOGLE_APP_STORE"
+    mock_enums.AppCampaignBiddingStrategyGoalTypeEnum.OPTIMIZE_INSTALLS_TARGET_INSTALL_COST = "OPTIMIZE_INSTALLS_TARGET_INSTALL_COST"
+    mock_enums.AdGroupStatusEnum.ENABLED = "ENABLED"
+    mock_enums.AdGroupAdStatusEnum.ENABLED = "ENABLED"
+    
+    # --- Mock types ---
+    # Most types are simple containers, MagicMock default behavior is often sufficient.
+    # For AdTextAsset, it's created and then its `text` attribute is set.
+    # The default MagicMock returned by get_type will handle this.
+    # mock_ad_text_asset = mock_google_ads_client.get_type("AdTextAsset")
+    # If create_ad_text_asset returned something complex that was then used,
+    # we would mock that type more specifically.
+
+    try:
+        main(
+            mock_google_ads_client,
+            mock_customer_id,
+        )
+    except Exception as e:
+        pytest.fail(f"main function raised an exception: {e}")

examples/advanced_operations/tests/test_add_app_campaign.py

@@ -0,0 +1,36 @@
+import pytest
+from unittest.mock import MagicMock, patch
+
+from examples.advanced_operations.add_bidding_data_exclusion import main
+
+@patch("examples.advanced_operations.add_bidding_data_exclusion.uuid4", return_value=MagicMock(hex="testuuid"))
+def test_main_runs_successfully(mock_uuid4: MagicMock, mock_google_ads_client: MagicMock) -> None:
+    """Tests that the main function runs without raising an exception."""
+    mock_customer_id = "123"
+    mock_start_date_time = "2023-10-01 00:00:00"
+    mock_end_date_time = "2023-10-02 00:00:00"
+
+    # Mock BiddingDataExclusionService
+    mock_bde_service = mock_google_ads_client.get_service("BiddingDataExclusionService")
+    mock_mutate_response = MagicMock()
+    mock_result = MagicMock()
+    mock_result.resource_name = "mock_resource_name_bde"
+    mock_mutate_response.results = [mock_result]
+    mock_bde_service.mutate_bidding_data_exclusions.return_value = mock_mutate_response
+
+    # Mock enums
+    mock_enums = mock_google_ads_client.enums
+    mock_enums.SeasonalityEventScopeEnum.CHANNEL = "CHANNEL"
+    mock_enums.AdvertisingChannelTypeEnum.SEARCH = "SEARCH"
+    # The script also uses DeviceEnum, but it's commented out, so not strictly needed for this test pass
+    # mock_enums.DeviceEnum.MOBILE = "MOBILE" 
+
+    try:
+        main(
+            mock_google_ads_client,
+            mock_customer_id,
+            mock_start_date_time,
+            mock_end_date_time,
+        )
+    except Exception as e:
+        pytest.fail(f"main function raised an exception: {e}")

examples/advanced_operations/tests/test_add_bidding_data_exclusion.py

@@ -0,0 +1,38 @@
+import pytest
+from unittest.mock import MagicMock, patch
+
+from examples.advanced_operations.add_bidding_seasonality_adjustment import main
+
+@patch("examples.advanced_operations.add_bidding_seasonality_adjustment.uuid4", return_value=MagicMock(hex="testuuid"))
+def test_main_runs_successfully(mock_uuid4: MagicMock, mock_google_ads_client: MagicMock) -> None:
+    """Tests that the main function runs without raising an exception."""
+    mock_customer_id = "123"
+    mock_start_date_time = "2023-10-01 00:00:00"
+    mock_end_date_time = "2023-10-02 00:00:00"
+    mock_bid_modifier = 1.5
+
+    # Mock BiddingSeasonalityAdjustmentService
+    mock_bsa_service = mock_google_ads_client.get_service("BiddingSeasonalityAdjustmentService")
+    mock_mutate_response = MagicMock()
+    mock_result = MagicMock()
+    mock_result.resource_name = "mock_resource_name_bsa"
+    mock_mutate_response.results = [mock_result]
+    mock_bsa_service.mutate_bidding_seasonality_adjustments.return_value = mock_mutate_response
+
+    # Mock enums
+    mock_enums = mock_google_ads_client.enums
+    mock_enums.SeasonalityEventScopeEnum.CHANNEL = "CHANNEL"
+    mock_enums.AdvertisingChannelTypeEnum.SEARCH = "SEARCH"
+    # The script also uses DeviceEnum, but it's commented out, so not strictly needed for this test pass
+    # mock_enums.DeviceEnum.MOBILE = "MOBILE"
+
+    try:
+        main(
+            mock_google_ads_client,
+            mock_customer_id,
+            mock_start_date_time,
+            mock_end_date_time,
+            mock_bid_modifier,
+        )
+    except Exception as e:
+        pytest.fail(f"main function raised an exception: {e}")

examples/advanced_operations/tests/test_add_bidding_seasonality_adjustment.py

@@ -0,0 +1,46 @@
+import pytest
+from unittest.mock import MagicMock
+
+from examples.advanced_operations.add_call_ad import main
+
+def test_main_runs_successfully(mock_google_ads_client: MagicMock) -> None:
+    """Tests that the main function runs without raising an exception."""
+    mock_customer_id = "123"
+    mock_ad_group_id = "456"
+    mock_phone_number = "(800) 555-0100"
+    mock_phone_country = "US"
+    mock_conversion_action_id = None  # Or a string "789" if testing that path
+
+    # Mock GoogleAdsService for path helpers
+    mock_googleads_service = mock_google_ads_client.get_service("GoogleAdsService")
+    mock_googleads_service.ad_group_path.return_value = f"customers/{mock_customer_id}/adGroups/{mock_ad_group_id}"
+    if mock_conversion_action_id:
+        mock_googleads_service.conversion_action_path.return_value = f"customers/{mock_customer_id}/conversionActions/{mock_conversion_action_id}"
+
+    # Mock AdGroupAdService
+    mock_ad_group_ad_service = mock_google_ads_client.get_service("AdGroupAdService")
+    mock_mutate_response = MagicMock()
+    mock_result = MagicMock()
+    mock_result.resource_name = "mock_resource_name_ad_group_ad"
+    mock_mutate_response.results = [mock_result]
+    mock_ad_group_ad_service.mutate_ad_group_ads.return_value = mock_mutate_response
+
+    # Mock enums
+    mock_enums = mock_google_ads_client.enums
+    mock_enums.AdGroupAdStatusEnum.PAUSED = "PAUSED"
+    mock_enums.CallConversionReportingStateEnum.USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION = "USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION"
+    # If mock_conversion_action_id is None, this enum below is used.
+    mock_enums.CallConversionReportingStateEnum.USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION = "USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION"
+
+
+    try:
+        main(
+            mock_google_ads_client,
+            mock_customer_id,
+            mock_ad_group_id,
+            mock_phone_number,
+            mock_phone_country,
+            mock_conversion_action_id,
+        )
+    except Exception as e:
+        pytest.fail(f"main function raised an exception: {e}")