هنگام کار با Google Ads API، از نشانی‌های ایمیل در چندین مکان برای مدیریت تماس و دسترسی استفاده می‌شود. مهم‌ترین آن‌ها عبارت‌اند از:
- ایمیل تماس Google Ads API: نشانی‌های ایمیلی که نقش مالک یا ویرایشگر در پروژه Google Cloud شما به آن‌ها اختصاص داده شده است و Google از آن‌ها برای ارسال «اعلامیه‌های اجباری خدمات» (MSA) و اعلان‌های اداری استفاده می‌کند.
- ایمیل حساب Google Cloud Console: ایمیلی که دسترسی سرپرست به پروژه Google Cloud مورداستفاده برای برنامه OAuth 2.0 شما را دارد.
- دسترسی حساب مدیر Google Ads: حساب سرویس (توصیه‌شده) یا نام مستعار ایمیل مشترک که دارای اجازه‌های دسترسی در حساب(های) مدیر Google Ads است که ازطریق Google Ads API به آن‌ها دسترسی پیدا شده است.
بقیه این راهنما درباره هریک از حساب‌های فهرست‌شده در بالا و نحوه پیکربندی آن‌ها توضیح می‌دهد تا ادغام شما به نشانی ایمیل کاربر خاصی وابسته نباشد.
ایمیل تماس Google Ads API
Google اعلان‌های اداری، به‌روزرسانی‌های بازبینی API، درخواست‌های حسابرسی، «اعلامیه‌های خدمات اجباری» (MSA)، و ارتباطات اضطراری تولید را به نشانی‌های ایمیل مرتبط با نقش‌های مالک و ویرایشگر پروژه Google Cloud شما ارسال می‌کند (ایمیل‌های تماس جدید API را ببینید، زیرا تنظیمات ایمیل تماس قدیمی API Center در واسط کاربری Google Ads منسوخ شده است).
برای به‌روزرسانی ایمیل تماس خود و اطمینان از اینکه کل تیم شما این اعلان‌ها را دریافت می‌کند، نقش مالک یا ویرایشگر را به یک نام مستعار تیمی مشترک در پروژه Google Cloud خود اعطا کنید و ایمیل‌های ارسال‌شده به آن نام مستعار را به‌طور منظم نظارت کنید.
حساب Google Cloud Console
پروژه «کنسول Google Cloud» حاوی اطلاعات کاربری OAuth برنامه شما است و دسترسی به Google Ads API را کنترل می‌کند. با اعطای نقش مالک (یا ویرایشگر) به نام مستعار تیم مشترک، دسترسی به این پروژه را تضمین کنید.
برای افزودن نام مستعار مشترک به‌عنوان مالک پروژه Google Cloud، این مراحل را دنبال کنید:
- به سیستم کنسول Google Cloud وارد شوید.
- پروژه‌تان را از انتخابگر پروژه در بالای صفحه انتخاب کنید.
- در منو پیمایش، به IAM & Admin (مدیریت هویت و دسترسی و سرپرست) > IAM (مدیریت هویت و دسترسی) بروید.
- روی اجازه دسترسی دادن کلیک کنید.
- در بخش افزودن مدیران، نشانی ایمیل مشترک را در فیلد مدیران جدید وارد کنید.
- در بخش واگذاری نقش‌ها، روی انتخاب نقش کلیک کنید و پایه > مالک (یا پایه > ویرایشگر) را انتخاب کنید.
- روی ذخیره کلیک کنید. اگر نقش مالک را به نشانی ایمیلی خارج از سازمان Google Cloud خود (یا در پروژه‌ای بدون سازمان) اعطا کرده‌اید، Google Cloud یک ایمیل دعوت به نام مستعار مشترک ارسال می‌کند که باید قبل‌از اعمال نقش پذیرفته شود. برای کسب اطلاعات بیشتر درباره اعطا و لغو دسترسی، به اسناد Cloud مراجعه کنید.
حساب مدیر Google Ads
یک روش رایج برای مدیریت حساب‌ها بااستفاده از Google Ads API این است که همه حساب‌هایتان را تحت یک حساب مدیر مشترک پیوند دهید و بااستفاده از اطلاعات کاربری حساب مدیر بالاترین سطح، فراخوانی‌های API را برای همه حساب‌ها انجام دهید. در این پیکربندی، توسعه‌دهنده سرایند درخواست login-customer-id (یا تنظیم پیکربندی کتابخانه مشتری login_customer_id) را روی شناسه مشتری ۱۰ رقمی (بدون خط تیره) حساب مدیر Google Ads تنظیم می‌کند و هدف customer_id را روی حساب عملیاتی که تماس‌های API با آن برقرار می‌شود تنظیم می‌کند.
توصیه‌شده: استفاده از حساب سرویس
استفاده از حساب سرویس رویکرد ترجیحی برای اصالت‌سنجی و دسترسی به حساب مدیر Google Ads است. برخلاف حساب‌های کاربری فردی، حساب خدمات در پروژه Google Cloud شما مدیریت می‌شود و به شخص خاصی مرتبط نیست، که این امر از قطعی‌ها هنگام تغییر نقش اعضای تیم یا ترک شرکت جلوگیری می‌کند. راهنمای حساب سرویس را دنبال کنید تا حساب سرویس ایجاد کنید و به آن اجازه دسترسی به حساب مدیر Google Ads خود را بدهید.
جایگزین: استفاده از ایمیل مستعار مشترک
اگر ادغام شما نمی‌تواند از حساب خدمات استفاده کند و درعوض به گردش کار اصالت‌سنجی تک‌کاربره متکی است، کاربری که به حساب مدیر Google Ads دسترسی دارد، ژتون بازآوری OAuth 2.0 صادر می‌کند.
برای جلوگیری از این سناریو هنگام استفاده از اطلاعات اعتباری کاربر:
- یک ایمیل مستعار مشترک (با پشتیبانی «حساب Google» فعال با درستی‌سنجی گذرکلید فعال) را برای مدیریت این حساب مدیر Google Ads با سطوح دسترسی مناسب دعوت کنید.
- دعوت را بااستفاده از ایمیل مستعار هم‌رسانی‌شده بپذیرید.
- از این ایمیل مستعار مشترک برای صدور کد بازآوری OAuth برای برقراری تماس‌های API استفاده کنید.