جدول زیر اطلاعات اعتباری‌ای را که برنامه باید مدیریت کند خلاصه می‌کند. برای کسب اطلاعات بیشتر درباره انواع برنامه، به سند 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 خود با حساب سرویس شما. هرگز نشان‌ها را به‌صورت نوشتار ساده منتقل نکنید و همیشه نشان‌های رمزگذاری‌شده را در حالت سکون ذخیره کنید تا درصورت سرقت اطلاعات شبکه، یک لایه محافظتی اضافی فراهم شود. وقتی دیگر به حساب کاربر نیاز ندارید، اجازه‌های حساب سرویس یا توکن‌ها را لغو کنید. پس‌از باطل شدن توکن‌ها، آن‌ها را برای همیشه از برنامه یا سیستم خود حذف کنید.
لغو و انقضای ژتون بازآوری را مدیریت کنید
اگر از جریان اصالت‌سنجی کاربر استفاده می‌کنید، به‌خاطر داشته باشید که نشان‌های بازآوری را می‌توان در هر زمانی نامعتبر کرد. برای مثال، اگر از جریان اصالت‌سنجی چندکاربره استفاده می‌کنید، کاربر می‌تواند انتخاب کند که دسترسی به برنامه‌تان را لغو کند. درحالی‌که احتمال کمتری وجود دارد که برنامه‌ای که از جریان اصالت‌سنجی تک‌کاربره استفاده می‌کند به این روش تحت‌تأثیر قرار گیرد، فرایند دستی یا خودکاری که برای محافظت از کاربران طراحی شده است همچنان می‌تواند ژتون بازآوری را پاک کند، یا ممکن است ژتون بازآوری منقضی شود. اگر برنامه شما برای ارائه تجربه خوب به کاربران به اعلان ابطال رمز نیاز دارد، باید با سرویس محافظت بین‌حسابی ادغام شوید.
استفاده مجدد از اعتبارنامه‌های کاربر در درخواست‌های میانای برنامه‌سازی کاربردی
کدهای دسترسی OAuth کوتاه‌مدت هستند و پس‌از یک ساعت منقضی می‌شوند. اگر از کتابخانه کارخواه Google Ads API استفاده می‌کنید، کتابخانه انقضای کد دسترسی و بازآوری را به‌روش ایمن برای رشته‌ها مدیریت می‌کند. شیء کارخواه Google Ads API را با اطلاعات اعتباری OAuth مناسب بسازید و در طول عمر آن از آن استفاده مجدد کنید.
اگر استراتژی مدیریت و بازآوری کد دسترسی خودتان را می‌سازید، انقضای کد دسترسی را پیگیری کنید و تا زمانی که کدها معتبر هستند از آن‌ها مجدداً استفاده کنید. وقتی
درخواست بازآوری کد می‌دهید، سرور صدور مجوز کد دسترسی جدیدی را
به‌همراه مدت باقی‌مانده به ثانیه
(expires_in) برمی‌گرداند. توصیه می‌کنیم اگر کمتر از ۵ دقیقه
تا انقضا باقی مانده است، کد دسترسی را پیش‌دستانه بازآوری کنید.