شروع به کار
رابط برنامهنویسی کاربردی (API) کیف پول گوگل چیست؟
رابط برنامهنویسی کاربردی (API) کیف پول گوگل (Google Wallet API) به توسعهدهندگان اجازه میدهد تا در کیف پول گوگل، کارتهای عبور دیجیتال ایجاد کنند. رابط برنامهنویسی کاربردی کیف پول گوگل در حال حاضر از کارتهای پرواز، بلیطهای رویدادها، کارتهای وفاداری، پیشنهادات ویژه و کارتهای حمل و نقل عمومی پشتیبانی میکند. اخیراً، یک نوع کارت عبور عمومی برای پشتیبانی از موارد استفاده بیشتر اضافه شده است.
چگونه میتوانم محیط توسعه خود را بر اساس الزامات و پیچیدگیهای کسبوکارم تنظیم کنم؟
در زیر راهنماهایی وجود دارد که میتوانند برای راهاندازی یک محیط توسعه که سطوح مختلف پیچیدگی و امنیت کسبوکار را برآورده میکند، استفاده شوند. استفاده از چندین حساب سرویس میتواند توسعهدهندگان را قادر سازد تا یک محیط TEST جدا از محیط PROD خود ایجاد کنند.
پیچیدگی تنظیمات اولیه
۱ حساب کنسول تجاری یا ۱ حساب مادر کنسول تجاری به چندین حساب صادرکننده.
- این گزینه یک رویکرد مدیریتشدهی متمرکز را با استفاده از یک حساب اصلی با صفر تا چندین کسبوکار/صادرکنندهی فرعی امکانپذیر میکند.
- ۱ پروژه ابری گوگل.
- ۱ اعتبارنامه حساب کاربری سرویس.
- مجموعه واحدی از کاربران.
پیچیدگی متوسط راه اندازی
یک حساب مادر به چندین حساب صادرکننده.
- این گزینه یک رویکرد مدیریتشدهی متمرکز را با استفاده از یک حساب اصلی و بسیاری از کسبوکارهای فرعی امکانپذیر میکند.
- ۱ پروژه ابری گوگل.
- کاربران کنسول تجاری مجزا برای هر صادرکننده.
- اعتبارنامههای حساب سرویس از ۱ تا چندین.
- ۱ اعتبارنامه برای هر کسبوکار/صادرکننده.
- دسترسی به اعتبارنامههای مختلف برای هر کسبوکار.
پیچیدگی تنظیمات پیچیده
یک حساب مادر به چندین حساب صادرکننده.
- این گزینه یک رویکرد مدیریتشدهی متمرکز را با استفاده از یک حساب اصلی و بسیاری از کسبوکارهای فرعی امکانپذیر میکند.
- ۱ تا بسیاری از پروژههای ابری گوگل.
- کاربران کنسول تجاری مجزا برای هر صادرکننده.
- اعتبارنامههای حساب سرویس از ۱ تا چندین.
- ۱ گواهی PROD برای هر کسبوکار/صادرکننده.
- ۱ اعتبارنامه DEV برای هر کسبوکار/صادرکننده.
کار با پاسها
چگونه کلاسها یا اشیاء را حذف کنم؟
در حال حاضر، شما نمیتوانید کلاسها یا اشیاء را از Google Wallet حذف کنید. با این حال، کاربران میتوانند اشیاء را از Google Wallet خود جدا کنند .
چگونه میتوانم چندین پاس را با هم گروهبندی کنم؟
استفاده از GroupingID گروهبندی کردن مسیرها را آسان میکند.
چگونه میتوانم فقط بخشی از یک گذر را بهروزرسانی کنم؟
برای درک نحوه انجام بهروزرسانیهای جزئی با استفاده از درخواستهای PATCH، راهنمای عملکرد ما را دنبال کنید.
آیا میتوانم به صورت دستهای رمز عبور ایجاد کنم؟
برای درک نحوه انجام درخواستهای دستهای با استفاده از API ، راهنمای عملکرد ما را دنبال کنید.
سوالات عمومی
محدودیت نرخ درخواستهای ارسالی به API کیف پول گوگل چقدر است؟
تعداد درخواستهای API کیف پول گوگل به 20 درخواست در ثانیه محدود شده است.
مدت زمان توصیه شده برای درخواستهای ارسالی به API کیف پول گوگل چقدر است؟
رابط برنامهنویسی کاربردی کیف پول گوگل (Google Wallet API) توافقنامه سطح خدمات (SLA) رسمی ندارد، اما ما بر اساس تأخیر ۹۹ درصدی حدود ۵ ثانیه، زمان تأخیر ۱۰ ثانیه را توصیه میکنیم. همچنین توجه داشته باشید که تأخیر اغلب به عوامل خارجی بستگی دارد، مانند زمان لازم برای دریافت تصویری که در یک سرور خارجی میزبانی میشود هنگام درج یک شیء با آن تصویر، زیرا این به تأخیر سرور خارجی بستگی دارد.
چرا قرار دادن تصاویر شخصی روی کارتهای اعتباری گوگل والت ممنوع است؟
کیف پول گوگل از تصاویر شخصی روی کارتهای اعتباری پشتیبانی نمیکند، زیرا مقررات فعلی بیان میکند که همه مصرفکنندگان حق دارند از جمعآوری یا پردازش دادههای حساس خودداری کنند. با داشتن دادههای حساس (تصاویر شخصی) به عنوان بخشی از شیء ارزشمند (در یک JWT)، ممکن است نگرانیهایی در مورد میزبانی وجود داشته باشد که در آن دادهها ممکن است عمومی شوند که خارج از توافقنامه رضایت اولیه است. برای اطمینان از محرمانه بودن دادهها، تصاویر شخصی مجاز نیستند. ما در تلاشیم تا در آینده از تصاویر شخصی پشتیبانی کنیم.
چه کدهای خطایی توسط API کیف پول گوگل برگردانده میشوند؟
برای فهرستی از کدهای خطا و استثنائاتی که توسط API کیف پول گوگل برگردانده میشوند، به کدهای خطا مراجعه کنید.چگونه اعلانهای فوری (Push Notifications) را فعال کنم؟
اعلانهای ارسالی توسعهدهنده در حال حاضر توسط گوگل والت پشتیبانی نمیشوند. با این حال، گوگل والت برای مراحل بعدی اعلانهای بهموقع ارائه میدهد. اعلانهای ارسالی توسعهدهنده در حال حاضر توسط گوگل والت پشتیبانی نمیشوند.
| عمودی | اعلان | فعال شده | مستندات |
|---|---|---|---|
| رویداد | یادآوری آینده | ۳ ساعت قبل از مراسم | اسناد |
| کارت سوار شدن به هواپیما | یادآوری آینده | ۳ ساعت قبل از حرکت پرواز | اسناد |
| کارت سوار شدن به هواپیما | بهروزرسانی عبور | ترمینال مبدا، گیت، زمان سوار شدن به هواپیما یا تغییر زمان حرکت | اسناد |
| کارت پیشنهاد | یادآوری انقضا | ۴۸ ساعت قبل از انقضای کارت تخفیف | اسناد |
| عمومی | یادآوری آینده | ۲۴ ساعت قبل از شروع «فاصله زمانی» | اسناد |
| عمومی | یادآوری انقضا | ۴۸ ساعت قبل از پایان «زمان داخلی» | اسناد |
آیا میتوان شناسههای فروشنده را حذف کرد؟
در حال حاضر، شناسههای فروشنده را نمیتوان از کنسول Google Pay & Wallet حذف یا بایگانی کرد.
چگونه از ویژگی Applinking استفاده کنم؟
اتصال به اپلیکیشن نیاز به فهرست مجاز دارد که میتوانید از اینجا درخواست دهید.
آیا گوگل والت از Geofencing پشتیبانی میکند؟
در حال حاضر از Geofencing پشتیبانی نمیشود.
چگونه یک برنامه وفاداری راهاندازی کنم؟
شما میتوانید با دنبال کردن این راهنما، یک برنامه ثبتنام و وفاداری راهاندازی کنید.
چگونه لوگوی خود را برای کارتهای حمل و نقل عمومی به گوگل ارسال کنم؟
لطفاً از این فرم برای ارسال لوگو به گوگل جهت قرار گرفتن در فهرست استفاده کنید.
چگونه میتوان دادههای userProfile کدگذاری شده با Base64 را به درستی مدیریت کرد؟
مطمئن شوید که در طول فرآیند خود از کدگذاری UTF-8 استفاده میکنید. رشته JSON ابتدا با UTF-8 کدگذاری میشود و متعاقباً با استفاده از android.util.Base64 با گزینههای NO_WRAP و URL_SAFE کدگذاری میشود. این با بخش ۴ RFC 3548 مطابقت دارد.
چگونه میتوانم حسابهای صادرکننده را از طریق برنامهنویسی ایجاد کنم؟
برای ایجاد حسابهای صادرکننده از طریق API، به این راهنما مراجعه کنید.
شیر هوشمند
آیا برای استفاده از کارتهای اعتباری Google SmartTap به یک دستگاه NFC خوان مخصوص نیاز دارم؟
باید یک ترمینال با قابلیت SmartTap باشد. فهرستی از ارائه دهندگان مجاز را میتوانید اینجا پیدا کنید.
چگونه میتوانم کارتهای اعتباریام را با NFC سازگار کنم؟
لطفاً این تنظیمات را دنبال کنید تا کارت شما قابلیت استفاده از Smart Tap را داشته باشد.
توکنهای وب JSON (JWT)
آیا ابزارهایی وجود دارند که پیادهسازی و اشکالزدایی JWTها را ساده کنند؟
بله، پلتفرمهایی مانند www.jwt.io به شما امکان میدهند توکنهای خود را در طول فرآیند توسعه رمزگشایی و اشکالزدایی کنید و محتوایی را که ارسال میکنید تأیید کنید. توجه داشته باشید که گوگل هیچ وابستگی ندارد و به طور خاص هیچ یک از این اشخاص ثالث را توصیه نمیکند.
آدرس لینک JWT من از محدودیت ۱۸۰۰ کاراکتری مرورگر عبور کرده است. چه کاری باید انجام دهم؟
شما میتوانید قبل از ایجاد لینک ذخیره (JWT)، کلاسها و اشیاء را با استفاده از API از قبل ایجاد کنید .
عیبیابی
چرا تنظیمات زمان من، زمان اشتباهی را برای رویداد نشان میدهد؟
زمان نمایش داده شده روی کارت، زمان محلی رویداد است و با زمان محل برگزاری رویداد، اختلاف زمانی دارد.
لوگوی من روی Pass هایی که ساختهام رندر نمیشود. مشکل از کجا میتواند باشد؟
- اول از همه، مطمئن شوید که لوگوی شما از دستورالعملها پیروی میکند و با فرمت PNG ذخیره شده است.
- مطمئن شوید که لوگو با قابلیت اطمینان بالا به راحتی در دسترس است. به فایلهای تصویری که میتوانند باعث خطای ۴۰۴ شوند، ریدایرکت نکنید. تصاویر شما باید در محل HTTPS میزبانی شوند زیرا در غیر این صورت در Google Wallet قابل مشاهده نخواهند بود.
- مطمئن شوید که تمام فیلدهای الزامی که در API به عنوان الزامی علامتگذاری شدهاند، در گذرنامه نیز تنظیم شدهاند.
پشتیبانی و بازخورد
چگونه با پشتیبانی فنی تماس بگیرم؟
برای راهنمایی بیشتر، با کلیک روی دکمه «تماس با پشتیبانی» در نوار کناری سمت چپ کنسول Google Pay و Wallet با تیم پشتیبانی تماس بگیرید.
چگونه میتوانم بازخورد محصول را ثبت کنم؟
برای ارسال بازخورد محصول، روی دکمه «ارسال بازخورد» در ربع بالا سمت راست صفحه سایت توسعهدهنده کلیک کنید و «بازخورد محصول» را انتخاب کنید. سپس، بازخورد خود را در قسمت متن شرح دهید و روی «ارسال» کلیک کنید.
چگونه میتوانم بازخورد مستندات را ثبت کنم؟
برای ارسال بازخورد در مورد مستندات، روی دکمه «ارسال بازخورد» در ربع بالا سمت راست صفحه سایت توسعهدهنده کلیک کنید و «بازخورد مستندات» را انتخاب کنید. سپس، بازخورد خود را در قسمت متن شرح دهید و روی «ارسال» کلیک کنید.