
如何用notebooklm-py程序化分享Notebook公共链接与查看者/编辑者权限全解【免费下载链接】notebooklm-pyUnofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to NotebookLMs features—including capabilities the web UI doesnt expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.项目地址: https://gitcode.com/GitHub_Trending/no/notebooklm-pynotebooklm-py 是一个非官方的 Google Gemini NotebookNotebookLMPython API它让程序化分享 Notebook成为可能你可以通过 Python API、CLI 命令和 AI Agent 一键生成公共分享链接精确管理每位协作者的查看者Viewer与编辑者Editor权限甚至只开放聊天界面而不泄露原始资料。这些能力在网页 UI 中往往需要点选多次用 notebooklm-py 一条命令即可完成。 为什么需要程序化分享在网页版 NotebookLM 中把笔记本分享给同事需要手动打开设置面板、逐个输入邮箱、调整权限。而 notebooklm-py 把整个分享流程变成了可编程的操作公共链接分享一条命令开启/关闭任何持有链接的人可访问精细权限控制按邮箱批量授予查看者或编辑者权限视图级别控制决定查看者能看到完整笔记本还是仅聊天界面自动化友好输出结构化 JSON可直接接入脚本与 AI Agent核心实现位于 src/notebooklm/_sharing.py官方命令参考见 docs/cli-reference.md。️ 快速上手notebooklm share 命令全家桶安装并登录账号后所有分享操作都通过notebooklm share命令组完成命令定义在 src/notebooklm/cli/share_cmd.py。1️⃣ 查看当前分享状态notebooklm share status输出会显示笔记本是否公共、公共分享链接若已开启、以及所有被分享用户及其权限级别。加--json可拿到结构化数据方便脚本解析。2️⃣ 一键开启公共链接notebooklm share public --enable # 开启任何持有链接的人可访问 notebooklm share public --disable # 关闭恢复受限访问开启后share status会给出形如.../notebook/notebook_id的share_url直接把链接发给任何人都能访问。对应的 Python 方法是client.sharing.set_public(notebook_id, True)。3️⃣ 按邮箱分享并指定权限notebooklm share add userexample.com # 默认查看者权限 notebooklm share add userexample.com --permission editor # 编辑者权限 notebooklm share add userexample.com -m 欢迎查看 # 附带欢迎语 notebooklm share add userexample.com --no-notify # 不发邮件通知后续调整权限与移除访问notebooklm share update userexample.com --permission editor # 升级/降级权限 notebooklm share remove userexample.com # 移除访问-y 跳过确认一个实用细节add与update底层都是upsert新增或覆盖操作——邮箱尚未分享则自动添加已有权限则直接替换为新的权限级别无需先删除再添加。️ 三种权限级别Viewer / Editor / Owner 全解权限模型定义在 src/notebooklm/rpc/types.py 的SharePermission枚举中权限说明能否通过 API 授予OWNER所有者完全控制权❌ 只读API 会拒绝分配EDITOR编辑者可编辑笔记本内容、添加资料✅VIEWER查看者只读访问默认级别✅也就是说add/update命令只接受viewer或editor两种权限尝试授予 OWNER 会抛出ValueError。批量分享时set_users还支持一次请求为多个邮箱设置权限注意同一邮箱不能重复出现会被客户端提前拦截。️ 控制查看者能看到什么view-level 视图级别公共链接分享还有一个关键开关——视图级别ShareViewLevelnotebooklm share view-level full # 完整笔记本聊天 资料 笔记 notebooklm share view-level chat # 仅聊天界面FULL_NOTEBOOK查看者能看到聊天、原始资料和笔记适合完整的知识共享CHAT_ONLY查看者只能使用聊天界面适合把 NotebookLM 当问答机器人开放而不想暴露原始资料这个能力在 Web UI 中并不直观暴露属于 notebooklm-py 的差异化功能之一。 Python APIclient.sharing 自动化分享流程在 Python 代码中分享功能挂在client.sharingSharingAPI之下完整方法表见 docs/python-api.md。典型流程如下完整示例同样可在该文档找到from notebooklm import SharePermission, ShareViewLevel status await client.sharing.get_status(notebook_id) # 查询当前状态 status await client.sharing.set_public(notebook_id, True) # 开启公共链接 print(status.share_url) # 输出分享链接 await client.sharing.set_view_level( notebook_id, ShareViewLevel.CHAT_ONLY ) # 只开放聊天界面 status await client.sharing.add_user( notebook_id, colleagueexample.com, SharePermission.EDITOR, # 授予编辑者权限 notifyTrue, welcome_message欢迎协作, # 附带欢迎语 )返回的ShareStatus对象定义于 src/notebooklm/_types/sharing.py包含is_public、share_url、shared_users列表等字段其中每位SharedUser都带有邮箱、权限和显示名——方便你在自动化流程中做分享审计。 AI Agent 集成MCP 分享工具如果你在用 Claude Code、Codex 等 AI Agentnotebooklm-py 内置的 MCP 服务器工具实现见 src/notebooklm/mcp/tools/sharing.py提供了 4 个开箱即用的分享工具工具功能share_status只读查询分享状态与用户列表share_set_access设置公共链接开关 视图级别share_set_user按邮箱设置/修改用户权限upsertshare_remove_user移除用户访问破坏性操作带确认门这样你只需用自然语言告诉 Agent把这个笔记本以只读方式分享给张三它就能自动完成解析笔记本、调用正确工具、返回分享结果的全过程。⚠️ 实用提示与注意事项upsert 语义add_user/update_user本质是设置权限而非追加对已有权限的用户会直接覆盖旧权限级别移除是单发的remove_user一次只移除一个邮箱。批量移除时若其中某个邮箱本就不在分享列表后端会静默丢弃整个请求——所以请逐个移除通知与欢迎语作用于整批set_users批量授权时notify和welcome_message对所有用户统一生效不是按人设置策略门ShareStatus.is_public_sharing_allowed字段反映后端是否允许该笔记本开启公共分享自动化脚本在set_public前值得先检查一下协作者上限max_individuals_share_limit字段报告单笔记本的协作者上限线上实测通常为 1000大规模分享脚本应据此做预算 总结需求推荐方式快速手动分享notebooklm share public --enable精细权限管理notebooklm share add / update / remove脚本化、可复用流程client.sharingPython API让 AI Agent 代劳MCP 分享工具share_set_user等notebooklm-py 把 NotebookLM 的分享能力从点鼠标升级为写代码公共链接一键开关、查看者/编辑者权限精确到邮箱、视图级别细到只开放聊天。无论你是要搭建团队知识库分发流水线还是让 AI Agent 自动管理协作权限这套程序化分享方案都能直接上手。更多细节可查阅 docs/cli-reference.md 的 Share 命令章节与 docs/python-api.md 的 SharingAPI 部分。【免费下载链接】notebooklm-pyUnofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to NotebookLMs features—including capabilities the web UI doesnt expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.项目地址: https://gitcode.com/GitHub_Trending/no/notebooklm-py创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考