شروع کردن
Google Wallet API چیست؟
Google Wallet API به توسعه دهندگان اجازه می دهد تا مجوزهای دیجیتالی را در Google Wallet ایجاد کنند. Google Wallet API در حال حاضر از کارت‌های پرواز، بلیت‌های رویداد، کارت‌های وفاداری، پیشنهادات و کارت‌های حمل‌ونقل پشتیبانی می‌کند. اخیراً، یک نوع پاس عمومی برای پشتیبانی از موارد استفاده اضافی اضافه شده است.
چگونه می توانم محیط برنامه نویس خود را بر اساس نیازها و پیچیدگی های تجاری خود تنظیم کنم؟
در زیر راهنماهایی وجود دارد که می‌توان از آنها برای راه‌اندازی یک محیط توسعه برای سطوح مختلف پیچیدگی و امنیت کسب‌وکار استفاده کرد. استفاده از حساب‌های سرویس چندگانه می‌تواند توسعه‌دهندگان را قادر به ایجاد یک محیط TEST جدا از محیط PROD خود کند.
پیچیدگی راه اندازی اولیه
1 حساب کنسول کسب و کار یا 1 حساب مادر کنسول کسب و کار به بسیاری از حساب های صادرکننده.
- این گزینه یک رویکرد مدیریت مرکزی را با استفاده از 1 حساب اصلی با صفر تا بسیاری از کسب و کارها/صاحبان فرعی فعال می کند.
- 1 پروژه Google Cloud.
- 1 اعتبار حساب سرویس.
- تک مجموعه ای از کاربران.
متوسط پیچیدگی راه اندازی
1 حساب مادر به بسیاری از حساب های صادرکننده.
- این گزینه یک رویکرد مدیریت مرکزی را با استفاده از 1 حساب اصلی با بسیاری از مشاغل فرعی فعال می کند.
- 1 Google Cloud Project.
- کاربران کنسول کسب و کار متمایز در هر صادرکننده.
- 1 به بسیاری از اعتبار حساب خدمات.
- 1 اعتبار برای هر کسب و کار/ صادرکننده.
- دسترسی به اعتبار متفاوت در هر کسب و کار
پیچیدگی راه اندازی پیچیده
1 حساب مادر به بسیاری از حساب های صادرکننده.
- این گزینه یک رویکرد مدیریت مرکزی را با استفاده از 1 حساب اصلی با بسیاری از مشاغل فرعی فعال می کند.
- 1 به بسیاری از پروژه های Google Cloud.
- کاربران کنسول کسب و کار متمایز در هر صادرکننده.
- 1 به بسیاری از اعتبار حساب خدمات.
- 1 اعتبار PROD برای هر کسب و کار/ صادرکننده.
- 1 اعتبار DEV برای هر کسب و کار/ صادرکننده.
کار با پاس ها
چگونه کلاس ها یا اشیاء را حذف کنم؟
در حال حاضر، نمی‌توانید کلاس‌ها یا اشیاء را از Google Wallet حذف کنید. با این حال، کاربران می توانند اشیاء را از کیف پول Google خود حذف کنند .
چگونه چندین پاس را با هم گروه کنم؟
استفاده از GroupingID گروه بندی پاس ها را با هم آسان می کند.
چگونه فقط بخشی از یک پاس را به روز کنم؟
راهنمای عملکرد ما را دنبال کنید تا نحوه انجام به‌روزرسانی‌های جزئی با استفاده از درخواست‌های PATCH را بدانید.
آیا می توانم به صورت دسته ای پاس ایجاد کنم؟
راهنمای عملکرد ما را دنبال کنید تا نحوه انجام درخواست های دسته ای با استفاده از API را بدانید.
سوالات عمومی
محدودیت نرخ درخواست‌های ارسال شده به Google Wallet API چقدر است؟
نرخ تماس با Google Wallet API به 20 درخواست در ثانیه محدود می شود.
چرا قرار گرفتن تصاویر شخصی در کارت‌های Google Wallet ممنوع است؟
Google Wallet از تصاویر شخصی در مجوزها پشتیبانی نمی‌کند، زیرا مقررات فعلی بیان می‌کند که همه مصرف‌کنندگان حق دارند از جمع‌آوری یا پردازش داده‌های حساس انصراف دهند. با داشتن داده‌های حساس (تصاویر شخصی) به عنوان بخشی از شی با ارزش (در JWT)، ممکن است نگرانی‌هایی برای میزبانی وجود داشته باشد که در آن داده‌ها ممکن است عمومی شوند که خارج از توافقنامه رضایت اصلی است. برای اطمینان از محرمانه بودن داده ها، تصاویر شخصی مجاز نیستند. ما در حال کار برای پشتیبانی از تصاویر شخصی در آینده هستیم.
چه کدهای خطایی توسط Google Wallet API برگردانده می شود؟
برای فهرستی از کدهای خطا و استثناهای برگردانده شده توسط Google Wallet API، به کدهای خطا مراجعه کنید.چگونه اعلان‌های فشاری را فعال کنم؟
اعلان‌های ارسالی توسط برنامه‌نویس در حال حاضر توسط Google Wallet پشتیبانی نمی‌شوند. با این حال Google Wallet اعلان‌های به‌موقع را برای مجوزهای زیر ارائه می‌کند. اعلان‌های ارسالی توسط برنامه‌نویس در حال حاضر توسط Google Wallet پشتیبانی نمی‌شوند.
| عمودی | اطلاع رسانی | باعث شد | مستندات |
|---|---|---|---|
| رویداد | یادآوری آینده | 3 ساعت قبل از مراسم | اسناد |
| کارت پرواز | یادآوری آینده | 3 ساعت قبل از حرکت پرواز | اسناد |
| کارت پرواز | پاس به روز رسانی | ترمینال مبدا، دروازه، زمان سوار شدن یا تغییر زمان حرکت | اسناد |
| کارت پیشنهاد | یادآوری انقضا | 48 ساعت قبل از انقضای کارت پیشنهاد | اسناد |
| عمومی | یادآوری آینده | 24 ساعت قبل از شروع "فاصله زمانی". | اسناد |
| عمومی | یادآوری انقضا | 48 ساعت قبل از پایان "زمان داخلی". | اسناد |
آیا شناسه های تجاری قابل حذف هستند؟
در حال حاضر، شناسه‌های تاجر را نمی‌توان از Google Pay و Wallet Console حذف یا بایگانی کرد.
چگونه از ویژگی Applinking استفاده کنم؟
برای پیوند دادن به برنامه نیاز به فهرست مجوزهایی است که می‌توانید از اینجا درخواست کنید.
آیا Google Wallet از Geofencing پشتیبانی می کند؟
Geofencing در حال حاضر پشتیبانی نمی شود.
چگونه یک برنامه وفاداری راه اندازی کنم؟
با دنبال کردن این راهنما می توانید یک برنامه ثبت نام و وفاداری راه اندازی کنید.
چگونه لوگوی خود را برای مجوزهای حمل و نقل به Google ارسال کنم؟
لطفاً از این فرم برای ارسال لوگوی Google برای فهرست مجاز استفاده کنید.
چگونه به درستی داده های UserProfile رمزگذاری شده Base64 را مدیریت کنیم؟
اطمینان حاصل کنید که از رمزگذاری UTF-8 در طول فرآیند خود استفاده می کنید. رشته JSON ابتدا با UTF-8 کدگذاری می شود و سپس با استفاده از android.util.Base64 با گزینه های NO_WRAP و URL_SAFE کدگذاری می شود. این با RFC 3548 بخش 4 مطابقت دارد.
چگونه می توانم حساب های صادرکننده را به صورت برنامه ریزی شده ایجاد کنم؟
برای ایجاد حساب های صادرکننده از طریق API به این راهنما مراجعه کنید.
ضربه هوشمند
آیا برای مجوزهای Google SmartTap به یک خواننده NFC ویژه نیاز دارم؟
باید یک ترمینال با قابلیت SmartTap باشد. لیستی از ارائه دهندگان تایید شده را می توانید در اینجا بیابید.
چگونه پاس‌هایم را با NFC کار کنم؟
لطفاً این پیکربندی را دنبال کنید تا پاس خود را فعال کنید تا Smart Tap قابل بازخرید باشد.
توکن های وب JSON (JWT)
آیا ابزارهایی وجود دارند که پیاده سازی و اشکال زدایی JWT ها را ساده می کنند؟
بله، پلتفرم‌هایی مانند www.jwt.io به شما امکان می‌دهند توکن‌های خود را در طول فرآیند توسعه خود رمزگشایی و اشکال‌زدایی کنید و به شما امکان می‌دهند محتوایی را که ارسال می‌کنید تأیید کنید. توجه داشته باشید که Google هیچ وابستگی ندارد و به طور خاص هیچ یک از این اشخاص ثالث را توصیه نمی کند.
URL پیوند JWT من از محدودیت مرورگر 1800 نویسه بیشتر است. چه کار کنم؟
می توانید قبل از ایجاد پیوند ذخیره پاس (JWT) با استفاده از API کلاس ها و اشیاء را از قبل ایجاد کنید .
عیب یابی
چرا تنظیم زمان من زمان اشتباه را برای رویداد نمایش می دهد؟
زمان نمایش داده شده در گذرنامه، زمان محلی رویداد است، با افست زمانی که رویداد در آن است.
لوگوی من در پاس هایی که ساخته ام ارائه نمی شود. چه اشکالی می تواند داشته باشد؟
- ابتدا مطمئن شوید که لوگوی شما از دستورالعمل ها پیروی می کند و در قالب PNG ذخیره می شود.
- اطمینان حاصل کنید که لوگو به راحتی با قابلیت اطمینان بالا در دسترس است. به فایل های تصویری که می تواند باعث خطای 404 شود هدایت نکنید. تصاویر شما باید در مکان HTTPS میزبانی شوند زیرا در غیر این صورت در Google Wallet قابل مشاهده نخواهند بود.
- اطمینان حاصل کنید که تمام فیلدهای الزامی که در API به عنوان الزامی علامت‌گذاری شده‌اند در پاس تنظیم شده باشند.
پشتیبانی و بازخورد
چگونه با پشتیبانی فنی تماس بگیرم؟
برای راهنمایی بیشتر، با کلیک روی دکمه «تماس با پشتیبانی» در نوار کناری کنسول Google Pay و Wallet با تیم پشتیبانی تماس بگیرید.
چگونه بازخورد محصول را بگذارم؟
برای ارسال بازخورد محصول، روی دکمه "ارسال بازخورد" در ربع سمت راست بالای صفحه سایت توسعه دهنده کلیک کنید و "بازخورد محصول" را انتخاب کنید. سپس، بازخورد خود را در قسمت متن توضیح دهید و روی «ارسال» کلیک کنید.
چگونه می توانم بازخورد اسناد را بگذارم؟
برای ارسال بازخورد مستندات، روی دکمه "ارسال بازخورد" در ربع سمت راست بالای صفحه سایت توسعه دهنده کلیک کنید و "بازخورد اسناد" را انتخاب کنید. سپس، بازخورد خود را در قسمت متن توضیح دهید و روی «ارسال» کلیک کنید.