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