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