Sohbet İşlemleri, 13 Haziran 2023'te kullanımdan kaldırılacak. Daha fazla bilgi için Görüşme İşlemleri'nin kullanımdan kaldırılması başlıklı makaleyi inceleyin.

İşleminizi yayınlamak için hazırlanın

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

İşleminizi kullanıcılara yayınlamadan önce ayrıntılı olarak test etmeniz, hedef yüzeyleri, konumları ve cihazları belirtmeniz ve Google'ın Eylemler Politikası'na uyduğunu doğrulamanız gerekir. Bu sayfada, Action'larınızı incelenmek üzere göndermeye hazırlanırken gerçekleştirmeniz gereken görevlere genel bir bakış sunulmaktadır. Açıklamanın Beta veya Üretim kanallarına yayınlanması konusunda onay alın.

Politika ihlallerini kontrol edin

İşleminizin Actions on Google politikalarına uygun olduğunu doğrulayın. Genel olarak içeriğiniz için aşağıdaki yönergeleri izleyin:

  • Net olun: Kullanıcılar özellikle İşleminizi başlatabilmelidir. Görünen adı veya telaffuzu seçerken çok geniş veya genel olmayın. Örneğin, İşlem ifadesi olarak "[şehir] için hava durumunu kontrol edin" yerine "[şehir] için hava durumunu kontrol etmek" kullanın. İyi işlem ifadeleri sağlama yönergelerini uygulayın.
  • Yasaklanmış içeriklerden kaçının: Bilimsel, sanatsal, belgesel veya eğitsel bir amaç taşımadığı sürece açıkça cinsel, şiddet barındıran, yasa dışı veya nefret söylemi barındıran Action'lar, Actions on Google politikalarını ihlal eder. Zorbalık veya tacizi teşvik eden işlemler de reddedilir veya kaldırılır.
  • Telif haklarına ve fikri mülkiyet haklarına saygı gösterin: İşleminizin sunduğu içeriği kullanmak için yeterli haklara sahip olduğunuzdan emin olun.
  • Dürüst olun: Yanlış iddialarla kullanıcıları yanlış yönlendirmeyin veya aldatmayın.
  • Kullanıcıların gizliliğini ve güvenliğini koruma: Kullanıcı verilerini ele alma, kullanıcı verilerini güvenli bir şekilde iletme ve gizlilik politikası sağlama konusunda şeffaf olun.
  • İzin verilmeyen kullanıcıları dinleme: İşleminizin ne zaman girileceğini öğrenmek için kullanıcıların bunu anlaması gerekir. Kullanıcıya sormadan mikrofonu açık bırakmak, politikalarımızda ana hatlarıyla açıklanan yaygın bir hatadır. Bir komut beklerken İşleminizin reddedilme riskini azaltmak için İşleminizin kullanıcıyı bilgilendirdiğinden emin olun.
  • Çağrı ve görünen adlarınızı inceleyin: Asistan adınızın, Asistan dizin sayfanızda görünen görünen adla tutarlı olduğundan emin olun. Her iki adın da kullanıcıların İşleminizi kolayca çağırabileceği kadar spesifik olduğundan emin olun. Çağrı ve görünen adlarınız, Actions on Google politikalarına da uygun olmalıdır.

İşleminizin incelenmesi ve onaylanmasını hızlandırmak için politikaların tam listesini inceleyin ve bunlara uyduğunuzdan emin olun.

Görünen adı ayarla

Görünen ad, kullanıcıların İşleminizi açıkça nasıl çağırdığını tanımlar. Bu ad aynı zamanda Asistan dizininde de kullanılır.

Görünen adınızı ayarlamak için aşağıdaki adımları uygulayın:

  1. Geliştirme > Çağrı > Ayarlar bölümüne gidin.
  2. İşleminizin görünen adını girin.
  3. Adın nasıl telaffuz edildiğini duymak için Oynat simgesini tıklayın.

Actions Console'da görünen ad seçeneğinin ekran görüntüsü

Görünen adınızı değiştirin

İşleminizin görünen adını dilediğiniz zaman değiştirebilirsiniz. Ancak kullanıcıların yeni adla İşleminizi başlatabilmesi için İşleminiz başka bir tam inceleme sürecinden geçer.

İsteğe bağlı: Konum hedeflemeyi belirtme

Kullanıcının cihazının yerel ayarı "İngilizce" olarak ayarlandığı sürece İşleminiz varsayılan olarak tüm bölgelerde kullanılabilir (ör. Amerikan İngilizcesi veya İngiliz İngilizcesi).

Konum hedefleme ayarı, işleminiz için bölgesel kullanılabilirliği kontrol eder.

Yer hedefleme seçeneklerinin ekran görüntüsü

Yerelleştirilmiş yayınlama hakkında daha fazla bilgi edinin.

İsteğe bağlı: Yüzey özelliklerini belirtin

İşleminiz telefonlar (Android ve iOS) ve akıllı ekranlar gibi Asistan'ın desteklediği çeşitli yüzeylerde görünebilir.

Yüzey özellikleri, kullanıcıların kullandıkları yüzeye bağlı olarak işleminizi başlatıp başlatamayacağını kontrol etmenize olanak tanır. Kullanıcılar, Action'ınızı desteklenmeyen bir yüzeyde çağırmaya çalışırsa cihazlarının desteklenmediğini belirten bir hata mesajı alır.

Yüzey seçenekleri seçeneklerinin ekran görüntüsü

Yüzey özellikleri hakkında daha fazla bilgi edinin.

İsteğe bağlı: Etkileşimli Tuval seçeneklerini belirtme

İşleminiz Etkileşimli Tuval kullanıyorsa sol gezinme bölmesindeki Geliştirme > Etkileşimli Tuval altında birkaç seçeneği etkinleştirip ayarlamanız gerekir.

  1. İşleminizle Etkileşimli Tuval'i kullanma seçeneğini etkinleştirin.
  2. İşleminizin görsellerini barındıran web uygulamasının URL'sini girin.

Simülasyon aracıyla test etme

İşleminizi yayınlamadan önce simülasyon aracını kullanarak İşleminizin kullanıcı deneyimini test edin ve her şeyin çalıştığından emin olun.

Sık karşılaşılan hata ve ihlalleri kontrol edin:

  • Webhook aktarımı güvenli olmalıdır: Web kancalarınız için taşıma işleminde HTTPS (TLS) şifrelemesi kullandığınızı doğrulayın.
  • Webhook isteklerini doğrulama: Webhook isteklerinizi Actions SDK'yı kullanarak imzaladığınızdan ve webhook'unuzda doğruladığınızdan emin olun.
  • İşlem adınızı test edin: Belirlediğiniz İşlem adının tutarlı bir şekilde İşleminizi tetiklediğinden emin olun. Bir donanım cihazı veya web simülatörünü kullanın ve çağrı adınızı farklı gerçek senaryolarda tekrar edin (ör. arka planda gürültüyle veya cihazdan farklı mesafelerde). Mümkünse farklı cinsiyetlere veya farklı aksanlara sahip kişilerden harekete geçmenizi isteyin. Çağrı adınız tutarlı bir şekilde tanınmıyorsa adını değiştirmek isteyebilirsiniz.
  • Fiziksel cihazlarda test etme: Web simülatörü, geliştirme sırasında İşleminizi hızlı bir şekilde test etmek için mükemmel olsa da her zaman çağrıları ve iletişim kutularını gerçek cihazlarda test etmeniz gerekir. Bu, İşleminizin gerçek hayatta nasıl çalıştığını anlamanın ve kullanıcı deneyimini iyileştirmenize yardımcı olmanın en iyi yoludur.

Mevcut Actions proje taslağınızı test etmek için ana gezinme menüsünde Test'e gidin. Bu sayede Simülatör, konsol ve Asistan özellikli cihazlarda İşleminizin mevcut sürümü kullanılabilir.

Actions Console simülasyon aracının ekran görüntüsü

İşlem simülatörü hakkında daha fazla bilgi edinin.

Projenizi yayınlama

Proje taslağınızı test ettikten ve sonuçlarından memnun kaldığınızda, ek test için Alfa veya Beta kanallarına dağıtabilirsiniz. Alternatif olarak, incelenmesi ve Asistan kullanıcılarına yayınlanması için gönderebilirsiniz.

Konsolun Dağıt > Sürüm bölümünde sürümler için aşağıdaki seçenekleri görürsünüz:

  • Alfa: En iyi sonuç, hızlı test yinelemeleri için kullanılır. İşleminiz, Google incelemesinden geçmeden tanımladığınız küçük bir kullanıcı grubuna dağıtılır.
  • Beta: En iyi Google incelemesinden sonra İşleminizi sınırlı sayıda kullanıcıya dağıtmak için kullanılır. İşlem tam bir incelemeden geçtiği için dilediğiniz zaman herkese açık olarak ayarlayabilirsiniz.
  • Üretim: İşleminizi tam Google incelemesi için gönderir. İşlem onaylandıktan sonra Asistan kullanıcıları Asistan'ı kullanabilir.

Yayınlar hakkında daha fazla bilgi edinin.

Dağıtım durumu

Aşağıdaki tabloda bir projenin farklı dağıtım durumları ve uygulamanız gereken ek adımlar açıklanmaktadır:

Dağıtım durumu Açıklama
İnceleniyor

Yeni dağıtım gönderdiğinizde bu onay sürecinden geçer. İncelemeciler İşleminizi test eder ve herhangi bir politikayı ihlal etmediğinizi doğrular. İnceleme tamamlandığında dağıtımınızın onaylanıp onaylanmadığını bildiren bir e-posta alırsınız.

Reddedildi Durumun reddedilmesi, dağıtımınızın onaylanmadığı anlamına gelir. Dağıtımınızın neden reddedildiğini açıklayan bir e-posta alırsınız. Reddetme nedenini görmek için konsoldaki Reddedildi durumunun yanındaki Neden? seçeneğini de tıklayabilirsiniz.
Dağıtıldı Etkin ve kullanıcılara sunulmakta olan onaylanmış bir işlem. Dağıtılmış bir sürümü dilediğiniz zaman konsoldan "yayından kaldırabilirsiniz".
Onaylandı İncelemeyi geçen ve şu anda kullanıcılara sunulmayan bir işlem. Bir işlem zaten başarılı bir şekilde incelenmişse ek bir inceleme olmadan herhangi bir anda konsoldan serbest bırakılabilir.
Sağlıksız

Google, İşleminizin uç noktasına düzenli olarak istek gönderir ve uygun yanıtı alıp almadığımızı kontrol eder. Uç noktanızın devre dışı olduğunu veya yanıt vermediğini tespit edersek İşleminizi kullanıcılara sunmayı geçici olarak durdururuz.

Bu durumda, uç noktanızın sağlıksız olduğunu ve İşleminizin sağlıksız durumuna taşındığını bildiren bir e-posta alırsınız. Uç noktanızın tekrar duyarlı olduğunu tespit eder etmez İşleminizi kullanıcılara sunmaya devam edeceğiz. Bu durumda bir e-posta alırsınız ve dağıtımınızın durumu Dağıtıldı durumuna döner.

Kaldırıldı

Dağıtımdan sonra politika ihlali tespit edilirse Google İşleminizi kaldırabilir.

Böyle bir durumda e-posta alırsınız. Ayrıca, geliştirici konsolunda İşleminizin kaldırıldığını bildiren bir banner görürsünüz. Gerekçesini görmek ve politika ihlalini düzeltme veya karara itiraz etme seçeneklerinizi görmek için Neden? seçeneğini tıklayabilirsiniz.

Projenize sürüm oluşturma

İşleminizle ilgili bilgileri zaman içinde güncelleyebilirsiniz. Bir işlemde yapılan bazı değişiklikler projenizin yeni bir sürümüyle sonuçlanır. Güncellenen İşlemin yayınlanmadan ve herkese sunulmadan önce her yeni sürümün yeniden gönderilmesi ve tüm inceleme sürecinden geçmesi gerekir.

Aşağıdaki değişikliklerden herhangi birini yapmak için bir İşlemi incelenmesi için yeniden göndermeniz gerekir:

  • Konsolda projenin açıklamasını, simgesini veya diğer meta verilerini değiştirmek için değişiklik yapılır.
  • Actions Builder veya Actions SDK'yı kullanarak Actions projenizde değişiklik yaptınız.
  • Eski Actions SDK'yı kullanarak İşlem paketinizde değişiklikler yaptınız.
  • Dialogflow'u kullanarak Dialogflow aracınızda değişiklikler yaptınız.

Aşağıdaki durumlar için projenizi yeniden göndermeniz gerekmez:

  • Kodunuzda yalnızca harici olarak barındırılan bir webhook'ta, Actions Builder'da satır içi webhook düzenleyicisinde veya Dialogflow'un satır içi düzenleyicisinde değişiklik yapmışsınızdır.
  • Şablonlar özelliğini kullanıyorsunuz ve şablon verilerinizi Google E-Tablolar'a içerik yükleyerek güncelliyorsunuz.

Güncellenen İşleminizi incelemeye göndermek için Dağıt > Sürüm'e gidin ve Sürüm oluştur'u tıklayın. Onaylanırsa önceki sürümün dağıtımı kaldırılır ve İşleminizin son sürümü Asistan kullanıcılarına sunulur.

Sürümleri izleme ve değiştirme

Sürümlerinizle ilgili bilgileri izlemek ve almak için Dağıt > Sürüm bölümüne gidin ve hakkında bilgi edinmek istediğiniz sürümü tıklayın.

Daha önce yayınlanan sürümleri gösteren İşlemlere genel bakış sayfasının ekran görüntüsü

Tabloda, son değiştirilme tarihi ve sürümün mevcut durumu gösterilir. Sürümün mevcut durumuna bağlı olarak durum üzerinde belirli değişiklikler yapabilirsiniz.

  • İncelenmekte olan bir sürümü incelemekten geri çekmeyi seçebilirsiniz.
  • Bir sürüm dağıtıldıysa işleminizi yayından kaldırmak için Dağıtımı kaldır'ı seçebilirsiniz.
  • Eski bir sürümün dağıtımı kaldırıldığında, söz konusu sürüme geri dönmek için Üretim sürümüne dağıt'ı seçebilirsiniz.