Trước khi phát hành một ứng dụng yêu cầu thông tin xác thực của người dùng cho Data Manager API cho người dùng bên ngoài, dự án trên đám mây của bạn trên Google Cloud phải trải qua quy trình xác minh ứng dụng OAuth của Google.
Hướng dẫn này đề cập đến các bước chuyển đổi cấu hình Đối tượng được đề xuất trong quá trình phát triển và các bước để hoàn tất quy trình xác minh ứng dụng Google OAuth.
Các giai đoạn của đối tượng ứng dụng
Tuỳ thuộc vào giai đoạn phát triển, hãy định cấu hình trang Đối tượng trong Google Cloud Console bằng các chế độ cài đặt Loại người dùng và Trạng thái phát hành khác nhau. Hãy làm theo các giai đoạn sau để chuyển đổi suôn sẻ từ giai đoạn thử nghiệm ban đầu sang giai đoạn phát hành công khai.
Giai đoạn 1: Phát triển ban đầu (Thử nghiệm)
Khi bắt đầu phát triển và thử nghiệm các yêu cầu API cơ bản:
Trạng thái phát hành: Đặt thành Thử nghiệm.
Loại người dùng:
Nếu dự án trên đám mây của bạn trên Google Cloud thuộc một tổ chức Google Workspace và chỉ người dùng trong tổ chức của bạn mới sử dụng ứng dụng này, hãy chọn Nội bộ.
Nếu không, hãy chọn Bên ngoài.
Người dùng thử nghiệm: Nếu bạn đặt Loại người dùng thành Bên ngoài, hãy nhấp vào Thêm người dùng để thêm theo cách thủ công những Tài khoản Google mà bạn dùng để tạo thông tin xác thực. Chỉ những Tài khoản Google có trong danh sách mới có thể uỷ quyền cho ứng dụng và các giới hạn thử nghiệm cũng như quy tắc hết hạn mã thông báo sẽ được áp dụng.
Bạn không cần phải xác minh trong quá trình thử nghiệm. Nếu bạn sử dụng chế độ Bên ngoài, người dùng thử nghiệm sẽ thấy một màn hình cảnh báo xác nhận rằng họ có quyền truy cập thử nghiệm vào một ứng dụng chưa được xác minh trước khi chuyển đến màn hình xin phép.
Giai đoạn 2: Gần ngày ra mắt (Gửi yêu cầu xác minh)
Khi bạn đã hoàn tất việc tích hợp, xây dựng xong giao diện người dùng và dự định ra mắt trong tháng tới:
Cập nhật chế độ cài đặt của trang Đối tượng:
Trạng thái phát hành: Chuyển sang trạng thái Đang phát hành công khai.
Loại người dùng: Đặt thành Bên ngoài nếu ứng dụng của bạn phục vụ khách hàng bên ngoài tổ chức, chẳng hạn như khách hàng là nhà quảng cáo.
Gửi ứng dụng của bạn để xác minh. Quy trình xác minh ứng dụng OAuth của Google có thể mất vài tuần, vì vậy, hãy gửi càng sớm càng tốt sau khi giao diện người dùng của bạn sẵn sàng.
Yêu cầu về việc xác minh ứng dụng
Để gửi ứng dụng của bạn đi xác minh trong Trung tâm xác minh, hãy định cấu hình chế độ cài đặt Nền tảng xác thực của Google và chuẩn bị các tài liệu xác minh cần thiết.
Xây dựng thương hiệu và chính sách quyền riêng tư
Trên Trang xây dựng thương hiệu trong Google Cloud Console, hãy xác minh các thông tin chi tiết sau đây trước khi gửi:
Trang chủ của ứng dụng: Trang chủ của bạn phải truy cập được công khai và có một đường liên kết rõ ràng đến chính sách quyền riêng tư của ứng dụng.
Đường liên kết đến chính sách quyền riêng tư: URL chính sách quyền riêng tư được định cấu hình trên trang Thương hiệu phải khớp với URL chính sách quyền riêng tư được liên kết trên trang chủ của ứng dụng.
Phạm vi xác minh
Trên trang Quyền truy cập dữ liệu, chỉ yêu cầu những phạm vi mà ứng dụng của bạn cần. Data Manager API sử dụng các phạm vi nhạy cảm:
https://www.googleapis.com/auth/datamanager(Phạm vi chính)https://www.googleapis.com/auth/datamanager.partnerlink(Đối với đường liên kết của đối tác)
Trong nội dung gửi xác minh, hãy cung cấp nội dung giải thích chi tiết bằng văn bản về lý do ứng dụng của bạn cần quyền truy cập vào các phạm vi được yêu cầu.
Thông tin liên hệ
Nhóm xác minh OAuth của Google sẽ gửi tất cả thông tin liên lạc đến chủ sở hữu dự án và người chỉnh sửa dự án được định cấu hình trong dự án trên đám mây của bạn trên Google Cloud. Hãy cập nhật thông tin liên hệ này trong bảng điều khiển Google Cloud để không bỏ lỡ các yêu cầu cung cấp thông tin.
Nếu nhóm xác minh gửi câu hỏi tiếp theo hoặc yêu cầu cập nhật (chẳng hạn như thay đổi đối với video minh hoạ hoặc chế độ cài đặt màn hình xin phép), thì quá trình xem xét sẽ tạm dừng cho đến khi bạn phản hồi. Nếu nội dung bạn gửi đã ở trạng thái chờ xử lý hơn vài tuần mà không có thông tin cập nhật, hãy kiểm tra hộp thư đến (bao gồm cả thư mục thư rác và thư rác) của tất cả chủ sở hữu dự án và người chỉnh sửa dự án.
Video thuyết minh
Cung cấp đường liên kết đến một video minh hoạ có thể truy cập công khai (chẳng hạn như một video không công khai trên YouTube hoặc một đường liên kết công khai trên Google Drive) cho thấy cách ứng dụng của bạn sử dụng các phạm vi được yêu cầu.
Đảm bảo video đáp ứng tất cả Yêu cầu đối với video minh hoạ chức năng của ứng dụng, bao gồm cả các bước kiểm tra sau đây đối với Data Manager API:
Hành trình hoàn chỉnh của người dùng và quyền sử dụng OAuth: Cho thấy toàn bộ hành trình của người dùng trong ứng dụng của bạn, bắt đầu từ khi người dùng bắt đầu đăng nhập hoặc uỷ quyền cho đến khi hoàn tất quy trình cấp quyền sử dụng OAuth.
Danh tính ứng dụng trùng khớp: Đảm bảo tên, biểu trưng và thương hiệu của ứng dụng xuất hiện trong video trùng khớp với cấu hình trên trang Thương hiệu trong Google Cloud Console.
Màn hình xin phép bằng OAuth hoàn chỉnh bằng tiếng Anh: Hiển thị toàn bộ màn hình xin phép bằng OAuth với bộ chọn ngôn ngữ ở góc dưới bên trái được đặt thành Tiếng Anh, đồng thời đảm bảo màn hình hiển thị chính xác các phạm vi Data Manager API mà ứng dụng của bạn yêu cầu.
Cách sử dụng phạm vi trong giao diện người dùng của ứng dụng: Minh hoạ các tính năng của ứng dụng sử dụng phạm vi được yêu cầu (ví dụ: tạo đường liên kết đến đối tác, tạo danh sách đối tượng hoặc định cấu hình việc nhập dữ liệu trong giao diện người dùng của ứng dụng).
Giai đoạn 3: Sẵn sàng ra mắt (Đã xác minh)
Sau khi nhóm xác minh OAuth của Google thông báo rằng họ đã phê duyệt yêu cầu xác minh ứng dụng của bạn, bạn không cần làm gì thêm. Ứng dụng của bạn hiện đã được xác minh và người dùng bên ngoài có thể uỷ quyền cho ứng dụng mà không gặp phải màn hình cảnh báo ứng dụng chưa được xác minh.