İşleminiz için en uygun hesap bağlama türü, kullanıcılarınıza en basit deneyimi sunan ve uygulamanızın ya da işletmenizin ihtiyaçlarına uygun olandır. Bağlantı türünüzün seçilmesi çoğunlukla aşağıdaki faktörlere bağlıdır:
- Sesle hesap oluşturmaya izin vermek isteyip istemediğiniz
- Kullanıcıların Google dışı bir hesapla hizmetinizde oturum açabilmesini isteyip istemediğiniz
- Hizmetinizin gizli bilgileri (ör. istemci gizli anahtarı) depolayıp depolayamayacağı
İdeal hesap bağlama türünüzü belirlemek için aşağıdaki adımları uygulayın:
- Tercih ettiğiniz oturum açma türünü tanımlama bölümündeki soruları göz önünde bulundurun.
- Bağlantı türünüzü seçmek için karar ağacına bakın.
- İşleyiş şeklini daha da hassaslaştırmak için seçtiğiniz ilk türe karşılık gelen bölüme gidin.
Tercih ettiğiniz oturum açma türünü tanımlayın
Karar ağacına danışmadan önce aşağıdaki soruları göz önünde bulundurun:
- Tüm kullanıcılarınızın bir Google Hesabına sahip olmasını mı bekliyorsunuz?
- İşleminiz yalnızca Asistan'ı hedefliyorsa tüm kullanıcılarınızın bir Google Hesabı olmasını bekleyebilirsiniz. İşleminiz Asistan dışındaki platformları hedefliyorsa tüm kullanıcılarınızın bir Google Hesabı olmasını bekleyemezsiniz.
- Hizmetinizde halihazırda mevcut kullanıcılar varsa büyük olasılıkla bu kullanıcıların Google Hesabı olmayabilir veya hizmetinizde bir Google Hesabı ile oturum açmamış olabilirler.
- OAuth uygulamanız varsa bu uygulama, Google protokolünü destekleyecek şekilde genişletilebilir mi?
- Google protokolünü desteklemek için jeton değişimi uç noktanıza
intent=getveintent=createişlevlerini ekleyebilmeniz gerekir. Bu işlev, Google'ın kullanıcının arka uçunuzda zaten mevcut olup olmadığını kontrol etmesine ve sırasıyla hizmetinizde yeni bir hesap oluşturma isteğinde bulunmasına olanak tanır.
- Google protokolünü desteklemek için jeton değişimi uç noktanıza
Siz ve kullanıcılarınız için en uygun hesap bağlama türünü belirlemek üzere aşağıdaki karar ağacını izleyin:
Bir bağlantı türü seçtikten sonra, nasıl çalıştığı hakkında daha fazla bilgi edinmek ve İşleminizde hesap bağlamanın nasıl çalıştığıyla ilgili daha fazla karar vermek için aşağıdaki ilgili bölüme devam edin.
OAuth ve Google ile Oturum Açma
OAuth ve Google ile Oturum Açma (GSI) bağlantı türü, OAuth tabanlı hesap bağlamanın yanına GSI'yı ekler. Bu, GSI'nın avantajlarını (örneğin, Google kullanıcıları için ses tabanlı bağlantı) sağlarken, hizmetinize Google dışı bir hesapla kaydolan kullanıcılar için de hesap bağlamayı etkinleştirir. Bu bağlantı türü, Google dışı kullanıcılar için yedek ile Google kullanıcılarına sorunsuz bir akış sağladığından özellikle son kullanıcılar için avantajlıdır. OAuth ve GSI bağlantı türünün nasıl çalıştığı hakkında daha fazla bilgi edinmek için OAuth ve Google ile Oturum Açma kavram rehberini inceleyin.
OAuth ve Google ile Oturum Açma bağlantı türünü hassaslaştırma
İşleminizde OAuth ve GSI hesap bağlama türünü kullandığınızda, nasıl çalıştığını tanımlamak için Actions konsolunda aşağıdaki soruların yanıtlarını belirtirsiniz:
Web sitenizde sesli hesap oluşturmayı etkinleştirmek mi yoksa yalnızca hesap oluşturmaya mı izin vermek istiyorsunuz?
Genel olarak, ses aracılığıyla hesap oluşturma özelliğini etkinleştirmeniz gerekir. Böylece, ekranlanmayan bir cihazdaki kullanıcıların başka bir cihaza aktarım yapmak zorunda kalmadan hesap oluşturabilir. Sesle hesap oluşturmaya izin vermezseniz Asistan, kullanıcı kimlik doğrulaması için sağladığınız web sitesinin URL'sini açar ve hesap bağlama akışına devam etmesi için kullanıcıyı telefona yönlendirir.
Ancak, aşağıdakilerden herhangi biri geçerliyse sesli hesap oluşturma işlemine izin vermemelisiniz:
- Hesap oluşturma akışı üzerinde tam kontrole sahip olmanız gerekir. Örneğin, hesap oluşturma veya başka bir bildirim türü sırasında kullanıcıya hizmet şartlarınızı göstermeniz gerekebilir.
- Sizinle hesabı olan kullanıcıların bu hesapla oturum açtığından emin olmak istiyorsunuz. Örneğin, bir bağlılık programı sunuyorsanız ve hesaplarında biriken puanları kaybetmesini istemiyorsanız kullanıcıların mevcut hesaplarını kullanmaya devam etmesini isteyebilirsiniz.
Yetkilendirme kodu akışını mı örtülü akışı mı kullanmak istiyorsunuz?
Yetkilendirme kodu akışı ile örtülü akış, yetkilendirme kodu akışının ikinci bir uç nokta olan jeton değişimi uç noktasını gerektirmesinden farklıdır. Bu uç nokta, kullanıcının tekrar oturum açmasını istemeden yeni ve kısa ömürlü erişim jetonları oluşturmak için yenileme jetonları kullanır.
Öte yandan, örtülü akışı kullanırsanız Google'a genellikle yeniden oluşturulması gerekmeyen uzun ömürlü bir erişim jetonu verirsiniz. Yetkilendirme kodu ve örtülü akışlar hakkında daha fazla bilgi edinmek için OAuth ve Google ile Oturum Açma kavram rehberini inceleyin.
Google, daha güvenli olduğu için İşleminizde yetkilendirme kodu akışını kullanmanızı önerir. Ancak hizmetiniz gizli bilgileri (ör. istemci gizli anahtarı) depolayamıyorsa bunun yerine dolaylı akışı kullanın. Örneğin, tek sayfalık uygulamalar (SPA'lar) gibi herkese açık istemciler için dolaylı akışı kullanmanız gerekir.
Bu karar noktalarını değerlendirdikten sonra aşağıdaki karar ağacına başvurun:
Google ile Oturum Açma
GSI bağlantı türü sayesinde İşleminiz, görüşme sırasında kullanıcınızın Google profiline erişim izni isteyebilir ve kullanıcının hizmetinizin arka ucunda olup olmadığını kontrol etmek için profil bilgilerini kullanabilir. Kullanıcı mevcut değilse Google profil bilgilerini kullanarak sisteminizde yeni bir hesap oluşturabilir.
GSI için sesli hesap oluşturma özelliğini etkinleştirmeniz gerekir. Bu özellik, kullanıcının tüm akışı ses üzerinden tamamlamasını sağlar. GSI hakkında daha fazla bilgi için Google ile Oturum Açma kavram rehberine bakın.
OAuth
OAuth bağlantı türünde, kullanıcı standart OAuth 2 akışıyla oturum açar. OAuth bağlantı türü, endüstri standardı olmak üzere iki OAuth 2.0 akışını destekler: dolaylı ve yetkilendirme kod akışları.
Kullanıcı ekransız bir cihaz kullanıyorsa Google, oturum açma işlemini tamamlamak için kullanıcıyı sesten ekrana aktarmayı gerektirdiğinden OAuth bağlantı türünün tek başına kullanılmasını önermez. Mevcut bir OAuth 2 sunucusu uygulamanız varsa ve jeton değişimi uç noktasını Google'ın kimlik jetonundan otomatik bağlantı ve hesap oluşturma protokollerini destekleyecek şekilde genişletemiyorsanız bu akışı kullanabilirsiniz. Daha fazla bilgi için OAuth kavram rehberini inceleyin.
Akışı hassaslaştırın
İşleminizde OAuth hesap bağlama türünü kullandığınızda, nasıl çalıştığını tanımlamak için Actions konsolunda aşağıdaki sorunun yanıtını belirtmeniz gerekir:
Yetkilendirme kodu akışını mı örtülü akışı mı kullanmak istiyorsunuz?
OAuth bağlantı türü, endüstri standardı olmak üzere iki OAuth 2.0 akışını destekler: dolaylı ve yetkilendirme kod akışları. Yetkilendirme kodu akışı ve örtülü akış, yetkilendirme kodu akışının ikinci bir uç nokta olan jeton değişimi uç noktasını gerektirmesinden farklıdır. Bu uç nokta, kullanıcının tekrar oturum açmasını istemeden yeni ve kısa ömürlü erişim jetonları oluşturmak için yenileme jetonları kullanır.
Öte yandan, örtülü akışı kullanırsanız Google'a genellikle yeniden oluşturulması gerekmeyen uzun ömürlü bir erişim jetonu verirsiniz. Yetkilendirme kodu ve örtülü akışlar hakkında daha fazla bilgi edinmek için OAuth kavram kılavuzunu inceleyin.
Google, daha güvenli olduğu için İşleminizde yetkilendirme kodu akışını kullanmanızı önerir. Ancak hizmetiniz gizli bilgileri (ör. istemci gizli anahtarı) depolayamıyorsa bunun yerine dolaylı akışı kullanın. Örneğin, tek sayfalık uygulamalar (SPA'lar) gibi herkese açık istemciler için dolaylı akışı kullanmanız gerekir.