首页 专区 文章 专题 AI工具 学习 编程手册

PHP MySQL jquery HTML CSS
首页 > Skill > 内容创作

Google Slides

Polar Sponsor
爱发电 赞助
.NET 9.0
立即下载

通过托管OAuth集成Google Slides API，创建演示文稿、添加幻灯片、插入内容并管理幻灯片格式。当用户想要创建演示文稿时使用此技能。

Google 幻灯片

功能概述

Google 幻灯片是一项面向实际任务的技能，主要用于使用管理 OAuth 认证的 Google 幻灯片 API；创建和管理演示文稿, 添加幻灯片, 插入文本和图像, 以及控制格式化；

核心要点

  • @ 快速启动；
  • Base URL.。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Google Slides

通过托管的 OAuth 认证访问 Google Slides API。创建和管理演示文稿、添加幻灯片、插入文本与图片，并控制格式设置。

快速开始

# 创建一个新的演示文稿
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'title': 'My Presentation'}).encode()
req = urllib.request.Request('https://api.maton.ai/google-slides/v1/presentations', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础 URL

https://api.maton.ai/google-slides/{native-api-path}

Maton 将请求代理至 slides.googleapis.com，并自动注入您的 OAuth 令牌。

认证

所有请求均需在 Authorization 请求头中提供 Maton API 密钥：

Authorization: Bearer $MATON_API_KEY

环境变量：将您的 API 密钥设为 MATON_API_KEY：

export MATON_API_KEY="YOUR_API_KEY"

获取您的 API 密钥

  1. 在 maton.ai 登录或注册账户
  2. 访问 maton.ai/settings
  3. 复制您的 API 密钥

连接管理

在 https://api.maton.ai 管理您的 Google OAuth 连接。

列出连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=google-slides&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'google-slides'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应示例：

{
  "connection": {
    "connection_id": "{connection_id}",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "google-slides",
    "metadata": {}
  }
}

在浏览器中打开返回的 url 以完成 OAuth 授权流程。

删除连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

若您拥有多个 Google Slides 连接，请使用 Maton-Connection 请求头指定所用连接：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'title': 'My Presentation'}).encode()
req = urllib.request.Request('https://api.maton.ai/google-slides/v1/presentations', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
req.add_header('Maton-Connection', '{connection_id}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

当存在多个连接时，务必始终包含该请求头，以确保请求被路由至目标账户。

安全与权限

  • 访问范围限定于已连接 Google Slides 账户内的演示文稿、幻灯片及其内容。
  • 所有写入操作均需用户显式授权。 在执行任何创建、更新或删除调用前，必须向用户确认目标资源及预期变更效果。

API 参考

演示文稿（Presentations）

创建演示文稿

POST /google-slides/v1/presentations
Content-Type: application/json

{
  "title": "My Presentation"
}

获取演示文稿

GET /google-slides/v1/presentations/{presentationId}

页面（幻灯片，Pages）

获取页面

GET /google-slides/v1/presentations/{presentationId}/pages/{pageId}

获取页面缩略图

GET /google-slides/v1/presentations/{presentationId}/pages/{pageId}/thumbnail

自定义尺寸：

GET /google-slides/v1/presentations/{presentationId}/pages/{pageId}/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=LARGE

批量更新（Batch Update）

大多数修改操作均通过 batchUpdate 接口完成。该接口接收一个请求数组，并以原子方式应用全部请求。

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [...]
}

创建幻灯片

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "createSlide": {
        "objectId": "slide_001",
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_BODY"
        }
      }
    }
  ]
}

可用的预定义版式：

  • BLANK
  • TITLE
  • TITLE_AND_BODY
  • TITLE_AND_TWO_COLUMNS
  • TITLE_ONLY
  • SECTION_HEADER
  • ONE_COLUMN_TEXT
  • MAIN_POINT
  • BIG_NUMBER

插入文本

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "insertText": {
        "objectId": "{shapeId}",
        "text": "Hello, World!",
        "insertionIndex": 0
      }
    }
  ]
}

删除文本

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "deleteText": {
        "objectId": "{shapeId}",
        "textRange": {
          "type": "ALL"
        }
      }
    }
  ]
}

创建形状

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "createShape": {
        "objectId": "shape_001",
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId": "{slideId}",
          "size": {
            "width": {"magnitude": 300, "unit": "PT"},
            "height": {"magnitude": 100, "unit": "PT"}
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 100,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

创建图片

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "createImage": {
        "objectId": "image_001",
        "url": "https://example.com/image.png",
        "elementProperties": {
          "pageObjectId": "{slideId}",
          "size": {
            "width": {"magnitude": 200, "unit": "PT"},
            "height": {"magnitude": 200, "unit": "PT"}
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 200,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

删除对象

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "deleteObject": {
        "objectId": "{objectId}"
      }
    }
  ]
}

更新文本样式

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "updateTextStyle": {
        "objectId": "{shapeId}",
        "textRange": {
          "type": "ALL"
        },
        "style": {
          "bold": true,
          "fontSize": {"magnitude": 24, "unit": "PT"},
          "foregroundColor": {
            "opaqueColor": {
              "rgbColor": {"red": 0.2, "green": 0.4, "blue": 0.8}
            }
          }
        },
        "fields": "bold,fontSize,foregroundColor"
      }
    }
  ]
}

替换全部文本

POST /google-slides/v1/presentations/{presentationId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "replaceAllText": {
        "containsText": {
          "text": "{{placeholder}}",
          "matchCase": true
        },
        "replaceText": "Actual Value"
      }
    }
  ]
}

代码示例

JavaScript

// 创建一个演示文稿
const response = await fetch(
  'https://api.maton.ai/google-slides/v1/presentations',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    },
    body: JSON.stringify({ title: 'My Presentation' })
  }
);

const presentation = await response.json();
const presentationId = presentation.presentationId;

// 添加一张幻灯片
await fetch(
  `https://api.maton.ai/google-slides/v1/presentations/${presentationId}:batchUpdate`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    },
    body: JSON.stringify({
      requests: [
        {
          createSlide: {
            slideLayoutReference: { predefinedLayout: 'TITLE_AND_BODY' }
          }
        }
      ]
    })
  }
);

Python

import os
import requests

headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'
}

# 创建一个演示文稿
response = requests.post(
    'https://api.maton.ai/google-slides/v1/presentations',
    headers=headers,
    json={'title': 'My Presentation'}
)
presentation = response.json()
presentation_id = presentation['presentationId']

# 添加一张幻灯片
requests.post(
    f'https://api.maton.ai/google-slides/v1/presentations/{presentation_id}:batchUpdate',
    headers=headers,
    json={
        'requests': [
            {
                'createSlide': {
                    'slideLayoutReference': {'predefinedLayout': 'TITLE_AND_BODY'}
                }
            }
        ]
    }
)

注意事项

  • 对象 ID（Object ID）在单个演示文稿内必须唯一
  • 所有修改操作（如添加幻灯片、文本、形状等）均应使用 batchUpdate
  • batchUpdate 中的多个请求将被原子化执行
  • 尺寸与位置单位统一为 PT（点），72 PT = 1 英寸
  • 建议使用 replaceAllText 实现基于模板的演示文稿生成
  • 重要：使用 curl 命令时，若 URL 包含方括号，请使用 curl -g 参数禁用 glob 解析
  • 重要：当将 curl 输出管道传递给 jq 或其他命令时，在某些 shell 环境下环境变量（如 $MATON_API_KEY）可能无法正确展开，从而导致“Invalid API key”错误

错误处理

状态码 含义
400 缺少 Google Slides 连接
401 Maton API 密钥无效或缺失
404 未找到演示文稿
429 请求频率受限（每个账户每秒最多 10 次请求）
4xx/5xx 来自 Google Slides API 的透传错误

问题排查：API 密钥相关问题

  1. 检查 MATON_API_KEY 环境变量是否已设置：
echo $MATON_API_KEY
  1. 通过列出连接验证 API 密钥有效性：
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

问题排查：应用名称无效

  1. 确保您的 URL 路径以 google-slides 开头。例如：
  • 正确：https://api.maton.ai/google-slides/v1/presentations
  • 错误：https://api.maton.ai/slides/v1/presentations

相关资源

  • Slides API 概览
  • 演示文稿（Presentations）
  • 页面（Pages）
  • 批量更新请求（BatchUpdate Requests）
  • 页面版式（Page Layouts）
  • Maton 社区
  • Maton 支持

作者最新文章

如何理解 iframe 中媒体查询在不同缩放级别下宽度匹配不一致的问题

快手把直播字幕延迟砍到 500 毫秒内：自研端到端工程范式，把电商直播的字幕打成"实时"

如何正确遍历Appium上下文句柄以避免重复输出

看完三种结局才揭开部分真相：《独角仙之森》现已登陆Steam

如何使用 PHP 的 flock() 实现真正的单次文件访问控制

热门AI工具

更多
DeepSeek

DeepSeek

 Seko

Seko

Hot 墨刀AI

墨刀AI

Hot Laper

Laper

Hot Atoms

Atoms

Hot 豆包大模型

豆包大模型

 咔片AIPPT

咔片AIPPT

Hot VibeKnow

VibeKnow

Hot

相关专题

更多
NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程，覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复，帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程，涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作，并整理了免费版水印规则与手机端浏览器访问指南，助你快速将知识内容视频化。

2026.09.21

0

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程，覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

0

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程，覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容，帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程，覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景，帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程，覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景，帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw（AI龙虾助手）的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体，能直接在电脑上读写文件、运行脚本、操作浏览器，自动交付Word、PPT、Excel等成品。

2026.09.20

0

13

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程，涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能，帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单，涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比，助您快速选对适合创作需求的AI视频生成工具。

2026.09.16

0

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多
MDPHP(麦迪php框架系统)1.1
PHP 多国语言框架2.0
ujframe简单快速PHP开发框架1.0
php轻量型框架1.0
MyQEE开源PHP多项目及模块化开发框架3.0 RC2
php开源学习型框架CMVC1.2.0
PHP框架Kohana3.3.1

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gemini Notebook官方手册
Gemini Notebook官方手册

共0课时 | 0人学习

Google Cloud开发者文档
Google Cloud开发者文档

共0课时 | 0人学习

Veo 3 官方文档
Veo 3 官方文档

共0课时 | 0人学习

最新文章

更多
aionclaw怎么一键生成PPT大纲
OpenAI成立数学与人工智能咨询小组
AionClaw能根据目标拆出每日安排吗
WorkBuddy文本模型写广告语怎么抓眼球详细技巧步骤
LiblibAI API并发任务数量怎么控制
Coze扣子怎么添加JevAPI插件_Coze配置JevAPI实现自定义模型调用方法
Laper能找出前后矛盾的剧情设定吗
updream生成的对白不自然，应该怎么调整
剧云AI短剧剧本怎么创作_用剧云AI免费版写微短剧全套实操教程
剧云AI永久免费版入口在哪_剧云AI免费网页版登录入口与操作指南