قبل از اجرای برنامه‌ای که از کاربران خارجی برای رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) درخواست اعتبارنامه کاربر می‌کند، پروژه Google Cloud شما باید تحت تأیید برنامه Google OAuth قرار گیرد.
این راهنما، انتقال‌های پیکربندی توصیه‌شده‌ی مخاطبان در طول توسعه و مراحل تکمیل تأیید برنامه‌ی Google OAuth را پوشش می‌دهد.
مراحل مخاطبان برنامه
بسته به مرحله توسعه خود، صفحه مخاطبان را در کنسول Google Cloud با تنظیمات مختلف نوع کاربر و وضعیت انتشار پیکربندی کنید. برای انتقال روان از آزمایش اولیه به راه‌اندازی نهایی، این مراحل را دنبال کنید.
فاز ۱: توسعه اولیه (آزمایش)
هنگام شروع توسعه و آزمایش درخواست‌های اولیه API:
- وضعیت انتشار : روی «در حال آزمایش» تنظیم شده است.
نوع کاربری :
اگر پروژه Google Cloud شما متعلق به یک سازمان Google Workspace است و فقط کاربران سازمان شما از برنامه استفاده می‌کنند، گزینه Internal را انتخاب کنید.
در غیر این صورت، خارجی را انتخاب کنید.
کاربران آزمایشی : اگر نوع کاربر را روی خارجی تنظیم کرده‌اید، روی افزودن کاربران کلیک کنید تا حساب‌های گوگلی که برای تولید اعتبارنامه استفاده می‌کنید را به صورت دستی اضافه کنید. فقط حساب‌های گوگل فهرست‌شده می‌توانند برنامه را تأیید کنند و محدودیت‌های آزمایشی و قوانین انقضای توکن اعمال می‌شود.
تأیید : در طول آزمایش لازم نیست. اگر از External استفاده می‌کنید، کاربران آزمایشی قبل از رفتن به صفحه رضایت، صفحه هشداری را مشاهده می‌کنند که تأیید می‌کند به یک برنامه تأیید نشده دسترسی آزمایشی دارند.
مرحله ۲: نزدیک به راه‌اندازی (ارسال تأیید)
وقتی یکپارچه‌سازی شما کامل شد، رابط کاربری شما ساخته شده است و قصد دارید ظرف ماه آینده آن را راه‌اندازی کنید:
- وضعیت انتشار : در حال گذار به در دست تولید .
- نوع کاربر : اگر برنامه شما به مشتریان خارج از سازمان شما، مانند مشتریان تبلیغ‌کننده، خدمات ارائه می‌دهد، روی خارجی تنظیم کنید.
- اقدام : برنامه خود را برای تأیید ارسال کنید . فرآیند تأیید برنامه Google OAuth می‌تواند چندین هفته طول بکشد، بنابراین پس از آماده شدن رابط کاربری خود، در اسرع وقت ارسال کنید.
- رسیدگی به آزمایش‌کنندگان اولیه : در طول بررسی تأیید، برنامه شما برای کاربران خارجی تأیید نشده باقی می‌ماند. اگر نیاز به آزمایش‌کنندگان بتای اولیه دارید:
- به آنها اطلاع دهید که با صفحه برنامه تأیید نشده مواجه خواهند شد.
- با کلیک روی Advanced و سپس Go to APP_NAME (unsafe) به آنها دستور دهید تا ادامه دهند.
الزامات تأیید برنامه
برای ارسال برنامه خود برای تأیید در مرکز تأیید ، تنظیمات Google Auth Platform خود را پیکربندی کنید و موارد تأیید لازم را آماده کنید.
دامنه‌های تأیید
در صفحه دسترسی به داده‌ها ، فقط محدوده‌هایی را که برنامه شما نیاز دارد درخواست کنید. API مدیریت داده از محدوده‌های حساس استفاده می‌کند:
-
https://www.googleapis.com/auth/datamanager(دامنه اصلی) -
https://www.googleapis.com/auth/datamanager.partnerlink(برای لینک‌های همکار)
اطلاعات تماس
تیم تأیید هویت گوگل (Google OAuth) تمام ارتباطات را به صاحبان پروژه و ویرایشگران پروژه که در پروژه گوگل کلود شما پیکربندی شده‌اند، ارسال می‌کند. این اطلاعات تماس را در کنسول گوگل کلود به‌روز نگه دارید تا درخواست‌های اطلاعات را از دست ندهید.
ویدیوی نمایشی
پیوندی به یک ویدیوی نمایشی قابل دسترس برای عموم (مانند یک ویدیوی یوتیوب فهرست نشده یا یک لینک عمومی گوگل درایو) ارائه دهید که نحوه استفاده برنامه شما از محدوده‌های درخواستی را نشان دهد.
مطمئن شوید که ویدیو، الزامات ویدیوی نمایشی عملکرد برنامه را برآورده می‌کند.
مرحله ۳: آماده برای راه‌اندازی (تأیید شده)
به محض اینکه تیم تأیید اعتبار گوگل OAuth به شما اطلاع دهد که درخواست تأیید اعتبار برنامه شما را تأیید کرده است، نیازی به انجام هیچ کاری نیست. برنامه شما اکنون تأیید شده است و کاربران خارجی می‌توانند بدون مواجهه با صفحه هشدار برنامه تأیید نشده، آن را تأیید کنند.