این سند اصطلاحات و مفاهیم رایجی را که هنگام استفاده از Google Wallet API باید با آن‌ها آشنا باشید فهرست می‌کند.
گذربلیت‌ها
رد کردن
مجوز نمونه‌ای از «شیء مجوزها» است که برای ذخیره شدن در «کیف پول Google» به کاربر ارائه می‌شود. Google Wallet API از تعدادی از انواع مجوزهای رایج، ازجمله کارت پرواز، بلیت رویداد، کارت شناسایی، و غیره پشتیبانی می‌کند. Google Wallet API همچنین نوع مجوز «عمومی» را ارائه می‌دهد که می‌توان از آن برای ایجاد مجوزهایی که به‌طور خاص پشتیبانی نمی‌شوند استفاده کرد.
در اکثر موارد، مجوز بااستفاده از هر دو «کلاس مجوزها» و «شیء مجوزها» ایجاد می‌شود.
صادرکننده مجوز
«صادرکننده مجوز» نهادی است که مجوزها را ایجاد می‌کند و آن‌ها را برای کاربران صادر می‌کند تا در «کیف پول Google» ذخیره کنند. «صادرکننده مجوز» مالک مجوزها است و می‌تواند آن‌ها را ایجاد، صادر، و به‌روز کند. صادرکنندگان مجوز می‌توانند توسعه‌دهندگان فردی، شرکت‌ها و سازمان‌ها، و همچنین تجمیع‌کنندگانی باشند که ازطرف دیگران مجوز ایجاد و صادر می‌کنند، مانند شرکتی که در اجرای بلیت برای رویدادها یا کوپن برای خرده‌فروشان تخصص دارد.
کلاس مجوزها
«کلاس مجوزها» را می‌توان به‌عنوان الگوی هم‌رسانی‌شده‌ای درنظر گرفت که مجوزها از آن ایجاد می‌شوند. «کلاس مجوزها» ویژگی‌های خاصی را تعریف می‌کند که در همه مجوزهایی که از آن استفاده می‌کنند گنجانده می‌شود. «صادرکننده مجوز» می‌تواند چندین کلاس ایجاد کند که هرکدام مجموعه ویژگی‌های متمایز خود را دارند که مشخصه‌هایی مانند سبک و ظاهر، و همچنین ویژگی‌های اضافی مانند «ضربه هوشمند»، و «ثبت‌نام» و «ورود به سیستم» را تعریف می‌کنند.
در بیشتر موارد، مجوز با ارائه «کلاس مجوزها» برای تعریف الگوی مجوز و «شیء مجوزها» برای تعریف جزئیات مجوز صادرشده ایجاد می‌شود.
شیء مجوزها
«شیء مجوزها» مجوز شخصی را تعریف می‌کند که برای ذخیره شدن در «کیف پول Google» به کاربر ارائه می‌شود. «گذرها» اغلب حاوی اطلاعات مختص کاربر هستند. برای مثال، درحالی‌که «کلاس مجوزها» ممکن است ظاهر مجوز کارت هدیه را برای فروشگاهی خاص تعریف کند، «شیء مجوزها» جزئیات خاصی مانند موجودی یا تاریخ انقضا را ارائه می‌دهد.
«شیء مجوزها» باید برای هر مجوزی که صادر می‌شود ایجاد شود، برخلاف «کلاس‌های مجوزها» که می‌تواند در بسیاری‌از نمونه‌های مجوز هم‌رسانی شود.
مجوزهای شخصی
برخی‌از مجوزهایی که با Google Wallet API ایجاد می‌کنید ممکن است حاوی داده‌های حساس کاربر باشد. این مجوزها برای حفظ امنیت داده‌های کاربران شما به محافظت بیشتری نیاز دارند و بااستفاده از نوع مجوز خصوصی عمومی در Google Wallet API به‌روش متفاوتی مدیریت می‌شوند. در مواردی که داده‌های حساس (همان‌طور که در خط‌مشی استفاده مجاز Google Wallet API تعریف شده است) در مجوز شما گنجانده شده است، باید از مجوز «خصوصی عمومی» استفاده شود و ممکن است درطول آماده‌سازی مشمول کنترل‌های حریم خصوصی و بازبینی بیشتر شود.
Smart Tap
Smart Tap یک پروتکل ارتباط حوزه نزدیک اختصاصی Google برای انتقال داده بین دستگاه همراه و پایانه NFC است. فناوری «ضربه هوشمند» به کاربران این امکان را می‌دهد تا با نگه داشتن تلفن روی پایانه‌های سازگار NFC، مجوزهای ذخیره‌شده در «کیف پول Google» را پس‌خرید کنند.
برای استفاده از پروتکل «ضربه هوشمند» با مجوزهایتان، باید با ارائه‌دهنده پایانه سازگار با «ضربه هوشمند» ارتباط برقرار کنید.
میاناهای برنامه‌سازی کاربردی و کیت توسعه نرم‌افزار
میانای برنامه‌سازی کاربردی «کیف پول Google»
Google Wallet API سرویسی است که Google ارائه می‌دهد و به شما امکان می‌دهد مجوزهایی را برای کاربران ایجاد و صادر کنید تا در «کیف پول Google» خود ذخیره کنند. از این میانای برنامه‌سازی کاربردی می‌توان به روش‌های مختلفی استفاده کرد، ازجمله Google Wallet REST API، کیت توسعه نرم‌افزار Android «کیف پول Google»، و کنسول «کیف پول Google».
Google Wallet REST API
Google Wallet REST API میانایی برای ایجاد و مدیریت برنامه‌ریزی‌شده مجوزها ازطریق ارسال درخواست‌های اچ‌تی‌تی‌پی به Google Wallet API است.
برای استفاده از Google Wallet REST API، به حساب Google Cloud نیز نیاز دارید تا حساب سرویسی ایجاد کنید که برای اصالت‌سنجی درخواست‌ها به Google Wallet REST API استفاده می‌شود.
«کیت توسعه نرم‌افزار Android» برای «کیف پول Google»
«کیت توسعه نرم‌افزار Android کیف پول Google» مجموعه‌ای از روش‌های راحت را برای کار با Google Wallet API در برنامه‌های Android شما ارائه می‌دهد، مانند ایجاد و صدور مجوز.
افزودن به «کیف پول Google»
دکمه «افزودن به کیف پول Google»
دکمه «افزودن به کیف پول Google» دارایی موردتأیید Google برای ارائه مجوز به کاربر است. وقتی کاربر روی دکمه کلیک یا ضربه می‌زند، باید پیوند «افزودن به کیف پول Google» راه‌اندازی شود تا جریان افزودن مجوز صادرشده به «کیف پول Google» کاربر شروع شود.
توصیه می‌شود هرجا ممکن بود از دکمه «افزودن به کیف پول Google» استفاده کنید، زیرا این دکمه عنصر میانای کاربر آشنایی است که کاربران شما ازقبل می‌دانند چگونه با آن تعامل کنند.
دارایی‌ها و دستورالعمل‌های استفاده از دکمه در دستورالعمل‌های نمانام Google Wallet API دردسترس است.
پیوند «افزودن به کیف پول Google»
با پیوند «افزودن به کیف پول Google»، می‌توانید با اَبَرپیوند معمولی مجوزی برای کاربر صادر کنید. از این پیوند می‌توانید در هر جایی که امکان استفاده از اَبَرپیوند وجود دارد استفاده کنید، مثلاً ایمیل، پیامک، وب‌سایت، و برنامه‌های تلفن همراه.
پیوندهای «افزودن به کیف پول Google» با پیوست کردن یک JWT امضاشده به نشانی وب https://pay.google.com/gp/v/save/ ایجاد می‌شوند.
حساب صادرکننده
حالت نمایشی
وقتی حساب «صادرکننده» خود را ایجاد می‌کنید، تا زمانی که برای دسترسی انتشار تأیید شوید، در «حالت نمایشی» خواهد بود. در حالت نمایشی می‌توانید مجوز ایجاد کنید، اما فقط می‌توانید آن‌ها را برای کاربرانی صادر کنید که نقش «سرپرست» یا «توسعه‌دهنده» حساب «صادرکننده» شما را دارند، یا کاربرانی که به‌عنوان حساب آزمایشی در کنسول «کیف پول Google» اضافه شده‌اند.
وقتی در «حالت نمایشی» هستید، عنوان هر مجوزی که صادر می‌کنید به‌طور خودکار با عبارت «[TEST ONLY]» (فقط آزمایشی) شروع می‌شود تا نشان دهد که این مجوز فقط برای اهداف آزمایشی است.
حساب‌های آزمایشی
وقتی حساب «صادرکننده» شما در «حالت نمایشی» است، اگر می‌خواهید برای کاربری که نقش‌های «سرپرست» یا «توسعه‌دهنده» را برای حساب شما ندارد مجوز صادر کنید، باید او را به‌عنوان حساب آزمایشی در کنسول «کیف پول Google» اضافه کنید. کاربرانی که به‌عنوان حساب آزمایشی ثبت‌نام کرده‌اند می‌توانند مجوزهای صادرشده توسط شما را به «کیف پول Google» خود اضافه کنند. این برای آزمایش کردن مجوزهایتان با مخاطبان گسترده‌تر درحالی‌که در «حالت نمایش» هستید مفید است.
نمایه کسب‌وکار
برای ایجاد حساب «صادرکننده» برای «میانای برنامه‌سازی کاربردی کیف پول Google»، باید هنگام ثبت‌نام در «کنسول کیف پول و Google Pay»، نمایه کسب‌وکار راه‌اندازی کنید. نمایه کسب‌وکار اطلاعات پایه درباره شرکت یا سازمانتان را به Google ارائه می‌دهد و برای تأیید شدن دسترسی انتشار الزامی است.
دسترسی انتشار
پیش‌از اینکه بتوانید مجوزهایی صادر کنید که هر کاربری بتواند در «کیف پول Google» خود ذخیره کند، باید برای دسترسی انتشار تأیید شوید. برای تأیید شدن دسترسی انتشار، باید حداقل یک «کلاس مجوز» ایجاد کرده باشید و نمایه کسب‌وکار کاملی داشته باشید. صادرکنندگانی که می‌خواهند بااستفاده از «کیت توسعه نرم‌افزار Android کیف پول Google» مجوز صادر کنند باید اثر انگشت SHA-1 را نیز برای برنامه‌شان ارسال کنند.
برای درخواست دسترسی انتشار، به کنسول «کیف پول Google» بروید و روی دکمه «درخواست دسترسی انتشار» کلیک کنید. تیم «کیف پول Google» درخواست شما را بررسی خواهد کرد و پس‌از اعطای دسترسی انتشار به شما اطلاع خواهد داد.
اصالت‌سنجی
JSON Web Token (JWT)
«نشان‌های وب JSON» یک استاندارد صنعتی رایج برای انتقال ایمن اطلاعات به‌عنوان یک شیء JSON است. هنگام استفاده از Google Wallet API، جزئیات Passes Object را که می‌خواهید برای ایجاد نمونه مجوز استفاده کنید، در قالب JWT (تلفظ «jot») کدگذاری می‌کنید، سپس آن JWT را در درخواستی به Google Wallet API ارسال می‌کنید.
JWTها با امضا شدن با یک رمز مشترک قبل‌از ارسال به Google Wallet API، ایمن نگه داشته می‌شوند. اگر از Google Wallet REST API استفاده می‌کنید، رمز امضا کلید حساب سرویس Google Cloud شما است. اگر از کیت توسعه نرم‌افزار Android «کیف پول Google» استفاده می‌کنید، رمز امضا اثر انگشت SHA-1 برای برنامه Android شما است.
حساب سرویس
حساب سرویس Google Cloud نوع خاصی از حساب است که معمولاً توسط یک برنامه یا بار کاری محاسباتی استفاده می‌شود، نه یک شخص. در مورد Google Wallet API، حساب سرویس چیزی است که برای اصالت‌سنجی درخواست‌های ارسال‌شده به Google Wallet REST API استفاده خواهید کرد.
حساب‌های خدمات در کنسول Google Cloud ایجاد می‌شوند. برای استفاده از حساب سرویس، باید میانای برنامه‌سازی کاربردی کیف پول Google را در «کنسول Cloud» فعال کنید تا حساب سرویس بتواند برای «میانای برنامه‌سازی کاربردی کیف پول Google» درخواست REST ارسال کند.
کلید حساب سرویس
کلید حساب سرویس اعتباری است که برای اصالت‌سنجی فراخوانی‌های «میانای برنامه‌سازی کاربردی» Google Wallet REST استفاده خواهید کرد. کلید حساب سرویس بسیار حساس تلقی می‌شود و باید خصوصی نگه داشته شود، زیرا بااستفاده از Google Wallet REST API، دسترسی به بسیاری از ویژگی‌های «صادرکننده کارت» حساب شما را اعطا می‌کند، ازجمله ایجاد «کلاس‌های کارت» و «اشیاء کارت».
اثر انگشت اس‌اچ‌اِی-۱
اثر انگشت SHA-1 گواهینامه امضای برنامه Android شما اطلاعات اعتباری‌ای است که هنگام استفاده از «کیت توسعه نرم‌افزار Android کیف پول Google» برای اصالت‌سنجی فراخوانی‌های «میانای برنامه‌سازی کاربردی کیف پول Google» استفاده خواهید کرد. اثر انگشت SHA-1 گواهینامه شما بااستفاده از Gradle یا keytool تولید می‌شود. برای استفاده از اثر انگشت برای اصالت‌سنجی درخواست‌هایتان، باید آن را در کنسول «کیف پول Google» ثبت کنید.