google

README

togo-framework/contacts-google

Part of the togo framework.

Install

togo install togo-framework/contacts-google

contacts-google — Google People API driver for togo contacts

A togo contacts driver backed by the Google People API. Imports/syncs a user's Google Contacts behind the togo ContactsProvider interface.

togo install togo-framework/contacts        # the base
togo install togo-framework/contacts-google # this driver

CONTACTS_DRIVER=google
GOOGLE_CONTACTS_TOKEN=ya29.…   # a People-API OAuth access token

The OAuth flow (consent + token refresh, scope contacts.readonly) is handled by your app; this driver consumes the access token and calls people/me/connections. Once selected it powers the base API:

svc, _ := contacts.FromKernel(k)
all, _ := svc.Sync(ctx)   // every Google contact, normalized

MIT

---

Premium sponsors

ID8 Media  ·  One Studio

_{Support togo — become a sponsor.}

Documentation

Overview

Package google is a Google People API driver for togo contacts. Blank-import it and set CONTACTS_DRIVER=google plus a People-API OAuth access token.

The OAuth flow (obtaining/refreshing the access token) is the app's job; this driver consumes a token from GOOGLE_CONTACTS_TOKEN (or GOOGLE_ACCESS_TOKEN).