درستی‌سنجی برنامه OAuth

قبل‌از راه‌اندازی برنامه‌ای که اعتبارنامه کاربر را برای Data Manager API از کاربران خارجی درخواست می‌کند، پروژه Google Cloud شما باید درستی‌سنجی برنامه Google OAuth را انجام دهد.

این راهنما انتقال‌های پیکربندی توصیه‌شده مخاطب را درطول توسعه و مراحل تکمیل درستی‌سنجی برنامه Google OAuth پوشش می‌دهد.

مراحل مخاطب برنامه

بسته به مرحله توسعه، صفحه مخاطب را در کنسول Google Cloud با تنظیمات مختلف نوع کاربر و وضعیت انتشار پیکربندی کنید. این مراحل را دنبال کنید تا انتقال از آزمایش اولیه به راه‌اندازی تولید به‌آرامی انجام شود.

فاز ۱: توسعه اولیه (آزمایش)

هنگام شروع توسعه و آزمایش درخواست‌های پایه میانای برنامه‌سازی کاربردی:

  • وضعیت انتشار: روی آزمایش تنظیم شده است.

  • نوع کاربر:

    اگر پروژه Google Cloud شما به سازمان Google Workspace تعلق دارد و فقط کاربران سازمان شما از برنامه استفاده می‌کنند، داخلی را انتخاب کنید.

    درغیراین‌صورت، خارجی را انتخاب کنید.

  • کاربران آزمایشی: اگر نوع کاربر را روی خارجی تنظیم کرده‌اید، روی افزودن کاربران کلیک کنید تا «حساب‌های Google» را که برای تولید اعتبارنامه استفاده می‌کنید به‌صورت دستی اضافه کنید. فقط «حساب‌های Google» فهرست‌شده می‌توانند برنامه را مجاز کنند و محدودیت‌های آزمایش و قوانین انقضای کد اعمال می‌شود.

درستی‌سنجی درطول آزمایش لازم نیست. اگر از خارجی استفاده می‌کنید، کاربران آزمایشی قبل‌از رفتن به صفحه رضایت، صفحه هشداری را می‌بینند که تأیید می‌کند به برنامه تأییدنشده دسترسی آزمایشی دارند.

فاز ۲: نزدیک به راه‌اندازی (ارسال برای درستی‌سنجی)

وقتی ادغام شما کامل شد، میانای کاربر شما ساخته شد، و قصد دارید ظرف ماه آینده راه‌اندازی کنید:

  1. تنظیمات صفحه مخاطبان را به‌روز کنید:

    • وضعیت انتشار: انتقال به در مرحله تولید.

    • نوع کاربر: اگر برنامه‌تان به مشتریان خارج از سازمانتان، مثل مشتریان آگهی‌دهنده، خدمات ارائه می‌دهد، آن را روی خارجی تنظیم کنید.

  2. برنامه‌تان را برای درستی‌سنجی ارسال کنید. فرایند درستی‌سنجی برنامه Google OAuth ممکن است چند هفته طول بکشد، بنابراین به‌محض آماده شدن میانای کاربر، در اسرع وقت درخواستتان را ارسال کنید.

الزامات درستی‌سنجی برنامه

برای ارسال برنامه‌تان جهت درستی‌سنجی در مرکز درستی‌سنجی، تنظیمات پلاتفرم اصالت‌سنجی Google را پیکربندی کنید و مطالب درستی‌سنجی موردنیاز را آماده کنید.

خط‌مشی رازداری و نمانام‌سازی

در صفحه نمانام‌سازی در کنسول Google Cloud، جزئیات زیر را قبل‌از ارسال تأیید کنید:

  • صفحه اصلی برنامه: صفحه اصلی شما باید برای عموم دردسترس باشد و پیوند نمایانی به خط‌مشی رازداری برنامه‌تان داشته باشد.

  • پیوند خط‌مشی رازداری: نشانی وب خط‌مشی رازداری پیکربندی‌شده در صفحه نمانام‌سازی باید با نشانی وب خط‌مشی رازداری پیوندشده در صفحه اصلی برنامه‌تان مطابقت داشته باشد.

دامنه‌های درستی‌سنجی

در صفحه دسترسی به داده، فقط گستره‌هایی را درخواست کنید که برنامه‌تان نیاز دارد. Data Manager API از گستره‌های حساس استفاده می‌کند:

  • https://www.googleapis.com/auth/datamanager (گستره اصلی)

  • https://www.googleapis.com/auth/datamanager.partnerlink (برای پیوندهای شریک)

در ارسال درستی‌سنجی، توضیح کتبی دقیقی درباره اینکه چرا برنامه‌تان به دامنه‌های درخواستی نیاز دارد ارائه دهید.

اطلاعات تماس

تیم درستی‌سنجی Google OAuth همه مکاتبات را به مالکان پروژه و ویرایشگران پروژه که در پروژه Google Cloud شما پیکربندی شده‌اند ارسال می‌کند. این اطلاعات تماس را در کنسول Google Cloud به‌روز نگه دارید تا درخواست‌های اطلاعات را ازدست ندهید.

اگر تیم درستی‌سنجی سؤالات پیگیری ارسال کند یا درخواست به‌روزرسانی کند (مثل تغییرات در ویدیو نمایشی یا تنظیمات صفحه رضایت)، بازبینی تا زمانی که پاسخ دهید متوقف می‌شود. اگر درخواستتان بیش‌از چند هفته است که بدون به‌روزرسانی در وضعیت معلق قرار دارد، صندوق ورودی ایمیل (ازجمله پوشه‌های هرزنامه و ناخواسته) همه مالکان و ویرایشگران پروژه را بررسی کنید.

ویدیو نمایشی

پیوندی به ویدیو نمایشی دردسترس عموم (مانند ویدیو YouTube فهرست‌نشده یا پیوند Google Drive عمومی) ارائه دهید که نشان دهد برنامه‌تان چگونه از گستره‌های درخواستی استفاده می‌کند.

مطمئن شوید ویدیو همه الزامات ویدیو نمایشی عملکرد برنامه را برآورده می‌کند، ازجمله این بررسی‌های Data Manager API:

  • مسیر کاربر سرتاسر و اعطای OAuth: مسیر کامل کاربر را در برنامه‌تان نشان دهید، از شروع ورود به سیستم یا مجوزدهی توسط کاربر تا تکمیل جریان اعطای OAuth.

  • مطابقت هویت برنامه: مطمئن شوید نام، نشان‌واره، و نمانام‌سازی برنامه که در ویدیو نشان داده می‌شود با پیکربندی صفحه نمانام‌سازی در کنسول Google Cloud مطابقت داشته باشد.

  • صفحه کسب رضایت OAuth کامل به زبان انگلیسی: کل صفحه کسب رضایت OAuth را نشان دهید و انتخابگر زبان در گوشه پایین سمت راست را روی انگلیسی تنظیم کنید و مطمئن شوید که صفحه دقیقاً گستره‌های Data Manager API را که برنامه‌تان درخواست می‌کند نمایش می‌دهد.

  • استفاده از گستره در میانای کاربر برنامه: ویژگی‌های برنامه را که از گستره‌های درخواستی استفاده می‌کنند نشان دهید (برای مثال، ایجاد پیوند شریک، ایجاد فهرست مخاطب، یا پیکربندی دریافت داده در میانای کاربر برنامه).

فاز ۳: آماده راه‌اندازی (درستی‌سنجی‌شده)

وقتی تیم درستی‌سنجی Google OAuth به شما اطلاع داد که درخواست درستی‌سنجی برنامه‌تان را تأیید کرده است، لازم نیست کاری انجام دهید. اکنون برنامه‌تان تأیید شده است، و کاربران خارجی می‌توانند بدون مواجه شدن با صفحه هشدار برنامه تأییدنشده، آن را مجاز کنند.