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

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

برای آشنایی با بهترین روش های پروژه Cloud، این ویدیو را تماشا کنید

تأیید Google OAuth

هر برنامه Google Cloud که برای به دست آوردن اعتبار برای دامنه Google Ads API استفاده می‌شود، باید تأییدیه Google OAuth را انجام دهد تا از صفحه رابط کاربری تأییدنشده برای کاربران خود جلوگیری کند. یک برنامه، در این زمینه، به عنوان شناسه مشتری OAuth 2.0 منحصر به فرد در Google Cloud تعریف می شود.

این راستی‌آزمایی مستقل است و علاوه بر بررسی‌هایی که به‌عنوان بخشی از فرآیند تأیید توکن توسعه‌دهنده انجام می‌شود، و از آنجایی که حوزه API Google Ads یک حوزه حساس است، لازم است.

برای راستی‌آزمایی Google که معمولاً طی 3 تا 5 روز کاری تکمیل می‌شود، هزینه‌ای وجود ندارد. این سیاست برای همه برنامه ها اعمال می شود.

توصیه می‌کنیم همه برنامه‌ها در اسرع وقت فرآیند تأیید Google OAuth را انجام دهند تا از هرگونه وقفه در کار جلوگیری شود.

یک پروژه ایجاد کنید

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

نکته کلیدی: اگر صورت‌حساب را فعال کرده‌اید - به عنوان مثال برای Google Cloud - باید یک حساب صورت‌حساب برای پروژه جدید انتخاب کنید.

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

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

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

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

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

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

نوع کاربر و وضعیت انتشار را انتخاب کنید

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

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

عدم تکمیل تأییدیه Google OAuth بدون توجه به نوع کاربر یا وضعیت انتشار پروژه شما، نتایج زیر را نشان می دهد:

• در طول فرآیند مجوز، یک صفحه رابط کاربری تأیید نشده به کاربران نمایش داده می‌شود.

• شما محدود به اجازه دادن به 100 کاربر هستید.

صفحه رضایت OAuth را پیکربندی کنید

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

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

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

4. در صفحه بعد، روی افزودن یا حذف SCOPES کلیک کنید.

   • به پایین پیمایش کنید و موارد زیر را در قسمت Manually Add scopes وارد کنید:

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

   • روی افزودن به جدول کلیک کنید.

   • هر محدوده دیگری که پروژه شما درخواست می کند اضافه کنید، سپس روی UPDATE کلیک کنید.

   • روی ذخیره و ادامه کلیک کنید.

5. اگر قصد ندارید پروژه خود را فوراً منتشر کنید، آدرس ایمیل هر حساب کاربری را که برای آزمایش استفاده می کنید اضافه کنید، سپس روی ذخیره و ادامه کلیک کنید.

6. صفحه خلاصه را مرور کنید و بر بازگشت به داشبورد کلیک کنید.

پس از آزمایش برنامه و فرآیند مجوز، می‌توانید به داشبورد برگردید و روی PUBLISH APP کلیک کنید تا وضعیت انتشار آن از آزمایش به در حال تولید تغییر کند.

یک نوع برنامه را انتخاب کنید

دو گزینه نوع برنامه برای API Google Ads وجود دارد: دسکتاپ یا وب. برای تعیین اینکه کدام نوع برای برنامه ای که می خواهید بسازید مناسب است، به جدول زیر مراجعه کنید:

این نوع برنامه را انتخاب کنید	اگر...
برنامه دسکتاپ	شما با استفاده از یک حساب مدیر سطح بالا، همه حساب‌های Google Ads خود را مدیریت می‌کنید. شما برای اولین بار کاربر هستید یا می خواهید با ساده ترین راه اندازی سریع شروع کنید. برنامه شما فقط کاربران Google را از یک دستگاه احراز هویت می کند.
برنامه وب	می‌خواهید به‌عنوان کاربری که می‌تواند به برنامه شما اجازه دسترسی به داده‌های حساب Google Ads خود را بدهد، احراز هویت شوید. شما می خواهید به راحتی چندین اعتبار مجوز تولید کنید، به عنوان مثال، حساب های شخص ثالث را مدیریت کنید. برنامه شما به URL های پاسخ به تماس نیاز دارد. URL های پاسخ به تماس در جریان برنامه دسک تاپ پشتیبانی نمی شوند.

نکته کلیدی: شما همچنان می‌توانید جریان برنامه دسک‌تاپ را انتخاب کنید، حتی اگر در حال توسعه برنامه‌ای برای اجرا در سرور هستید. تفاوت این است که آیا مجوز OAuth به صورت محلی یا از راه دور تکمیل می شود. یک جریان دسکتاپ نیاز به مجوز برای تکمیل در ماشین محلی دارد، در حالی که جریان وب اجازه می دهد تا مجوز در سرور مجوز Google تکمیل شود.

برای جزئیات بیشتر، به مستندات Google Identity Platform OAuth برای برنامه های دسکتاپ یا برنامه های وب مراجعه کنید.

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

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

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

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

   1. اگر قبلاً صفحه رضایت OAuth را برای این پروژه پیکربندی نکرده بودید، اکنون به شما دستور داده می شود که این کار را انجام دهید. روی پیکربندی صفحه رضایت کلیک کنید.

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

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

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

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

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

5. اگر نوع مشتری شما برنامه وب است، حداقل یک URI تغییر مسیر مجاز اضافه کنید.

   برای آزمایش محلی که با پیکربندی پیش‌فرض در نمونه‌های کتابخانه مشتری ما سازگار است، از http://127.0.0.1 استفاده کنید.

   توجه: می‌توانید یک شماره پورت به URI تغییر مسیر خود اضافه کنید تا استفاده را به یک پورت خاص محدود کنید. اگر پورت تنظیم نشده باشد، یک سرویس گیرنده OAuth می تواند به هر پورتی هدایت شود.

   برای کلاینت‌های برنامه دسک‌تاپ ، همچنان از تغییر مسیر IP حلقه بک استفاده می‌کنید، اما URI به صراحت در کنسول Cloud پیکربندی نشده است.

6. در صفحه تایید، شناسه مشتری و راز مشتری خود را در کلیپ بورد خود کپی کنید، زیرا هنگام پیکربندی کتابخانه مشتری به آنها نیاز خواهید داشت. همچنین می توانید بعداً برای بازیابی این جزئیات به صفحه اعتبارنامه بازگردید.