Migrar do login do Google+

Etapas para minimizar o impacto das mudanças de escopo nos usuários

1. Se o aplicativo exigir o endereço de e-mail de um usuário autenticado e você já tiver usado profile.emails.read para essa finalidade, use email.
2. Receber aprovação para profile.emails.read com uma solicitação de verificação aprovada. Consulte Como enviar para verificação?
3. Revogue o token do usuário anterior para o escopo que será removido ou remova completamente o acesso ao aplicativo. Por exemplo, um token com acesso a profile.emails.read precisa ser revogado. Recomendamos que você aplique a revogação enquanto seus usuários estiverem no aplicativo para receber o consentimento deles imediatamente.
4. Solicite que os usuários concordem novamente com o novo escopo, como email, sem profile.emails.read.
5. Remova o escopo que será desativado na configuração da tela de permissão OAuth das APIs do Google.

.

As alterações que você precisa fazer para migrar seu site do Login do Google+ para o Google O login depende do fluxo de Login do Google+ que você usa. Em geral, a migração exige que você atualize o botão de login, os escopos solicitados e as instruções sobre como recuperar informações de perfil do Google.

Ao atualizar o botão de login, não se refira ao G+ nem use a cor vermelha. Conformidade com nossa diretrizes da promoção de marca.

A maioria dos aplicativos de Login do Google+ solicitava uma combinação dos escopos: plus.login, plus.me e plus.profile.emails.read. Você precisa remapear os escopos da seguinte forma:

Escopo antigo	Novo escopo
plus.login	profile
plus.me	openid
plus.profile.emails.read	email

Muitos implementadores do Login do Google+ usaram a fluxo de código (link em inglês). Isso significa que que os apps Android, iOS ou JavaScript recebam um código OAuth do Google, e o cliente envia o código de volta para o servidor, junto com a solicitação entre sites proteção contra pirataria. O servidor, então, valida o código e obtém atualização e tokens de acesso para extrair informações de perfil de usuário da API people.get.

Agora, o Google recomenda que você solicite um token de ID e o envie pelo seu cliente para seu servidor. Os tokens de ID têm proteções contra falsificação entre sites integrada e pode ser verificada estaticamente em seu servidor, o que evita uma chamada de API extra para obter informações de perfil de usuário dos servidores do Google. Siga o instruções para validar tokens de ID no seu servidor.

Se você ainda preferir usar o fluxo de código para obter informações de perfil, faça isso. Depois que o servidor tiver um token de acesso, será preciso receber informações do perfil do usuário dos endpoints userinfo especificados em nosso sistema Documento de descoberta: A API a resposta é formatada de modo diferente da resposta do perfil do Google+, portanto você precisar atualizar a análise para o novo formato.

Migrar um botão de login HTML

Se você incluiu um botão de Login do Google+ em sua página por tarefa da turma g-signin a um elemento, faça as seguintes alterações:

• Quando você especifica seu ID do cliente, seja em uma tag <meta>, um data- atributo ou um objeto de parâmetros, mude a string clientid para client_id, como no exemplo abaixo:

  <!-- 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">
  

• Atribua a classe g-signin2 ao elemento do botão de login em vez de g-signin. Além disso, especifique callbacks de sucesso e falha separados, em vez de um único callback, como no exemplo a seguir:

  <!-- 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>
  

• Em vez de um único gerenciador de callback, defina gerenciadores de sucesso e falha. como no exemplo a seguir:

  // 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
  }
  

• Essas mudanças atualizam os escopos padrão para profile email openid. Você pode acessar as informações básicas do perfil do usuário, como nome, e-mail e foto de imagem da Web, da seguinte maneira:

  // Google Sign-in (new)
  function onSignIn(googleUser) {
    let profile = googleUser.getBasicProfile();
    let fullName = profile.getName();
    let email = profile.getEmail();
    let imageUrl = profile.getImageUrl();
  }
  

Migrar um botão de login renderizado dinamicamente

Se você incluiu um botão de Login do Google+ em sua página chamando gapi.signin.render(), faça as seguintes alterações:

• Quando você especifica seu ID do cliente, seja em uma tag <meta>, um data- atributo ou um objeto de parâmetros, mude a string clientid para client_id, como no exemplo abaixo:

  <!-- 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">
  

• Renderize o botão de login com gapi.signin2.render() em vez de gapi.signin.render(), como no exemplo abaixo:

  // Google+ Sign-in (old)
  gapi.signin.render('myButton', additionalParams);
  

  // Google Sign-in (new)
  gapi.signin2.render('myButton', additionalParams);
  

• Em vez de um único gerenciador de callback, defina gerenciadores de sucesso e falha. como no exemplo a seguir:

  // 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
  }
  

Essas mudanças atualizam os escopos padrão para profile email openid. Você pode Consiga as informações básicas de perfil do usuário com o método getBasicProfile().

Migrar um fluxo de login iniciado por JavaScript

Se você iniciou o fluxo de login com uma chamada para gapi.auth.signIn() quando os usuários clicar no botão de login, faça as seguintes alterações:

• Quando você especifica seu ID do cliente, seja em uma tag <meta>, um data- atributo ou um objeto de parâmetros, mude a string clientid para client_id, como no exemplo abaixo:

  <!-- 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">
  

• Use gapi.auth2.attachClickHandler() para iniciar o fluxo de login quando um botão for pressionada, como no exemplo a seguir:

  // 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);
  

• Em vez de um único gerenciador de callback, defina gerenciadores de sucesso e falha. como no exemplo a seguir:

  // 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
  }
  

Essas mudanças atualizam os escopos padrão para profile email openid. Você pode Consiga as informações básicas do perfil do usuário chamando o método getBasicProfile() .

Migrar um fluxo híbrido do lado do servidor

Se você usou a API JavaScript para receber um código de autorização único para transmitir ao servidor, faça as seguintes alterações:

• Altere o escopo de https://www.googleapis.com/auth/plus.login para profile.

• Usar o método gapi.auth2.grantOfflineAccess() com o callback já existente como no exemplo a seguir:

  <!-- 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);
  

Se você também precisar de acesso ao e-mail do usuário, adicione email ao parâmetro de escopo.