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