مفاهیم و اصطلاحات کلیدی

این سند اصطلاحات و مفاهیم رایجی را که هنگام استفاده از Google Wallet API باید با آنها آشنا باشید فهرست می کند.

پاس می دهد

عبور

پاس نمونه‌ای از یک Object Passes است که برای کاربر صادر می‌شود تا در Google Wallet خود ذخیره کند. Google Wallet API از تعدادی از انواع مجوزهای رایج، از جمله کارت پرواز، بلیط رویداد، کارت شناسایی و موارد دیگر پشتیبانی می کند. Google Wallet API همچنین یک نوع پاس عمومی ارائه می‌کند که می‌تواند برای ایجاد مجوزهایی استفاده شود که به‌طور خاص پشتیبانی نمی‌شوند.

در بیشتر موارد، یک پاس با استفاده از یک کلاس پاس و یک شیء عبور ایجاد می شود.

صادرکننده مجوز

صادرکننده مجوز، نهادی است که مجوز ایجاد می‌کند و آن‌ها را برای کاربران صادر می‌کند تا در Google Wallet خود ذخیره کنند. صادرکننده گذرنامه مالک مجوزها است و می تواند آنها را ایجاد، صادر و به روز کند. صادرکنندگان مجوز می‌توانند توسعه‌دهندگان، شرکت‌ها و سازمان‌ها، و همچنین جمع‌آوری‌کننده‌هایی باشند که از طرف دیگران مجوز ایجاد و صادر می‌کنند، مانند شرکتی که در اجرای بلیط رویدادها یا کوپن‌ها برای خرده‌فروشان متخصص است.

بیشتر بدانید

کلاس را پاس می کند

یک کلاس پاس را می توان به عنوان یک الگوی مشترک در نظر گرفت که پاس ها از آن ایجاد می شوند. یک کلاس Passes ویژگی‌های خاصی را تعریف می‌کند که در همه پاس‌هایی که از آن استفاده می‌کنند گنجانده می‌شوند. یک صادرکننده مجوز می‌تواند چندین کلاس ایجاد کند، که هر کدام مجموعه‌ای از ویژگی‌های خاص خود را دارند که ویژگی‌هایی مانند سبک و ظاهر و همچنین ویژگی‌های اضافی مانند Smart Tap و ثبت نام و ورود به سیستم را تعریف می‌کنند.

در بیشتر موارد، یک پاس با ارائه یک کلاس پاس برای تعریف الگوی پاس، و یک شی پاس برای تعریف ویژگی های پاس فردی صادر شده ایجاد می شود.

بیشتر بدانید

Object را پاس می کند

یک Object Passes یک مجوز فردی را تعریف می کند که برای کاربر صادر می شود تا در Google Wallet خود ذخیره کند. Pass Object ها اغلب حاوی اطلاعات خاص کاربر هستند. به عنوان مثال، در حالی که یک کلاس Passes ممکن است تعریف کند که کارت هدیه برای یک فروشگاه خاص چگونه خواهد بود، Object Passes جزئیات خاصی مانند موجودی یا تاریخ انقضا را ارائه می دهد.

برای هر پاسی که صادر می‌شود، باید یک Object Passes ایجاد شود، در مقابل کلاس‌های پاس که می‌توانند در بسیاری از نمونه‌های پاس به اشتراک گذاشته شوند.

بیشتر بدانید

پاس های خصوصی

برخی از مجوزهایی که با Google Wallet API ایجاد می‌کنید ممکن است حاوی داده‌های حساس کاربر باشد. این مجوزها برای کمک به ایمن نگه داشتن داده‌های کاربران شما به محافظت بیشتری نیاز دارند و با استفاده از نوع مجوز عمومی عمومی، در Google Wallet API متفاوت مدیریت می‌شوند. مجوز عمومی خصوصی باید در مواردی استفاده شود که داده‌های حساس (همانطور که در خط‌مشی استفاده قابل قبول API Google Wallet تعریف شده است) در گذرنامه شما گنجانده شده است، و ممکن است تحت کنترل‌های حریم خصوصی اضافی و بازبینی در حین ورود باشد.

بیشتر بدانید

ضربه هوشمند

Smart Tap یک پروتکل ارتباطی میدان نزدیک اختصاصی گوگل برای انتقال داده ها بین یک دستگاه تلفن همراه و یک ترمینال NFC است. فناوری Smart Tap به کاربران اجازه می‌دهد با نزدیک نگه داشتن تلفن خود در نزدیکی هر پایانه NFC سازگار، مجوزهای ذخیره شده در Google Wallet خود را پس‌خرید کنند.

برای استفاده از پروتکل Smart Tap با مجوزهای خود، باید با ارائه‌دهنده ترمینال دارای Smart Tap ارتباط برقرار کنید.

بیشتر بدانید

API ها و SDK

Google Wallet API

Google Wallet API سرویسی است که توسط Google ارائه می‌شود و به شما امکان می‌دهد مجوزهایی را برای کاربران ایجاد و صادر کنید تا در Google Wallets خود ذخیره کنند. API را می توان به روش های مختلف استفاده کرد، از جمله Google Wallet REST API، Google Wallet Android SDK، و کنسول Google Wallet.

Google Wallet REST API

Google Wallet REST API رابطی برای ایجاد و مدیریت گذرنامه‌ها به صورت برنامه‌نویسی با ارسال درخواست‌های HTTP به Google Wallet API است.

برای استفاده از Google Wallet REST API، همچنین به یک حساب Google Cloud برای ایجاد یک حساب سرویس نیاز دارید که برای تأیید اعتبار درخواست‌های Google Wallet REST API استفاده می‌شود.

Google Wallet Android SDK

Google Wallet Android SDK مجموعه‌ای از روش‌های راحت را برای کار با Google Wallet API در برنامه‌های Android شما ارائه می‌کند، مانند ایجاد و صدور مجوز.

به Google Wallet اضافه کنید

دکمه «افزودن به Google Wallet».

دکمه «افزودن به Google Wallet» یک دارایی مورد تأیید Google برای ارائه مجوز به کاربر است. وقتی کاربر روی دکمه کلیک یا ضربه می‌زند، پیوند «افزودن به Google Wallet» باید فعال شود تا جریان افزودن مجوز صادر شده به Google Wallet کاربر شروع شود.

توصیه می‌شود در صورت امکان از دکمه «افزودن به Google Wallet» استفاده کنید، زیرا این یک عنصر رابط کاربری آشنا است که کاربران شما از قبل می‌دانند چگونه با آن تعامل داشته باشند.

دارایی‌ها و دستورالعمل‌های استفاده از دکمه در دستورالعمل‌های برند Google Wallet API موجود است.

با پیوند «افزودن به کیف پول Google»، می‌توانید برای کاربری با یک پیوند معمولی مجوز صادر کنید. این را می توان در هر جایی که بتوانید از هایپرلینک ها استفاده کنید، مانند ایمیل، پیامک، وب سایت ها و برنامه های تلفن همراه استفاده کنید.

پیوندهای «افزودن به Google Wallet» با الحاق یک JWT امضا شده به URL https://pay.google.com/gp/v/save/ ایجاد می‌شوند.

حساب صادرکننده

حالت نمایشی

وقتی حساب صادرکننده خود را ایجاد می‌کنید، تا زمانی که برای دسترسی به انتشار تأیید نشوید، در «حالت آزمایشی» خواهد بود. در حالت نمایشی می‌توانید مجوز ایجاد کنید، اما فقط می‌توانید آن‌ها را برای کاربرانی که نقش‌های «مدیر» یا «توسعه‌دهنده» حساب صادرکننده شما یا کاربرانی که به‌عنوان حساب‌های آزمایشی در کنسول Google Wallet اضافه شده‌اند، صادر کنید.

در حالت نمایشی، عنوان هر مجوزی که صادر می‌کنید به‌طور خودکار با کلمات «[TEST ONLY]» شروع می‌شود تا نشان دهد که مجوز فقط برای اهداف آزمایشی است.

حساب های آزمایشی

وقتی حساب صادرکننده شما در «حالت نمایشی» است، اگر می‌خواهید برای هر کاربری که نقش «سرپرست» یا «توسعه‌دهنده» را برای حساب شما ندارد، مجوز صادر کنید، باید آن‌ها را به‌عنوان حساب‌های آزمایشی در کنسول Google Wallet اضافه کنید. . کاربرانی که به عنوان حساب های آزمایشی ثبت نام کرده اند، می توانند مجوزهای صادر شده توسط شما را به کیف پول Google خود اضافه کنند. این برای آزمایش پاس‌های شما با مخاطبان گسترده‌تر در حالت نمایشی مفید است.

نمایه تجاری

برای ایجاد یک حساب صادرکننده برای Google Wallet API، هنگام ثبت نام برای کنسول Google Pay & Wallet، باید یک نمایه کسب‌وکار راه‌اندازی کنید. نمایه کسب‌وکار اطلاعات اولیه درباره شرکت یا سازمان شما را در اختیار Google قرار می‌دهد و برای دسترسی به انتشار باید تأیید شود.

بیشتر بدانید

دسترسی به انتشار

قبل از اینکه بتوانید مجوزهایی را صادر کنید که هر کاربری می تواند در Google Wallet خود ذخیره کند، باید برای انتشار مجوز دسترسی داشته باشید. برای تأیید دسترسی به انتشار، باید حداقل یک کلاس پاس ایجاد کرده باشید و یک نمایه تجاری کامل داشته باشید. صادرکنندگانی که می خواهند با استفاده از Google Wallet Android SDK مجوز صادر کنند، باید اثر انگشت SHA-1 را برای برنامه خود ارسال کنند.

برای درخواست دسترسی انتشار، به کنسول Google Wallet بروید و روی دکمه «درخواست دسترسی انتشار» کلیک کنید. تیم Google Wallet درخواست شما را بررسی می‌کند و پس از اینکه به شما اجازه انتشار داده شد، به شما اطلاع می‌دهد.

بیشتر بدانید

احراز هویت

JSON Web Token (JWT)

JSON Web Tokens یک استاندارد صنعتی رایج برای انتقال امن اطلاعات به عنوان یک شی JSON است. هنگام استفاده از Google Wallet API، جزئیات شی Passes را که می‌خواهید برای ایجاد یک نمونه پاس در قالب JWT (تلفظ "jot") استفاده کنید، رمزگذاری می‌کنید، سپس آن JWT را در یک درخواست به Google Wallet API ارسال می‌کنید.

JWT ها با امضای آنها با یک راز مشترک قبل از ارسال به Google Wallet API ایمن نگه داشته می شوند. اگر از Google Wallet REST API استفاده می‌کنید، رمز امضای کلید حساب سرویس Google Cloud شما است. اگر از Google Wallet Android SDK استفاده می‌کنید، راز امضا اثر انگشت SHA-1 برای برنامه Android شما است.

حساب سرویس

حساب سرویس Google Cloud نوع خاصی از حساب است که معمولاً توسط یک برنامه کاربردی یا حجم کاری محاسبه می‌شود، نه یک شخص. در مورد Google Wallet API، یک حساب سرویس چیزی است که برای تأیید اعتبار درخواست‌های ارسال شده به Google Wallet REST API استفاده می‌کنید.

حساب‌های سرویس در کنسول Google Cloud ایجاد می‌شوند. برای استفاده از یک حساب سرویس، همچنین باید Google Wallet API را در کنسول Cloud فعال کنید تا به حساب سرویس اجازه دهد تا درخواست‌هایی را برای Google Wallet REST API ارسال کند.

بیشتر بدانید

کلید حساب سرویس

یک کلید حساب سرویس، اعتباری است که برای احراز هویت تماس‌ها با Google Wallet REST API استفاده می‌کنید. کلید حساب سرویس بسیار حساس در نظر گرفته می‌شود و باید خصوصی نگه داشته شود، زیرا با استفاده از Google Wallet REST API به بسیاری از ویژگی‌های Pass Issuer حساب شما دسترسی می‌دهد، از جمله ایجاد Passes Classes و Passes Objects.

بیشتر بدانید

اثر انگشت SHA-1

اثر انگشت SHA-1 گواهی امضای برنامه Android شما اعتباری است که هنگام استفاده از Google Wallet Android SDK از آن برای احراز هویت تماس‌ها با Google Wallet API استفاده می‌کنید. اثر انگشت SHA-1 گواهی شما با استفاده از Gradle یا Keytool ایجاد می‌شود. برای استفاده از اثر انگشت برای احراز هویت درخواست های خود، باید آن را در کنسول Google Wallet ثبت کنید.

بیشتر بدانید