feat(clients): workspace: 20 Workspace APIs from Discovery, delegation sub claim, demo
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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
|
||||
Reference in New Issue
Block a user