برای راهنمایی پیاده سازی Google SSO در افزونه های Classroom ، صفحه ورود بدون اصطکاک را ببینید. راهنمای ورود به سیستم بدون اصطکاک همچنین به طرح آزمایشی اشاره دارد که می‌تواند برای اطمینان از اینکه افزونه شما از بهترین شیوه‌های ورود به سیستم پیروی می‌کند استفاده می‌شود.
جریان ورود به سیستم
برای کاهش اصطکاک ورود به سیستم برای کاربران، Google Classroom پارامتر query login_hint را هنگام باز شدن iframe ارائه می‌کند. login_hint شناسه گوگل منحصر به فرد یک کاربر است و پس از اینکه کاربر برای اولین بار وارد افزونه شما شد ارائه می شود. این پارامتر زمینه را در مورد کاربری که به Google Classroom وارد شده است ارائه می دهد. برای بحث دقیق تر در مورد این پارامترهای پرس و جو، صفحه راهنمای پارامترهای ورود به سیستم ما را ببینید.
اگر پارامتر جستجوی login_hint کاربر فعلی Google Classroom با هیچ یک از کاربران واردشده به سیستم افزونه مطابقت ندارد، باید یک گفتگوی ورود به سیستم Google را نمایش دهید. این دکمه باید از دستورالعمل‌های نام تجاری Google پیروی کند. اگر کاربر قبلاً وارد سیستم شده باشد، نباید از او خواسته شود دوباره وارد سیستم شود.
شکل 1. هنگامی که کاربر در ابتدا افزونه شما را راه اندازی می کند، جریان ورود به سیستم.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
شکل 1. هنگامی که کاربر در ابتدا افزونه شما را راه اندازی می کند، جریان ورود به سیستم.