Conversion Client Manager

A utility module for managing API client connections with configurable transport mechanisms and endpoint settings.

Capabilities

Client Initialization

Create a function that initializes and returns a properly configured API client instance with appropriate transport settings.

• Calling create_client("merchants/12345") with default settings returns a synchronous client instance @test
• Calling create_client("merchants/12345", transport="rest") configures the client to use REST transport @test

Asynchronous Client Support

Implement support for creating asynchronous client instances for concurrent operations.

• Calling create_async_client("merchants/12345") returns an asynchronous client instance @test
• The async client supports async context manager protocol (can be used with "async with") @test

Endpoint Configuration

Enable configuration of regional API endpoints for client connections.

• Calling create_client("merchants/12345", endpoint="https://custom-api.example.com") configures the client to connect to that endpoint @test

Implementation

@generates

API

from typing import Optional, Literal

TransportType = Literal["grpc", "grpc_asyncio", "rest"]

def create_client(
    merchant_id: str,
    transport: TransportType = "grpc",
    endpoint: Optional[str] = None
):
    """
    Creates and returns a synchronous API client.

    Args:
        merchant_id: The merchant account identifier
        transport: Transport mechanism to use (grpc, grpc_asyncio, or rest)
        endpoint: Optional custom API endpoint URL

    Returns:
        Configured client instance
    """
    pass

def create_async_client(
    merchant_id: str,
    transport: TransportType = "grpc_asyncio",
    endpoint: Optional[str] = None
):
    """
    Creates and returns an asynchronous API client.

    Args:
        merchant_id: The merchant account identifier
        transport: Transport mechanism to use (grpc_asyncio recommended)
        endpoint: Optional custom API endpoint URL

    Returns:
        Configured async client instance
    """
    pass

Dependencies { .dependencies }

google-shopping-merchant-conversions { .dependency }

Provides the Google Shopping Merchant Conversions API client library for managing conversion sources.

@satisfied-by