Nếu ứng dụng của bạn yêu cầu cấp quyền sử dụng các API của Google để truy cập vào dữ liệu người dùng Google, thì bạn có thể phải hoàn tất quy trình xác minh trước khi ra mắt công khai ứng dụng lần đầu.
Việc yêu cầu này có áp dụng cho ứng dụng của bạn hay không chủ yếu phụ thuộc vào 2 yếu tố:
- Loại dữ liệu người dùng mà bạn truy cập – thông tin hồ sơ công khai, các mục trên lịch, tệp trong Drive, một số dữ liệu sức khoẻ và thể chất, v.v.
- Mức độ truy cập bạn cần – chỉ có thể đọc, đọc và ghi, v.v.
Khi dùng OAuth 2.0 để được một Tài khoản Google cấp quyền truy cập vào dữ liệu, bạn sẽ sử dụng chuỗi được gọi là phạm vi để chỉ định loại dữ liệu mà bạn muốn truy cập thay mặt cho ứng dụng/dịch vụ đó. Nếu ứng dụng của bạn yêu cầu các phạm vi được phân loại là nhạy cảm hoặc bị hạn chế, thì bạn có thể cần hoàn tất quy trình xác minh trừ phi ứng dụng của bạn đủ điều kiện được coi là ngoại lệ.
Ví dụ về phạm vi nhạy cảm bao gồm: sự kiện đọc lưu trữ trong Lịch Google, lưu trữ người liên hệ mới trong Danh bạ Google hoặc xoá video trên YouTube. Để biết thêm thông tin về phạm vi có sẵn và cách phân loại các phạm vi đó, hãy tham khảo tài liệu tham khảo về điểm cuối API mà ứng dụng của bạn gọi, cũng như mọi hướng dẫn uỷ quyền có liên quan được phát hành cho API.
Bạn phải yêu cầu những phạm vi cần có ít quyền truy cập nhất vào dữ liệu người dùng cần thiết để cung cấp chức năng đó. Ví dụ: một ứng dụng chỉ đọc dữ liệu không được yêu cầu quyền đọc, ghi và xoá nội dung khi API và các điểm cuối liên quan có phạm vi hẹp hơn. Bạn chỉ được sử dụng dữ liệu mà bạn nhận được từ API của Google theo cách tuân thủ các chính sách của API này và theo cách mà bạn trình bày cho người dùng trong các thao tác của ứng dụng cũng như trong chính sách quyền riêng tư của bạn.
Hãy nhớ tính đến thời gian cần thiết để hoàn tất quy trình xác minh cho kế hoạch phát hành cho ứng dụng của bạn hoặc bất kỳ tính năng mới nào yêu cầu phạm vi mới. Quy trình xác minh phạm vi nhạy cảm thường mất từ 3 đến 5 ngày làm việc để hoàn tất. Xin lưu ý rằng ứng dụng của bạn có thể đủ điều kiện để hoàn tất quy trình xác minh thương hiệu trong phạm vi yêu cầu xác minh phạm vi nhạy cảm.
Tìm hiểu về phạm vi nhạy cảm
Phạm vi nhạy cảm cần phải được Google xem xét thì mới có thể cấp quyền truy cập cho Tài khoản Google. Quản trị viên tổ chức Google Workspace có thể hạn chế quyền truy cập vào các phạm vi nhạy cảm để ngăn việc truy cập bằng mã ứng dụng OAuth mà tổ chức không đánh dấu rõ ràng là đáng tin cậy.
Tìm hiểu cách bạn sử dụng phạm vi
- Xem lại các phạm vi mà ứng dụng của bạn dùng hoặc bạn muốn dùng. Để tìm mức sử dụng phạm vi hiện tại của bạn, hãy kiểm tra mã nguồn của ứng dụng để xác định mọi phạm vi được gửi cùng với yêu cầu uỷ quyền.
- Xác định rằng mỗi phạm vi được yêu cầu là cần thiết cho hành động dự định của tính năng trong ứng dụng và sử dụng đặc quyền tối thiểu cần thiết để cung cấp tính năng đó. API Google thường có tài liệu tham khảo trên Trang dành cho nhà phát triển của Google cho các điểm cuối của sản phẩm đó, trong đó có phạm vi cần thiết để gọi điểm cuối hoặc các thuộc tính cụ thể trong đó. Để biết thêm thông tin về phạm vi truy cập cần thiết cho các điểm cuối API mà ứng dụng của bạn gọi, hãy đọc tài liệu tham khảo về các điểm cuối đó.
- Bạn chỉ được sử dụng dữ liệu mà bạn nhận được từ API của Google theo cách tuân thủ các chính sách của API này và theo cách mà bạn trình bày cho người dùng trong các thao tác của ứng dụng cũng như trong chính sách quyền riêng tư của bạn.
- Hãy tham khảo tài liệu về API để tìm hiểu thêm về từng phạm vi, bao gồm cả trạng thái sensitive or restricted có thể có của phạm vi đó.
- Khai báo tất cả các phạm vi mà ứng dụng của bạn dùng trên trang phạm vi cấu hình màn hình xin phép bằng OAuth của API Console. Các phạm vi mà bạn chỉ định được nhóm thành các danh mục nhạy cảm hoặc bị hạn chế để làm nổi bật mọi hoạt động xác minh bổ sung cần thiết.
- Tìm phạm vi tốt nhất phù hợp với dữ liệu mà hoạt động tích hợp của bạn sử dụng, tìm hiểu cách sử dụng phạm vi đó, xác nhận lại rằng mọi thứ vẫn hoạt động trong môi trường thử nghiệm, sau đó chuẩn bị gửi đi xác minh.
![Bảng cho thấy tên của một API, một trong các phạm vi nhạy cảm của API đó và nội dung mô tả về những nội dung thuộc phạm vi đó.](https://developers-dot-devsite-v2-prod.appspot.com/static/identity/protocols/oauth2/images/examples/sensitive-scope-example.png?authuser=5&hl=vi)
Các bước chuẩn bị cho quy trình xác minh
Tất cả ứng dụng sử dụng API của Google để yêu cầu quyền truy cập vào dữ liệu đều phải thực hiện các bước sau để hoàn tất quy trình xác minh thương hiệu:
- Xác nhận rằng ứng dụng của bạn không thuộc bất cứ trường hợp sử dụng nào trong phần Ngoại lệ đối với yêu cầu xác minh.
- Đảm bảo ứng dụng tuân thủ các yêu cầu về nhãn hiệu của sản phẩm hoặc API liên quan. Ví dụ: xem nguyên tắc sử dụng thương hiệu cho phạm vi Đăng nhập bằng Google.
- Xác minh quyền sở hữu đối với các miền được uỷ quyền của dự án trong Google Search Console. Hãy sử dụng Tài khoản Google liên kết với dự án API Console của bạn với vai trò là Chủ sở hữu hoặc Người chỉnh sửa.
- Đảm bảo tất cả thông tin thương hiệu trên màn hình xin phép bằng OAuth (chẳng hạn như tên ứng dụng, email hỗ trợ, URI trang chủ, URI chính sách quyền riêng tư, v.v.) thể hiện chính xác danh tính của ứng dụng.
Yêu cầu về trang chủ ứng dụng
Đảm bảo rằng trang chủ của bạn đáp ứng các yêu cầu sau:
- Trang chủ của bạn phải cho phép truy cập công khai, chứ không chỉ dành cho người dùng đã đăng nhập vào trang web.
- Bạn phải thể hiện rõ mức độ liên quan giữa trang chủ với ứng dụng đang được xem xét.
- Các đường liên kết đến trang thông tin của ứng dụng trên Cửa hàng Google Play hoặc trang Facebook của ứng dụng không được coi là trang chủ hợp lệ của ứng dụng.
Yêu cầu đối với đường liên kết đến chính sách quyền riêng tư của ứng dụng
Đảm bảo rằng chính sách quyền riêng tư của ứng dụng đáp ứng các yêu cầu sau:
- Chính sách quyền riêng tư phải hiển thị cho người dùng, được lưu trữ trong cùng một miền với trang chủ của ứng dụng và được liên kết với trên màn hình xin phép bằng OAuth của Google API Console. Xin lưu ý rằng trang chủ phải chứa nội dung mô tả về chức năng của ứng dụng, cũng như các đường liên kết đến chính sách quyền riêng tư và điều khoản dịch vụ không bắt buộc.
- Chính sách quyền riêng tư phải công bố cách thức ứng dụng của bạn truy cập, sử dụng, lưu trữ hoặc chia sẻ dữ liệu người dùng của Google. Bạn chỉ được sử dụng dữ liệu người dùng của Google cho những phương thức mà chính sách quyền riêng tư bạn đã phát hành công bố.
Cách gửi ứng dụng của bạn để xác minh
Google API Console Dự án sắp xếp tất cả tài nguyên API Console của bạn. Một dự án bao gồm một nhóm Tài khoản Google được liên kết có quyền thực hiện hoạt động dự án, một nhóm API đã bật cũng như các chế độ cài đặt thanh toán, xác thực và giám sát cho những API đó. Ví dụ: một dự án có thể chứa một hoặc nhiều ứng dụng OAuth, định cấu hình API để các ứng dụng đó sử dụng và định cấu hình màn hình xin phép bằng OAuth hiển thị với người dùng trước khi họ cho phép truy cập vào ứng dụng của bạn.
Nếu có ứng dụng OAuth chưa sẵn sàng để phát hành chính thức, bạn nên xoá những ứng dụng đó khỏi dự án đang yêu cầu xác minh. Bạn có thể thực hiện việc này trong Google API Console.
Để gửi yêu cầu xác minh, hãy làm theo các bước sau:
- Đảm bảo ứng dụng tuân thủ Điều khoản dịch vụ về các API của Google và Chính sách dữ liệu người dùng của các dịch vụ API của Google.
- Luôn cập nhật vai trò chủ sở hữu và người chỉnh sửa của các tài khoản được liên kết trong dự án, cũng như email hỗ trợ người dùng và thông tin liên hệ của nhà phát triển trên màn hình xin phép bằng OAuth trong API Console. Việc này giúp đảm bảo rằng các thành viên chính xác trong nhóm của bạn sẽ nhận được thông báo về mọi yêu cầu mới.
- Truy cập vào API Console OAuth Consent Screen page.
- Nhấp vào nút Project selector (Bộ chọn dự án).
-
Trong hộp thoại Chọn từ xuất hiện, hãy chọn dự án của bạn. Nếu không tìm thấy dự án nhưng biết mã dự án, bạn có thể tạo URL trong trình duyệt theo định dạng sau:
https://console.developers.google.com/apis/credentials/consent?project=[PROJECT_ID]
Thay thế [PROJECT_ID] bằng mã dự án mà bạn muốn sử dụng.
- Chọn nút Edit App (Chỉnh sửa ứng dụng).
- Nhập thông tin cần thiết trên trang màn hình xin phép bằng OAuth rồi chọn nút Lưu và tiếp tục.
- Dùng nút Thêm hoặc xoá phạm vi để khai báo tất cả phạm vi mà ứng dụng của bạn yêu cầu. Một nhóm phạm vi ban đầu cần thiết cho tính năng Đăng nhập bằng Google sẽ được điền sẵn trong mục Phạm vi không nhạy cảm. Các phạm vi đã thêm được phân loại là không nhạy cảm, sensitive, or restricted.
- Cung cấp tối đa ba đường liên kết đến tài liệu liên quan bất kỳ cho các tính năng liên quan trong ứng dụng.
-
Cung cấp mọi thông tin bổ sung theo yêu cầu về ứng dụng của bạn trong các bước tiếp theo.
- Prepare a detailed justification for each requested sensitive scope, as well as an explanation
for why a narrower scope isn't sufficient. For example: "My app will use
https://www.googleapis.com/auth/calendar
to show a user's Google calendar data on the scheduling screen of my app. This lets users manage their schedules through my app and sync the changes with their Google calendar." -
Prepare a video that fully demonstrates how a user initiates and grants access to the requested scopes and shows, in detail, the usage of the granted sensitive and restricted scopes in the app. Upload the video to YouTube Studio and set its Visibility as Unlisted. You need to provide a link to the demonstration video in the YouTube link field.
- Show the OAuth grant process that users will experience, in English. This includes the consent flow and, if you use Google Sign-In, the sign-in flow.
- Show that the OAuth consent screen correctly displays the App Name.
- Show that the browser address bar of the OAuth consent screen correctly includes your app's OAuth client ID.
- To show how the data will be used, demonstrate the functionality that's enabled by each sensitive scope that you request.
- Prepare a detailed justification for each requested sensitive scope, as well as an explanation
for why a narrower scope isn't sufficient. For example: "My app will use
- Nếu cấu hình ứng dụng bạn cung cấp yêu cầu xác minh, bạn có thể gửi ứng dụng đi xác minh. Điền vào các trường bắt buộc rồi nhấp vào Gửi để bắt đầu quy trình xác minh.
Sau khi bạn gửi ứng dụng, Nhóm phụ trách vấn đề Tin cậy và An toàn của Google sẽ liên hệ qua email để cung cấp thêm thông tin mà họ cần hoặc các bước bạn phải hoàn tất. Kiểm tra địa chỉ email của bạn trong phần Thông tin liên hệ của nhà phát triển và email hỗ trợ trên màn hình xin phép bằng OAuth để xem các yêu cầu cung cấp thêm thông tin. Bạn cũng có thể xem trang màn hình xin phép bằng OAuth của dự án để xác nhận trạng thái xem xét hiện tại cho dự án của mình, bao gồm cả việc liệu quá trình xem xét có bị tạm dừng trong khi chúng tôi chờ bạn phản hồi hay không.
Trường hợp ngoại lệ đối với các yêu cầu về việc xác minh
Nếu ứng dụng của bạn sẽ được dùng trong bất kỳ trường hợp nào được mô tả trong các phần sau, bạn không cần gửi ứng dụng đó đi xem xét.
Sử dụng cá nhân
Một trường hợp sử dụng là khi bạn là người dùng duy nhất của ứng dụng hoặc nếu chỉ có một số ít người dùng sử dụng ứng dụng đó, tất cả đều là những người dùng cá nhân mà bạn biết. Bạn và số lượng người dùng giới hạn của mình có thể thoải mái việc di chuyển qua màn hình ứng dụng chưa được xác minh và cấp quyền truy cập vào ứng dụng cho tài khoản cá nhân của bạn.
Dự án được dùng trong cấp Phát triển, Thử nghiệm hoặc Sắp xếp
Để tuân thủ các chính sách của Google OAuth 2.0, bạn nên có nhiều dự án cho môi trường thử nghiệm và thực tế. Bạn chỉ nên gửi ứng dụng để xác minh nếu muốn cung cấp ứng dụng cho mọi người dùng có Tài khoản Google. Do đó, nếu ứng dụng của bạn đang trong giai đoạn phát triển, kiểm thử hoặc thử nghiệm, thì bạn không cần phải xác minh.
Nếu ứng dụng của bạn đang trong giai đoạn phát triển hoặc thử nghiệm, thì bạn có thể để nguyên Trạng thái xuất bản trong chế độ cài đặt mặc định của Thử nghiệm. Chế độ cài đặt này có nghĩa là ứng dụng của bạn vẫn đang trong quá trình phát triển và chỉ dành cho những người dùng mà bạn đã thêm vào danh sách người dùng thử nghiệm. Bạn phải quản lý danh sách Tài khoản Google liên quan đến quá trình phát triển hoặc thử nghiệm ứng dụng của mình.
![Thông báo cảnh báo rằng Google chưa xác minh ứng dụng đang trong quá trình thử nghiệm.](https://developers-dot-devsite-v2-prod.appspot.com/static/identity/protocols/oauth2/images/examples/tester-warning-screen.png?authuser=5&hl=vi)
Chỉ dữ liệu do dịch vụ sở hữu
Nếu ứng dụng của bạn dùng tài khoản dịch vụ chỉ để truy cập vào dữ liệu của ứng dụng đó và không truy cập vào dữ liệu người dùng (liên kết với Tài khoản Google), thì bạn không cần gửi yêu cầu xác minh.
Để tìm hiểu về tài khoản dịch vụ, hãy xem phần Tài khoản dịch vụ trong tài liệu của Google Cloud. Để biết hướng dẫn về cách sử dụng tài khoản dịch vụ, hãy xem phần Sử dụng OAuth 2.0 cho các ứng dụng từ máy chủ đến máy chủ.
Chỉ sử dụng nội bộ
Điều này có nghĩa là chỉ những người trong tổ chức Google Workspace hoặc Cloud Identity của bạn mới dùng ứng dụng này. Dự án phải do tổ chức sở hữu và cần định cấu hình màn hình xin phép bằng OAuth của dự án cho loại người dùng Nội bộ. Trong trường hợp này, ứng dụng của bạn có thể cần được quản trị viên tổ chức phê duyệt. Để biết thêm thông tin, hãy xem bài viết Những điểm khác cần cân nhắc đối với Google Workspace.
- Tìm hiểu thêm về ứng dụng công khai và nội bộ.
- Tìm hiểu cách đánh dấu ứng dụng là nội bộ trong phần Câu hỏi thường gặp Làm cách nào để đánh dấu ứng dụng của bạn là chỉ dành cho nội bộ?
Cài đặt trên toàn miền
Nếu bạn dự định để ứng dụng chỉ nhắm đến người dùng của một tổ chức Google Workspace hoặc Cloud Identity và luôn sử dụng chế độ cài đặt trên toàn miền, thì ứng dụng của bạn sẽ không cần phải xác minh ứng dụng. Điều này là do việc cài đặt trên toàn miền cho phép quản trị viên miền cấp cho các ứng dụng bên thứ ba và ứng dụng nội bộ quyền truy cập vào dữ liệu của người dùng. Quản trị viên tổ chức là những tài khoản duy nhất có thể thêm ứng dụng vào danh sách cho phép để sử dụng trong miền của họ.
Tìm hiểu cách đặt ứng dụng của bạn thành Cài đặt trên toàn miền trong phần Câu hỏi thường gặp Ứng dụng của tôi có người dùng sử dụng tài khoản doanh nghiệp từ một miền Google Workspace khác.