جدول زیر اطلاعات اعتباری‌ای را که برنامه باید مدیریت کند خلاصه می‌کند. برای کسب اطلاعات بیشتر درباره انواع برنامه، به سند Google Identity OAuth 2.0 مراجعه کنید.
| گردش کار اصالت‌سنجی | اطلاعات کاربری | نوع اعتبارنامه | هدف |
|---|---|---|---|
|
برنامه‌های وب جاوا اسکریپت Android Apps |
شناسه کارخواه OAuth | اعتبارنامه‌های برنامه | برنامه را به‌طور منحصربه‌فرد درطول جریان OAuth شناسایی می‌کند. |
| کد دسترسی و ژتون بازآوری | اطلاعات کاربری | نشان‌دهنده مجوز کاربر برای اجازه دادن به برنامه برای دسترسی به حساب Google Ads او ازطرف او است. | |
|
برنامه‌های وب سمت سرور برنامه‌های رایانه و iOS برنامه‌های تلویزیون و دستگاه |
شناسه کارخواه OAuth و رمز کارخواه | اعتبارنامه‌های برنامه | برنامه را به‌طور منحصربه‌فرد درطول جریان OAuth شناسایی می‌کند. |
| کد دسترسی و ژتون بازآوری | اطلاعات کاربری | نشان‌دهنده مجوز کاربر برای اجازه دادن به برنامه برای دسترسی به حساب Google Ads او ازطرف او است. | |
| حساب‌های سرویس | کلید حساب سرویس OAuth | اعتبارنامه‌های برنامه | برای امضای درخواست OAuth استفاده می‌شود. |
| کد دسترسی حساب سرویس | اطلاعات کاربری | وقتی کاربری حساب Google Ads خود را با حساب خدمات هم‌رسانی می‌کند، مجوز حساب خدمات را نشان می‌دهد. |
هنگام مدیریت اعتبارنامه‌ها برای برنامه Google Ads API، چند نکته را باید درنظر بگیرید.
مدیریت ایمن اطلاعات اعتباری برنامه
اعتبارنامه برنامه به تنظیماتی اشاره دارد که مختص برنامه شما است و از کاربری به کاربر دیگر تغییر نمی‌کند. با اطلاعات اعتباری برنامه OAuth خود با نهایت دقت رفتار کنید، زیرا هرکسی که آن‌ها را داشته باشد می‌تواند از هویت برنامه شما برای دسترسی به اطلاعات کاربر استفاده کند. اطلاعات کاربری برنامه OAuth را در مکانی امن ذخیره کنید و از آن‌ها محافظت کنید، درست همان‌طور که از گذرواژه محافظت می‌کنید. درصورت امکان، از مدیر رمزها، مانند Google Cloud Secret Manager، برای ذخیره کردن اعتبارنامه‌های برنامه استفاده کنید. هرگز نباید اعتبارنامه‌های مشتری را در مخازن کد دردسترس عموم ثبت کنید. اکیداً توصیه می‌کنیم از ارسال آن‌ها به هرگونه مخزن کد خودداری کنید.
مدیریت ایمن اطلاعات اعتباری کاربر
اعتبارنامه کاربر به ژتون‌های OAuth اشاره دارد که نشان‌دهنده مجوز کاربر است. این اطلاعات توسط کاربرانی که به شما اجازه می‌دهند ازطرف آن‌ها اقدام کنید و به داده‌هایشان دسترسی داشته باشید به شما سپرده می‌شود—چه مستقیماً با اصالت‌سنجی کردن برنامه شما، چه غیرمستقیم با هم‌رسانی کردن حساب Google Ads خود با حساب سرویس شما. هرگز نشان‌ها را به‌صورت نوشتار ساده منتقل نکنید و همیشه نشان‌های رمزگذاری‌شده را در حالت سکون ذخیره کنید تا درصورت سرقت اطلاعات شبکه، یک لایه محافظتی تکمیلی ارائه شود. وقتی دیگر به حساب کاربر نیاز ندارید، اجازه‌های حساب سرویس یا توکن‌ها را لغو کنید. پس‌از باطل شدن توکن‌ها، آن‌ها را برای همیشه از برنامه یا سیستم خود حذف کنید.
رسیدگی به ابطال و انقضای ژتون بازآوری
اگر از جریان اصالت‌سنجی کاربر استفاده می‌کنید، به‌خاطر داشته باشید که ژتون‌های بازآوری ممکن است در هرزمانی باطل شوند. برای مثال، اگر از جریان اصالت‌سنجی چندکاربره استفاده می‌کنید، کاربر می‌تواند دسترسی به برنامه‌تان را لغو کند. اگرچه احتمال اینکه برنامه‌ای که از جریان اصالت‌سنجی تک‌کاربره استفاده می‌کند به این روش تحت‌تأثیر قرار بگیرد کمتر است، اما فرایند دستی یا خودکاری که برای محافظت از کاربران طراحی شده است همچنان می‌تواند ژتون بازآوری را پاک کند یا ژتون بازآوری منقضی شود. اگر برنامه‌تان برای ارائه تجربه خوب به کاربران به اعلان لغو کردن رمز نیاز دارد، باید با سرویس محافظت بین‌حسابی ادغام شوید.
استفاده مجدد از اطلاعات اعتباری کاربر در درخواست‌های API
کدهای دسترسی OAuth کوتاه‌مدت هستند و پس‌از یک ساعت منقضی می‌شوند. اگر از کتابخانه کارخواه Google Ads API استفاده می‌کنید، کتابخانه انقضای کد دسترسی را مدیریت می‌کند و به‌صورت ایمن از رشته بازآوری می‌کند. یک شیء کارخواه Google Ads API با اعتبارنامه OAuth مناسب بسازید و درطول عمر آن دوباره از آن استفاده کنید.
اگر استراتژی مدیریت و بازآوری کد دسترسی خودتان را می‌سازید، انقضای کد دسترسی را پیگیری کنید و تا زمانی که کدها معتبر هستند از آن‌ها دوباره استفاده کنید. وقتی
درخواست بازآوری کد می‌دهید، سرور صدور مجوز کد دسترسی جدیدی را
به‌همراه مدت باقی‌مانده به ثانیه
(expires_in) برمی‌گرداند. توصیه می‌کنیم اگر کمتر از ۵ دقیقه تا انقضا باقی مانده است،
کد دسترسی را پیش‌دستانه بازآوری کنید.