نمای کلی
«کنسول Google Play» مجموعه‌ای از میاناهای برنامه‌سازی کاربردی سرویس وب مبتنی بر REST ارائه می‌دهد که به شما امکان می‌دهد عملکردهای انتشار، گزارش‌دهی، و سایر عملکردهای مدیریت برنامه را مستقیماً برای برنامه‌تان انجام دهید.
همه توسعه‌دهندگان نیاز به استفاده از این میاناهای برنامه‌سازی کاربردی توسعه‌دهنده ندارند — در بیشتر موارد می‌توانید به مدیریت مستقیم برنامه‌هایتان بااستفاده از «کنسول Google Play» ادامه دهید. بااین‌حال، اگر تعداد زیادی APK برای مدیریت دارید، یا باید خریدها و اشتراک‌های کاربر را ردیابی کنید، ممکن است این میاناهای برنامه‌سازی کاربردی برایتان مفید باشد.
آنچه در بسته گنجانده شده است
میاناهای Google Play Developer API به شما اجازه می‌دهند بر طراحی و توسعه برنامه‌تان تمرکز کنید و درعین‌حال زمان و تلاش کمتری را صرف مدیریت نسخه‌های پخش کنید، حتی زمانی که به بازارهای جدید گسترش پیدا می‌کنید.
«کنسول Google Play» شامل مجموعه‌ای از میاناهای برنامه‌سازی کاربردی است که می‌توانید از آن‌ها برای مدیریت برنامه‌تان استفاده کنید:
- Publishing API به شما امکان می‌دهد برنامه‌ها را بارگذاری و منتشر کنید، و دیگر کارهای مربوط به انتشار را انجام دهید.
- Subscriptions and In-App Purchases API به شما امکان می‌دهد خریدهای درون‌برنامه و اشتراک‌ها را مدیریت کنید. (این API قبلاً با نام «Purchase Status API» شناخته می‌شد.)
- Reporting API به شما امکان می‌دهد اطلاعات مربوط به کیفیت برنامه‌تان را از «معیارهای کلیدی Android» بازیابی کنید.
- Reply to Reviews API به شما امکان می‌دهد مرورهای برنامه‌تان را بازیابی کنید و به آن‌ها پاسخ دهید.
- Permissions API به شما امکان می‌دهد مدیریت اجازه‌ها را در «کنسول Play» خودکارسازی کنید.
- Play Games Services Management API به شما امکان می‌دهد تماس‌های REST را برای کنترل برنامه‌ای فراداده‌های زیربنایی ویژگی‌های «سرویس‌های بازی‌های Google Play» صادر کنید.
- Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌دهد.
شروع کردن
برای شروع کار با Google Play Developer APIs، به سند شروع کار مراجعه کنید.
Publishing API
Publishing API به شما اجازه می‌دهد تکالیف معمول را که باید درخصوص توزیع برنامه انجام دهید خودکارسازی کنید. این میانای برنامه‌سازی کاربردی عملکردهایی مشابه عملکردهای دردسترس توسعه‌دهنده ازطریق «کنسول Play» ارائه می‌دهد، ازجمله:
- بارگذاری نسخه‌های جدید برنامه
- انتشار برنامه‌ها با اختصاص دادن فایل‌های APK به دسته‌های هدف مختلف (آلفا، بتا، عرضه گام‌به‌گام، یا تولید)
- ایجاد و اصلاح فهرستگان‌های «فروشگاه Google Play»، ازجمله نوشتار بومی‌سازی‌شده و گرافیک و نماگرفت‌های چنددستگاهی
این وظایف بااستفاده از عملکرد ویرایش‌ها انجام می‌شود که رویکردی تراکنشی برای ایجاد تغییرات دارد. این به شما امکان می‌دهد چندین تغییر را در یک ویرایش پیش‌نویس دسته‌بندی کنید، سپس همه تغییرات را به‌طور هم‌زمان اعمال کنید. (هیچ‌کدام از تغییرات تا زمانی که ویرایش نهایی نشود اعمال نمی‌شود.)
روال‌های مطلوب
- تعداد به‌روزرسانی‌های برنامه را محدود کنید. به‌روزرسانی‌های آلفا یا بتا را بیشتر از یک بار در روز منتشر نکنید (برنامه‌های تولید باید حتی کمتر از این تعداد به‌روزرسانی شوند). هر به‌روزرسانی برای کاربران شما هزینه زمانی و احتمالاً مالی دارد. اگر بیش‌ازحد به‌روزرسانی کنید، ممکن است کاربران به‌روزرسانی‌ها را نادیده بگیرند یا حتی محصول را حذف نصب کنند.
Subscriptions and In-App Purchases API
Subscriptions and In-App Purchases API
به شما امکان می‌دهد کاتالوگ محصولات درون‌برنامه‌ای و اشتراک‌های برنامه‌تان را مدیریت کنید. علاوه‌براین، بااستفاده از
Subscriptions and In-App Purchases API، می‌توانید به‌سرعت جزئیات
هر خریدی را بااستفاده از درخواست استاندارد GET بازیابی کنید.
در درخواست، اطلاعاتی درباره خرید ارائه می‌دهید — نام بسته برنامه، شناسه خرید یا اشتراک، و توکن خرید. سرور با یک شیء JSON پاسخ می‌دهد که جزئیات خرید مرتبط، وضعیت سفارش، محموله توسعه‌دهنده، و اطلاعات دیگر را شرح می‌دهد.
می‌توانید از این API به روش‌های مختلفی استفاده کنید، مثلاً برای گزارش‌دهی و تطبیق سفارش‌های تکی و برای تأیید خریدها و انقضای اشتراک. همچنین می‌توانید از API برای اطلاع از سفارش‌های لغوشده و تأیید اینکه آیا محصولات درون‌برنامه مصرف شده‌اند یا نه، ازجمله اینکه آیا قبل‌از لغو شدن مصرف شده‌اند یا نه، استفاده کنید.
روال‌های مطلوب
- اطلاعات اشتراک را در سرورتان ذخیره کنید تا از برقراری تماس‌های API غیرضروری جلوگیری شود. وقتی برنامه‌تان نیاز به درستی‌سنجی اشتراک دارد، باید به‌جای تکرار فراخوانی میانای برنامه‌سازی کاربردی به Google، به اطلاعات ذخیره‌شده در حافظه نهان سرورتان اتکا کنید.
- دو سناریو وجود دارد که در آن‌ها سرور امن شما باید از Google Play Developer API برای دریافت اطلاعات اشتراک استفاده کند:
- سرور شما یک کد خرید جدید دریافت می‌کند که قبلاً دیده نشده است.
- سرور شما اعلان بی‌درنگ توسعه‌دهنده (RTDN) دریافت می‌کند که نشان می‌دهد باید از کد خرید برای دریافت اطلاعات اشتراک جدید استفاده کنید.
- به‌طور منظم برای وضعیت اشتراک، API را نظرسنجی نکنید. برای مثال، برای بررسی هر اشتراک، API را روزانه فراخوانی نکنید.
- ازآنجایی‌که وقتی اشتراک منقضی یا تمدید می‌شود، RTDN دریافت می‌کنید، نیازی نیست براساس زمان انقضای زمان‌بندی‌شده، تماس API را زمان‌بندی کنید.
میانای برنامه‌سازی کاربردی گزارش‌دهی
Reporting API برای توسعه‌دهندگانی است که می‌خواهند گردش‌های کاری خودکارشده را روی داده‌های «کنسول Play» بسازند، یا توسعه‌دهندگانی که از داده‌های «کنسول Play» برای گزارش‌دهی و تحلیل کسب‌وکار داخلی، احتمالاً درکنار دیگر مجموعه‌های داده، استفاده می‌کنند. این API امکان دسترسی برنامه‌ریزی‌شده به داده‌ها و سنجه‌ها را در سطح برنامه برای انجام گزارش‌دهی داخلی، تجزیه‌وتحلیل، و خودکارسازی به شما ارائه می‌دهد.
Reporting API امکان دسترسی به داده‌های معیارهای کلیدی Android را فراهم می‌کند، ازجمله میزان خرابی، میزان خطای ANR، مشکلات بیدار شدن و قفل بیداری، و ردیابی‌های پشته‌ای خطا.
روال‌های مطلوب
- این نسخه از Reporting API حد پیش‌فرض ۱۰ پُرسمان در ثانیه را دارد. می‌توانید مصرف سهمیه‌تان را در بخش سهمیه‌ها در Google Cloud Console مشاهده کنید. اگر لازم است از این حد فراتر بروید، می‌توانید بااستفاده از این فرم درخواست سهمیه ارسال کنید.
Reply to Reviews API
Reply to Reviews API به شما امکان می‌دهد بازخورد کاربر را برای برنامه‌تان مشاهده کنید و به این بازخورد پاسخ دهید. می‌توانید از این میانای برنامه‌سازی کاربردی برای تعامل با کاربران مستقیماً در جعبه ابزار پشتیبانی مشتری موجود خود، مانند سیستم CRM، استفاده کنید.
Reply to Reviews API به شما امکان می‌دهد فقط به بازخورد نسخه‌های تولیدی برنامه‌تان دسترسی داشته باشید. اگر می‌خواهید بازخورد نسخه‌های آلفا یا بتای برنامه‌تان را ببینید، به‌جای آن از «کنسول Google Play» استفاده کنید. همچنین توجه داشته باشید که API فقط مرورهایی را نشان می‌دهد که حاوی نظر باشند. اگر کاربری به برنامه شما رده‌بندی بدهد اما نظری ارائه نکند، بازخورد او ازطریق API دردسترس نخواهد بود.
Permissions API
Permissions API به توسعه‌دهندگان امکان می‌دهد مدیریت اجازه‌ها را در «کنسول Play» خودکارسازی کنند. این کار به شما امکان می‌دهد کنترل انعطاف‌پذیری بر افرادی که به حساب توسعه‌دهنده شما دسترسی دارند داشته باشید، بدون اینکه نیاز به دخالت دستی باشد.
با Permissions API، می‌توانید عملکردهای مدیریتی مانند موارد زیر را انجام دهید:
- برداشتن دسترسی کاربران وقتی شرکت شما را ترک می‌کنند.
- اعطای دسترسی به برنامه وقتی کاربر به تیم مربوطه می‌پیوندد.
Voided purchases API
Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌دهد. می‌توانید از اطلاعات این فهرست برای پیاده‌سازی سیستم لغو استفاده کنید که مانع از دسترسی کاربر به محصولات آن سفارش‌ها می‌شود.
این میانای برنامه‌سازی کاربردی برای سفارش‌های درون‌برنامه‌ای یک‌باره و اشتراک‌های برنامه اعمال می‌شود.
خرید را می‌توان به روش‌های زیر باطل کرد:
- کاربر برای سفارش خود درخواست استرداد مبلغ می‌کند.
- کاربر سفارش خود را لغو کند.
- سفارشی برگردانده شود.
- توسعه‌دهنده سفارش را لغو یا مسترد می‌کند. توجه: فقط سفارش‌های لغوشده در Voided Purchases API نشان داده می‌شود. اگر توسعه‌دهنده بدون تنظیم گزینه لغو بازپرداخت کند، سفارش‌ها در API نشان داده نخواهد شد.
- Google سفارش را لغو یا مسترد می‌کند.
بااستفاده از این میانای برنامه‌سازی کاربردی، به ایجاد تجربه‌ای متعادل‌تر و عادلانه‌تر برای همه کاربران برنامه‌تان کمک می‌کنید، به‌ویژه اگر برنامه‌تان بازی باشد.