ویژگی ثبت‌نام (ورود به سیستم) «کارت هدیه» به کاربران امکان می‌دهد «کارت هدیه» را جستجو کنند و آن را به «کیف پول Google» اضافه کنند. کاربران برای تکمیل فرایند به وب‌سایت سازگار با تلفن همراه شما هدایت می‌شوند و پس‌از آن می‌توانند کارتشان را به «کیف پول Google» اضافه کنند.
این راهنما نمای کلی‌ای از مراحل پیاده‌سازی لازم برای فعال کردن برنامه کارت هدیه شما برای این ویژگی ارائه می‌دهد.
نمای کلی
برای شروع، مطمئن شوید که قبلاً پروژه خود را راه‌اندازی کرده‌اید و به Google Wallet API دسترسی دارید.
برای پیاده‌سازی ویژگی ورود به سیستم برای برنامه کارت هدیه‌تان، باید این چهار مرحله را دنبال کنید:
- کلاس آزمایشی در «کیف پول Google» برای آزمایش کردن جریان ورود به سیستم راه‌اندازی کنید.
- صفحه‌های ورود به سیستم را که از «کیف پول Google» استفاده می‌کنند توسعه دهید
SharedDataType. - پس‌از ورود به سیستم، کارت هدیه را به «کیف پول Google» برگردانید.
- درخواست درستی‌سنجی و فعال‌سازی.
راه‌اندازی کلاس آزمایشی در «کیف پول Google»
نشانی وب ورود به سیستم و نشان‌واره برنامه‌تان را تعیین کنید. سپس،
از فیلدهای تودرتوی discoverableProgram در
giftcardclass برای تنظیم
مقادیر مناسب استفاده کنید.
مقادیر را در discoverableProgram تنظیم کنید تا نسخه پیش‌نویس برنامه کارت هدیه با ورود به سیستم فعال‌شده را ایجاد کنید. برای اطمینان از اینکه این مورد برای آزمایش‌کنندگان قابل‌مشاهده است، بررسی کنید که
آزمایش‌کنندگان به Google Pay و «کنسول کیف پول» شما دسترسی داشته باشند. برای جزئیات بیشتر درباره نحوه هم‌رسانی دسترسی به «کنسول Pay و کیف پول Google» با افراد دیگر، به آشنایی با صفحه «کاربران» مراجعه کنید.
برای تکمیل درستی‌سنجی عملکرد پیاده‌سازی‌تان درطول فرایند توسعه، بااستفاده از ابزارک تماس با پشتیبانی در «کنسول کیف پول و Google Pay» با ما تماس بگیرید. وقتی در کنسول هستید، Google Wallet API را در موضوع انتخاب کنید و ورود به سیستم کارت هدیه را در زیرموضوع انتخاب کنید.
توسعه صفحه ورود به سیستم که از داده‌های کاربر «کیف پول Google» استفاده می‌کند
وقتی کاربری انتخاب می‌کند کارت هدیه شما را اضافه کند، به صفحه سفارشی‌شده‌ای در وب‌سایت شما هدایت می‌شود تا فرایند ورود به سیستم را تکمیل کند.
باید نشانی وب ورود به سیستمی ارائه دهید که کاربر بتواند ازطریق آن به سیستم حساب موجود وارد شود.
صفحه ورود به سیستم شما باید الزامات زیر را برآورده کند:
- تجربه کاربری سازگار با دستگاه همراه ارائه دهید.
- به کاربر اجازه دهید ورود به سیستم را در یک صفحه تکمیل کند.
- از رمزگذاری
HTTPSبا گواهی معتبر استفاده کنید تا مطمئن شوید داده‌های کاربر به‌طور ایمن منتقل می‌شود. - مطمئن شوید که زمان فعال بودن صفحه ورود به سیستم شما حداقل ۹۹٫۹٪ باشد.
هنگام ارائه صفحه ورود به سیستم، «کیف پول Google» یک Android WebView ایجاد می‌کند و درخواست POST به نشانی وب ارائه‌شده شما ارسال می‌شود. داده‌های کاربر در پارامتر SharedDataType ارائه می‌شود
که در درخواست POST بااستفاده از
نوع محتوای
application/x-www-form-urlencoded و
کدبندی UTF-8 گنجانده شده است. مقدار پارامتر SharedDataType
یک شیء JSON کدبندی‌شده با Base64 است.
کارت هدیه را فوراً به «کیف پول Google» برگردانید
پس‌از اصالت‌سنجی (ورود به سیستم)، صفحه شما باید فوراً کارت هدیه کاربر را به «کیف پول Google» برگرداند.
می‌توانید کارت هدیه را با هدایت کردن به پیوندی که از ساختار زیر پیروی می‌کند به «کیف پول Google» برگردانید
https://pay.google.com/gp/v/save/{jwt_generated}طول ایمن برای نشانی وب ۲۰۰۰ نویسه است. پیوندهایتان باید کمتر از این حد باشد. اشیاء کدگذاری‌شده در JWT باید کوچک باشند و فقط حاوی داده‌های مختص کاربر باشند. سعی کنید بیشتر داده‌ها را در کلاس شیء نگه دارید، و آن را قبل‌از ساختن JWT ایجاد کنید. برای اشیای بزرگ‌تر که در این محدودیت نمی‌گنجند، ابتدا شیء را در Google Wallet API ایجاد کنید و فقط شناسه شیء را در JWT ارسال کنید.
جریان ارتباطی معمول
جریان ارتباطی برای کاربری که ورود به سیستم را تکمیل می‌کند در تصویر زیر نشان داده شده است. مسئولیت اجرای همه کنش‌های بین «سرور شما» برعهده شما است.
درخواست درستی‌سنجی و فعال‌سازی
پس‌از تکمیل کار توسعه و آزمایش جریان ورود به سیستم، درخواستی را ازطریق ابزاره پشتیبانی تماس کنسول Google Pay و «کیف پول» ارسال کنید.
پس‌از بررسی کامل پیاده‌سازی شما که ویژگی صحیح را در ترکیب با برنامه «کیف پول Google» تأیید می‌کند، ویژگی ورود به سیستم کارت هدیه به‌طور عمومی برای برنامه کارت هدیه شما راه‌اندازی خواهد شد. این کار به هر کاربری اجازه می‌دهد برنامه را ببیند و از این ویژگی استفاده کند.
برای اطمینان از تجربه کاربری بهینه، بررسی‌های مکرر از پیاده‌سازی ورود به سیستم شما انجام خواهد شد تا از رعایت مداوم الزامات ویژگی اطمینان حاصل شود. درصورت وجود مغایرت به شما اطلاع داده می‌شود و ممکن است ویژگی ورود به سیستم تا زمان حل مشکل غیرفعال شود.
پرسشگان
- آیا برای تصاویر استفاده‌شده در برنامه کارت هدیه من الزامی وجود دارد؟
- بله، تصاویرتان باید در مکان
HTTPSمیزبانی شود چون درغیراین‌صورت در «کیف پول Google» نمایان نخواهد بود.
- بله، تصاویرتان باید در مکان
- آیا ابزاری وجود دارد که پیاده‌سازی و اشکال‌زدایی JWT را ساده کند؟
- بله، پلاتفرم‌هایی مثل www.jwt.io به شما امکان می‌دهند درطول فرایند توسعه، رمز توکن‌هایتان را باز کنید و آن‌ها را اشکال‌زدایی کنید، و به شما امکان می‌دهند محتوایی را که ارسال می‌کنید درستی‌سنجی کنید. توجه داشته باشید که Google هیچ وابستگی‌ای به این اشخاص ثالث ندارد و هیچ‌کدام از آن‌ها را به‌طور خاص توصیه نمی‌کند.
- چگونه داده‌های SharedDataType کدبندی‌شده با Base64 را به‌درستی مدیریت کنیم؟
- مطمئن شوید که در سراسر فرایندتان از کدبندی UTF-8 استفاده می‌کنید. رشته JSON ابتدا با UTF-8 کدبندی می‌شود و سپس بااستفاده از android.util.Base64 با گزینه‌های NO_WRAP و URL_SAFE کدبندی می‌شود. این با RFC 3548 بخش ۴ مطابقت دارد.