Actions'ınıza bağlantı oluşturma (Dialogflow)

Her işlem için ayrı ayrı, doğrudan ilgili İşleme bağlantı veren bir URL oluşturabilirsiniz. Web'de veya mobil tarayıcıda Asistan bağlantısını (eski adıyla İşlem bağlantıları) tıklayan kullanıcılar, cihazlarında Asistan'a yönlendirilecek ve burada ilgili İşleminizle doğrudan etkileşim kuracak.

Faydalı Asistan bağlantılarına örnek olarak aşağıdakiler verilebilir:

Kullanıcıları bir "nasıl yapılır" web sitesindeki sesli talimatlara yönlendirerek.
"Yardım al" sayfasından kullanıcıları müşteri desteği deneyimine bağlama.
Gelecekteki güncellemelerinize kaydolabilmeleri için kullanıcıları bir güncelleme amacına bağlama.

Bir İşlemin URL'sini oluşturmak için aşağıdakileri yapın:

Actions Console'da Geliştirme > İşlemler'e gidin.
Bağlantı oluşturmak istediğiniz İşlemi tıklayın.
Bağlantılar bölümünün altında Bu İşlem için bir URL'yi etkinleştirmek ister misiniz? seçeneğini etkinleştirin.
Bir Bağlantı başlığı girin. Bu başlık, İşlem'in ne yapacağını açıklayan bir fiil içermelidir. Örneğin, İşleminiz kullanıcıyı bir konsere bilet satın almak için işlem akışından aşağı yönlendiriyorsa, yararlı bir bağlantı başlığı "konser bileti satın al" olabilir.
Kaydet'i tıklayın.

Sağlanan URL'yi kopyalayıp kullanıcıları bu İşleme yönlendirmek istediğiniz her yere referans verebilirsiniz.

Asistan bağlantısı parametreleri

Asistan bağlantıları isteğe bağlı olarak URL'de amaç ve parametreler içerebilir. Google, parametreleri URL'de belirtilen amaç türüne göre işler.

Asistan bağlantı URL'si spesifikasyonu

Asistan bağlantısının URL'si için genel söz dizimi şöyledir:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

Ayarlayabileceğiniz URL parametreleri aşağıdaki tabloda açıklanmıştır:

URL parametresi	Açıklama
`$action_id`	İşlemin sayısal tanımlayıcısı.
`$intent`	Yerleşik veya özel amacın tam adı.
`$param`	İşlem paketinde belirtilen bir amaç parametresinin tam adı.
`$value`	İşlem paketinde `$param` için bildirilen türün URL olarak kodlanmış değeri.
`$utm_param`	Bir veya daha fazla UTM parametresi türünün listesi. Geçerli değerler şunları içerir: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` ve `utm_content`.
`$utm_value`	UTM parametresinin dize değeri.

Yerleşik intent'leri olan Asistan bağlantı URL'leri

Asistan bağlantısı yerleşik amaç içeriyorsa (Niyet actions.intent.* ile başlar) Google, URL'deki yerleşik amaç parametrelerini çıkarıp İşleminize aktarmaya çalışır. Google'ın yerleşik amaç parametresi olarak anlamadığı tüm parametreler çıkarılır.

Google, etkileşimli işlemler için bu parametreleri AppRequest mesajının bir parçası olarak karşılamanıza gönderir.

Aşağıdaki örnekte, tek bir intent parametresine sahip yerleşik intent içeren bir Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

Özel amaçlı Asistan bağlantı URL'leri

Özel amaçlar için Google yalnızca İşleminiz tarafından amacın bir parçası olarak tanımlanan parametreleri çıkarır ve diğer tüm parametreleri siler.

Aşağıdaki örnekte, özel amaç içeren bir Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

Yukarıdaki örnek URL için, AppRequest bölümüne Google aşağıdaki gibi bir JSON nesnesi ekler:

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

Asistan bağlantısı olmadan amaç içermeyen URL'ler

Asistan bağlantısında amaç belirtmezseniz Google, aşağıdaki davranışla varsayılan olarak İşleminizin MAIN amacına (actions.intent.MAIN) bağlantı verir:

Asistan bağlantısında MAIN amacını açıkça etkinleştirmediyseniz Google, "app_name ile konuş" davranışına benzer şekilde ana niyeti herhangi bir parametre olmadan tetikler.
MAIN amacını açık bir şekilde etkinleştirdiyseniz Google, parametreleri İşlemlerinize iletir.

Aşağıdaki örnekte, niyet olmadan Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

UTM parametreleriyle Asistan bağlantı URL'leri

UTM parametreleri, kullanıcılar bir Asistan bağlantısını tıkladığında Google'ın İşleminize gönderdiği ve daha sonra analiz için kullanabileceğiniz dizelerdir.

Google'ın İşleminize gönderdiği UTM parametreleri şunları içerir:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

Aşağıdaki örnekte, UTM parametrelerini içeren bir Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

Yukarıdaki örnek URL için Google, AppRequest mesajına aşağıdaki bağımsız değişkenleri ekler:

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

Asistan bağlantılarını test et

Herhangi bir amaç için (ana veya özel, parametre içeren veya içermeyen) Asistan bağlantılarını simülatör veya bir cihaz aracılığıyla test edebilirsiniz.

Asistan bağlantınızı test etmek için:

Konsolda Asistan bağlantısını etkinleştir.
Actions on Google projenizi oluşturmak için kullandığınız hesapla Asistan'da oturum açın.
Asistan bağlantınızın tıklanabilir bir sürümünü oluşturun (e-posta, sohbet, doküman vb.).
Asistan özellikli bir cihazda önceki adımda oluşturulan bağlantıyı tıklayın.

Asistan bağlantısının beklendiği gibi çalıştığını onayladıktan sonra, bağlantıyı kullanıcılarınıza sunmak için İşleminizi yeniden dağıtmanız gerekir.

Kısıtlamalar ve en iyi uygulamalar

Asistan bağlantı URL'niz artık dizinin veya diğer Google hizmetlerinin dışında dağıtılabileceği ve referans verilebileceği için aşağıdaki kısıtlamaların ve en iyi uygulamaların geçerli olduğunu lütfen unutmayın:

Tüm Asistan bağlantılarınızı desteklemeye devam ettiğinizden emin olun. Daha sonra çalışmayan bir Asistan bağlantısı dağıtırsanız Actions projeniz sağlıksız olarak işaretlenip kaldırılabilir.
Bağlantı yayınlamak, güvenilmeyen kaynaklardan tetiklemeyi desteklediğiniz anlamına gelir. Bağlı İşlemler için, "gerçek hayatta" bir işlem yapmadan önce kullanıcıyla bunu açıkça onaylamanız gerekir. Örneğin, akıllı ev cihazını kapatan bir İşlem, kullanıcıdan "$applianceName'i kapatmak istediğinizden emin misiniz?"

Bu bağlamda "gerçek dünyada yapılan işlemler", kullanıcının hizmetlerini, verilerini, cihazlarını, ağlarını, bilgisayarlarını veya API'lerini etkileyen herhangi bir eylemdir. Örneğin, e-posta gönderme, işlem gerçekleştirme, akıllı ev cihazının durumunu değiştirme, abonelik oluşturma veya bir içeriği güncelleme.