پس از پیادهسازی OAuth 2.0، میتوانید به صورت اختیاری App Flip مبتنی بر OAuth را پیکربندی کنید، که به کاربران Android شما اجازه میدهد سریعتر حسابهای خود را در سیستم احراز هویت شما به حسابهای گوگل خود پیوند دهند. بخشهای زیر نحوه طراحی و پیادهسازی App Flip برای ادغام Cloud-to-cloud شما شرح میدهند.
دستورالعملهای طراحی
این بخش الزامات و توصیههای طراحی برای صفحه رضایت اتصال حساب App Flip را شرح میدهد. پس از اینکه گوگل برنامه شما را فراخوانی کرد، برنامه شما صفحه رضایت را به کاربر نمایش میدهد.
الزامات
- شما باید یک بیانیه مجوز گوگل مانند «پس از اتصال، گوگل اجازه کنترل دستگاههای شما را خواهد داشت» داشته باشید.
- شما باید اطلاع دهید که حساب کاربر به گوگل متصل میشود، نه به یک محصول خاص گوگل، مانند گوگل هوم یا دستیار گوگل.
- شما باید یک فراخوان عمل واضح در صفحه رضایت خود بیان کنید و از عبارت «موافقم و پیوند» برای اقدام پیوند استفاده کنید. دلیل این امر این است که کاربران باید بدانند برای پیوند دادن حسابهایشان، چه دادههایی را باید با گوگل به اشتراک بگذارند.
- شما باید راهی برای کاربران فراهم کنید تا در صورت عدم تمایل به پیوند، بتوانند به عقب برگردند، آن را رد کنند یا لغو کنند. برای لغو پیوند از عبارت «لغو» استفاده کنید.
- شما باید این گردش کار را پیادهسازی کنید: پس از کلیک روی «موافقت و پیوند»، باید موفقیت پیوند را نشان دهید و کاربر را به طور خودکار به برنامه Google Home هدایت کنید. اکنون کاربر باید دستگاه پیوند شده را با اقدام شما در برنامه Google Home ببیند. پس از کلیک روی «لغو»، باید کاربر را به برنامه Google Home هدایت کنید.
توصیهها
توصیه میکنیم موارد زیر را انجام دهید:
سیاست حفظ حریم خصوصی گوگل را نمایش دهید. پیوندی به سیاست حفظ حریم خصوصی گوگل را در صفحه رضایتنامه قرار دهید.
دادههایی که باید به اشتراک گذاشته شوند. با زبانی واضح و مختصر به کاربر بگویید که گوگل به چه دادههایی از او نیاز دارد و چرا.
امکان لغو پیوند. مکانیزمی برای لغو پیوند کاربران ارائه دهید، مانند URL به تنظیمات حساب کاربری آنها در پلتفرم شما. از طرف دیگر، میتوانید پیوندی به حساب گوگل قرار دهید که کاربران بتوانند حساب پیوند شده خود را مدیریت کنند.
امکان تغییر حساب کاربری. روشی را برای کاربران پیشنهاد دهید تا حساب(های) خود را تغییر دهند. این امر به ویژه در صورتی مفید است که کاربران تمایل به داشتن چندین حساب داشته باشند.
- اگر کاربری برای تغییر حساب کاربری باید صفحه رضایت را ببندد، یک خطای قابل بازیابی به گوگل ارسال کنید تا کاربر بتواند با پیوند OAuth و جریان ضمنی به حساب مورد نظر خود وارد شود.
لوگوی خود را قرار دهید. لوگوی شرکت خود را در صفحه رضایتنامه نمایش دهید. از دستورالعملهای سبک خود برای قرار دادن لوگوی خود استفاده کنید. اگر میخواهید لوگوی گوگل را نیز نمایش دهید، به بخش لوگوها و علائم تجاری مراجعه کنید.
برای App Flip مبتنی بر OAuth تنظیم کنید
بخشهای زیر پیشنیازهای App Flip مبتنی بر OAuth و نحوه پیکربندی پروژه App Flip شما در کنسول توسعهدهندگان Google Home را شرح میدهند.
ایجاد یکپارچهسازی ابر به ابر و راهاندازی سرور OAuth 2.0
قبل از اینکه بتوانید App Flip پیکربندی کنید، باید موارد زیر را انجام دهید:
- یک سرور OAuth 2.0 راهاندازی کنید. برای اطلاعات بیشتر در مورد راهاندازی یک سرور OAuth، به بخش پیادهسازی یک سرور OAuth 2.0 مراجعه کنید.
- ایجاد یکپارچهسازی ابر به ابر. برای ایجاد یکپارچهسازی، دستورالعملهای موجود در «ایجاد یکپارچهسازی ابر به ابر» را دنبال کنید.
پیکربندی App Flip در کنسول توسعهدهندگان
بخش زیر نحوه پیکربندی App Flip را در کنسول توسعهدهندگان توضیح میدهد.
- تمام فیلدهای زیر اطلاعات OAuth Client را پر کنید. (اگر App Flip پشتیبانی نشود، OAuth معمولی به عنوان جایگزین استفاده میشود.)
- در قسمت «استفاده از برنامه شما برای پیوند حساب کاربری (اختیاری) ، گزینه «فعال کردن برای iOS» را علامت بزنید.
- فیلد پیوند جهانی را پر کنید. برای اطلاعات بیشتر در مورد پیوندهای جهانی، به بخش «اجازه دادن به برنامهها و وبسایتها برای پیوند دادن به محتوای شما» مراجعه کنید.
- اگر میخواهید کلاینت خود را به صورت اختیاری پیکربندی کنید، محدودهها را اضافه کنید و در قسمت پیکربندی کلاینت (اختیاری)، روی افزودن محدوده کلیک کنید.
- روی ذخیره کلیک کنید.
اکنون میتوانید برای پیادهسازی App Flip در اپلیکیشن iOS یا Android خود، به بخش بعدی بروید.
پیادهسازی App Flip در اپلیکیشنهای نیتیو
برای پیادهسازی App Flip ، باید کد مجوز کاربر را در برنامه خود تغییر دهید تا یک لینک عمیق از گوگل را بپذیرد.
App Flip روی دستگاه خود آزمایش کنید
اکنون که یکپارچهسازی ابر به ابر را ایجاد کردهاید و App Flip را روی کنسول و در برنامه خود پیکربندی کردهاید، میتوانید App Flip را روی دستگاه تلفن همراه خود آزمایش کنید. میتوانید از برنامه Google Home برای آزمایش App Flip استفاده کنید.
برای آزمایش App Flip از برنامه Google Home ، این مراحل را دنبال کنید:
- به کنسول توسعهدهندگان بروید و پروژه خود را انتخاب کنید.
- به ابر به ابر > تست بروید.
- فعال کردن جریان لینک حساب از برنامه Home:
- Google Home app (GHA) را باز کنید.
- روی دکمه + کلیک کنید.
- روی راهاندازی دستگاه کلیک کنید.
- روی «آیا قبلاً چیزی راهاندازی شده است؟» کلیک کنید.
- ادغام ابر به ابر خود را از لیست ارائه دهندگان انتخاب کنید. در لیست با پیشوند "[test]" مشخص شده است. وقتی ادغام [test] خود را از لیست انتخاب میکنید، باید برنامه شما باز شود.
- تأیید کنید که برنامه شما راهاندازی شده است و آزمایش جریان مجوز خود را شروع کنید.