Uyarı: Bu veriler Google Kullanıcı Verileri Politikası kapsamında sağlanır. Lütfen politikayı inceleyin ve politikaya uyun. Bunu yapmazsanız proje veya hesap askıya alınabilir.

Google JavaScript API ile Oturum Açma referansı

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu referans sayfasında, Oturum Açma JavaScript API'si açıklanmaktadır. Bu API'yi kullanarak web sayfalarınızda One Tap istemi veya Google ile Oturum Aç düğmesini görüntüleyebilirsiniz.

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öntemle ilgili aşağıdaki kod örneğini inceleyin:

google.accounts.id.initialize(IdConfiguration)

Aşağıdaki kod örneği, google.accounts.id.initialize yöntemini onload işleviyle uygular:

<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ılabilecek bir Google ile Oturum Açma istemci örneği oluşturur.

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

Yapılandırmaları google.accounts.id.initialize yöntemini her çağırdığınızda sıfırlarsınız ve aynı web sayfasında 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:

Alan
client_id Uygulamanızın istemci kimliği
auto_select Otomatik seçimi etkinleştirir.
callback Kimlik jetonlarını işleyen JavaScript işlevi. Google One Tap ve Google ile Oturum Aç düğmesi popup kullanıcı deneyimi modu bu özelliği kullanır.
login_uri Giriş uç noktanızın URL'si. Google ile Oturum Aç düğmesi redirect kullanıcı deneyimi modu bu özelliği kullanır.
native_callback Şifre kimlik bilgilerini işleyen JavaScript işlevi.
cancel_on_tap_outside Kullanıcı istemin dışını tıklarsa istemi iptal eder.
prompt_parent_id One Tap istemi kapsayıcı öğesinin DOM kimliği
nonce Kimlik jetonları için rastgele dize
context One Tap istemindeki başlık ve kelimeler
state_cookie_domain Üst alanda ve alt alanlarında Tek Dokunma'yı çağırmanız gerekiyorsa paylaşılan tek bir çerezin kullanılması için üst alanı bu alana aktarın.
ux_mode Google ile Oturum Açma düğmesi kullanıcı deneyimi akışı
allowed_parent_origin Ara iframe yerleştirmesine izin verilen kaynaklar. Bu alan gösterilirse Tek Dokunma, ara iframe modunda çalışır.
intermediate_iframe_close_callback Kullanıcılar One Tap'i manuel olarak kapattığında, varsayılan ara iframe davranışını geçersiz kılar.
itp_support ITP tarayıcılarda yeni One Tap kullanıcı deneyiminin etkinleştirilmesini sağlar.

client_id

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

Tür Zorunlu Örnek
string Evet client_id: "CLIENT_ID.apps.googleusercontent.com"

otomatik_seç

Bu alan, uygulamanızı daha önce onaylamış olan yalnızca bir Google oturumu olduğunda, bir 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 değeridir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
boolean İsteğe bağlı auto_select: true

geri çağırma

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

Tür Zorunlu Örnek
fonksiyon One Tap ve popup kullanıcı deneyimi modu için gereklidir callback: handleResponse

giriş_urisi

Bu özellik, giriş uç noktanızın URI'sıdır. Geçerli sayfa giriş sayfanızsa atlanabilir ve bu durumda kimlik bilgisi varsayılan olarak bu sayfada yayınlanır.

Kimlik jetonu kimlik bilgisi yanıtı, kullanıcı Google ile Oturum Aç düğmesini tıkladığında ve yönlendirme kullanıcı deneyimi modunu kullandığında giriş uç noktanıza gönderilir.

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

Tür İsteğe bağlı Örnek
URL Varsayılan olarak geçerli sayfanın URI'sını veya belirttiğiniz değeri belirtir.
Yalnızca ux_mode: "redirect" ayarlandığında kullanılır.
login_uri="https://www.example.com/login"

Giriş uç noktanız, gövdede kimlik jetonu değeri olan bir credential anahtarı içeren POST isteklerini işlemelidir.

Giriş uç noktanıza yapılan bir istek örneği aşağıdadır:

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

yerel_geri arama

Bu alan, tarayıcının yerel 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:

Tür Zorunlu Örnek
fonksiyon İsteğe bağlı native_callback: handleResponse

iptal_on_dokunma_dışı

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

Tür Zorunlu Örnek
boolean İsteğe bağlı cancel_on_tap_outside: false

prompt_parent_id

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

Tür Zorunlu Örnek
string İsteğe bağlı prompt_parent_id: 'parent_id'

tek seferlik rastgele sayı

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

Tür Zorunlu Örnek
string İsteğe bağlı nonce: "biaqbm70g23"

Nonce uzunluğu, ortamınız tarafından desteklenen maksimum JWT boyutuyla ve bağımsız tarayıcı ve sunucu HTTP boyutu kısıtlamalarıyla sınırlıdır.

context

Bu alan, One Tap istemindeki başlığın ve mesajların metnini değiştirir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
string İsteğe bağlı context: "use"

Aşağıdaki tabloda mevcut bağlamlar ve açıklamaları listelenmiştir:

Bağlam
signin "Google ile oturum aç"
signup ""Google'a kaydolun"
use "Google'la Kullan"

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

Tür Zorunlu Örnek
string İsteğe bağlı state_cookie_domain: "example.com"

ux_modu

Google ile Oturum Aç düğmesinin kullandığı kullanıcı deneyimi akışını ayarlamak için bu alanı kullanın. Varsayılan değer popup şeklindedir. Bu özelliğin OneTap kullanıcı deneyimi üzerinde hiçbir etkisi yoktur. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
string İsteğe bağlı ux_mode: "redirect"

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

Kullanıcı Deneyimi Modu
popup Bir pop-up pencerede oturum açma kullanıcı deneyimi akışı gerçekleştirir.
redirect Tam sayfa yönlendirmesiyle oturum açma kullanıcı deneyimi akışı gerçekleştirir.

izin verilen_ebeveyn_kaynak

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

Tür Zorunlu Örnek
dize veya dize dizisi İsteğe bağlı allowed_parent_origin: "https://example.com"

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

Değer Türleri
string Tek bir alan URI'si. &"https://example.com"
string array Alan URI'leri dizisi. ["https://news.example.com", "https://local.example.com"]

Joker karakter ön ekleri de desteklenir. Örneğin, "https://*.example.com", example.com ve alt düzeyleriyle tüm düzeylerde eşleşir (ör.news.example.com, login.news.example.com). Joker karakter kullanırken göz önünde bulundurulması gerekenler:

  • Desen dizeleri yalnızca joker karakter ve üst düzey alan adı içeremez. Örneğin, https://*.com ve https://*.co.uk geçersiz. Yukarıda belirtildiği gibi, "https://*.example.com" example.com ve alt alan adlarıyla eşleşecektir. Diziyi 2 farklı alanı temsil edecek şekilde de kullanabilirsiniz. Örneğin, ["https://example1.com", "https://*.example2.com"] alanı example1.com, example2.com alan adları ve example2.com alt alan adlarıyla eşleşecektir
  • Joker karakter alan adları güvenli bir https:// şemasıyla başlamalıdır. "*.example.com" geçersiz olarak kabul edilecek.

allowed_parent_origin alanının değeri geçersizse, ara iFrame modunun One Tap ilk kullanıma hazırlama işlemi başarısız olur ve durur.

ara_iframe_close_callback

Kullanıcılar Tek Dokunma kullanıcı arayüzünde 'X' düğmesine dokunarak tek dokunmayla varsayılan ara iframe davranışını geçersiz kılar. Varsayılan davranış, ara iframe'i DOM'den 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. One Tap kullanıcı arayüzü, geri çağırma işlemi yapılmadan önce kaldırılır.

Tür Zorunlu Örnek
fonksiyon İsteğe bağlı intermediate_iframe_close_callback: logBeforeClose

itp_destek ekibi

Bu alan, Akıllı İzleme Önleme'yi (ITP) destekleyen tarayıcılarda yeni sürüme geçirilmiş One Tap Kullanıcı Deneyiminin etkinleştirilip etkinleştirilmeyeceğini belirler. Varsayılan değer false şeklindedir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
boolean İsteğe bağlı itp_support: true

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ının yerel kimlik bilgisi yöneticisini görüntüler. Yöntemle ilgili aşağıdaki kod örneğini inceleyin:

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

Normalde prompt() yöntemi, sayfa yüklemesinde çağrılır. Oturum durumu ve Google tarafındaki kullanıcı ayarları nedeniyle One Tap istemi kullanıcı arayüzü gösterilmeyebilir. Farklı anlardaki kullanıcı arayüzü durumuyla ilgili bildirim almak için kullanıcı arayüzü durumu bildirimlerini almak üzere bir işlevden geçin.

Bildirimler şu 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örüntülenip görüntülenmediğini belirten bir boole değeri içerir.
  • Atlanma anı: Bu durum, Tek Dokunuş isteminin otomatik iptal, manuel iptal veya Google tarafından kimlik bilgisi yayınlanamaması (ör. seçilen oturumun Google oturumunun kapatılması gibi) durumunda meydana gelir.

    Bu durumlarda, sonraki kimlik sağlayıcılarıyla devam etmenizi öneririz.

  • Kapatılma zamanı: Bu durum, Google bir kimlik bilgisini başarıyla aldığında veya bir kullanıcı kimlik bilgisi alma akışını durdurmak istediğinde ortaya çıkar. Örneğin, kullanıcı, giriş iletişim kutusunda kullanıcı adını ve şifresini girmeye başladığında, Tek Dokunma istemini kapatmak ve reddedilen bir anı 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ı listelenmektedir:

Yöntem
isDisplayMoment() Bu bildirim bir görüntüleme anıyla ilgili mi?
isDisplayed() Bu bildirim bir görüntüleme anına ait mi ve kullanıcı arayüzü gösteriliyor mu?
isNotDisplayed() Bu bildirim yalnızca bir görüntüleme anına ait mi ve kullanıcı arayüzü gösterilmiyor mu?
getNotDisplayedReason()

Kullanıcı arayüzünün görüntülenmemesinin ayrıntılı nedeni. Olası değerler şunlardır:

  • browser_not_supported
  • invalid_client
  • missing_client_id
  • opt_out_or_no_session
  • secure_http_required
  • suppressed_by_user
  • unregistered_origin
  • unknown_reason
isSkippedMoment() Bu bildirim, atlanan bir an için mi?
getSkippedReason()

Atlanan anla ilgili ayrıntılı neden. Olası değerler şunlardır:

  • auto_cancel
  • user_cancel
  • tap_outside
  • issuing_failed
isDismissedMoment() Bu bildirim, kapatılan bir an için mi gönderildi?
getDismissedReason()

Kapatmanın ayrıntılı nedeni. Olası değerler şunlardır:

  • credential_returned
  • cancel_called
  • flow_restarted
getMomentType()

An türü için bir dize döndürün. Olası değerler şunlardır:

  • display
  • skipped
  • dismissed

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 bulunan alanlar listelenmiştir:

Alan
credential Bu alan, döndürülen kimlik jetonudur.
select_by Bu alan, kimlik bilgilerinin nasıl seçildiğini belirler.

kimlik bilgisi

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

Kodu çözüldüğünde JWT aşağıdaki örnektekine 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 GSuite email address
  "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's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

sub alanı, Google hesabı için genel olarak benzersiz bir tanımlayıcı içerir.

email, email_verified ve hd alanlarını kullanarak Google'ın bir e-posta adresi barındırıp barındırmadığını ve e-posta adresi için yetkili olup olmadığını belirleyebilirsiniz. Google'ın yetkili olduğu durumlarda, kullanıcının geçerli hesap sahibi olduğu bilinmektedir.

Google'ın yetkili olduğu durumlar:

  • email adlı hesabın @gmail.com son eki var. Bu bir Gmail hesabıdır.
  • email_verified doğru ve hd ayarlandı. Bu bir G Suite hesabıdır.

Kullanıcılar Gmail veya G Suite kullanmadan Google Hesaplarına kaydolabilir. email içinde @gmail.com son eki yoksa 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'ın, Google hesabı oluşturulduğunda ilk olarak kullanıcıyı doğrulaması email_verfied da mümkündür ancak üçüncü taraf e-posta hesabının sahipliği değişmiş olabilir.

seçme_seçeneği

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

  • Kullanıcı, Tek Dokunuş veya Google ile Oturum Açma düğmesine basmış veya temassız 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ında seçim yapıp oturum açtı.

  • Kimlik jetonu kimlik bilgilerini uygulamanızla paylaşmadan önce kullanıcı

    • Kimlik bilgilerini paylaşmasına izin vermek için Onayla düğmesine basmış olma veya
    • Daha önce izin vermiş ve bir Google Hesabı seçmek için Hesap Seç özelliğini kullanmıştır.

Bu alanın değeri bu türlerden birine ayarlanmıştır,

Değer Açıklama
auto Kimlik bilgilerinin paylaşılması için daha önce izin vermiş olan mevcut bir kullanıcının otomatik olarak oturum açması.
user Mevcut bir oturumu daha önce izin vermiş olan bir kullanıcı, kimlik bilgilerini paylaşmak için One Tap 'Continue as' düğmesine bastı.
user_1tap Mevcut oturumu olan bir kullanıcı izin vermek ve kimlik bilgilerini paylaşmak için One Tap 'Continue as' düğmesine basmıştır. Yalnızca Chrome 75 ve sonraki sürümler için geçerlidir.
user_2tap Mevcut oturumu olmayan bir kullanıcı, hesap seçmek için One Tap 'Devam et' düğmesine bastı ve ardından pop-up pencerede Onayla düğmesine basarak izin verip kimlik bilgilerini paylaştı. Chromium tabanlı tarayıcılar için geçerlidir.
btn Mevcut bir oturumu olan ve daha önce Google ile Oturum Aç düğmesine basan ve kimlik bilgilerini paylaşmak için 'Hesap Seçin' bölümünden bir Google Hesabı seçen bir kullanıcı.
btn_confirm Mevcut oturumu olan bir kullanıcı, izin vermek ve kimlik bilgilerini paylaşmak için Google ile Oturum Aç düğmesine ve Onayla düğmesine basmıştır.
btn_add_session Önceden oturum izni vermiş olan bir kullanıcı, Google Hesabı seçmek ve kimlik bilgilerini paylaşmak için Google ile Oturum Aç düğmesine bastı.
btn_confirm_add_session Oturumu olmayan bir kullanıcı ilk olarak bir Google Hesabı seçmek için Google ile Oturum Aç düğmesine bastı. Ardından izin vermek ve kimlik bilgilerini paylaşmak için Onayla düğmesine bastı.

Yöntem: google.accounts.id.renderButton

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

Yöntemle ilgili aşağıdaki kod örneğini inceleyin:

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
type Düğme türü: simgesi veya standart düğme.
theme Düğme teması. Örneğin, full_blue veya full_black.
size Düğme boyutu. Örneğin, küçük veya büyük.
text Düğme metni. Örneğin, "Google ile oturum açın" veya "Google ile kaydolun".
shape Düğme şekli. Örneğin, dikdörtgen veya dairesel.
logo_alignment Google logosu hizalaması: sol veya orta.
width Piksel cinsinden düğme genişliği.
locale Ayarlanırsa düğme dili oluşturulur.

Özellik türleri

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

tür

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

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

Tür Zorunlu Örnek
string Evet type: "icon"

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

Tür
standard Metin veya kişiselleştirilmiş bilgiler içeren bir düğme:
icon Metin içermeyen bir simge düğmesi:

tema

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

Tür Zorunlu Örnek
string İsteğe bağlı theme: "filled_blue"

Aşağıdaki tabloda mevcut temalar ve açıklamaları listelenmiştir:

Tema
outline Standart düğme teması:
filled_blue Mavi renkli düğme teması:
filled_black Siyah renkli düğme teması:

boy

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

Tür Zorunlu Örnek
string İsteğe bağlı size: "small"

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

Boyut
large Büyük bir düğme:
Büyük bir standart düğme Büyük simge simgesi Büyük ve kişiselleştirilmiş bir düğme
medium Orta boyutlu düğme:
Orta boy standart düğme Orta renkli simge düğmesi
small Küçük bir düğme:
Küçük bir düğme Küçük bir simge düğmesi

kısa mesaj

Düğme metni. Varsayılan değer signin_with değeridir. Farklı text özellikleri olan simge düğmelerinin metni için herhangi bir görsel fark yoktur. Bunun tek istisnası, metnin ekran erişilebilirliği için okunmasıdır.

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

Tür Zorunlu Örnek
string İsteğe bağlı text: "signup_with"

Aşağıdaki tabloda mevcut düğme metinleri ve açıklamaları verilmiştir:

Metin
signin_with Düğme metni "Google ile oturum aç" şeklindedir:
signup_with Düğme metni "Google'a kaydolun" şeklindedir:
continue_with Düğme metni "Google ile Devam Et"tir:
signin Düğme metni "Oturum aç" şeklindedir:

shape

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

Tür Zorunlu Örnek
string İsteğe bağlı shape: "rectangular"

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

Şekil
rectangular Dikdörtgen şekilli düğme. icon düğme türü için kullanılıyorsa bu, square ile aynıdır.
pill Hap şeklindeki düğme. icon düğme türü için kullanılıyorsa bu, circle ile aynıdır.
circle Daire şeklindeki düğme. standard düğme türü için kullanılıyorsa bu, pill ile aynıdır.
square Kare şekilli düğme. standard düğme türü için kullanılıyorsa bu, rectangular ile aynıdır.

logo_hizalama

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

Tür Zorunlu Örnek
string İsteğe bağlı logo_alignment: "center"

Aşağıdaki tabloda mevcut hizalamalar ve açıklamaları listelenmiştir:

logo_hizalama
left Google logosunu sola hizalar.
center Google logosunu ortaya hizalar.

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:

Tür Zorunlu Örnek
string İsteğe bağlı width: 400

locale

Düğme metninin önceden belirlenmiş yerel ayarı. 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 farklı boyutlara ve muhtemelen farklı boyutlara sahip farklı sürümler görebilir.

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

Tür Zorunlu Örnek
string İsteğe bağlı locale: "zh_CN"

Veri türü: Kimlik bilgisi

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

Alan
id Kullanıcıyı tanımlar.
password Şifre

Yöntem: google.accounts.id.disabledAutoSelect

Kullanıcı web sitenizde oturumu kapattığında, durumu çerezlere kaydetmek için google.accounts.id.disableAutoSelect yöntemini çağırmanız gerekir. Bu, kullanıcı deneyimine yönelik, geçersiz bir döngüyü önler. Yöntemin aşağıdaki kod snippet'ine bakın:

google.accounts.id.disableAutoSelect()

Aşağıdaki kod örneği, google.accounts.id.disableAutoSelect yöntemini bir onSignout() işleviyle uygular:

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

Yöntem: google.accounts.id.storeCredential

Bu yöntem, tarayıcının yerel kimlik bilgisi yöneticisi API'sinin store() yöntemi için basit bir sarmalayıcıdır. Bu nedenle, yalnızca şifre kimlik bilgilerini depolamak için kullanılabilir. Yöntemle ilgili aşağıdaki kod örneğini inceleyin:

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

Aşağıdaki kod örneği, google.accounts.id.storeCredential yöntemini bir onSignIn() işleviyle uygular:

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

Yöntem: google.accounts.id.cancel

İstemi bağlı taraf DOM'den kaldırırsanız One Tap akışını iptal edebilirsiniz. Bir kimlik bilgisi zaten seçilmişse iptal işlemi yoksayılır. Yöntemle ilgili aşağıdaki kod örneğini inceleyin:

google.accounts.id.cancel()

Aşağıdaki kod örneği, google.accounts.id.cancel() yöntemini onNextButtonClicked() işleviyle uygular:

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

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

Bir onGoogleLibraryLoad geri çağırması kaydedebilirsiniz. Google ile Oturum Açma JavaScript kitaplığı yüklendikten sonra bilgilendirilir:

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

Bu geri çağırma, window.onload geri çağırma işleminin yalnızca bir kısayoludur. Davranışta fark yoktur.

Aşağıdaki kod örneği bir onGoogleLibraryLoad geri çağırması 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'ine bakın: google.accounts.id.revoke(hint, callback)

Parametre Tür Açıklama
hint string Kullanıcının Google Hesabının e-posta adresi veya benzersiz kimliği. Kimlik, kimlik bilgisi yükünün sub özelliğidir.
callback fonksiyon İsteğe bağlı RevocationResponse işleyici.

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:

Alan
successful Bu alan, yöntem çağrısının dönüş değeridir.
error Bu alan isteğe bağlı olarak ayrıntılı bir hata yanıtı mesajı içerir.

başarılı

Bu alan, iptal etme yöntemi başarılı olduysa veya hata durumunda yanlış değerini döndürürse doğru olarak ayarlanmış bir boole değeridir.

hata

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