Conversion Source Configuration Updater

Build a tool that updates configuration settings for existing Merchant Center conversion tracking destinations. The tool must support selective field updates using field masks to modify only specified properties while leaving others unchanged.

Capabilities

Update Display Name

• When updating merchant account "12345", conversion source "conv_001" with display name "New Campaign Name", the display name is changed while currency and attribution settings remain unchanged @test

Update Currency Code

• When updating merchant account "12345", conversion source "conv_002" with currency code "EUR", the currency is changed from "USD" to "EUR" while display name and attribution settings remain unchanged @test

Update Attribution Model

• When updating merchant account "12345", conversion source "conv_003" with attribution model "LINEAR", the attribution model is changed while display name and currency remain unchanged @test

Validate Update Request

• When attempting to update with no fields specified, a ValueError is raised with message "At least one field must be specified for update" @test

Implementation

@generates

API

def update_conversion_source(
    merchant_id: str,
    conversion_source_id: str,
    display_name: str = None,
    currency_code: str = None,
    attribution_model: str = None
):
    """
    Update specific fields of a Merchant Center destination conversion source.

    Args:
        merchant_id: The merchant account ID (e.g., "12345")
        conversion_source_id: The conversion source identifier (e.g., "conv_001")
        display_name: Optional new display name for the conversion source
        currency_code: Optional new currency code (e.g., "USD", "EUR")
        attribution_model: Optional new attribution model type (e.g., "LINEAR", "LAST_CLICK")

    Returns:
        Dictionary containing the updated conversion source with keys:
        - 'name': Full resource name
        - 'display_name': Updated display name
        - 'currency_code': Updated currency code
        - 'attribution_model': Updated attribution model

    Raises:
        ValueError: If no fields are specified for update
    """
    pass

Dependencies { .dependencies }

google-shopping-merchant-conversions { .dependency }

Provides conversion source management functionality for Google Merchant Center.

@satisfied-by