Sign in with Google JavaScript API referansı

Bu referans sayfasında, web sayfalarında Google ile Oturum Aç düğmesini veya One Tap istemini görüntülemek için kullanılan Google ile Oturum Aç JavaScript API'si açıklanmaktadır.

Yöntem: google.accounts.id.initialize

google.accounts.id.initialize yöntemi, yapılandırma nesnesine göre Google ile Oturum Açma istemcisini başlatır. Yöntemin aşağıdaki kod örneğine bakın:

google.accounts.id.initialize(IdConfiguration)

Aşağıdaki kod örneğinde, google.accounts.id.initialize yöntemi bir onload işleviyle uygulanmaktadır:

<script>
  window.onload = function () {
    google.accounts.id.initialize({
      client_id: 'YOUR_GOOGLE_CLIENT_ID',
      callback: handleCredentialResponse
    });
    google.accounts.id.prompt();
  };
</script>

google.accounts.id.initialize yöntemi, aynı web sayfasındaki tüm modüller tarafından dolaylı olarak kullanılabilen bir Google ile oturum açma istemci örneği oluşturur.

• Aynı web sayfasında birden fazla modül (ör. Tek Dokunuş, kişiselleştirilmiş düğme, iptal vb.) kullansanız bile google.accounts.id.initialize yöntemini yalnızca bir kez çağırmanız gerekir.
• google.accounts.id.initialize yöntemini birden fazla kez çağırırsanız yalnızca son çağrıdaki yapılandırmalar hatırlanır ve kullanılır.

google.accounts.id.initialize yöntemini her çağırdığınızda yapılandırmaları sıfırlarsınız ve aynı web sayfasındaki sonraki tüm yöntemler yeni yapılandırmaları hemen kullanır.

Veri türü: IdConfiguration

Aşağıdaki tabloda, IdConfiguration veri türünün alanları ve açıklamaları listelenmiştir:

client_id

Bu alan, uygulamanızın istemci kimliğidir. Bu kimlik, Google Cloud Console'da bulunur ve oluşturulur. Daha fazla bilgi için aşağıdaki tabloya bakın:

color_scheme

Bu alan, One Tap istemine uygulanan renk şemasıdır. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir renk şemaları ve açıklamaları listelenmiştir.

auto_select

Bu alan, uygulamanızı daha önce onaylamış tek bir Google oturumu olduğunda kimlik jetonunun herhangi bir kullanıcı etkileşimi olmadan otomatik olarak döndürülüp döndürülmeyeceğini belirler. Varsayılan değer: false. Daha fazla bilgi için aşağıdaki tabloya bakın:

callback

Bu alan, One Tap isteminden veya pop-up penceresinden döndürülen kimlik jetonunu işleyen JavaScript işlevidir. Google One Tap veya Google ile oturum açma düğmesi popup kullanıcı deneyimi modu kullanılıyorsa bu özellik zorunludur. Daha fazla bilgi için aşağıdaki tabloya bakın:

login_uri

Bu özellik, giriş uç noktanızın URI'sidir.

Değer, Google Cloud Console'da yapılandırdığınız OAuth 2.0 istemcisinin yetkili yönlendirme URI'lerinden biriyle tam olarak eşleşmeli ve yönlendirme URI'si doğrulama kurallarımıza uygun olmalıdır.

Geçerli sayfa giriş sayfanızsa bu özellik atlanabilir. Bu durumda, kimlik bilgileri varsayılan olarak bu sayfaya gönderilir.

Kullanıcı, Google ile oturum açma düğmesini tıkladığında ve yönlendirme kullanıcı deneyimi modu kullanıldığında kimlik jetonunun kimlik bilgisi yanıtı, giriş uç noktanıza gönderilir.

Daha fazla bilgi için aşağıdaki tabloya bakın:

Giriş uç noktanız, gövdede kimlik jetonu değeri içeren bir credential parametresi barındıran POST isteklerini işlemelidir. select_by, login_uri veya data-login_uri adresine gönderilen HTTP POST isteklerine dahil edilmez ve yalnızca JavaScript callback işlevine iletilen CredentialResponse nesnesinde döndürülür.

native_callback

Bu alan, tarayıcının yerleşik kimlik bilgisi yöneticisinden döndürülen şifre kimlik bilgisini işleyen JavaScript işlevinin adıdır. Daha fazla bilgi için aşağıdaki tabloya bakın:

cancel_on_tap_outside

Bu alan, kullanıcı istemin dışını tıklarsa One Tap isteğinin iptal edilip edilmeyeceğini belirler. Varsayılan değer: true. Değeri false olarak ayarlarsanız devre dışı bırakabilirsiniz. Daha fazla bilgi için aşağıdaki tabloya bakın:

prompt_parent_id

Bu özellik, kapsayıcı öğenin DOM kimliğini ayarlar. Ayarlanmazsa One Tap istemi pencerenin sağ üst köşesinde gösterilir. Daha fazla bilgi için aşağıdaki tabloya bakın:

tek seferlik rastgele sayı

Bu alan, kimlik jetonu tarafından tekrar saldırılarını önlemek için kullanılan rastgele bir dizedir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tek seferlik rastgele sayı uzunluğu, ortamınız tarafından desteklenen maksimum JWT boyutu ve tarayıcı ile sunucu HTTP boyutu kısıtlamalarıyla sınırlıdır.

essential_claims

Bu alan, Google tarafından döndürülen kimlik jetonuna ek taleplerin dahil edilmesini istemek için kullanılan bir dizedir. Google tarafından kabul edilen hak taleplerinin tam listesi için desteklenen hak talepleri bölümüne bakın.

Daha fazla bilgi için aşağıdaki tabloya bakın:

bağlam

Bu alan, One Tap isteminde gösterilen başlık ve mesajların metnini değiştirir. ITP tarayıcıları üzerinde herhangi bir etkisi yoktur. Varsayılan değer signin'dir.

Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir tüm bağlamlar ve açıklamaları listelenmiştir:

state_cookie_domain

Tek Dokunuş'u üst alanda ve alt alanlarında göstermeniz gerekiyorsa tek bir paylaşılan durum çerezinin kullanılması için üst alanı bu alana iletin. Daha fazla bilgi için aşağıdaki tabloya bakın:

ux_mode

Google ile oturum açma düğmesi tarafından kullanılan kullanıcı deneyimi akışını ayarlamak için bu alanı kullanın. Varsayılan değer popup'dir. Bu özelliğin OneTap kullanıcı deneyimi üzerinde bir etkisi yoktur. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir kullanıcı deneyimi modları ve açıklamaları listelenmiştir.

allowed_parent_origin

Ara iFrame'i yerleştirmesine izin verilen kaynaklar. Bu alan mevcutsa One Tap, ara iframe modunda çalışır. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda desteklenen değer türleri ve açıklamaları listelenmiştir.

Joker karakter önekleri de desteklenir. Örneğin, "https://*.example.com", example.com ve tüm düzeylerdeki alt alan adlarıyla (ör. news.example.com, login.news.example.com) eşleşir. Joker karakterleri kullanırken dikkat edilmesi gerekenler:

• Kalıp dizeleri yalnızca bir joker karakter ve bir üst düzey alandan oluşamaz. Örneğin, https://.com ve https://.co.uk geçersizdir. Çünkü "https://.example.com", example.com ve tüm alt alan adlarıyla eşleşir. İki farklı alan adını temsil etmek için virgülle ayrılmış bir liste kullanın. Örneğin, "https://example1.com,https://.example2.com", example1.com ve example2.com alanlarıyla ve example2.com alt alanlarıyla eşleşir.
• Joker karakter alanları güvenli bir https:// şemasıyla başlamalıdır. Bu nedenle "*.example.com" geçersiz kabul edilir.

allowed_parent_origin alanının değeri geçersizse ara iFrame modunun One Tap başlatma işlemi başarısız olur ve durur.

intermediate_iframe_close_callback

Kullanıcılar One Tap kullanıcı arayüzündeki "X" düğmesine dokunarak One Tap'i manuel olarak kapattığında varsayılan ara iframe davranışını geçersiz kılar. Varsayılan davranış, ara iframe'i DOM'dan hemen kaldırmaktır.

intermediate_iframe_close_callback alanı yalnızca ara iFrame modunda geçerli olur. Ayrıca, One Tap iframe'i yerine yalnızca ara iframe'i etkiler. Geri çağırma işlevi çağrılmadan önce One Tap kullanıcı arayüzü kaldırılır.

itp_support

Bu alan, Akıllı Takip Önleme'yi (ITP) destekleyen tarayıcılarda yükseltilmiş One Tap kullanıcı deneyiminin etkinleştirilip etkinleştirilmeyeceğini belirler. Varsayılan değer: false. Daha fazla bilgi için aşağıdaki tabloya bakın:

login_hint

Uygulamanız hangi kullanıcının oturum açması gerektiğini önceden biliyorsa Google'a bir giriş ipucu sağlayabilir. İşlem başarılı olduğunda hesap seçimi atlanır. Kabul edilen değerler: e-posta adresi veya kimlik jetonu sub alan değeri.

Daha fazla bilgi için OpenID Connect belgelerindeki login_hint alanına bakın.

hd

Birden fazla hesabı olan ve yalnızca Workspace hesabıyla oturum açması gereken kullanıcılar için Google'a alan adı ipucu sağlamak üzere bu ayarı kullanın. İşlem başarılı olduğunda, hesap seçimi sırasında gösterilen kullanıcı hesapları, sağlanan alanla sınırlı olur. Joker karakter değeri: *, kullanıcıya yalnızca Workspace hesapları sunar ve hesap seçimi sırasında tüketici hesaplarını (user@gmail.com) hariç tutar.

Daha fazla bilgi için OpenID Connect belgelerindeki hd alanına bakın.

use_fedcm_for_prompt

Tarayıcının, kullanıcı oturum açma istemlerini kontrol etmesine ve web siteniz ile Google arasındaki oturum açma akışına aracılık etmesine izin verin. Varsayılan olarak false değerine ayarlanır. Daha fazla bilgi için FedCM'ye geçiş sayfasına bakın.

use_fedcm_for_button

Bu alan, Chrome'da (masaüstü M125+ ve Android M128+) FedCM düğmesi kullanıcı deneyiminin kullanılıp kullanılmayacağını belirler. Varsayılan değer false şeklindedir. Daha fazla bilgi için aşağıdaki tabloya bakın:

button_auto_select

Bu alan, FedCM düğme akışı için otomatik seçim seçeneğinin etkinleştirilip etkinleştirilmeyeceğini belirler. Etkinleştirilirse etkin bir Google oturumu olan geri gelen kullanıcıların oturumu, hesap seçici istemi atlanarak otomatik olarak açılır. Varsayılan değer false olarak ayarlanır. Düğmeyle otomatik oturum açma özelliğini, ilk kullanıma sunma sırasında açıkça etkinleştirmeniz gerekir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Yöntem: google.accounts.id.prompt

google.accounts.id.prompt yöntemi, initialize() yöntemi çağrıldıktan sonra One Tap istemini veya tarayıcıda yerleşik kimlik bilgisi yöneticisini gösterir. Yöntemin aşağıdaki kod örneğine bakın:

 google.accounts.id.prompt(/**
 @type{(function(!PromptMomentNotification):void)=} */ momentListener)

Normalde prompt() yöntemi sayfa yüklenirken çağrılır. Google tarafındaki oturum durumu ve kullanıcı ayarları nedeniyle One Tap istemi kullanıcı arayüzü gösterilmeyebilir. Farklı anlarda kullanıcı arayüzü durumu hakkında bildirim almak için kullanıcı arayüzü durumu bildirimlerini alacak bir işlev iletin.

Bildirimler aşağıdaki anlarda tetiklenir:

• Görüntüleme anı: Bu, prompt() yöntemi çağrıldıktan sonra gerçekleşir. Bildirim, kullanıcı arayüzünün gösterilip gösterilmediğini belirten bir Boole değeri içerir.

• Atlanan an: Bu durum, One Tap istemi otomatik iptal veya manuel iptal ile kapatıldığında ya da Google, kimlik bilgisi veremediğinde (ör. seçilen oturumun Google oturumu kapatıldığında) ortaya çıkar.

  Bu gibi durumlarda, varsa sonraki kimlik sağlayıcılara geçmenizi öneririz.

• Kapatılan an: Bu durum, Google bir kimlik bilgisini başarıyla aldığında veya kullanıcı, kimlik bilgisi alma akışını durdurmak istediğinde gerçekleşir. Örneğin, kullanıcı giriş iletişim kutunuza kullanıcı adını ve şifresini girmeye başladığında, One Tap istemini kapatmak ve kapatma anını tetiklemek için google.accounts.id.cancel() yöntemini çağırabilirsiniz.

Aşağıdaki kod örneği, atlanan anı uygular:

<script>
  window.onload = function () {
    google.accounts.id.initialize(...);
    google.accounts.id.prompt((notification) => {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
        // continue with another identity provider.
      }
    });
  };
</script>

Veri türü: PromptMomentNotification

Aşağıdaki tabloda, PromptMomentNotification veri türünün yöntemleri ve açıklamaları listelenmiştir:

Veri türü: CredentialResponse

callback işleviniz çağrıldığında parametre olarak bir CredentialResponse nesnesi iletilir. Aşağıdaki tabloda, kimlik bilgisi yanıt nesnesinde yer alan alanlar listelenmiştir:

yeterlilik belgesi

Bu alan, base64 kodlu JSON Web Token (JWT) dizesi olarak kimlik jetonudur.

Kodu çözüldüğünde JWT aşağıdaki örneğe benzer:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's Google Workspace email address
  "auth_time": 1748875426,
  "amr": ["mfa", "pwd", "tel"],
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Elisa",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion creation time
  "exp": 1596477600, // Unix timestamp of the assertion expiration time
  "jti": "abc161803398874def"
}

sub alanı, Google Hesabı için dünya genelinde benzersiz bir tanımlayıcıdır. Tüm Google Hesapları arasında benzersiz olduğu ve hiçbir zaman yeniden kullanılmadığı için kullanıcının tanımlayıcısı olarak yalnızca sub alanını kullanın.

email, email_verified ve hd alanlarını kullanarak Google'ın bir e-posta adresini barındırıp barındırmadığını ve bu adres için yetkili olup olmadığını belirleyebilirsiniz. Google'ın yetkili olduğu durumlarda kullanıcının yasal hesap sahibi olduğu doğrulanır.

Google'ın yetkili olduğu durumlar:

• email, @gmail.com son ekine sahip. Bu bir Gmail hesabıdır.
• email_verified doğruysa ve hd ayarlanmışsa bu bir Google Workspace hesabıdır.

Kullanıcılar, Gmail veya Google Workspace kullanmadan Google Hesaplarına kaydolabilir. email, @gmail.com son ekini içermediğinde ve hd olmadığında Google yetkili değildir ve kullanıcıyı doğrulamak için şifre veya diğer sorgulama yöntemleri önerilir. Google, Google Hesabı oluşturulduğunda kullanıcıyı doğruladığı için email_verfied de doğru olabilir ancak üçüncü taraf e-posta hesabının sahipliği o zamandan beri değişmiş olabilir.

exp alanı, jetonu sunucu tarafında doğrulamanız için geçerlilik süresini gösterir. Google ile oturum açma özelliğinden alınan kimlik jetonu için bu süre bir saattir. Süre dolmadan önce jetonu doğrulamanız gerekir. Oturum yönetimi için exp kullanmayın. Süresi dolmuş bir kimlik jetonu, kullanıcının oturumunun kapalı olduğu anlamına gelmez. Uygulamanız, kullanıcılarınızın oturum yönetiminden sorumludur.

select_by

Aşağıdaki tabloda, select_by alanı için olası değerler listelenmiştir. Değeri ayarlamak için oturum ve izin durumuyla birlikte kullanılan düğme türü kullanılır.

• Kullanıcı, One Tap veya Google ile oturum aç düğmesine basmış ya da dokunmadan otomatik oturum açma işlemini kullanmıştır.

• Mevcut bir oturum bulundu veya kullanıcı yeni bir oturum oluşturmak için bir Google Hesabı seçip oturum açtı.

• Kullanıcı, kimlik jetonu kimlik bilgilerini uygulamanızla paylaşmadan önce şunlardan birini yapar:

  • Kimlik bilgilerini paylaşma izni vermek için Onayla düğmesine basmış, veya
  • daha önce izin vermiş ve bir Google Hesabı seçmek için Hesap Seçin'i kullanmışsa.

Bu alanın değeri aşağıdaki türlerden birine ayarlanır:

durum

Bu alan yalnızca kullanıcı oturum açmak için Google ile oturum aç düğmesini tıkladığında ve tıklanan düğmenin state özelliği belirtildiğinde tanımlanır. Bu alanın değeri, düğmenin state özelliğinde belirttiğiniz değerle aynıdır.

Aynı sayfada birden fazla Google ile oturum açma düğmesi oluşturulabileceğinden her düğmeye benzersiz bir dize atayabilirsiniz. Bu nedenle, kullanıcının oturum açmak için hangi düğmeyi tıkladığını belirlemek amacıyla bu state alanını kullanabilirsiniz.

Yöntem: google.accounts.id.renderButton

google.accounts.id.renderButton yöntemi, web sayfalarınızda Google ile oturum açma düğmesi oluşturur.

Yöntemin aşağıdaki kod örneğine bakın:

google.accounts.id.renderButton(
      /** @type{!HTMLElement} */ parent,
      /** @type{!GsiButtonConfiguration} */ options
    )

Veri türü: GsiButtonConfiguration

Aşağıdaki tabloda, GsiButtonConfiguration veri türünün alanları ve açıklamaları listelenmiştir:

Özellik türleri

Aşağıdaki bölümlerde her özellik türüyle ilgili ayrıntılar ve bir örnek yer almaktadır.

tür

Düğme türü. Varsayılan değer: standard.

Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir düğme türleri ve açıklamaları listelenmiştir:

Tür
standard
icon

tema

Düğme teması. Varsayılan değer: outline. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir temalar ve açıklamaları listelenmiştir:

Tema	Örnekler	Teknik Özellikler
outline		Dolgu: #FFFFFF Kontur: #747775 | 1 piksel | iç Yazı tipi: #1F1F1F | Roboto Medium | 14/20 Kişiselleştirilmiş: #1F1F1F | Roboto | Medium 12/14 | Regular 11/13
filled_blue		Dolgu: #0B57D0 Kontur: #OB57D0 | 1 piksel | iç Yazı tipi: #FFFFFF | Google Sans Medium | 14/20 Kişiselleştirilmiş: #FFFFFF | Roboto | Medium 12/14 | Regular 11/13
filled_black		Dolgu: #202124 Kontur: #OB57D0 | 1 piksel | iç Yazı tipi: #FFFFFF | Google Sans Medium | 14/20 Kişiselleştirilmiş: #FFFFFF | Roboto | Medium 12/14 | Regular 11/13
outline_dark		Dolgu: #131314 Kontur: #8E918F | 1 piksel | iç Yazı tipi: #FFFFFF | Google Sans Medium | 14/20 Kişiselleştirilmiş: #FFFFFF | Roboto | Medium 12/14 | Regular 11/13

beden

Düğme boyutu. Varsayılan değer: large. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir düğme boyutları ve açıklamaları listelenmiştir:

Boyut
large
medium
small

text (metin)

Düğme metni. Varsayılan değer: signin_with. Farklı text özelliklerine sahip simge düğmelerinin metinleri arasında görsel fark yok. Bunun tek istisnası, metnin ekran erişilebilirliği için okunmasıdır.

Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir tüm düğme metinleri ve açıklamaları listelenmiştir:

Metin
signin_with
signup_with
continue_with
signin

şekil

Düğme şekli. Varsayılan değer: rectangular. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir düğme şekilleri ve açıklamaları listelenmiştir:

Şekil
rectangular
pill
circle
square

logo_alignment

Google logosunun hizalaması. Varsayılan değer: left. Bu özellik yalnızca standard düğme türü için geçerlidir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Aşağıdaki tabloda, kullanılabilir hizalamalar ve açıklamaları listelenmiştir:

logo_alignment
left
center

genişlik

Piksel cinsinden minimum düğme genişliği. Maksimum genişlik 400 pikseldir.

Daha fazla bilgi için aşağıdaki tabloya bakın:

locale

İsteğe bağlı. Düğme metnini belirtilen yerel ayarı kullanarak gösterir. Aksi takdirde, kullanıcının Google Hesabı veya tarayıcı ayarları varsayılan olarak kullanılır. Kitaplığı yüklerken src yönergesine hl parametresini ve dil kodunu ekleyin. Örneğin: gsi/client?hl=<iso-639-code>.

Ayarlanmazsa tarayıcının varsayılan yerel ayarı veya Google oturumu kullanıcısının tercihi kullanılır. Bu nedenle, farklı kullanıcılar yerelleştirilmiş düğmelerin farklı sürümlerini ve muhtemelen farklı boyutlarda görebilir.

Daha fazla bilgi için aşağıdaki tabloya bakın:

click_listener

click_listener özelliğini kullanarak Google ile oturum açma düğmesi tıklandığında çağrılacak bir JavaScript işlevi tanımlayabilirsiniz.

  google.accounts.id.renderButton(document.getElementById("signinDiv"), {
      theme: 'outline',
      size: 'large',
      click_listener: onClickHandler
    });

  
  function onClickHandler(){
    console.log("Sign in with Google button clicked...")
  }
  

Bu örnekte, Google ile oturum açma düğmesi tıklandığında konsola Google ile oturum açma düğmesi tıklandı... mesajı kaydedilir.

durum

İsteğe bağlı olarak, aynı sayfada birden fazla Google ile oturum açma düğmesi oluşturulabileceğinden her düğmeye benzersiz bir dize atayabilirsiniz. Aynı dize, kimlik jetonuyla birlikte döndürülür. Böylece, kullanıcının oturum açmak için hangi düğmeyi tıkladığını belirleyebilirsiniz.

Daha fazla bilgi için aşağıdaki tabloya bakın:

Veri türü: Kimlik bilgisi

native_callback işleviniz çağrıldığında parametre olarak bir Credential nesnesi iletilir. Aşağıdaki tabloda, nesnede bulunan alanlar listelenmiştir:

Yöntem: google.accounts.id.disableAutoSelect

Kullanıcı web sitenizde oturumu kapattığında durumu çerezlere kaydetmek için google.accounts.id.disableAutoSelect yöntemini çağırmanız gerekir. Bu sayede kullanıcı deneyimi açısından sonsuz döngüye girilmez. Yöntemin aşağıdaki kod snippet'ine bakın:

google.accounts.id.disableAutoSelect()

Aşağıdaki kod örneğinde, google.accounts.id.disableAutoSelect yöntemi onSignout() işleviyle uygulanmaktadır:

<script>
  function onSignout() {
    google.accounts.id.disableAutoSelect();
  }
</script>

Yöntem: google.accounts.id.storeCredential

Bu yöntem, tarayıcının yerleşik Credential Manager API'sinin store() yöntemi için bir sarmalayıcıdır. Bu nedenle, yalnızca şifre kimlik bilgilerini depolamak için kullanılabilir. Yöntemin aşağıdaki kod örneğine bakın:

google.accounts.id.storeCredential(Credential, callback)

Aşağıdaki kod örneğinde, google.accounts.id.storeCredential yöntemi onSignIn() işleviyle uygulanmaktadır:

<script>
  function onSignIn() {
    let cred = {id: '...', password: '...'};
    google.accounts.id.storeCredential(cred);
  }
</script>

Yöntem: google.accounts.id.cancel

İstemi, taraf DOM'undan kaldırırsanız One Tap akışını iptal edebilirsiniz. Bir kimlik bilgisi zaten seçilmişse iptal işlemi yok sayılır. Yöntemin aşağıdaki kod örneğine bakın:

google.accounts.id.cancel()

Aşağıdaki kod örneğinde, google.accounts.id.cancel() yöntemi bir onNextButtonClicked() işleviyle uygulanmaktadır:

<script>
  function onNextButtonClicked() {
    google.accounts.id.cancel();
    showPasswordPage();
  }
</script>

Kitaplık yükleme geri çağırma işlevi: onGoogleLibraryLoad

onGoogleLibraryLoad geri çağırma işlevi kaydedebilirsiniz. Google ile Oturum Açma JavaScript kitaplığı yüklendikten sonra bildirim gönderilir:

window.onGoogleLibraryLoad = () => {
    ...
};

Bu geri çağırma, window.onload geri çağırması için bir kısayoldur. Davranışta herhangi bir fark yoktur.

Aşağıdaki kod örneği, bir onGoogleLibraryLoad geri çağırma işlevi uygular:

<script>
  window.onGoogleLibraryLoad = () => {
   google.accounts.id.initialize({
     ...
   });
   google.accounts.id.prompt();
  };
</script>

Yöntem: google.accounts.id.revoke

google.accounts.id.revoke yöntemi, belirtilen kullanıcının kimlik jetonunu paylaşmak için kullanılan OAuth erişim iznini iptal eder. Yöntemin aşağıdaki kod snippet'ini inceleyin: javascript google.accounts.id.revoke(login_hint, callback)

Aşağıdaki kod örneğinde, revoke yönteminin bir kimlikle nasıl kullanılacağı gösterilmektedir.

  google.accounts.id.revoke('1618033988749895', done => {
    console.log(done.error);
  });

Veri türü: RevocationResponse

callback işleviniz çağrıldığında parametre olarak bir RevocationResponse nesnesi iletilir. Aşağıdaki tabloda, iptal yanıtı nesnesinde bulunan alanlar listelenmiştir:

tamamlandı

Bu alan, iptal yöntemi çağrısı başarılı olursa true, başarısız olursa false olarak ayarlanan bir Boole değeridir.

hata

Bu alan bir dize değeridir ve iptal yöntemi çağrısı başarısız olursa ayrıntılı bir hata mesajı içerir. Başarılı olduğunda ise tanımsızdır.