شروع شدن

قبل از اینکه بتوانید تماس‌های API را شروع کنید، باید دسترسی API را به حساب برنامه‌نویس Google Play خود تنظیم کنید. این شامل تغییراتی در کنسول Google Play و Google Cloud Console است. دستورالعمل‌های زیر مراحل مورد نیاز برای شروع استفاده از Google Play Developer API را توضیح می‌دهند.

  1. یک پروژه Google Cloud ایجاد کنید.
  2. Google Play Developer API را برای پروژه Google Cloud خود فعال کنید.
  3. برای دسترسی به Google Play Developer API یک حساب سرویس با مجوزهای کنسول Google Play مناسب تنظیم کنید.

یک پروژه Google Cloud ایجاد کنید

اگر قبلاً یک پروژه Google Cloud دارید که می‌خواهید از آن استفاده کنید، می‌توانید این مرحله را نادیده بگیرید.

یک پروژه در Google Cloud Console ایجاد کنید.

برای اطلاعات بیشتر در مورد Google Cloud Projects، به ایجاد و مدیریت پروژه ها مراجعه کنید.

API را فعال کنید

پس از راه‌اندازی Google Cloud Project، باید Google Play Developer API را برای این پروژه فعال کنید.

برای فعال کردن Google Play Developer API:

  1. به صفحه Google Play Developer API در Google Cloud Console بروید.
  2. روی Enable کلیک کنید.

حساب‌های OAuth و Service را پیکربندی کنید

باید دسترسی به Google Play Developer API را با یک سرویس گیرنده OAuth یا یک حساب سرویس پیکربندی کنید. در بیشتر موارد، برای دسترسی به API باید از یک حساب سرویس استفاده کنید.

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

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

  • حساب سرویس: یک سرویس نرم افزاری ایمن به API دسترسی خواهد داشت (متداول ترین)
  • مشتریان OAuth: یک کاربر به API دسترسی خواهد داشت

از حساب سرویس استفاده کنید

می توانید یک حساب سرویس از کنسول Google Play ایجاد کنید.

  1. در Google Cloud Console به Service Accounts بروید.
  2. روی ایجاد حساب کاربری کلیک کنید و مراحل را دنبال کنید.
  3. به صفحه Users & Permissions در Google Play Console بروید.
  4. روی دعوت از کاربران جدید کلیک کنید.

  5. یک آدرس ایمیل برای حساب سرویس خود در قسمت آدرس ایمیل قرار دهید و حقوق لازم را برای انجام اقدامات اعطا کنید.

    برای استفاده از Google Play Billing API، باید مجوزهای زیر را بدهید:

    • مشاهده داده‌های مالی، سفارش‌ها و پاسخ‌های نظرسنجی لغو
    • سفارشات و اشتراک ها را مدیریت کنید

  6. روی دعوت از کاربر کلیک کنید.

در این مرحله، باید بتوانید از طریق حساب سرویس به Google Play Developer API دسترسی داشته باشید. برای اطلاعات بیشتر، استفاده از OAuth 2.0 برای برنامه های کاربردی سرور به سرور را ببینید.

از مشتریان OAuth استفاده کنید

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

قبل از ایجاد مشتریان OAuth، باید اطلاعات برندینگ را برای محصول خود پیکربندی کنید. برای اطلاعات بیشتر، به تنظیم صفحه رضایت OAuth مراجعه کنید.

  1. در Google Cloud Console، به صفحه نمایش رضایت OAuth بروید.
  2. مراحل ایجاد صفحه رضایت OAuth را دنبال کنید.

برای ایجاد یک سرویس گیرنده OAuth:

  1. در Google Cloud Console، به اعتبارنامه بروید.
  2. روی ایجاد اعتبارنامه > شناسه مشتری OAuth کلیک کنید.
  3. نوع برنامه خود را انتخاب کنید و دستورالعمل ها را دنبال کنید.

اطلاعات تکمیلی

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

شناسه توسعه دهنده خود را دریافت کنید

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

به عنوان مثال، URL کنسول Google Play را در نظر بگیرید:

https://play.google.com/console/developers/1234567890123456789/api-access

در URL بالا، شناسه برنامه‌نویس 1234567890123456789 خواهد بود.

توجه: اگر برنامه‌ای از یک حساب برنامه‌نویس Google Play به حساب دیگر منتقل شود، شناسه برنامه‌نویس مرتبط با آن برنامه تغییر می‌کند. این بدان معناست که پس از تکمیل انتقال، باید از شناسه برنامه‌نویس برای حساب جدید Google Play Developer Account در تماس‌های API برای آن برنامه استفاده کنید.

API های تخصصی

Google Play Developer API حاوی چندین API تخصصی است که به شما امکان می دهد انواع خاصی از تجزیه و تحلیل را روی برنامه خود انجام دهید:

پاسخ به نظرات API
به شما امکان می دهد بازخورد کاربران را برای برنامه خود مشاهده کنید و به این بازخورد پاسخ دهید.
Voided Purchases API
به شما امکان می‌دهد دسترسی به محصولات درون‌برنامه مرتبط با خریدهایی را که کاربر باطل کرده است لغو کنید.

کتابخانه های مشتری

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