Google ile Oturum Açma JavaScript istemci referansı

Bu referansta, web uygulamalarınızda Google ile Oturum Açma'yı uygulamak için kullanacağınız JavaScript istemci yöntemleri ve özellikleri açıklanmaktadır.

Kitaplığı kullanırken herhangi bir sorunla karşılaşırsanız GitHub depomuza bildirin.

Kimlik Doğrulama Kurulumu

gapi nesnesini oluşturmak için Google API'leri platform kitaplığını yükleyin:

<script src="https://apis.google.com/js/platform.js?onload=init" async defer></script>

Platform kitaplığı yüklendikten sonra auth2 kitaplığını yükleyin:

function init() {
  gapi.load('auth2', function() {
    /* Ready. Make a call to gapi.auth2.init or some other API */
  });
}

gapi.auth2.init(params)

GoogleAuth nesnesini başlatır. gapi.auth2.GoogleAuth yöntemlerini çağırmadan önce bu yöntemi çağırmanız gerekir.

GoogleAuth nesnesini ilk kullanıma hazırlarken, nesneyi OAuth 2.0 istemci kimliğinizle ve belirtmek istediğiniz diğer seçeneklerle yapılandırırsınız. Ardından, kullanıcı zaten oturum açmışsa GoogleAuth nesnesi, kullanıcının önceki oturumdaki oturum açma durumunu geri yükler.

{
  client_id: 'CLIENT_ID.apps.googleusercontent.com'
}

GoogleAuth.then(onInit, onError)

GoogleAuth nesnesi tam olarak başlatıldığında onInit işlevini çağırır. Başlatma sırasında bir hata oluşursa (bu durum, desteklenmeyen eski tarayıcılarda yaşanabilir) bunun yerine onError işlevi çağrılır.

Hata Kodları

idpiframe_initialization_failed

Örneğin, desteklenmeyen bir ortam nedeniyle, gerekli bir iframe Google'dan başlatılamadı. details özelliği, oluşturulan hata hakkında daha fazla bilgi sağlar.

gapi.auth2.ClientConfig

gapi.auth2.init yöntemi için farklı yapılandırma parametrelerini temsil eden arayüz.

Kimlik doğrulama

GoogleAuth, kullanıcının bir Google hesabıyla oturum açmasına, kullanıcının mevcut oturum açma durumunu öğrenmesine, Google profilinden belirli verileri almasına, ek kapsamlar istemesine ve mevcut hesabın oturumunu kapatmasına olanak tanıyan yöntemler sunan bir tekil sınıftır.

gapi.auth2.getAuthInstance()

GoogleAuth nesnesini döndürür. Bu yöntemi çağırmadan önce GoogleAuth nesnesini gapi.auth2.init() ile başlatmalısınız.

GoogleAuth.isSignedIn.get()

Geçerli kullanıcının oturum açmış olup olmadığını döndürür.

GoogleAuth.isSignedIn.listen(listener)

Geçerli kullanıcının oturum açma durumundaki değişiklikleri bekleyin.

GoogleAuth.signIn()

gapi.auth2.init() için belirtilen seçeneklerle kullanıcının oturumunu açar.

Hata kodları

Şu sayfaya göz atın: GoogleAuth.signIn(options).

GoogleAuth.signIn(options)

Belirtilen seçenekleri kullanarak kullanıcının oturumunu açar.

Hata kodları

popup_closed_by_user

Kullanıcı, oturum açma akışını tamamlamadan pop-up'ı kapattı.

access_denied

Kullanıcı, gerekli kapsamlara yönelik izni reddetti.

immediate_failed

İzin akışı istenmeden hiçbir kullanıcı otomatik olarak seçilemedi. prompt: 'none' seçeneğiyle signIn kullanılırken hata oluştu. Önceki bir oturumda daha önce oturum açılmışsa gapi.auth2.init, kullanıcının oturumunu otomatik olarak açacağından bu seçeneğin kullanılması gerekmez.

gapi.auth2.SignInOptions

GoogleAuth.signIn(options) yöntemi için farklı yapılandırma parametrelerini temsil eden arayüz.

GoogleAuth.signOut()

Geçerli hesabın uygulamadaki oturumunu kapatır.

GoogleAuth.disconnect()

Kullanıcının verdiği tüm kapsamları iptal eder.

GoogleAuth.grant offlineAccess(options)

Belirtilen kapsamlara çevrimdışı olarak erişmek için kullanıcıdan izin alın.

{
  scope: 'profile email'
}

auth2.grantOfflineAccess().then(function(resp) {
  var auth_code = resp.code;
});

Hata kodları

popup_closed_by_user

Kullanıcı, izin akışını tamamlamadan pop-up'ı kapattı.

access_denied

Kullanıcı, gerekli kapsamlara yönelik izni reddetti.

immediate_failed

İzin akışı istenmeden hiçbir kullanıcı otomatik olarak seçilemedi. prompt: 'none' seçeneğiyle signIn kullanılırken hata oluştu. gapi.auth2.init, önceki bir oturum sırasında daha önce oturum açmışsa kullanıcının oturumunu otomatik olarak açacağından bu seçeneğin kullanılması zorunlu değildir.

gapi.auth2.OfflineAccessOptions

GoogleAuth.grantOfflineAccess(options) yöntemi için farklı yapılandırma parametrelerini temsil eden arayüz.

GoogleAuth.attachClickHandler(container, options, onsuccess, onfailure)

Oturum açma akışını, belirtilen kapsayıcının tıklama işleyicisine ekler.

Kullanıcılar

GoogleUser nesnesi bir kullanıcı hesabını temsil eder. GoogleUser nesneleri genellikle GoogleAuth.currentUser.get() çağrısı yapılarak elde edilir.

GoogleAuth.currentUser.get()

Geçerli kullanıcıyı temsil eden bir GoogleUser nesnesi döndürür. Yeni başlatılan bir GoogleAuth örneğinde geçerli kullanıcının ayarlanmamış olduğunu unutmayın. Başlatılmış bir GoogleAuth örneği almak için currentUser.listen() yöntemini veya GoogleAuth.then() yöntemini kullanın.

GoogleAuth.currentUser.listen(listener)

currentUser'daki değişiklikleri takip et.

GoogleUser.getId()

Kullanıcının benzersiz kimlik dizesini alın.

GoogleUser.isSignedIn()

Kullanıcı oturum açmışsa true değerini döndürür.

GoogleUser.getHostedDomain()

Kullanıcı bir G Suite hesabıyla oturum açtıysa kullanıcının G Suite alanını alın.

GoogleUser.getGrantedScopes()

Kullanıcının boşlukla ayrılmış bir dize olarak verdiği kapsamları alın.

GoogleUser.getBasicProfile()

Kullanıcının temel profil bilgilerini alır.

GoogleUser.getAuthResponse(includeAuthorizationData)

Kullanıcının kimlik doğrulama oturumundan yanıt nesnesini alın.

GoogleUser.reloadAuthResponse()

Erişim jetonunun yenilenmesini zorlar ve ardından yeni AuthResponse için bir Promise döndürür.

gapi.auth2.AuthResponse

GoogleUser.getAuthResponse(includeAuthorizationData) veya GoogleUser.reloadAuthResponse() yöntemleri çağrıldığında döndürülen yanıt.

GoogleUser.hasGrantedScopes(scopes)

Kullanıcı belirtilen kapsamları verdiyse true değerini döndürür.

GoogleUser.grant(options)

Kullanıcıya ek kapsamlar isteyin.

Parametre listesi ve hata kodu için GoogleAuth.signIn() adresini ziyaret edin.

GoogleUser.grant offlineAccess(options)

Belirtilen kapsamlara çevrimdışı olarak erişmek için kullanıcıdan izin alın.

{
  scope: 'profile email'
}

GoogleUser.disconnect()

Kullanıcının uygulama için verdiği tüm kapsamları iptal eder.

kullanıcı arayüzü öğeleri

gapi.signin2.render(id, options)

options nesnesi tarafından belirtilen ayarları kullanarak, belirtilen kimliğe sahip öğede bir oturum açma düğmesi oluşturur.

{
  scope: 'email',
  width: 200,
  height: 50,
  longtitle: true,
  theme: 'dark',
  onsuccess: handleSuccess,
  onfailure: handleFailure
}

Gelişmiş

gapi.auth2.authorized(params callback)

Tek seferlik OAuth 2.0 yetkilendirmesi gerçekleştirir. Bu işlem, kullanılan parametrelere bağlı olarak Google ile oturum açma akışına dair bir pop-up açar veya istenen yanıtı kullanıcı etkileşimi olmadan sessiz bir şekilde yüklemeye çalışır.

Bu yöntemin yararlı olduğu bazı kullanım alanları şunlardır:

• Uygulamanızın yalnızca bir Google API uç noktası istemesi gerekir. Örneğin, kullanıcının ilk kez oturum açtığında favori YouTube videolarını yüklemek için.
• Uygulamanız kendi oturum yönetimi altyapısına sahiptir ve arka ucunuzda kullanıcıyı tanımlamak için Kimlik Jetonu'nu yalnızca bir kez gerektirir.
• Aynı sayfa içinde çeşitli Client-ID'ler kullanılıyor.

{
  client_id: 'CLIENT_ID.apps.googleusercontent.com',
  scope: 'email profile openid',
  response_type: 'id_token permission'
}

Örnek

gapi.auth2.authorize({
  client_id: 'CLIENT_ID.apps.googleusercontent.com',
  scope: 'email profile openid',
  response_type: 'id_token permission'
}, function(response) {
  if (response.error) {
    // An error happened!
    return;
  }
  // The user authorized the application for the scopes requested.
  var accessToken = response.access_token;
  var idToken = response.id_token;
  // You can also now use gapi.client to perform authenticated requests.
});

Hata kodları

idpiframe_initialization_failed

Örneğin, desteklenmeyen bir ortam nedeniyle, gerekli bir iframe Google'dan başlatılamadı. details özelliği, oluşturulan hata hakkında daha fazla bilgi sağlar.

popup_closed_by_user

Kullanıcı, oturum açma akışını tamamlamadan pop-up'ı kapattı.

access_denied

Kullanıcı, gerekli kapsamlara yönelik izni reddetti.

immediate_failed

İzin akışı istenmeden hiçbir kullanıcı otomatik olarak seçilemedi. prompt: 'none' seçeneğiyle signIn kullanılırken hata oluştu.

gapi.auth2.AuthorizeConfig

gapi.auth2.authorize yöntemi için farklı yapılandırma parametrelerini temsil eden arayüz.

gapi.auth2.AuthorizeResponse

Yanıt, gapi.auth2.authorize yönteminin geri çağırmasına döndürüldü.