	In Browser
	StumbleUpon
	del.icio.us
	Google
	Google Buzz
	reddit
	LinkedIn

	Facebook
	Twitter
	Linkedin
	E-Mail

Generative AI > Google Gemini API > ADK with Google Contacts - CRM Integration

ADK with Google Contacts - CRM Integration

Author: Venkata Sudhakar

The Google People API (formerly Contacts API) gives ADK agents access to the Google Workspace contact directory - useful for resolving vendor email addresses, looking up regional managers, and maintaining a lightweight CRM without a separate system. ShopMax India uses a Contacts-connected agent to enrich order data with vendor details and create new contact records when onboarding suppliers.

The People API supports two types of contacts: personal contacts (contactGroups) and directory contacts (domain-wide). For Workspace organisations, the otherContacts and directory search scopes allow the agent to search the company directory by name or email. Creating contacts uses the people.create method with a Person resource containing names, emails, phone numbers, and organisation details.

The below example shows an ADK agent that searches the ShopMax contact directory and creates a new vendor contact.

from google.adk.agents import LlmAgent
from google.adk.tools import FunctionTool
from google.adk.sessions import InMemorySessionService
from google.adk.runners import Runner
from google.oauth2 import service_account
from googleapiclient.discovery import build

SCOPES = [
    "https://www.googleapis.com/auth/contacts",
    "https://www.googleapis.com/auth/directory.readonly",
]

def get_people_service(delegated_user: str = "admin@shopmax.in"):
    creds = service_account.Credentials.from_service_account_file(
        "/secrets/sa-key.json", scopes=SCOPES
    ).with_subject(delegated_user)
    return build("people", "v1", credentials=creds)

def search_contacts(query: str) -> dict:
    """Search the ShopMax Workspace directory for a contact by name or email."""
    svc = get_people_service()
    results = svc.people().searchDirectoryPeople(
        query=query,
        readMask="names,emailAddresses,phoneNumbers,organizations",
        sources=["DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT",
                 "DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE"],
        pageSize=5,
    ).execute()
    people = results.get("people", [])
    contacts = []
    for p in people:
        contacts.append({
            "name": p.get("names", [{}])[0].get("displayName"),
            "email": p.get("emailAddresses", [{}])[0].get("value"),
            "phone": p.get("phoneNumbers", [{}])[0].get("value"),
            "org": p.get("organizations", [{}])[0].get("name"),
        })
    return {"found": len(contacts), "contacts": contacts}

def create_vendor_contact(name: str, email: str, phone: str,
                           company: str, city: str) -> dict:
    """Create a new vendor contact in the ShopMax address book."""
    svc = get_people_service()
    person = {
        "names": [{"givenName": name}],
        "emailAddresses": [{"value": email, "type": "work"}],
        "phoneNumbers": [{"value": phone, "type": "work"}],
        "organizations": [{"name": company, "type": "work"}],
        "addresses": [{"city": city, "type": "work"}],
    }
    created = svc.people().createContact(body=person).execute()
    return {"status": "created", "resource_name": created["resourceName"]}

agent = LlmAgent(
    name="shopmax_contacts_agent",
    model="gemini-2.0-flash",
    instruction="You are a ShopMax CRM agent. Search vendor contacts and create new contact records as requested.",
    tools=[FunctionTool(search_contacts), FunctionTool(create_vendor_contact)],
)

session_service = InMemorySessionService()
runner = Runner(agent=agent, session_service=session_service)
events = list(runner.run(
    user_id="procurement", session_id="sess_contacts_001",
    new_message={"role": "user", "parts": [{
        "text": "Add new vendor: Rahul Verma, rahul@freshsupply.in, +91-98201-44321, FreshSupply Pvt Ltd, Hyderabad"
    }]},
))
print(next(e.content.parts[0].text for e in events if e.is_final_response()))

It gives the following output,

New vendor contact created:
  Name    : Rahul Verma
  Email   : [email protected]
  Phone   : +91-98201-44321
  Company : FreshSupply Pvt Ltd
  City    : Hyderabad
  Status  : Contact saved to ShopMax address book.

Combine the Contacts agent with the Sheets agent to sync the vendor master list - when a new contact is created, a row is appended to the Vendor Registry sheet with the contact details and onboarding date. Use the People API groups endpoint to organise contacts into labelled groups such as Electronics Vendors, Logistics Partners, and Service Providers for easier lookup by other agents.

Send your comments, suggestions or queries regarding this site to [email protected].