Google Play Developer APIs

نمای کلی

«کنسول 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 به شما امکان می‌دهد تکالیف معمول مربوط به توزیع برنامه را خودکارسازی کنید. این 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 غیرضروری جلوگیری شود. وقتی برنامه‌تان نیاز به درستی‌سنجی اشتراک دارد، باید به‌جای تکرار فراخوانی میانای برنامه‌سازی کاربردی به Google، به اطلاعات ذخیره‌شده در حافظه نهان سرورتان تکیه کنید.
  • دو سناریو وجود دارد که در آن‌ها سرور امن شما باید از Google Play Developer API برای دریافت اطلاعات اشتراک استفاده کند:
    • سرور شما یک توکن خرید جدید دریافت می‌کند که قبلاً دیده نشده است.
    • سرور شما اعلان بی‌درنگ توسعه‌دهنده (RTDN) دریافت می‌کند که نشان می‌دهد باید از رمز خرید برای دریافت اطلاعات اشتراک جدید استفاده کنید.
  • به‌طور منظم برای وضعیت اشتراک، API را نظرسنجی نکنید. برای مثال، برای بررسی هر اشتراک، API را روزانه فراخوانی نکنید.
  • ازآنجایی‌که وقتی اشتراک منقضی یا تمدید می‌شود، RTDN دریافت می‌کنید، نیازی نیست فراخوانی میانای برنامه‌سازی کاربردی را براساس زمان انقضای زمان‌بندی‌شده زمان‌بندی کنید.

میانای برنامه‌سازی کاربردی گزارش‌دهی

Reporting API برای توسعه‌دهندگانی است که می‌خواهند گردش‌های کاری خودکارشده روی داده‌های «کنسول Play» بسازند، یا توسعه‌دهندگانی که از داده‌های «کنسول Play» برای گزارش‌دهی و تحلیل کسب‌وکار داخلی، احتمالاً درکنار دیگر مجموعه‌های داده، استفاده می‌کنند. این API امکان دسترسی برنامه‌ریزی‌شده به داده‌ها و سنجه‌ها را در سطح برنامه برای گزارش‌دهی داخلی، تجزیه‌وتحلیل، و خودکارسازی به شما ارائه می‌دهد.

میانای برنامه‌سازی کاربردی گزارش‌دهی دسترسی به داده‌های معیارهای کلیدی Android را ارائه می‌دهد، ازجمله نرخ خرابی، نرخ ANR، مشکلات بیدار شدن و قفل بیداری، و ردیابی‌های پشته‌ای خطا.

روال‌های مطلوب

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 سفارش را لغو یا مسترد می‌کند.

بااستفاده از این میانای برنامه‌سازی کاربردی، به ایجاد تجربه‌ای متعادل‌تر و عادلانه‌تر برای همه کاربران برنامه‌تان کمک می‌کنید، به‌ویژه اگر برنامه‌تان بازی باشد.