Merge branch 'worktree-agent-acef51f9a1658599e'

This commit is contained in:
2026-10-25 15:24:28 +01:00
24 changed files with 3949 additions and 3 deletions
+212
View File
@@ -0,0 +1,212 @@
# Google Workspace - Specification
Owned directory: `src/google/workspace/`. Namespace `molo::google::workspace`.
Depends on the `src/google` foundation (`GoogleClient`, `Service`,
`ServiceAccountKey`, `Credentials`). Plan: `plans/18-breadth.md` section 1.
## 1. Scope
Twenty Workspace APIs, every Discovery method (714 calls, generated, not typed
by hand): Gmail, Drive, Calendar, Sheets, Docs, Slides, Forms, Tasks, Chat,
Meet, People, Keep, Classroom, YouTube Data, YouTube Analytics, YouTube
Reporting, Admin SDK Directory, Admin SDK Reports, Groups Settings, Vault.
`WorkspaceApi` reaches any call by its Discovery method id; typed classes
(`Gmail`, `Drive`, ...) add read helpers for common questions. Domain-wide
delegation (service-account `sub` claim) is a typed option (`Delegation`).
Workspace data belongs to humans. Every call has a `Kind` (read, write,
destroy, send) and the library method that runs it must match: `read`,
`write`, `destroy`, `send`. The last three take an explicit `confirm` with no
default; false throws before any traffic. The example never sends, writes or
deletes without `"confirm":true`. Live checks here are reads only.
## 2. Module map
| File | Concern |
|---|---|
| `caps.h` | Static ceilings (`WorkspaceCaps`) |
| `calls.h/.cpp` | `ApiSpec`, `CallSpec`, `Kind`, lookups (`find_call_in`, `params_of`, `body_fields_of`) |
| `call_table.cpp` | GENERATED: the one table of apis, calls and request schemas |
| `prepared_call.h/.cpp` | `PreparedCall::build`: validation, path and query rendering from the table |
| `workspace_api.h/.cpp` | `WorkspaceApi : Service`: read / write / destroy / send / pages / list |
| `services.h/.cpp` | Typed read helpers, one class per API |
| `delegation.h/.cpp` | `Delegation`, `DelegatedAuth` (RS256 JWT with optional `sub`) |
| `workspace_client.h/.cpp` | `Scopes`, `WorkspaceOptions`, `WorkspaceAuth`, `make_workspace_client`, `Workspace` facade |
| `tools/gen_calls.py` | Regenerates `call_table.cpp` from Discovery |
| `tools/check_discovery.py` | Proves the table against Discovery |
## 3. Static caps
| Knob | Value |
|---|---|
| parameters per call | 40 |
| query value / path value | 2048 / 512 chars |
| repeated parameter values | 100 |
| request body | 2 MiB serialized |
| `fields` selector | 1024 chars |
| pages walked / items collected | 20 (typed helpers and example: 1 to 5) / 2000 |
| delegation subject | 254 chars, one `@`, no whitespace |
| scopes per token | 40, 4096 chars joined |
## 4. Contracts
- Every URL comes from the table. Path values are percent-encoded; `{+x}`
placeholders keep `/`, no `..` segment anywhere. Unknown parameters and
unknown top-level body fields are rejected (`GoogleError` 400
`INVALID_ARGUMENT`) before any network traffic. No credential:
`NotConfiguredError` (503).
- Method ids are unique per API, not across APIs (`admin.channels.stop` is in
both Directory and Reports): lookups take the API.
- Calls whose response is bytes (`drive.files.export`, media downloads; flag
`b`) are refused, as are media uploads (flag `u` rows send the JSON metadata
only). Groups Settings gets `alt=json` (default is Atom XML).
- Kind rule (`gen_calls.py`): GET is read; DELETE, `*delete*`, `trash`,
`clear`, `emptyTrash`, `signOut`, `makeAdmin`, device `action`, matter
`close` are destroy; calls that reach other people (mail send, Chat message
and space setup, Calendar event writes, Drive permission create/update,
Classroom invitations and posts, YouTube comments) are send; the three
read-only POSTs (`calendar.freebusy.query`, Sheets `getByDataFilter`,
`values.batchGetByDataFilter`) are reads; every other POST/PUT/PATCH is write.
`check_discovery.py` enforces the GET/DELETE/allowlist part.
- Credential choice (`WorkspaceAuth::from_env`): delegation subject
(option or `GOOGLE_WORKSPACE_SUBJECT`) with the key file in
`GOOGLE_APPLICATION_CREDENTIALS` -> `DelegatedAuth`; else
`GOOGLE_ACCESS_TOKEN` (a user's OAuth token, used as is); else the key file
without subject (acts as the service account, which owns no Workspace data);
else none.
- Delegation: the foundation `JwtSigner` cannot add `sub`, so `DelegatedAuth`
signs its own assertion (same wolfCrypt RS256, key parsed by the
foundation's `ServiceAccountKey`) and refreshes 60 s before expiry.
Foundation gap, not edited: `JwtSigner::sign` / `ServiceAccountAuth` have no
subject parameter. The admin must grant the service account's client id the
scopes in Admin console > Security > API controls > Domain-wide delegation.
## 5. Scopes per service
Workspace APIs refuse `cloud-platform`. `Scopes::all_of(api)` returns every
OAuth scope Discovery lists; `Scopes::readonly_of(api)` the `*.readonly` /
`*.metadata` subset (Groups Settings has none: its single scope stands in).
`GET /google/workspace/scopes?apis=gmail,drive&readonly=true` prints them.
Read-only scopes that cover the typed helpers:
| API | Read-only scope (full list in `call_table.cpp`, `kApiTable`) |
|---|---|
| gmail | `gmail.readonly` (or `gmail.metadata`) |
| drive | `drive.readonly` (or `drive.metadata.readonly`) |
| calendar | `calendar.readonly` |
| sheets | `spreadsheets.readonly` |
| docs | `documents.readonly` |
| slides | `presentations.readonly` |
| forms | `forms.body.readonly`, `forms.responses.readonly` |
| tasks | `tasks.readonly` |
| chat | `chat.spaces.readonly`, `chat.messages.readonly` |
| meet | `meetings.space.readonly` |
| people | `contacts.readonly` (profile: `userinfo.profile`) |
| keep | `keep.readonly` |
| classroom | `classroom.courses.readonly` and sibling `*.readonly` |
| youtube | `youtube.readonly` |
| youtubeanalytics / youtubereporting | `yt-analytics.readonly` |
| directory | `admin.directory.user.readonly`, `.group.readonly`, ... |
| reports | `admin.reports.audit.readonly` |
| groupssettings | `apps.groups.settings` (no readonly scope exists) |
| vault | `ediscovery.readonly` |
## 6. Example routes (`/google/workspace`)
GET `/` (page), `/status`, `/apis`, `/calls?api=&kind=`, `/scopes?apis=&readonly=`.
POST `/call` (`api`, `id`, `params`, `body`, `confirm`), `/list` (`api`, `id`,
`params`, `maxPages` 1..5), `/delegation` (`subject`, `apis`, `readonly`;
local preview, nothing sent). Validation first (422), then dry run for
write/destroy/send unless `"confirm":true`, then the credential (503
`google_not_configured`). With no injected client the example builds one per
API and access level from the environment (read-only scopes for reads).
## Required APIs
Enable these on the project (placeholder project `example-214512124`; one
`gcloud services enable` line in `src/google/APIS.md` once the owner adds them).
A disabled API answers 403 `PERMISSION_DENIED` ("has not been used").
- `gmail.googleapis.com`: https://console.developers.google.com/apis/api/gmail.googleapis.com/overview?project=example-214512124
- `drive.googleapis.com`: https://console.developers.google.com/apis/api/drive.googleapis.com/overview?project=example-214512124
- `calendar-json.googleapis.com`: https://console.developers.google.com/apis/api/calendar-json.googleapis.com/overview?project=example-214512124
- `sheets.googleapis.com`: https://console.developers.google.com/apis/api/sheets.googleapis.com/overview?project=example-214512124
- `docs.googleapis.com`: https://console.developers.google.com/apis/api/docs.googleapis.com/overview?project=example-214512124
- `slides.googleapis.com`: https://console.developers.google.com/apis/api/slides.googleapis.com/overview?project=example-214512124
- `forms.googleapis.com`: https://console.developers.google.com/apis/api/forms.googleapis.com/overview?project=example-214512124
- `tasks.googleapis.com`: https://console.developers.google.com/apis/api/tasks.googleapis.com/overview?project=example-214512124
- `chat.googleapis.com`: https://console.developers.google.com/apis/api/chat.googleapis.com/overview?project=example-214512124
- `meet.googleapis.com`: https://console.developers.google.com/apis/api/meet.googleapis.com/overview?project=example-214512124
- `people.googleapis.com`: https://console.developers.google.com/apis/api/people.googleapis.com/overview?project=example-214512124
- `keep.googleapis.com`: https://console.developers.google.com/apis/api/keep.googleapis.com/overview?project=example-214512124
- `classroom.googleapis.com`: https://console.developers.google.com/apis/api/classroom.googleapis.com/overview?project=example-214512124
- `youtube.googleapis.com`: https://console.developers.google.com/apis/api/youtube.googleapis.com/overview?project=example-214512124
- `youtubeanalytics.googleapis.com`: https://console.developers.google.com/apis/api/youtubeanalytics.googleapis.com/overview?project=example-214512124
- `youtubereporting.googleapis.com`: https://console.developers.google.com/apis/api/youtubereporting.googleapis.com/overview?project=example-214512124
- `admin.googleapis.com` (Directory and Reports): https://console.developers.google.com/apis/api/admin.googleapis.com/overview?project=example-214512124
- `groupssettings.googleapis.com`: https://console.developers.google.com/apis/api/groupssettings.googleapis.com/overview?project=example-214512124
- `vault.googleapis.com`: https://console.developers.google.com/apis/api/vault.googleapis.com/overview?project=example-214512124
## Sources
- Discovery documents, fetched 2026-10-25 (directory:
`https://discovery.googleapis.com/discovery/v1/apis`; the URLs are in
`tools/gen_calls.py`). Revisions: gmail 20261019, drive 20261020, calendar
20261021, sheets 20261019, docs 20261019, slides 20261019, forms 20261022,
tasks 20261020, chat 20261019, meet 20261020, people 20261021, keep
20261019, classroom 20261020, youtube 20261022, youtubeAnalytics 20261021,
youtubereporting 20261021, directory 20261021, reports 20261021,
groupssettings 20220614, vault 20261015.
- OAuth 2.0 for service accounts with domain-wide delegation (RFC 7523 JWT
bearer, `sub` claim).
## Verified against discovery
`python3 -I src/google/workspace/tools/check_discovery.py`, run 2026-10-25:
`discovery ok: 20 apis, 714 calls, 201 request schemas`. Checks per row: HTTP
method, path, parameter names, location, required, number / boolean / repeated,
request schema, its top-level fields, items key is an array, media flags, base
URL, scope list; every Discovery method has a row; GET is read, DELETE is
destroy, non-GET reads are on the allowlist.
## Verified live
Project `lisa-448004`, service account, reads only, 2026-10-25
(`make google-live`, opt-in tests `workspace_live.*`):
- Token with Workspace read-only scopes and no `sub`: 200 (Google issues it).
- Same SA with `sub=nobody@example.com`: token endpoint 401 `invalid_grant`
"Invalid email or User ID". This proves the `sub` claim reaches Google; a
real user without a domain-wide delegation grant would answer
`unauthorized_client`. A successful delegated call is Unverified (no
Workspace domain with a delegation grant is available).
- `cloud-platform` bearer (sa-token) against 19 services: 403
PERMISSION_DENIED "Request had insufficient authentication scopes" (Directory
403 API not enabled).
- Scoped SA token, no `sub`: 403 PERMISSION_DENIED **API NOT ENABLED** on
project 474586702855 for Drive, Calendar, Tasks, Gmail, Sheets, Docs, Slides,
Forms, Chat, Meet, Keep, Classroom, YouTube Data, YouTube Reporting, Vault,
Admin SDK (Directory and Reports), Groups Settings. People: 403 "requires
scope profile". YouTube Analytics was not probed (needs a channel id).
Enable these in the console to see the real 401/403/empty answers.
## Unverified
- Any successful call: no Workspace data is reachable from the test project.
Response parsing in the typed helpers (items keys) is checked against the
Discovery response schemas only.
- Delegated token success, Workspace error shapes for missing delegation
(`unauthorized_client`) and per-call scope sufficiency.
- Writes, deletes and sends (by design never run live).
- `list()` pagination across several pages (no list returned data).
## Gaps
- Media upload and download (bytes) are not implemented: flagged rows `u`
send metadata only, rows `b` are refused (`src/google/workspace/calls.h`).
- Batch HTTP endpoints, push-notification channels (`watch`/`stop`) are
callable as ordinary rows but no receiver exists.
- Foundation: `ServiceAccountAuth` / `JwtSigner` lack a subject parameter
(`src/google/service_account.h`); worked around in `delegation.cpp`.
- Services to add to `api_catalog.*` / `APIS.md` by the owner: the 19 service
names under Required APIs.
+960
View File
@@ -0,0 +1,960 @@
// GENERATED by tools/gen_calls.py from Google Discovery documents. Do not edit.
// Checked against Google by tools/check_discovery.py.
#include "google/workspace/calls.h"
namespace molo::google::workspace {
// APIS-BEGIN
const ApiSpec kApiTable[] = {
{"gmail", "gmail:v1", "https://gmail.googleapis.com/$discovery/rest?version=v1", "https://gmail.googleapis.com", "gmail.googleapis.com", "https://www.googleapis.com/auth/gmail.settings.basic https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.settings.sharing https://www.googleapis.com/auth/gmail.insert https://www.googleapis.com/auth/gmail.addons.current.message.action https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.addons.current.action.compose https://www.googleapis.com/auth/gmail.addons.current.message.metadata https://mail.google.com/ https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.labels https://www.googleapis.com/auth/gmail.metadata https://www.googleapis.com/auth/gmail.addons.current.message.readonly", "https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.addons.current.message.metadata https://www.googleapis.com/auth/gmail.metadata https://www.googleapis.com/auth/gmail.addons.current.message.readonly", "20261019"},
{"drive", "drive:v3", "https://www.googleapis.com/discovery/v1/apis/drive/v3/rest", "https://www.googleapis.com/drive/v3", "drive.googleapis.com", "https://www.googleapis.com/auth/drive.appdata https://www.googleapis.com/auth/drive.metadata https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/drive.scripts https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.apps.readonly https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.photos.readonly", "https://www.googleapis.com/auth/drive.metadata https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/drive.apps.readonly https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.photos.readonly", "20261020"},
{"calendar", "calendar:v3", "https://calendar-json.googleapis.com/$discovery/rest?version=v3", "https://www.googleapis.com/calendar/v3", "calendar-json.googleapis.com", "https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/calendar.events.owned.readonly https://www.googleapis.com/auth/calendar.calendarlist https://www.googleapis.com/auth/calendar.settings.readonly https://www.googleapis.com/auth/calendar.calendars.readonly https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/calendar.calendars https://www.googleapis.com/auth/calendar.events.owned https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/calendar.calendarlist.readonly https://www.googleapis.com/auth/calendar.settings https://www.googleapis.com/auth/calendar.app.created https://www.googleapis.com/auth/calendar.freebusy https://www.googleapis.com/auth/calendar.acls.readonly https://www.googleapis.com/auth/calendar.events.freebusy https://www.googleapis.com/auth/calendar.acls https://www.googleapis.com/auth/calendar.events.public.readonly", "https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/calendar.events.owned.readonly https://www.googleapis.com/auth/calendar.settings.readonly https://www.googleapis.com/auth/calendar.calendars.readonly https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/calendar.calendarlist.readonly https://www.googleapis.com/auth/calendar.acls.readonly https://www.googleapis.com/auth/calendar.events.public.readonly", "20261021"},
{"sheets", "sheets:v4", "https://sheets.googleapis.com/$discovery/rest?version=v4", "https://sheets.googleapis.com", "sheets.googleapis.com", "https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/drive.readonly", "20261019"},
{"docs", "docs:v1", "https://docs.googleapis.com/$discovery/rest?version=v1", "https://docs.googleapis.com", "docs.googleapis.com", "https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/drive.readonly", "20261019"},
{"slides", "slides:v1", "https://slides.googleapis.com/$discovery/rest?version=v1", "https://slides.googleapis.com", "slides.googleapis.com", "https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/presentations https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/drive.readonly", "20261019"},
{"forms", "forms:v1", "https://forms.googleapis.com/$discovery/rest?version=v1", "https://forms.googleapis.com", "forms.googleapis.com", "https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/forms.body https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.file", "https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/forms.body.readonly", "20261022"},
{"tasks", "tasks:v1", "https://tasks.googleapis.com/$discovery/rest?version=v1", "https://tasks.googleapis.com", "tasks.googleapis.com", "https://www.googleapis.com/auth/tasks https://www.googleapis.com/auth/tasks.readonly", "https://www.googleapis.com/auth/tasks.readonly", "20261020"},
{"chat", "chat:v1", "https://chat.googleapis.com/$discovery/rest?version=v1", "https://chat.googleapis.com", "chat.googleapis.com", "https://www.googleapis.com/auth/chat.app.spaces.readonly https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.app.messages.readonly https://www.googleapis.com/auth/chat.customemojis https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.users.availability https://www.googleapis.com/auth/chat.users.spacesettings https://www.googleapis.com/auth/chat.spaces.pins https://www.googleapis.com/auth/chat.messages.reactions.create https://www.googleapis.com/auth/chat.app.memberships.readonly https://www.googleapis.com/auth/chat.users.sections.readonly https://www.googleapis.com/auth/chat.admin.delete https://www.googleapis.com/auth/chat.app.all.spaces.readonly https://www.googleapis.com/auth/chat.app.all.messages.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.app.delete https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.spaces.pins.readonly https://www.googleapis.com/auth/chat.app.all.memberships.readonly https://www.googleapis.com/auth/chat.users.readstate.readonly https://www.googleapis.com/auth/chat.users.availability.readonly https://www.googleapis.com/auth/chat.app.spaces.create https://www.googleapis.com/auth/chat.customemojis.readonly https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.delete https://www.googleapis.com/auth/chat.users.sections https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.admin.memberships.readonly", "https://www.googleapis.com/auth/chat.app.spaces.readonly https://www.googleapis.com/auth/chat.app.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.app.memberships.readonly https://www.googleapis.com/auth/chat.users.sections.readonly https://www.googleapis.com/auth/chat.app.all.spaces.readonly https://www.googleapis.com/auth/chat.app.all.messages.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces.pins.readonly https://www.googleapis.com/auth/chat.app.all.memberships.readonly https://www.googleapis.com/auth/chat.users.readstate.readonly https://www.googleapis.com/auth/chat.users.availability.readonly https://www.googleapis.com/auth/chat.customemojis.readonly https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.admin.memberships.readonly", "20261019"},
{"meet", "meet:v2", "https://meet.googleapis.com/$discovery/rest?version=v2", "https://meet.googleapis.com", "meet.googleapis.com", "https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/meetings.space.readonly https://www.googleapis.com/auth/meetings.space.settings", "https://www.googleapis.com/auth/meetings.space.readonly", "20261020"},
{"people", "people:v1", "https://people.googleapis.com/$discovery/rest?version=v1", "https://people.googleapis.com", "people.googleapis.com", "https://www.googleapis.com/auth/contacts.other.readonly https://www.googleapis.com/auth/user.phonenumbers.read https://www.googleapis.com/auth/user.birthday.read https://www.googleapis.com/auth/user.addresses.read https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/contacts https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/user.organization.read https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/user.gender.read https://www.googleapis.com/auth/user.emails.read https://www.googleapis.com/auth/directory.readonly", "https://www.googleapis.com/auth/contacts.other.readonly https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/directory.readonly", "20261021"},
{"keep", "keep:v1", "https://keep.googleapis.com/$discovery/rest?version=v1", "https://keep.googleapis.com", "keep.googleapis.com", "https://www.googleapis.com/auth/keep https://www.googleapis.com/auth/keep.readonly", "https://www.googleapis.com/auth/keep.readonly", "20261019"},
{"classroom", "classroom:v1", "https://classroom.googleapis.com/$discovery/rest?version=v1", "https://classroom.googleapis.com", "classroom.googleapis.com", "https://www.googleapis.com/auth/classroom.student-submissions.me.readonly https://www.googleapis.com/auth/classroom.profile.emails https://www.googleapis.com/auth/classroom.student-submissions.students.readonly https://www.googleapis.com/auth/classroom.rosters https://www.googleapis.com/auth/classroom.coursework.me https://www.googleapis.com/auth/classroom.courses https://www.googleapis.com/auth/classroom.announcements https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly https://www.googleapis.com/auth/classroom.coursework.students.readonly https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly https://www.googleapis.com/auth/classroom.courses.readonly https://www.googleapis.com/auth/classroom.push-notifications https://www.googleapis.com/auth/classroom.topics https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly https://www.googleapis.com/auth/classroom.addons.teacher https://www.googleapis.com/auth/classroom.profile.photos https://www.googleapis.com/auth/classroom.coursework.me.readonly https://www.googleapis.com/auth/classroom.announcements.readonly https://www.googleapis.com/auth/classroom.addons.student https://www.googleapis.com/auth/classroom.topics.readonly https://www.googleapis.com/auth/classroom.guardianlinks.students https://www.googleapis.com/auth/classroom.coursework.students https://www.googleapis.com/auth/classroom.rosters.readonly https://www.googleapis.com/auth/classroom.courseworkmaterials", "https://www.googleapis.com/auth/classroom.student-submissions.me.readonly https://www.googleapis.com/auth/classroom.student-submissions.students.readonly https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly https://www.googleapis.com/auth/classroom.coursework.students.readonly https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly https://www.googleapis.com/auth/classroom.courses.readonly https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly https://www.googleapis.com/auth/classroom.coursework.me.readonly https://www.googleapis.com/auth/classroom.announcements.readonly https://www.googleapis.com/auth/classroom.topics.readonly https://www.googleapis.com/auth/classroom.rosters.readonly", "20261020"},
{"youtube", "youtube:v3", "https://youtube.googleapis.com/$discovery/rest?version=v3", "https://youtube.googleapis.com", "youtube.googleapis.com", "https://www.googleapis.com/auth/youtube.upload https://www.googleapis.com/auth/youtube https://www.googleapis.com/auth/youtube.force-ssl https://www.googleapis.com/auth/youtube.channel-memberships.creator https://www.googleapis.com/auth/youtubepartner-channel-audit https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/youtubepartner", "https://www.googleapis.com/auth/youtube.readonly", "20261022"},
{"youtubeanalytics", "youtubeAnalytics:v2", "https://youtubeanalytics.googleapis.com/$discovery/rest?version=v2", "https://youtubeanalytics.googleapis.com", "youtubeanalytics.googleapis.com", "https://www.googleapis.com/auth/yt-analytics-monetary.readonly https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/yt-analytics.readonly https://www.googleapis.com/auth/youtubepartner https://www.googleapis.com/auth/youtube", "https://www.googleapis.com/auth/yt-analytics-monetary.readonly https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/yt-analytics.readonly", "20261021"},
{"youtubereporting", "youtubereporting:v1", "https://youtubereporting.googleapis.com/$discovery/rest?version=v1", "https://youtubereporting.googleapis.com", "youtubereporting.googleapis.com", "https://www.googleapis.com/auth/yt-analytics-monetary.readonly https://www.googleapis.com/auth/yt-analytics.readonly", "https://www.googleapis.com/auth/yt-analytics-monetary.readonly https://www.googleapis.com/auth/yt-analytics.readonly", "20261021"},
{"directory", "admin:directory_v1", "https://admin.googleapis.com/$discovery/rest?version=directory_v1", "https://admin.googleapis.com", "admin.googleapis.com", "https://www.googleapis.com/auth/admin.directory.orgunit https://www.googleapis.com/auth/admin.directory.device.mobile.action https://www.googleapis.com/auth/admin.directory.resource.calendar https://www.googleapis.com/auth/admin.directory.customer https://www.googleapis.com/auth/admin.directory.group https://www.googleapis.com/auth/admin.directory.userschema.readonly https://www.googleapis.com/auth/admin.directory.group.readonly https://www.googleapis.com/auth/admin.directory.device.mobile.readonly https://www.googleapis.com/auth/admin.directory.customer.readonly https://www.googleapis.com/auth/admin.directory.domain https://www.googleapis.com/auth/admin.directory.rolemanagement https://www.googleapis.com/auth/admin.directory.user.alias https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/admin.directory.user.readonly https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly https://www.googleapis.com/auth/admin.directory.group.member https://www.googleapis.com/auth/admin.directory.user.security https://www.googleapis.com/auth/admin.chrome.printers https://www.googleapis.com/auth/admin.directory.user https://www.googleapis.com/auth/admin.directory.user.alias.readonly https://www.googleapis.com/auth/admin.directory.userschema https://www.googleapis.com/auth/admin.chrome.printers.readonly https://www.googleapis.com/auth/admin.directory.device.chromeos https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly https://www.googleapis.com/auth/admin.directory.group.member.readonly https://www.googleapis.com/auth/admin.directory.orgunit.readonly https://www.googleapis.com/auth/admin.directory.device.mobile https://www.googleapis.com/auth/admin.directory.domain.readonly", "https://www.googleapis.com/auth/admin.directory.userschema.readonly https://www.googleapis.com/auth/admin.directory.group.readonly https://www.googleapis.com/auth/admin.directory.device.mobile.readonly https://www.googleapis.com/auth/admin.directory.customer.readonly https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly https://www.googleapis.com/auth/admin.directory.user.readonly https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly https://www.googleapis.com/auth/admin.directory.user.alias.readonly https://www.googleapis.com/auth/admin.chrome.printers.readonly https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly https://www.googleapis.com/auth/admin.directory.group.member.readonly https://www.googleapis.com/auth/admin.directory.orgunit.readonly https://www.googleapis.com/auth/admin.directory.domain.readonly", "20261021"},
{"reports", "admin:reports_v1", "https://admin.googleapis.com/$discovery/rest?version=reports_v1", "https://admin.googleapis.com", "admin.googleapis.com", "https://www.googleapis.com/auth/admin.reports.audit.readonly https://www.googleapis.com/auth/admin.reports.usage.readonly", "https://www.googleapis.com/auth/admin.reports.audit.readonly https://www.googleapis.com/auth/admin.reports.usage.readonly", "20261021"},
{"groupssettings", "groupssettings:v1", "https://groupssettings.googleapis.com/$discovery/rest?version=v1", "https://www.googleapis.com/groups/v1/groups", "groupssettings.googleapis.com", "https://www.googleapis.com/auth/apps.groups.settings", "", "20220614"},
{"vault", "vault:v1", "https://vault.googleapis.com/$discovery/rest?version=v1", "https://vault.googleapis.com", "vault.googleapis.com", "https://www.googleapis.com/auth/ediscovery https://www.googleapis.com/auth/ediscovery.readonly", "https://www.googleapis.com/auth/ediscovery.readonly", "20261015"},
};
// APIS-END
const std::size_t kApiTableSize = sizeof(kApiTable) / sizeof(kApiTable[0]);
// CALLS-BEGIN (one row per Discovery method; parsed by tools/check_discovery.py)
const CallSpec kCallTable[] = {
{"gmail.users.drafts.create", "gmail", "POST", "gmail/v1/users/{userId}/drafts", "userId@", "Draft", "", "w", "u"},
{"gmail.users.drafts.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/drafts/{id}", "id@,userId@", "", "", "d", ""},
{"gmail.users.drafts.get", "gmail", "GET", "gmail/v1/users/{userId}/drafts/{id}", "id@,userId@,format", "", "", "r", ""},
{"gmail.users.drafts.list", "gmail", "GET", "gmail/v1/users/{userId}/drafts", "userId@,includeSpamTrash?,maxResults#,pageToken,q", "", "drafts", "r", ""},
{"gmail.users.drafts.send", "gmail", "POST", "gmail/v1/users/{userId}/drafts/send", "userId@", "Draft", "", "s", "u"},
{"gmail.users.drafts.update", "gmail", "PUT", "gmail/v1/users/{userId}/drafts/{id}", "id@,userId@", "Draft", "", "w", "u"},
{"gmail.users.getProfile", "gmail", "GET", "gmail/v1/users/{userId}/profile", "userId@", "", "", "r", ""},
{"gmail.users.history.list", "gmail", "GET", "gmail/v1/users/{userId}/history", "userId@,historyTypes*,labelId,maxResults#,pageToken,startHistoryId", "", "history", "r", ""},
{"gmail.users.labels.create", "gmail", "POST", "gmail/v1/users/{userId}/labels", "userId@", "Label", "", "w", ""},
{"gmail.users.labels.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/labels/{id}", "userId@,id@", "", "", "d", ""},
{"gmail.users.labels.get", "gmail", "GET", "gmail/v1/users/{userId}/labels/{id}", "id@,userId@", "", "", "r", ""},
{"gmail.users.labels.list", "gmail", "GET", "gmail/v1/users/{userId}/labels", "userId@", "", "", "r", ""},
{"gmail.users.labels.patch", "gmail", "PATCH", "gmail/v1/users/{userId}/labels/{id}", "id@,userId@", "Label", "", "w", ""},
{"gmail.users.labels.update", "gmail", "PUT", "gmail/v1/users/{userId}/labels/{id}", "userId@,id@", "Label", "", "w", ""},
{"gmail.users.messages.attachments.get", "gmail", "GET", "gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}", "messageId@,userId@,id@", "", "", "r", ""},
{"gmail.users.messages.batchDelete", "gmail", "POST", "gmail/v1/users/{userId}/messages/batchDelete", "userId@", "BatchDeleteMessagesRequest", "", "d", ""},
{"gmail.users.messages.batchModify", "gmail", "POST", "gmail/v1/users/{userId}/messages/batchModify", "userId@", "BatchModifyMessagesRequest", "", "w", ""},
{"gmail.users.messages.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/messages/{id}", "id@,userId@", "", "", "d", ""},
{"gmail.users.messages.get", "gmail", "GET", "gmail/v1/users/{userId}/messages/{id}", "userId@,id@,format,metadataHeaders*", "", "", "r", ""},
{"gmail.users.messages.import", "gmail", "POST", "gmail/v1/users/{userId}/messages/import", "userId@,deleted?,internalDateSource,neverMarkSpam?,processForCalendar?", "Message", "", "w", "u"},
{"gmail.users.messages.insert", "gmail", "POST", "gmail/v1/users/{userId}/messages", "userId@,deleted?,internalDateSource", "Message", "", "w", "u"},
{"gmail.users.messages.list", "gmail", "GET", "gmail/v1/users/{userId}/messages", "userId@,includeSpamTrash?,labelIds*,maxResults#,pageToken,q", "", "messages", "r", ""},
{"gmail.users.messages.modify", "gmail", "POST", "gmail/v1/users/{userId}/messages/{id}/modify", "userId@,id@", "ModifyMessageRequest", "", "w", ""},
{"gmail.users.messages.send", "gmail", "POST", "gmail/v1/users/{userId}/messages/send", "userId@", "Message", "", "s", "u"},
{"gmail.users.messages.trash", "gmail", "POST", "gmail/v1/users/{userId}/messages/{id}/trash", "id@,userId@", "", "", "d", ""},
{"gmail.users.messages.untrash", "gmail", "POST", "gmail/v1/users/{userId}/messages/{id}/untrash", "id@,userId@", "", "", "w", ""},
{"gmail.users.settings.cse.identities.create", "gmail", "POST", "gmail/v1/users/{userId}/settings/cse/identities", "userId@", "CseIdentity", "", "w", ""},
{"gmail.users.settings.cse.identities.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}", "userId@,cseEmailAddress@", "", "", "d", ""},
{"gmail.users.settings.cse.identities.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}", "cseEmailAddress@,userId@", "", "", "r", ""},
{"gmail.users.settings.cse.identities.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/cse/identities", "userId@,pageSize#,pageToken", "", "cseIdentities", "r", ""},
{"gmail.users.settings.cse.identities.patch", "gmail", "PATCH", "gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}", "userId@,emailAddress@", "CseIdentity", "", "w", ""},
{"gmail.users.settings.cse.keypairs.create", "gmail", "POST", "gmail/v1/users/{userId}/settings/cse/keypairs", "userId@,chainValidation", "CseKeyPair", "", "w", ""},
{"gmail.users.settings.cse.keypairs.disable", "gmail", "POST", "gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable", "userId@,keyPairId@", "DisableCseKeyPairRequest", "", "w", ""},
{"gmail.users.settings.cse.keypairs.enable", "gmail", "POST", "gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable", "userId@,keyPairId@", "EnableCseKeyPairRequest", "", "w", ""},
{"gmail.users.settings.cse.keypairs.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}", "keyPairId@,userId@", "", "", "r", ""},
{"gmail.users.settings.cse.keypairs.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/cse/keypairs", "userId@,pageSize#,pageToken", "", "cseKeyPairs", "r", ""},
{"gmail.users.settings.cse.keypairs.obliterate", "gmail", "POST", "gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate", "keyPairId@,userId@", "ObliterateCseKeyPairRequest", "", "w", ""},
{"gmail.users.settings.delegates.create", "gmail", "POST", "gmail/v1/users/{userId}/settings/delegates", "userId@", "Delegate", "", "w", ""},
{"gmail.users.settings.delegates.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/settings/delegates/{delegateEmail}", "delegateEmail@,userId@", "", "", "d", ""},
{"gmail.users.settings.delegates.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/delegates/{delegateEmail}", "userId@,delegateEmail@", "", "", "r", ""},
{"gmail.users.settings.delegates.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/delegates", "userId@", "", "", "r", ""},
{"gmail.users.settings.filters.create", "gmail", "POST", "gmail/v1/users/{userId}/settings/filters", "userId@", "Filter", "", "w", ""},
{"gmail.users.settings.filters.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/settings/filters/{id}", "id@,userId@", "", "", "d", ""},
{"gmail.users.settings.filters.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/filters/{id}", "userId@,id@", "", "", "r", ""},
{"gmail.users.settings.filters.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/filters", "userId@", "", "", "r", ""},
{"gmail.users.settings.forwardingAddresses.create", "gmail", "POST", "gmail/v1/users/{userId}/settings/forwardingAddresses", "userId@", "ForwardingAddress", "", "w", ""},
{"gmail.users.settings.forwardingAddresses.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}", "userId@,forwardingEmail@", "", "", "d", ""},
{"gmail.users.settings.forwardingAddresses.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}", "userId@,forwardingEmail@", "", "", "r", ""},
{"gmail.users.settings.forwardingAddresses.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/forwardingAddresses", "userId@", "", "", "r", ""},
{"gmail.users.settings.getAutoForwarding", "gmail", "GET", "gmail/v1/users/{userId}/settings/autoForwarding", "userId@", "", "", "r", ""},
{"gmail.users.settings.getImap", "gmail", "GET", "gmail/v1/users/{userId}/settings/imap", "userId@", "", "", "r", ""},
{"gmail.users.settings.getLanguage", "gmail", "GET", "gmail/v1/users/{userId}/settings/language", "userId@", "", "", "r", ""},
{"gmail.users.settings.getPop", "gmail", "GET", "gmail/v1/users/{userId}/settings/pop", "userId@", "", "", "r", ""},
{"gmail.users.settings.getVacation", "gmail", "GET", "gmail/v1/users/{userId}/settings/vacation", "userId@", "", "", "r", ""},
{"gmail.users.settings.sendAs.create", "gmail", "POST", "gmail/v1/users/{userId}/settings/sendAs", "userId@", "SendAs", "", "w", ""},
{"gmail.users.settings.sendAs.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}", "sendAsEmail@,userId@", "", "", "d", ""},
{"gmail.users.settings.sendAs.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}", "userId@,sendAsEmail@", "", "", "r", ""},
{"gmail.users.settings.sendAs.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/sendAs", "userId@", "", "", "r", ""},
{"gmail.users.settings.sendAs.patch", "gmail", "PATCH", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}", "sendAsEmail@,userId@", "SendAs", "", "w", ""},
{"gmail.users.settings.sendAs.smimeInfo.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}", "id@,sendAsEmail@,userId@", "", "", "d", ""},
{"gmail.users.settings.sendAs.smimeInfo.get", "gmail", "GET", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}", "userId@,id@,sendAsEmail@", "", "", "r", ""},
{"gmail.users.settings.sendAs.smimeInfo.insert", "gmail", "POST", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo", "sendAsEmail@,userId@", "SmimeInfo", "", "w", ""},
{"gmail.users.settings.sendAs.smimeInfo.list", "gmail", "GET", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo", "userId@,sendAsEmail@", "", "", "r", ""},
{"gmail.users.settings.sendAs.smimeInfo.setDefault", "gmail", "POST", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault", "sendAsEmail@,id@,userId@", "", "", "w", ""},
{"gmail.users.settings.sendAs.update", "gmail", "PUT", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}", "sendAsEmail@,userId@", "SendAs", "", "w", ""},
{"gmail.users.settings.sendAs.verify", "gmail", "POST", "gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify", "sendAsEmail@,userId@", "", "", "w", ""},
{"gmail.users.settings.updateAutoForwarding", "gmail", "PUT", "gmail/v1/users/{userId}/settings/autoForwarding", "userId@", "AutoForwarding", "", "w", ""},
{"gmail.users.settings.updateImap", "gmail", "PUT", "gmail/v1/users/{userId}/settings/imap", "userId@", "ImapSettings", "", "w", ""},
{"gmail.users.settings.updateLanguage", "gmail", "PUT", "gmail/v1/users/{userId}/settings/language", "userId@", "LanguageSettings", "", "w", ""},
{"gmail.users.settings.updatePop", "gmail", "PUT", "gmail/v1/users/{userId}/settings/pop", "userId@", "PopSettings", "", "w", ""},
{"gmail.users.settings.updateVacation", "gmail", "PUT", "gmail/v1/users/{userId}/settings/vacation", "userId@", "VacationSettings", "", "w", ""},
{"gmail.users.stop", "gmail", "POST", "gmail/v1/users/{userId}/stop", "userId@", "", "", "w", ""},
{"gmail.users.threads.delete", "gmail", "DELETE", "gmail/v1/users/{userId}/threads/{id}", "userId@,id@", "", "", "d", ""},
{"gmail.users.threads.get", "gmail", "GET", "gmail/v1/users/{userId}/threads/{id}", "userId@,id@,format,metadataHeaders*", "", "", "r", ""},
{"gmail.users.threads.list", "gmail", "GET", "gmail/v1/users/{userId}/threads", "userId@,includeSpamTrash?,labelIds*,maxResults#,pageToken,q", "", "threads", "r", ""},
{"gmail.users.threads.modify", "gmail", "POST", "gmail/v1/users/{userId}/threads/{id}/modify", "userId@,id@", "ModifyThreadRequest", "", "w", ""},
{"gmail.users.threads.trash", "gmail", "POST", "gmail/v1/users/{userId}/threads/{id}/trash", "userId@,id@", "", "", "d", ""},
{"gmail.users.threads.untrash", "gmail", "POST", "gmail/v1/users/{userId}/threads/{id}/untrash", "id@,userId@", "", "", "w", ""},
{"gmail.users.watch", "gmail", "POST", "gmail/v1/users/{userId}/watch", "userId@", "WatchRequest", "", "w", ""},
{"drive.about.get", "drive", "GET", "about", "", "", "", "r", ""},
{"drive.accessproposals.get", "drive", "GET", "files/{fileId}/accessproposals/{proposalId}", "fileId@,proposalId@", "", "", "r", ""},
{"drive.accessproposals.list", "drive", "GET", "files/{fileId}/accessproposals", "fileId@,pageSize#,pageToken", "", "accessProposals", "r", ""},
{"drive.accessproposals.resolve", "drive", "POST", "files/{fileId}/accessproposals/{proposalId}:resolve", "fileId@,proposalId@", "ResolveAccessProposalRequest", "", "w", ""},
{"drive.approvals.approve", "drive", "POST", "files/{fileId}/approvals/{approvalId}:approve", "approvalId@,fileId@", "ApproveApprovalRequest", "", "w", ""},
{"drive.approvals.cancel", "drive", "POST", "files/{fileId}/approvals/{approvalId}:cancel", "approvalId@,fileId@", "CancelApprovalRequest", "", "w", ""},
{"drive.approvals.comment", "drive", "POST", "files/{fileId}/approvals/{approvalId}:comment", "fileId@,approvalId@", "CommentApprovalRequest", "", "w", ""},
{"drive.approvals.decline", "drive", "POST", "files/{fileId}/approvals/{approvalId}:decline", "fileId@,approvalId@", "DeclineApprovalRequest", "", "w", ""},
{"drive.approvals.get", "drive", "GET", "files/{fileId}/approvals/{approvalId}", "approvalId@,fileId@", "", "", "r", ""},
{"drive.approvals.list", "drive", "GET", "files/{fileId}/approvals", "fileId@,pageSize#,pageToken", "", "items", "r", ""},
{"drive.approvals.reassign", "drive", "POST", "files/{fileId}/approvals/{approvalId}:reassign", "approvalId@,fileId@", "ReassignApprovalRequest", "", "w", ""},
{"drive.approvals.start", "drive", "POST", "files/{fileId}/approvals:start", "fileId@", "StartApprovalRequest", "", "w", ""},
{"drive.apps.get", "drive", "GET", "apps/{appId}", "appId@", "", "", "r", ""},
{"drive.apps.list", "drive", "GET", "apps", "appFilterExtensions,appFilterMimeTypes,languageCode", "", "", "r", ""},
{"drive.changes.getStartPageToken", "drive", "GET", "changes/startPageToken", "driveId,supportsAllDrives?,supportsTeamDrives?,teamDriveId", "", "", "r", ""},
{"drive.changes.list", "drive", "GET", "changes", "driveId,includeCorpusRemovals?,includeItemsFromAllDrives?,includeLabels,includePermissionsForView,includeRemoved?,includeTeamDriveItems?,pageSize#,pageToken!,restrictToMyDrive?,spaces,supportsAllDrives?,supportsTeamDrives?,teamDriveId", "", "changes", "r", ""},
{"drive.changes.watch", "drive", "POST", "changes/watch", "driveId,includeCorpusRemovals?,includeItemsFromAllDrives?,includeLabels,includePermissionsForView,includeRemoved?,includeTeamDriveItems?,pageSize#,pageToken!,restrictToMyDrive?,spaces,supportsAllDrives?,supportsTeamDrives?,teamDriveId", "Channel", "", "w", ""},
{"drive.channels.stop", "drive", "POST", "channels/stop", "", "Channel", "", "w", ""},
{"drive.comments.create", "drive", "POST", "files/{fileId}/comments", "fileId@", "Comment", "", "w", ""},
{"drive.comments.delete", "drive", "DELETE", "files/{fileId}/comments/{commentId}", "fileId@,commentId@", "", "", "d", ""},
{"drive.comments.get", "drive", "GET", "files/{fileId}/comments/{commentId}", "commentId@,fileId@,includeDeleted?", "", "", "r", ""},
{"drive.comments.list", "drive", "GET", "files/{fileId}/comments", "fileId@,includeDeleted?,pageSize#,pageToken,startModifiedTime", "", "comments", "r", ""},
{"drive.comments.update", "drive", "PATCH", "files/{fileId}/comments/{commentId}", "fileId@,commentId@", "Comment", "", "w", ""},
{"drive.drives.create", "drive", "POST", "drives", "requestId!", "Drive", "", "w", ""},
{"drive.drives.delete", "drive", "DELETE", "drives/{driveId}", "driveId@,allowItemDeletion?,useDomainAdminAccess?", "", "", "d", ""},
{"drive.drives.get", "drive", "GET", "drives/{driveId}", "driveId@,useDomainAdminAccess?", "", "", "r", ""},
{"drive.drives.hide", "drive", "POST", "drives/{driveId}/hide", "driveId@", "", "", "w", ""},
{"drive.drives.list", "drive", "GET", "drives", "pageSize#,pageToken,q,useDomainAdminAccess?", "", "drives", "r", ""},
{"drive.drives.unhide", "drive", "POST", "drives/{driveId}/unhide", "driveId@", "", "", "w", ""},
{"drive.drives.update", "drive", "PATCH", "drives/{driveId}", "driveId@,useDomainAdminAccess?", "Drive", "", "w", ""},
{"drive.files.copy", "drive", "POST", "files/{fileId}/copy", "fileId@,copyComments?,enforceSingleParent?,ignoreDefaultVisibility?,includeLabels,includePermissionsForView,keepRevisionForever?,ocrLanguage,supportsAllDrives?,supportsTeamDrives?", "File", "", "w", ""},
{"drive.files.create", "drive", "POST", "files", "enforceSingleParent?,ignoreDefaultVisibility?,includeLabels,includePermissionsForView,keepRevisionForever?,ocrLanguage,supportsAllDrives?,supportsTeamDrives?,useContentAsIndexableText?", "File", "", "w", "u"},
{"drive.files.delete", "drive", "DELETE", "files/{fileId}", "fileId@,enforceSingleParent?,supportsAllDrives?,supportsTeamDrives?", "", "", "d", ""},
{"drive.files.download", "drive", "POST", "files/{fileId}/download", "fileId@,mimeType,revisionId", "", "", "w", ""},
{"drive.files.emptyTrash", "drive", "DELETE", "files/trash", "driveId,enforceSingleParent?", "", "", "d", ""},
{"drive.files.export", "drive", "GET", "files/{fileId}/export", "fileId@,mimeType!", "", "", "r", "db"},
{"drive.files.generateCseToken", "drive", "GET", "files/generateCseToken", "fileId,parent", "", "", "r", ""},
{"drive.files.generateIds", "drive", "GET", "files/generateIds", "count#,space,type", "", "", "r", ""},
{"drive.files.get", "drive", "GET", "files/{fileId}", "fileId@,acknowledgeAbuse?,includeLabels,includePermissionsForView,supportsAllDrives?,supportsTeamDrives?", "", "", "r", "d"},
{"drive.files.list", "drive", "GET", "files", "corpora,corpus,driveId,includeItemsFromAllDrives?,includeLabels,includePermissionsForView,includeTeamDriveItems?,orderBy,pageSize#,pageToken,q,spaces,supportsAllDrives?,supportsTeamDrives?,teamDriveId", "", "files", "r", ""},
{"drive.files.listLabels", "drive", "GET", "files/{fileId}/listLabels", "fileId@,maxResults#,pageToken", "", "labels", "r", ""},
{"drive.files.modifyLabels", "drive", "POST", "files/{fileId}/modifyLabels", "fileId@", "ModifyLabelsRequest", "", "w", ""},
{"drive.files.update", "drive", "PATCH", "files/{fileId}", "fileId@,addParents,enforceSingleParent?,includeLabels,includePermissionsForView,keepRevisionForever?,ocrLanguage,removeParents,supportsAllDrives?,supportsTeamDrives?,useContentAsIndexableText?", "File", "", "w", "u"},
{"drive.files.watch", "drive", "POST", "files/{fileId}/watch", "fileId@,acknowledgeAbuse?,includeLabels,includePermissionsForView,supportsAllDrives?,supportsTeamDrives?", "Channel", "", "w", ""},
{"drive.operations.get", "drive", "GET", "operations/{name}", "name@", "", "", "r", ""},
{"drive.permissions.create", "drive", "POST", "files/{fileId}/permissions", "fileId@,emailMessage,enforceExpansiveAccess?,enforceSingleParent?,moveToNewOwnersRoot?,sendNotificationEmail?,supportsAllDrives?,supportsTeamDrives?,transferOwnership?,useDomainAdminAccess?", "Permission", "", "s", ""},
{"drive.permissions.delete", "drive", "DELETE", "files/{fileId}/permissions/{permissionId}", "permissionId@,fileId@,enforceExpansiveAccess?,supportsAllDrives?,supportsTeamDrives?,useDomainAdminAccess?", "", "", "d", ""},
{"drive.permissions.get", "drive", "GET", "files/{fileId}/permissions/{permissionId}", "permissionId@,fileId@,supportsAllDrives?,supportsTeamDrives?,useDomainAdminAccess?", "", "", "r", ""},
{"drive.permissions.list", "drive", "GET", "files/{fileId}/permissions", "fileId@,includePermissionsForView,pageSize#,pageToken,supportsAllDrives?,supportsTeamDrives?,useDomainAdminAccess?", "", "permissions", "r", ""},
{"drive.permissions.update", "drive", "PATCH", "files/{fileId}/permissions/{permissionId}", "fileId@,permissionId@,enforceExpansiveAccess?,removeExpiration?,supportsAllDrives?,supportsTeamDrives?,transferOwnership?,useDomainAdminAccess?", "Permission", "", "s", ""},
{"drive.replies.create", "drive", "POST", "files/{fileId}/comments/{commentId}/replies", "commentId@,fileId@", "Reply", "", "w", ""},
{"drive.replies.delete", "drive", "DELETE", "files/{fileId}/comments/{commentId}/replies/{replyId}", "fileId@,commentId@,replyId@", "", "", "d", ""},
{"drive.replies.get", "drive", "GET", "files/{fileId}/comments/{commentId}/replies/{replyId}", "fileId@,replyId@,commentId@,includeDeleted?", "", "", "r", ""},
{"drive.replies.list", "drive", "GET", "files/{fileId}/comments/{commentId}/replies", "commentId@,fileId@,includeDeleted?,pageSize#,pageToken", "", "replies", "r", ""},
{"drive.replies.update", "drive", "PATCH", "files/{fileId}/comments/{commentId}/replies/{replyId}", "commentId@,replyId@,fileId@", "Reply", "", "w", ""},
{"drive.revisions.delete", "drive", "DELETE", "files/{fileId}/revisions/{revisionId}", "fileId@,revisionId@", "", "", "d", ""},
{"drive.revisions.get", "drive", "GET", "files/{fileId}/revisions/{revisionId}", "fileId@,revisionId@,acknowledgeAbuse?", "", "", "r", "d"},
{"drive.revisions.list", "drive", "GET", "files/{fileId}/revisions", "fileId@,pageSize#,pageToken", "", "revisions", "r", ""},
{"drive.revisions.update", "drive", "PATCH", "files/{fileId}/revisions/{revisionId}", "fileId@,revisionId@", "Revision", "", "w", ""},
{"drive.teamdrives.create", "drive", "POST", "teamdrives", "requestId!", "TeamDrive", "", "w", ""},
{"drive.teamdrives.delete", "drive", "DELETE", "teamdrives/{teamDriveId}", "teamDriveId@", "", "", "d", ""},
{"drive.teamdrives.get", "drive", "GET", "teamdrives/{teamDriveId}", "teamDriveId@,useDomainAdminAccess?", "", "", "r", ""},
{"drive.teamdrives.list", "drive", "GET", "teamdrives", "pageSize#,pageToken,q,useDomainAdminAccess?", "", "teamDrives", "r", ""},
{"drive.teamdrives.update", "drive", "PATCH", "teamdrives/{teamDriveId}", "teamDriveId@,useDomainAdminAccess?", "TeamDrive", "", "w", ""},
{"calendar.acl.delete", "calendar", "DELETE", "calendars/{calendarId}/acl/{ruleId}", "ruleId@,calendarId@", "", "", "d", ""},
{"calendar.acl.get", "calendar", "GET", "calendars/{calendarId}/acl/{ruleId}", "ruleId@,calendarId@", "", "", "r", ""},
{"calendar.acl.insert", "calendar", "POST", "calendars/{calendarId}/acl", "calendarId@,sendNotifications?", "AclRule", "", "s", ""},
{"calendar.acl.list", "calendar", "GET", "calendars/{calendarId}/acl", "calendarId@,maxResults#,pageToken,showDeleted?,syncToken", "", "items", "r", ""},
{"calendar.acl.patch", "calendar", "PATCH", "calendars/{calendarId}/acl/{ruleId}", "calendarId@,ruleId@,sendNotifications?", "AclRule", "", "w", ""},
{"calendar.acl.update", "calendar", "PUT", "calendars/{calendarId}/acl/{ruleId}", "ruleId@,calendarId@,sendNotifications?", "AclRule", "", "w", ""},
{"calendar.acl.watch", "calendar", "POST", "calendars/{calendarId}/acl/watch", "calendarId@,maxResults#,pageToken,showDeleted?,syncToken", "Channel", "", "w", ""},
{"calendar.calendarList.delete", "calendar", "DELETE", "users/me/calendarList/{calendarId}", "calendarId@", "", "", "d", ""},
{"calendar.calendarList.get", "calendar", "GET", "users/me/calendarList/{calendarId}", "calendarId@", "", "", "r", ""},
{"calendar.calendarList.insert", "calendar", "POST", "users/me/calendarList", "colorRgbFormat?", "CalendarListEntry", "", "w", ""},
{"calendar.calendarList.list", "calendar", "GET", "users/me/calendarList", "maxResults#,minAccessRole,pageToken,showDeleted?,showHidden?,showOwnOrganizationOnly?,syncToken", "", "items", "r", ""},
{"calendar.calendarList.patch", "calendar", "PATCH", "users/me/calendarList/{calendarId}", "calendarId@,colorRgbFormat?", "CalendarListEntry", "", "w", ""},
{"calendar.calendarList.update", "calendar", "PUT", "users/me/calendarList/{calendarId}", "calendarId@,colorRgbFormat?", "CalendarListEntry", "", "w", ""},
{"calendar.calendarList.watch", "calendar", "POST", "users/me/calendarList/watch", "maxResults#,minAccessRole,pageToken,showDeleted?,showHidden?,showOwnOrganizationOnly?,syncToken", "Channel", "", "w", ""},
{"calendar.calendars.clear", "calendar", "POST", "calendars/{calendarId}/clear", "calendarId@", "", "", "d", ""},
{"calendar.calendars.delete", "calendar", "DELETE", "calendars/{calendarId}", "calendarId@", "", "", "d", ""},
{"calendar.calendars.get", "calendar", "GET", "calendars/{calendarId}", "calendarId@", "", "", "r", ""},
{"calendar.calendars.insert", "calendar", "POST", "calendars", "", "Calendar", "", "w", ""},
{"calendar.calendars.patch", "calendar", "PATCH", "calendars/{calendarId}", "calendarId@", "Calendar", "", "w", ""},
{"calendar.calendars.transferOwnership", "calendar", "POST", "calendars/{calendarId}/transferOwnership", "calendarId@,newDataOwner!,useAdminAccess!?", "", "", "w", ""},
{"calendar.calendars.update", "calendar", "PUT", "calendars/{calendarId}", "calendarId@", "Calendar", "", "w", ""},
{"calendar.channels.stop", "calendar", "POST", "channels/stop", "", "Channel", "", "w", ""},
{"calendar.colors.get", "calendar", "GET", "colors", "", "", "", "r", ""},
{"calendar.events.delete", "calendar", "DELETE", "calendars/{calendarId}/events/{eventId}", "calendarId@,eventId@,sendNotifications?,sendUpdates", "", "", "d", ""},
{"calendar.events.get", "calendar", "GET", "calendars/{calendarId}/events/{eventId}", "calendarId@,eventId@,alwaysIncludeEmail?,maxAttendees#,timeZone", "", "", "r", ""},
{"calendar.events.import", "calendar", "POST", "calendars/{calendarId}/events/import", "calendarId@,conferenceDataVersion#,eventLabelVersion#,supportsAttachments?", "Event", "", "s", ""},
{"calendar.events.insert", "calendar", "POST", "calendars/{calendarId}/events", "calendarId@,conferenceDataVersion#,eventLabelVersion#,maxAttendees#,sendNotifications?,sendUpdates,supportsAttachments?", "Event", "", "s", ""},
{"calendar.events.instances", "calendar", "GET", "calendars/{calendarId}/events/{eventId}/instances", "eventId@,calendarId@,alwaysIncludeEmail?,maxAttendees#,maxResults#,originalStart,pageToken,showDeleted?,timeMax,timeMin,timeZone", "", "", "r", ""},
{"calendar.events.list", "calendar", "GET", "calendars/{calendarId}/events", "calendarId@,alwaysIncludeEmail?,eventTypes*,iCalUID,maxAttendees#,maxResults#,orderBy,pageToken,privateExtendedProperty*,q,sharedExtendedProperty*,showDeleted?,showHiddenInvitations?,singleEvents?,syncToken,timeMax,timeMin,timeZone,updatedMin", "", "", "r", ""},
{"calendar.events.move", "calendar", "POST", "calendars/{calendarId}/events/{eventId}/move", "eventId@,calendarId@,destination!,sendNotifications?,sendUpdates", "", "", "s", ""},
{"calendar.events.patch", "calendar", "PATCH", "calendars/{calendarId}/events/{eventId}", "calendarId@,eventId@,alwaysIncludeEmail?,conferenceDataVersion#,eventLabelVersion#,maxAttendees#,sendNotifications?,sendUpdates,supportsAttachments?", "Event", "", "s", ""},
{"calendar.events.quickAdd", "calendar", "POST", "calendars/{calendarId}/events/quickAdd", "calendarId@,sendNotifications?,sendUpdates,text!", "", "", "s", ""},
{"calendar.events.update", "calendar", "PUT", "calendars/{calendarId}/events/{eventId}", "calendarId@,eventId@,alwaysIncludeEmail?,conferenceDataVersion#,eventLabelVersion#,maxAttendees#,sendNotifications?,sendUpdates,supportsAttachments?", "Event", "", "s", ""},
{"calendar.events.watch", "calendar", "POST", "calendars/{calendarId}/events/watch", "calendarId@,alwaysIncludeEmail?,eventTypes*,iCalUID,maxAttendees#,maxResults#,orderBy,pageToken,privateExtendedProperty*,q,sharedExtendedProperty*,showDeleted?,showHiddenInvitations?,singleEvents?,syncToken,timeMax,timeMin,timeZone,updatedMin", "Channel", "", "w", ""},
{"calendar.freebusy.query", "calendar", "POST", "freeBusy", "", "FreeBusyRequest", "", "r", ""},
{"calendar.settings.get", "calendar", "GET", "users/me/settings/{setting}", "setting@", "", "", "r", ""},
{"calendar.settings.list", "calendar", "GET", "users/me/settings", "maxResults#,pageToken,syncToken", "", "items", "r", ""},
{"calendar.settings.watch", "calendar", "POST", "users/me/settings/watch", "maxResults#,pageToken,syncToken", "Channel", "", "w", ""},
{"sheets.spreadsheets.batchUpdate", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}:batchUpdate", "spreadsheetId@", "BatchUpdateSpreadsheetRequest", "", "w", ""},
{"sheets.spreadsheets.create", "sheets", "POST", "v4/spreadsheets", "", "Spreadsheet", "", "w", ""},
{"sheets.spreadsheets.developerMetadata.get", "sheets", "GET", "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}", "spreadsheetId@,metadataId@#", "", "", "r", ""},
{"sheets.spreadsheets.developerMetadata.search", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/developerMetadata:search", "spreadsheetId@", "SearchDeveloperMetadataRequest", "", "w", ""},
{"sheets.spreadsheets.get", "sheets", "GET", "v4/spreadsheets/{spreadsheetId}", "spreadsheetId@,commentsViewMode,excludeTablesInBandedRanges?,includeGridData?,ranges*", "", "", "r", ""},
{"sheets.spreadsheets.getByDataFilter", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}:getByDataFilter", "spreadsheetId@", "GetSpreadsheetByDataFilterRequest", "", "r", ""},
{"sheets.spreadsheets.sheets.copyTo", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo", "sheetId@#,spreadsheetId@", "CopySheetToAnotherSpreadsheetRequest", "", "w", ""},
{"sheets.spreadsheets.values.append", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values/{range}:append", "range@,spreadsheetId@,includeValuesInResponse?,insertDataOption,responseDateTimeRenderOption,responseValueRenderOption,valueInputOption", "ValueRange", "", "w", ""},
{"sheets.spreadsheets.values.batchClear", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values:batchClear", "spreadsheetId@", "BatchClearValuesRequest", "", "d", ""},
{"sheets.spreadsheets.values.batchClearByDataFilter", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter", "spreadsheetId@", "BatchClearValuesByDataFilterRequest", "", "d", ""},
{"sheets.spreadsheets.values.batchGet", "sheets", "GET", "v4/spreadsheets/{spreadsheetId}/values:batchGet", "spreadsheetId@,dateTimeRenderOption,majorDimension,ranges*,valueRenderOption", "", "", "r", ""},
{"sheets.spreadsheets.values.batchGetByDataFilter", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter", "spreadsheetId@", "BatchGetValuesByDataFilterRequest", "", "r", ""},
{"sheets.spreadsheets.values.batchUpdate", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values:batchUpdate", "spreadsheetId@", "BatchUpdateValuesRequest", "", "w", ""},
{"sheets.spreadsheets.values.batchUpdateByDataFilter", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter", "spreadsheetId@", "BatchUpdateValuesByDataFilterRequest", "", "w", ""},
{"sheets.spreadsheets.values.clear", "sheets", "POST", "v4/spreadsheets/{spreadsheetId}/values/{range}:clear", "spreadsheetId@,range@", "ClearValuesRequest", "", "d", ""},
{"sheets.spreadsheets.values.get", "sheets", "GET", "v4/spreadsheets/{spreadsheetId}/values/{range}", "spreadsheetId@,range@,dateTimeRenderOption,majorDimension,valueRenderOption", "", "", "r", ""},
{"sheets.spreadsheets.values.update", "sheets", "PUT", "v4/spreadsheets/{spreadsheetId}/values/{range}", "range@,spreadsheetId@,includeValuesInResponse?,responseDateTimeRenderOption,responseValueRenderOption,valueInputOption", "ValueRange", "", "w", ""},
{"docs.documents.batchUpdate", "docs", "POST", "v1/documents/{documentId}:batchUpdate", "documentId@", "BatchUpdateDocumentRequest", "", "w", ""},
{"docs.documents.create", "docs", "POST", "v1/documents", "", "Document", "", "w", ""},
{"docs.documents.get", "docs", "GET", "v1/documents/{documentId}", "documentId@,commentsViewMode,includeTabsContent?,suggestionsViewMode", "", "", "r", ""},
{"slides.presentations.batchUpdate", "slides", "POST", "v1/presentations/{presentationId}:batchUpdate", "presentationId@", "BatchUpdatePresentationRequest", "", "w", ""},
{"slides.presentations.create", "slides", "POST", "v1/presentations", "", "Presentation", "", "w", ""},
{"slides.presentations.get", "slides", "GET", "v1/presentations/{+presentationId}", "presentationId@,commentsViewMode", "", "", "r", ""},
{"slides.presentations.pages.get", "slides", "GET", "v1/presentations/{presentationId}/pages/{pageObjectId}", "presentationId@,pageObjectId@,commentsViewMode", "", "", "r", ""},
{"slides.presentations.pages.getThumbnail", "slides", "GET", "v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail", "pageObjectId@,presentationId@,thumbnailProperties.mimeType,thumbnailProperties.thumbnailSize", "", "", "r", ""},
{"forms.forms.batchUpdate", "forms", "POST", "v1/forms/{formId}:batchUpdate", "formId@", "BatchUpdateFormRequest", "", "w", ""},
{"forms.forms.create", "forms", "POST", "v1/forms", "unpublished?", "Form", "", "w", ""},
{"forms.forms.get", "forms", "GET", "v1/forms/{formId}", "formId@", "", "", "r", ""},
{"forms.forms.responses.get", "forms", "GET", "v1/forms/{formId}/responses/{responseId}", "responseId@,formId@", "", "", "r", ""},
{"forms.forms.responses.list", "forms", "GET", "v1/forms/{formId}/responses", "formId@,filter,pageSize#,pageToken", "", "responses", "r", ""},
{"forms.forms.setPublishSettings", "forms", "POST", "v1/forms/{formId}:setPublishSettings", "formId@", "SetPublishSettingsRequest", "", "w", ""},
{"forms.forms.watches.create", "forms", "POST", "v1/forms/{formId}/watches", "formId@", "CreateWatchRequest", "", "w", ""},
{"forms.forms.watches.delete", "forms", "DELETE", "v1/forms/{formId}/watches/{watchId}", "formId@,watchId@", "", "", "d", ""},
{"forms.forms.watches.list", "forms", "GET", "v1/forms/{formId}/watches", "formId@", "", "", "r", ""},
{"forms.forms.watches.renew", "forms", "POST", "v1/forms/{formId}/watches/{watchId}:renew", "watchId@,formId@", "RenewWatchRequest", "", "w", ""},
{"tasks.tasklists.delete", "tasks", "DELETE", "tasks/v1/users/@me/lists/{tasklist}", "tasklist@", "", "", "d", ""},
{"tasks.tasklists.get", "tasks", "GET", "tasks/v1/users/@me/lists/{tasklist}", "tasklist@", "", "", "r", ""},
{"tasks.tasklists.insert", "tasks", "POST", "tasks/v1/users/@me/lists", "", "TaskList", "", "w", ""},
{"tasks.tasklists.list", "tasks", "GET", "tasks/v1/users/@me/lists", "maxResults#,pageToken", "", "items", "r", ""},
{"tasks.tasklists.patch", "tasks", "PATCH", "tasks/v1/users/@me/lists/{tasklist}", "tasklist@", "TaskList", "", "w", ""},
{"tasks.tasklists.update", "tasks", "PUT", "tasks/v1/users/@me/lists/{tasklist}", "tasklist@", "TaskList", "", "w", ""},
{"tasks.tasks.clear", "tasks", "POST", "tasks/v1/lists/{tasklist}/clear", "tasklist@", "", "", "d", ""},
{"tasks.tasks.delete", "tasks", "DELETE", "tasks/v1/lists/{tasklist}/tasks/{task}", "tasklist@,task@", "", "", "d", ""},
{"tasks.tasks.get", "tasks", "GET", "tasks/v1/lists/{tasklist}/tasks/{task}", "task@,tasklist@", "", "", "r", ""},
{"tasks.tasks.insert", "tasks", "POST", "tasks/v1/lists/{tasklist}/tasks", "tasklist@,parent,previous", "Task", "", "w", ""},
{"tasks.tasks.list", "tasks", "GET", "tasks/v1/lists/{tasklist}/tasks", "tasklist@,completedMax,completedMin,dueMax,dueMin,maxResults#,pageToken,showAssigned?,showCompleted?,showDeleted?,showHidden?,updatedMin", "", "items", "r", ""},
{"tasks.tasks.move", "tasks", "POST", "tasks/v1/lists/{tasklist}/tasks/{task}/move", "task@,tasklist@,destinationTasklist,parent,previous", "", "", "w", ""},
{"tasks.tasks.patch", "tasks", "PATCH", "tasks/v1/lists/{tasklist}/tasks/{task}", "tasklist@,task@", "Task", "", "w", ""},
{"tasks.tasks.update", "tasks", "PUT", "tasks/v1/lists/{tasklist}/tasks/{task}", "task@,tasklist@", "Task", "", "w", ""},
{"chat.customEmojis.create", "chat", "POST", "v1/customEmojis", "", "CustomEmoji", "", "w", ""},
{"chat.customEmojis.delete", "chat", "DELETE", "v1/{+name}", "name@", "", "", "d", ""},
{"chat.customEmojis.get", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.customEmojis.list", "chat", "GET", "v1/customEmojis", "filter,pageSize#,pageToken", "", "customEmojis", "r", ""},
{"chat.media.download", "chat", "GET", "v1/media/{+resourceName}", "resourceName@", "", "", "r", "d"},
{"chat.media.upload", "chat", "POST", "v1/{+parent}/attachments:upload", "parent@", "UploadAttachmentRequest", "", "s", "u"},
{"chat.spaces.completeImport", "chat", "POST", "v1/{+name}:completeImport", "name@", "CompleteImportSpaceRequest", "", "w", ""},
{"chat.spaces.create", "chat", "POST", "v1/spaces", "requestId", "Space", "", "w", ""},
{"chat.spaces.delete", "chat", "DELETE", "v1/{+name}", "name@,useAdminAccess?", "", "", "d", ""},
{"chat.spaces.findDirectMessage", "chat", "GET", "v1/spaces:findDirectMessage", "name", "", "", "r", ""},
{"chat.spaces.findGroupChats", "chat", "GET", "v1/spaces:findGroupChats", "pageSize#,pageToken,spaceView,users*", "", "spaces", "r", ""},
{"chat.spaces.get", "chat", "GET", "v1/{+name}", "name@,useAdminAccess?", "", "", "r", ""},
{"chat.spaces.list", "chat", "GET", "v1/spaces", "filter,pageSize#,pageToken", "", "spaces", "r", ""},
{"chat.spaces.members.create", "chat", "POST", "v1/{+parent}/members", "parent@,useAdminAccess?", "Membership", "", "s", ""},
{"chat.spaces.members.delete", "chat", "DELETE", "v1/{+name}", "name@,useAdminAccess?", "", "", "d", ""},
{"chat.spaces.members.get", "chat", "GET", "v1/{+name}", "name@,useAdminAccess?", "", "", "r", ""},
{"chat.spaces.members.list", "chat", "GET", "v1/{+parent}/members", "parent@,filter,pageSize#,pageToken,showGroups?,showInvited?,useAdminAccess?", "", "memberships", "r", ""},
{"chat.spaces.members.patch", "chat", "PATCH", "v1/{+name}", "name@,updateMask,useAdminAccess?", "Membership", "", "w", ""},
{"chat.spaces.messagePins.create", "chat", "POST", "v1/{+parent}/messagePins", "parent@", "MessagePin", "", "w", ""},
{"chat.spaces.messagePins.delete", "chat", "DELETE", "v1/{+name}", "name@", "", "", "d", ""},
{"chat.spaces.messagePins.list", "chat", "GET", "v1/{+parent}/messagePins", "parent@,pageSize#,pageToken", "", "messagePins", "r", ""},
{"chat.spaces.messages.attachments.get", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.spaces.messages.create", "chat", "POST", "v1/{+parent}/messages", "parent@,createMessageNotificationOptions.notificationType,messageId,messageReplyOption,requestId,threadKey", "Message", "", "s", ""},
{"chat.spaces.messages.delete", "chat", "DELETE", "v1/{+name}", "name@,force?", "", "", "d", ""},
{"chat.spaces.messages.get", "chat", "GET", "v1/{+name}", "name@,markupSyntax", "", "", "r", ""},
{"chat.spaces.messages.list", "chat", "GET", "v1/{+parent}/messages", "parent@,filter,markupSyntax,orderBy,pageSize#,pageToken,showDeleted?", "", "messages", "r", ""},
{"chat.spaces.messages.patch", "chat", "PATCH", "v1/{+name}", "name@,allowMissing?,updateMask", "Message", "", "w", ""},
{"chat.spaces.messages.reactions.create", "chat", "POST", "v1/{+parent}/reactions", "parent@", "Reaction", "", "w", ""},
{"chat.spaces.messages.reactions.delete", "chat", "DELETE", "v1/{+name}", "name@", "", "", "d", ""},
{"chat.spaces.messages.reactions.list", "chat", "GET", "v1/{+parent}/reactions", "parent@,filter,pageSize#,pageToken", "", "reactions", "r", ""},
{"chat.spaces.messages.replaceCards", "chat", "POST", "v1/{+name}:replaceCards", "name@", "ReplaceMessageCardsRequest", "", "w", ""},
{"chat.spaces.messages.search", "chat", "POST", "v1/{+parent}/messages:search", "parent@", "SearchMessagesRequest", "", "w", ""},
{"chat.spaces.messages.update", "chat", "PUT", "v1/{+name}", "name@,allowMissing?,updateMask", "Message", "", "w", ""},
{"chat.spaces.patch", "chat", "PATCH", "v1/{+name}", "name@,updateMask,useAdminAccess?", "Space", "", "w", ""},
{"chat.spaces.search", "chat", "GET", "v1/spaces:search", "orderBy,pageSize#,pageToken,query,useAdminAccess?", "", "", "r", ""},
{"chat.spaces.setup", "chat", "POST", "v1/spaces:setup", "", "SetUpSpaceRequest", "", "s", ""},
{"chat.spaces.spaceEvents.get", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.spaces.spaceEvents.list", "chat", "GET", "v1/{+parent}/spaceEvents", "parent@,filter,pageSize#,pageToken", "", "spaceEvents", "r", ""},
{"chat.users.availability.get", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.users.availability.markAsActive", "chat", "POST", "v1/{+name}:markAsActive", "name@", "MarkAsActiveRequest", "", "w", ""},
{"chat.users.availability.markAsAway", "chat", "POST", "v1/{+name}:markAsAway", "name@", "MarkAsAwayRequest", "", "w", ""},
{"chat.users.availability.markAsDoNotDisturb", "chat", "POST", "v1/{+name}:markAsDoNotDisturb", "name@", "MarkAsDoNotDisturbRequest", "", "w", ""},
{"chat.users.availability.patch", "chat", "PATCH", "v1/{+name}", "name@,updateMask", "Availability", "", "w", ""},
{"chat.users.sections.create", "chat", "POST", "v1/{+parent}/sections", "parent@", "GoogleChatV1Section", "", "w", ""},
{"chat.users.sections.delete", "chat", "DELETE", "v1/{+name}", "name@", "", "", "d", ""},
{"chat.users.sections.items.list", "chat", "GET", "v1/{+parent}/items", "parent@,filter,pageSize#,pageToken", "", "sectionItems", "r", ""},
{"chat.users.sections.items.move", "chat", "POST", "v1/{+name}:move", "name@", "MoveSectionItemRequest", "", "w", ""},
{"chat.users.sections.list", "chat", "GET", "v1/{+parent}/sections", "parent@,pageSize#,pageToken", "", "sections", "r", ""},
{"chat.users.sections.patch", "chat", "PATCH", "v1/{+name}", "name@,updateMask", "GoogleChatV1Section", "", "w", ""},
{"chat.users.sections.position", "chat", "POST", "v1/{+name}:position", "name@", "PositionSectionRequest", "", "w", ""},
{"chat.users.spaces.getSpaceReadState", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.users.spaces.spaceNotificationSetting.get", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.users.spaces.spaceNotificationSetting.patch", "chat", "PATCH", "v1/{+name}", "name@,updateMask", "SpaceNotificationSetting", "", "w", ""},
{"chat.users.spaces.threads.getThreadReadState", "chat", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"chat.users.spaces.updateSpaceReadState", "chat", "PATCH", "v1/{+name}", "name@,updateMask", "SpaceReadState", "", "w", ""},
{"meet.conferenceRecords.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.list", "meet", "GET", "v2/conferenceRecords", "filter,pageSize#,pageToken", "", "conferenceRecords", "r", ""},
{"meet.conferenceRecords.participants.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.participants.list", "meet", "GET", "v2/{+parent}/participants", "parent@,filter,pageSize#,pageToken", "", "participants", "r", ""},
{"meet.conferenceRecords.participants.participantSessions.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.participants.participantSessions.list", "meet", "GET", "v2/{+parent}/participantSessions", "parent@,filter,pageSize#,pageToken", "", "participantSessions", "r", ""},
{"meet.conferenceRecords.recordings.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.recordings.list", "meet", "GET", "v2/{+parent}/recordings", "parent@,pageSize#,pageToken", "", "recordings", "r", ""},
{"meet.conferenceRecords.smartNotes.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.smartNotes.list", "meet", "GET", "v2/{+parent}/smartNotes", "parent@,pageSize#,pageToken", "", "smartNotes", "r", ""},
{"meet.conferenceRecords.transcripts.entries.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.transcripts.entries.list", "meet", "GET", "v2/{+parent}/entries", "parent@,pageSize#,pageToken", "", "transcriptEntries", "r", ""},
{"meet.conferenceRecords.transcripts.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.conferenceRecords.transcripts.list", "meet", "GET", "v2/{+parent}/transcripts", "parent@,pageSize#,pageToken", "", "transcripts", "r", ""},
{"meet.spaces.create", "meet", "POST", "v2/spaces", "", "Space", "", "w", ""},
{"meet.spaces.endActiveConference", "meet", "POST", "v2/{+name}:endActiveConference", "name@", "EndActiveConferenceRequest", "", "w", ""},
{"meet.spaces.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.spaces.members.batchUpdate", "meet", "POST", "v2/{+parent}/members:batchUpdate", "parent@", "BatchUpdateMembersRequest", "", "w", ""},
{"meet.spaces.members.create", "meet", "POST", "v2/{+parent}/members", "parent@", "Member", "", "w", ""},
{"meet.spaces.members.delete", "meet", "DELETE", "v2/{+name}", "name@", "", "", "d", ""},
{"meet.spaces.members.get", "meet", "GET", "v2/{+name}", "name@", "", "", "r", ""},
{"meet.spaces.members.list", "meet", "GET", "v2/{+parent}/members", "parent@,pageSize#,pageToken", "", "members", "r", ""},
{"meet.spaces.members.patch", "meet", "PATCH", "v2/{+name}", "name@,updateMask", "Member", "", "w", ""},
{"meet.spaces.patch", "meet", "PATCH", "v2/{+name}", "name@,updateMask", "Space", "", "w", ""},
{"people.contactGroups.batchGet", "people", "GET", "v1/contactGroups:batchGet", "groupFields,maxMembers#,resourceNames*", "", "", "r", ""},
{"people.contactGroups.create", "people", "POST", "v1/contactGroups", "", "CreateContactGroupRequest", "", "w", ""},
{"people.contactGroups.delete", "people", "DELETE", "v1/{+resourceName}", "resourceName@,deleteContacts?", "", "", "d", ""},
{"people.contactGroups.get", "people", "GET", "v1/{+resourceName}", "resourceName@,groupFields,maxMembers#", "", "", "r", ""},
{"people.contactGroups.list", "people", "GET", "v1/contactGroups", "groupFields,pageSize#,pageToken,syncToken", "", "contactGroups", "r", ""},
{"people.contactGroups.members.modify", "people", "POST", "v1/{+resourceName}/members:modify", "resourceName@", "ModifyContactGroupMembersRequest", "", "w", ""},
{"people.contactGroups.update", "people", "PUT", "v1/{+resourceName}", "resourceName@", "UpdateContactGroupRequest", "", "w", ""},
{"people.otherContacts.copyOtherContactToMyContactsGroup", "people", "POST", "v1/{+resourceName}:copyOtherContactToMyContactsGroup", "resourceName@", "CopyOtherContactToMyContactsGroupRequest", "", "w", ""},
{"people.otherContacts.list", "people", "GET", "v1/otherContacts", "pageSize#,pageToken,readMask,requestSyncToken?,sources*,syncToken", "", "otherContacts", "r", ""},
{"people.otherContacts.search", "people", "GET", "v1/otherContacts:search", "pageSize#,query,readMask", "", "", "r", ""},
{"people.people.batchCreateContacts", "people", "POST", "v1/people:batchCreateContacts", "", "BatchCreateContactsRequest", "", "w", ""},
{"people.people.batchDeleteContacts", "people", "POST", "v1/people:batchDeleteContacts", "", "BatchDeleteContactsRequest", "", "d", ""},
{"people.people.batchUpdateContacts", "people", "POST", "v1/people:batchUpdateContacts", "", "BatchUpdateContactsRequest", "", "w", ""},
{"people.people.connections.list", "people", "GET", "v1/{+resourceName}/connections", "resourceName@,pageSize#,pageToken,personFields,requestMask.includeField,requestSyncToken?,sortOrder,sources*,syncToken", "", "connections", "r", ""},
{"people.people.createContact", "people", "POST", "v1/people:createContact", "personFields,sources*", "Person", "", "w", ""},
{"people.people.deleteContact", "people", "DELETE", "v1/{+resourceName}:deleteContact", "resourceName@", "", "", "d", ""},
{"people.people.deleteContactPhoto", "people", "DELETE", "v1/{+resourceName}:deleteContactPhoto", "resourceName@,personFields,sources*", "", "", "d", ""},
{"people.people.get", "people", "GET", "v1/{+resourceName}", "resourceName@,personFields,requestMask.includeField,sources*", "", "", "r", ""},
{"people.people.getBatchGet", "people", "GET", "v1/people:batchGet", "personFields,requestMask.includeField,resourceNames*,sources*", "", "", "r", ""},
{"people.people.listDirectoryPeople", "people", "GET", "v1/people:listDirectoryPeople", "mergeSources*,pageSize#,pageToken,readMask,requestSyncToken?,sources*,syncToken", "", "people", "r", ""},
{"people.people.searchContacts", "people", "GET", "v1/people:searchContacts", "pageSize#,query,readMask,sources*", "", "", "r", ""},
{"people.people.searchDirectoryPeople", "people", "GET", "v1/people:searchDirectoryPeople", "mergeSources*,pageSize#,pageToken,query,readMask,sources*", "", "people", "r", ""},
{"people.people.updateContact", "people", "PATCH", "v1/{+resourceName}:updateContact", "resourceName@,personFields,sources*,updatePersonFields", "Person", "", "w", ""},
{"people.people.updateContactPhoto", "people", "PATCH", "v1/{+resourceName}:updateContactPhoto", "resourceName@", "UpdateContactPhotoRequest", "", "w", ""},
{"keep.media.download", "keep", "GET", "v1/{+name}", "name@,mimeType", "", "", "r", "d"},
{"keep.notes.create", "keep", "POST", "v1/notes", "", "Note", "", "w", ""},
{"keep.notes.delete", "keep", "DELETE", "v1/{+name}", "name@", "", "", "d", ""},
{"keep.notes.get", "keep", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"keep.notes.list", "keep", "GET", "v1/notes", "filter,pageSize#,pageToken", "", "notes", "r", ""},
{"keep.notes.permissions.batchCreate", "keep", "POST", "v1/{+parent}/permissions:batchCreate", "parent@", "BatchCreatePermissionsRequest", "", "w", ""},
{"keep.notes.permissions.batchDelete", "keep", "POST", "v1/{+parent}/permissions:batchDelete", "parent@", "BatchDeletePermissionsRequest", "", "d", ""},
{"classroom.courses.aliases.create", "classroom", "POST", "v1/courses/{courseId}/aliases", "courseId@", "CourseAlias", "", "w", ""},
{"classroom.courses.aliases.delete", "classroom", "DELETE", "v1/courses/{courseId}/aliases/{alias}", "alias@,courseId@", "", "", "d", ""},
{"classroom.courses.aliases.list", "classroom", "GET", "v1/courses/{courseId}/aliases", "courseId@,pageSize#,pageToken", "", "aliases", "r", ""},
{"classroom.courses.announcements.addOnAttachments.create", "classroom", "POST", "v1/courses/{courseId}/announcements/{itemId}/addOnAttachments", "itemId@,courseId@,addOnToken,postId", "AddOnAttachment", "", "w", ""},
{"classroom.courses.announcements.addOnAttachments.delete", "classroom", "DELETE", "v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}", "attachmentId@,courseId@,itemId@,postId", "", "", "d", ""},
{"classroom.courses.announcements.addOnAttachments.get", "classroom", "GET", "v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}", "itemId@,courseId@,attachmentId@,postId", "", "", "r", ""},
{"classroom.courses.announcements.addOnAttachments.list", "classroom", "GET", "v1/courses/{courseId}/announcements/{itemId}/addOnAttachments", "courseId@,itemId@,pageSize#,pageToken,postId", "", "addOnAttachments", "r", ""},
{"classroom.courses.announcements.addOnAttachments.patch", "classroom", "PATCH", "v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}", "courseId@,attachmentId@,itemId@,postId,updateMask", "AddOnAttachment", "", "w", ""},
{"classroom.courses.announcements.create", "classroom", "POST", "v1/courses/{courseId}/announcements", "courseId@", "Announcement", "", "s", ""},
{"classroom.courses.announcements.delete", "classroom", "DELETE", "v1/courses/{courseId}/announcements/{id}", "courseId@,id@", "", "", "d", ""},
{"classroom.courses.announcements.get", "classroom", "GET", "v1/courses/{courseId}/announcements/{id}", "courseId@,id@", "", "", "r", ""},
{"classroom.courses.announcements.getAddOnContext", "classroom", "GET", "v1/courses/{courseId}/announcements/{itemId}/addOnContext", "courseId@,itemId@,addOnToken,attachmentId,postId", "", "", "r", ""},
{"classroom.courses.announcements.list", "classroom", "GET", "v1/courses/{courseId}/announcements", "courseId@,announcementStates*,orderBy,pageSize#,pageToken", "", "announcements", "r", ""},
{"classroom.courses.announcements.modifyAssignees", "classroom", "POST", "v1/courses/{courseId}/announcements/{id}:modifyAssignees", "courseId@,id@", "ModifyAnnouncementAssigneesRequest", "", "w", ""},
{"classroom.courses.announcements.patch", "classroom", "PATCH", "v1/courses/{courseId}/announcements/{id}", "id@,courseId@,updateMask", "Announcement", "", "w", ""},
{"classroom.courses.courseWork.addOnAttachments.create", "classroom", "POST", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments", "courseId@,itemId@,addOnToken,postId", "AddOnAttachment", "", "w", ""},
{"classroom.courses.courseWork.addOnAttachments.delete", "classroom", "DELETE", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}", "itemId@,courseId@,attachmentId@,postId", "", "", "d", ""},
{"classroom.courses.courseWork.addOnAttachments.get", "classroom", "GET", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}", "itemId@,courseId@,attachmentId@,postId", "", "", "r", ""},
{"classroom.courses.courseWork.addOnAttachments.list", "classroom", "GET", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments", "courseId@,itemId@,pageSize#,pageToken,postId", "", "addOnAttachments", "r", ""},
{"classroom.courses.courseWork.addOnAttachments.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}", "attachmentId@,courseId@,itemId@,postId,updateMask", "AddOnAttachment", "", "w", ""},
{"classroom.courses.courseWork.addOnAttachments.studentSubmissions.get", "classroom", "GET", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}", "courseId@,submissionId@,attachmentId@,itemId@,postId", "", "", "r", ""},
{"classroom.courses.courseWork.addOnAttachments.studentSubmissions.list", "classroom", "GET", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions", "courseId@,attachmentId@,itemId@,pageSize#,pageToken", "", "addOnAttachmentStudentSubmissions", "r", ""},
{"classroom.courses.courseWork.addOnAttachments.studentSubmissions.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}", "attachmentId@,submissionId@,itemId@,courseId@,postId,updateMask", "AddOnAttachmentStudentSubmission", "", "w", ""},
{"classroom.courses.courseWork.create", "classroom", "POST", "v1/courses/{courseId}/courseWork", "courseId@", "CourseWork", "", "s", ""},
{"classroom.courses.courseWork.delete", "classroom", "DELETE", "v1/courses/{courseId}/courseWork/{id}", "id@,courseId@", "", "", "d", ""},
{"classroom.courses.courseWork.get", "classroom", "GET", "v1/courses/{courseId}/courseWork/{id}", "courseId@,id@", "", "", "r", ""},
{"classroom.courses.courseWork.getAddOnContext", "classroom", "GET", "v1/courses/{courseId}/courseWork/{itemId}/addOnContext", "courseId@,itemId@,addOnToken,attachmentId,postId", "", "", "r", ""},
{"classroom.courses.courseWork.list", "classroom", "GET", "v1/courses/{courseId}/courseWork", "courseId@,courseWorkStates*,orderBy,pageSize#,pageToken", "", "courseWork", "r", ""},
{"classroom.courses.courseWork.modifyAssignees", "classroom", "POST", "v1/courses/{courseId}/courseWork/{id}:modifyAssignees", "courseId@,id@", "ModifyCourseWorkAssigneesRequest", "", "w", ""},
{"classroom.courses.courseWork.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWork/{id}", "courseId@,id@,updateMask", "CourseWork", "", "w", ""},
{"classroom.courses.courseWork.rubrics.create", "classroom", "POST", "v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics", "courseId@,courseWorkId@", "Rubric", "", "w", ""},
{"classroom.courses.courseWork.rubrics.delete", "classroom", "DELETE", "v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}", "courseWorkId@,id@,courseId@", "", "", "d", ""},
{"classroom.courses.courseWork.rubrics.get", "classroom", "GET", "v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}", "courseId@,courseWorkId@,id@", "", "", "r", ""},
{"classroom.courses.courseWork.rubrics.list", "classroom", "GET", "v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics", "courseWorkId@,courseId@,pageSize#,pageToken", "", "rubrics", "r", ""},
{"classroom.courses.courseWork.rubrics.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}", "courseWorkId@,id@,courseId@,updateMask", "Rubric", "", "w", ""},
{"classroom.courses.courseWork.studentSubmissions.get", "classroom", "GET", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}", "id@,courseId@,courseWorkId@", "", "", "r", ""},
{"classroom.courses.courseWork.studentSubmissions.list", "classroom", "GET", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions", "courseId@,courseWorkId@,late,pageSize#,pageToken,states*,userId", "", "studentSubmissions", "r", ""},
{"classroom.courses.courseWork.studentSubmissions.modifyAttachments", "classroom", "POST", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments", "courseWorkId@,id@,courseId@", "ModifyAttachmentsRequest", "", "w", ""},
{"classroom.courses.courseWork.studentSubmissions.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}", "id@,courseId@,courseWorkId@,updateMask", "StudentSubmission", "", "w", ""},
{"classroom.courses.courseWork.studentSubmissions.reclaim", "classroom", "POST", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim", "courseWorkId@,courseId@,id@", "ReclaimStudentSubmissionRequest", "", "w", ""},
{"classroom.courses.courseWork.studentSubmissions.return", "classroom", "POST", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return", "courseWorkId@,courseId@,id@", "ReturnStudentSubmissionRequest", "", "w", ""},
{"classroom.courses.courseWork.studentSubmissions.turnIn", "classroom", "POST", "v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn", "id@,courseWorkId@,courseId@", "TurnInStudentSubmissionRequest", "", "w", ""},
{"classroom.courses.courseWork.updateRubric", "classroom", "PATCH", "v1/courses/{courseId}/courseWork/{courseWorkId}/rubric", "courseId@,courseWorkId@,id,updateMask", "Rubric", "", "w", ""},
{"classroom.courses.courseWorkMaterials.addOnAttachments.create", "classroom", "POST", "v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments", "itemId@,courseId@,addOnToken,postId", "AddOnAttachment", "", "w", ""},
{"classroom.courses.courseWorkMaterials.addOnAttachments.delete", "classroom", "DELETE", "v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}", "attachmentId@,itemId@,courseId@,postId", "", "", "d", ""},
{"classroom.courses.courseWorkMaterials.addOnAttachments.get", "classroom", "GET", "v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}", "itemId@,attachmentId@,courseId@,postId", "", "", "r", ""},
{"classroom.courses.courseWorkMaterials.addOnAttachments.list", "classroom", "GET", "v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments", "itemId@,courseId@,pageSize#,pageToken,postId", "", "addOnAttachments", "r", ""},
{"classroom.courses.courseWorkMaterials.addOnAttachments.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}", "attachmentId@,courseId@,itemId@,postId,updateMask", "AddOnAttachment", "", "w", ""},
{"classroom.courses.courseWorkMaterials.create", "classroom", "POST", "v1/courses/{courseId}/courseWorkMaterials", "courseId@", "CourseWorkMaterial", "", "s", ""},
{"classroom.courses.courseWorkMaterials.delete", "classroom", "DELETE", "v1/courses/{courseId}/courseWorkMaterials/{id}", "courseId@,id@", "", "", "d", ""},
{"classroom.courses.courseWorkMaterials.get", "classroom", "GET", "v1/courses/{courseId}/courseWorkMaterials/{id}", "id@,courseId@", "", "", "r", ""},
{"classroom.courses.courseWorkMaterials.getAddOnContext", "classroom", "GET", "v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext", "itemId@,courseId@,addOnToken,attachmentId,postId", "", "", "r", ""},
{"classroom.courses.courseWorkMaterials.list", "classroom", "GET", "v1/courses/{courseId}/courseWorkMaterials", "courseId@,courseWorkMaterialStates*,materialDriveId,materialLink,orderBy,pageSize#,pageToken", "", "courseWorkMaterial", "r", ""},
{"classroom.courses.courseWorkMaterials.patch", "classroom", "PATCH", "v1/courses/{courseId}/courseWorkMaterials/{id}", "courseId@,id@,updateMask", "CourseWorkMaterial", "", "w", ""},
{"classroom.courses.create", "classroom", "POST", "v1/courses", "", "Course", "", "w", ""},
{"classroom.courses.delete", "classroom", "DELETE", "v1/courses/{id}", "id@", "", "", "d", ""},
{"classroom.courses.get", "classroom", "GET", "v1/courses/{id}", "id@", "", "", "r", ""},
{"classroom.courses.getGradingPeriodSettings", "classroom", "GET", "v1/courses/{courseId}/gradingPeriodSettings", "courseId@", "", "", "r", ""},
{"classroom.courses.list", "classroom", "GET", "v1/courses", "courseStates*,pageSize#,pageToken,studentId,teacherId", "", "courses", "r", ""},
{"classroom.courses.patch", "classroom", "PATCH", "v1/courses/{id}", "id@,updateMask", "Course", "", "w", ""},
{"classroom.courses.posts.addOnAttachments.create", "classroom", "POST", "v1/courses/{courseId}/posts/{postId}/addOnAttachments", "postId@,courseId@,addOnToken,itemId", "AddOnAttachment", "", "w", ""},
{"classroom.courses.posts.addOnAttachments.delete", "classroom", "DELETE", "v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}", "attachmentId@,courseId@,postId@,itemId", "", "", "d", ""},
{"classroom.courses.posts.addOnAttachments.get", "classroom", "GET", "v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}", "attachmentId@,postId@,courseId@,itemId", "", "", "r", ""},
{"classroom.courses.posts.addOnAttachments.list", "classroom", "GET", "v1/courses/{courseId}/posts/{postId}/addOnAttachments", "postId@,courseId@,itemId,pageSize#,pageToken", "", "addOnAttachments", "r", ""},
{"classroom.courses.posts.addOnAttachments.patch", "classroom", "PATCH", "v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}", "postId@,attachmentId@,courseId@,itemId,updateMask", "AddOnAttachment", "", "w", ""},
{"classroom.courses.posts.addOnAttachments.studentSubmissions.get", "classroom", "GET", "v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}", "postId@,courseId@,submissionId@,attachmentId@,itemId", "", "", "r", ""},
{"classroom.courses.posts.addOnAttachments.studentSubmissions.patch", "classroom", "PATCH", "v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}", "postId@,courseId@,submissionId@,attachmentId@,itemId,updateMask", "AddOnAttachmentStudentSubmission", "", "w", ""},
{"classroom.courses.posts.getAddOnContext", "classroom", "GET", "v1/courses/{courseId}/posts/{postId}/addOnContext", "courseId@,postId@,addOnToken,attachmentId,itemId", "", "", "r", ""},
{"classroom.courses.studentGroups.create", "classroom", "POST", "v1/courses/{courseId}/studentGroups", "courseId@", "StudentGroup", "", "w", ""},
{"classroom.courses.studentGroups.delete", "classroom", "DELETE", "v1/courses/{courseId}/studentGroups/{id}", "id@,courseId@", "", "", "d", ""},
{"classroom.courses.studentGroups.list", "classroom", "GET", "v1/courses/{courseId}/studentGroups", "courseId@,pageSize#,pageToken", "", "studentGroups", "r", ""},
{"classroom.courses.studentGroups.patch", "classroom", "PATCH", "v1/courses/{courseId}/studentGroups/{id}", "id@,courseId@,updateMask", "StudentGroup", "", "w", ""},
{"classroom.courses.studentGroups.studentGroupMembers.create", "classroom", "POST", "v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers", "courseId@,studentGroupId@", "StudentGroupMember", "", "w", ""},
{"classroom.courses.studentGroups.studentGroupMembers.delete", "classroom", "DELETE", "v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers/{userId}", "courseId@,studentGroupId@,userId@", "", "", "d", ""},
{"classroom.courses.studentGroups.studentGroupMembers.list", "classroom", "GET", "v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers", "studentGroupId@,courseId@,pageSize#,pageToken", "", "studentGroupMembers", "r", ""},
{"classroom.courses.students.create", "classroom", "POST", "v1/courses/{courseId}/students", "courseId@,enrollmentCode", "Student", "", "s", ""},
{"classroom.courses.students.delete", "classroom", "DELETE", "v1/courses/{courseId}/students/{userId}", "userId@,courseId@", "", "", "d", ""},
{"classroom.courses.students.get", "classroom", "GET", "v1/courses/{courseId}/students/{userId}", "courseId@,userId@", "", "", "r", ""},
{"classroom.courses.students.list", "classroom", "GET", "v1/courses/{courseId}/students", "courseId@,pageSize#,pageToken", "", "students", "r", ""},
{"classroom.courses.teachers.create", "classroom", "POST", "v1/courses/{courseId}/teachers", "courseId@", "Teacher", "", "s", ""},
{"classroom.courses.teachers.delete", "classroom", "DELETE", "v1/courses/{courseId}/teachers/{userId}", "userId@,courseId@", "", "", "d", ""},
{"classroom.courses.teachers.get", "classroom", "GET", "v1/courses/{courseId}/teachers/{userId}", "courseId@,userId@", "", "", "r", ""},
{"classroom.courses.teachers.list", "classroom", "GET", "v1/courses/{courseId}/teachers", "courseId@,pageSize#,pageToken", "", "teachers", "r", ""},
{"classroom.courses.topics.create", "classroom", "POST", "v1/courses/{courseId}/topics", "courseId@", "Topic", "", "w", ""},
{"classroom.courses.topics.delete", "classroom", "DELETE", "v1/courses/{courseId}/topics/{id}", "courseId@,id@", "", "", "d", ""},
{"classroom.courses.topics.get", "classroom", "GET", "v1/courses/{courseId}/topics/{id}", "id@,courseId@", "", "", "r", ""},
{"classroom.courses.topics.list", "classroom", "GET", "v1/courses/{courseId}/topics", "courseId@,pageSize#,pageToken", "", "topic", "r", ""},
{"classroom.courses.topics.patch", "classroom", "PATCH", "v1/courses/{courseId}/topics/{id}", "id@,courseId@,updateMask", "Topic", "", "w", ""},
{"classroom.courses.update", "classroom", "PUT", "v1/courses/{id}", "id@", "Course", "", "w", ""},
{"classroom.courses.updateGradingPeriodSettings", "classroom", "PATCH", "v1/courses/{courseId}/gradingPeriodSettings", "courseId@,updateMask", "GradingPeriodSettings", "", "w", ""},
{"classroom.invitations.accept", "classroom", "POST", "v1/invitations/{id}:accept", "id@", "", "", "w", ""},
{"classroom.invitations.create", "classroom", "POST", "v1/invitations", "", "Invitation", "", "s", ""},
{"classroom.invitations.delete", "classroom", "DELETE", "v1/invitations/{id}", "id@", "", "", "d", ""},
{"classroom.invitations.get", "classroom", "GET", "v1/invitations/{id}", "id@", "", "", "r", ""},
{"classroom.invitations.list", "classroom", "GET", "v1/invitations", "courseId,pageSize#,pageToken,userId", "", "invitations", "r", ""},
{"classroom.registrations.create", "classroom", "POST", "v1/registrations", "", "Registration", "", "w", ""},
{"classroom.registrations.delete", "classroom", "DELETE", "v1/registrations/{registrationId}", "registrationId@", "", "", "d", ""},
{"classroom.userProfiles.get", "classroom", "GET", "v1/userProfiles/{userId}", "userId@", "", "", "r", ""},
{"classroom.userProfiles.guardianInvitations.create", "classroom", "POST", "v1/userProfiles/{studentId}/guardianInvitations", "studentId@", "GuardianInvitation", "", "w", ""},
{"classroom.userProfiles.guardianInvitations.get", "classroom", "GET", "v1/userProfiles/{studentId}/guardianInvitations/{invitationId}", "studentId@,invitationId@", "", "", "r", ""},
{"classroom.userProfiles.guardianInvitations.list", "classroom", "GET", "v1/userProfiles/{studentId}/guardianInvitations", "studentId@,invitedEmailAddress,pageSize#,pageToken,states*", "", "guardianInvitations", "r", ""},
{"classroom.userProfiles.guardianInvitations.patch", "classroom", "PATCH", "v1/userProfiles/{studentId}/guardianInvitations/{invitationId}", "studentId@,invitationId@,updateMask", "GuardianInvitation", "", "w", ""},
{"classroom.userProfiles.guardians.delete", "classroom", "DELETE", "v1/userProfiles/{studentId}/guardians/{guardianId}", "guardianId@,studentId@", "", "", "d", ""},
{"classroom.userProfiles.guardians.get", "classroom", "GET", "v1/userProfiles/{studentId}/guardians/{guardianId}", "guardianId@,studentId@", "", "", "r", ""},
{"classroom.userProfiles.guardians.list", "classroom", "GET", "v1/userProfiles/{studentId}/guardians", "studentId@,invitedEmailAddress,pageSize#,pageToken", "", "guardians", "r", ""},
{"youtube.abuseReports.insert", "youtube", "POST", "youtube/v3/abuseReports", "part!*", "AbuseReport", "", "w", ""},
{"youtube.activities.list", "youtube", "GET", "youtube/v3/activities", "channelId,home?,maxResults#,mine?,pageToken,part!*,publishedAfter,publishedBefore,regionCode", "", "items", "r", ""},
{"youtube.captions.delete", "youtube", "DELETE", "youtube/v3/captions", "id!,onBehalfOf,onBehalfOfContentOwner", "", "", "d", ""},
{"youtube.captions.download", "youtube", "GET", "youtube/v3/captions/{id}", "id@,onBehalfOf,onBehalfOfContentOwner,tfmt,tlang", "", "", "r", "db"},
{"youtube.captions.insert", "youtube", "POST", "youtube/v3/captions", "onBehalfOf,onBehalfOfContentOwner,part!*,sync?", "Caption", "", "w", "u"},
{"youtube.captions.list", "youtube", "GET", "youtube/v3/captions", "id*,onBehalfOf,onBehalfOfContentOwner,part!*,videoId!", "", "", "r", ""},
{"youtube.captions.update", "youtube", "PUT", "youtube/v3/captions", "onBehalfOf,onBehalfOfContentOwner,part!*,sync?", "Caption", "", "w", "u"},
{"youtube.channelBanners.insert", "youtube", "POST", "youtube/v3/channelBanners/insert", "channelId,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel", "ChannelBannerResource", "", "w", "u"},
{"youtube.channelSections.delete", "youtube", "DELETE", "youtube/v3/channelSections", "id!,onBehalfOfContentOwner", "", "", "d", ""},
{"youtube.channelSections.insert", "youtube", "POST", "youtube/v3/channelSections", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "ChannelSection", "", "w", ""},
{"youtube.channelSections.list", "youtube", "GET", "youtube/v3/channelSections", "channelId,hl,id*,mine?,onBehalfOfContentOwner,part!*", "", "", "r", ""},
{"youtube.channelSections.update", "youtube", "PUT", "youtube/v3/channelSections", "onBehalfOfContentOwner,part!*", "ChannelSection", "", "w", ""},
{"youtube.channels.list", "youtube", "GET", "youtube/v3/channels", "categoryId,forHandle,forUsername,hl,id*,managedByMe?,maxResults#,mine?,mySubscribers?,onBehalfOfContentOwner,pageToken,part!*", "", "items", "r", ""},
{"youtube.channels.update", "youtube", "PUT", "youtube/v3/channels", "onBehalfOfContentOwner,part!*", "Channel", "", "w", ""},
{"youtube.commentThreads.insert", "youtube", "POST", "youtube/v3/commentThreads", "part!*", "CommentThread", "", "s", ""},
{"youtube.commentThreads.list", "youtube", "GET", "youtube/v3/commentThreads", "allThreadsRelatedToChannelId,channelId,id*,maxResults#,moderationStatus,order,pageToken,part!*,searchTerms,textFormat,videoId", "", "items", "r", ""},
{"youtube.comments.delete", "youtube", "DELETE", "youtube/v3/comments", "id!", "", "", "d", ""},
{"youtube.comments.insert", "youtube", "POST", "youtube/v3/comments", "part!*", "Comment", "", "s", ""},
{"youtube.comments.list", "youtube", "GET", "youtube/v3/comments", "id*,maxResults#,pageToken,parentId,part!*,textFormat", "", "items", "r", ""},
{"youtube.comments.markAsSpam", "youtube", "POST", "youtube/v3/comments/markAsSpam", "id!*", "", "", "w", ""},
{"youtube.comments.setModerationStatus", "youtube", "POST", "youtube/v3/comments/setModerationStatus", "banAuthor?,id!*,moderationStatus!", "", "", "s", ""},
{"youtube.comments.update", "youtube", "PUT", "youtube/v3/comments", "part!*", "Comment", "", "w", ""},
{"youtube.i18nLanguages.list", "youtube", "GET", "youtube/v3/i18nLanguages", "hl,part!*", "", "", "r", ""},
{"youtube.i18nRegions.list", "youtube", "GET", "youtube/v3/i18nRegions", "hl,part!*", "", "", "r", ""},
{"youtube.liveBroadcasts.bind", "youtube", "POST", "youtube/v3/liveBroadcasts/bind", "id!,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*,streamId", "", "", "w", ""},
{"youtube.liveBroadcasts.delete", "youtube", "DELETE", "youtube/v3/liveBroadcasts", "id!,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel", "", "", "d", ""},
{"youtube.liveBroadcasts.insert", "youtube", "POST", "youtube/v3/liveBroadcasts", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "LiveBroadcast", "", "w", ""},
{"youtube.liveBroadcasts.insertCuepoint", "youtube", "POST", "youtube/v3/liveBroadcasts/cuepoint", "id,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part*", "Cuepoint", "", "w", ""},
{"youtube.liveBroadcasts.list", "youtube", "GET", "youtube/v3/liveBroadcasts", "broadcastStatus,broadcastType,id*,maxResults#,mine?,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,pageToken,part!*", "", "items", "r", ""},
{"youtube.liveBroadcasts.transition", "youtube", "POST", "youtube/v3/liveBroadcasts/transition", "broadcastStatus!,id!,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "", "", "w", ""},
{"youtube.liveBroadcasts.update", "youtube", "PUT", "youtube/v3/liveBroadcasts", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "LiveBroadcast", "", "w", ""},
{"youtube.liveChatBans.delete", "youtube", "DELETE", "youtube/v3/liveChat/bans", "id!", "", "", "d", ""},
{"youtube.liveChatBans.insert", "youtube", "POST", "youtube/v3/liveChat/bans", "part!*", "LiveChatBan", "", "w", ""},
{"youtube.liveChatMessages.delete", "youtube", "DELETE", "youtube/v3/liveChat/messages", "id!", "", "", "d", ""},
{"youtube.liveChatMessages.insert", "youtube", "POST", "youtube/v3/liveChat/messages", "part!*", "LiveChatMessage", "", "w", ""},
{"youtube.liveChatMessages.list", "youtube", "GET", "youtube/v3/liveChat/messages", "hl,liveChatId!,maxResults#,pageToken,part!*,profileImageSize#", "", "items", "r", ""},
{"youtube.liveChatMessages.transition", "youtube", "POST", "youtube/v3/liveChat/messages/transition", "id,status", "", "", "w", ""},
{"youtube.liveChatModerators.delete", "youtube", "DELETE", "youtube/v3/liveChat/moderators", "id!", "", "", "d", ""},
{"youtube.liveChatModerators.insert", "youtube", "POST", "youtube/v3/liveChat/moderators", "part!*", "LiveChatModerator", "", "w", ""},
{"youtube.liveChatModerators.list", "youtube", "GET", "youtube/v3/liveChat/moderators", "liveChatId!,maxResults#,pageToken,part!*", "", "items", "r", ""},
{"youtube.liveStreams.delete", "youtube", "DELETE", "youtube/v3/liveStreams", "id!,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel", "", "", "d", ""},
{"youtube.liveStreams.insert", "youtube", "POST", "youtube/v3/liveStreams", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "LiveStream", "", "w", ""},
{"youtube.liveStreams.list", "youtube", "GET", "youtube/v3/liveStreams", "id*,maxResults#,mine?,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,pageToken,part!*", "", "items", "r", ""},
{"youtube.liveStreams.update", "youtube", "PUT", "youtube/v3/liveStreams", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "LiveStream", "", "w", ""},
{"youtube.members.list", "youtube", "GET", "youtube/v3/members", "filterByMemberChannelId,hasAccessToLevel,maxResults#,mode,pageToken,part!*", "", "items", "r", ""},
{"youtube.membershipsLevels.list", "youtube", "GET", "youtube/v3/membershipsLevels", "part!*", "", "", "r", ""},
{"youtube.playlistImages.delete", "youtube", "DELETE", "youtube/v3/playlistImages", "id,onBehalfOfContentOwner", "", "", "d", ""},
{"youtube.playlistImages.insert", "youtube", "POST", "youtube/v3/playlistImages", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part*", "PlaylistImage", "", "w", "u"},
{"youtube.playlistImages.list", "youtube", "GET", "youtube/v3/playlistImages", "maxResults#,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,pageToken,parent,part*", "", "items", "r", ""},
{"youtube.playlistImages.update", "youtube", "PUT", "youtube/v3/playlistImages", "onBehalfOfContentOwner,part*", "PlaylistImage", "", "w", "u"},
{"youtube.playlistItems.delete", "youtube", "DELETE", "youtube/v3/playlistItems", "id!,onBehalfOfContentOwner", "", "", "d", ""},
{"youtube.playlistItems.insert", "youtube", "POST", "youtube/v3/playlistItems", "onBehalfOfContentOwner,part!*", "PlaylistItem", "", "w", ""},
{"youtube.playlistItems.list", "youtube", "GET", "youtube/v3/playlistItems", "id*,maxResults#,onBehalfOfContentOwner,pageToken,part!*,playlistId,videoId", "", "items", "r", ""},
{"youtube.playlistItems.update", "youtube", "PUT", "youtube/v3/playlistItems", "onBehalfOfContentOwner,part!*", "PlaylistItem", "", "w", ""},
{"youtube.playlists.delete", "youtube", "DELETE", "youtube/v3/playlists", "id!,onBehalfOfContentOwner", "", "", "d", ""},
{"youtube.playlists.insert", "youtube", "POST", "youtube/v3/playlists", "onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*", "Playlist", "", "w", ""},
{"youtube.playlists.list", "youtube", "GET", "youtube/v3/playlists", "channelId,hl,id*,maxResults#,mine?,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,pageToken,part!*", "", "items", "r", ""},
{"youtube.playlists.update", "youtube", "PUT", "youtube/v3/playlists", "onBehalfOfContentOwner,part!*", "Playlist", "", "w", ""},
{"youtube.search.list", "youtube", "GET", "youtube/v3/search", "channelId,channelType,eventType,forContentOwner?,forDeveloper?,forMine?,location,locationRadius,maxResults#,onBehalfOfContentOwner,order,pageToken,part!*,publishedAfter,publishedBefore,q,regionCode,relevanceLanguage,safeSearch,topicId,type*,videoCaption,videoCategoryId,videoDefinition,videoDimension,videoDuration,videoEmbeddable,videoLicense,videoPaidProductPlacement,videoSyndicated,videoType", "", "items", "r", ""},
{"youtube.subscriptions.delete", "youtube", "DELETE", "youtube/v3/subscriptions", "id!", "", "", "d", ""},
{"youtube.subscriptions.insert", "youtube", "POST", "youtube/v3/subscriptions", "part!*", "Subscription", "", "w", ""},
{"youtube.subscriptions.list", "youtube", "GET", "youtube/v3/subscriptions", "channelId,forChannelId,id*,maxResults#,mine?,myRecentSubscribers?,mySubscribers?,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,order,pageToken,part!*", "", "items", "r", ""},
{"youtube.superChatEvents.list", "youtube", "GET", "youtube/v3/superChatEvents", "hl,maxResults#,pageToken,part!*", "", "items", "r", ""},
{"youtube.tests.insert", "youtube", "POST", "youtube/v3/tests", "externalChannelId,onBehalfOfContentOwnerChannel,part!*", "TestItem", "", "w", ""},
{"youtube.thirdPartyLinks.delete", "youtube", "DELETE", "youtube/v3/thirdPartyLinks", "externalChannelId,linkingToken!,part*,type!", "", "", "d", ""},
{"youtube.thirdPartyLinks.insert", "youtube", "POST", "youtube/v3/thirdPartyLinks", "externalChannelId,part!*", "ThirdPartyLink", "", "w", ""},
{"youtube.thirdPartyLinks.list", "youtube", "GET", "youtube/v3/thirdPartyLinks", "externalChannelId,linkingToken,part!*,type", "", "", "r", ""},
{"youtube.thirdPartyLinks.update", "youtube", "PUT", "youtube/v3/thirdPartyLinks", "externalChannelId,part!*", "ThirdPartyLink", "", "w", ""},
{"youtube.thumbnails.set", "youtube", "POST", "youtube/v3/thumbnails/set", "onBehalfOfContentOwner,videoId!", "", "", "w", "u"},
{"youtube.videoAbuseReportReasons.list", "youtube", "GET", "youtube/v3/videoAbuseReportReasons", "hl,part!*", "", "", "r", ""},
{"youtube.videoCategories.list", "youtube", "GET", "youtube/v3/videoCategories", "hl,id*,part!*,regionCode", "", "", "r", ""},
{"youtube.videoTrainability.get", "youtube", "GET", "youtube/v3/videoTrainability", "id", "", "", "r", ""},
{"youtube.videos.batchGetStats", "youtube", "GET", "youtube/v3/videos:batchGetStats", "id*,onBehalfOfContentOwner,part*", "", "", "r", ""},
{"youtube.videos.delete", "youtube", "DELETE", "youtube/v3/videos", "id!,onBehalfOfContentOwner", "", "", "d", ""},
{"youtube.videos.getRating", "youtube", "GET", "youtube/v3/videos/getRating", "id!*,onBehalfOfContentOwner", "", "", "r", ""},
{"youtube.videos.insert", "youtube", "POST", "youtube/v3/videos", "autoLevels?,notifySubscribers?,onBehalfOfContentOwner,onBehalfOfContentOwnerChannel,part!*,stabilize?", "Video", "", "w", "u"},
{"youtube.videos.list", "youtube", "GET", "youtube/v3/videos", "chart,hl,id*,locale,maxHeight#,maxResults#,maxWidth#,myRating,onBehalfOfContentOwner,pageToken,part!*,regionCode,videoCategoryId", "", "items", "r", ""},
{"youtube.videos.rate", "youtube", "POST", "youtube/v3/videos/rate", "id!,rating!", "", "", "w", ""},
{"youtube.videos.reportAbuse", "youtube", "POST", "youtube/v3/videos/reportAbuse", "onBehalfOfContentOwner", "VideoAbuseReport", "", "w", ""},
{"youtube.videos.update", "youtube", "PUT", "youtube/v3/videos", "onBehalfOfContentOwner,part!*", "Video", "", "w", ""},
{"youtube.watermarks.set", "youtube", "POST", "youtube/v3/watermarks/set", "channelId!,onBehalfOfContentOwner", "InvideoBranding", "", "w", "u"},
{"youtube.watermarks.unset", "youtube", "POST", "youtube/v3/watermarks/unset", "channelId!,onBehalfOfContentOwner", "", "", "w", ""},
{"youtube.youtube.v3.liveChat.messages.stream", "youtube", "GET", "youtube/v3/liveChat/messages/stream", "hl,liveChatId,maxResults#,pageToken,part*,profileImageSize#", "", "items", "r", ""},
{"youtubeAnalytics.groupItems.delete", "youtubeanalytics", "DELETE", "v2/groupItems", "id,onBehalfOfContentOwner", "", "", "d", ""},
{"youtubeAnalytics.groupItems.insert", "youtubeanalytics", "POST", "v2/groupItems", "onBehalfOfContentOwner", "GroupItem", "", "w", ""},
{"youtubeAnalytics.groupItems.list", "youtubeanalytics", "GET", "v2/groupItems", "groupId,onBehalfOfContentOwner", "", "", "r", ""},
{"youtubeAnalytics.groups.delete", "youtubeanalytics", "DELETE", "v2/groups", "id,onBehalfOfContentOwner", "", "", "d", ""},
{"youtubeAnalytics.groups.insert", "youtubeanalytics", "POST", "v2/groups", "onBehalfOfContentOwner", "Group", "", "w", ""},
{"youtubeAnalytics.groups.list", "youtubeanalytics", "GET", "v2/groups", "id,mine?,onBehalfOfContentOwner,pageToken", "", "items", "r", ""},
{"youtubeAnalytics.groups.update", "youtubeanalytics", "PUT", "v2/groups", "onBehalfOfContentOwner", "Group", "", "w", ""},
{"youtubeAnalytics.reports.query", "youtubeanalytics", "GET", "v2/reports", "currency,dimensions,endDate,filters,ids,includeHistoricalChannelData?,maxResults#,metrics,sort,startDate,startIndex#", "", "", "r", ""},
{"youtubereporting.jobs.create", "youtubereporting", "POST", "v1/jobs", "onBehalfOfContentOwner", "Job", "", "w", ""},
{"youtubereporting.jobs.delete", "youtubereporting", "DELETE", "v1/jobs/{jobId}", "jobId@,onBehalfOfContentOwner", "", "", "d", ""},
{"youtubereporting.jobs.get", "youtubereporting", "GET", "v1/jobs/{jobId}", "jobId@,onBehalfOfContentOwner", "", "", "r", ""},
{"youtubereporting.jobs.list", "youtubereporting", "GET", "v1/jobs", "includeSystemManaged?,onBehalfOfContentOwner,pageSize#,pageToken", "", "jobs", "r", ""},
{"youtubereporting.jobs.reports.get", "youtubereporting", "GET", "v1/jobs/{jobId}/reports/{reportId}", "jobId@,reportId@,onBehalfOfContentOwner", "", "", "r", ""},
{"youtubereporting.jobs.reports.list", "youtubereporting", "GET", "v1/jobs/{jobId}/reports", "jobId@,createdAfter,onBehalfOfContentOwner,pageSize#,pageToken,startTimeAtOrAfter,startTimeBefore", "", "reports", "r", ""},
{"youtubereporting.media.download", "youtubereporting", "GET", "v1/media/{+resourceName}", "resourceName@", "", "", "r", "d"},
{"youtubereporting.reportTypes.list", "youtubereporting", "GET", "v1/reportTypes", "includeSystemManaged?,onBehalfOfContentOwner,pageSize#,pageToken", "", "reportTypes", "r", ""},
{"admin.channels.stop", "directory", "POST", "admin/directory_v1/channels/stop", "", "Channel", "", "w", ""},
{"admin.customer.devices.chromeos.batchChangeStatus", "directory", "POST", "admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus", "customerId@", "BatchChangeChromeOsDeviceStatusRequest", "", "w", ""},
{"admin.customer.devices.chromeos.commands.get", "directory", "GET", "admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}", "customerId@,commandId@,deviceId@", "", "", "r", ""},
{"admin.customer.devices.chromeos.countChromeOsDevices", "directory", "GET", "admin/directory/v1/customer/{customerId}/devices/chromeos:countChromeOsDevices", "customerId@,filter,includeChildOrgunits?,orgUnitPath", "", "", "r", ""},
{"admin.customer.devices.chromeos.issueCommand", "directory", "POST", "admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand", "customerId@,deviceId@", "DirectoryChromeosdevicesIssueCommandRequest", "", "w", ""},
{"admin.customers.chrome.printServers.batchCreatePrintServers", "directory", "POST", "admin/directory/v1/{+parent}/chrome/printServers:batchCreatePrintServers", "parent@", "BatchCreatePrintServersRequest", "", "w", ""},
{"admin.customers.chrome.printServers.batchDeletePrintServers", "directory", "POST", "admin/directory/v1/{+parent}/chrome/printServers:batchDeletePrintServers", "parent@", "BatchDeletePrintServersRequest", "", "d", ""},
{"admin.customers.chrome.printServers.create", "directory", "POST", "admin/directory/v1/{+parent}/chrome/printServers", "parent@", "PrintServer", "", "w", ""},
{"admin.customers.chrome.printServers.delete", "directory", "DELETE", "admin/directory/v1/{+name}", "name@", "", "", "d", ""},
{"admin.customers.chrome.printServers.get", "directory", "GET", "admin/directory/v1/{+name}", "name@", "", "", "r", ""},
{"admin.customers.chrome.printServers.list", "directory", "GET", "admin/directory/v1/{+parent}/chrome/printServers", "parent@,filter,orderBy,orgUnitId,pageSize#,pageToken", "", "printServers", "r", ""},
{"admin.customers.chrome.printServers.patch", "directory", "PATCH", "admin/directory/v1/{+name}", "name@,updateMask", "PrintServer", "", "w", ""},
{"admin.customers.chrome.printers.batchCreatePrinters", "directory", "POST", "admin/directory/v1/{+parent}/chrome/printers:batchCreatePrinters", "parent@", "BatchCreatePrintersRequest", "", "w", ""},
{"admin.customers.chrome.printers.batchDeletePrinters", "directory", "POST", "admin/directory/v1/{+parent}/chrome/printers:batchDeletePrinters", "parent@", "BatchDeletePrintersRequest", "", "d", ""},
{"admin.customers.chrome.printers.create", "directory", "POST", "admin/directory/v1/{+parent}/chrome/printers", "parent@", "Printer", "", "w", ""},
{"admin.customers.chrome.printers.delete", "directory", "DELETE", "admin/directory/v1/{+name}", "name@", "", "", "d", ""},
{"admin.customers.chrome.printers.get", "directory", "GET", "admin/directory/v1/{+name}", "name@", "", "", "r", ""},
{"admin.customers.chrome.printers.list", "directory", "GET", "admin/directory/v1/{+parent}/chrome/printers", "parent@,filter,orderBy,orgUnitId,pageSize#,pageToken", "", "printers", "r", ""},
{"admin.customers.chrome.printers.listPrinterModels", "directory", "GET", "admin/directory/v1/{+parent}/chrome/printers:listPrinterModels", "parent@,filter,pageSize#,pageToken", "", "printerModels", "r", ""},
{"admin.customers.chrome.printers.patch", "directory", "PATCH", "admin/directory/v1/{+name}", "name@,clearMask,updateMask", "Printer", "", "w", ""},
{"directory.asps.delete", "directory", "DELETE", "admin/directory/v1/users/{userKey}/asps/{codeId}", "userKey@,codeId@#", "", "", "d", ""},
{"directory.asps.get", "directory", "GET", "admin/directory/v1/users/{userKey}/asps/{codeId}", "userKey@,codeId@#", "", "", "r", ""},
{"directory.asps.list", "directory", "GET", "admin/directory/v1/users/{userKey}/asps", "userKey@", "", "", "r", ""},
{"directory.chromeosdevices.action", "directory", "POST", "admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action", "resourceId@,customerId@", "ChromeOsDeviceAction", "", "d", ""},
{"directory.chromeosdevices.get", "directory", "GET", "admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}", "deviceId@,customerId@,projection", "", "", "r", ""},
{"directory.chromeosdevices.list", "directory", "GET", "admin/directory/v1/customer/{customerId}/devices/chromeos", "customerId@,includeChildOrgunits?,maxResults#,orderBy,orgUnitPath,pageToken,projection,query,sortOrder", "", "chromeosdevices", "r", ""},
{"directory.chromeosdevices.moveDevicesToOu", "directory", "POST", "admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu", "customerId@,orgUnitPath!", "ChromeOsMoveDevicesToOu", "", "w", ""},
{"directory.chromeosdevices.patch", "directory", "PATCH", "admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}", "customerId@,deviceId@,projection", "ChromeOsDevice", "", "w", ""},
{"directory.chromeosdevices.update", "directory", "PUT", "admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}", "deviceId@,customerId@,projection", "ChromeOsDevice", "", "w", ""},
{"directory.customers.get", "directory", "GET", "admin/directory/v1/customers/{customerKey}", "customerKey@", "", "", "r", ""},
{"directory.customers.patch", "directory", "PATCH", "admin/directory/v1/customers/{customerKey}", "customerKey@", "Customer", "", "w", ""},
{"directory.customers.update", "directory", "PUT", "admin/directory/v1/customers/{customerKey}", "customerKey@", "Customer", "", "w", ""},
{"directory.domainAliases.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}", "customer@,domainAliasName@", "", "", "d", ""},
{"directory.domainAliases.get", "directory", "GET", "admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}", "domainAliasName@,customer@", "", "", "r", ""},
{"directory.domainAliases.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/domainaliases", "customer@", "DomainAlias", "", "w", ""},
{"directory.domainAliases.list", "directory", "GET", "admin/directory/v1/customer/{customer}/domainaliases", "customer@,parentDomainName", "", "", "r", ""},
{"directory.domains.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/domains/{domainName}", "domainName@,customer@", "", "", "d", ""},
{"directory.domains.get", "directory", "GET", "admin/directory/v1/customer/{customer}/domains/{domainName}", "domainName@,customer@", "", "", "r", ""},
{"directory.domains.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/domains", "customer@", "Domains", "", "w", ""},
{"directory.domains.list", "directory", "GET", "admin/directory/v1/customer/{customer}/domains", "customer@", "", "", "r", ""},
{"directory.groups.aliases.delete", "directory", "DELETE", "admin/directory/v1/groups/{groupKey}/aliases/{alias}", "groupKey@,alias@", "", "", "d", ""},
{"directory.groups.aliases.insert", "directory", "POST", "admin/directory/v1/groups/{groupKey}/aliases", "groupKey@", "Alias", "", "w", ""},
{"directory.groups.aliases.list", "directory", "GET", "admin/directory/v1/groups/{groupKey}/aliases", "groupKey@", "", "", "r", ""},
{"directory.groups.delete", "directory", "DELETE", "admin/directory/v1/groups/{groupKey}", "groupKey@", "", "", "d", ""},
{"directory.groups.get", "directory", "GET", "admin/directory/v1/groups/{groupKey}", "groupKey@", "", "", "r", ""},
{"directory.groups.insert", "directory", "POST", "admin/directory/v1/groups", "", "Group", "", "w", ""},
{"directory.groups.list", "directory", "GET", "admin/directory/v1/groups", "customer,domain,maxResults#,orderBy,pageToken,query,sortOrder,userKey", "", "groups", "r", ""},
{"directory.groups.patch", "directory", "PATCH", "admin/directory/v1/groups/{groupKey}", "groupKey@", "Group", "", "w", ""},
{"directory.groups.update", "directory", "PUT", "admin/directory/v1/groups/{groupKey}", "groupKey@", "Group", "", "w", ""},
{"directory.members.delete", "directory", "DELETE", "admin/directory/v1/groups/{groupKey}/members/{memberKey}", "groupKey@,memberKey@", "", "", "d", ""},
{"directory.members.get", "directory", "GET", "admin/directory/v1/groups/{groupKey}/members/{memberKey}", "groupKey@,memberKey@", "", "", "r", ""},
{"directory.members.hasMember", "directory", "GET", "admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}", "groupKey@,memberKey@", "", "", "r", ""},
{"directory.members.insert", "directory", "POST", "admin/directory/v1/groups/{groupKey}/members", "groupKey@", "Member", "", "w", ""},
{"directory.members.list", "directory", "GET", "admin/directory/v1/groups/{groupKey}/members", "groupKey@,includeDerivedMembership?,maxResults#,pageToken,roles", "", "members", "r", ""},
{"directory.members.patch", "directory", "PATCH", "admin/directory/v1/groups/{groupKey}/members/{memberKey}", "groupKey@,memberKey@", "Member", "", "w", ""},
{"directory.members.update", "directory", "PUT", "admin/directory/v1/groups/{groupKey}/members/{memberKey}", "groupKey@,memberKey@", "Member", "", "w", ""},
{"directory.mobiledevices.action", "directory", "POST", "admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action", "resourceId@,customerId@", "MobileDeviceAction", "", "d", ""},
{"directory.mobiledevices.delete", "directory", "DELETE", "admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}", "customerId@,resourceId@", "", "", "d", ""},
{"directory.mobiledevices.get", "directory", "GET", "admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}", "customerId@,resourceId@,projection", "", "", "r", ""},
{"directory.mobiledevices.list", "directory", "GET", "admin/directory/v1/customer/{customerId}/devices/mobile", "customerId@,maxResults#,orderBy,pageToken,projection,query,sortOrder", "", "mobiledevices", "r", ""},
{"directory.orgunits.delete", "directory", "DELETE", "admin/directory/v1/customer/{customerId}/orgunits/{+orgUnitPath}", "customerId@,orgUnitPath@", "", "", "d", ""},
{"directory.orgunits.get", "directory", "GET", "admin/directory/v1/customer/{customerId}/orgunits/{+orgUnitPath}", "orgUnitPath@,customerId@", "", "", "r", ""},
{"directory.orgunits.insert", "directory", "POST", "admin/directory/v1/customer/{customerId}/orgunits", "customerId@", "OrgUnit", "", "w", ""},
{"directory.orgunits.list", "directory", "GET", "admin/directory/v1/customer/{customerId}/orgunits", "customerId@,orgUnitPath,type", "", "", "r", ""},
{"directory.orgunits.patch", "directory", "PATCH", "admin/directory/v1/customer/{customerId}/orgunits/{+orgUnitPath}", "customerId@,orgUnitPath@", "OrgUnit", "", "w", ""},
{"directory.orgunits.update", "directory", "PUT", "admin/directory/v1/customer/{customerId}/orgunits/{+orgUnitPath}", "orgUnitPath@,customerId@", "OrgUnit", "", "w", ""},
{"directory.privileges.list", "directory", "GET", "admin/directory/v1/customer/{customer}/roles/ALL/privileges", "customer@", "", "", "r", ""},
{"directory.resources.buildings.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}", "buildingId@,customer@", "", "", "d", ""},
{"directory.resources.buildings.get", "directory", "GET", "admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}", "customer@,buildingId@", "", "", "r", ""},
{"directory.resources.buildings.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/resources/buildings", "customer@,coordinatesSource", "Building", "", "w", ""},
{"directory.resources.buildings.list", "directory", "GET", "admin/directory/v1/customer/{customer}/resources/buildings", "customer@,maxResults#,pageToken", "", "buildings", "r", ""},
{"directory.resources.buildings.patch", "directory", "PATCH", "admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}", "customer@,buildingId@,coordinatesSource", "Building", "", "w", ""},
{"directory.resources.buildings.update", "directory", "PUT", "admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}", "customer@,buildingId@,coordinatesSource", "Building", "", "w", ""},
{"directory.resources.calendars.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}", "calendarResourceId@,customer@", "", "", "d", ""},
{"directory.resources.calendars.get", "directory", "GET", "admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}", "calendarResourceId@,customer@", "", "", "r", ""},
{"directory.resources.calendars.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/resources/calendars", "customer@", "CalendarResource", "", "w", ""},
{"directory.resources.calendars.list", "directory", "GET", "admin/directory/v1/customer/{customer}/resources/calendars", "customer@,maxResults#,orderBy,pageToken,query", "", "items", "r", ""},
{"directory.resources.calendars.patch", "directory", "PATCH", "admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}", "calendarResourceId@,customer@", "CalendarResource", "", "w", ""},
{"directory.resources.calendars.update", "directory", "PUT", "admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}", "customer@,calendarResourceId@", "CalendarResource", "", "w", ""},
{"directory.resources.features.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/resources/features/{featureKey}", "customer@,featureKey@", "", "", "d", ""},
{"directory.resources.features.get", "directory", "GET", "admin/directory/v1/customer/{customer}/resources/features/{featureKey}", "featureKey@,customer@", "", "", "r", ""},
{"directory.resources.features.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/resources/features", "customer@", "Feature", "", "w", ""},
{"directory.resources.features.list", "directory", "GET", "admin/directory/v1/customer/{customer}/resources/features", "customer@,maxResults#,pageToken", "", "features", "r", ""},
{"directory.resources.features.patch", "directory", "PATCH", "admin/directory/v1/customer/{customer}/resources/features/{featureKey}", "customer@,featureKey@", "Feature", "", "w", ""},
{"directory.resources.features.rename", "directory", "POST", "admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename", "customer@,oldName@", "FeatureRename", "", "w", ""},
{"directory.resources.features.update", "directory", "PUT", "admin/directory/v1/customer/{customer}/resources/features/{featureKey}", "customer@,featureKey@", "Feature", "", "w", ""},
{"directory.roleAssignments.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}", "customer@,roleAssignmentId@", "", "", "d", ""},
{"directory.roleAssignments.get", "directory", "GET", "admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}", "roleAssignmentId@,customer@", "", "", "r", ""},
{"directory.roleAssignments.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/roleassignments", "customer@", "RoleAssignment", "", "w", ""},
{"directory.roleAssignments.list", "directory", "GET", "admin/directory/v1/customer/{customer}/roleassignments", "customer@,includeIndirectRoleAssignments?,maxResults#,pageToken,roleId,userKey", "", "items", "r", ""},
{"directory.roles.delete", "directory", "DELETE", "admin/directory/v1/customer/{customer}/roles/{roleId}", "customer@,roleId@", "", "", "d", ""},
{"directory.roles.get", "directory", "GET", "admin/directory/v1/customer/{customer}/roles/{roleId}", "customer@,roleId@", "", "", "r", ""},
{"directory.roles.insert", "directory", "POST", "admin/directory/v1/customer/{customer}/roles", "customer@", "Role", "", "w", ""},
{"directory.roles.list", "directory", "GET", "admin/directory/v1/customer/{customer}/roles", "customer@,maxResults#,pageToken", "", "items", "r", ""},
{"directory.roles.patch", "directory", "PATCH", "admin/directory/v1/customer/{customer}/roles/{roleId}", "roleId@,customer@", "Role", "", "w", ""},
{"directory.roles.update", "directory", "PUT", "admin/directory/v1/customer/{customer}/roles/{roleId}", "customer@,roleId@", "Role", "", "w", ""},
{"directory.schemas.delete", "directory", "DELETE", "admin/directory/v1/customer/{customerId}/schemas/{schemaKey}", "customerId@,schemaKey@", "", "", "d", ""},
{"directory.schemas.get", "directory", "GET", "admin/directory/v1/customer/{customerId}/schemas/{schemaKey}", "customerId@,schemaKey@", "", "", "r", ""},
{"directory.schemas.insert", "directory", "POST", "admin/directory/v1/customer/{customerId}/schemas", "customerId@", "Schema", "", "w", ""},
{"directory.schemas.list", "directory", "GET", "admin/directory/v1/customer/{customerId}/schemas", "customerId@", "", "", "r", ""},
{"directory.schemas.patch", "directory", "PATCH", "admin/directory/v1/customer/{customerId}/schemas/{schemaKey}", "customerId@,schemaKey@", "Schema", "", "w", ""},
{"directory.schemas.update", "directory", "PUT", "admin/directory/v1/customer/{customerId}/schemas/{schemaKey}", "customerId@,schemaKey@", "Schema", "", "w", ""},
{"directory.tokens.delete", "directory", "DELETE", "admin/directory/v1/users/{userKey}/tokens/{clientId}", "clientId@,userKey@", "", "", "d", ""},
{"directory.tokens.get", "directory", "GET", "admin/directory/v1/users/{userKey}/tokens/{clientId}", "clientId@,userKey@", "", "", "r", ""},
{"directory.tokens.list", "directory", "GET", "admin/directory/v1/users/{userKey}/tokens", "userKey@", "", "", "r", ""},
{"directory.twoStepVerification.turnOff", "directory", "POST", "admin/directory/v1/users/{userKey}/twoStepVerification/turnOff", "userKey@", "", "", "w", ""},
{"directory.users.aliases.delete", "directory", "DELETE", "admin/directory/v1/users/{userKey}/aliases/{alias}", "userKey@,alias@", "", "", "d", ""},
{"directory.users.aliases.insert", "directory", "POST", "admin/directory/v1/users/{userKey}/aliases", "userKey@", "Alias", "", "w", ""},
{"directory.users.aliases.list", "directory", "GET", "admin/directory/v1/users/{userKey}/aliases", "userKey@,event", "", "", "r", ""},
{"directory.users.aliases.watch", "directory", "POST", "admin/directory/v1/users/{userKey}/aliases/watch", "userKey@,event", "Channel", "", "w", ""},
{"directory.users.createGuest", "directory", "POST", "admin/directory/v1/users:createGuest", "", "DirectoryUsersCreateGuestRequest", "", "w", ""},
{"directory.users.delete", "directory", "DELETE", "admin/directory/v1/users/{userKey}", "userKey@", "", "", "d", ""},
{"directory.users.get", "directory", "GET", "admin/directory/v1/users/{userKey}", "userKey@,customFieldMask,projection,viewType", "", "", "r", ""},
{"directory.users.insert", "directory", "POST", "admin/directory/v1/users", "resolveConflictAccount?", "User", "", "w", ""},
{"directory.users.list", "directory", "GET", "admin/directory/v1/users", "customFieldMask,customer,domain,event,maxResults#,orderBy,pageToken,projection,query,showDeleted,sortOrder,viewType", "", "users", "r", ""},
{"directory.users.makeAdmin", "directory", "POST", "admin/directory/v1/users/{userKey}/makeAdmin", "userKey@", "UserMakeAdmin", "", "d", ""},
{"directory.users.patch", "directory", "PATCH", "admin/directory/v1/users/{userKey}", "userKey@", "User", "", "w", ""},
{"directory.users.photos.delete", "directory", "DELETE", "admin/directory/v1/users/{userKey}/photos/thumbnail", "userKey@", "", "", "d", ""},
{"directory.users.photos.get", "directory", "GET", "admin/directory/v1/users/{userKey}/photos/thumbnail", "userKey@", "", "", "r", ""},
{"directory.users.photos.patch", "directory", "PATCH", "admin/directory/v1/users/{userKey}/photos/thumbnail", "userKey@", "UserPhoto", "", "w", ""},
{"directory.users.photos.update", "directory", "PUT", "admin/directory/v1/users/{userKey}/photos/thumbnail", "userKey@", "UserPhoto", "", "w", ""},
{"directory.users.signOut", "directory", "POST", "admin/directory/v1/users/{userKey}/signOut", "userKey@", "", "", "d", ""},
{"directory.users.undelete", "directory", "POST", "admin/directory/v1/users/{userKey}/undelete", "userKey@", "UserUndelete", "", "w", ""},
{"directory.users.update", "directory", "PUT", "admin/directory/v1/users/{userKey}", "userKey@", "User", "", "w", ""},
{"directory.users.watch", "directory", "POST", "admin/directory/v1/users/watch", "customFieldMask,customer,domain,event,maxResults#,orderBy,pageToken,projection,query,showDeleted,sortOrder,viewType", "Channel", "", "w", ""},
{"directory.verificationCodes.generate", "directory", "POST", "admin/directory/v1/users/{userKey}/verificationCodes/generate", "userKey@", "", "", "w", ""},
{"directory.verificationCodes.invalidate", "directory", "POST", "admin/directory/v1/users/{userKey}/verificationCodes/invalidate", "userKey@", "", "", "w", ""},
{"directory.verificationCodes.list", "directory", "GET", "admin/directory/v1/users/{userKey}/verificationCodes", "userKey@", "", "", "r", ""},
{"admin.channels.stop", "reports", "POST", "admin/reports_v1/channels/stop", "", "Channel", "", "w", ""},
{"reports.activities.list", "reports", "GET", "admin/reports/v1/activity/users/{userKey}/applications/{applicationName}", "userKey@,applicationName@,actorIpAddress,agentInfoFilter,applicationInfoFilter,customerId,deviceFilter,endTime,eventName,filters,groupIdFilter,includeSensitiveData?,maxResults#,networkInfoFilter,orgUnitID,pageToken,resourceDetailsFilter,startTime,statusFilter", "", "items", "r", ""},
{"reports.activities.watch", "reports", "POST", "admin/reports/v1/activity/users/{userKey}/applications/{applicationName}/watch", "userKey@,applicationName@,actorIpAddress,customerId,endTime,eventName,filters,groupIdFilter,maxResults#,orgUnitID,pageToken,startTime", "Channel", "", "w", ""},
{"reports.customerUsageReports.get", "reports", "GET", "admin/reports/v1/usage/dates/{date}", "date@,customerId,pageToken,parameters", "", "", "r", ""},
{"reports.entityUsageReports.get", "reports", "GET", "admin/reports/v1/usage/{entityType}/{entityKey}/dates/{date}", "entityType@,date@,entityKey@,customerId,filters,maxResults#,pageToken,parameters", "", "", "r", ""},
{"reports.userUsageReport.get", "reports", "GET", "admin/reports/v1/usage/users/{userKey}/dates/{date}", "date@,userKey@,customerId,filters,groupIdFilter,maxResults#,orgUnitID,pageToken,parameters", "", "", "r", ""},
{"groupsSettings.groups.get", "groupssettings", "GET", "{groupUniqueId}", "groupUniqueId@", "", "", "r", ""},
{"groupsSettings.groups.patch", "groupssettings", "PATCH", "{groupUniqueId}", "groupUniqueId@", "Groups", "", "w", ""},
{"groupsSettings.groups.update", "groupssettings", "PUT", "{groupUniqueId}", "groupUniqueId@", "Groups", "", "w", ""},
{"vault.matters.addPermissions", "vault", "POST", "v1/matters/{matterId}:addPermissions", "matterId@", "AddMatterPermissionsRequest", "", "w", ""},
{"vault.matters.close", "vault", "POST", "v1/matters/{matterId}:close", "matterId@", "CloseMatterRequest", "", "d", ""},
{"vault.matters.count", "vault", "POST", "v1/matters/{matterId}:count", "matterId@", "CountArtifactsRequest", "", "w", ""},
{"vault.matters.create", "vault", "POST", "v1/matters", "", "Matter", "", "w", ""},
{"vault.matters.delete", "vault", "DELETE", "v1/matters/{matterId}", "matterId@", "", "", "d", ""},
{"vault.matters.exports.create", "vault", "POST", "v1/matters/{matterId}/exports", "matterId@", "Export", "", "w", ""},
{"vault.matters.exports.delete", "vault", "DELETE", "v1/matters/{matterId}/exports/{exportId}", "matterId@,exportId@", "", "", "d", ""},
{"vault.matters.exports.get", "vault", "GET", "v1/matters/{matterId}/exports/{exportId}", "exportId@,matterId@", "", "", "r", ""},
{"vault.matters.exports.list", "vault", "GET", "v1/matters/{matterId}/exports", "matterId@,pageSize#,pageToken", "", "exports", "r", ""},
{"vault.matters.get", "vault", "GET", "v1/matters/{matterId}", "matterId@,view", "", "", "r", ""},
{"vault.matters.holds.accounts.create", "vault", "POST", "v1/matters/{matterId}/holds/{holdId}/accounts", "matterId@,holdId@", "HeldAccount", "", "w", ""},
{"vault.matters.holds.accounts.delete", "vault", "DELETE", "v1/matters/{matterId}/holds/{holdId}/accounts/{accountId}", "holdId@,accountId@,matterId@", "", "", "d", ""},
{"vault.matters.holds.accounts.list", "vault", "GET", "v1/matters/{matterId}/holds/{holdId}/accounts", "holdId@,matterId@", "", "", "r", ""},
{"vault.matters.holds.addHeldAccounts", "vault", "POST", "v1/matters/{matterId}/holds/{holdId}:addHeldAccounts", "matterId@,holdId@", "AddHeldAccountsRequest", "", "w", ""},
{"vault.matters.holds.create", "vault", "POST", "v1/matters/{matterId}/holds", "matterId@", "Hold", "", "w", ""},
{"vault.matters.holds.delete", "vault", "DELETE", "v1/matters/{matterId}/holds/{holdId}", "matterId@,holdId@", "", "", "d", ""},
{"vault.matters.holds.get", "vault", "GET", "v1/matters/{matterId}/holds/{holdId}", "matterId@,holdId@,view", "", "", "r", ""},
{"vault.matters.holds.list", "vault", "GET", "v1/matters/{matterId}/holds", "matterId@,pageSize#,pageToken,view", "", "holds", "r", ""},
{"vault.matters.holds.removeHeldAccounts", "vault", "POST", "v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts", "matterId@,holdId@", "RemoveHeldAccountsRequest", "", "d", ""},
{"vault.matters.holds.update", "vault", "PUT", "v1/matters/{matterId}/holds/{holdId}", "holdId@,matterId@", "Hold", "", "w", ""},
{"vault.matters.list", "vault", "GET", "v1/matters", "pageSize#,pageToken,state,view", "", "matters", "r", ""},
{"vault.matters.removePermissions", "vault", "POST", "v1/matters/{matterId}:removePermissions", "matterId@", "RemoveMatterPermissionsRequest", "", "d", ""},
{"vault.matters.reopen", "vault", "POST", "v1/matters/{matterId}:reopen", "matterId@", "ReopenMatterRequest", "", "w", ""},
{"vault.matters.savedQueries.create", "vault", "POST", "v1/matters/{matterId}/savedQueries", "matterId@", "SavedQuery", "", "w", ""},
{"vault.matters.savedQueries.delete", "vault", "DELETE", "v1/matters/{matterId}/savedQueries/{savedQueryId}", "matterId@,savedQueryId@", "", "", "d", ""},
{"vault.matters.savedQueries.get", "vault", "GET", "v1/matters/{matterId}/savedQueries/{savedQueryId}", "savedQueryId@,matterId@", "", "", "r", ""},
{"vault.matters.savedQueries.list", "vault", "GET", "v1/matters/{matterId}/savedQueries", "matterId@,pageSize#,pageToken", "", "savedQueries", "r", ""},
{"vault.matters.undelete", "vault", "POST", "v1/matters/{matterId}:undelete", "matterId@", "UndeleteMatterRequest", "", "w", ""},
{"vault.matters.update", "vault", "PUT", "v1/matters/{matterId}", "matterId@", "Matter", "", "w", ""},
{"vault.operations.cancel", "vault", "POST", "v1/{+name}:cancel", "name@", "CancelOperationRequest", "", "w", ""},
{"vault.operations.delete", "vault", "DELETE", "v1/{+name}", "name@", "", "", "d", ""},
{"vault.operations.get", "vault", "GET", "v1/{+name}", "name@", "", "", "r", ""},
{"vault.operations.list", "vault", "GET", "v1/{+name}", "name@,filter,pageSize#,pageToken,returnPartialSuccess?", "", "", "r", ""},
};
// CALLS-END
const std::size_t kCallTableSize = sizeof(kCallTable) / sizeof(kCallTable[0]);
// SCHEMAS-BEGIN (top-level fields of every request body schema)
const SchemaSpec kSchemaTable[] = {
{"calendar", "AclRule", "etag,id,kind,role,scope"},
{"calendar", "Calendar", "autoAcceptInvitations,conferenceProperties,dataOwner,description,etag,id,kind,labelProperties,location,summary,timeZone"},
{"calendar", "CalendarListEntry", "accessRole,autoAcceptInvitations,backgroundColor,colorId,conferenceProperties,dataOwner,defaultReminders,deleted,description,etag,foregroundColor,hidden,id,kind,location,notificationSettings,primary,selected,summary,summaryOverride,timeZone"},
{"calendar", "Channel", "address,expiration,id,kind,params,payload,resourceId,resourceUri,token,type"},
{"calendar", "Event", "anyoneCanAddSelf,attachments,attendees,attendeesOmitted,birthdayProperties,colorId,conferenceData,created,creator,description,end,endTimeUnspecified,etag,eventLabelId,eventType,extendedProperties,focusTimeProperties,gadget,guestsCanInviteOthers,guestsCanModify,guestsCanSeeOtherGuests,hangoutLink,htmlLink,iCalUID,id,kind,location,locked,organizer,originalStartTime,outOfOfficeProperties,privateCopy,recurrence,recurringEventId,reminders,sequence,source,start,status,summary,transparency,updated,visibility,workingLocationProperties"},
{"calendar", "FreeBusyRequest", "calendarExpansionMax,groupExpansionMax,items,timeMax,timeMin,timeZone"},
{"chat", "Availability", "customStatus,doNotDisturbMetadata,name,state"},
{"chat", "CompleteImportSpaceRequest", ""},
{"chat", "CustomEmoji", "emojiName,name,payload,temporaryImageUri,uid"},
{"chat", "GoogleChatV1Section", "displayName,name,sortOrder,type"},
{"chat", "MarkAsActiveRequest", "expireTime,ttl"},
{"chat", "MarkAsAwayRequest", ""},
{"chat", "MarkAsDoNotDisturbRequest", "expireTime,ttl"},
{"chat", "Membership", "affiliation,createTime,deleteTime,groupMember,member,name,role,state"},
{"chat", "Message", "accessoryWidgets,actionResponse,annotations,argumentText,attachedGifs,attachment,cards,cardsV2,clientAssignedMessageId,createTime,deleteTime,deletionMetadata,emojiReactionSummaries,fallbackText,formattedText,lastUpdateTime,markupSyntax,matchedUrl,name,privateMessageViewer,quotedMessageMetadata,sender,silent,slashCommand,space,text,thread,threadReply"},
{"chat", "MessagePin", "message,name"},
{"chat", "MoveSectionItemRequest", "targetSection"},
{"chat", "PositionSectionRequest", "relativePosition,sortOrder"},
{"chat", "Reaction", "emoji,name,user"},
{"chat", "ReplaceMessageCardsRequest", "cardsV2"},
{"chat", "SearchMessagesRequest", "filter,markupSyntax,orderBy,pageSize,pageToken,view"},
{"chat", "SetUpSpaceRequest", "memberships,requestId,space"},
{"chat", "Space", "accessSettings,adminInstalled,createTime,customer,displayName,externalUserAllowed,importMode,importModeExpireTime,lastActiveTime,membershipCount,name,permissionSettings,predefinedPermissionSettings,singleUserBotDm,spaceDetails,spaceHistoryState,spaceThreadingState,spaceType,spaceUri,threaded,type"},
{"chat", "SpaceNotificationSetting", "muteSetting,name,notificationSetting"},
{"chat", "SpaceReadState", "lastReadTime,name"},
{"chat", "UploadAttachmentRequest", "filename"},
{"classroom", "AddOnAttachment", "copyHistory,courseId,dueDate,dueTime,id,itemId,maxPoints,postId,studentViewUri,studentWorkReviewUri,teacherViewUri,title"},
{"classroom", "AddOnAttachmentStudentSubmission", "courseWorkSubmissionId,id,pointsEarned,postSubmissionState,userId"},
{"classroom", "Announcement", "alternateLink,assigneeMode,courseId,creationTime,creatorUserId,id,individualStudentsOptions,materials,scheduledTime,state,text,updateTime"},
{"classroom", "Course", "alternateLink,calendarId,courseGroupEmail,courseMaterialSets,courseState,creationTime,description,descriptionHeading,enrollmentCode,gradebookSettings,guardiansEnabled,id,levels,name,ownerId,room,section,subject,teacherFolder,teacherGroupEmail,updateTime"},
{"classroom", "CourseAlias", "alias"},
{"classroom", "CourseWork", "alternateLink,assigneeMode,assignment,associatedWithDeveloper,courseId,creationTime,creatorUserId,description,dueDate,dueTime,gradeCategory,gradingPeriodId,id,individualStudentsOptions,materials,maxPoints,multipleChoiceQuestion,scheduledTime,state,submissionModificationMode,title,topicId,updateTime,workType"},
{"classroom", "CourseWorkMaterial", "alternateLink,assigneeMode,courseId,creationTime,creatorUserId,description,id,individualStudentsOptions,materials,scheduledTime,state,title,topicId,updateTime"},
{"classroom", "GradingPeriodSettings", "applyToExistingCoursework,gradingPeriods"},
{"classroom", "GuardianInvitation", "creationTime,invitationId,invitedEmailAddress,state,studentId"},
{"classroom", "Invitation", "courseId,id,role,userId"},
{"classroom", "ModifyAnnouncementAssigneesRequest", "assigneeMode,modifyIndividualStudentsOptions"},
{"classroom", "ModifyAttachmentsRequest", "addAttachments"},
{"classroom", "ModifyCourseWorkAssigneesRequest", "assigneeMode,modifyIndividualStudentsOptions"},
{"classroom", "ReclaimStudentSubmissionRequest", ""},
{"classroom", "Registration", "cloudPubsubTopic,expiryTime,feed,registrationId"},
{"classroom", "ReturnStudentSubmissionRequest", ""},
{"classroom", "Rubric", "courseId,courseWorkId,creationTime,criteria,id,sourceSpreadsheetId,updateTime"},
{"classroom", "Student", "courseId,profile,studentWorkFolder,userId"},
{"classroom", "StudentGroup", "courseId,id,title"},
{"classroom", "StudentGroupMember", "courseId,studentGroupId,userId"},
{"classroom", "StudentSubmission", "alternateLink,assignedGrade,assignedRubricGrades,assignmentSubmission,associatedWithDeveloper,courseId,courseWorkId,courseWorkType,creationTime,draftGrade,draftRubricGrades,id,late,multipleChoiceSubmission,shortAnswerSubmission,state,submissionHistory,updateTime,userId"},
{"classroom", "Teacher", "courseId,profile,userId"},
{"classroom", "Topic", "courseId,name,topicId,updateTime"},
{"classroom", "TurnInStudentSubmissionRequest", ""},
{"directory", "Alias", "alias,etag,id,kind,primaryEmail"},
{"directory", "BatchChangeChromeOsDeviceStatusRequest", "changeChromeOsDeviceStatusAction,deprovisionReason,deviceIds"},
{"directory", "BatchCreatePrintServersRequest", "requests"},
{"directory", "BatchCreatePrintersRequest", "requests"},
{"directory", "BatchDeletePrintServersRequest", "printServerIds"},
{"directory", "BatchDeletePrintersRequest", "printerIds"},
{"directory", "Building", "address,buildingId,buildingName,coordinates,description,etags,floorNames,kind"},
{"directory", "CalendarResource", "buildingId,capacity,etags,featureInstances,floorName,floorSection,generatedResourceName,kind,resourceCategory,resourceDescription,resourceEmail,resourceId,resourceName,resourceType,userVisibleDescription"},
{"directory", "Channel", "address,expiration,id,kind,params,payload,resourceId,resourceUri,token,type"},
{"directory", "ChromeOsDevice", "activeTimeRanges,annotatedAssetId,annotatedLocation,annotatedUser,autoUpdateExpiration,autoUpdateThrough,backlightInfo,bluetoothAdapterInfo,bootMode,chromeOsType,cpuInfo,cpuStatusReports,deprovisionReason,deviceFiles,deviceId,deviceLicenseType,diskSpaceUsage,diskVolumeReports,dockMacAddress,etag,ethernetMacAddress,ethernetMacAddress0,extendedSupportEligible,extendedSupportEnabled,extendedSupportStart,fanInfo,firmwareVersion,firstEnrollmentTime,kind,lastDeprovisionTimestamp,lastEnrollmentTime,lastKnownNetwork,lastSync,macAddress,manufactureDate,meid,model,notes,orderNumber,orgUnitId,orgUnitPath,osUpdateStatus,osVersion,osVersionCompliance,platformVersion,recentUsers,screenshotFiles,serialNumber,status,supportEndDate,systemRamFreeReports,systemRamTotal,tpmVersionInfo,willAutoRenew"},
{"directory", "ChromeOsDeviceAction", "action,deprovisionReason"},
{"directory", "ChromeOsMoveDevicesToOu", "deviceIds"},
{"directory", "Customer", "alternateEmail,customerCreationTime,customerDomain,etag,id,kind,language,phoneNumber,postalAddress"},
{"directory", "DirectoryChromeosdevicesIssueCommandRequest", "commandType,payload"},
{"directory", "DirectoryUsersCreateGuestRequest", "customer,primaryGuestEmail"},
{"directory", "DomainAlias", "creationTime,domainAliasName,etag,kind,parentDomainName,verified"},
{"directory", "Domains", "creationTime,domainAliases,domainName,etag,isPrimary,kind,verified"},
{"directory", "Feature", "etags,kind,name"},
{"directory", "FeatureRename", "newName"},
{"directory", "Group", "adminCreated,aliases,description,directMembersCount,email,etag,externalIds,id,kind,name,nonEditableAliases"},
{"directory", "Member", "delivery_settings,email,etag,id,kind,role,status,type"},
{"directory", "MobileDeviceAction", "action"},
{"directory", "OrgUnit", "blockInheritance,description,etag,kind,name,orgUnitId,orgUnitPath,parentOrgUnitId,parentOrgUnitPath"},
{"directory", "PrintServer", "createTime,description,displayName,id,name,orgUnitId,uri"},
{"directory", "Printer", "auxiliaryMessages,createTime,description,displayName,id,makeAndModel,name,orgUnitId,uri,useDriverlessConfig"},
{"directory", "Role", "etag,isSuperAdminRole,isSystemRole,kind,roleDescription,roleId,roleName,rolePrivileges"},
{"directory", "RoleAssignment", "assignedTo,assigneeType,condition,etag,expirationDetails,kind,orgUnitId,roleAssignmentId,roleId,scopeType"},
{"directory", "Schema", "displayName,etag,fields,kind,schemaId,schemaName"},
{"directory", "User", "addresses,agreedToTerms,aliases,archivalTime,archived,changePasswordAtNextLogin,creationTime,customSchemas,customerId,deletionTime,emails,etag,externalIds,gender,guestAccountInfo,hashFunction,id,ims,includeInGlobalAddressList,ipWhitelisted,isAdmin,isDelegatedAdmin,isEnforcedIn2Sv,isEnrolledIn2Sv,isGuestUser,isMailboxSetup,keywords,kind,languages,lastLoginTime,locations,name,nonEditableAliases,notes,orgUnitPath,organizations,password,phones,posixAccounts,primaryEmail,recoveryEmail,recoveryPhone,relations,sshPublicKeys,suspended,suspensionReason,suspensionTime,thumbnailPhotoEtag,thumbnailPhotoUrl,websites"},
{"directory", "UserMakeAdmin", "status"},
{"directory", "UserPhoto", "etag,height,id,kind,mimeType,photoData,primaryEmail,width"},
{"directory", "UserUndelete", "orgUnitPath"},
{"docs", "BatchUpdateDocumentRequest", "requests,writeControl"},
{"docs", "Document", "body,comments,commentsViewMode,documentId,documentStyle,footers,footnotes,headers,inlineObjects,lists,namedRanges,namedStyles,positionedObjects,revisionId,suggestedDocumentStyleChanges,suggestedNamedStylesChanges,suggestions,suggestionsViewMode,tabs,title"},
{"drive", "ApproveApprovalRequest", "message"},
{"drive", "CancelApprovalRequest", "message"},
{"drive", "Channel", "address,expiration,id,kind,params,payload,resourceId,resourceUri,token,type"},
{"drive", "Comment", "anchor,assigneeEmailAddress,author,content,createdTime,deleted,htmlContent,id,kind,mentionedEmailAddresses,modifiedTime,quotedFileContent,replies,resolved"},
{"drive", "CommentApprovalRequest", "message"},
{"drive", "DeclineApprovalRequest", "message"},
{"drive", "Drive", "backgroundImageFile,backgroundImageLink,capabilities,colorRgb,createdTime,hidden,id,kind,name,orgUnitId,restrictions,themeId"},
{"drive", "File", "appProperties,capabilities,clientEncryptionDetails,contentHints,contentRestrictions,copyRequiresWriterPermission,createdTime,description,downloadRestrictions,driveId,explicitlyTrashed,exportLinks,fileExtension,folderColorRgb,fullFileExtension,hasAugmentedPermissions,hasThumbnail,headRevisionId,iconLink,id,imageMediaMetadata,inheritedPermissionsDisabled,isAppAuthorized,kind,labelInfo,lastModifyingUser,linkShareMetadata,md5Checksum,mimeType,modifiedByMe,modifiedByMeTime,modifiedTime,name,originalFilename,ownedByMe,owners,parents,permissionIds,permissions,properties,quotaBytesUsed,resourceKey,sha1Checksum,sha256Checksum,shared,sharedWithMeTime,sharingUser,shortcutDetails,size,spaces,starred,teamDriveId,thumbnailLink,thumbnailVersion,trashed,trashedTime,trashingUser,version,videoMediaMetadata,viewedByMe,viewedByMeTime,viewersCanCopyContent,webContentLink,webViewLink,writersCanShare"},
{"drive", "ModifyLabelsRequest", "kind,labelModifications"},
{"drive", "Permission", "allowFileDiscovery,deleted,displayName,domain,emailAddress,expirationTime,id,inheritedPermissionsDisabled,kind,pendingOwner,permissionDetails,photoLink,role,teamDrivePermissionDetails,type,view"},
{"drive", "ReassignApprovalRequest", "addReviewers,message,replaceReviewers"},
{"drive", "Reply", "action,assigneeEmailAddress,author,content,createdTime,deleted,htmlContent,id,kind,mentionedEmailAddresses,modifiedTime"},
{"drive", "ResolveAccessProposalRequest", "action,role,sendNotification,view"},
{"drive", "Revision", "exportLinks,id,keepForever,kind,lastModifyingUser,md5Checksum,mimeType,modifiedTime,originalFilename,publishAuto,published,publishedLink,publishedOutsideDomain,size"},
{"drive", "StartApprovalRequest", "dueTime,fileContentChangeBehavior,lockFile,message,reviewerEmails"},
{"drive", "TeamDrive", "backgroundImageFile,backgroundImageLink,capabilities,colorRgb,createdTime,id,kind,name,orgUnitId,restrictions,themeId"},
{"forms", "BatchUpdateFormRequest", "includeFormInResponse,requests,writeControl"},
{"forms", "CreateWatchRequest", "watch,watchId"},
{"forms", "Form", "formId,info,items,linkedSheetId,publishSettings,responderUri,revisionId,settings"},
{"forms", "RenewWatchRequest", ""},
{"forms", "SetPublishSettingsRequest", "publishSettings,updateMask"},
{"gmail", "AutoForwarding", "disposition,emailAddress,enabled"},
{"gmail", "BatchDeleteMessagesRequest", "ids"},
{"gmail", "BatchModifyMessagesRequest", "addClassificationLabels,addLabelIds,ids,removeClassificationLabelIds,removeLabelIds"},
{"gmail", "CseIdentity", "emailAddress,primaryKeyPairId,signAndEncryptKeyPairs"},
{"gmail", "CseKeyPair", "disableTime,enablementState,keyPairId,pem,pkcs7,privateKeyMetadata,subjectEmailAddresses"},
{"gmail", "Delegate", "delegateEmail,verificationStatus"},
{"gmail", "DisableCseKeyPairRequest", ""},
{"gmail", "Draft", "id,message"},
{"gmail", "EnableCseKeyPairRequest", ""},
{"gmail", "Filter", "action,criteria,id"},
{"gmail", "ForwardingAddress", "forwardingEmail,verificationStatus"},
{"gmail", "ImapSettings", "autoExpunge,enabled,expungeBehavior,maxFolderSize"},
{"gmail", "Label", "color,id,labelListVisibility,messageListVisibility,messagesTotal,messagesUnread,name,threadsTotal,threadsUnread,type"},
{"gmail", "LanguageSettings", "displayLanguage"},
{"gmail", "Message", "classificationLabelValues,historyId,id,internalDate,labelIds,payload,raw,sizeEstimate,snippet,threadId"},
{"gmail", "ModifyMessageRequest", "addClassificationLabels,addLabelIds,removeClassificationLabelIds,removeLabelIds"},
{"gmail", "ModifyThreadRequest", "addLabelIds,removeLabelIds"},
{"gmail", "ObliterateCseKeyPairRequest", ""},
{"gmail", "PopSettings", "accessWindow,disposition"},
{"gmail", "SendAs", "displayName,isDefault,isPrimary,replyToAddress,sendAsEmail,signature,smtpMsa,treatAsAlias,verificationStatus"},
{"gmail", "SmimeInfo", "encryptedKeyPassword,expiration,id,isDefault,issuerCn,pem,pkcs12"},
{"gmail", "VacationSettings", "enableAutoReply,endTime,responseBodyHtml,responseBodyPlainText,responseSubject,restrictToContacts,restrictToDomain,startTime"},
{"gmail", "WatchRequest", "labelFilterAction,labelFilterBehavior,labelIds,topicName"},
{"groupssettings", "Groups", "allowExternalMembers,allowGoogleCommunication,allowWebPosting,archiveOnly,customFooterText,customReplyTo,customRolesEnabledForSettingsToBeMerged,defaultMessageDenyNotificationText,default_sender,description,email,enableCollaborativeInbox,favoriteRepliesOnTop,includeCustomFooter,includeInGlobalAddressList,isArchived,kind,maxMessageBytes,membersCanPostAsTheGroup,messageDisplayFont,messageModerationLevel,name,primaryLanguage,replyTo,sendMessageDenyNotification,showInGroupDirectory,spamModerationLevel,whoCanAdd,whoCanAddExternalMembers,whoCanAddReferences,whoCanApproveMembers,whoCanApproveMessages,whoCanAssignTopics,whoCanAssistContent,whoCanBanUsers,whoCanContactOwner,whoCanDeleteAnyPost,whoCanDeleteTopics,whoCanDiscoverGroup,whoCanEnterFreeFormTags,whoCanHideAbuse,whoCanInvite,whoCanJoin,whoCanLeaveGroup,whoCanLockTopics,whoCanMakeTopicsSticky,whoCanMarkDuplicate,whoCanMarkFavoriteReplyOnAnyTopic,whoCanMarkFavoriteReplyOnOwnTopic,whoCanMarkNoResponseNeeded,whoCanModerateContent,whoCanModerateMembers,whoCanModifyMembers,whoCanModifyTagsAndCategories,whoCanMoveTopicsIn,whoCanMoveTopicsOut,whoCanPostAnnouncements,whoCanPostMessage,whoCanTakeTopics,whoCanUnassignTopic,whoCanUnmarkFavoriteReplyOnAnyTopic,whoCanViewGroup,whoCanViewMembership"},
{"keep", "BatchCreatePermissionsRequest", "requests"},
{"keep", "BatchDeletePermissionsRequest", "names"},
{"keep", "Note", "attachments,body,createTime,name,permissions,title,trashTime,trashed,updateTime"},
{"meet", "BatchUpdateMembersRequest", "requests,updateMask"},
{"meet", "EndActiveConferenceRequest", ""},
{"meet", "Member", "email,name,role"},
{"meet", "Space", "activeConference,config,gatewaySipAccess,meetingCode,meetingUri,name,phoneAccess"},
{"people", "BatchCreateContactsRequest", "contacts,readMask,sources"},
{"people", "BatchDeleteContactsRequest", "resourceNames"},
{"people", "BatchUpdateContactsRequest", "contacts,readMask,sources,updateMask"},
{"people", "CopyOtherContactToMyContactsGroupRequest", "copyMask,readMask,sources"},
{"people", "CreateContactGroupRequest", "contactGroup,readGroupFields"},
{"people", "ModifyContactGroupMembersRequest", "resourceNamesToAdd,resourceNamesToRemove"},
{"people", "Person", "addresses,ageRange,ageRanges,biographies,birthdays,braggingRights,calendarUrls,clientData,coverPhotos,emailAddresses,etag,events,externalIds,fileAses,genders,imClients,interests,locales,locations,memberships,metadata,miscKeywords,names,nicknames,occupations,organizations,phoneNumbers,photos,relations,relationshipInterests,relationshipStatuses,residences,resourceName,sipAddresses,skills,taglines,urls,userDefined"},
{"people", "UpdateContactGroupRequest", "contactGroup,readGroupFields,updateGroupFields"},
{"people", "UpdateContactPhotoRequest", "personFields,photoBytes,sources"},
{"reports", "Channel", "address,expiration,id,kind,params,payload,resourceId,resourceUri,token,type"},
{"sheets", "BatchClearValuesByDataFilterRequest", "dataFilters"},
{"sheets", "BatchClearValuesRequest", "ranges"},
{"sheets", "BatchGetValuesByDataFilterRequest", "dataFilters,dateTimeRenderOption,majorDimension,valueRenderOption"},
{"sheets", "BatchUpdateSpreadsheetRequest", "commentsViewMode,includeSpreadsheetInResponse,requests,responseIncludeGridData,responseRanges"},
{"sheets", "BatchUpdateValuesByDataFilterRequest", "data,includeValuesInResponse,responseDateTimeRenderOption,responseValueRenderOption,valueInputOption"},
{"sheets", "BatchUpdateValuesRequest", "data,includeValuesInResponse,responseDateTimeRenderOption,responseValueRenderOption,valueInputOption"},
{"sheets", "ClearValuesRequest", ""},
{"sheets", "CopySheetToAnotherSpreadsheetRequest", "destinationSpreadsheetId"},
{"sheets", "GetSpreadsheetByDataFilterRequest", "commentsViewMode,dataFilters,excludeTablesInBandedRanges,includeGridData"},
{"sheets", "SearchDeveloperMetadataRequest", "dataFilters"},
{"sheets", "Spreadsheet", "comments,commentsViewMode,dataSourceSchedules,dataSources,developerMetadata,namedRanges,properties,sheets,spreadsheetId,spreadsheetUrl"},
{"sheets", "ValueRange", "majorDimension,range,values"},
{"slides", "BatchUpdatePresentationRequest", "requests,writeControl"},
{"slides", "Presentation", "comments,commentsViewMode,layouts,locale,masters,notesMaster,pageSize,presentationId,revisionId,slides,title"},
{"tasks", "Task", "assignmentInfo,completed,deleted,due,etag,hidden,id,kind,links,notes,parent,position,selfLink,status,title,updated,webViewLink"},
{"tasks", "TaskList", "etag,id,kind,selfLink,title,updated"},
{"vault", "AddHeldAccountsRequest", "accountIds,emails"},
{"vault", "AddMatterPermissionsRequest", "ccMe,matterPermission,sendEmails"},
{"vault", "CancelOperationRequest", ""},
{"vault", "CloseMatterRequest", ""},
{"vault", "CountArtifactsRequest", "query,view"},
{"vault", "Export", "cloudStorageSink,createTime,exportOptions,id,matterId,name,parentExportId,query,requester,stats,status"},
{"vault", "HeldAccount", "accountId,email,firstName,holdTime,lastName"},
{"vault", "Hold", "accounts,corpus,holdId,name,orgUnit,query,updateTime"},
{"vault", "Matter", "description,matterId,matterPermissions,matterRegion,name,state"},
{"vault", "RemoveHeldAccountsRequest", "accountIds"},
{"vault", "RemoveMatterPermissionsRequest", "accountId"},
{"vault", "ReopenMatterRequest", ""},
{"vault", "SavedQuery", "createTime,displayName,matterId,query,savedQueryId"},
{"vault", "UndeleteMatterRequest", ""},
{"youtube", "AbuseReport", "abuseTypes,description,relatedEntities,subject"},
{"youtube", "Caption", "etag,id,kind,snippet"},
{"youtube", "Channel", "auditDetails,brandingSettings,contentDetails,contentOwnerDetails,conversionPings,etag,id,kind,localizations,snippet,statistics,status,topicDetails"},
{"youtube", "ChannelBannerResource", "etag,kind,url"},
{"youtube", "ChannelSection", "contentDetails,etag,id,kind,localizations,snippet,targeting"},
{"youtube", "Comment", "etag,id,kind,snippet"},
{"youtube", "CommentThread", "etag,id,kind,replies,snippet"},
{"youtube", "Cuepoint", "cueType,durationSecs,etag,id,insertionOffsetTimeMs,walltimeMs"},
{"youtube", "InvideoBranding", "imageBytes,imageUrl,position,targetChannelId,timing"},
{"youtube", "LiveBroadcast", "contentDetails,etag,id,kind,monetizationDetails,snippet,statistics,status"},
{"youtube", "LiveChatBan", "etag,id,kind,snippet"},
{"youtube", "LiveChatMessage", "authorDetails,etag,id,kind,snippet"},
{"youtube", "LiveChatModerator", "etag,id,kind,snippet"},
{"youtube", "LiveStream", "cdn,contentDetails,etag,id,kind,snippet,status"},
{"youtube", "Playlist", "contentDetails,etag,id,kind,localizations,player,snippet,status"},
{"youtube", "PlaylistImage", "id,kind,snippet"},
{"youtube", "PlaylistItem", "contentDetails,etag,id,kind,snippet,status"},
{"youtube", "Subscription", "contentDetails,etag,id,kind,snippet,subscriberSnippet"},
{"youtube", "TestItem", "etag,featuredPart,gaia,id,snippet"},
{"youtube", "ThirdPartyLink", "etag,kind,linkingToken,snippet,status"},
{"youtube", "Video", "ageGating,brandPartner,contentDetails,etag,fileDetails,id,kind,liveStreamingDetails,localizations,monetizationDetails,paidProductPlacementDetails,player,processingDetails,projectDetails,recordingDetails,snippet,statistics,status,suggestions,topicDetails"},
{"youtube", "VideoAbuseReport", "comments,language,reasonId,secondaryReasonId,videoId"},
{"youtubeanalytics", "Group", "contentDetails,errors,etag,id,kind,snippet"},
{"youtubeanalytics", "GroupItem", "errors,etag,groupId,id,kind,resource"},
{"youtubereporting", "Job", "createTime,expireTime,id,name,reportTypeId,systemManaged"},
};
// SCHEMAS-END
const std::size_t kSchemaTableSize = sizeof(kSchemaTable) / sizeof(kSchemaTable[0]);
} // namespace molo::google::workspace
+90
View File
@@ -0,0 +1,90 @@
#include "google/workspace/calls.h"
#include <cstring>
#include <unordered_map>
namespace molo::google::workspace {
namespace {
std::vector<std::string> split(const char* text, char sep) {
std::vector<std::string> out;
std::string cur;
for (const char* p = text; *p; ++p) {
if (*p == sep) {
if (!cur.empty()) out.push_back(cur);
cur.clear();
} else {
cur += *p;
}
}
if (!cur.empty()) out.push_back(cur);
return out;
}
} // namespace
std::vector<ParamInfo> params_of(const CallSpec& call) {
std::vector<ParamInfo> out;
for (const std::string& item : split(call.params, ',')) {
ParamInfo p;
std::size_t end = item.find_first_of("@!#?*");
p.name = item.substr(0, end);
for (std::size_t i = end; i != std::string::npos && i < item.size(); ++i) {
switch (item[i]) {
case '@': p.path = true; p.required = true; break;
case '!': p.required = true; break;
case '#': p.number = true; break;
case '?': p.boolean = true; break;
case '*': p.repeated = true; break;
default: break;
}
}
out.push_back(std::move(p));
}
return out;
}
Kind kind_of(const CallSpec& call) { return static_cast<Kind>(call.kind[0]); }
bool has_flag(const CallSpec& call, char flag) { return std::strchr(call.flags, flag) != nullptr; }
const ApiSpec* find_api(const std::string& name) {
for (std::size_t i = 0; i < kApiTableSize; ++i)
if (name == kApiTable[i].name) return &kApiTable[i];
return nullptr;
}
const CallSpec* find_call(const std::string& id) {
static const std::unordered_map<std::string, const CallSpec*> index = [] {
std::unordered_map<std::string, const CallSpec*> m;
for (std::size_t i = 0; i < kCallTableSize; ++i) m.emplace(kCallTable[i].id, &kCallTable[i]);
return m;
}();
auto it = index.find(id);
return it == index.end() ? nullptr : it->second;
}
const CallSpec* find_call_in(const std::string& api, const std::string& id) {
for (std::size_t i = 0; i < kCallTableSize; ++i)
if (api == kCallTable[i].api && id == kCallTable[i].id) return &kCallTable[i];
return nullptr;
}
std::vector<std::string> body_fields_of(const CallSpec& call) {
if (!*call.body) return {};
for (std::size_t i = 0; i < kSchemaTableSize; ++i)
if (std::strcmp(kSchemaTable[i].api, call.api) == 0 &&
std::strcmp(kSchemaTable[i].schema, call.body) == 0)
return split(kSchemaTable[i].fields, ',');
return {};
}
std::vector<const CallSpec*> calls_of(const std::string& api) {
std::vector<const CallSpec*> out;
for (std::size_t i = 0; i < kCallTableSize; ++i)
if (api == kCallTable[i].api) out.push_back(&kCallTable[i]);
return out;
}
} // namespace molo::google::workspace
+83
View File
@@ -0,0 +1,83 @@
#pragma once
// The ONE table of Workspace REST calls: every method of twenty Discovery
// documents (call_table.cpp, generated by tools/gen_calls.py, proven by
// tools/check_discovery.py). Code builds every URL from this table.
#include <cstddef>
#include <string>
#include <vector>
namespace molo::google::workspace {
// One Workspace API (one Discovery document).
struct ApiSpec {
const char* name; // gmail, drive, directory, ...
const char* discovery_id; // gmail:v1
const char* discovery_url;
const char* base_url; // rootUrl + servicePath, no trailing slash
const char* service; // API to enable: gmail.googleapis.com
const char* scopes; // space separated, every OAuth scope of the API
const char* readonly_scopes; // subset ending in readonly / metadata
const char* revision;
};
// What a call does to the world. Decides which library method may run it.
enum class Kind : char {
kRead = 'r', // no side effect
kWrite = 'w', // changes data of a human or organization
kDestroy = 'd', // deletes, trashes, clears, signs out, wipes
kSend = 's', // reaches other people (mail, chat, invites, shares)
};
struct CallSpec {
const char* id; // gmail.users.messages.list
const char* api; // ApiSpec::name
const char* http; // GET POST PUT PATCH DELETE
const char* path; // Discovery path, relative to the base URL
const char* params; // "userId@,maxResults#,labelIds*,q" (see ParamInfo)
const char* body; // request schema name, "" when none
const char* items_key; // array property of the list response, "" if none
const char* kind; // one char of Kind
const char* flags; // u media upload, d media download, b bytes response
};
struct SchemaSpec {
const char* api;
const char* schema;
const char* fields; // comma list of top-level properties
};
extern const ApiSpec kApiTable[];
extern const std::size_t kApiTableSize;
extern const CallSpec kCallTable[];
extern const std::size_t kCallTableSize;
extern const SchemaSpec kSchemaTable[];
extern const std::size_t kSchemaTableSize;
// One parameter of a call, decoded from CallSpec::params. Markers after the
// name: @ path, ! required query, # number, ? boolean, * repeated.
struct ParamInfo {
std::string name;
bool path = false;
bool required = false;
bool number = false;
bool boolean = false;
bool repeated = false;
};
std::vector<ParamInfo> params_of(const CallSpec& call);
Kind kind_of(const CallSpec& call);
bool has_flag(const CallSpec& call, char flag);
const ApiSpec* find_api(const std::string& name);
// Method ids are unique per API, not across APIs (admin.channels.stop exists
// in both directory and reports): find_call returns the first row with the id,
// find_call_in the row of the named API.
const CallSpec* find_call(const std::string& id);
const CallSpec* find_call_in(const std::string& api, const std::string& id);
// Top-level request body fields for the call, empty when it has no body.
std::vector<std::string> body_fields_of(const CallSpec& call);
std::vector<const CallSpec*> calls_of(const std::string& api);
} // namespace molo::google::workspace
+23
View File
@@ -0,0 +1,23 @@
#pragma once
// Static ceilings for the Workspace package. Never autotuned.
#include <cstddef>
namespace molo::google::workspace {
struct WorkspaceCaps {
static constexpr std::size_t kMaxParams = 40; // path + query parameters per call
static constexpr std::size_t kMaxParamChars = 2048; // one query value
static constexpr std::size_t kMaxPathValueChars = 512; // one path value
static constexpr std::size_t kMaxRepeated = 100; // values of one repeated parameter
static constexpr std::size_t kMaxBodyBytes = 2 * 1024 * 1024; // serialized request body
static constexpr std::size_t kMaxFieldsChars = 1024; // the `fields` selector
static constexpr int kMaxPages = 20; // pages walked by pages()
static constexpr std::size_t kMaxItems = 2000; // items collected by list()
static constexpr std::size_t kMaxSubjectChars = 254; // delegated user e-mail
static constexpr std::size_t kMaxScopes = 40; // scopes in one token
static constexpr std::size_t kMaxScopeChars = 4096; // joined scope string
};
} // namespace molo::google::workspace
+173
View File
@@ -0,0 +1,173 @@
#include "google/workspace/delegation.h"
#include <wolfssl/options.h>
#include <wolfssl/wolfcrypt/asn.h>
#include <wolfssl/wolfcrypt/error-crypt.h>
#include <wolfssl/wolfcrypt/random.h>
#include <wolfssl/wolfcrypt/rsa.h>
#include <wolfssl/wolfcrypt/signature.h>
#include <ctime>
#include <sstream>
#include "clients/body/json.h"
#include "clients/client.h"
#include "clients/transports/http_transport.h"
#include "google/errors.h"
#include "google/workspace/caps.h"
#include "security/crypto/Base64.h"
namespace molo::google::workspace {
using clients::body::Json;
using security::crypto::Base64;
namespace {
constexpr auto kRefreshMargin = std::chrono::seconds(60);
std::string str(const Json& doc, const char* key) {
const Json* v = doc.is_object() ? doc.find(key) : nullptr;
return v && v->is_string() ? v->as_string() : "";
}
std::string pem_to_der(const std::string& pem) {
std::string body;
std::istringstream in(pem);
std::string line;
while (std::getline(in, line)) {
if (!line.empty() && line.back() == '\r') line.pop_back();
if (line.rfind("-----", 0) == 0 || line.empty()) continue;
body += line;
}
std::string der;
if (!Base64::decode(body, der) || der.empty())
throw GoogleError::invalid("private_key is not valid PEM");
return der;
}
struct RsaGuard {
RsaGuard() { wc_InitRsaKey(&key, nullptr); }
~RsaGuard() { wc_FreeRsaKey(&key); }
RsaGuard(const RsaGuard&) = delete;
RsaGuard& operator=(const RsaGuard&) = delete;
RsaKey key;
};
} // namespace
void Delegation::validate() const {
if (subject.empty()) return;
if (subject.size() > WorkspaceCaps::kMaxSubjectChars)
throw GoogleError::invalid("delegation subject is too long");
std::size_t at = subject.find('@');
if (at == std::string::npos || at == 0 || at + 1 >= subject.size() ||
subject.find('@', at + 1) != std::string::npos)
throw GoogleError::invalid("delegation subject must be an e-mail address");
for (unsigned char c : subject)
if (c <= 0x20 || c == 0x7f)
throw GoogleError::invalid("delegation subject holds whitespace or a control character");
}
DelegatedAuth::DelegatedAuth(ServiceAccountKey key, std::vector<std::string> scopes,
Delegation delegation)
: key_(std::move(key)), delegation_(std::move(delegation)) {
delegation_.validate();
if (scopes.empty() || scopes.size() > WorkspaceCaps::kMaxScopes)
throw GoogleError::invalid("scopes must hold 1 to 40 entries");
for (const auto& s : scopes) {
if (s.rfind("https://", 0) != 0 || s.find(' ') != std::string::npos)
throw GoogleError::invalid("scope must be an https URL without spaces");
scope_ += (scope_.empty() ? "" : " ") + s;
}
if (scope_.size() > WorkspaceCaps::kMaxScopeChars)
throw GoogleError::invalid("scope string is over the size cap");
}
DelegatedAuth::~DelegatedAuth() = default;
std::string DelegatedAuth::assertion(const ServiceAccountKey& key, const std::string& scope,
const Delegation& delegation, std::int64_t iat,
std::chrono::seconds lifetime) {
delegation.validate();
Json header = Json::object();
header.set("alg", Json("RS256"));
header.set("typ", Json("JWT"));
Json claims = Json::object();
claims.set("iss", Json(key.client_email));
claims.set("scope", Json(scope));
claims.set("aud", Json(key.token_uri));
claims.set("iat", Json(static_cast<double>(iat)));
claims.set("exp", Json(static_cast<double>(iat + lifetime.count())));
if (delegation.active()) claims.set("sub", Json(delegation.subject));
std::string signing_input = Base64::encode_url(header.dump()) + "." +
Base64::encode_url(claims.dump());
std::string der = pem_to_der(key.private_key_pem);
RsaGuard rsa;
word32 idx = 0;
int off = wc_GetPkcs8TraditionalOffset(reinterpret_cast<byte*>(der.data()), &idx,
static_cast<word32>(der.size()));
if (off < 0) idx = 0;
if (wc_RsaPrivateKeyDecode(reinterpret_cast<const byte*>(der.data()), &idx, &rsa.key,
static_cast<word32>(der.size())) != 0)
throw GoogleError::invalid("private_key is not a usable RSA key");
WC_RNG rng;
if (wc_InitRng(&rng) != 0) throw GoogleError(500, "INTERNAL", "rng init failed");
word32 sig_len = static_cast<word32>(
wc_SignatureGetSize(WC_SIGNATURE_TYPE_RSA_W_ENC, &rsa.key, sizeof(rsa.key)));
std::string sig(sig_len, '\0');
int rc = wc_SignatureGenerate(WC_HASH_TYPE_SHA256, WC_SIGNATURE_TYPE_RSA_W_ENC,
reinterpret_cast<const byte*>(signing_input.data()),
static_cast<word32>(signing_input.size()),
reinterpret_cast<byte*>(sig.data()), &sig_len, &rsa.key,
sizeof(rsa.key), &rng);
wc_FreeRng(&rng);
if (rc != 0) throw GoogleError(500, "INTERNAL", "JWT signing failed");
sig.resize(sig_len);
return signing_input + "." + Base64::encode_url(sig);
}
std::string DelegatedAuth::fetch_token() const {
std::string jwt = assertion(key_, scope_, delegation_, static_cast<std::int64_t>(std::time(nullptr)));
clients::Client http(std::make_unique<clients::transports::HttpTransport>());
clients::ClientRequest req = clients::ClientRequest::post(key_.token_uri);
req.form("grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Ajwt-bearer&assertion=" + jwt);
clients::ClientResponse resp = http.send_blocking(std::move(req));
Json doc;
try {
doc = resp.json();
} catch (const std::exception&) {
throw GoogleError(502, "BAD_RESPONSE", "token endpoint returned non-JSON", "oauth2");
}
if (!resp.is_success()) {
std::string msg = str(doc, "error_description");
std::string err = str(doc, "error");
throw GoogleError(resp.status() == 400 ? 401 : resp.status(),
err.empty() ? "UNAUTHENTICATED" : err,
msg.empty() ? "token exchange failed" : msg, "oauth2");
}
std::string tok = str(doc, "access_token");
if (tok.empty())
throw GoogleError(502, "BAD_RESPONSE", "token endpoint returned no access_token", "oauth2");
const Json* ttl = doc.find("expires_in");
long seconds = ttl && ttl->is_number() ? ttl->as_int() : 3600;
std::lock_guard<std::mutex> lock(mutex_);
token_ = tok;
expires_ = std::chrono::steady_clock::now() + std::chrono::seconds(seconds);
return tok;
}
std::string DelegatedAuth::token() const {
{
std::lock_guard<std::mutex> lock(mutex_);
if (!token_.empty() && std::chrono::steady_clock::now() + kRefreshMargin < expires_)
return token_;
}
return fetch_token();
}
void DelegatedAuth::apply(clients::ClientRequest& request) const { request.bearer(token()); }
} // namespace molo::google::workspace
+67
View File
@@ -0,0 +1,67 @@
#pragma once
// Domain-wide delegation for Workspace. The foundation ServiceAccountAuth
// cannot carry the JWT `sub` claim, so this package signs its own assertion
// (same RS256 / wolfCrypt method, key file parsed by the foundation's
// ServiceAccountKey) and keeps the token fresh.
//
// Typed option: Delegation{subject}. With a subject the token acts as that
// human (the admin must have granted the service account's client id the
// scopes in Admin console > Security > API controls > Domain-wide delegation).
// Without it the token acts as the service account itself, which owns no mail,
// drive or calendar data: Workspace APIs then answer 400/401/403 or empty lists.
//
// Env: GOOGLE_WORKSPACE_SUBJECT (looked up like every Google knob),
// GOOGLE_APPLICATION_CREDENTIALS (key file), GOOGLE_ACCESS_TOKEN (a user's
// OAuth token, used as is).
#include <chrono>
#include <memory>
#include <mutex>
#include <string>
#include <vector>
#include "clients/auth.h"
#include "google/service_account.h"
namespace molo::google::workspace {
struct Delegation {
std::string subject; // e-mail of the user to impersonate; empty: none
bool active() const { return !subject.empty(); }
// Throws GoogleError (invalid) unless empty or a plausible e-mail address
// (one @, no whitespace or control characters, at most 254 characters).
void validate() const;
};
class DelegatedAuth : public clients::Auth {
public:
DelegatedAuth(ServiceAccountKey key, std::vector<std::string> scopes, Delegation delegation = {});
~DelegatedAuth() override;
void apply(clients::ClientRequest& request) const override;
const char* scheme() const override { return "service-account-delegated"; }
const Delegation& delegation() const { return delegation_; }
const std::string& scope_string() const { return scope_; }
// Pure computation, no network: the signed JWT assertion with iss, scope,
// aud, iat, exp and (when active) sub.
static std::string assertion(const ServiceAccountKey& key, const std::string& scope,
const Delegation& delegation, std::int64_t iat,
std::chrono::seconds lifetime = std::chrono::seconds(3600));
// One token exchange with Google; throws GoogleError on refusal. Public so a
// live check can show the exact refusal (unauthorized_client without DWD).
std::string fetch_token() const;
private:
std::string token() const;
ServiceAccountKey key_;
std::string scope_;
Delegation delegation_;
mutable std::mutex mutex_;
mutable std::string token_;
mutable std::chrono::steady_clock::time_point expires_{};
};
} // namespace molo::google::workspace
+183
View File
@@ -0,0 +1,183 @@
#include "google/workspace/prepared_call.h"
#include <cmath>
#include <cstdio>
#include <set>
#include "google/errors.h"
#include "google/workspace/caps.h"
namespace molo::google::workspace {
using clients::body::Json;
namespace {
[[noreturn]] void bad(const std::string& why) { throw GoogleError::invalid(why); }
bool control(unsigned char c) { return c < 0x20 || c == 0x7f; }
void check_text(const std::string& name, const std::string& v, std::size_t cap) {
if (v.size() > cap) bad(name + " is over " + std::to_string(cap) + " characters");
for (unsigned char c : v)
if (control(c)) bad(name + " holds a control character");
}
std::string number_text(const std::string& name, const Json& v) {
if (v.is_number()) {
double d = v.as_number();
if (!std::isfinite(d)) bad(name + " must be a finite number");
char buf[64];
if (d == std::floor(d) && std::fabs(d) < 1e15)
std::snprintf(buf, sizeof buf, "%lld", static_cast<long long>(d));
else
std::snprintf(buf, sizeof buf, "%.15g", d);
return buf;
}
if (v.is_string()) {
const std::string& s = v.as_string();
std::size_t used = 0;
try {
std::stod(s, &used);
} catch (const std::exception&) {
bad(name + " must be a number");
}
if (used != s.size()) bad(name + " must be a number");
return s;
}
bad(name + " must be a number");
}
std::string scalar_text(const ParamInfo& p, const Json& v) {
if (p.number) return number_text(p.name, v);
if (p.boolean) {
if (v.is_bool()) return v.as_bool() ? "true" : "false";
if (v.is_string() && (v.as_string() == "true" || v.as_string() == "false")) return v.as_string();
bad(p.name + " must be true or false");
}
if (!v.is_string()) bad(p.name + " must be a string");
check_text(p.name, v.as_string(), WorkspaceCaps::kMaxParamChars);
return v.as_string();
}
} // namespace
std::string PreparedCall::encode(const std::string& value, bool keep_slash) {
static const char* hex = "0123456789ABCDEF";
std::string out;
for (unsigned char c : value) {
bool plain = (c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') ||
c == '-' || c == '.' || c == '_' || c == '~' || (keep_slash && c == '/');
if (plain) {
out += static_cast<char>(c);
} else {
out += '%';
out += hex[c >> 4];
out += hex[c & 15];
}
}
return out;
}
PreparedCall PreparedCall::build(const CallSpec& spec, const Json& params, const Json* body) {
if (!params.is_object()) bad("params must be a JSON object");
std::vector<ParamInfo> infos = params_of(spec);
std::set<std::string> known;
for (const auto& p : infos) known.insert(p.name);
if (params.as_object().size() > WorkspaceCaps::kMaxParams) bad("too many parameters");
for (const auto& [name, v] : params.as_object()) {
(void)v;
if (name != "fields" && !known.count(name))
bad("unknown parameter " + name + " for " + spec.id);
}
PreparedCall out;
out.spec = &spec;
const std::string http = spec.http;
out.method = http == "GET" ? clients::Method::kGet
: http == "POST" ? clients::Method::kPost
: http == "PUT" ? clients::Method::kPut
: http == "PATCH" ? clients::Method::kPatch
: clients::Method::kDelete;
// Path template: {name} or {+name}; everything else is copied.
std::string rendered = "/";
const std::string tmpl = spec.path;
for (std::size_t i = 0; i < tmpl.size();) {
if (tmpl[i] != '{') {
rendered += tmpl[i++];
continue;
}
std::size_t close = tmpl.find('}', i);
if (close == std::string::npos) bad("broken path template");
std::string name = tmpl.substr(i + 1, close - i - 1);
bool plus = !name.empty() && name[0] == '+';
if (plus) name.erase(0, 1);
const Json* v = params.find(name);
if (!v || !v->is_string() || v->as_string().empty()) bad(name + " is required (string)");
const std::string& s = v->as_string();
check_text(name, s, WorkspaceCaps::kMaxPathValueChars);
std::string seg;
for (std::size_t k = 0; k <= s.size(); ++k) {
if (k == s.size() || s[k] == '/') {
if (seg == "..") bad(name + " must not contain ..");
seg.clear();
} else {
seg += s[k];
}
}
if (!plus && s.find('/') != std::string::npos) bad(name + " must not contain /");
rendered += encode(s, plus);
i = close + 1;
}
std::string query;
auto add = [&](const std::string& k, const std::string& v) {
query += (query.empty() ? "?" : "&") + encode(k, false) + "=" + encode(v, false);
};
for (const auto& p : infos) {
if (p.path) continue;
const Json* v = params.find(p.name);
if (!v || v->is_null()) {
if (p.required) bad(p.name + " is required");
continue;
}
if (p.repeated) {
if (!v->is_array()) bad(p.name + " must be an array");
if (v->as_array().size() > WorkspaceCaps::kMaxRepeated) bad(p.name + " has too many values");
for (const Json& e : v->as_array()) add(p.name, scalar_text(p, e));
} else {
add(p.name, scalar_text(p, *v));
}
}
if (const Json* f = params.find("fields")) {
if (!f->is_string()) bad("fields must be a string");
check_text("fields", f->as_string(), WorkspaceCaps::kMaxFieldsChars);
add("fields", f->as_string());
}
// Groups Settings answers Atom XML unless asked for JSON.
if (std::string(spec.api) == "groupssettings") add("alt", "json");
out.path = rendered + query;
if (body && !body->is_null()) {
if (!*spec.body) bad(std::string(spec.id) + " takes no request body");
if (!body->is_object()) bad("body must be a JSON object");
if (body->dump().size() > WorkspaceCaps::kMaxBodyBytes) bad("body is over the size cap");
std::vector<std::string> fields = body_fields_of(spec);
for (const auto& [k, v] : body->as_object()) {
(void)v;
bool ok = false;
for (const auto& f : fields) ok = ok || f == k;
if (!ok) bad("unknown body field " + k + " for " + spec.body);
}
out.body = *body;
out.has_body = true;
}
return out;
}
std::string PreparedCall::path_with_token(const std::string& token) const {
return path + (path.find('?') == std::string::npos ? "?" : "&") + "pageToken=" + encode(token, false);
}
} // namespace molo::google::workspace
+32
View File
@@ -0,0 +1,32 @@
#pragma once
// PreparedCall: a validated request, ready to send. Built from the call table
// and the caller's parameters; nothing reaches the network before it passes.
// Parameters are one flat Json object: path and query names side by side.
#include <string>
#include "clients/body/json.h"
#include "clients/request.h"
#include "google/workspace/calls.h"
namespace molo::google::workspace {
struct PreparedCall {
const CallSpec* spec = nullptr;
clients::Method method = clients::Method::kGet;
std::string path; // under the API base URL, with query string
clients::body::Json body;
bool has_body = false;
// Throws GoogleError (invalid): unknown or missing parameter, wrong type,
// oversize value, unknown body field, body on a bodyless call.
static PreparedCall build(const CallSpec& spec, const clients::body::Json& params,
const clients::body::Json* body);
// The same with a page token appended (pagination).
std::string path_with_token(const std::string& token) const;
static std::string encode(const std::string& value, bool keep_slash);
};
} // namespace molo::google::workspace
+182
View File
@@ -0,0 +1,182 @@
#include "google/workspace/services.h"
namespace molo::google::workspace {
namespace {
Json strs(std::initializer_list<const char*> v) {
Json a = Json::array();
for (const char* s : v) a.push(Json(s));
return a;
}
Json csv(const std::string& list) {
Json a = Json::array();
std::string cur;
for (char c : list) {
if (c == ',') { if (!cur.empty()) a.push(Json(cur)); cur.clear(); }
else cur += c;
}
if (!cur.empty()) a.push(Json(cur));
return a;
}
void opt(ParamList& p, const char* k, const std::string& v) {
if (!v.empty()) p.emplace_back(k, Json(v));
}
} // namespace
// --- Gmail -------------------------------------------------------------
Json Gmail::profile(const std::string& user) const {
return read("gmail.users.getProfile", make_params({{"userId", Json(user)}}));
}
Json Gmail::labels(const std::string& user) const {
return read("gmail.users.labels.list", make_params({{"userId", Json(user)}}));
}
Listing Gmail::messages(const std::string& user, const std::string& query, int max) const {
ParamList p{{"userId", Json(user)}, {"maxResults", Json(max)}};
opt(p, "q", query);
return list("gmail.users.messages.list", make_params(p), 1);
}
Json Gmail::message(const std::string& user, const std::string& id, const std::string& format) const {
return read("gmail.users.messages.get",
make_params({{"userId", Json(user)}, {"id", Json(id)}, {"format", Json(format)}}));
}
Listing Gmail::threads(const std::string& user, const std::string& query, int max) const {
ParamList p{{"userId", Json(user)}, {"maxResults", Json(max)}};
opt(p, "q", query);
return list("gmail.users.threads.list", make_params(p), 1);
}
// --- Drive -------------------------------------------------------------
Json Drive::about(const std::string& fields) const {
return read("drive.about.get", make_params({{"fields", Json(fields)}}));
}
Listing Drive::files(const std::string& query, int page_size) const {
ParamList p{{"pageSize", Json(page_size)}};
opt(p, "q", query);
return list("drive.files.list", make_params(p), 1);
}
Json Drive::file(const std::string& id, const std::string& fields) const {
return read("drive.files.get", make_params({{"fileId", Json(id)}, {"fields", Json(fields)}}));
}
// --- Calendar ----------------------------------------------------------
Listing Calendar::calendars() const { return list("calendar.calendarList.list", Json::object(), 1); }
Listing Calendar::events(const std::string& calendar_id, const std::string& time_min,
const std::string& time_max, int max) const {
ParamList p{{"calendarId", Json(calendar_id)}, {"maxResults", Json(max)}, {"singleEvents", Json(true)}};
opt(p, "timeMin", time_min);
opt(p, "timeMax", time_max);
return list("calendar.events.list", make_params(p), 1);
}
Json Calendar::free_busy(const Json& request) const {
return read("calendar.freebusy.query", Json::object(), &request);
}
// --- Sheets / Docs / Slides / Forms ---------------------------------------
Json Sheets::spreadsheet(const std::string& id, bool grid) const {
return read("sheets.spreadsheets.get",
make_params({{"spreadsheetId", Json(id)}, {"includeGridData", Json(grid)}}));
}
Json Sheets::values(const std::string& id, const std::string& range) const {
return read("sheets.spreadsheets.values.get",
make_params({{"spreadsheetId", Json(id)}, {"range", Json(range)}}));
}
Json Docs::document(const std::string& id) const {
return read("docs.documents.get", make_params({{"documentId", Json(id)}}));
}
Json Slides::presentation(const std::string& id) const {
return read("slides.presentations.get", make_params({{"presentationId", Json(id)}}));
}
Json Slides::page(const std::string& id, const std::string& page_id) const {
return read("slides.presentations.pages.get",
make_params({{"presentationId", Json(id)}, {"pageObjectId", Json(page_id)}}));
}
Json Forms::form(const std::string& id) const {
return read("forms.forms.get", make_params({{"formId", Json(id)}}));
}
Listing Forms::responses(const std::string& id, int page_size) const {
return list("forms.forms.responses.list",
make_params({{"formId", Json(id)}, {"pageSize", Json(page_size)}}), 1);
}
// --- Tasks / Chat / Meet / People / Keep / Classroom ------------------------
Listing Tasks::task_lists() const { return list("tasks.tasklists.list", Json::object(), 1); }
Listing Tasks::tasks(const std::string& list_id) const {
return list("tasks.tasks.list", make_params({{"tasklist", Json(list_id)}}), 1);
}
Listing Chat::spaces() const { return list("chat.spaces.list", Json::object(), 1); }
Listing Chat::messages(const std::string& space) const {
return list("chat.spaces.messages.list", make_params({{"parent", Json(space)}}), 1);
}
Listing Meet::conference_records() const { return list("meet.conferenceRecords.list", Json::object(), 1); }
Json Meet::space(const std::string& name) const {
return read("meet.spaces.get", make_params({{"name", Json(name)}}));
}
Json People::me(const std::string& fields) const {
return read("people.people.get",
make_params({{"resourceName", Json("people/me")}, {"personFields", Json(fields)}}));
}
Listing People::connections(const std::string& fields, int page_size) const {
return list("people.people.connections.list",
make_params({{"resourceName", Json("people/me")}, {"personFields", Json(fields)},
{"pageSize", Json(page_size)}}), 1);
}
Listing Keep::notes(const std::string& filter) const {
ParamList p;
opt(p, "filter", filter);
return list("keep.notes.list", make_params(p), 1);
}
Listing Classroom::courses(int page_size) const {
return list("classroom.courses.list", make_params({{"pageSize", Json(page_size)}}), 1);
}
Json Classroom::course(const std::string& id) const {
return read("classroom.courses.get", make_params({{"id", Json(id)}}));
}
// --- YouTube -----------------------------------------------------------
Json YouTube::my_channel(const std::string& part) const {
return read("youtube.channels.list", make_params({{"part", csv(part)}, {"mine", Json(true)}}));
}
Json YouTube::search(const std::string& query, int max) const {
return read("youtube.search.list",
make_params({{"part", strs({"snippet"})}, {"q", Json(query)}, {"maxResults", Json(max)}}));
}
Json YouTube::videos(const std::string& ids, const std::string& part) const {
return read("youtube.videos.list", make_params({{"part", csv(part)}, {"id", csv(ids)}}));
}
Json YouTubeAnalytics::report(const std::string& ids, const std::string& start, const std::string& end,
const std::string& metrics, const std::string& dimensions) const {
ParamList p{{"ids", Json(ids)}, {"startDate", Json(start)}, {"endDate", Json(end)},
{"metrics", Json(metrics)}};
opt(p, "dimensions", dimensions);
return read("youtubeAnalytics.reports.query", make_params(p));
}
Listing YouTubeReporting::report_types() const {
return list("youtubereporting.reportTypes.list", Json::object(), 1);
}
Listing YouTubeReporting::jobs() const { return list("youtubereporting.jobs.list", Json::object(), 1); }
// --- Admin SDK / Groups settings / Vault -----------------------------------
Listing Directory::users(const std::string& customer, int max) const {
return list("directory.users.list",
make_params({{"customer", Json(customer)}, {"maxResults", Json(max)}}), 1);
}
Listing Directory::groups(const std::string& customer, int max) const {
return list("directory.groups.list",
make_params({{"customer", Json(customer)}, {"maxResults", Json(max)}}), 1);
}
Json Directory::org_units(const std::string& customer) const {
return read("directory.orgunits.list", make_params({{"customerId", Json(customer)}}));
}
Listing Reports::activities(const std::string& user_key, const std::string& application, int max) const {
return list("reports.activities.list",
make_params({{"userKey", Json(user_key)}, {"applicationName", Json(application)},
{"maxResults", Json(max)}}), 1);
}
Json GroupsSettings::group(const std::string& email) const {
return read("groupsSettings.groups.get", make_params({{"groupUniqueId", Json(email)}}));
}
Listing Vault::matters(int page_size) const {
return list("vault.matters.list", make_params({{"pageSize", Json(page_size)}}), 1);
}
} // namespace molo::google::workspace
+162
View File
@@ -0,0 +1,162 @@
#pragma once
// One typed class per Workspace API. Each adds read helpers for the common
// questions (profile, list, get) on top of WorkspaceApi, which still reaches
// every other call of the API by its Discovery method id. Helpers are reads
// only: writes, deletes and sends stay explicit calls on WorkspaceApi.
#include <string>
#include "google/workspace/workspace_api.h"
namespace molo::google::workspace {
class Gmail : public WorkspaceApi {
public:
explicit Gmail(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "gmail") {}
Json profile(const std::string& user = "me") const;
Json labels(const std::string& user = "me") const;
Listing messages(const std::string& user, const std::string& query, int max_results = 20) const;
Json message(const std::string& user, const std::string& id, const std::string& format = "metadata") const;
Listing threads(const std::string& user, const std::string& query, int max_results = 20) const;
};
class Drive : public WorkspaceApi {
public:
explicit Drive(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "drive") {}
Json about(const std::string& fields = "user,storageQuota") const;
Listing files(const std::string& query, int page_size = 20) const;
Json file(const std::string& id, const std::string& fields = "id,name,mimeType,modifiedTime") const;
};
class Calendar : public WorkspaceApi {
public:
explicit Calendar(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "calendar") {}
Listing calendars() const;
Listing events(const std::string& calendar_id, const std::string& time_min,
const std::string& time_max, int max_results = 20) const;
Json free_busy(const Json& request) const; // read: a POST that changes nothing
};
class Sheets : public WorkspaceApi {
public:
explicit Sheets(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "sheets") {}
Json spreadsheet(const std::string& id, bool grid_data = false) const;
Json values(const std::string& id, const std::string& range) const;
};
class Docs : public WorkspaceApi {
public:
explicit Docs(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "docs") {}
Json document(const std::string& id) const;
};
class Slides : public WorkspaceApi {
public:
explicit Slides(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "slides") {}
Json presentation(const std::string& id) const;
Json page(const std::string& id, const std::string& page_id) const;
};
class Forms : public WorkspaceApi {
public:
explicit Forms(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "forms") {}
Json form(const std::string& id) const;
Listing responses(const std::string& id, int page_size = 50) const;
};
class Tasks : public WorkspaceApi {
public:
explicit Tasks(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "tasks") {}
Listing task_lists() const;
Listing tasks(const std::string& list_id) const;
};
class Chat : public WorkspaceApi {
public:
explicit Chat(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "chat") {}
Listing spaces() const;
Listing messages(const std::string& space) const; // "spaces/AAAA"
};
class Meet : public WorkspaceApi {
public:
explicit Meet(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "meet") {}
Listing conference_records() const;
Json space(const std::string& name) const; // "spaces/abc"
};
class People : public WorkspaceApi {
public:
explicit People(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "people") {}
Json me(const std::string& person_fields = "names,emailAddresses") const;
Listing connections(const std::string& person_fields = "names,emailAddresses", int page_size = 50) const;
};
class Keep : public WorkspaceApi {
public:
explicit Keep(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "keep") {}
Listing notes(const std::string& filter = "") const;
};
class Classroom : public WorkspaceApi {
public:
explicit Classroom(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "classroom") {}
Listing courses(int page_size = 20) const;
Json course(const std::string& id) const;
};
class YouTube : public WorkspaceApi {
public:
explicit YouTube(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "youtube") {}
Json my_channel(const std::string& part = "snippet,statistics") const;
// Costs 100 quota units per call.
Json search(const std::string& query, int max_results = 5) const;
Json videos(const std::string& ids, const std::string& part = "snippet,statistics") const;
};
class YouTubeAnalytics : public WorkspaceApi {
public:
explicit YouTubeAnalytics(std::shared_ptr<GoogleClient> c)
: WorkspaceApi(std::move(c), "youtubeanalytics") {}
Json report(const std::string& ids, const std::string& start_date, const std::string& end_date,
const std::string& metrics, const std::string& dimensions = "") const;
};
class YouTubeReporting : public WorkspaceApi {
public:
explicit YouTubeReporting(std::shared_ptr<GoogleClient> c)
: WorkspaceApi(std::move(c), "youtubereporting") {}
Listing report_types() const;
Listing jobs() const;
};
class Directory : public WorkspaceApi {
public:
explicit Directory(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "directory") {}
Listing users(const std::string& customer = "my_customer", int max_results = 50) const;
Listing groups(const std::string& customer = "my_customer", int max_results = 50) const;
Json org_units(const std::string& customer = "my_customer") const;
};
class Reports : public WorkspaceApi {
public:
explicit Reports(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "reports") {}
Listing activities(const std::string& user_key, const std::string& application,
int max_results = 50) const;
};
class GroupsSettings : public WorkspaceApi {
public:
explicit GroupsSettings(std::shared_ptr<GoogleClient> c)
: WorkspaceApi(std::move(c), "groupssettings") {}
Json group(const std::string& group_email) const;
};
class Vault : public WorkspaceApi {
public:
explicit Vault(std::shared_ptr<GoogleClient> c) : WorkspaceApi(std::move(c), "vault") {}
Listing matters(int page_size = 20) const;
};
} // namespace molo::google::workspace
@@ -0,0 +1,143 @@
#!/usr/bin/env python3
"""Check src/google/workspace/call_table.cpp against Google's Discovery documents.
Fails (exit 1) when a row is absent from Discovery, a Discovery method has no
row, or method, path, parameter (name, location, required, type, repeated),
request schema, schema field, items key, media flag, base URL or scope list
differ. Kind sanity: every GET is a read, every DELETE is destructive, a
read that is not a GET is on the explicit allowlist. Python 3 stdlib only.
python3 -I src/google/workspace/tools/check_discovery.py
"""
import json
import os
import re
import sys
import urllib.request
HERE = os.path.dirname(os.path.abspath(__file__))
TABLE = os.path.join(HERE, "..", "call_table.cpp")
STR = re.compile(r'"((?:[^"\\]|\\.)*)"')
POST_READS = {"calendar.freebusy.query", "sheets.spreadsheets.getByDataFilter",
"sheets.spreadsheets.values.batchGetByDataFilter"}
def block(text, begin, end):
a, b = text.index(begin), text.index(end)
rows = []
for line in text[a:b].splitlines()[1:]:
s = line.strip()
if s.startswith("{") and s.endswith("},"):
rows.append([x.replace('\\"', '"').replace("\\\\", "\\") for x in STR.findall(s)])
return rows
def fetch(url):
with urllib.request.urlopen(url, timeout=60) as r:
return json.load(r)
def methods(node, out):
for m in node.get("methods", {}).values():
out[m["id"]] = m
for child in node.get("resources", {}).values():
methods(child, out)
def decode(spec):
out = {}
for item in filter(None, spec.split(",")):
name = re.split(r"[@!#?*]", item, maxsplit=1)[0]
out[name] = item[len(name):]
return out
def main():
text = open(TABLE).read()
apis = {r[0]: r for r in block(text, "// APIS-BEGIN", "// APIS-END")}
calls = block(text, "// CALLS-BEGIN", "// CALLS-END")
schemas = {(r[0], r[1]): r[2] for r in block(text, "// SCHEMAS-BEGIN", "// SCHEMAS-END")}
bad = []
rows_by_api = {}
for r in calls:
rows_by_api.setdefault(r[1], {})[r[0]] = r
total = 0
for name, (_, did, url, base, service, scopes, readonly, revision) in apis.items():
doc = fetch(url)
index = {}
methods(doc, index)
if (doc["rootUrl"] + doc["servicePath"]).rstrip("/") != base:
bad.append("%s: base url differs" % name)
want_scopes = set(doc.get("auth", {}).get("oauth2", {}).get("scopes", {}))
if set(scopes.split()) != want_scopes:
bad.append("%s: scope list differs (%s)" % (name, sorted(want_scopes ^ set(scopes.split()))))
if not set(readonly.split()) <= want_scopes:
bad.append("%s: readonly scope not in Discovery" % name)
rows = rows_by_api.get(name, {})
for rid in index:
if rid not in rows:
bad.append("%s: Discovery method %s has no row" % (name, rid))
for rid, (_, api, http, path, params, body, items, kind, flags) in rows.items():
total += 1
m = index.get(rid)
if not m:
bad.append("missing rpc " + rid)
continue
if m["httpMethod"] != http:
bad.append("%s: http %s != %s" % (rid, http, m["httpMethod"]))
if m["path"] != path:
bad.append("%s: path %s != %s" % (rid, path, m["path"]))
have = m.get("parameters", {})
mine = decode(params)
if set(have) != set(mine):
bad.append("%s: parameter names differ %s" % (rid, sorted(set(have) ^ set(mine))))
for pn, mark in mine.items():
p = have.get(pn)
if not p:
continue
if ("@" in mark) != (p.get("location") == "path"):
bad.append("%s: %s location" % (rid, pn))
if p.get("location") != "path" and ("!" in mark) != bool(p.get("required")):
bad.append("%s: %s required" % (rid, pn))
if ("#" in mark) != (p.get("type") in ("integer", "number")):
bad.append("%s: %s number" % (rid, pn))
if ("?" in mark) != (p.get("type") == "boolean"):
bad.append("%s: %s boolean" % (rid, pn))
if ("*" in mark) != bool(p.get("repeated")):
bad.append("%s: %s repeated" % (rid, pn))
ref = m.get("request", {}).get("$ref", "")
if ref != body:
bad.append("%s: request schema %r != %r" % (rid, body, ref))
if body:
props = ",".join(sorted(doc["schemas"][body].get("properties", {})))
if schemas.get((name, body)) != props:
bad.append("%s: schema %s fields differ" % (rid, body))
if items:
rprops = doc["schemas"].get(m.get("response", {}).get("$ref"), {}).get("properties", {})
if rprops.get(items, {}).get("type") != "array":
bad.append("%s: items key %s is not an array" % (rid, items))
f = ""
if m.get("supportsMediaUpload"):
f += "u"
if m.get("supportsMediaDownload"):
f += "d"
if "response" not in m:
f += "b"
if f != flags:
bad.append("%s: flags %r != %r" % (rid, flags, f))
if http == "GET" and kind != "r":
bad.append("%s: GET must be a read" % rid)
if http == "DELETE" and kind != "d":
bad.append("%s: DELETE must be destructive" % rid)
if kind == "r" and http != "GET" and rid not in POST_READS:
bad.append("%s: non-GET read not on the allowlist" % rid)
if bad:
print("\n".join(bad))
print("discovery MISMATCH: %d findings" % len(bad))
return 1
print("discovery ok: %d apis, %d calls, %d request schemas" % (len(apis), total, len(schemas)))
return 0
if __name__ == "__main__":
sys.exit(main())
+194
View File
@@ -0,0 +1,194 @@
#!/usr/bin/env python3
"""Generate src/google/workspace/call_table.cpp from Google's Discovery documents.
Every Discovery method of the twenty Workspace APIs becomes one row; nothing is
typed by hand. Python 3 stdlib only, no credentials.
python3 -I src/google/workspace/tools/gen_calls.py # rewrite the table
python3 -I src/google/workspace/tools/gen_calls.py --list # print kind per row
tools/check_discovery.py then proves the committed table still matches Google.
"""
import json
import os
import sys
import urllib.request
HERE = os.path.dirname(os.path.abspath(__file__))
OUT = os.path.join(HERE, "..", "call_table.cpp")
# api name -> (Discovery id, Discovery URL, API service name to enable)
APIS = [
("gmail", "gmail:v1", "https://gmail.googleapis.com/$discovery/rest?version=v1", "gmail.googleapis.com"),
("drive", "drive:v3", "https://www.googleapis.com/discovery/v1/apis/drive/v3/rest", "drive.googleapis.com"),
("calendar", "calendar:v3", "https://calendar-json.googleapis.com/$discovery/rest?version=v3", "calendar-json.googleapis.com"),
("sheets", "sheets:v4", "https://sheets.googleapis.com/$discovery/rest?version=v4", "sheets.googleapis.com"),
("docs", "docs:v1", "https://docs.googleapis.com/$discovery/rest?version=v1", "docs.googleapis.com"),
("slides", "slides:v1", "https://slides.googleapis.com/$discovery/rest?version=v1", "slides.googleapis.com"),
("forms", "forms:v1", "https://forms.googleapis.com/$discovery/rest?version=v1", "forms.googleapis.com"),
("tasks", "tasks:v1", "https://tasks.googleapis.com/$discovery/rest?version=v1", "tasks.googleapis.com"),
("chat", "chat:v1", "https://chat.googleapis.com/$discovery/rest?version=v1", "chat.googleapis.com"),
("meet", "meet:v2", "https://meet.googleapis.com/$discovery/rest?version=v2", "meet.googleapis.com"),
("people", "people:v1", "https://people.googleapis.com/$discovery/rest?version=v1", "people.googleapis.com"),
("keep", "keep:v1", "https://keep.googleapis.com/$discovery/rest?version=v1", "keep.googleapis.com"),
("classroom", "classroom:v1", "https://classroom.googleapis.com/$discovery/rest?version=v1", "classroom.googleapis.com"),
("youtube", "youtube:v3", "https://youtube.googleapis.com/$discovery/rest?version=v3", "youtube.googleapis.com"),
("youtubeanalytics", "youtubeAnalytics:v2", "https://youtubeanalytics.googleapis.com/$discovery/rest?version=v2", "youtubeanalytics.googleapis.com"),
("youtubereporting", "youtubereporting:v1", "https://youtubereporting.googleapis.com/$discovery/rest?version=v1", "youtubereporting.googleapis.com"),
("directory", "admin:directory_v1", "https://admin.googleapis.com/$discovery/rest?version=directory_v1", "admin.googleapis.com"),
("reports", "admin:reports_v1", "https://admin.googleapis.com/$discovery/rest?version=reports_v1", "admin.googleapis.com"),
("groupssettings", "groupssettings:v1", "https://groupssettings.googleapis.com/$discovery/rest?version=v1", "groupssettings.googleapis.com"),
("vault", "vault:v1", "https://vault.googleapis.com/$discovery/rest?version=v1", "vault.googleapis.com"),
]
# Row kinds: r read, w write, d destructive, s send (reaches other people).
# Explicit lists, so a reviewer can read what each kind means.
POST_READS = {
"calendar.freebusy.query",
"sheets.spreadsheets.getByDataFilter",
"sheets.spreadsheets.values.batchGetByDataFilter",
}
SENDS = {
"gmail.users.messages.send", "gmail.users.drafts.send",
"chat.spaces.messages.create", "chat.spaces.setup", "chat.spaces.members.create",
"chat.media.upload",
"classroom.invitations.create", "classroom.courses.announcements.create",
"classroom.courses.courseWork.create", "classroom.courses.courseWorkMaterials.create",
"classroom.courses.students.create", "classroom.courses.teachers.create",
"calendar.events.insert", "calendar.events.quickAdd", "calendar.events.import",
"calendar.events.update", "calendar.events.patch", "calendar.events.move",
"calendar.acl.insert",
"drive.permissions.create", "drive.permissions.update",
"youtube.comments.insert", "youtube.commentThreads.insert", "youtube.comments.setModerationStatus",
}
DESTROY_WORDS = ("delete", "batchDelete", "emptyTrash", "remove", "purge", "clear", "reject", "wipe")
DESTROY_IDS = {
"gmail.users.messages.trash", "gmail.users.threads.trash",
"directory.chromeosdevices.action", "directory.mobiledevices.action",
"directory.users.signOut", "directory.users.makeAdmin",
"vault.matters.close", "vault.matters.holds.removeHeldAccounts",
"vault.matters.holds.accounts.delete",
"sheets.spreadsheets.values.clear", "sheets.spreadsheets.values.batchClear",
"sheets.spreadsheets.values.batchClearByDataFilter",
"tasks.tasks.clear",
}
def methods(node, out):
for m in node.get("methods", {}).values():
out.append(m)
for child in node.get("resources", {}).values():
methods(child, out)
def kind_of(m):
rid = m["id"]
if rid in SENDS:
return "s"
last = rid.rsplit(".", 1)[1]
if m["httpMethod"] == "DELETE" or rid in DESTROY_IDS or any(
last == w or (last.startswith(w) and last[len(w):][:1].isupper()) for w in DESTROY_WORDS):
return "d"
if m["httpMethod"] == "GET" or rid in POST_READS:
return "r"
return "w"
def param_spec(m):
path_names, query = [], []
for name, p in m.get("parameters", {}).items():
t = p.get("type", "string")
mark = ""
if p.get("location") == "path":
mark += "@"
elif p.get("required"):
mark += "!"
if t in ("integer", "number"):
mark += "#"
elif t == "boolean":
mark += "?"
if p.get("repeated"):
mark += "*"
(path_names if p.get("location") == "path" else query).append(name + mark)
return ",".join(path_names + sorted(query))
def items_key(doc, m):
ref = m.get("response", {}).get("$ref")
if not ref or "pageToken" not in m.get("parameters", {}):
return ""
props = doc["schemas"].get(ref, {}).get("properties", {})
arrays = [k for k, v in props.items() if v.get("type") == "array"]
return arrays[0] if len(arrays) == 1 else ""
def flags_of(m):
f = ""
if m.get("supportsMediaUpload"):
f += "u"
if m.get("supportsMediaDownload"):
f += "d"
if "response" not in m:
f += "b" # no JSON response: the body is bytes (export, download)
return f
def cstr(s):
return '"' + s.replace("\\", "\\\\").replace('"', '\\"') + '"'
def fetch(url):
with urllib.request.urlopen(url, timeout=60) as r:
return json.load(r)
def main():
listing = "--list" in sys.argv
apis, rows, schemas = [], [], {}
for name, did, url, service in APIS:
doc = fetch(url)
scopes = list(doc.get("auth", {}).get("oauth2", {}).get("scopes", {}).keys())
readonly = [s for s in scopes if "readonly" in s or s.endswith(".metadata")]
base = (doc["rootUrl"] + doc["servicePath"]).rstrip("/")
apis.append((name, did, url, base, service, " ".join(scopes), " ".join(readonly), doc["revision"]))
ms = []
methods(doc, ms)
for m in sorted(ms, key=lambda x: x["id"]):
body = m.get("request", {}).get("$ref", "")
rows.append((m["id"], name, m["httpMethod"], m["path"], param_spec(m), body,
items_key(doc, m), kind_of(m), flags_of(m)))
if body:
schemas[(name, body)] = ",".join(sorted(doc["schemas"][body].get("properties", {}).keys()))
if listing:
print(kind_of(m), m["id"])
if listing:
return
lines = ['// GENERATED by tools/gen_calls.py from Google Discovery documents. Do not edit.',
'// Checked against Google by tools/check_discovery.py.',
'#include "google/workspace/calls.h"', '',
'namespace molo::google::workspace {', '',
'// APIS-BEGIN',
'const ApiSpec kApiTable[] = {']
for a in apis:
lines.append(" {" + ", ".join(cstr(x) for x in a) + "},")
lines += ['};', '// APIS-END', 'const std::size_t kApiTableSize = sizeof(kApiTable) / sizeof(kApiTable[0]);', '',
'// CALLS-BEGIN (one row per Discovery method; parsed by tools/check_discovery.py)',
'const CallSpec kCallTable[] = {']
for r in rows:
lines.append(" {" + ", ".join(cstr(x) for x in r) + "},")
lines += ['};', '// CALLS-END',
'const std::size_t kCallTableSize = sizeof(kCallTable) / sizeof(kCallTable[0]);', '',
'// SCHEMAS-BEGIN (top-level fields of every request body schema)',
'const SchemaSpec kSchemaTable[] = {']
for (api, ref), fields in sorted(schemas.items()):
lines.append(" {" + ", ".join(cstr(x) for x in (api, ref, fields)) + "},")
lines += ['};', '// SCHEMAS-END',
'const std::size_t kSchemaTableSize = sizeof(kSchemaTable) / sizeof(kSchemaTable[0]);', '',
'} // namespace molo::google::workspace', '']
with open(OUT, "w") as f:
f.write("\n".join(lines))
print("wrote %d apis, %d calls" % (len(apis), len(rows)))
if __name__ == "__main__":
main()
+135
View File
@@ -0,0 +1,135 @@
#include "google/workspace/workspace_api.h"
#include "google/errors.h"
#include "google/workspace/caps.h"
namespace molo::google::workspace {
namespace {
ServiceEndpoint endpoint_for(const std::string& api) {
const ApiSpec* spec = find_api(api);
if (!spec) throw GoogleError::invalid("unknown Workspace API " + api);
return ServiceEndpoint{spec->name, spec->base_url, false};
}
const char* kind_name(Kind k) {
switch (k) {
case Kind::kRead: return "read";
case Kind::kWrite: return "write";
case Kind::kDestroy: return "destroy";
case Kind::kSend: return "send";
}
return "?";
}
Json without_token(const Json& params) {
Json out = Json::object();
for (const auto& [k, v] : params.as_object())
if (k != "pageToken") out.set(k, v);
return out;
}
} // namespace
WorkspaceApi::WorkspaceApi(std::shared_ptr<GoogleClient> client, const std::string& api)
: Service(std::move(client), endpoint_for(api)), api_(find_api(api)) {}
Json WorkspaceApi::make_params(const ParamList& list) {
Json out = Json::object();
for (const auto& [k, v] : list) out.set(k, v);
return out;
}
PreparedCall WorkspaceApi::prepare(const std::string& id, const Json& params,
const Json* body) const {
const CallSpec* spec = find_call_in(api_->name, id);
if (!spec) {
const CallSpec* other = find_call(id);
if (other) throw GoogleError::invalid(id + " belongs to " + other->api + ", not " + api_->name);
throw GoogleError::invalid("unknown call " + id);
}
if (has_flag(*spec, 'b'))
throw GoogleError::invalid(id + " answers bytes, not JSON; not supported");
return PreparedCall::build(*spec, params, body);
}
Json WorkspaceApi::run(const std::string& id, Kind want, const Json& params,
const Json* body) const {
PreparedCall call = prepare(id, params, body);
Kind have = kind_of(*call.spec);
if (have != want)
throw GoogleError::invalid(id + " is a " + kind_name(have) + " call, use " + kind_name(have) + "()");
return client_->request(call.method, endpoint_, call.path, call.has_body ? &call.body : nullptr);
}
Json WorkspaceApi::read(const std::string& id, const Json& params, const Json* body) const {
return run(id, Kind::kRead, params, body);
}
Json WorkspaceApi::write(const std::string& id, const Json& params, const Json* body,
bool confirm) const {
prepare(id, params, body); // validation errors first
if (!confirm) throw GoogleError::invalid("write " + id + " needs confirm=true");
return run(id, Kind::kWrite, params, body);
}
Json WorkspaceApi::destroy(const std::string& id, const Json& params, bool confirm) const {
prepare(id, params, nullptr);
if (!confirm) throw GoogleError::invalid("destroy " + id + " needs confirm=true");
return run(id, Kind::kDestroy, params, nullptr);
}
Json WorkspaceApi::send(const std::string& id, const Json& params, const Json* body,
bool confirm) const {
prepare(id, params, body);
if (!confirm) throw GoogleError::invalid("send " + id + " needs confirm=true");
return run(id, Kind::kSend, params, body);
}
std::vector<Json> WorkspaceApi::pages(const std::string& id, const Json& params,
int max_pages) const {
if (max_pages < 1 || max_pages > WorkspaceCaps::kMaxPages)
throw GoogleError::invalid("max_pages must be 1 to 20");
if (!params.is_object()) throw GoogleError::invalid("params must be a JSON object");
PreparedCall first = prepare(id, without_token(params));
if (kind_of(*first.spec) != Kind::kRead)
throw GoogleError::invalid(id + " is not a read call, pages() walks reads only");
const Json* start = params.find("pageToken");
std::vector<Json> out;
std::string token = start && start->is_string() ? start->as_string() : "";
for (int i = 0; i < max_pages; ++i) {
std::string path = token.empty() ? first.path : first.path_with_token(token);
out.push_back(client_->request(first.method, endpoint_, path, nullptr));
const Json* next = out.back().find("nextPageToken");
if (!next || !next->is_string() || next->as_string().empty()) break;
token = next->as_string();
}
return out;
}
Listing WorkspaceApi::list(const std::string& id, const Json& params, int max_pages) const {
const CallSpec* spec = find_call_in(api_->name, id);
if (!spec) throw GoogleError::invalid("unknown call " + id);
if (!*spec->items_key) throw GoogleError::invalid(id + " has no single items array");
Listing out;
std::vector<Json> docs = pages(id, params, max_pages);
for (const Json& doc : docs) {
++out.pages;
const Json* arr = doc.find(spec->items_key);
if (arr && arr->is_array())
for (const Json& item : arr->as_array()) {
if (out.items.size() >= WorkspaceCaps::kMaxItems) {
out.truncated = true;
break;
}
out.items.push_back(item);
}
const Json* next = doc.find("nextPageToken");
out.next_page_token = next && next->is_string() ? next->as_string() : "";
}
if (!out.next_page_token.empty()) out.truncated = true;
return out;
}
} // namespace molo::google::workspace
+62
View File
@@ -0,0 +1,62 @@
#pragma once
// WorkspaceApi: one Workspace API (Gmail, Drive, ...) over the call table.
// Every call of the API is reachable by its Discovery method id. The method
// that runs it must match the call's kind, so a write never hides inside a
// read: read / write / destroy / send. The three side-effecting forms take an
// explicit `confirm` with no default; false throws before any traffic.
#include <memory>
#include <string>
#include <utility>
#include <vector>
#include "google/service.h"
#include "google/workspace/calls.h"
#include "google/workspace/prepared_call.h"
namespace molo::google::workspace {
using Json = clients::body::Json;
using ParamList = std::vector<std::pair<std::string, Json>>;
struct Listing {
std::vector<Json> items;
std::string next_page_token; // set when the walk stopped at a cap
int pages = 0;
bool truncated = false;
};
class WorkspaceApi : public Service {
public:
// Throws GoogleError (invalid) for an unknown API name.
WorkspaceApi(std::shared_ptr<GoogleClient> client, const std::string& api);
const ApiSpec& api() const { return *api_; }
// Validate only: what would be sent. Throws for an unknown id, an id of
// another API, or any invalid parameter or body field.
PreparedCall prepare(const std::string& id, const Json& params = Json::object(),
const Json* body = nullptr) const;
Json read(const std::string& id, const Json& params = Json::object(),
const Json* body = nullptr) const;
Json write(const std::string& id, const Json& params, const Json* body, bool confirm) const;
Json destroy(const std::string& id, const Json& params, bool confirm) const;
Json send(const std::string& id, const Json& params, const Json* body, bool confirm) const;
// Walks nextPageToken of a read call: at most max_pages pages (cap 20).
std::vector<Json> pages(const std::string& id, const Json& params = Json::object(),
int max_pages = 5) const;
// The same, collecting the response's array (CallSpec::items_key), at most
// 2000 items. Throws (invalid) when the call has no single items array.
Listing list(const std::string& id, const Json& params = Json::object(),
int max_pages = 5) const;
static Json make_params(const ParamList& list);
private:
Json run(const std::string& id, Kind want, const Json& params, const Json* body) const;
const ApiSpec* api_;
};
} // namespace molo::google::workspace
+89
View File
@@ -0,0 +1,89 @@
#include "google/workspace/workspace_client.h"
#include <set>
#include <sstream>
#include "clients/transports/http_transport.h"
#include "google/credentials.h"
#include "google/errors.h"
#include "google/workspace/caps.h"
namespace molo::google::workspace {
namespace {
std::vector<std::string> words(const char* text) {
std::vector<std::string> out;
std::istringstream in(text);
std::string w;
while (in >> w) out.push_back(w);
return out;
}
const ApiSpec& need(const std::string& api) {
const ApiSpec* spec = find_api(api);
if (!spec) throw GoogleError::invalid("unknown Workspace API " + api);
return *spec;
}
std::string subject_of(const WorkspaceOptions& o) {
if (o.delegation.active()) return o.delegation.subject;
return Credentials::env("GOOGLE_WORKSPACE_SUBJECT");
}
} // namespace
std::vector<std::string> Scopes::all_of(const std::string& api) { return words(need(api).scopes); }
std::vector<std::string> Scopes::readonly_of(const std::string& api) {
auto ro = words(need(api).readonly_scopes);
return ro.empty() ? all_of(api) : ro;
}
std::vector<std::string> Scopes::for_apis(const std::vector<std::string>& apis, bool readonly) {
if (apis.empty()) throw GoogleError::invalid("name at least one API");
std::vector<std::string> out;
std::set<std::string> seen;
for (const auto& a : apis)
for (const auto& s : readonly ? readonly_of(a) : all_of(a))
if (seen.insert(s).second) out.push_back(s);
if (out.size() > WorkspaceCaps::kMaxScopes)
throw GoogleError::invalid("these APIs need over 40 scopes together; name fewer APIs");
return out;
}
std::string WorkspaceAuth::mode_from_env(const WorkspaceOptions& options) {
if (!subject_of(options).empty()) return "delegated";
if (!Credentials::env("GOOGLE_ACCESS_TOKEN").empty()) return "user-token";
if (!Credentials::env("GOOGLE_APPLICATION_CREDENTIALS").empty()) return "service-account";
return "none";
}
std::shared_ptr<clients::Auth> WorkspaceAuth::from_env(const WorkspaceOptions& options) {
options.delegation.validate();
std::string subject = subject_of(options);
std::string mode = mode_from_env(options);
if (mode == "user-token") return Credentials::bearer(Credentials::env("GOOGLE_ACCESS_TOKEN"));
if (mode == "none") return nullptr;
std::string path = Credentials::env("GOOGLE_APPLICATION_CREDENTIALS");
if (path.empty())
throw GoogleError::invalid("a delegation subject needs GOOGLE_APPLICATION_CREDENTIALS");
Delegation d{subject};
return std::make_shared<DelegatedAuth>(ServiceAccountKey::load_file(path),
Scopes::for_apis(options.apis, options.readonly), d);
}
std::shared_ptr<GoogleClient> make_workspace_client(const WorkspaceOptions& options) {
return std::make_shared<GoogleClient>(std::make_unique<clients::transports::HttpTransport>(),
nullptr, WorkspaceAuth::from_env(options));
}
Workspace::Workspace(std::shared_ptr<GoogleClient> client) : client_(std::move(client)) {}
std::vector<std::string> Workspace::api_names() {
std::vector<std::string> out;
for (std::size_t i = 0; i < kApiTableSize; ++i) out.push_back(kApiTable[i].name);
return out;
}
} // namespace molo::google::workspace
+90
View File
@@ -0,0 +1,90 @@
#pragma once
// Credentials and client wiring for Workspace, and the Workspace facade.
//
// Scopes: Workspace APIs refuse the cloud-platform scope; each API has its own
// (see ApiSpec::scopes, full list per API in SPEC.md). `Scopes` selects the
// read-only subset by default.
//
// Credential choice (WorkspaceAuth::from_env), first match wins:
// 1. a delegation subject (option or GOOGLE_WORKSPACE_SUBJECT): the service
// account key in GOOGLE_APPLICATION_CREDENTIALS impersonates that user
// (domain-wide delegation). No key: GoogleError invalid.
// 2. GOOGLE_ACCESS_TOKEN: a user's OAuth token, used as is (its scopes were
// fixed when the user consented).
// 3. GOOGLE_APPLICATION_CREDENTIALS without subject: the service account
// itself (it owns no Workspace data; expect empty lists or 403).
// 4. nothing: null, every call throws NotConfiguredError.
#include <map>
#include <memory>
#include <string>
#include <vector>
#include "clients/auth.h"
#include "google/client.h"
#include "google/workspace/delegation.h"
#include "google/workspace/services.h"
namespace molo::google::workspace {
class Scopes {
public:
// Scope URLs of the named APIs. readonly: the read-only subset; an API
// without one (groupssettings) contributes its full scope.
// Throws GoogleError (invalid) for an unknown API, no API, or over 40 scopes.
static std::vector<std::string> for_apis(const std::vector<std::string>& apis, bool readonly);
static std::vector<std::string> all_of(const std::string& api);
static std::vector<std::string> readonly_of(const std::string& api);
};
struct WorkspaceOptions {
std::vector<std::string> apis; // which APIs the token must cover
bool readonly = true;
Delegation delegation; // typed `sub` option; empty: env, then none
};
class WorkspaceAuth {
public:
static std::shared_ptr<clients::Auth> from_env(const WorkspaceOptions& options);
// "delegated", "user-token", "service-account" or "none": for status pages.
static std::string mode_from_env(const WorkspaceOptions& options);
};
// GoogleClient over HttpTransport with the credential above.
std::shared_ptr<GoogleClient> make_workspace_client(const WorkspaceOptions& options);
// All twenty services over one client.
class Workspace {
public:
explicit Workspace(std::shared_ptr<GoogleClient> client);
// Any API by name (see api_names()).
WorkspaceApi api(const std::string& name) const { return WorkspaceApi(client_, name); }
static std::vector<std::string> api_names();
Gmail gmail() const { return Gmail(client_); }
Drive drive() const { return Drive(client_); }
Calendar calendar() const { return Calendar(client_); }
Sheets sheets() const { return Sheets(client_); }
Docs docs() const { return Docs(client_); }
Slides slides() const { return Slides(client_); }
Forms forms() const { return Forms(client_); }
Tasks tasks() const { return Tasks(client_); }
Chat chat() const { return Chat(client_); }
Meet meet() const { return Meet(client_); }
People people() const { return People(client_); }
Keep keep() const { return Keep(client_); }
Classroom classroom() const { return Classroom(client_); }
YouTube youtube() const { return YouTube(client_); }
YouTubeAnalytics youtube_analytics() const { return YouTubeAnalytics(client_); }
YouTubeReporting youtube_reporting() const { return YouTubeReporting(client_); }
Directory directory() const { return Directory(client_); }
Reports reports() const { return Reports(client_); }
GroupsSettings groups_settings() const { return GroupsSettings(client_); }
Vault vault() const { return Vault(client_); }
private:
std::shared_ptr<GoogleClient> client_;
};
} // namespace molo::google::workspace