Esta página foi traduzida pela API Cloud Translation.

Integrando o Login do Google em seu aplicativo Android

Para integrar o Google Sign-In em seu aplicativo Android, configure o Google Sign-In e adicione um botão ao layout do seu aplicativo que inicia o fluxo de login.

Antes de você começar

Configurar um projeto Console Google API e configurar seu projeto Android Estúdio .

Configure o Google Sign-in e o objeto GoogleSignInClient

Em seu início de sessão da atividade onCreate método, configure Google Sign-In para solicitar os dados do usuário necessários para a sua aplicação. Por exemplo, para configurar o Google Sign-In para ID de solicitação dos usuários e informações básicas perfil, criar um GoogleSignInOptions objeto com o DEFAULT_SIGN_IN parâmetro. Para endereços de e-mail de solicitação dos usuários, bem como, criar as GoogleSignInOptions objeto com o requestEmail opção.
```
// Configure sign-in to request the user's ID, email address, and basic
// profile. ID and basic profile are included in DEFAULT_SIGN_IN.
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestEmail()
        .build();
```
Se você precisa solicitar âmbitos adicionais para acessar o Google APIs, especificá-los com requestScopes . Para obter a melhor experiência do usuário, ao entrar, solicite apenas os escopos necessários para que seu aplicativo funcione minimamente. Solicite escopos adicionais apenas quando precisar deles, para que seus usuários vejam a tela de consentimento no contexto de uma ação que executaram. Veja Solicitando Scopes adicionais .
Em seguida, também em sua sign-in da atividade onCreate método, crie um GoogleSignInClient objeto com as opções especificadas.
```
// Build a GoogleSignInClient with the options specified by gso.
mGoogleSignInClient = GoogleSignIn.getClient(this, gso);
```

Verifique se há um usuário conectado existente

No da sua actividade onStart método, verificar se um usuário já tiver feito login em seu aplicativo com o Google.

// Check for existing Google Sign In account, if the user is already signed in
// the GoogleSignInAccount will be non-null.
GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
updateUI(account);

Se GoogleSignIn.getLastSignedInAccount retorna um GoogleSignInAccount objeto (em vez de null ), o usuário já tiver feito login em sua aplicação com o Google. Atualize sua IU de acordo, ou seja, oculte o botão de login, inicie sua atividade principal ou o que for apropriado para seu aplicativo.

Se GoogleSignIn.getLastSignedInAccount retorna null , o usuário ainda não tenha feito login em sua aplicação com o Google. Atualize sua IU para exibir o botão de login do Google.

Adicione o botão de login do Google ao seu aplicativo

O botão de login padrão do Google Adicione o SignInButton no layout do seu aplicativo:

<com.google.android.gms.common.SignInButton
 android:id="@+id/sign_in_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content" />

Opcional: Se você estiver usando o login padrão gráfico do botão em vez de fornecer o seu próprio login ativos de botão, você pode personalizar o tamanho do botão com o setSize método.
```
// Set the dimensions of the sign-in button.
SignInButton signInButton = findViewById(R.id.sign_in_button);
signInButton.setSize(SignInButton.SIZE_STANDARD);
```
Na atividade Android (por exemplo, no onCreate método), cadastre-se do seu botão OnClickListener a assinar no usuário quando clicado:
```
findViewById(R.id.sign_in_button).setOnClickListener(this);
```

Inicie o fluxo de login

Na sua atividade onClick método, alça de sessão torneiras botão criando um login intenções com o getSignInIntent método, e começando a intenção com startActivityForResult .
```
@Override
public void onClick(View v) {
    switch (v.getId()) {
        case R.id.sign_in_button:
            signIn();
            break;
        // ...
    }
}
```
```
private void signIn() {
    Intent signInIntent = mGoogleSignInClient.getSignInIntent();
    startActivityForResult(signInIntent, RC_SIGN_IN);
}
```
Iniciar o intent solicita que o usuário selecione uma conta do Google para fazer login. Se você solicitou escopos além do profile , email , e openid , o usuário também é solicitado a conceder acesso aos recursos solicitados.

Após o usuário se, você pode obter um GoogleSignInAccount objeto para o usuário na sua atividade onActivityResult método.

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // Result returned from launching the Intent from GoogleSignInClient.getSignInIntent(...);
    if (requestCode == RC_SIGN_IN) {
        // The Task returned from this call is always completed, no need to attach
        // a listener.
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        handleSignInResult(task);
    }
}

O GoogleSignInAccount objeto contém informações sobre o usuário conectado, tal como o nome do usuário.

private void handleSignInResult(Task<GoogleSignInAccount> completedTask) {
    try {
        GoogleSignInAccount account = completedTask.getResult(ApiException.class);

        // Signed in successfully, show authenticated UI.
        updateUI(account);
    } catch (ApiException e) {
        // The ApiException status code indicates the detailed failure reason.
        // Please refer to the GoogleSignInStatusCodes class reference for more information.
        Log.w(TAG, "signInResult:failed code=" + e.getStatusCode());
        updateUI(null);
    }
}

Você também pode obter o endereço de e-mail do usuário com getEmail , do usuário do Google ID (para uso do lado do cliente) com getId , e um ID token para o usuário com getIdToken . Se você precisa passar o momento usuário conectado a um servidor back-end, enviar o ID token para o servidor back-end e validar o token no servidor.