API های برنامه نویس Google Play

نمای کلی

کنسول Google Play مجموعه‌ای از APIهای سرویس وب مبتنی بر REST را ارائه می‌کند که به شما امکان می‌دهد انتشار، گزارش‌دهی و سایر عملکردهای مدیریت برنامه را مستقیماً برای برنامه خود انجام دهید.

همه برنامه‌نویس‌ها نیازی به استفاده از این API‌های توسعه‌دهنده ندارند - در بیشتر موارد می‌توانید مستقیماً با استفاده از کنسول Google Play به مدیریت برنامه‌های خود ادامه دهید. با این حال، اگر تعداد زیادی APK برای مدیریت دارید، یا مجبور هستید خریدها و اشتراک‌های کاربران را ردیابی کنید، ممکن است این APIها را مفید بدانید.

چه چیزی گنجانده شده است

APIهای برنامه‌نویس Google Play به شما امکان می‌دهند روی طراحی و توسعه برنامه‌تان تمرکز کنید، در حالی که زمان و تلاش کمتری را برای مدیریت نسخه‌های خود صرف می‌کنید، حتی وقتی به بازارهای جدید رشد می‌کنید.

کنسول Google Play شامل مجموعه‌ای از API است که می‌توانید برای مدیریت برنامه خود از آنها استفاده کنید:

  • Publishing API به شما امکان می دهد برنامه ها را آپلود و منتشر کنید و سایر وظایف مربوط به انتشار را انجام دهید.
  • API اشتراک ها و خریدهای درون برنامه ای به شما امکان می دهد خریدها و اشتراک های درون برنامه ای را مدیریت کنید. (این قبلا به عنوان "API وضعیت خرید" شناخته می شد.)
  • گزارش API به شما امکان می دهد اطلاعات مربوط به کیفیت برنامه خود را از حیاتی اندروید بازیابی کنید.
  • API Reply to Reviews به شما امکان می دهد نظرات برنامه خود را بازیابی کرده و به آنها پاسخ دهید.
  • Permissions API به شما امکان می دهد مدیریت مجوزها را در Play Console به صورت خودکار انجام دهید.
  • API مدیریت خدمات بازی‌های Play به شما امکان می‌دهد برای کنترل برنامه‌ای فراداده‌های زیربنای ویژگی‌های خدمات بازی‌های Google Play، تماس‌های REST صادر کنید.
  • Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند.

شروع کردن

برای شروع کار با API های برنامه نویس Google Play، به مستندات شروع کار مراجعه کنید.

انتشار API

Publishing API به شما امکان می دهد کارهای مکرر مرتبط با توزیع برنامه را خودکار کنید. این کارکردهایی مشابه عملکردهایی را که از طریق کنسول Play در اختیار یک برنامه‌نویس قرار می‌گیرد، ارائه می‌کند، مانند:

  • آپلود نسخه های جدید یک برنامه
  • انتشار برنامه‌ها، با اختصاص فایل‌های APK به آهنگ‌های مختلف (آلفا، بتا، عرضه مرحله‌ای، یا تولید)
  • ایجاد و اصلاح فهرست‌های فروشگاه Google Play، از جمله متن و گرافیک بومی‌سازی شده و اسکرین‌شات‌های چند دستگاهی

این وظایف با استفاده از قابلیت ویرایش انجام می‌شوند، که یک رویکرد تراکنشی برای ایجاد تغییرات دارد. این به شما امکان می دهد چندین تغییر را در یک ویرایش پیش نویس یکپارچه کنید، سپس تغییرات را به یکباره انجام دهید. (تا زمانی که ویرایش انجام نشود هیچ یک از تغییرات اعمال نمی شود.)

بهترین شیوه ها

  • تعداد به‌روزرسانی‌های برنامه را محدود کنید. به‌روزرسانی‌های آلفا یا بتا را بیشتر از یک بار در روز منتشر نکنید (برنامه‌های تولیدی باید حتی کمتر از آن به‌روزرسانی شوند). هر به‌روزرسانی برای کاربران شما زمان و احتمالاً هزینه دارد. اگر به‌طور مکرر به‌روزرسانی می‌کنید، کاربران ممکن است شروع به نادیده گرفتن به‌روزرسانی‌ها کنند یا حتی محصول را حذف نصب کنند.

API اشتراک ها و خریدهای درون برنامه ای

API اشتراک‌ها و خریدهای درون‌برنامه به شما امکان می‌دهد کاتالوگ محصولات درون‌برنامه و اشتراک‌های برنامه خود را مدیریت کنید. علاوه بر این، با API اشتراک‌ها و خریدهای درون‌برنامه‌ای، می‌توانید به سرعت جزئیات هر خریدی را با استفاده از درخواست استاندارد GET بازیابی کنید.

در درخواست، اطلاعاتی درباره خرید ارائه می‌کنید - نام بسته برنامه، شناسه خرید یا اشتراک، و رمز خرید. سرور با یک شی JSON پاسخ می دهد که جزئیات خرید مرتبط، وضعیت سفارش، بار توسعه دهنده و سایر اطلاعات را شرح می دهد.

می‌توانید از این API به روش‌های مختلفی استفاده کنید، مانند گزارش‌دهی و تطبیق سفارش‌های فردی و تأیید خریدها و انقضای اشتراک. همچنین می‌توانید از API برای اطلاع از سفارش‌های لغو شده استفاده کنید و تأیید کنید که آیا محصولات درون‌برنامه مصرف شده‌اند، از جمله اینکه آیا قبل از لغو مصرف شده‌اند یا خیر.

بهترین شیوه ها

  • اطلاعات اشتراک را در سرور خود ذخیره کنید تا از برقراری تماس های غیر ضروری API جلوگیری کنید. هنگامی که برنامه شما نیاز به تأیید اشتراک دارد، به جای تکرار تماس API با Google، باید به اطلاعات ذخیره شده روی سرور خود تکیه کنید.
  • دو حالت وجود دارد که در آن سرور امن شما باید از Google Play Developer API برای دریافت اطلاعات اشتراک استفاده کند:
    • سرور شما یک رمز خرید جدید دریافت می کند که قبلاً دیده نشده است.
    • سرور شما یک اعلان توسعه دهنده بلادرنگ (RTDN) دریافت می کند که نشان می دهد برای دریافت اطلاعات اشتراک جدید باید از رمز خرید استفاده کنید.
  • از API برای وضعیت اشتراک به طور منظم نظرسنجی نکنید. به عنوان مثال، برای بررسی هر اشتراک روزانه با API تماس نگیرید.
  • از آنجایی که زمانی که اشتراک منقضی می شود یا تمدید می شود، یک RTDN دریافت می کنید، نیازی به برنامه ریزی تماس API بر اساس زمان انقضای برنامه ریزی شده ندارید.

گزارش API

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

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

بهترین شیوه ها

  • این نسخه از Reporting API دارای محدودیت پیش فرض 10 پرس و جو در ثانیه است. می‌توانید میزان استفاده از سهمیه خود را در بخش سهمیه‌ها در Google Cloud Console مشاهده کنید. اگر نیاز به تجاوز از این حد دارید، می‌توانید با استفاده از این فرم درخواست سهمیه ارسال کنید.

پاسخ به نظرات API

Reply to Reviews API به شما امکان می دهد بازخورد کاربران را برای برنامه خود مشاهده کنید و به این بازخورد پاسخ دهید. شما می توانید از این API برای تعامل مستقیم با کاربران در جعبه ابزار پشتیبانی مشتری فعلی خود، مانند یک سیستم CRM، استفاده کنید.

Reply to Reviews API به شما امکان می دهد فقط برای نسخه های تولیدی برنامه خود به بازخورد دسترسی داشته باشید. اگر می‌خواهید بازخورد مربوط به نسخه‌های آلفا یا بتا برنامه خود را ببینید، به جای آن از کنسول Google Play استفاده کنید. همچنین، توجه داشته باشید که API فقط نظراتی را نشان می‌دهد که شامل نظرات هستند. اگر کاربری به برنامه شما امتیاز دهد اما نظری ارائه نکند، بازخورد او از API قابل دسترسی نیست.

API مجوزها

Permissions API به توسعه دهندگان این امکان را می دهد که مدیریت مجوزها را در کنسول Play به طور خودکار انجام دهند . این به شما امکان می دهد بدون دخالت دستی، کنترل انعطاف پذیری بر روی افرادی که به حساب توسعه دهنده شما دسترسی دارند، داشته باشید.

با Permissions API، می توانید عملکردهای مدیریتی مانند:

  • حذف دسترسی کاربران هنگام خروج از شرکت شما.
  • اعطای دسترسی به یک برنامه زمانی که کاربر به تیم مربوطه می‌پیوندد.

API خریدهای باطل شد

Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند. می‌توانید از اطلاعات این فهرست برای پیاده‌سازی یک سیستم ابطال استفاده کنید که از دسترسی کاربر به محصولات آن سفارش‌ها جلوگیری می‌کند.

این API برای سفارشات درون‌برنامه‌ای یک‌باره و اشتراک‌های برنامه اعمال می‌شود.

خرید را می توان به روش های زیر باطل کرد:

  • کاربر برای سفارش خود درخواست بازپرداخت می کند.
  • کاربر سفارش خود را لغو می کند.
  • یک سفارش پس گرفته می شود.
  • برنامه‌نویس سفارش را لغو یا بازپرداخت می‌کند. توجه: فقط سفارش‌های لغو شده در API خریدهای باطل نشان داده می‌شوند. اگر برنامه‌نویس بدون تنظیم گزینه ابطال، وجه را بازپرداخت کند، سفارش‌ها در API نشان داده نمی‌شوند.
  • Google سفارش را لغو یا بازپرداخت می کند.

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

،

نمای کلی

کنسول Google Play مجموعه‌ای از APIهای سرویس وب مبتنی بر REST را ارائه می‌کند که به شما امکان می‌دهد انتشار، گزارش‌دهی و سایر عملکردهای مدیریت برنامه را مستقیماً برای برنامه خود انجام دهید.

همه برنامه‌نویس‌ها نیازی به استفاده از این API‌های توسعه‌دهنده ندارند - در بیشتر موارد می‌توانید مستقیماً با استفاده از کنسول Google Play به مدیریت برنامه‌های خود ادامه دهید. با این حال، اگر تعداد زیادی APK برای مدیریت دارید، یا مجبور هستید خریدها و اشتراک‌های کاربران را ردیابی کنید، ممکن است این APIها را مفید بدانید.

چه چیزی گنجانده شده است

APIهای برنامه‌نویس Google Play به شما امکان می‌دهند روی طراحی و توسعه برنامه‌تان تمرکز کنید، در حالی که زمان و تلاش کمتری را برای مدیریت نسخه‌های خود صرف می‌کنید، حتی وقتی به بازارهای جدید رشد می‌کنید.

کنسول Google Play شامل مجموعه‌ای از API است که می‌توانید برای مدیریت برنامه خود از آنها استفاده کنید:

  • Publishing API به شما امکان می دهد برنامه ها را آپلود و منتشر کنید و سایر وظایف مربوط به انتشار را انجام دهید.
  • API اشتراک ها و خریدهای درون برنامه ای به شما امکان می دهد خریدها و اشتراک های درون برنامه ای را مدیریت کنید. (این قبلا به عنوان "API وضعیت خرید" شناخته می شد.)
  • گزارش API به شما امکان می دهد اطلاعات مربوط به کیفیت برنامه خود را از حیاتی اندروید بازیابی کنید.
  • API Reply to Reviews به شما امکان می دهد نظرات برنامه خود را بازیابی کرده و به آنها پاسخ دهید.
  • Permissions API به شما امکان می دهد مدیریت مجوزها را در Play Console به صورت خودکار انجام دهید.
  • API مدیریت خدمات بازی‌های Play به شما امکان می‌دهد برای کنترل برنامه‌ای فراداده‌های زیربنای ویژگی‌های خدمات بازی‌های Google Play، تماس‌های REST صادر کنید.
  • Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند.

شروع کردن

برای شروع کار با API های برنامه نویس Google Play، به مستندات شروع کار مراجعه کنید.

انتشار API

Publishing API به شما امکان می دهد کارهای مکرر مرتبط با توزیع برنامه را خودکار کنید. این کارکردهایی مشابه عملکردهایی را که از طریق کنسول Play در اختیار یک برنامه‌نویس قرار می‌گیرد، ارائه می‌کند، مانند:

  • آپلود نسخه های جدید یک برنامه
  • انتشار برنامه‌ها، با اختصاص فایل‌های APK به آهنگ‌های مختلف (آلفا، بتا، عرضه مرحله‌ای، یا تولید)
  • ایجاد و اصلاح فهرست‌های فروشگاه Google Play، از جمله متن و گرافیک بومی‌سازی شده و اسکرین‌شات‌های چند دستگاهی

این وظایف با استفاده از قابلیت ویرایش انجام می‌شوند، که یک رویکرد تراکنشی برای ایجاد تغییرات دارد. این به شما امکان می دهد چندین تغییر را در یک ویرایش پیش نویس یکپارچه کنید، سپس تغییرات را به یکباره انجام دهید. (تا زمانی که ویرایش انجام نشود هیچ یک از تغییرات اعمال نمی شود.)

بهترین شیوه ها

  • تعداد به‌روزرسانی‌های برنامه را محدود کنید. به‌روزرسانی‌های آلفا یا بتا را بیشتر از یک بار در روز منتشر نکنید (برنامه‌های تولیدی باید حتی کمتر از آن به‌روزرسانی شوند). هر به‌روزرسانی برای کاربران شما زمان و احتمالاً هزینه دارد. اگر به‌طور مکرر به‌روزرسانی می‌کنید، کاربران ممکن است شروع به نادیده گرفتن به‌روزرسانی‌ها کنند یا حتی محصول را حذف نصب کنند.

API اشتراک ها و خریدهای درون برنامه ای

API اشتراک‌ها و خریدهای درون‌برنامه به شما امکان می‌دهد کاتالوگ محصولات درون‌برنامه و اشتراک‌های برنامه خود را مدیریت کنید. علاوه بر این، با API اشتراک‌ها و خریدهای درون‌برنامه‌ای، می‌توانید به سرعت جزئیات هر خریدی را با استفاده از درخواست استاندارد GET بازیابی کنید.

در درخواست، اطلاعاتی درباره خرید ارائه می‌کنید - نام بسته برنامه، شناسه خرید یا اشتراک، و رمز خرید. سرور با یک شی JSON پاسخ می دهد که جزئیات خرید مرتبط، وضعیت سفارش، بار توسعه دهنده و سایر اطلاعات را شرح می دهد.

می‌توانید از این API به روش‌های مختلفی استفاده کنید، مانند گزارش‌دهی و تطبیق سفارش‌های فردی و تأیید خریدها و انقضای اشتراک. همچنین می‌توانید از API برای اطلاع از سفارش‌های لغو شده استفاده کنید و تأیید کنید که آیا محصولات درون‌برنامه مصرف شده‌اند، از جمله اینکه آیا قبل از لغو مصرف شده‌اند یا خیر.

بهترین شیوه ها

  • اطلاعات اشتراک را در سرور خود ذخیره کنید تا از برقراری تماس های غیر ضروری API جلوگیری کنید. هنگامی که برنامه شما نیاز به تأیید اشتراک دارد، به جای تکرار تماس API با Google، باید به اطلاعات ذخیره شده روی سرور خود تکیه کنید.
  • دو حالت وجود دارد که در آن سرور امن شما باید از Google Play Developer API برای دریافت اطلاعات اشتراک استفاده کند:
    • سرور شما یک رمز خرید جدید دریافت می کند که قبلاً دیده نشده است.
    • سرور شما یک اعلان توسعه دهنده بلادرنگ (RTDN) دریافت می کند که نشان می دهد برای دریافت اطلاعات اشتراک جدید باید از رمز خرید استفاده کنید.
  • از API برای وضعیت اشتراک به طور منظم نظرسنجی نکنید. به عنوان مثال، برای بررسی هر اشتراک روزانه با API تماس نگیرید.
  • از آنجایی که زمانی که اشتراک منقضی می شود یا تمدید می شود، یک RTDN دریافت می کنید، نیازی به برنامه ریزی تماس API بر اساس زمان انقضای برنامه ریزی شده ندارید.

گزارش API

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

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

بهترین شیوه ها

  • این نسخه از Reporting API دارای محدودیت پیش فرض 10 پرس و جو در ثانیه است. می‌توانید میزان استفاده از سهمیه خود را در بخش سهمیه‌ها در Google Cloud Console مشاهده کنید. اگر نیاز به تجاوز از این حد دارید، می‌توانید با استفاده از این فرم درخواست سهمیه ارسال کنید.

پاسخ به نظرات API

Reply to Reviews API به شما امکان می دهد بازخورد کاربران را برای برنامه خود مشاهده کنید و به این بازخورد پاسخ دهید. شما می توانید از این API برای تعامل مستقیم با کاربران در جعبه ابزار پشتیبانی مشتری فعلی خود، مانند یک سیستم CRM، استفاده کنید.

Reply to Reviews API به شما امکان می دهد فقط برای نسخه های تولیدی برنامه خود به بازخورد دسترسی داشته باشید. اگر می‌خواهید بازخورد مربوط به نسخه‌های آلفا یا بتا برنامه خود را ببینید، به جای آن از کنسول Google Play استفاده کنید. همچنین، توجه داشته باشید که API فقط نظراتی را نشان می‌دهد که شامل نظرات هستند. اگر کاربری به برنامه شما امتیاز دهد اما نظری ارائه نکند، بازخورد او از API قابل دسترسی نیست.

API مجوزها

Permissions API به توسعه دهندگان این امکان را می دهد که مدیریت مجوزها را در کنسول Play به طور خودکار انجام دهند . این به شما امکان می دهد بدون دخالت دستی، کنترل انعطاف پذیری بر روی افرادی که به حساب توسعه دهنده شما دسترسی دارند، داشته باشید.

با Permissions API، می توانید عملکردهای مدیریتی مانند:

  • حذف دسترسی کاربران هنگام خروج از شرکت شما.
  • اعطای دسترسی به یک برنامه زمانی که کاربر به تیم مربوطه می‌پیوندد.

API خریدهای باطل شد

Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند. می‌توانید از اطلاعات این فهرست برای پیاده‌سازی یک سیستم ابطال استفاده کنید که از دسترسی کاربر به محصولات آن سفارش‌ها جلوگیری می‌کند.

این API برای سفارشات درون‌برنامه‌ای یک‌باره و اشتراک‌های برنامه اعمال می‌شود.

خرید را می توان به روش های زیر باطل کرد:

  • کاربر برای سفارش خود درخواست بازپرداخت می کند.
  • کاربر سفارش خود را لغو می کند.
  • یک سفارش پس گرفته می شود.
  • برنامه‌نویس سفارش را لغو یا بازپرداخت می‌کند. توجه: فقط سفارش‌های لغو شده در API خریدهای باطل نشان داده می‌شوند. اگر برنامه‌نویس بدون تنظیم گزینه ابطال، وجه را بازپرداخت کند، سفارش‌ها در API نشان داده نمی‌شوند.
  • Google سفارش را لغو یا بازپرداخت می کند.

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

،

نمای کلی

کنسول Google Play مجموعه‌ای از APIهای سرویس وب مبتنی بر REST را ارائه می‌کند که به شما امکان می‌دهد انتشار، گزارش‌دهی و سایر عملکردهای مدیریت برنامه را مستقیماً برای برنامه خود انجام دهید.

همه برنامه‌نویس‌ها نیازی به استفاده از این API‌های توسعه‌دهنده ندارند - در بیشتر موارد می‌توانید مستقیماً با استفاده از کنسول Google Play به مدیریت برنامه‌های خود ادامه دهید. با این حال، اگر تعداد زیادی APK برای مدیریت دارید، یا مجبور هستید خریدها و اشتراک‌های کاربران را ردیابی کنید، ممکن است این APIها را مفید بدانید.

چه چیزی گنجانده شده است

APIهای برنامه‌نویس Google Play به شما امکان می‌دهند روی طراحی و توسعه برنامه‌تان تمرکز کنید، در حالی که زمان و تلاش کمتری را برای مدیریت نسخه‌های خود صرف می‌کنید، حتی وقتی به بازارهای جدید رشد می‌کنید.

کنسول Google Play شامل مجموعه‌ای از API است که می‌توانید برای مدیریت برنامه خود از آنها استفاده کنید:

  • Publishing API به شما امکان می دهد برنامه ها را آپلود و منتشر کنید و سایر وظایف مربوط به انتشار را انجام دهید.
  • API اشتراک ها و خریدهای درون برنامه ای به شما امکان می دهد خریدها و اشتراک های درون برنامه ای را مدیریت کنید. (این قبلا به عنوان "API وضعیت خرید" شناخته می شد.)
  • گزارش API به شما امکان می دهد اطلاعات مربوط به کیفیت برنامه خود را از حیاتی اندروید بازیابی کنید.
  • API Reply to Reviews به شما امکان می دهد نظرات برنامه خود را بازیابی کرده و به آنها پاسخ دهید.
  • Permissions API به شما امکان می دهد مدیریت مجوزها را در Play Console به صورت خودکار انجام دهید.
  • API مدیریت خدمات بازی‌های Play به شما امکان می‌دهد برای کنترل برنامه‌ای فراداده‌های زیربنای ویژگی‌های خدمات بازی‌های Google Play، تماس‌های REST صادر کنید.
  • Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند.

شروع کردن

برای شروع کار با API های برنامه نویس Google Play، به مستندات شروع کار مراجعه کنید.

انتشار API

Publishing API به شما امکان می دهد کارهای مکرر مرتبط با توزیع برنامه را خودکار کنید. این کارکردهایی مشابه عملکردهایی را که از طریق کنسول Play در اختیار یک برنامه‌نویس قرار می‌گیرد، ارائه می‌کند، مانند:

  • آپلود نسخه های جدید یک برنامه
  • انتشار برنامه‌ها، با اختصاص فایل‌های APK به آهنگ‌های مختلف (آلفا، بتا، عرضه مرحله‌ای، یا تولید)
  • ایجاد و اصلاح فهرست‌های فروشگاه Google Play، از جمله متن و گرافیک بومی‌سازی شده و اسکرین‌شات‌های چند دستگاهی

این وظایف با استفاده از قابلیت ویرایش انجام می‌شوند، که یک رویکرد تراکنشی برای ایجاد تغییرات دارد. این به شما امکان می دهد چندین تغییر را در یک ویرایش پیش نویس یکپارچه کنید، سپس تغییرات را به یکباره انجام دهید. (تا زمانی که ویرایش انجام نشود هیچ یک از تغییرات اعمال نمی شود.)

بهترین شیوه ها

  • تعداد به‌روزرسانی‌های برنامه را محدود کنید. به‌روزرسانی‌های آلفا یا بتا را بیشتر از یک بار در روز منتشر نکنید (برنامه‌های تولیدی باید حتی کمتر از آن به‌روزرسانی شوند). هر به‌روزرسانی برای کاربران شما زمان و احتمالاً هزینه دارد. اگر به‌طور مکرر به‌روزرسانی می‌کنید، کاربران ممکن است شروع به نادیده گرفتن به‌روزرسانی‌ها کنند یا حتی محصول را حذف نصب کنند.

API اشتراک ها و خریدهای درون برنامه ای

API اشتراک‌ها و خریدهای درون‌برنامه به شما امکان می‌دهد کاتالوگ محصولات درون‌برنامه و اشتراک‌های برنامه خود را مدیریت کنید. علاوه بر این، با API اشتراک‌ها و خریدهای درون‌برنامه‌ای، می‌توانید به سرعت جزئیات هر خریدی را با استفاده از درخواست استاندارد GET بازیابی کنید.

در درخواست، اطلاعاتی درباره خرید ارائه می‌کنید - نام بسته برنامه، شناسه خرید یا اشتراک، و رمز خرید. سرور با یک شی JSON پاسخ می دهد که جزئیات خرید مرتبط، وضعیت سفارش، بار توسعه دهنده و سایر اطلاعات را شرح می دهد.

می‌توانید از این API به روش‌های مختلفی استفاده کنید، مانند گزارش‌دهی و تطبیق سفارش‌های فردی و تأیید خریدها و انقضای اشتراک. همچنین می‌توانید از API برای اطلاع از سفارش‌های لغو شده استفاده کنید و تأیید کنید که آیا محصولات درون‌برنامه مصرف شده‌اند، از جمله اینکه آیا قبل از لغو مصرف شده‌اند یا خیر.

بهترین شیوه ها

  • اطلاعات اشتراک را در سرور خود ذخیره کنید تا از برقراری تماس های غیر ضروری API جلوگیری کنید. هنگامی که برنامه شما نیاز به تأیید اشتراک دارد، به جای تکرار تماس API با Google، باید به اطلاعات ذخیره شده روی سرور خود تکیه کنید.
  • دو حالت وجود دارد که در آن سرور امن شما باید از Google Play Developer API برای دریافت اطلاعات اشتراک استفاده کند:
    • سرور شما یک رمز خرید جدید دریافت می کند که قبلاً دیده نشده است.
    • سرور شما یک اعلان توسعه دهنده بلادرنگ (RTDN) دریافت می کند که نشان می دهد برای دریافت اطلاعات اشتراک جدید باید از رمز خرید استفاده کنید.
  • از API برای وضعیت اشتراک به طور منظم نظرسنجی نکنید. به عنوان مثال، برای بررسی هر اشتراک روزانه با API تماس نگیرید.
  • از آنجایی که زمانی که اشتراک منقضی می شود یا تمدید می شود، یک RTDN دریافت می کنید، نیازی به برنامه ریزی تماس API بر اساس زمان انقضای برنامه ریزی شده ندارید.

گزارش API

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

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

بهترین شیوه ها

  • این نسخه از Reporting API دارای محدودیت پیش فرض 10 پرس و جو در ثانیه است. می‌توانید میزان استفاده از سهمیه خود را در بخش سهمیه‌ها در Google Cloud Console مشاهده کنید. اگر نیاز به تجاوز از این حد دارید، می‌توانید با استفاده از این فرم درخواست سهمیه ارسال کنید.

پاسخ به نظرات API

Reply to Reviews API به شما امکان می دهد بازخورد کاربران را برای برنامه خود مشاهده کنید و به این بازخورد پاسخ دهید. شما می توانید از این API برای تعامل مستقیم با کاربران در جعبه ابزار پشتیبانی مشتری فعلی خود، مانند یک سیستم CRM، استفاده کنید.

Reply to Reviews API به شما امکان می دهد فقط برای نسخه های تولیدی برنامه خود به بازخورد دسترسی داشته باشید. اگر می‌خواهید بازخورد مربوط به نسخه‌های آلفا یا بتا برنامه خود را ببینید، به جای آن از کنسول Google Play استفاده کنید. همچنین، توجه داشته باشید که API فقط نظراتی را نشان می‌دهد که شامل نظرات هستند. اگر کاربری به برنامه شما امتیاز دهد اما نظری ارائه نکند، بازخورد او از API قابل دسترسی نیست.

API مجوزها

Permissions API به توسعه دهندگان این امکان را می دهد که مدیریت مجوزها را در کنسول Play به طور خودکار انجام دهند . این به شما امکان می دهد بدون دخالت دستی، کنترل انعطاف پذیری بر روی افرادی که به حساب توسعه دهنده شما دسترسی دارند، داشته باشید.

با Permissions API، می توانید عملکردهای مدیریتی مانند:

  • حذف دسترسی کاربران هنگام خروج از شرکت شما.
  • اعطای دسترسی به یک برنامه زمانی که کاربر به تیم مربوطه می‌پیوندد.

API خریدهای باطل شد

Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند. می‌توانید از اطلاعات این فهرست برای پیاده‌سازی یک سیستم ابطال استفاده کنید که از دسترسی کاربر به محصولات آن سفارش‌ها جلوگیری می‌کند.

این API برای سفارشات درون‌برنامه‌ای یک‌باره و اشتراک‌های برنامه اعمال می‌شود.

خرید را می توان به روش های زیر باطل کرد:

  • کاربر برای سفارش خود درخواست بازپرداخت می کند.
  • کاربر سفارش خود را لغو می کند.
  • یک سفارش پس گرفته می شود.
  • برنامه‌نویس سفارش را لغو یا بازپرداخت می‌کند. توجه: فقط سفارش‌های لغو شده در API خریدهای باطل نشان داده می‌شوند. اگر برنامه‌نویس بدون تنظیم گزینه ابطال، وجه را بازپرداخت کند، سفارش‌ها در API نشان داده نمی‌شوند.
  • Google سفارش را لغو یا بازپرداخت می کند.

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

،

نمای کلی

کنسول Google Play مجموعه‌ای از APIهای سرویس وب مبتنی بر REST را ارائه می‌کند که به شما امکان می‌دهد انتشار، گزارش‌دهی و سایر عملکردهای مدیریت برنامه را مستقیماً برای برنامه خود انجام دهید.

همه برنامه‌نویس‌ها نیازی به استفاده از این API‌های توسعه‌دهنده ندارند - در بیشتر موارد می‌توانید مستقیماً با استفاده از کنسول Google Play به مدیریت برنامه‌های خود ادامه دهید. با این حال، اگر تعداد زیادی APK برای مدیریت دارید، یا مجبور هستید خریدها و اشتراک‌های کاربران را ردیابی کنید، ممکن است این APIها را مفید بدانید.

چه چیزی گنجانده شده است

APIهای برنامه‌نویس Google Play به شما امکان می‌دهند روی طراحی و توسعه برنامه‌تان تمرکز کنید، در حالی که زمان و تلاش کمتری را برای مدیریت نسخه‌های خود صرف می‌کنید، حتی وقتی به بازارهای جدید رشد می‌کنید.

کنسول Google Play شامل مجموعه‌ای از API است که می‌توانید برای مدیریت برنامه خود از آنها استفاده کنید:

  • Publishing API به شما امکان می دهد برنامه ها را آپلود و منتشر کنید و سایر وظایف مربوط به انتشار را انجام دهید.
  • API اشتراک ها و خریدهای درون برنامه ای به شما امکان می دهد خریدها و اشتراک های درون برنامه ای را مدیریت کنید. (این قبلا به عنوان "API وضعیت خرید" شناخته می شد.)
  • گزارش API به شما امکان می دهد اطلاعات مربوط به کیفیت برنامه خود را از حیاتی اندروید بازیابی کنید.
  • API Reply to Reviews به شما امکان می دهد نظرات برنامه خود را بازیابی کرده و به آنها پاسخ دهید.
  • Permissions API به شما امکان می دهد مدیریت مجوزها را در Play Console به صورت خودکار انجام دهید.
  • API مدیریت خدمات بازی‌های Play به شما امکان می‌دهد برای کنترل برنامه‌ای فراداده‌های زیربنای ویژگی‌های خدمات بازی‌های Google Play، تماس‌های REST صادر کنید.
  • Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند.

شروع کردن

برای شروع کار با API های برنامه نویس Google Play، به مستندات شروع کار مراجعه کنید.

انتشار API

Publishing API به شما امکان می دهد کارهای مکرر مرتبط با توزیع برنامه را خودکار کنید. این کارکردهایی مشابه عملکردهایی را که از طریق کنسول Play در اختیار یک برنامه‌نویس قرار می‌گیرد، ارائه می‌کند، مانند:

  • آپلود نسخه های جدید یک برنامه
  • انتشار برنامه‌ها، با اختصاص فایل‌های APK به آهنگ‌های مختلف (آلفا، بتا، عرضه مرحله‌ای، یا تولید)
  • ایجاد و اصلاح فهرست‌های فروشگاه Google Play، از جمله متن و گرافیک بومی‌سازی شده و اسکرین‌شات‌های چند دستگاهی

این وظایف با استفاده از قابلیت ویرایش انجام می‌شوند، که یک رویکرد تراکنشی برای ایجاد تغییرات دارد. این به شما امکان می دهد چندین تغییر را در یک ویرایش پیش نویس یکپارچه کنید، سپس تغییرات را به یکباره انجام دهید. (تا زمانی که ویرایش انجام نشود هیچ یک از تغییرات اعمال نمی شود.)

بهترین شیوه ها

  • تعداد به‌روزرسانی‌های برنامه را محدود کنید. به‌روزرسانی‌های آلفا یا بتا را بیشتر از یک بار در روز منتشر نکنید (برنامه‌های تولیدی باید حتی کمتر از آن به‌روزرسانی شوند). هر به‌روزرسانی برای کاربران شما زمان و احتمالاً هزینه دارد. اگر به‌طور مکرر به‌روزرسانی می‌کنید، کاربران ممکن است شروع به نادیده گرفتن به‌روزرسانی‌ها کنند یا حتی محصول را حذف نصب کنند.

API اشتراک ها و خریدهای درون برنامه ای

API اشتراک‌ها و خریدهای درون‌برنامه به شما امکان می‌دهد کاتالوگ محصولات درون‌برنامه و اشتراک‌های برنامه خود را مدیریت کنید. علاوه بر این، با API اشتراک‌ها و خریدهای درون‌برنامه‌ای، می‌توانید به سرعت جزئیات هر خریدی را با استفاده از درخواست استاندارد GET بازیابی کنید.

در درخواست، اطلاعاتی درباره خرید ارائه می‌کنید - نام بسته برنامه، شناسه خرید یا اشتراک، و رمز خرید. سرور با یک شی JSON پاسخ می دهد که جزئیات خرید مرتبط، وضعیت سفارش، بار توسعه دهنده و سایر اطلاعات را شرح می دهد.

می‌توانید از این API به روش‌های مختلفی استفاده کنید، مانند گزارش‌دهی و تطبیق سفارش‌های فردی و تأیید خریدها و انقضای اشتراک. همچنین می‌توانید از API برای اطلاع از سفارش‌های لغو شده استفاده کنید و تأیید کنید که آیا محصولات درون‌برنامه مصرف شده‌اند، از جمله اینکه آیا قبل از لغو مصرف شده‌اند یا خیر.

بهترین شیوه ها

  • اطلاعات اشتراک را در سرور خود ذخیره کنید تا از برقراری تماس های غیر ضروری API جلوگیری کنید. هنگامی که برنامه شما نیاز به تأیید اشتراک دارد، به جای تکرار تماس API با Google، باید به اطلاعات ذخیره شده روی سرور خود تکیه کنید.
  • دو حالت وجود دارد که در آن سرور امن شما باید از Google Play Developer API برای دریافت اطلاعات اشتراک استفاده کند:
    • سرور شما یک رمز خرید جدید دریافت می کند که قبلاً دیده نشده است.
    • سرور شما یک اعلان توسعه دهنده بلادرنگ (RTDN) دریافت می کند که نشان می دهد برای دریافت اطلاعات اشتراک جدید باید از رمز خرید استفاده کنید.
  • از API برای وضعیت اشتراک به طور منظم نظرسنجی نکنید. به عنوان مثال، برای بررسی هر اشتراک روزانه با API تماس نگیرید.
  • از آنجایی که زمانی که اشتراک منقضی می شود یا تمدید می شود، یک RTDN دریافت می کنید، نیازی به برنامه ریزی تماس API بر اساس زمان انقضای برنامه ریزی شده ندارید.

گزارش API

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

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

بهترین شیوه ها

  • این نسخه از Reporting API دارای محدودیت پیش فرض 10 پرس و جو در ثانیه است. می‌توانید میزان استفاده از سهمیه خود را در بخش سهمیه‌ها در Google Cloud Console مشاهده کنید. اگر نیاز به تجاوز از این حد دارید، می‌توانید با استفاده از این فرم درخواست سهمیه ارسال کنید.

پاسخ به نظرات API

Reply to Reviews API به شما امکان می دهد بازخورد کاربران را برای برنامه خود مشاهده کنید و به این بازخورد پاسخ دهید. شما می توانید از این API برای تعامل مستقیم با کاربران در جعبه ابزار پشتیبانی مشتری فعلی خود، مانند یک سیستم CRM، استفاده کنید.

Reply to Reviews API به شما امکان می دهد فقط برای نسخه های تولیدی برنامه خود به بازخورد دسترسی داشته باشید. اگر می‌خواهید بازخورد مربوط به نسخه‌های آلفا یا بتا برنامه خود را ببینید، به جای آن از کنسول Google Play استفاده کنید. همچنین، توجه داشته باشید که API فقط بررسی هایی را نشان می دهد که شامل نظرات هستند. اگر کاربری به برنامه شما امتیاز دهد اما نظری ارائه نکند، بازخورد او از API قابل دسترسی نیست.

API مجوزها

Permissions API به توسعه دهندگان این امکان را می دهد که مدیریت مجوزها را در کنسول Play به طور خودکار انجام دهند . این به شما امکان می دهد بدون دخالت دستی، کنترل انعطاف پذیری بر روی افرادی که به حساب توسعه دهنده شما دسترسی دارند، داشته باشید.

با Permissions API، می توانید عملکردهای مدیریتی مانند:

  • حذف دسترسی کاربران هنگام خروج از شرکت شما.
  • اعطای دسترسی به یک برنامه زمانی که کاربر به تیم مربوطه می‌پیوندد.

API خریدهای باطل شد

Voided Purchases API فهرستی از سفارش‌های مرتبط با خریدهایی را که کاربر باطل کرده است ارائه می‌کند. می‌توانید از اطلاعات این فهرست برای پیاده‌سازی یک سیستم ابطال استفاده کنید که از دسترسی کاربر به محصولات آن سفارش‌ها جلوگیری می‌کند.

این API برای سفارشات درون‌برنامه‌ای یک‌باره و اشتراک‌های برنامه اعمال می‌شود.

خرید را می توان به روش های زیر باطل کرد:

  • کاربر برای سفارش خود درخواست بازپرداخت می کند.
  • کاربر سفارش خود را لغو می کند.
  • یک سفارش پس گرفته می شود.
  • برنامه‌نویس سفارش را لغو یا بازپرداخت می‌کند. توجه: فقط سفارش‌های لغو شده در API خریدهای باطل نشان داده می‌شوند. اگر برنامه‌نویس بدون تنظیم گزینه ابطال، وجه را بازپرداخت کند، سفارش‌ها در API نشان داده نمی‌شوند.
  • Google سفارش را لغو یا بازپرداخت می کند.

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