Google Slides API 技能：自动化创建和管理演示文稿的完整指南

google-slides by odyssey4me/agent-skills

124 周安装量

2 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/odyssey4me/agent-skills --skill google-slides

办公软件自动化 API

🇨🇳中文介绍

Google Slides

与 Google Slides 交互，用于演示文稿创建、幻灯片管理和内容插入。

安装

依赖项：pip install --user google-auth google-auth-oauthlib google-api-python-client keyring pyyaml

设置验证

安装后，验证技能是否已正确配置：

$SKILL_DIR/scripts/google-slides.py check

这将检查：

Python 依赖项 (google-auth, google-auth-oauthlib, google-api-python-client, keyring, pyyaml)
身份验证配置
与 Google Slides API 的连接性

如果缺少任何内容，检查命令将提供设置说明。

身份验证

Google Slides 使用 OAuth 2.0 进行身份验证。完整的设置说明，请参阅：

GCP 项目设置指南 - 创建项目，启用 Slides API
Google OAuth 设置指南 - 配置凭据

快速开始

创建 ~/.config/agent-skills/google.yaml：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

创建简单演示文稿

# 创建演示文稿
$SKILL_DIR/scripts/google-slides.py presentations create --title "Team Update"

# 验证创建并获取默认幻灯片 ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# 添加标题文本
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "Q4 Team Update" \
  --x 50 --y 50 --width 600 --height 100

# 添加副标题
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "December 2024" \
  --x 50 --y 180 --width 600 --height 50

# 验证内容是否正确插入
$SKILL_DIR/scripts/google-slides.py presentations read $PRES_ID

构建多幻灯片演示文稿

#!/bin/bash
PRES_ID="your-presentation-id"

# 添加内容幻灯片
$SKILL_DIR/scripts/google-slides.py slides create $PRES_ID --layout TITLE_AND_BODY

# 验证幻灯片已添加并获取其 ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# 添加标题
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "Key Metrics" \
  --x 50 --y 30 --width 600 --height 60

# 添加图表图片
$SKILL_DIR/scripts/google-slides.py images create $PRES_ID \
  --slide-id $SLIDE_ID \
  --image-url "https://example.com/metrics.png" \
  --x 100 --y 120 --width 500 --height 350

# 添加另一个带形状的幻灯片
$SKILL_DIR/scripts/google-slides.py slides create $PRES_ID --layout BLANK

# 验证并获取新幻灯片 ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# 添加装饰形状
$SKILL_DIR/scripts/google-slides.py shapes create $PRES_ID \
  --slide-id $SLIDE2_ID \
  --shape-type STAR_5 \
  --x 550 --y 30 --width 80 --height 80

# 验证最终演示文稿内容
$SKILL_DIR/scripts/google-slides.py presentations read $PRES_ID

从数据创建演示文稿

#!/bin/bash

# 创建演示文稿
$SKILL_DIR/scripts/google-slides.py presentations create --title "Sales Report"

# 验证创建
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# 为每个区域添加一个幻灯片
$SKILL_DIR/scripts/google-slides.py slides create $PRES_ID --layout TITLE_AND_BODY

# 验证幻灯片已添加并获取其 ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# 使用上面输出中的幻灯片 ID 在每个幻灯片上插入文本
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "North Region Sales" \
  --x 50 --y 30 --width 600 --height 80

# 验证内容
$SKILL_DIR/scripts/google-slides.py presentations read $PRES_ID

Google Slides 使用点进行定位和尺寸设定：

1 点 = 1/72 英寸
1 英寸 = 72 点
原点 (0, 0) 位于左上角
标准幻灯片尺寸：720 x 540 点 (10 x 7.5 英寸)

常见参考位置：

(0, 0)                                    (720, 0)
  ┌───────────────────────────────────────┐
  │  标题区域                             │
  │  (50, 50, 620, 80)                    │
  │                                       │
  │  内容区域                             │
  │  (50, 150, 620, 350)                  │
  │                                       │
  │                                       │
  └───────────────────────────────────────┘
(0, 540)                                (720, 540)

身份验证和作用域错误不可重试。 如果命令因身份验证错误、作用域不足错误或权限被拒绝错误（退出代码 1）而失败，请停止并通知用户。不要重试或尝试自主修复问题 — 这些错误需要用户交互（基于浏览器的 OAuth 同意）。请引导用户查看 OAuth 故障排除指南。

可重试错误：速率限制（HTTP 429）和临时服务器错误（HTTP 5xx）可能在短暂等待后重试成功。所有其他错误都应报告给用户。

此技能需要进行结构化输入/输出的 API 调用。建议使用标准能力模型。

找不到演示文稿

确保您使用的是来自 URL 的正确演示文稿 ID：

URL：https://docs.google.com/presentation/d/1abc...xyz/edit
演示文稿 ID：1abc...xyz

图片 URL 必须：

可公开访问（无需身份验证），或
可供您正在使用的 Google 账户访问

在浏览器中测试 URL。如果需要身份验证，您需要：

将图片上传到 Google Drive
使其可公开访问或与您的 Google 账户共享
使用 Google Drive URL

高级用法，请参阅：

🇺🇸English

Google Slides

Interact with Google Slides for presentation creation, slide management, and content insertion.

Installation

Dependencies : pip install --user google-auth google-auth-oauthlib google-api-python-client keyring pyyaml

Setup Verification

After installation, verify the skill is properly configured:

$SKILL_DIR/scripts/google-slides.py check

This will check:

Python dependencies (google-auth, google-auth-oauthlib, google-api-python-client, keyring, pyyaml)
Authentication configuration
Connectivity to Google Slides API

If anything is missing, the check command will provide setup instructions.

Authentication

Google Slides uses OAuth 2.0 for authentication. For complete setup instructions, see:

GCP Project Setup Guide - Create project, enable Slides API
Google OAuth Setup Guide - Configure credentials

Quick Start

Create ~/.config/agent-skills/google.yaml:

oauth_client: client_id: your-client-id.apps.googleusercontent.com client_secret: your-client-secret
Run $SKILL_DIR/scripts/google-slides.py check to trigger OAuth flow and verify setup.

On scope or authentication errors, see the OAuth troubleshooting guide.

Script Usage

See permissions.md for read/write classification of each command.

# Setup and auth
$SKILL_DIR/scripts/google-slides.py check
$SKILL_DIR/scripts/google-slides.py auth setup --client-id ID --client-secret SECRET
$SKILL_DIR/scripts/google-slides.py auth reset
$SKILL_DIR/scripts/google-slides.py auth status

# Presentations
$SKILL_DIR/scripts/google-slides.py presentations create --title "Title"
$SKILL_DIR/scripts/google-slides.py presentations get PRESENTATION_ID
$SKILL_DIR/scripts/google-slides.py presentations read PRESENTATION_ID [--format text|pdf] [--output PATH]

# Slides — use presentations get to find slide IDs
$SKILL_DIR/scripts/google-slides.py slides create PRESENTATION_ID --layout LAYOUT [--index N]
$SKILL_DIR/scripts/google-slides.py slides delete PRESENTATION_ID --slide-id SLIDE_ID

# Content — coordinates are in points; origin (0,0) is top-left
$SKILL_DIR/scripts/google-slides.py text insert PRESENTATION_ID --slide-id ID --text "..." [--x N --y N --width N --height N]
$SKILL_DIR/scripts/google-slides.py shapes create PRESENTATION_ID --slide-id ID --shape-type TYPE [--x N --y N --width N --height N]
$SKILL_DIR/scripts/google-slides.py images create PRESENTATION_ID --slide-id ID --image-url URL [--x N --y N --width N --height N]

See command-reference.md for full argument details and examples.

Examples

Create a simple presentation

# Create presentation
$SKILL_DIR/scripts/google-slides.py presentations create --title "Team Update"

# Verify creation and get the default slide ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# Add title text
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "Q4 Team Update" \
  --x 50 --y 50 --width 600 --height 100

# Add subtitle
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "December 2024" \
  --x 50 --y 180 --width 600 --height 50

# Verify content was inserted correctly
$SKILL_DIR/scripts/google-slides.py presentations read $PRES_ID

Build a multi-slide presentation

#!/bin/bash
PRES_ID="your-presentation-id"

# Add content slide
$SKILL_DIR/scripts/google-slides.py slides create $PRES_ID --layout TITLE_AND_BODY

# Verify slide was added and get its ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# Add title
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "Key Metrics" \
  --x 50 --y 30 --width 600 --height 60

# Add chart image
$SKILL_DIR/scripts/google-slides.py images create $PRES_ID \
  --slide-id $SLIDE_ID \
  --image-url "https://example.com/metrics.png" \
  --x 100 --y 120 --width 500 --height 350

# Add another slide with shapes
$SKILL_DIR/scripts/google-slides.py slides create $PRES_ID --layout BLANK

# Verify and get the new slide ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# Add decorative shape
$SKILL_DIR/scripts/google-slides.py shapes create $PRES_ID \
  --slide-id $SLIDE2_ID \
  --shape-type STAR_5 \
  --x 550 --y 30 --width 80 --height 80

# Verify final presentation content
$SKILL_DIR/scripts/google-slides.py presentations read $PRES_ID

Create presentation from data

#!/bin/bash

# Create presentation
$SKILL_DIR/scripts/google-slides.py presentations create --title "Sales Report"

# Verify creation
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# Add a slide for each region
$SKILL_DIR/scripts/google-slides.py slides create $PRES_ID --layout TITLE_AND_BODY

# Verify slide was added and get its ID
$SKILL_DIR/scripts/google-slides.py presentations get $PRES_ID

# Insert text on each slide using the slide ID from the output above
$SKILL_DIR/scripts/google-slides.py text insert $PRES_ID \
  --slide-id $SLIDE_ID \
  --text "North Region Sales" \
  --x 50 --y 30 --width 600 --height 80

# Verify content
$SKILL_DIR/scripts/google-slides.py presentations read $PRES_ID

Coordinate System

Google Slides uses points for positioning and sizing:

1 point = 1/72 inch
1 inch = 72 points
Origin (0, 0) is at the top-left corner
Standard slide size: 720 x 540 points (10 x 7.5 inches)

Common reference positions:

(0, 0)                                    (720, 0)
  ┌───────────────────────────────────────┐
  │  Title area                           │
  │  (50, 50, 620, 80)                    │
  │                                       │
  │  Content area                         │
  │  (50, 150, 620, 350)                  │
  │                                       │
  │                                       │
  └───────────────────────────────────────┘
(0, 540)                                (720, 540)

Error Handling

Authentication and scope errors are not retryable. If a command fails with an authentication error, insufficient scope error, or permission denied error (exit code 1), stop and inform the user. Do not retry or attempt to fix the issue autonomously — these errors require user interaction (browser-based OAuth consent). Point the user to the OAuth troubleshooting guide.

Retryable errors : Rate limiting (HTTP 429) and temporary server errors (HTTP 5xx) may succeed on retry after a brief wait. All other errors should be reported to the user.

Model Guidance

This skill makes API calls requiring structured input/output. A standard-capability model is recommended.

Troubleshooting

Cannot find presentation

Make sure you're using the correct presentation ID from the URL:

URL: https://docs.google.com/presentation/d/1abc...xyz/edit
Presentation ID: 1abc...xyz

Image not appearing

The image URL must be:

Publicly accessible (no authentication required), OR
Accessible to the Google account you're using

Test the URL in a browser. If it requires authentication, you'll need to:

Upload the image to Google Drive
Make it publicly accessible or share it with your Google account
Use the Google Drive URL

API Reference

For advanced usage, see:

Weekly Installs

116

Repository

odyssey4me/agent-skills

GitHub Stars

First Seen

Jan 27, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

opencode101

gemini-cli98

claude-code94

github-copilot93

cursor92

codex92

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

44,900 周安装

Google Slides API 技能：自动化创建和管理演示文稿的完整指南

🇨🇳中文介绍

Google Slides

安装

设置验证

身份验证

快速开始

相关 Skills

脚本使用

示例

创建简单演示文稿

构建多幻灯片演示文稿

从数据创建演示文稿

坐标系

错误处理

模型指导

故障排除

找不到演示文稿

图片未显示

API 参考

🇺🇸English

Google Slides

Installation

Setup Verification

Authentication

Quick Start

Script Usage

Examples

Create a simple presentation

Build a multi-slide presentation

Create presentation from data

Coordinate System

Error Handling

Model Guidance

Troubleshooting

Cannot find presentation

Image not appearing

API Reference

最新 Skills