یک پروژه Google API Console راه اندازی کنید

برای ایجاد اعتبارنامه OAuth 2.0، پیکربندی صفحه رضایت کاربر و فعال کردن Google Ads API برای برنامه خود، به یک پروژه Google API Console نیاز دارید.

اعتبارنامه ها برای احراز هویت و مجوز کاربران Google Ads توسط سرورهای Google مورد نیاز است. این اعتبارنامه ها به شما امکان می دهد توکن های OAuth را برای استفاده در تماس های API ایجاد کنید.

یک پروژه Google API Console را انتخاب یا ایجاد کنید

اگر قبلاً یک پروژه Google API Console دارید و می‌خواهید از آن برای ایجاد اعتبارنامه‌ها استفاده کنید، می‌توانید از ایجاد شناسه مشتری و راز سرویس گیرنده پرش کنید.

برای ایجاد یک پروژه،

  • به کنسول API Google بروید
  • روی ایجاد پروژه کلیک کنید
  • یک نام وارد کنید یا پیشنهاد ایجاد شده را بپذیرید
  • فیلدهای باقی مانده را تأیید یا ویرایش کنید
  • روی Create کلیک کنید

اگر صورتحساب را فعال کرده اید، یک حساب صورتحساب برای پروژه جدید انتخاب کنید. برای استفاده از Google Ads API هیچ هزینه ای دریافت نمی شود، اما برای تعداد کل پروژه های Cloud سهمیه ای وجود دارد.

اگر از یک پروژه کنسول Google API موجود استفاده می‌کنید و قبلاً صفحه رضایت OAuth را پیکربندی کرده‌اید، می‌توانید از این مرحله صرفنظر کنید و به جای آن با افزودن دامنه Google Ads API OAuth 2.0، صفحه رضایت خود را تغییر دهید.

وقتی از OAuth 2.0 برای مجوز استفاده می‌کنید، Google صفحه رضایت شامل خلاصه‌ای از پروژه شما، خط‌مشی‌های آن و محدوده‌های دسترسی درخواستی مجوز را به کاربر نشان می‌دهد. پیکربندی صفحه رضایت OAuth برنامه شما، آنچه را که برای کاربران و بازبینان برنامه نمایش داده می شود، مشخص می کند و برنامه شما را ثبت می کند تا بتوانید بعداً آن را منتشر کنید.

  1. صفحه Consent Screen را باز کنید و پروژه خود را در منوی کشویی بالای صفحه انتخاب کنید.
  2. نوع کاربر را انتخاب کنید و روی CREATE کلیک کنید.
  3. فرم صفحه رضایت را پر کنید. در صورت نیاز می توانید بعداً این را ویرایش کنید. پس از اتمام روی ذخیره و ادامه کلیک کنید.
  4. در صفحه بعد، روی افزودن یا حذف SCOPES کلیک کنید.
  5. به پایین پیمایش کنید و موارد زیر را در قسمت Manually Add scopes وارد کنید:

    https://www.googleapis.com/auth/adwords

  6. روی افزودن به جدول کلیک کنید.
  7. هر حوزه دیگری که پروژه شما ممکن است به آن نیاز داشته باشد اضافه کنید، سپس روی UPDATE کلیک کنید.
  8. روی ذخیره و ادامه کلیک کنید.
  9. اگر قصد ندارید پروژه خود را فوراً منتشر کنید، آدرس ایمیل هر حساب کاربری را که ممکن است برای آزمایش استفاده کنید اضافه کنید، سپس روی ذخیره و ادامه کلیک کنید.
  10. صفحه خلاصه را مرور کنید و بر بازگشت به داشبورد کلیک کنید.
  1. صفحه Consent Screen را باز کنید و پروژه خود را در منوی کشویی در بالای صفحه انتخاب کنید.
  2. روی EDIT APP کلیک کنید.
  3. روی ذخیره و ادامه در فرم صفحه رضایت OAuth کلیک کنید.
  4. در صفحه بعد، روی افزودن یا حذف SCOPES کلیک کنید.
  5. به پایین پیمایش کنید و موارد زیر را در قسمت Manually Add scopes وارد کنید:

    https://www.googleapis.com/auth/adwords

  6. روی افزودن به جدول کلیک کنید.
  7. روی ذخیره و ادامه کلیک کنید.
  8. روی ذخیره و ادامه در فرم کاربران تست کلیک کنید.
  9. صفحه خلاصه را مرور کنید و بر بازگشت به داشبورد کلیک کنید.

یک شناسه مشتری و راز مشتری ایجاد کنید

اگر از یک پروژه کنسول Google API موجود که قبلاً دارای شناسه مشتری و راز تولید شده است، استفاده می‌کنید، می‌توانید از این مرحله بگذرید.

بعد از اینکه نوع برنامه خود را مشخص کردید، دستورالعمل های زیر را دنبال کنید تا شناسه مشتری OAuth 2.0 و راز سرویس گیرنده ایجاد کنید:

  1. صفحه اعتبارنامه را باز کنید. یک پروژه ایجاد شده قبلی را انتخاب کنید یا یک پروژه جدید ایجاد کنید.

  2. در صفحه Credentials، روی CREATE CREDENTIALS کلیک کنید، سپس OAuth Client ID را انتخاب کنید.

    • اگر قبلاً صفحه رضایت OAuth را برای این پروژه پیکربندی نکرده‌اید، روی «پیکربندی صفحه رضایت» کلیک کنید.

      • نوع کاربر را انتخاب کنید و روی CREATE کلیک کنید.

      • فرم اولیه را پر کنید. در صورت نیاز می توانید بعداً این را ویرایش کنید. پس از اتمام روی ذخیره کلیک کنید.

    • برای ادامه به Credentials > CREATE CREDENTIALS > OAuth Client ID برگردید.

  3. بسته به مورد استفاده خود، برنامه دسکتاپ یا برنامه وب را به عنوان نوع برنامه انتخاب کنید. این راهنما از برنامه دسکتاپ به عنوان نوع برنامه استفاده می کند.

  4. یک نام برای برنامه وارد کنید، سپس روی ایجاد کلیک کنید.

  5. در صفحه تأیید، شناسه مشتری و راز مشتری خود را در کلیپ بورد خود کپی کنید تا بعداً کتابخانه مشتری خود را پیکربندی کنید. همچنین، اعتبارنامه ها را با فرمت JSON در فایلی با نام credentials.json دانلود کنید.

Google Ads API را در پروژه خود فعال کنید

برای فعال کردن Google Ads API در پروژه خود، این مراحل را دنبال کنید:

  1. کتابخانه API را در Google API Console باز کنید . اگر از شما خواسته شد، پروژه خود را انتخاب کنید یا یک پروژه جدید ایجاد کنید. کتابخانه API همه API های موجود را فهرست می کند که بر اساس خانواده محصول و محبوبیت گروه بندی شده اند.

  2. اگر Google Ads API در لیست قابل مشاهده نیست، از جستجو برای یافتن API استفاده کنید.

  3. Google Ads API را انتخاب کنید، سپس روی دکمه فعال کردن کلیک کنید.