قبل‌از راه‌اندازی برنامه‌ای که اطلاعات کاربری کاربر را برای Data Manager API از کاربران خارجی درخواست می‌کند، پروژه Google Cloud شما باید درستی‌سنجی برنامه Google OAuth را انجام دهد.
این راهنما انتقال‌های پیکربندی توصیه‌شده مخاطب را درطول توسعه و مراحل تکمیل درستی‌سنجی برنامه Google OAuth پوشش می‌دهد.
مراحل مخاطب برنامه
بسته به مرحله توسعه، صفحه مخاطب را در کنسول Google Cloud با تنظیمات مختلف نوع کاربر و وضعیت انتشار پیکربندی کنید. این مراحل را دنبال کنید تا انتقال از آزمایش اولیه به راه‌اندازی تولید به‌آرامی انجام شود.
مرحله ۱: توسعه اولیه (آزمایش)
هنگام شروع توسعه و آزمایش درخواست‌های پایه میانای برنامه‌سازی کاربردی:
وضعیت انتشار: روی آزمایش تنظیم شده است.
نوع کاربر:
اگر پروژه Google Cloud شما به سازمان Google Workspace تعلق دارد و فقط کاربران سازمان شما از برنامه استفاده می‌کنند، داخلی را انتخاب کنید.
درغیراین‌صورت، خارجی را انتخاب کنید.
کاربران آزمایشی: اگر نوع کاربر را روی خارجی تنظیم کرده‌اید، روی افزودن کاربر کلیک کنید تا «حساب‌های Google» مورد استفاده برای تولید اعتبارنامه را به‌صورت دستی اضافه کنید. فقط «حساب‌های Google» فهرست‌شده می‌توانند برنامه را مجاز کنند و محدودیت‌های آزمایش و قوانین انقضای کد اعمال می‌شود.
درستی‌سنجی درطول آزمایش لازم نیست. اگر از خارجی استفاده می‌کنید، کاربران آزمایشی قبل‌از رفتن به صفحه رضایت، صفحه هشداری را می‌بینند که تأیید می‌کند آن‌ها دسترسی آزمایشی به برنامه تأییدنشده دارند.
فاز ۲: نزدیک به راه‌اندازی (ارسال درستی‌سنجی)
وقتی ادغام شما کامل شد، میانای کاربر شما ساخته شد، و قصد دارید ظرف ماه آینده راه‌اندازی کنید:
تنظیمات صفحه مخاطبان را به‌روز کنید:
وضعیت انتشار: انتقال به در مرحله تولید.
نوع کاربر: اگر برنامه‌تان به مشتریان خارج از سازمانتان، مثل مشتریان تبلیغ‌کننده، خدمات ارائه می‌دهد، آن را روی خارجی تنظیم کنید.
برنامه‌تان را برای درستی‌سنجی ارسال کنید. فرایند درستی‌سنجی برنامه 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 به شما اطلاع داد که درخواست درستی‌سنجی برنامه‌تان را تأیید کرده است، لازم نیست کاری انجام دهید. برنامه‌تان اکنون درستی‌سنجی شده است، و کاربران خارجی می‌توانند بدون مواجه شدن با صفحه هشدار برنامه درستی‌سنجی‌نشده آن را مجاز کنند.