feat(youtube): add YouTube Data API v3 support

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## 0.12.0 - Unreleased
 
 ### Added
+- YouTube: add `youtube` (alias `yt`) command group for YouTube Data API v3 — list activities, videos, playlists, comment threads, and channels; API key via config `youtube_api_key` or `GOG_YOUTUBE_API_KEY`; OAuth for “mine” with `gog auth add ... --services youtube`.
 - Sheets: add `sheets insert` to insert rows/columns into a sheet. (#203) — thanks @andybergon.
 - Gmail: add `watch serve --history-types` filtering (`messageAdded|messageDeleted|labelAdded|labelRemoved`) and include `deletedMessageIds` in webhook payloads. (#168) — thanks @salmonumbrella.
 - Contacts: support `--org`, `--title`, `--url`, `--note`, and `--custom` on create/update; include custom fields in get output with deterministic ordering. (#199) — thanks @phuctm97.

README.md

@@ -3,7 +3,7 @@
 ![GitHub Repo Banner](https://ghrb.waren.build/banner?header=gogcli%F0%9F%A7%AD&subheader=Google+in+your+terminal&bg=f3f4f6&color=1f2937&support=true)
 <!-- Created with GitHub Repo Banner by Waren Gonzaga: https://ghrb.waren.build -->
 
-Fast, script-friendly CLI for Gmail, Calendar, Chat, Classroom, Drive, Docs, Slides, Sheets, Forms, Apps Script, Contacts, Tasks, People, Groups (Workspace), and Keep (Workspace-only). JSON-first output, multiple accounts, and least-privilege auth built in.
+Fast, script-friendly CLI for Gmail, Calendar, Chat, Classroom, Drive, Docs, Slides, Sheets, Forms, Apps Script, Contacts, Tasks, People, Groups (Workspace), Keep (Workspace-only), and YouTube. JSON-first output, multiple accounts, and least-privilege auth built in.
 
 ## Features
 
@@ -22,6 +22,7 @@ Fast, script-friendly CLI for Gmail, Calendar, Chat, Classroom, Drive, Docs, Sli
 - **People** - access profile information
 - **Keep (Workspace only)** - list/get/search notes and download attachments (service account + domain-wide delegation)
 - **Groups** - list groups you belong to, view group members (Google Workspace)
+- **YouTube** - list activities, videos, playlists, comment threads, and channels (API key or OAuth for “mine”)
 - **Local time** - quick local/UTC time display for scripts and agents
 - **Multiple accounts** - manage multiple Google accounts simultaneously (with aliases)
 - **Command allowlist** - restrict top-level commands for sandboxed/agent runs
@@ -87,6 +88,7 @@ Before adding an account, create OAuth2 credentials from Google Cloud Console:
    - Google Forms API: https://console.cloud.google.com/apis/api/forms.googleapis.com
    - Apps Script API: https://console.cloud.google.com/apis/api/script.googleapis.com
    - Cloud Identity API (Groups): https://console.cloud.google.com/apis/api/cloudidentity.googleapis.com
+   - YouTube Data API v3 (YouTube): https://console.cloud.google.com/apis/api/youtube.googleapis.com
 3. Configure OAuth consent screen: https://console.cloud.google.com/auth/branding
 4. If your app is in "Testing", add test users: https://console.cloud.google.com/auth/audience
 5. Create OAuth client:
@@ -356,6 +358,7 @@ Service scope matrix (auto-generated; run `go run scripts/gen-auth-services-md.g
 | appscript | yes | Apps Script API | `https://www.googleapis.com/auth/script.projects`<br>`https://www.googleapis.com/auth/script.deployments`<br>`https://www.googleapis.com/auth/script.processes` |  |
 | groups | no | Cloud Identity API | `https://www.googleapis.com/auth/cloud-identity.groups.readonly` | Workspace only |
 | keep | no | Keep API | `https://www.googleapis.com/auth/keep.readonly` | Workspace only; service account (domain-wide delegation) |
+| youtube | yes | YouTube Data API v3 | `https://www.googleapis.com/auth/youtube.readonly` | Most read operations also work with API key only (config youtube_api_key or GOG_YOUTUBE_API_KEY) |
 <!-- auth-services:end -->
 
 ### Service Accounts (Workspace only)
@@ -416,7 +419,8 @@ gog keep get <noteId> --account you@yourdomain.com
 - `GOG_PLAIN` - Default plain output
 - `GOG_COLOR` - Color mode: `auto` (default), `always`, or `never`
 - `GOG_TIMEZONE` - Default output timezone for Calendar/Gmail (IANA name, `UTC`, or `local`)
-- `GOG_ENABLE_COMMANDS` - Comma-separated allowlist of top-level commands (e.g., `calendar,tasks`)
+- `GOG_ENABLE_COMMANDS` - Comma-separated allowlist of top-level commands (e.g., `calendar,tasks,youtube`)
+- `GOG_YOUTUBE_API_KEY` - YouTube Data API key (overrides config `youtube_api_key` when set)
 
 ### Config File (JSON5)
 
@@ -436,6 +440,8 @@ Example (JSON5 supports comments and trailing commas):
   keyring_backend: "file",
   // Default output timezone for Calendar/Gmail (IANA, UTC, or local)
   default_timezone: "UTC",
+  // YouTube Data API key (optional; or set GOG_YOUTUBE_API_KEY)
+  // youtube_api_key: "YOUR_KEY",
   // Optional account aliases
   account_aliases: {
     work: "work@company.com",
@@ -951,6 +957,43 @@ gog tasks clear <tasklistId>
 # See docs/dates.md for all supported date/time input formats across commands.
 ```
 
+### YouTube
+
+YouTube Data API commands use an **API key** for public data (by channel/video/playlist ID). For “mine” (your channel, playlists, activities), use OAuth with `-a` and `gog auth add ... --services youtube`.
+
+Set an API key (create one in [Google Cloud Console](https://console.cloud.google.com/apis/credentials) after enabling YouTube Data API v3):
+
+```bash
+gog config set youtube_api_key YOUR_API_KEY
+# or
+export GOG_YOUTUBE_API_KEY=YOUR_API_KEY
+```
+
+```bash
+# Activities (channel feed)
+gog yt activities list --channel-id UC_x5XG1OV2P6uZZ5FSM9Ttw --max 10
+gog yt activities list --mine -a you@gmail.com    # OAuth
+
+# Videos
+gog yt videos list --id dQw4w9WgXcQ
+gog yt videos list --chart mostPopular --region US --max 5
+
+# Playlists
+gog yt playlists list --channel-id UC_x5XG1OV2P6uZZ5FSM9Ttw
+gog yt playlists list --mine -a you@gmail.com   # OAuth
+
+# Comment threads
+gog yt comments list --video-id VIDEO_ID --max 20
+gog yt comments list --channel-id CHANNEL_ID
+
+# Channels
+gog yt channels list --id UC_x5XG1OV2P6uZZ5FSM9Ttw
+gog yt channels list --mine -a you@gmail.com    # OAuth
+
+# JSON output
+gog yt channels list --id UC_x5XG1OV2P6uZZ5FSM9Ttw --json
+```
+
 ### Sheets
 
 ```bash
@@ -1508,6 +1551,7 @@ MIT
 - [Google Drive API Documentation](https://developers.google.com/drive)
 - [Google People API Documentation](https://developers.google.com/people)
 - [Google Tasks API Documentation](https://developers.google.com/tasks)
+- [YouTube Data API Documentation](https://developers.google.com/youtube/v3)
 - [Google Sheets API Documentation](https://developers.google.com/sheets)
 - [Cloud Identity API Documentation](https://cloud.google.com/identity/docs/reference/rest)
 

internal/cmd/contacts_crud.go

@@ -247,7 +247,7 @@ func contactsURLs(values []string) []*people.Url {
 	return out
 }
 
-func contactsApplyPersonName(person *people.Person, givenSet bool, given, familySet bool, family string) {
+func contactsApplyPersonName(person *people.Person, givenSet bool, given string, familySet bool, family string) {
 	curGiven := ""
 	curFamily := ""
 	if len(person.Names) > 0 && person.Names[0] != nil {
@@ -263,7 +263,7 @@ func contactsApplyPersonName(person *people.Person, givenSet bool, given, family
 	person.Names = []*people.Name{{GivenName: curGiven, FamilyName: curFamily}}
 }
 
-func contactsApplyPersonOrganization(person *people.Person, orgSet bool, org, titleSet bool, title string) {
+func contactsApplyPersonOrganization(person *people.Person, orgSet bool, org string, titleSet bool, title string) {
 	curOrg := ""
 	curTitle := ""
 	if len(person.Organizations) > 0 && person.Organizations[0] != nil {

internal/cmd/root.go

@@ -29,7 +29,7 @@ const (
 
 type RootFlags struct {
 	Color          string `help:"Color output: auto|always|never" default:"${color}"`
-	Account        string `help:"Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript)" aliases:"acct" short:"a"`
+	Account        string `help:"Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/youtube)" aliases:"acct" short:"a"`
 	Client         string `help:"OAuth client name (selects stored credentials + token bucket)" default:"${client}"`
 	EnableCommands string `help:"Comma-separated list of enabled top-level commands (restricts CLI)" default:"${enabled_commands}"`
 	JSON           bool   `help:"Output JSON to stdout (best for scripting)" default:"${json}" aliases:"machine" short:"j"`
@@ -77,6 +77,7 @@ type CLI struct {
 	Sheets     SheetsCmd             `cmd:"" aliases:"sheet" help:"Google Sheets"`
 	Forms      FormsCmd              `cmd:"" aliases:"form" help:"Google Forms"`
 	AppScript  AppScriptCmd          `cmd:"" name:"appscript" aliases:"script,apps-script" help:"Google Apps Script"`
+	YouTube    YouTubeCmd            `cmd:"" aliases:"yt" help:"YouTube Data API (activities, videos, playlists, comments, channels)"`
 	Config     ConfigCmd             `cmd:"" help:"Manage configuration"`
 	ExitCodes  AgentExitCodesCmd     `cmd:"" name:"exit-codes" aliases:"exitcodes" help:"Print stable exit codes (alias for 'agent exit-codes')"`
 	Agent      AgentCmd              `cmd:"" help:"Agent-friendly helpers"`
@@ -324,7 +325,7 @@ func newParser(description string) (*kong.Kong, *CLI, error) {
 }
 
 func baseDescription() string {
-	return "Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script"
+	return "Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/YouTube"
 }
 
 func helpDescription() string {