App Flip Linking مبتنی بر OAuth (App Flip) به کاربران شما این امکان را می دهد تا به راحتی و سریع حساب های خود را در سیستم احراز هویت شما به حساب های Google خود پیوند دهند. اگر زمانی که کاربر فرآیند پیوند دادن حساب را آغاز می کند، برنامه شما روی تلفن شما نصب شده باشد، برای دریافت مجوز کاربر به طور یکپارچه به برنامه شما منتقل می شود.
این رویکرد یک فرآیند پیوند سریعتر و آسانتر را فراهم می کند زیرا کاربر مجبور نیست نام کاربری و رمز عبور خود را مجدداً برای احراز هویت وارد کند. در عوض، App Flip از اعتبارنامه‌های حساب کاربر در برنامه شما استفاده می‌کند. هنگامی که یک کاربر حساب Google خود را با برنامه شما مرتبط کرد، می تواند از هر یکپارچه سازی که شما ایجاد کرده اید استفاده کند.
می توانید App Flip را برای هر دو برنامه iOS و Android تنظیم کنید.
الزامات
برای پیاده سازی App Flip، باید شرایط زیر را رعایت کنید:
- شما باید یک برنامه اندروید یا iOS داشته باشید.
- شما باید صاحب، مدیریت و نگهداری سرور OAuth 2.0 باشید که از جریان کد مجوز OAuth 2.0 پشتیبانی می کند.
App Flip Linking مبتنی بر OAuth (App Flip) به کاربران شما این امکان را می دهد تا به راحتی و سریع حساب های خود را در سیستم احراز هویت شما به حساب های Google خود پیوند دهند. اگر زمانی که کاربر فرآیند پیوند دادن حساب را آغاز می کند، برنامه شما روی تلفن شما نصب شده باشد، برای دریافت مجوز کاربر به طور یکپارچه به برنامه شما منتقل می شود.
این رویکرد یک فرآیند پیوند سریعتر و آسانتر را فراهم می کند زیرا کاربر مجبور نیست نام کاربری و رمز عبور خود را مجدداً برای احراز هویت وارد کند. در عوض، App Flip از اعتبارنامه‌های حساب کاربر در برنامه شما استفاده می‌کند. هنگامی که یک کاربر حساب Google خود را با برنامه شما مرتبط کرد، می تواند از هر یکپارچه سازی که شما ایجاد کرده اید استفاده کند.
می توانید App Flip را برای هر دو برنامه iOS و Android تنظیم کنید.
الزامات
برای پیاده سازی App Flip، باید شرایط زیر را رعایت کنید:
- شما باید یک برنامه اندروید یا iOS داشته باشید.
- شما باید صاحب، مدیریت و نگهداری سرور OAuth 2.0 باشید که از جریان کد مجوز OAuth 2.0 پشتیبانی می کند.
برای اطلاعات بیشتر در مورد جریان کد مجوز پیوند OAuth، به اجرای سرور OAuth خود مراجعه کنید.
دستورالعمل های طراحی
این بخش الزامات طراحی و توصیه‌هایی را برای صفحه رضایت پیوند دادن حساب App Flip توضیح می‌دهد. بعد از اینکه Google با برنامه شما تماس گرفت، برنامه شما صفحه رضایت را به کاربر نمایش می دهد.
الزامات
- باید اعلام کنید که حساب کاربر به Google مرتبط شده است، نه به یک محصول خاص Google، مانند Google Home یا Google Assistant.
توصیه ها
توصیه می کنیم موارد زیر را انجام دهید:
سیاست حفظ حریم خصوصی Google را نمایش دهید. پیوندی به خط‌مشی رازداری Google در صفحه رضایت اضافه کنید.
داده ها به اشتراک گذاشته شود. از زبان واضح و مختصر استفاده کنید تا به کاربر بگویید گوگل به چه اطلاعاتی از او نیاز دارد و چرا.
فراخوانی برای اقدام را پاک کنید. یک فراخوان برای اقدام واضح در صفحه رضایت خود، مانند «موافق و پیوند» بیان کنید. این به این دلیل است که کاربران باید بدانند چه داده‌هایی را باید با Google به اشتراک بگذارند تا حساب‌های خود را پیوند دهند.
قابلیت لغو. راهی برای کاربران فراهم کنید که در صورت عدم پیوند، به عقب برگردند یا لغو کنند.
قابلیت قطع لینک مکانیزمی را برای لغو پیوند به کاربران ارائه دهید، مانند URL به تنظیمات حساب آنها در پلتفرم شما. از طرف دیگر، می‌توانید پیوندی به حساب Google اضافه کنید تا کاربران بتوانند حساب پیوند شده خود را مدیریت کنند.
امکان تغییر حساب کاربری روشی را به کاربران پیشنهاد کنید تا حساب(های) خود را تغییر دهند. این به ویژه در صورتی مفید است که کاربران تمایل به داشتن چندین حساب داشته باشند.
- اگر کاربر باید صفحه رضایت را برای تغییر حساب ببندد، یک خطای قابل بازیابی به Google ارسال کنید تا کاربر بتواند با پیوند OAuth و جریان ضمنی به حساب مورد نظر وارد شود.
لوگوی خود را درج کنید. لوگوی شرکت خود را روی صفحه رضایت نمایش دهید. از دستورالعمل های سبک خود برای قرار دادن لوگوی خود استفاده کنید. اگر می‌خواهید نشان‌واره Google را نیز نمایش دهید، نشان‌ها و علائم تجاری را ببینید.
دستورالعمل های طراحی
این بخش الزامات طراحی و توصیه‌هایی را برای صفحه رضایت پیوند دادن حساب App Flip توضیح می‌دهد. بعد از اینکه Google با برنامه شما تماس گرفت، برنامه شما صفحه رضایت را به کاربر نمایش می دهد.
الزامات
- باید اعلام کنید که حساب کاربر به Google مرتبط شده است، نه به یک محصول خاص Google، مانند Google Home یا Google Assistant.
توصیه ها
توصیه می کنیم موارد زیر را انجام دهید:
سیاست حفظ حریم خصوصی Google را نمایش دهید. پیوندی به خط‌مشی رازداری Google در صفحه رضایت اضافه کنید.
داده ها به اشتراک گذاشته شود. از زبان واضح و مختصر استفاده کنید تا به کاربر بگویید گوگل به چه اطلاعاتی از او نیاز دارد و چرا.
پاک کردن فراخوان برای اقدام یک فراخوان برای اقدام واضح در صفحه رضایت خود، مانند «موافق و پیوند» بیان کنید. این به این دلیل است که کاربران باید بدانند چه داده‌هایی را باید با Google به اشتراک بگذارند تا حساب‌های خود را پیوند دهند.
قابلیت لغو. راهی برای کاربران فراهم کنید که در صورت عدم پیوند، به عقب برگردند یا لغو کنند.
قابلیت قطع لینک مکانیزمی را برای لغو پیوند به کاربران ارائه دهید، مانند URL به تنظیمات حساب آنها در پلتفرم شما. از طرف دیگر، می‌توانید پیوندی به حساب Google اضافه کنید تا کاربران بتوانند حساب پیوند شده خود را مدیریت کنند.
امکان تغییر حساب کاربری روشی را به کاربران پیشنهاد کنید تا حساب(های) خود را تغییر دهند. این به ویژه در صورتی مفید است که کاربران تمایل به داشتن چندین حساب داشته باشند.
- اگر کاربر باید صفحه رضایت را برای تغییر حساب ببندد، یک خطای قابل بازیابی به Google ارسال کنید تا کاربر بتواند با پیوند OAuth و جریان ضمنی به حساب مورد نظر وارد شود.
لوگوی خود را درج کنید. لوگوی شرکت خود را روی صفحه رضایت نمایش دهید. از دستورالعمل های سبک خود برای قرار دادن لوگوی خود استفاده کنید. اگر می‌خواهید نشان‌واره Google را نیز نمایش دهید، نشان‌ها و علائم تجاری را ببینید.
برای App Flip مبتنی بر OAuth تنظیم کنید
بخش‌های زیر پیش‌نیازهای App Flip مبتنی بر OAuth و نحوه پیکربندی پروژه App Flip خود را در کنسول Actions شرح می‌دهند.
یک Action ایجاد کنید و یک سرور OAuth 2.0 راه اندازی کنید
قبل از اینکه بتوانید App Flip را پیکربندی کنید، باید موارد زیر را انجام دهید:
- یک اکشن ایجاد کنید. برای ایجاد یک Action، دستورالعمل های موجود در بخش Create a project را دنبال کنید.
- یک سرور OAuth 2.0 راه اندازی کنید. برای اطلاعات بیشتر درباره راه‌اندازی سرور OAuth، به پیاده‌سازی پیوند حساب OAuth مراجعه کنید.
App Flip را در کنسول Actions پیکربندی کنید
بخش زیر نحوه پیکربندی App Flip را در کنسول Actions توضیح می‌دهد.
- روی توسعه در پیمایش بالا کلیک کنید. سپس روی Account linking در ناوبری سمت چپ کلیک کنید.
- سوئیچ کنار پیوند حساب را روشن کنید.
- در قسمت ایجاد حساب ، خیر را انتخاب کنید، من فقط می‌خواهم اجازه ایجاد حساب در وب‌سایت خود را بدهم .
- روی Next کلیک کنید.
- در قسمت نوع پیوند ، OAuth و کد مجوز را از منوهای کشویی انتخاب کنید.
- روی Next کلیک کنید.
- تمام فیلدهای زیر اطلاعات مشتری OAuth را پر کنید. (اگر App Flip پشتیبانی نمی شود، OAuth معمولی به عنوان یک بازگشت استفاده می شود.)
- روی Next کلیک کنید.
- در قسمت Use your app for account linking (اختیاری) ، گزینه Enable for iOS را علامت بزنید.
- فیلد پیوند جهانی را پر کنید. برای اطلاعات بیشتر درباره پیوندهای جهانی، به اجازه دادن به برنامه‌ها و وب‌سایت‌ها برای پیوند دادن به محتوای شما مراجعه کنید.
- اگر می‌خواهید به صورت اختیاری مشتری خود را پیکربندی کنید، دامنه‌ها را اضافه کنید و روی Add scope در زیر Configure your client (اختیاری) کلیک کنید. اگر نه، روی Next کلیک کنید.
- در دستورالعمل‌های تست،
test(یا هر رشته دیگری) را به‌عنوان جای‌بان تایپ کنید. (پر کردن این فیلد با یک حساب آزمایشی تنها در صورتی ضروری است که شما واقعاً اقدام خود را برای انتشار ارسال می کنید.) - روی ذخیره کلیک کنید.
اکنون می توانید برای پیاده سازی App Flip در برنامه iOS یا Android خود به بخش بعدی بروید.
App Flip را در برنامه های بومی خود پیاده کنید
برای اجرای App Flip، باید کد مجوز کاربر را در برنامه خود تغییر دهید تا پیوند عمیق از Google را بپذیرید.
برنامه Flip را روی دستگاه خود تست کنید
اکنون که یک Action ایجاد کرده اید و App Flip را در کنسول و برنامه خود پیکربندی کرده اید، می توانید App Flip را در دستگاه تلفن همراه خود آزمایش کنید. برای آزمایش App Flip می توانید از برنامه Google Assistant استفاده کنید.
برای آزمایش App Flip از برنامه Assistant، این مراحل را دنبال کنید:
- به کنسول Actions بروید و پروژه خود را انتخاب کنید.
- روی تست در پیمایش بالا کلیک کنید.
- جریان پیوند حساب را از برنامه دستیار فعال کنید:
- برنامه Google Assistant را باز کنید.
- روی تنظیمات کلیک کنید.
- در تب Assistant، روی Home Control کلیک کنید.
- روی Add(+) کلیک کنید.
- Action خود را از لیست ارائه دهندگان انتخاب کنید. پیشوند آن با "[test]" در لیست خواهد بود. وقتی اکشن [تست] خود را از لیست انتخاب می‌کنید، باید برنامه شما را باز کند.
- بررسی کنید که برنامه شما راه اندازی شده است و شروع به آزمایش جریان مجوز خود کنید.