谷歌

import { betterAuth } from "better-auth"

export const auth = betterAuth({
    baseURL: process.env.BETTER_AUTH_URL, 
    socialProviders: {
        google: { 
            clientId: process.env.GOOGLE_CLIENT_ID as string, 
            clientSecret: process.env.GOOGLE_CLIENT_SECRET as string, 
        }, 
    },
})

BETTER_AUTH_URL=https://your-domain.com

用法

【Usage】

使用 Google 登录

【Sign In with Google】

要使用 Google 登录，你可以使用客户端提供的 signIn.social 函数。signIn 函数接收一个具有以下属性的对象：

【To sign in with Google, you can use the signIn.social function provided by the client. The signIn function takes an object with the following properties:】

• provider：要使用的提供者。它应设置为 google。

import { createAuthClient } from "better-auth/client";
const authClient = createAuthClient();

const signIn = async () => {
  const data = await authClient.signIn.social({
    provider: "google",
  });
};

使用 ID 令牌通过 Google 登录

【Sign In with Google With ID Token】

要使用 ID 令牌通过 Google 登录，你可以使用 signIn.social 函数传递 ID 令牌。

【To sign in with Google using the ID Token, you can use the signIn.social function to pass the ID Token.】

当你在客户端拥有来自 Google 的 ID 令牌并希望用它在服务器端登录时，这会非常有用。

【This is useful when you have the ID Token from Google on the client-side and want to use it to sign in on the server.】

const data = await authClient.signIn.social({
    provider: "google",
    idToken: {
        token: // Google ID Token,
        accessToken: // Google Access Token
    }
})

始终要求选择一个账户

【Always ask to select an account】

如果你想始终要求用户选择一个账户，你可以将 prompt 参数传递给提供者，并将其设置为 select_account。

【If you want to always ask the user to select an account, you pass the prompt parameter to the provider, setting it to select_account.】

socialProviders: {
    google: {
        prompt: "select_account", 
        clientId: process.env.GOOGLE_CLIENT_ID as string,
        clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,
    },
}

请求额外的 Google 权限

【Requesting Additional Google Scopes】

如果你的应用在用户已注册后仍需要额外的 Google 权限（例如 Google Drive、Gmail 或其他 Google 服务），你可以使用相同的 Google 提供商通过 linkSocial 方法来请求这些权限。

【If your application needs additional Google scopes after the user has already signed up (e.g., for Google Drive, Gmail, or other Google services), you can request them using the linkSocial method with the same Google provider.】

const requestGoogleDriveAccess = async () => {
  await authClient.linkSocial({
    provider: "google",
    scopes: ["https://www.googleapis.com/auth/drive.file"],
  });
};

// Example usage in a React component
return (
  <button onClick={requestGoogleDriveAccess}>
    Add Google Drive Permissions
  </button>
);

这将触发一个新的 OAuth 流程，请求额外的权限范围。完成后，你的账户在数据库中将拥有新的权限范围，并且访问令牌将允许你访问所请求的 Google API。

【This will trigger a new OAuth flow that requests the additional scopes. After completion, your account will have the new scope in the database, and the access token will give you access to the requested Google APIs.】

始终获取刷新令牌

【Always get refresh token】

Google 仅在用户第一次同意你的应用时发放刷新令牌。如果用户已经授权过你的应用，后续的 OAuth 流程将只返回访问令牌，而不会返回刷新令牌。

【Google only issues a refresh token the first time a user consents to your app. If the user has already authorized your app, subsequent OAuth flows will only return an access token, not a refresh token.】

要始终获取刷新令牌，可以在提供者选项中将 accessType 设置为 offline，并将 prompt 设置为 select_account consent。

【To always get a refresh token, you can set the accessType to offline, and prompt to select_account consent in the provider options.】

socialProviders: {
    google: {
        clientId: process.env.GOOGLE_CLIENT_ID as string,
        clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,
        accessType: "offline", 
        prompt: "select_account consent", 
    },
}