Các bước để giảm thiểu tác động của các thay đổi về phạm vi đối với người dùng
- Nếu ứng dụng của bạn yêu cầu địa chỉ email của người dùng đã được xác thực và trước đây bạn đã sử dụng
profile.emails.read
cho mục đích đó, hãy sử dụngemail
. - Nhận phê duyệt cho
profile.emails.read
bằng một yêu cầu xác minh đã được phê duyệt. Hãy tham khảo bài viết Làm cách nào để gửi yêu cầu xác minh? - Thu hồi mã thông báo người dùng trước đó đối với phạm vi cần xoá hoặc xoá hoàn toàn quyền truy cập vào ứng dụng. Ví dụ: bạn nên thu hồi mã thông báo có quyền truy cập
profile.emails.read
. Bạn nên áp dụng việc thu hồi quyền truy cập khi người dùng đang sử dụng ứng dụng của bạn để có thể nhận được sự đồng ý của người dùng ngay lập tức. - Yêu cầu người dùng đồng ý lại với phạm vi mới, chẳng hạn như
email
, mà không cầnprofile.emails.read
. - Xoá phạm vi sắp ngừng hoạt động khỏi cấu hình màn hình xin phép bằng OAuth của API của Google.
Những thay đổi mà bạn phải thực hiện để di chuyển trang web từ tính năng Đăng nhập bằng Google+ sang tính năng Đăng nhập bằng Google phụ thuộc vào quy trình Đăng nhập bằng Google+ mà bạn sử dụng. Nhìn chung, quá trình di chuyển yêu cầu bạn cập nhật nút đăng nhập, phạm vi yêu cầu và hướng dẫn về cách truy xuất thông tin hồ sơ từ Google.
Khi bạn cập nhật nút đăng nhập, đừng tham chiếu đến G+ hoặc sử dụng màu đỏ. Tuân thủ nguyên tắc sử dụng thương hiệu mới cập nhật của chúng tôi.
Hầu hết các ứng dụng Đăng nhập bằng Google+ đều yêu cầu một số phạm vi kết hợp: plus.login
, plus.me
và plus.profile.emails.read
. Bạn cần gán lại phạm vi của mình như sau:
Phạm vi cũ | Phạm vi mới |
---|---|
plus.login |
profile |
plus.me |
openid |
plus.profile.emails.read |
email |
Nhiều nhà triển khai tính năng Đăng nhập bằng Google+ đã sử dụng quy trình mã. Điều này có nghĩa là các ứng dụng Android, iOS hoặc JavaScript lấy mã OAuth từ Google, sau đó ứng dụng gửi mã đó trở lại máy chủ, cùng với biện pháp bảo vệ chống giả mạo yêu cầu trên nhiều trang web. Sau đó, máy chủ sẽ xác thực mã và lấy mã thông báo làm mới và truy cập để lấy thông tin hồ sơ người dùng từ API people.get
.
Bây giờ, bạn nên yêu cầu một mã thông báo giá trị nhận dạng và gửi mã thông báo giá trị nhận dạng đó từ ứng dụng đến máy chủ của mình. Mã thông báo nhận dạng có tính năng chống giả mạo trên nhiều trang web tích hợp sẵn và cũng có thể được xác minh tĩnh trên máy chủ của bạn, nhờ đó tránh được lệnh gọi API bổ sung để lấy thông tin hồ sơ người dùng từ máy chủ của Google. Làm theo hướng dẫn để xác thực mã thông báo nhận dạng trên máy chủ.
Nếu vẫn muốn sử dụng luồng mã để lấy thông tin hồ sơ, bạn có thể làm như vậy. Sau khi máy chủ của bạn có mã thông báo truy cập, bạn cần lấy thông tin hồ sơ người dùng từ các điểm cuối userinfo
được chỉ định trong tài liệu Khám phá về tính năng Đăng nhập. Phản hồi API có định dạng khác với phản hồi hồ sơ Google+, vì vậy, bạn cần cập nhật cách phân tích cú pháp thành định dạng mới.
Di chuyển nút đăng nhập HTML
Nếu bạn đã thêm nút Đăng nhập bằng Google+ vào trang bằng cách chỉ định lớp g-signin
cho một phần tử, hãy thực hiện các thay đổi sau:
Khi bạn chỉ định mã ứng dụng, trong thẻ
<meta>
, thuộc tínhdata-
hoặc đối tượng tham số, hãy thay đổi chuỗiclientid
thànhclient_id
, như trong ví dụ sau:<!-- Google+ Sign-in (old) --> <meta name="google-signin-clientid" content="YOUR_CLIENT_ID">
<!-- Google Sign-in (new) --> <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
Chỉ định lớp
g-signin2
cho phần tử nút đăng nhập thay vìg-signin
. Ngoài ra, hãy chỉ định các lệnh gọi lại thành công và không thành công riêng biệt thay vì một lệnh gọi lại duy nhất, như trong ví dụ sau:<!-- Google+ Sign-in (old) --> <div class="g-signin" data-callback="signinCallback"> </div>
<!-- Google Sign-in (new) --> <div class="g-signin2" data-onsuccess="onSignIn" data-onfailure="onSignInFailure"> </div>
Thay vì một trình xử lý gọi lại, hãy xác định trình xử lý thành công và không thành công, như trong ví dụ sau:
// Google+ Sign-in (old) function signinCallback(authResult) { if (authResult['status']['signed_in']) { // Handle successful sign-in } else { // Handle sign-in errors console.log('Sign-in error: ' + authResult['error']); } }
// Google Sign-in (new) function onSignIn(googleUser) { // Handle successful sign-in } function onSignInFailure() { // Handle sign-in errors }
Những thay đổi này sẽ cập nhật phạm vi mặc định của bạn thành
profile email openid
. Bạn có thể lấy thông tin cơ bản trong hồ sơ của người dùng, chẳng hạn như tên, email và URL hình ảnh của ảnh, như sau:// Google Sign-in (new) function onSignIn(googleUser) { let profile = googleUser.getBasicProfile(); let fullName = profile.getName(); let email = profile.getEmail(); let imageUrl = profile.getImageUrl(); }
Di chuyển nút đăng nhập được kết xuất động
Nếu bạn đã đưa nút Đăng nhập bằng Google+ vào trang của mình bằng cách gọi
gapi.signin.render()
, hãy thực hiện các thay đổi sau:
Khi bạn chỉ định mã ứng dụng, trong thẻ
<meta>
, thuộc tínhdata-
hoặc đối tượng tham số, hãy thay đổi chuỗiclientid
thànhclient_id
, như trong ví dụ sau:<!-- Google+ Sign-in (old) --> <meta name="google-signin-clientid" content="YOUR_CLIENT_ID">
<!-- Google Sign-in (new) --> <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
Hiển thị nút đăng nhập bằng
gapi.signin2.render()
thay vìgapi.signin.render()
, như trong ví dụ sau:// Google+ Sign-in (old) gapi.signin.render('myButton', additionalParams);
// Google Sign-in (new) gapi.signin2.render('myButton', additionalParams);
Thay vì một trình xử lý gọi lại, hãy xác định trình xử lý thành công và không thành công, như trong ví dụ sau:
// Google+ Sign-in (old) function signinCallback(authResult) { if (authResult['status']['signed_in']) { // Handle successful sign-in } else { // Handle sign-in errors console.log('Sign-in error: ' + authResult['error']); } }
// Google Sign-in (new) function onSignIn(googleUser) { // Handle successful sign-in } function onSignInFailure() { // Handle sign-in errors }
Những thay đổi này sẽ cập nhật phạm vi mặc định của bạn thành profile email openid
. Bạn có thể lấy thông tin hồ sơ cơ bản của người dùng bằng phương thức getBasicProfile()
.
Di chuyển quy trình đăng nhập bằng JavaScript
Nếu bạn đã bắt đầu quy trình đăng nhập bằng lệnh gọi đến gapi.auth.signIn()
khi người dùng nhấp vào nút đăng nhập, hãy thực hiện các thay đổi sau:
Khi bạn chỉ định mã ứng dụng, trong thẻ
<meta>
, thuộc tínhdata-
hoặc đối tượng thông số, hãy thay đổi chuỗiclientid
thànhclient_id
, như trong ví dụ sau:<!-- Google+ Sign-in (old) --> <meta name="google-signin-clientid" content="YOUR_CLIENT_ID">
<!-- Google Sign-in (new) --> <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
Sử dụng
gapi.auth2.attachClickHandler()
để bắt đầu quy trình đăng nhập khi nhấn vào một nút, như trong ví dụ sau:// Google+ Sign-in (old) var signinButton = document.getElementById('signinButton'); signinButton.addEventListener('click', function() { gapi.auth.signIn(additionalParams); });
// Google Sign-in (new) auth2 = gapi.auth2.init(); auth2.attachClickHandler('signinButton', additionalParams, onSignIn, onSignInFailure);
Thay vì một trình xử lý gọi lại, hãy xác định các trình xử lý thành công và không thành công, như trong ví dụ sau:
// Google+ Sign-in (old) function signinCallback(authResult) { if (authResult['status']['signed_in']) { // Handle successful sign-in } else { // Handle sign-in errors console.log('Sign-in error: ' + authResult['error']); } }
// Google Sign-in (new) function onSignIn(googleUser) { // Handle successful sign-in } function onSignInFailure() { // Handle sign-in errors }
Những thay đổi này sẽ cập nhật phạm vi mặc định của bạn thành profile email openid
. Bạn có thể lấy thông tin hồ sơ cơ bản của người dùng bằng cách gọi phương thức getBasicProfile()
.
Di chuyển luồng phía máy chủ kết hợp
Nếu bạn đã sử dụng API JavaScript để lấy mã uỷ quyền một lần để truyền đến máy chủ, hãy thực hiện các thay đổi sau:
Thay đổi phạm vi từ
https://www.googleapis.com/auth/plus.login
thànhprofile
.Sử dụng phương thức
gapi.auth2.grantOfflineAccess()
với hàm gọi lại hiện có, như trong ví dụ sau:<!-- Google+ Sign-in (old) --> <div class="g-signin" data-scope="https://www.googleapis.com/auth/plus.login" data-clientid="YOUR_CLIENT_ID" data-redirecturi="postmessage" data-accesstype="offline" data-callback="signInCallback"> </div>
// Google Sign-in (new) auth2 = gapi.auth2.init({ client_id: 'YOUR_CLIENT_ID', scope: 'profile' }); ... auth2.grantOfflineAccess().then(signInCallback);
Nếu bạn cũng cần quyền truy cập vào email của người dùng, hãy thêm email
vào tham số phạm vi.