Consulte a página de login sem atrito para orientações de implementação do SSO do Google
em complementos do Google Sala de Aula. O guia de login sem atrito também se refere ao plano de teste, que pode ser usado para garantir que o complemento siga as práticas recomendadas de login.
Fluxo de login
Para reduzir o atrito de login para os usuários, o Google Sala de Aula fornece o
parâmetro de consulta login_hint quando um iframe é aberto. O login_hint é o ID exclusivo do Google de um usuário e é fornecido depois que o usuário faz login no seu complemento
pela primeira vez. Esse parâmetro fornece contexto sobre o usuário conectado ao Google Sala de Aula. Consulte nossa página do guia de parâmetros de login para uma discussão mais detalhada desses parâmetros de consulta.
Você precisa mostrar uma caixa de diálogo de login do Google se o parâmetro de consulta login_hint do usuário atual do Google Sala de Aula não corresponder a nenhum usuário conectado do complemento. O botão precisa obedecer às diretrizes de marca do Google. Se o usuário já estiver conectado, não será necessário fazer login de novo.
Figura 1. Fluxo de login quando um usuário inicia
seu complemento.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 UTC."],[],[],null,["# Sign in\n\nGoogle Classroom add-ons **must** use Google single sign-on (SSO) to identify\nand authenticate users.\n\nSee [Google Identity's OpenID Connect Guide](https://developers.google.com/identity/protocols/oauth2/openid-connect) for more information on SSO. We\nalso recommend referencing Google's official documentation on user sign-up and\nsign-in for [automatic sign in](https://developers.google.com/identity/gsi/web) and [Sign-In Branding Guidelines](https://developers.google.com/identity/branding-guidelines).\n\nSee the [frictionless sign-in page](/workspace/classroom/add-ons/developer-guides/frictionless-signin) for implementation guidance for Google SSO\nin Classroom add-ons. The frictionless sign-in guide also refers\nto the [test plan](/static/workspace/classroom/assets/classroom_add_ons_test_plan.pdf) that can be used to ensure your add-on is\nfollowing sign-in best practices.\n\nSign in flow\n------------\n\nTo reduce sign-in friction for users, Google Classroom provides the\n`login_hint` query parameter when an iframe is opened. `login_hint` is a user's\nunique Google ID, and is provided *after* the user has signed into your add-on\nfor the first time. This parameter provides context on the user that's signed\ninto Google Classroom. See our [sign-in parameters guide page](/workspace/classroom/add-ons/developer-guides/iframes#sign-in_related_parameters) for a more\ndetailed discussion of these query parameters.\n\nYou must display a Google sign-in dialog if the `login_hint` query parameter of\nthe current Google Classroom user doesn't match any signed-in user of the\nadd-on. The button must adhere to [Google's branding guidelines](https://developers.google.com/identity/branding-guidelines). If the user is\nalready signed in, they shouldn't be prompted to sign-in again.\n\n**Figure 1.** Sign in flow when a user initially launches\nyour add-on.\n| **Important:** The sign in button should only be seen when the add-on doesn't have a signed in user to compare against the `login_hint` query parameter. The sign in button is unnecessary if the add-on matches the signed in user using the value of `login_hint`; in this case, the add-on should keep the user signed in."]]
Figura 1. Fluxo de login quando um usuário inicia
seu complemento.