Method: projects.createSessionCookie

为给定的 Identity Platform ID 令牌创建会话 Cookie。客户端使用会话 Cookie 来保留用户的登录状态。

HTTP 请求

POST https://identitytoolkit.googleapis.com/v1/projects/{targetProjectId}:createSessionCookie

网址采用 gRPC 转码语法。

路径参数

参数
targetProjectId

string

账号所属项目的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "idToken": string,
  "validDuration": string,
  "tenantId": string
}
字段
idToken

string

必需。有效的 Identity Platform ID 令牌。
validDuration

string (int64 format)

会话 Cookie 过期前剩余的时间（以秒为单位）。以秒为单位指定时长，时长应介于 5 分钟到 14 天（包括这两个数值）之间。
tenantId

string

账号所属 Identity Platform 租户的租户 ID。

响应正文

如果成功，则响应正文包含一个 CreateSessionCookieResponse 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。