Skip to Content
Referenceoo CLI

oo connections

Connect Google with a browser link and manage your grants.

Connect Google with a browser link and manage your grants

oo connections list

Your Google accounts and explicit agent grants

oo connections list

It also takes the connection options.

oo connections google

Print a click-to-connect link for a person; no pasted code

oo connections google [options] [COMMAND]
ArgumentRequiredDefaultChoicesDescription
--agent AGENTnogrant this named agent the requested service access; an agent always requests for itself
--capability CAPABILITYnoa capability oo connections catalog marks available; required, repeat for several
--client CLIENTnoopenorange, ownwhose Google app the person approves: openorange (the default) or own, your organization's, once an administrator set it

It also takes the connection options.

oo connections google client

Your organization's own Google OAuth client. Connections made with it get whatever it requests and Google grants; Google's rules for your app apply.

oo connections google client [COMMAND]

It also takes the connection options.

oo connections google client show

The app set, and the redirect URI and JavaScript origin to register for it in Google Cloud

oo connections google client show

It also takes the connection options.

oo connections google client set

Set it from the OAuth client JSON file Google Cloud downloads

oo connections google client set [options]
ArgumentRequiredDefaultChoicesDescription
--file FILEyesthe downloaded client JSON file ({"web": ...} or {"installed": ...})
--picker-key-file FILEnoa file holding the Google Picker API key, for Drive files you choose; - reads standard input

It also takes the connection options.

oo connections google client clear

Remove it; every connection made with it ends

oo connections google client clear [options]
ArgumentRequiredDefaultChoicesDescription
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

oo connections catalog

Discover Workspace capabilities, operations and parameter schemas

oo connections catalog [options]
ArgumentRequiredDefaultChoicesDescription
--service SERVICEnoshow one service, for example gmail, calendar or sheets
--operation OPERATIONnoshow one operation with its complete parameter schema

It also takes the connection options.

oo connections do

Perform a catalogued Workspace action using an explicitly selected connection

oo connections do [options] connection_id operation
ArgumentRequiredDefaultChoicesDescription
connection_idyesthe connection ID from oo connections list
operationyesthe exact operation ID from oo connections catalog
--params PARAMSno{}operation parameters as a JSON object
--params-file PARAMS_FILEnoread operation parameters from a UTF-8 JSON file (up to 6 MiB)
--param PARAMnoone NAME=VALUE parameter; repeat for several; values may be JSON
--save PATHnoa read only: write the file it returns (a Drive download or export, a Gmail attachment) to PATH, a new file readable by you alone, instead of printing its content
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

oo connections status

Follow a connection request

oo connections status request_id
ArgumentRequiredDefaultChoicesDescription
request_idyesthe request ID returned by oo connections google

It also takes the connection options.

oo connections disconnect

End one explicit Google grant

oo connections disconnect [options] connection_id
ArgumentRequiredDefaultChoicesDescription
connection_idyesthe connection ID from oo connections list
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

Search an explicitly selected Gmail connection (read only)

oo connections gmail-search [options] connection_id query
ArgumentRequiredDefaultChoicesDescription
connection_idyesthe connection ID from oo connections list
queryyesthe Gmail search query, for example from:sender@example.com
--limit LIMITno10maximum messages to return, from 1 to 20 (default: 10)
--page-token PAGE_TOKENnothe next-page token returned by an earlier search

It also takes the connection options.

oo connections gmail-read

Read one message in an explicitly selected connection

oo connections gmail-read connection_id message_id
ArgumentRequiredDefaultChoicesDescription
connection_idyesthe connection ID from oo connections list
message_idyesthe message ID returned by oo connections gmail-search

It also takes the connection options.

On this page