نحوه ایجاد و پیکربندی پروژه Google API Console به سناریو مجوز OAuth 2.0 برنامه شما بستگی دارد. برای سفارشی‌سازی این راهنما، سناریوی مجوزدهی را انتخاب کنید.
برای ایجاد اطلاعات کاربری OAuth 2.0 و فعال کردن Google Ads API برای برنامه‌تان، به پروژه Google API Console نیاز دارید.
این اطلاعات کاربری، برنامه یا کاربران Google Ads شما را در سرورهای Google اصالت‌سنجی و مجاز می‌کند و به شما امکان می‌دهد تا کدهای OAuth را برای استفاده در تماس‌ها با API تولید کنید.
انتخاب یا ایجاد پروژه Google API Console
برای راه‌اندازی پروژه جدید، راهنمای ایجاد پروژه Google API Console را دنبال کنید. فعال کردن صورت‌حساب برای پروژه اختیاری است. اگر صورت‌حساب را فعال کرده‌اید، حساب صورت‌حسابی برای پروژه جدید انتخاب کنید. استفاده از Google Ads API رایگان است، اما پروژه‌های Cloud مشمول محدودیت‌های سهمیه پروژه استاندارد هستند.
Google Ads API را در پروژه‌تان فعال کنید
برای فعال کردن Google Ads API در پروژه‌تان، این مراحل را دنبال کنید:
کتابخانه میانای برنامه‌سازی کاربردی را در «کنسول Google API» باز کنید. درصورت درخواست، پروژه خود را انتخاب کنید یا پروژه جدیدی ایجاد کنید. «کتابخانه میانای برنامه‌سازی کاربردی» همه میاناهای برنامه‌سازی کاربردی دردسترس را براساس خانواده محصول و محبوبیت گروه‌بندی می‌کند.
اگر Google Ads API در فهرست قابل‌مشاهده نیست، از جستجو برای پیدا کردن آن استفاده کنید.
Google Ads API را انتخاب کنید، سپس روی دکمه فعال کردن کلیک کنید.
درخواست دسترسی به میانای برنامه‌سازی کاربردی
سپس، به صفحه نمای کلی Google Ads API بروید تا سطح دسترسی 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 در کادر گفتگوی تأیید بارگیری کنید.