ee.data.authenticateViaOauth

Configura a autenticação do lado do cliente de chamadas de API do EE usando a biblioteca de cliente das APIs do Google para JavaScript. A biblioteca será carregada automaticamente se ainda não estiver na página. O usuário vai precisar conceder à aplicação identificada por clientId acesso aos dados de EE, caso ainda não tenha feito isso.

Esse ou outro método de autenticação precisa ser chamado antes de ee.initialize().

Se o usuário não tiver concedido acesso ao aplicativo identificado pelo ID do cliente, por padrão, uma caixa de diálogo vai aparecer pedindo que ele conceda a permissão necessária. No entanto, esse pop-up pode ser bloqueado pelo navegador. Para evitar isso, especifique o callback opt_onImmediateFailed e renderize um botão de login na página. Em seguida, chame ee.data.authenticateViaPopup() do manipulador de eventos de clique desse botão. Isso impede que o navegador bloqueie o pop-up, já que ele agora é o resultado direto de uma ação do usuário.

O token de autenticação será atualizado automaticamente quando possível. Você pode presumir com segurança que todas as chamadas assíncronas serão enviadas com as credenciais adequadas. No entanto, para chamadas síncronas, verifique se há um token de autenticação com ee.data.getAuthToken() e chame ee.data.refreshAuthToken() manualmente se não houver nenhum. A operação de atualização do token é assíncrona e não pode ser realizada nos bastidores sob demanda antes das chamadas síncronas.

UsoRetorna
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes)
ArgumentoTipoDetalhes
clientIdStringO ID do cliente OAuth do aplicativo ou nulo para desativar as chamadas autenticadas. Isso pode ser obtido no Google Developers Console. O projeto precisa ter uma origem JavaScript que corresponda ao domínio em que o script está sendo executado.
successFunçãoA função a ser chamada se a autenticação for bem-sucedida.
errorFunção, opcionalA função a ser chamada se a autenticação falhar, transmitindo a mensagem de erro. Se a autenticação no modo imediato (nos bastidores) falhar e opt_onImmediateFailed for especificado, essa função será chamada em vez de opt_error.
extraScopesList<String>, opcionalEscopos OAuth extras a serem solicitados.
onImmediateFailedFunção, opcionalA função a ser chamada se a autenticação automática em segundo plano falhar. O padrão é ee.data.authenticateViaPopup(), vinculado aos callbacks transmitidos.
suppressDefaultScopesBooleano, opcionalQuando verdadeiro, apenas os escopos especificados em opt_extraScopes são solicitados. Os escopos padrão não são solicitados, a menos que sejam especificados explicitamente em opt_extraScopes.