نحوه ایجاد و پیکربندی پروژه Google API Console به سناریو مجوز OAuth 2.0 برنامه شما بستگی دارد. برای سفارشی‌سازی این راهنما، سناریوی صدور مجوزی را انتخاب کنید.
برای ایجاد کردن اطلاعات اعتباری OAuth 2.0 و فعال کردن «میانای برنامه‌سازی کاربردی Google Ads» برای برنامه‌تان، به پروژه «کنسول Google API» نیاز دارید.
این اطلاعات اعتباری کاربران برنامه یا Google Ads شما را در سرورهای Google اصالت‌سنجی و مجاز می‌کند و به شما امکان می‌دهد تا نشان‌های OAuth را برای استفاده در تماس با API تولید کنید.
پروژه Google API Console را انتخاب یا ایجاد کنید
برای راه‌اندازی پروژه جدید، راهنمای ایجاد پروژه «کنسول Google API» را دنبال کنید. فعال کردن صورت‌حساب برای پروژه اختیاری است. اگر صورت‌حساب را فعال کرده‌اید، حساب صورت‌حسابی برای پروژه جدید انتخاب کنید. استفاده از Google Ads API رایگان است، اما پروژه‌های Cloud مشمول محدودیت‌های سهمیه استاندارد پروژه هستند.
«میانای برنامه‌سازی کاربردی Google Ads» را در پروژه‌تان فعال کنید
برای فعال کردن Google Ads API در پروژه‌تان، این مراحل را دنبال کنید:
در «کنسول Google API»، کتابخانه API را باز کنید. درصورت دریافت پیام‌واره، پروژه‌تان را انتخاب کنید یا پروژه جدیدی ایجاد کنید. «کتابخانه API» همه میاناهای برنامه‌سازی کاربردی دردسترس را فهرست می‌کند و آن‌ها را براساس خانواده محصول و محبوبیت گروه‌بندی می‌کند.
اگر Google Ads API در فهرست قابل‌مشاهده نیست، از جستجو برای یافتن آن استفاده کنید.
Google Ads API را انتخاب کنید، سپس روی دکمه فعال کردن کلیک کنید.
درخواست دسترسی به میانای برنامه‌سازی کاربردی
سپس، به صفحه نمای کلی Google Ads API بروید تا سطح دسترسی به میانای برنامه‌سازی کاربردی فعلی‌تان را بررسی کنید. اگر سطح دسترسی فعلی شما به میانای برنامه‌سازی کاربردی آزمایش است، بخش ارتقا دادن سطح دسترسی را ازهم باز کنید. دستورالعمل‌ها را برای درخواست سطح دسترسی کاوشگر دنبال کنید.
وقتی درخواستتان را تکمیل کردید، Google به‌طور خودکار درخواستتان را بازبینی می‌کند و در اکثر موارد آن را به دسترسی «کاوشگر» ارتقا می‌دهد.
پیکربندی صفحه کسب رضایت OAuth
وقتی از OAuth 2.0 برای صدور مجوز استفاده می‌کنید، Google صفحه رضایتی به کاربر نشان می‌دهد که شامل خلاصه‌ای از پروژه شما، خط‌مشی‌های آن، و دامنه‌های دسترسی مجوز درخواستی است. پیکربندی صفحه موافقت OAuth برنامه شما مشخص می‌کند که چه چیزی به کاربران و مرورکنندگان برنامه نمایش داده شود و برنامه شما را ثبت می‌کند تا بتوانید آن را بعداً منتشر کنید.
صفحه کسب رضایت OAuth را برای برنامه‌تان پیکربندی کنید و https://www.googleapis.com/auth/adwords را به‌عنوان دامنه OAuth اضافه کنید.
ملاحظات مهم برای نوع کاربر و وضعیت انتشار
هنگام پیکربندی صفحه کسب رضایت OAuth، به تنظیمات نوع کاربر و وضعیت انتشار توجه کنید.
- نوع کاربر: مشخص می‌کند که آیا برنامه شما به کاربران درون سازمانتان (داخلی) محدود می‌شود یا برای همه کاربران Google (خارجی) دردسترس است. داخلی فقط درصورتی دردسترس است که پروژه‌تان بخشی از سازمان Google Workspace باشد.
- وضعیت انتشار: تعیین می‌کند که برنامه در حالت آزمایش است (محدود به کاربران آزمایشی خاصی که اضافه می‌کنید) یا در مرحله تولید (دردسترس برای مخاطبانی که توسط نوع کاربر تعریف شده‌اند، که ممکن است به درستی‌سنجی برنامه توسط Google نیاز داشته باشد).
برای اینکه بهترین انتخاب‌ها را برای برنامه‌تان داشته باشید، توضیحات دقیق و پیامدهای این تنظیمات را در اسناد رسمی پشتیبانی Google Cloud مرور کنید:
آشنایی با این تنظیمات برای اطمینان از اینکه برنامه شما برای کاربران موردنظرتان دردسترس است بسیار مهم است.
ایجاد شناسه کارخواه و رمز کارخواه
شناسه کارخواه و رمز کارخواه ایجاد کنید. می‌توانید برنامه رایانه‌ای یا برنامه وب را به‌عنوان نوع برنامه انتخاب کنید. پس‌از اینکه کارخواه OAuth 2.0 را ایجاد کردید، فایل JSON کارخواه را با کلیک کردن روی دکمه بارگیری JSON در چارگوش تأیید بارگیری کنید.