برای شروع فراخوانی «میانای برنامه‌سازی کاربردی انتشار»، باید مستقیماً از کنسول Google Play به پروژه «میانای برنامه‌سازی کاربردی» پیوند دهید و «میانای برنامه‌سازی کاربردی انتشار» را برای آن پروژه فعال کنید. پس‌از راه‌اندازی پروژه API، می‌توانید از آن برای مدیریت پروژه‌های بازی دیگری که مالک آن هستید استفاده کنید.
«میانای برنامه‌سازی کاربردی انتشار» فقط می‌تواند توسط مالک حساب توسعه‌دهنده Google Play شما پیکربندی شود. دستورالعمل‌های زیر توضیح می‌دهد که چگونه:
- پروژه جدید یا موجود میانای برنامه‌سازی کاربردی راه‌اندازی کنید
- مدیریت کارخواه‌های OAuth
- استفاده از حساب سرویس برای دسترسی به Publishing API
راه‌اندازی پروژه میانای برنامه‌سازی کاربردی
قبل‌از اینکه بتوانید به Publishing API دسترسی پیدا کنید، باید «کنسول Google Play» را به پروژه API پیوند دهید. در اکثر موارد، توصیه می‌شود پروژه جدید میانای برنامه‌سازی کاربردی ایجاد کنید، اگرچه کاربران فعلی Google Play Developer Publishing API می‌توانند به پروژه میانای برنامه‌سازی کاربردی موجود پیوند دهند. به‌خاطر داشته باشید که هر پروژه API فقط می‌تواند به یک حساب «کنسول Google Play» پیوند داده شود.
ایجاد پروژه جدید API
- به صفحه دسترسی به API در «کنسول Google Play» بروید.
- با شرایط خدمات موافقت کنید.
- روی ایجاد پروژه جدید کلیک کنید. پروژه API به‌طور خودکار تولید و به «کنسول Google Play» شما پیوند داده می‌شود.
- گزینه «میانای برنامه‌سازی کاربردی انتشار خدمات بازی» را روی روشن تنظیم کنید.
اکنون پروژه API شما برای دسترسی به «میانای برنامه‌سازی کاربردی انتشار» پیکربندی شده است.
استفاده از پروژه API موجود
اگر ازقبل کاربر Google Play Developer API هستید، می‌توانید پروژه API موجودتان را با دنبال کردن این مراحل راه‌اندازی کنید. اگر پروژه API موردنظر برای راه‌اندازی در فهرست نیست، مطمئن شوید که حساب Google Play Console شما به‌عنوان «مالک» تعیین شده باشد و Google Play Developer API فعال باشد.
- به صفحه دسترسی به API در «کنسول Google Play» بروید.
- «شرایط خدمات API» را بپذیرید.
- پروژه‌ای را که می‌خواهید راه‌اندازی کنید انتخاب کنید.
- روی پیوند دادن کلیک کنید. «کنسول Google Play» شما اکنون به پروژه API پیوند داده شده است.
- گزینه «میانای برنامه‌سازی کاربردی انتشار خدمات بازی» را روی روشن تنظیم کنید.
اکنون پروژه API شما برای دسترسی به «میانای برنامه‌سازی کاربردی انتشار» پیکربندی شده است.
راه‌اندازی کارخواهان دسترسی به میانای برنامه‌سازی کاربردی
ازطریق کارخواه OAuth یا حساب سرویس به Publishing API دسترسی پیدا می‌کنید.
استفاده از کارخواه‌های OAuth
می‌توانید به کاربران اجازه دهید بااستفاده از کارخواه OAuth و با اطلاعات اعتباری خودشان ازطریق Publishing API کنش انجام دهند.
کنش‌های کاربر به کنش‌هایی که ازطریق صفحه حساب‌ها و حقوق کاربر در «کنسول Google Play» مجاز شده است محدود می‌شود.
- به صفحه دسترسی به API در «کنسول Google Play» بروید.
- در بخش کارخواه‌های OAuth، روی ایجاد کارخواه OAuth کلیک کنید.
- اطلاعات نمانام‌سازی محصولتان را پیکربندی کنید و روی ادامه دادن کلیک کنید.
- روی ایجاد شناسه کارخواه کلیک کنید.
جزئیات کارخواه OAuth جدید شما در فهرستی در این صفحه نمایش داده می‌شود.
استفاده از حساب سرویس
همچنین می‌توانید حساب سرویس ایجاد کنید تا بدون ارائه اطلاعات اعتباری کاربر شخصی خود، از سرور ساخت به Publishing API دسترسی پیدا کنید:
- به صفحه دسترسی به API در «کنسول Google Play» بروید.
- در بخش حساب‌های سرویس، روی ایجاد حساب سرویس کلیک کنید.
- برای ایجاد حساب سرویس، دستورالعمل‌های صفحه را دنبال کنید.
- پس‌از ایجاد حساب خدماتی در «کنسول توسعه‌دهندگان Google»، روی تمام کلیک کنید. صفحه دسترسی به API به‌طور خودکار بازآوری می‌شود و حساب سرویس شما فهرست خواهد شد.
- برای اعطای حقوق لازم به حساب خدمات برای انجام اقدامات، روی اعطای دسترسی کلیک کنید.
برای اطلاعات بیشتر، استفاده از OAuth 2.0 برای برنامه‌های سرور به سرور را ببینید.
دسترسی به Google Play Games Services Publishing API
می‌توانید مستقیماً ازطریق HTTP به «میانای برنامه‌سازی کاربردی انتشار» دسترسی پیدا کنید. برای اطلاعات بیشتر، به مرجع Publishing API و برنامه نمونه مراجعه کنید.