寻求 Google gitkit identitytoolkit Javascript API 的完整文档

Question

通过在 http://www.gstatic.com/authtoolkit/js/gitkit.js

查看缩小的源代码

...我找到了以下没有文档的方法在 https://developers.google.com/identity/toolkit/web/setup-frontend

google.identitytoolkit.signIn()
google.identitytoolkit.signOut()
google.identitytoolkit.manageAccount()
google.identitytoolkit.start()
google.identitytoolkit.setConfig()

虽然有些名称是不言自明的，但拥有以下名称会很有用：

1) 它们的参数和回调的文档。

2) setConfig/start 方法有什么用？

3) API 找到并呈现旧但有效的 gtoken cookie 后是否有回调？

谢谢

Answer 1

此页面涵盖了大多数应用程序最常用的调用 Web api 的方法：https://developers.google.com/identity/toolkit/web/setup-frontend

这里有一个简短的摘要，可以帮助您开始：

google.identitytoolkit.signInButton(element, config)：这将呈现工具包导航栏：如果用户未登录则为登录按钮，如果用户已登录则为用户卡。提供的元素将成为该对象的容器。配置对象包含文档中描述的配置。如果在登录模式下，单击该按钮，它将重定向到触发以下启动方法的小部件 url 页面。

google.identitytoolkit.start(element, config, opt_postBody)：这将在提供的元素中呈现工具包小部件。这将在小部件 url 页面中使用。需要按照上面文档中的描述提供配置。可选的 post 正文用于完成某些身份提供商（如 Yahoo）的登录。登录成功后，这将重定向到配置中的静态登录成功 url 或调用登录成功回调函数（如果提供）。如果在小部件 url 中提供了登录成功 url 参数。成功登录后，它将覆盖成功静态登录的值 url.

google.identitytoolkit.setConfig(config)：这将动态设置配置字段。请记住，start 和 signInButton 是运行加载的，因此这对于下面的运行按需方法可能更有用。

google.identitytoolkit.signOut()：使用 setConfig 中提供的配置或 signInButton 中设置的配置动态触发以注销用户。这将重定向到配置中提供的注销 url 或调用注销回调函数（如果配置中提供）。如果您要提供自己的退出按钮，这很有用。

google.identitytoolkit.signIn()：与 signOut 相同，但用于动态登录用户。如果您使用自己的登录按钮，这很有用。这将重定向到小部件页面 url，模式设置为 select，如配置中所设置的那样。

google.identitytoolkit.manageAccount()：当用户登录并且他们想要管理他们的帐户（更改电子邮件或密码）时使用。它将重定向到管理帐户模式下的小部件 url。将使用配置中的小部件 url。如果您提供自己的管理帐户按钮，这很有用。

关于你的第三个问题，如果我没理解错的话，你问的是如何检测用户是否登录。你可以查看保存在浏览器cookie中的id token字符串（默认名称是gtoken）。然后，您可以使用 github 上的 gitkit 客户端库来验证令牌。检查这些链接的文档站点。例如，如果您在后端使用 python，则可以调用方法：

gitkit_user = gitkit_instance.VerifyGitkitToken(self.request.cookies['gtoken'])

如果成功，这将 return 一个用户对象。

寻求 Google gitkit identitytoolkit Javascript API 的完整文档

Seeking complete documentation of the Google gitkit identitytoolkit Javascript API

google-identity-toolkit