آماده شدن، آماده شدن

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

یک حساب توسعه‌دهنده گوگل پلی راه‌اندازی کنید

برای انتشار برنامه‌ها و بازی‌های خود در گوگل پلی، از کنسول گوگل پلی استفاده کنید. همچنین می‌توانید از کنسول گوگل پلی برای مدیریت محصولات و تنظیمات مربوط به صورتحساب خود استفاده کنید.

برای دسترسی به کنسول گوگل پلی، باید یک حساب توسعه‌دهنده گوگل پلی ایجاد کنید .

برای فروش برنامه‌های پولی و خریدهای درون‌برنامه‌ای در گوگل پلی، باید یک پروفایل در مرکز پرداخت‌های گوگل (Google Payments Center) ایجاد کنید و سپس آن پروفایل را به حساب توسعه‌دهنده گوگل پلی خود پیوند دهید. برای یادگیری نحوه پیوند دادن پروفایل خود به حسابتان، یا برای یادگیری نحوه بررسی اینکه آیا از قبل حساب و پروفایل پیوند داده شده دارید، به پیوند دادن حساب توسعه‌دهنده گوگل پلی به پروفایل پرداخت‌های خود مراجعه کنید.

فعال کردن ویژگی‌های مربوط به صورتحساب در کنسول گوگل پلی

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

وابستگی کتابخانه را اضافه کنید

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

کتابخانه پرداخت گوگل پلی از مخزن Maven گوگل در دسترس است. وابستگی را به فایل build.gradle برنامه خود اضافه کنید، همانطور که نشان داده شده است:

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

اگر از کاتلین استفاده می‌کنید، ماژول KTX کتابخانه‌ی پرداخت گوگل پلی شامل افزونه‌ها و پشتیبانی از کوروتین‌های کاتلین است که به شما امکان می‌دهد هنگام استفاده از سیستم پرداخت گوگل پلی، کاتلین ایدیوماتیک بنویسید. برای افزودن این افزونه‌ها به پروژه‌تان، وابستگی زیر را همانطور که نشان داده شده است به فایل build.gradle برنامه‌تان اضافه کنید:

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

نمونه‌های کد کاتلین موجود در این صفحه، در صورت امکان از KTX بهره می‌برند.

برنامه خود را آپلود کنید

پس از افزودن کتابخانه به برنامه خود، برنامه خود را بسازید و منتشر کنید. برای این مرحله، برنامه خود را ایجاد کنید و سپس آن را در هر مسیری، از جمله مسیر تست داخلی ، منتشر کنید.

محصولات خود را ایجاد و پیکربندی کنید

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

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

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

• برای ایجاد و پیکربندی محصولات یکبار مصرف، به بخش «ایجاد یک محصول مدیریت‌شده» مراجعه کنید. توجه داشته باشید که کنسول گوگل پلی به محصولات یکبار مصرف، محصولات مدیریت‌شده می‌گوید.

• برای ایجاد و پیکربندی اشتراک‌ها، به ایجاد اشتراک مراجعه کنید.

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

پیکربندی API توسعه‌دهندگان گوگل پلی

رابط برنامه‌نویسی کاربردی توسعه‌دهندگان گوگل پلی (Google Play Developer API) یک رابط برنامه‌نویسی کاربردی (API) سرور به سرور است که کتابخانه صورتحساب گوگل پلی (Google Play Billing Library) را در اندروید تکمیل می‌کند. این رابط برنامه‌نویسی کاربردی، قابلیت‌هایی را ارائه می‌دهد که در کتابخانه صورتحساب گوگل پلی موجود نیست، مانند تأیید ایمن خریدها و صدور بازپرداخت به کاربران شما.

به عنوان بخشی از ادغام سیستم پرداخت گوگل پلی در برنامه خود، باید دسترسی به API توسعه‌دهندگان گوگل پلی را از طریق کنسول گوگل پلی پیکربندی کنید. برای دستورالعمل‌ها، به «شروع به کار با API توسعه‌دهندگان گوگل پلی» مراجعه کنید.

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

پیکربندی اعلان‌های توسعه‌دهنده در لحظه

اعلان‌های توسعه‌دهنده‌ی بلادرنگ (RTDN) مکانیزمی برای دریافت اعلان‌ها از گوگل در هر زمانی است که تغییری در حق دسترسی کاربر در برنامه‌ی شما ایجاد شود. RTDN از Google Cloud Pub/Sub استفاده می‌کند که به شما امکان می‌دهد داده‌هایی را دریافت کنید که یا به URL تنظیم‌شده توسط شما ارسال می‌شوند یا با استفاده از یک کتابخانه‌ی کلاینت، نظرسنجی می‌شوند. این اعلان‌ها به شما امکان می‌دهند فوراً به تغییرات وضعیت اشتراک واکنش نشان دهید و از نیاز به نظرسنجی از API توسعه‌دهنده‌ی Google Play اجتناب کنید. توجه داشته باشید که استفاده‌ی ناکارآمد از API توسعه‌دهنده‌ی Google Play می‌تواند منجر به محدودیت‌های سهمیه‌ی API شود.

Cloud Pub/Sub یک سرویس پیام‌رسانی کاملاً مدیریت‌شده و بلادرنگ است که می‌توانید از آن برای ارسال و دریافت پیام بین برنامه‌های مستقل استفاده کنید. گوگل پلی از Cloud Pub/Sub برای انتشار اعلان‌های فوری در مورد موضوعاتی که در آنها مشترک می‌شوید، استفاده می‌کند.

برای دریافت اعلان‌ها، باید یک سرور backend ایجاد کنید تا پیام‌های ارسالی به تاپیک شما را دریافت کند. سپس سرور شما می‌تواند با پاسخ دادن به درخواست‌های HTTPS به یک نقطه پایانی ثبت‌شده یا با استفاده از کتابخانه‌های Cloud Pub/Sub Client ، این پیام‌ها را دریافت کند. این کتابخانه‌ها به زبان‌های مختلفی در دسترس هستند. اطلاعات بیشتر را می‌توانید در بخش ایجاد اشتراک Pub/Sub در این تاپیک نیز بیابید.

تعیین قیمت و سهمیه

برای جزئیات بیشتر در مورد قیمت‌گذاری و سهمیه‌بندی، به قیمت‌گذاری و سهمیه‌بندی مراجعه کنید.

تخمین میزان مصرف داده

بخش داده اعلان اشتراک تقریباً ۱ کیلوبایت داده در هر درخواست است. هر انتشار و دریافت به یک درخواست جداگانه یا تقریباً ۲ کیلوبایت داده در هر اعلان نیاز دارد. تعداد اعلان‌ها در هر ماه به چرخه صورتحساب شما و رفتار کاربرانتان بستگی دارد. شما باید حداقل یک اعلان برای هر کاربر در طول یک چرخه صورتحساب انتظار داشته باشید.

راه‌اندازی فضای ابری Pub/Sub

برای فعال کردن اعلان‌های توسعه‌دهنده‌ی بلادرنگ، ابتدا باید Cloud Pub/Sub را با استفاده از پروژه‌ی Google Cloud Platform (GCP) خود راه‌اندازی کنید و سپس اعلان‌ها را برای برنامه‌ی خود فعال کنید.

برای استفاده از Cloud Pub/Sub، باید یک پروژه GCP با API Cloud Pub/Sub فعال داشته باشید. اگر با GCP و Cloud Pub/Sub آشنا نیستید، به راهنمای شروع سریع مراجعه کنید.

ایجاد تاپیک

برای شروع دریافت اعلان‌ها، باید موضوعی ایجاد کنید که گوگل پلی باید اعلان‌ها را در آن منتشر کند. برای ایجاد یک موضوع، دستورالعمل‌های موجود در «ایجاد موضوع» را دنبال کنید.

ایجاد اشتراک Pub/Sub

برای دریافت پیام‌های منتشر شده در یک موضوع، باید یک اشتراک انتشار/زیرمجموعه برای آن موضوع ایجاد کنید. برای ایجاد اشتراک انتشار/زیرمجموعه، موارد زیر را انجام دهید:

1. برای تعیین اینکه آیا اشتراک را به صورت اشتراک push یا pull پیکربندی کنید، راهنمای Cloud Pub/Sub Subscriber را مطالعه کنید.
   • اشتراک پوش به Cloud Pub/Sub اجازه می‌دهد تا با صدور درخواست‌های HTTPS، اعلان‌ها را به backend امن شما ارسال کند.
   • اشتراک pull نیاز به سرور backend امن شما دارد تا درخواست‌هایی را به سرور Cloud Pub/Sub برای بازیابی پیام‌ها ارسال کند.
2. Follow the instructions in Add a subscription to create a subscription.

اعطای حق انتشار در موضوع شما

Cloud Pub/Sub مستلزم آن است که به Google Play امتیازات لازم برای انتشار اعلان‌ها در موضوع خود را اعطا کنید.

1. کنسول ابری گوگل را باز کنید.
2. پروژه خود را انتخاب کنید و سپس در منوی سمت چپ روی Pub/Sub کلیک کنید.

3. موضوع خود را پیدا کنید و جزئیات مجوزها را باز کنید.

   

4. حساب سرویس google-play-developer-notifications@system.gserviceaccount.com را اضافه کنید و به آن نقش Pub/Sub Publisher را بدهید.

   

5. برای تکمیل تنظیمات موضوع، روی ذخیره کلیک کنید.

   

اعلان‌های توسعه‌دهنده‌ی بلادرنگ را برای برنامه‌ی خود فعال کنید

برای فعال کردن اعلان‌های توسعه‌دهنده‌ی بلادرنگ برای برنامه‌ی خود، مراحل زیر را انجام دهید:

1. کنسول گوگل پلی را باز کنید.
2. برنامه خود را انتخاب کنید.
3. به کسب درآمد > تنظیمات کسب درآمد بروید.

4. به بخش اعلان‌های توسعه‌دهنده‌ی بلادرنگ در بالای صفحه بروید.

   

5. گزینه فعال کردن اعلان‌های بلادرنگ را تیک بزنید.

6. در فیلد نام موضوع (Topic name )، نام کامل موضوع Cloud Pub/Sub را که قبلاً پیکربندی کرده‌اید، وارد کنید. نام موضوع باید به فرمت projects/{project_id}/topics/{topic_name} باشد که در آن project_id شناسه منحصر به فرد پروژه شما و topic_name نام موضوعی است که قبلاً ایجاد شده است.

7. برای ارسال پیام آزمایشی، روی «ارسال پیام آزمایشی» کلیک کنید. انجام انتشار آزمایشی به شما کمک می‌کند تا از تنظیم و پیکربندی صحیح همه چیز اطمینان حاصل کنید. اگر انتشار آزمایشی با موفقیت انجام شود، پیامی نمایش داده می‌شود که نشان می‌دهد انتشار آزمایشی با موفقیت انجام شده است. اگر برای این موضوع اشتراکی پیوست کرده‌اید، باید پیام آزمایشی را دریافت کنید.

   For a pull subscription, go to the subscription in Cloud Console, click View Messages , and proceed to pull messages. You should acknowledge any message you have pulled to avoid repeated delivery by Cloud Pub/Sub. For a push subscription , check if the test message is delivered to your push endpoint. A successful response code will serve as a message acknowledgement.

   اگر انتشار با شکست مواجه شود، خطایی نمایش داده می‌شود. مطمئن شوید که نام موضوع صحیح است و حساب سرویس google-play-developer-notifications@system.gserviceaccount.com دسترسی Pub/Sub Publisher به موضوع را دارد.

8. انواع اعلان‌هایی را که می‌خواهید دریافت کنید، انتخاب کنید.

   • برای اشتراک‌ها و تمام خریدهای لغو شده اعلان دریافت کنید - اعلان‌های توسعه‌دهنده را در لحظه مربوط به اشتراک‌ها و خریدهای لغو شده دریافت کنید. برای خریدهای یکباره محصول اعلان دریافت نخواهید کرد.
   • دریافت همه اعلان‌ها برای اشتراک‌ها و محصولات یکبار مصرف - برای همه رویدادهای اشتراک و خرید لغو شده اعلان دریافت کنید. همچنین رویدادهای خرید محصول یکبار مصرف، مانند ONE_TIME_PRODUCT_PURCHASED و ONE_TIME_PRODUCT_CANCELED را دریافت خواهید کرد. برای کسب اطلاعات بیشتر در مورد این رویدادهای خرید، به چرخه عمر خرید یکبار مصرف مراجعه کنید.

9. روی ذخیره تغییرات کلیک کنید.

تأیید پیکربندی شما

برای دریافت اعلان‌های توسعه‌دهنده به‌صورت بلادرنگ، باید یک سرور پشتیبان امن ایجاد کنید تا پیام‌های ارسالی به Cloud Pub/Sub topic شما را دریافت کند.

همانطور که در بخش قبل توضیح داده شد، می‌توانید پیکربندی خود را با استفاده از دکمه «ارسال پیام آزمایشی» در کنسول گوگل پلی آزمایش کنید. اگر سرور بک‌اند را برای دریافت اعلان‌ها پیکربندی نکرده‌اید، می‌توانید از ابزار خط فرمان gcloud برای تأیید پیکربندی استفاده کنید. برای دستورالعمل‌های پردازش پیام‌ها با استفاده از gcloud ، به بخش «پیاده‌سازی پیام از اشتراک» مراجعه کنید.

مراحل بعدی

• کتابخانه را در برنامه خود ادغام کنید