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