درخواست‌های ReachPlanService باید
اعتبارنامه‌های OAuth و شناسه مشتری‌ای را که اعتبارنامه‌های OAuth شما بتواند به آن دسترسی داشته باشد ارائه دهد. علاوه‌براین، پروژه Google Cloud منسوب به اطلاعات اعتباری OAuth شما باید برای استفاده از این سرویس تأیید شود.
این راهنما جزئیات اصالت‌سنجی ویژه
ReachPlanService را پوشش می‌دهد. اگر هنوز این کار را نکرده‌اید، ابتدا مراحل ذکرشده در شروع به کار را تکمیل کنید، سپس به این راهنما برگردید.
اعتبارنامه‌های OAuth
علاوه‌بر راهنمایی‌های ارائه‌شده در شروع به کار، نکات زیر را درنظر داشته باشید:
- شماره پروژه Google Cloud شما باید به فهرست مجاز مناسب اضافه شود
تا به
ReachPlanServiceمتصل شود، حتی اگر قبلاً برای استفاده با دیگر سرویس‌های Google Ads API تأیید شده باشد. برای اطلاعات بیشتر، الزامات واجد شرایط بودن را ببینید. - برای اتصال به Google Ads API، باید «شرایط خدمات Google Ads API» را بپذیرید.
- کاربری که مالک ژتون بازآوری OAuth شما است تعیین می‌کند که در
ReachPlanServiceبتوانید کدام شناسه‌های مشتری را پُرسمان کنید. این امر بر ادغام شما تأثیر می‌گذارد و در بخش‌های زیر با جزئیات بیشتری توضیح داده شده است.
شناسه‌های مشتری
اکثر سرویس‌های درون Google Ads API روی حساب‌ها و پویش‌های Google Ads خاصی کار می‌کنند. درنتیجه، اکثر درخواست‌ها هم به شناسه مشتری برای شناسایی حساب هدف و هم به اعتبارنامه OAuth مجاز برای دسترسی به آن شناسه مشتری نیاز دارند.
بااین‌حال، ReachPlanService برای فعالیت‌های برنامه‌ریزی ویدیو درنظر گرفته شده است که ممکن است قبل‌از ایجاد حساب مشتری خاص برای اجرای پویش رخ دهد.
ابزارهای داخلی
اگر ابزارهایی برای استفاده داخلی در سازمانتان می‌سازید، گزینه‌های زیر را درنظر بگیرید:
- برنامه‌ریزهای بدون دسترسی مستقیم به حساب مشتری: اگر برنامه‌ریزهایتان
به حساب‌های Google Ads مشتریانتان دسترسی ندارند، بااستفاده از جریان اصالت‌سنجی تک‌کاربره
برای کاربری که به حساب مدیرتان دسترسی دارد، اعتبارنامه OAuth تولید کنید. سپس، برای هر تیم بااستفاده از ابزار خود، حساب Google Ads ایجاد کنید یا به‌دست آورید و آن‌ها را به حساب مدیر خود پیوند دهید. هنگام درخواست از
ReachPlanService، شناسه مشتری مربوط به تیم کاربر را ارائه دهید. - برنامه‌ریزان با دسترسی به حساب مشتری: اگر برنامه‌ریزان شما به حساب مدیر Google Ads که حساب‌های مشتریانتان را مدیریت می‌کند دسترسی دارند، جریان اصالت‌سنجی چندکاربره را پیاده‌سازی کنید تا به برنامه‌تان اجازه دهید از اطلاعات اعتباری OAuth برنامه‌ریزانتان استفاده کند. سپس می‌توانید شناسه مشتری مربوط به طرح مشتری را ارسال کنید.
ابزارهای خارجی
اگر برای کاربران طرف سوم یا خارجی ابزار می‌سازید، گزینه‌های زیر را توصیه می‌کنیم:
- حساب‌های هر مشتری: اطلاعات اعتباری OAuth را بااستفاده از جریان اصالت‌سنجی تک‌کاربره برای کاربری که به حساب مدیر شما دسترسی دارد تولید کنید. برای هر مشتری خارجی، حساب Google Ads ایجاد کنید و آن‌ها را به حساب مدیرتان پیوند دهید. ابزارتان را پیکربندی کنید تا هنگام تولید طرح‌ها، شناسه مشتری مربوط به کارخواه را ارائه دهد.
- دسترسی اعطاشده ازسوی کاربر: به کاربران خود اجازه دهید بااستفاده از جریان اصالت‌سنجی چندکاربره، به ابزار شما اجازه دسترسی به حساب‌هایشان را بدهند. پس‌از اینکه کاربر اجازه داد، از
CustomerServiceبرای بازیابی فهرست حساب‌های Google Ads که می‌تواند به آن‌ها دسترسی داشته باشد استفاده کنید.
پیش‌از یکپارچه‌سازی API، یکی از رویکردهای قبلی را براساس الزامات سیستم خود انتخاب کنید و چند شناسه مشتری آزمایشی را شناسایی کنید. اگر مطمئن نیستید، با جریان اصالت‌سنجی تک‌کاربر با حساب‌های پیوندشده شروع کنید.
قدم بعدی چیست
با نحوه مشخص کردن طرح رسانه‌ای آشنا شوید.