显示 API Explorer 并执行方法
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
在大多数文档页面上,屏幕右侧都会显示一个简化版 API Explorer。如果 API Explorer 未显示,请点击 Try it! 以显示 API Explorer 的精简版本。
如果参考文档页面中没有显示试试看! 字样,则 API Explorer 不支持该方法。例如,API Explorer 与需要服务帐号的 API 不兼容,因此它不会显示在这些 API 的文档页面上。
显示 API Explorer 的展开版本
API Explorer 的展开版本包含 c网址、HTTP 及可能的其他代码示例。要显示 API Explorer 的展开版本,请点击“全屏”图标 fullscreen 。
注意 :如需运行代码示例,您必须生成并使用自己的授权凭据。如需了解如何创建项目和生成凭据,请参阅具体的 Google API 文档。 执行方法
您可以使用 API Explorer 输入 API 方法的必需参数、可选参数和请求正文(如果适用)。对于许多 REST 方法(例如 list 方法),您只需要填充一个或两个字段即可执行该方法。例如,Books API 的 books.volumes.list
方法只需要查询参数 (q
) 即可列出图书。如需试用 books.volumes.list
方法,请执行以下操作:
转到 books.volumes.list
。
如果未显示 APIs Explorer,请点击 Try it!
在 q
字段中,输入 Hunger Games (不含任何引号或特殊字符)。
向下滚动,然后点击执行 。
(可选)Google 登录屏幕会要求您选择 Google 帐号。
(可选)Google 授权对话框会询问您是否允许“管理您的图书”。点击允许 。结果显示在“执行”按钮下方。
如果 API Explorer 显示 200 的结果,则表示方法成功。
注意 :在允许授权屏幕发出授权请求后,API Explorer 将有权发出其他请求,直到凭据过期。因此,您不会看到每个后续方法调用的授权屏幕。如需详细了解凭据,请参阅使用不同凭据类型和范围进行测试 。
排查 API Explorer 问题
您收到了 401 或 403 错误
如果您在使用 API Explorer 执行方法时收到 401 或 403 错误,则可能是由于以下某种原因所致:
您使用的授权类型有误(使用 API 密钥,而不是 OAuth 2.0)。
请尝试切换授权类型。
您使用的是 OAuth 2.0,但范围太窄。请尝试使用更宽泛的范围。
“授权”对话框未显示
API Explorer 使用弹出式窗口授予对私有数据的访问权限。如果浏览器拦截了弹出式窗口,该弹出式窗口就不会出现,而您也将无法授予访问权限。
如果您在授权对话框中点击允许 ,但没有任何反应,请尝试更改浏览器的弹出式窗口设置以启用弹出式窗口。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2022-04-27。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2022-04-27\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2022-04-27。"]]