Google ile Oturum Açma JavaScript istemci referansı

Bu referans, web uygulamalarınızda Google ile oturum açma özelliğini uygulamak için kullanacağınız JavaScript istemci yöntemlerini ve özelliklerini açıklar.

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

Auth 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'nın yöntemlerini çağırmadan önce bu yöntemi çağırmanız gerekir.

GoogleAuth nesnesini başlattığınızda nesneyi OAuth 2.0 istemci kimliğinizle ve belirtmek istediğiniz ek seçeneklerle yapılandırırsınız. Ardından, kullanıcı daha önce oturum açtıysa GoogleAuth nesnesi, kullanıcının önceki oturumdaki oturum açma durumunu geri yükler.

Bağımsız değişkenler
params İstemci yapılandırma verilerinin anahtar/değer çiftlerini içeren bir nesne. Yapılandırılabilir farklı özellikler için gapi.auth2.ClientConfig bölümüne bakın. Örneğin: 
{
  client_id: 'CLIENT_ID.apps.googleusercontent.com'
}
İadeler
gapi.auth2.GoogleAuth gapi.auth2.GoogleAuth nesnesi. gapi.auth2.GoogleAuth nesnesi başlatılmayı tamamladığında çözüme ulaştırılabilen bir Promise almak için then() yöntemini kullanın.

GoogleAuth.then(onInit, onError)

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

Bağımsız değişkenler
onInit GoogleAuth nesnesi tamamen başlatıldığında bu nesneyle çağrılan işlev.
onError GoogleAuth özelliğinin başlatılamaması durumunda error özelliği içeren bir nesneyle çağrılan işlev.
İadeler
Promise onInit işlevi tamamlandığında karşılanan veya bir başlatma hatası oluştuysa reddedilen bir Promise. Varsa onInit işlevinden döndürülen değerle çözümlenir.

Hata Kodları

idpiframe_initialization_failed
Örneğin, desteklenmeyen bir ortam nedeniyle Google'dan gerekli bir iFrame başlatılamadı. details mülkü, oluşturulan hata hakkında daha fazla bilgi verir.

gapi.auth2.ClientConfig

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

Parametreler
client_id string Zorunludur. Google API Konsolu'nda bulunan ve oluşturulan uygulamanın istemci kimliği.
cookie_policy string Oturum açma çerezlerinin oluşturulacağı alanlar. URI, single_host_origin veya none. Belirtilmezse varsayılan olarak single_host_origin olur.
scope string İstenecek alanlar, boşlukla ayrılmış bir dize olarak. fetch_basic_profile yanlış değerine ayarlanmamışsa isteğe bağlıdır.
fetch_basic_profile boolean Kullanıcılar oturum açtığında temel profil bilgilerini alma İstenen kapsamlara "profile", "email" ve "openid" eklenir. Belirtilmemişse doğru değerini döndürür.
hosted_domain string Kullanıcıların oturum açmak için ait olması gereken G Suite alanı. Bu değer, istemciler tarafından değiştirilebileceğinden döndürülen kullanıcının barındırılan alan mülkünü doğruladığınızdan emin olun. İstemcide GoogleUser.getHostedDomain() işlevini ve sunucudaki kimlik jetonunda hd iddiasını kullanarak alanın beklediğiniz alan olduğunu doğrulayın.
use_fedcm boolean İsteğe bağlıdır, varsayılan olarak True değerine ayarlanır. Oturum açma sırasında tarayıcı FedCM API'lerinin kullanımını etkinleştirin veya devre dışı bırakın.
ux_mode string Oturum açma akışı için kullanılacak kullanıcı deneyimi modu. Varsayılan olarak izin akışı bir pop-up pencerede açılır. Geçerli değerler popup ve redirect'dir.
redirect_uri string ux_mode='redirect' kullanılıyorsa bu parametre, kullanıcı rızası akışı sonunda kullanılacak varsayılan redirect_uri değerini geçersiz kılmanıza olanak tanır. Varsayılan redirect_uri, sorgu parametrelerinin ve karma oluşturma parçasının kaldırıldığı mevcut URL'dir.
enable_granular_consent boolean İsteğe bağlı. Ayrıntılı izinleri etkinleştirme false olarak ayarlanırsa 2019'dan önce oluşturulan OAuth istemci kimlikleri için daha ayrıntılı Google Hesabı izinleri devre dışı bırakılır. 2019'da veya sonrasında oluşturulan OAuth istemci kimlikleri için geçerli değildir. Bu kimlikler için daha ayrıntılı izinler her zaman etkindir.
plugin_name string İsteğe bağlı. Yalnızca 3 Mart 2025'ten önce oluşturulan istemci kimlikleri için geçerlidir. Aksi takdirde herhangi bir etkisi yoktur. Mevcut web uygulamalarının Google Platform Kitaplığı'nı kullanmaya devam etmesini sağlar. Varsayılan olarak, yeni oluşturulan istemci kimliklerinin Platform Kitaplığı'nı kullanması engellenir ve bunun yerine daha yeni Google Kimlik Hizmetleri kitaplığını kullanması gerekir.

İstediğiniz değeri seçebilirsiniz. Kimlik tanımlama için ürün veya eklenti adı gibi açıklayıcı bir ad kullanılması önerilir. Örneğin: plugin_name: 'YOUR_STRING_HERE'

Kimlik doğrulama

GoogleAuth, kullanıcının Google Hesabı ile oturum açmasına, kullanıcının mevcut oturum açma durumunu almasına, kullanıcının Google profilinden belirli verileri almasına, ek kapsamlar istemesine ve mevcut hesaptan çıkış yapmasına olanak tanıyan yöntemler sağlayan tekil bir 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şlatmanız gerekir.

İadeler
gapi.auth2.GoogleAuth gapi.auth2.GoogleAuth nesnesi. gapi.auth2.GoogleAuth'nin yöntemlerini çağırmak için bu nesneyi kullanın.

GoogleAuth.isSignedIn.get()

Geçerli kullanıcının oturum açıp açmadığını döndürür.

İadeler
Boole Kullanıcı oturum açtıysa true, oturumu kapalıysa veya GoogleAuth nesnesi başlatılmadıysa false değerini döndürür.

GoogleAuth.isSignedIn.listen(listener)

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

Bağımsız değişkenler
listener Boole değeri alan bir işlev. listen(), kullanıcı oturum açtığında true değerini, kullanıcı oturumu kapattığında ise false değerini bu işleve iletir.

GoogleAuth.signIn()

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

İadeler
Promise Kullanıcı kimliğini başarıyla doğrulayıp istenen kapsamları verdiğinde GoogleUser örneğiyle karşılanan veya bir hata oluştuğunda error mülkü içeren bir nesneyle reddedilen bir Promise. Hata kodları için sonraki bölüme bakın.

Hata kodları

GoogleAuth.signIn(options) adresine göz atın.

GoogleAuth.signIn(options)

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

Bağımsız değişkenler
options Şu yöntemlerden birini kullanın:
  • Oturum açma parametrelerinin anahtar/değer çiftlerini içeren bir gapi.auth2.SignInOptions nesnesi. Örneğin: 
    {
  scope: 'profile email'
}
  • gapi.auth2.SigninOptionsBuilder örneği. Örneğin:
    options = new gapi.auth2.SigninOptionsBuilder();
options.setAppPackageName('com.example.app');
options.setFetchBasicProfile(True);
options.setPrompt('select_account');
options.setScope('profile').setScope('email');
İadeler
Promise Kullanıcı kimliğini başarıyla doğrulayıp istenen kapsamları verdiğinde GoogleUser örneğiyle karşılanan veya bir hata oluştuğunda error mülkü içeren bir nesneyle reddedilen bir Promise (Hata kodları için aşağıya bakın).

Hata kodları

popup_closed_by_user
Kullanıcı, oturum açma akışını tamamlamadan pop-up'ı kapattı.
access_denied
Kullanıcı, gerekli kapsamlar için izni reddetti.
immediate_failed
Rıza akışı istem olmadan hiçbir kullanıcı otomatik olarak seçilememiştir. prompt: 'none' seçeneğiyle signIn kullanılırken hata oluştu. gapi.auth2.init, daha önce oturum açılmış bir oturumda oturum açtığı takdirde 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.

Parametreler
prompt string İzin akışı için belirli bir modu zorlar. İsteğe bağlı.
Olası değerler:
  • consent
    Yetkilendirme sunucusu, uygulamaya bilgi döndürmeden önce kullanıcıdan izin ister.
  • select_account
    Yetkilendirme sunucusu, kullanıcıdan bir Google Hesabı seçmesini ister. Bu sayede, birden fazla hesabı olan kullanıcılar, oturumları açık olabilecek birden fazla hesap arasından seçim yapabilir.
  • none (önerilmez)
    Yetkilendirme sunucusu herhangi bir kimlik doğrulama veya kullanıcı izni ekranı göstermez. Kullanıcının kimliği doğrulanmamışsa ve daha önce istenen kapsamlara izin vermemişse hata döndürür.
    gapi.auth2.init, daha önce oturum açmış bir kullanıcının uygulamada oturumunu otomatik olarak açacağından signIn({prompt: 'none'}) çağrısı genellikle başarısız olur.
scope string gapi.auth2.init parametrelerinde tanımlanan kapsamların yanı sıra, boşlukla ayrılmış bir dize olarak istenen kapsamlar. fetch_basic_profile yanlış değerine ayarlanmamışsa isteğe bağlıdır.
ux_mode string Oturum açma akışı için kullanılacak kullanıcı deneyimi modu. Varsayılan olarak izin akışı bir pop-up pencerede açılır. Geçerli değerler popup ve redirect'dir.
redirect_uri string ux_mode='redirect' kullanılıyorsa bu parametre, kullanıcı rızası akışının sonunda kullanılacak varsayılan redirect_uri değerini geçersiz kılmanıza olanak tanır. Varsayılan redirect_uri, sorgu parametrelerinin ve karma oluşturma parçasının kaldırıldığı mevcut URL'dir.

GoogleAuth.signOut()

Mevcut hesabın uygulamadaki oturumunu kapatır.

İadeler
Promise Kullanıcının oturumu kapatıldığında karşılanan bir Promise.

GoogleAuth.disconnect()

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

GoogleAuth.grantOfflineAccess(options)

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

Bağımsız değişkenler
options Parametrelerin anahtar/değer çiftlerini içeren bir gapi.auth2.OfflineAccessOptions nesnesi. Örneğin: 
{
  scope: 'profile email'
}
İadeler
Promise Kullanıcı istenen kapsamları verdiğinde, yetkilendirme kodunu Promise'nin istek karşılama işleyicisine ileterek yerine getirilen bir Promise. Örneğin: 
auth2.grantOfflineAccess().then(function(resp) {
  var auth_code = resp.code;
});

Hata kodları

popup_closed_by_user
Kullanıcı, izin akışı tamamlanmadan pop-up'ı kapattı.
access_denied
Kullanıcı, gerekli kapsamlar için izni reddetti.
immediate_failed
Rıza akışı istem olmadan hiçbir kullanıcı otomatik olarak seçilememiştir. prompt: 'none' seçeneğiyle signIn kullanılırken hata oluştu. gapi.auth2.init, önceki bir oturumda oturum açılmışsa kullanıcının oturumunu otomatik olarak açacağından bu seçeneğin kullanılması gerekmez.

gapi.auth2.OfflineAccessOptions

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

Parametreler
prompt string İzin akışı için belirli bir modu zorlar. İsteğe bağlı.
Olası değerler:
  • consent
    Yetkilendirme sunucusu, uygulamaya bilgi döndürmeden önce kullanıcıdan izin ister.
  • select_account
    Yetkilendirme sunucusu, kullanıcıdan bir Google Hesabı seçmesini ister. Bu sayede, birden fazla hesabı olan kullanıcılar, oturumları açık olabilecek birden fazla hesap arasından seçim yapabilir.
scope string gapi.auth2.init parametrelerinde tanımlanan kapsamların yanı sıra, boşlukla ayrılmış bir dize olarak istenen kapsamlar. fetch_basic_profile yanlış değerine ayarlanmamışsa isteğe bağlıdır.

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

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

Bağımsız değişkenler
container Tıklama işleyicisinin ekleneceği div öğesinin kimliği veya bu öğeye referans.
options Anahtar/değer çiftleri içeren bir nesne. GoogleAuth.signIn() işlevine bakın.
onsuccess Oturum açıldıktan sonra çağrılacak işlev.
onfailure Oturum açma işlemi başarısız olursa çağrılacak işlev.

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ılmış bir GoogleAuth örneğinde geçerli kullanıcının ayarlanmadığını unutmayın. İlkleştirilmiş bir GoogleAuth örneği almak için currentUser.listen() yöntemini veya GoogleAuth.then() yöntemini kullanın.

İadeler
GoogleUser Geçerli kullanıcı

GoogleAuth.currentUser.listen(listener)

currentUser değişkenindeki değişiklikleri dinleme.

Bağımsız değişkenler
listener GoogleUser parametresi alan bir işlev. listen, currentUser'yi değiştiren her değişiklikte bu işleve bir GoogleUser örneği iletmektedir.

GoogleUser.getId()

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

İadeler
Dize Kullanıcının benzersiz kimliği

GoogleUser.isSignedIn()

Kullanıcı oturum açtıysa true döndürür.

İadeler
Boole Kullanıcı oturum açtıysa doğru değerini döndürür.

GoogleUser.getHostedDomain()

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

İadeler
Dize Kullanıcının G Suite alanı

GoogleUser.getGrantedScopes()

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

İadeler
Dize Kullanıcı tarafından izin verilen kapsamlar

GoogleUser.getBasicProfile()

Kullanıcının temel profil bilgilerini alma.

İadeler
gapi.auth2.BasicProfile gapi.auth2.BasicProfile özelliğinin özelliklerini aşağıdaki yöntemlerle alabilirsiniz:
  • BasicProfile.getId()
  • BasicProfile.getName()
  • BasicProfile.getGivenName()
  • BasicProfile.getFamilyName()
  • BasicProfile.getImageUrl()
  • BasicProfile.getEmail()

GoogleUser.getAuthResponse(includeAuthorizationData)

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

Bağımsız değişkenler
includeAuthorizationData İsteğe bağlı: Her zaman bir erişim jetonu ve kapsam döndürülüp döndürülmeyeceğini belirten bir boole değeri. Varsayılan olarak, fetch_basic_profile doğru olduğunda (varsayılan değer) ve ek kapsam istenmediğinde erişim jetonu ve istenen kapsamlar döndürülmez.
İadeler
gapi.auth2.AuthResponse gapi.auth2.AuthResponse nesnesi.

GoogleUser.reloadAuthResponse()

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

İadeler
Promise OAuth jetonu yeniden yüklendiğinde, yeniden yüklenen gapi.auth2.AuthResponse ile doldurulan bir Promise.

gapi.auth2.AuthResponse

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

Özellikler
access_token string Erişim jetonu verildi.
id_token string Verilen kimlik jetonu.
scope string Erişim jetonunda verilen kapsamlar.
expires_in number Erişim jetonunun süresi dolana kadar geçecek saniye sayısı.
first_issued_at number Kullanıcının istenen kapsamları ilk kez verdiği zaman damgası.
expires_at number Erişim jetonunun süresinin sona ereceği zaman damgası.

GoogleUser.hasGrantedScopes(scopes)

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

Bağımsız değişkenler
scopes Boşlukla ayrılmış bir kapsam dizesi.
İadeler
Boole Kapsamlar verilmişse doğru değerini döndürür.

GoogleUser.grant(options)

Kullanıcıdan ek kapsamlar isteyebilirsiniz.

Parametrelerin listesi ve hata kodu için GoogleAuth.signIn() bölümüne bakın.

GoogleUser.grantOfflineAccess(options)

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

Bağımsız değişkenler
options Parametrelerin anahtar/değer çiftlerini içeren bir gapi.auth2.OfflineAccessOptions nesnesi. Örneğin: 
{
  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.

Bağımsız değişkenler
id Oturum açma düğmesinin oluşturulacağı öğenin kimliği.
options Düğmeyi oluşturmak için kullanılacak ayarları içeren bir nesne. Örneğin: 
{
  scope: 'email',
  width: 200,
  height: 50,
  longtitle: true,
  theme: 'dark',
  onsuccess: handleSuccess,
  onfailure: handleFailure
}
 Şu seçenekleri belirtebilirsiniz:
Parametreler
kapsam Kullanıcı oturum açtığında istenecek kapsamlar (varsayılan: profile).
genişlik Düğmenin piksel cinsinden genişliği (varsayılan: 120).
yükseklik Düğmenin piksel cinsinden yüksekliği (varsayılan: 36).
longtitle "Oturum aç" yerine "Google ile oturum aç" gibi uzun etiketler gösterin (varsayılan: false). Uzun başlıklar kullandığınızda düğmenin genişliğini varsayılan değerinden artırmanız gerekir.
tema Düğmenin renk teması: light veya dark (varsayılan: light).
onsuccess Kullanıcı başarıyla oturum açtığında çağrılacak geri çağırma işlevi. Bu işlev bir bağımsız değişken almalıdır: gapi.auth2.GoogleUser örneği (varsayılan: yok).
onfailure Oturum açma işlemi başarısız olduğunda çağrılacak geri çağırma işlevi. Bu işlev bağımsız değişken almaz (varsayılan: yok).

Gelişmiş

gapi.auth2.authorize(params, callback)

Tek seferlik bir OAuth 2.0 yetkilendirmesi gerçekleştirir. Kullanılan parametrelere bağlı olarak, Google oturum açma akışını içeren bir pop-up açılır veya istenen yanıt, kullanıcı etkileşimi olmadan sessizce yüklenmeye çalışılır.

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

  • Uygulamanızın, Google API uç noktasını yalnızca bir kez istemesi gerekir (ör. kullanıcı ilk kez oturum açtığında favori YouTube videolarını yüklemek için).
  • Uygulamanızın kendi oturum yönetimi altyapısı vardır ve arka uçta kullanıcıyı tanımlamak için kimlik jetonunun yalnızca bir kez kullanılması gerekir.
  • Aynı sayfada birden fazla müşteri kimliği kullanılıyor.
Bağımsız değişkenler
params Yapılandırma verilerinin anahtar/değer çiftlerini içeren bir nesne. Yapılandırılabilir farklı özellikler için gapi.auth2.AuthorizeConfig bölümüne bakın. Örneğin: 
{
  client_id: 'CLIENT_ID.apps.googleusercontent.com',
  scope: 'email profile openid',
  response_type: 'id_token permission'
}
callback İstek tamamlandıktan (başarılı veya başarısız) sonra gapi.auth2.AuthorizeResponse nesnesi ile çağrılan işlev.

Ö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 Google'dan gerekli bir iFrame başlatılamadı. details mülkü, oluşturulan hata hakkında daha fazla bilgi verir.
popup_closed_by_user
Kullanıcı, oturum açma akışını tamamlamadan pop-up'ı kapattı.
access_denied
Kullanıcı, gerekli kapsamlar için izni reddetti.
immediate_failed
Rıza akışı istem olmadan hiçbir kullanıcı otomatik olarak seçilememiştir. 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.

Özellikler
client_id string Zorunludur. Google API Konsolu'nda bulunan ve oluşturulan uygulamanın istemci kimliği.
scope string Zorunludur. İstenecek alanlar, boşlukla ayrılmış bir dize olarak.
response_type string Boşlukla ayrılmış yanıt türlerinin listesi. Varsayılan olarak 'permission' değerine ayarlanır. Olası değerler:
  • id_token, kimlik jetonu almak için
  • Erişim jetonu almak için permission (veya token)
  • code, yetkilendirme kodu almak için
prompt string İzin akışı için belirli bir modu zorlar. Olası değerler:
  • consent
    Yetkilendirme sunucusu, uygulamaya bilgi döndürmeden önce kullanıcıdan izin ister.
  • select_account
    Yetkilendirme sunucusu, kullanıcıdan bir Google Hesabı seçmesini ister. Bu sayede, birden fazla hesabı olan kullanıcılar, oturumları açık olabilecek birden fazla hesap arasından seçim yapabilir.
  • none
    Yetkilendirme sunucusu herhangi bir kimlik doğrulama veya kullanıcı izni ekranı göstermez. Kullanıcının kimliği doğrulanmamışsa ve daha önce istenen kapsamlara izin vermemişse hata döndürür.
    Yanıt türü olarak code istenirse döndürülen kod yalnızca refresh_token yerine access_token ile değiştirilebilir.
cookie_policy string Oturum açma çerezlerinin oluşturulacağı alanlar. URI, single_host_origin veya none. Belirtilmezse varsayılan olarak single_host_origin olur.
hosted_domain string Kullanıcıların oturum açmak için ait olması gereken G Suite alanı. Bu değer, istemciler tarafından değiştirilebileceğinden döndürülen kullanıcının barındırılan alan mülkünü doğruladığınızdan emin olun.
login_hint string Oturum açma akışında önceden seçilecek bir kullanıcının e-postası veya kullanıcı kimliği. prompt: "none" kullanılmadığı sürece bu ayar kullanıcı tarafından değiştirilebilir.
include_granted_scopes boolean Kullanıcının daha önce uygulamaya verdiği tüm kapsamları veya yalnızca mevcut çağrıda istenen kapsamları içeren bir erişim jetonu isteyip istenmeyeceği. Varsayılan olarak true değerine ayarlanır.
enable_granular_consent boolean İsteğe bağlı. Ayrıntılı izinleri etkinleştirme false olarak ayarlanırsa 2019'dan önce oluşturulan OAuth istemci kimlikleri için daha ayrıntılı Google Hesabı izinleri devre dışı bırakılır. 2019'da veya sonrasında oluşturulan OAuth istemci kimlikleri için bu değişiklik geçerli değildir. Bu kimlikler için daha ayrıntılı izinler her zaman etkindir.
plugin_name string İsteğe bağlı. Yalnızca 3 Mart 2025'ten önce oluşturulan istemci kimlikleri için geçerlidir. Aksi takdirde herhangi bir etkisi yoktur. Mevcut web uygulamalarının Google Platform Kitaplığı'nı kullanmaya devam etmesini sağlar. Varsayılan olarak, yeni oluşturulan istemci kimliklerinin Platform Kitaplığı'nı kullanması engellenir ve bunun yerine daha yeni Google Kimlik Hizmetleri kitaplığını kullanması gerekir.

İstediğiniz değeri seçebilirsiniz. Kimlik tanımlama için ürün veya eklenti adı gibi açıklayıcı bir ad kullanılması önerilir. Örneğin: plugin_name: 'YOUR_STRING_HERE'

gapi.auth2.AuthorizeResponse

Yanıt, gapi.auth2.authorize yönteminin geri çağırma işlevine döndürülür.

Özellikler
access_token string Erişim jetonu verildi. Yalnızca response_type öğesinde permission veya token belirtilmişse mevcuttur.
id_token string Verilen kimlik jetonu. Yalnızca response_type içinde id_token belirtilmişse mevcuttur.
code string Yetkilendirme kodu verildi. Yalnızca response_type içinde code belirtilmişse mevcuttur.
scope string Erişim jetonunda verilen kapsamlar. Yalnızca response_type öğesinde permission veya token belirtilmişse mevcuttur.
expires_in number Erişim jetonunun süresi dolana kadar geçecek saniye sayısı. Yalnızca response_type öğesinde permission veya token belirtilmişse mevcuttur.
first_issued_at number Kullanıcının istenen kapsamları ilk kez verdiği zaman damgası. Yalnızca response_type öğesinde permission veya token belirtilmişse mevcuttur.
expires_at number Erişim jetonunun süresinin sona ereceği zaman damgası. Yalnızca response_type öğesinde permission veya token belirtilmişse mevcuttur.
error string İstek başarısız olduğunda bu parametre hata kodunu içerir.
error_subtype string İstek başarısız olduğunda, döndürülen hata koduna ek bilgiler de dahil edilebilir.