درخواست‌های ارسال‌شده به 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، یکی از رویکردهای قبلی را براساس الزامات سیستم خود انتخاب کنید و چند شناسه مشتری آزمایشی را شناسایی کنید. اگر شک دارید، با جریان اصالت‌سنجی تک‌کاربره با حساب‌های پیوندشده شروع کنید.
قدم بعدی چیست
با نحوه مشخص کردن طرح رسانه آشنا شوید.