نام مستعار مشترک

هنگام کار با Google Ads API، مکان‌های متعددی وجود دارد که از آدرس‌های ایمیل برای مدیریت تماس و دسترسی استفاده می‌شود که مهم‌ترین آنها موارد زیر است:

• ایمیل تماس Google Ads API : این ایمیلی است که به عنوان مخاطب در مرکز API رابط کاربری Google Ads فهرست شده است.
• ایمیل حساب Google Cloud Console : این ایمیلی است که دسترسی سرپرست به حساب Google Cloud Console مورد استفاده برای برنامه OAuth 2.0 شما دارد.
• ایمیل(های) حساب مدیر Google Ads : اینها ایمیل هایی هستند که دارای مجوزهای سرپرست در حساب(های) مدیر Google Ads هستند که از طریق Google Ads API به آنها دسترسی دارید. هنگامی که یک توکن به‌روزرسانی برای برنامه خود ایجاد می‌کنید، معمولاً برنامه Google Ads API خود را با یکی از این ایمیل‌ها احراز هویت می‌کنید.

ما اکیداً توصیه می‌کنیم از نام مستعار تیم مشترک استفاده کنید تا وقتی اعضای تیم تغییر تیم می‌دهند یا شرکت را ترک می‌کنند، دسترسی به این حساب‌ها را از دست ندهید. بقیه این راهنما در مورد هر یک از ایمیل‌هایی که قبلاً فهرست شده‌اند و اینکه چگونه می‌توانید آن را برای استفاده از نام مستعار تیم مشترک به جای آدرس ایمیل یک کاربر به‌روزرسانی کنید، توضیح می‌دهد.

ایمیل تماس Google Ads API

ایمیل تماس Google Ads API آدرس ایمیلی است که هنگام ثبت نام برای Google Ads API ارائه می کنید. شما باید از دسترسی به این نام مستعار اطمینان حاصل کنید و ایمیل های ارسال شده به این آدرس را به طور مرتب نظارت کنید. Google از این آدرس ایمیل برای تماس با تیم شما در طول بررسی های API، درخواست های ممیزی یا شرایط اضطراری تولید که نیاز به توجه فوری دارند، استفاده می کند. از نام مستعار تیم مشترک به عنوان ایمیل تماس استفاده کنید تا مطمئن شوید که کل تیم این اعلان‌ها را دریافت می‌کند.

این مراحل را برای به‌روزرسانی ایمیل تماس API دنبال کنید:

• وارد حساب مدیر Google Ads شوید که هنگام درخواست دسترسی به Google Ads API استفاده کردید. این همان حسابی است که توکن توسعه دهنده شما در آن قرار دارد.
• به Tools & Settings > API Center بروید.
• روی فلش زیر بخش ایمیل تماس API کلیک کنید.
• آدرس ایمیل را به روز کنید و روی دکمه ذخیره کلیک کنید.

حساب Google Cloud Console

پروژه Google API Console حاوی اطلاعات کاربری OAuth برنامه شما است و دسترسی به API Google Ads را کنترل می کند. با قرار دادن نام مستعار مشترک به عنوان مالک حساب، دسترسی به این حساب را تضمین کنید.

برای به‌روزرسانی مالک پروژه Google API Console این مراحل را دنبال کنید:

• وارد Google API Console شوید.
• پروژه خود را از منوی کشویی در گوشه سمت چپ بالای صفحه انتخاب کنید.
• از منوی سمت چپ به IAM و admin > IAM بروید.
• روی دکمه Grant Access کلیک کنید.
• آدرس ایمیل مشترک را در قسمت Add principals وارد کنید.
• نقش مالک را تعیین کنید.
• روی دکمه Save کلیک کنید. برای کسب اطلاعات بیشتر در مورد اعطای و لغو دسترسی به اسناد Cloud مراجعه کنید.

حساب مدیر Google Ads

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

• توسعه‌دهنده با استفاده از اعتبار کاربری که به حساب مدیر Google Ads دسترسی دارد، یک نشانه به‌روزرسانی صادر می‌کند.
• برنامه‌نویس هدر login_customer_id را به‌عنوان شناسه مشتری حساب مدیر Google Ads و سرصفحه customer_id به‌عنوان شناسه مشتری حسابی که تماس‌های API با آن برقرار می‌شود، تنظیم می‌کند.

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