Google Chat uygulamalarını yayınlama

Bir Chat uygulaması oluşturduktan sonra bunu, belirli kişiler veya gruplar, Google Workspace kuruluşunuzdaki herkes veya Google Workspace hesabı olan herhangi bir Google Chat kullanıcısı tarafından kullanılabilmesi için yayınlayabilirsiniz.

Not: Bu sayfada, Google Cloud Console'u kullanarak Chat uygulamalarını nasıl yayınlayacağınız açıklanmaktadır. Chat uygulamanızı Google AppSheet'in otomatik yapılandırmasıyla oluşturduysanız Chat uygulamanızı yayınlamak için Google Cloud Console'u kullanmanız gerekmez. Bunun yerine, Chat uygulamanızı otomatik yapılandırma kullanarak paylaşın bölümünde açıklanan adımları uygulayın.

Kullanıcılar Google Chat uygulamalarını nasıl keşfeder ve kullanır?

Kullanıcılar Chat uygulamalarını birkaç farklı şekilde keşfedebilir ve kullanmaya başlayabilir:

• Google Chat'te uygulama arama
• Chat alanına eklenen bir uygulamayla etkileşim
• Bir Google Workspace yöneticisi uygulamayı kendi adına yükledikten sonra uygulamayı doğrudan mesaj panelinde keşfetmek.

Bir uygulamayı kullanmaya başlamak için Google Chat kullanıcıları, uygulamayla doğrudan mesaj başlatabilir veya aşağıda gösterilen önerilen alıcı listesinden uygulamayı bir alana ekleyebilirler:

Ayrıca kullanıcılar, uygulamadan @bahsederek önerilen alıcı listesini daraltabilirler. Örneğin, "Planlayıcı Bot" adlı bir uygulama yayınlar ve kuruluşunuzdaki bir kullanıcı "@sch" yazarsa Google Chat, uygulamanızı otomatik tamamlama seçeneklerinden biri olarak önerir.

Alternatif olarak Google Workspace yöneticileri, Google Workspace Marketplace'te Chat uygulamalarını bulabilir ve uygulamaları kuruluşlarındaki kullanıcılar için yükleyebilir. Yöneticiler bir Chat uygulaması yüklediğinde, uygulama kullanıcıların doğrudan mesajlar panelinde görünür.

Google Workspace yöneticileri, Google Workspace kuruluşlarında Chat uygulamalarının kullanımını da yönetebilir ve izin verilenler listesine ekleyebilir. İzin verilenler listeleri kullanan bir kuruluş için Chat uygulaması geliştiriyorsanız kullanıcıların uygulamayı bulup kullanabilmesi için yöneticiden Chat uygulamanızı izin verilenler listesine eklemesini istemeniz gerekir. Daha fazla bilgi için Kullanıcıların Chat uygulamalarını yüklemesine izin verme başlıklı Google Workspace Yönetici Yardımı dokümanlarına göz atın.

Google Cloud Console'u kullanarak Chat uygulamanızı yapılandırma ve yayınlama

Chat uygulamanızı yayınlamak ve diğer kullanıcıların kullanımına sunmak için genellikle aşağıdaki adımları uygulamanız gerekir:

1. Google Chat API'yi etkinleştirin ve yapılandırın. API'yi yapılandırdığınızda diğer Google Chat kullanıcılarının test için Chat uygulamanıza erişmesine izin verirsiniz.
2. Uygulamanızı Google Workspace Marketplace SDK'sı ile yayınlayın. Chat uygulamanızı Google Workspace kuruluşunuzdaki kullanıcılar veya tüm Google Chat kullanıcıları tarafından kullanılabilir olacak şekilde yapılandırabilirsiniz.
3. Chat uygulamalarına erişimi Google Workspace kuruluşunuz yönetiyorsa Google Workspace yöneticinizin uygulamayı kuruluşun izin verilenler listesine eklemesini isteyin.

Chat uygulamanız için görünürlük ve yayınlama ayarları

Aşağıdaki tabloda, Google Chat API ve Google Workspace Marketplace SDK'sı ayarlarının Chat uygulamanızın kitlesine göre nasıl yapılandırılacağı açıklanmaktadır:

. . . .

Bir Chat uygulaması geliştiriyorum...	Kimlik doğrulama yöntemi	Google Chat API ayarları	Google Workspace Marketplace SDK ayarları	Chat uygulamam nerede yayınlanır?
...Küçük ekibim için	Kullanıcı veya uygulama olarak kimlik doğrulayın.	Görünürlük ayarından uygulamaya erişebilecek kişileri ve/veya Google gruplarını belirtin. Google Workspace hesabınız, uygulamaların izin verilenler listesine eklenmesini gerektiriyorsa en fazla 5 ayrı e-posta adresi belirtebilirsiniz (Google Gruplar'ı belirtemezsiniz).	Chat uygulamanız için Google Workspace Marketplace SDK'sını yapılandırmanız gerekmez.	Ekip üyeleri, Chat uygulamanızı Google Chat'te bulabilir ve kullanabilir.
Büyük ekibim için	Kullanıcı veya uygulama olarak kimlik doğrulayın.	Görünürlük ayarında, Chat uygulamanızı test etmek için kişileri ve/veya Google Grupları'nı belirtin. Testten sonra, Google Workspace Marketplace SDK'sındaki ayarları kullanarak Chat uygulamanızı Google Workspace kuruluşunuza yayınlayın.	Uygulama görünürlüğü'nü Gizli olarak ayarlayın. Yükleme ayarları'nı Bireysel + Yönetici olarak ayarlayın. Google Workspace hesabınız uygulamaların izin verilenler listesine eklenmesini zorunlu tutuyorsa yöneticilerin uygulamayı bulabilmesi ve kullanabilmesi için Chat uygulamanızı izin verilenler listesine eklemesini isteyin. Daha fazla bilgi için Kullanıcıların Chat uygulamalarını yüklemesine izin verme başlıklı makaleyi inceleyin.	Google Workspace kuruluşunuzdaki herkes Google Chat'te Chat uygulamanızı bulup yükleyebilir ve uygulamanızı Google Workspace Marketplace'te görüntüleyebilir. Kullanıcılar ve Google Workspace yöneticileri, uygulamanızı Marketplace'ten yükleyebilir.
...Google Workspace kuruluşum için	Kullanıcı veya uygulama olarak kimlik doğrulayın.	Görünürlük ayarında, Chat uygulamanızı test etmek için kişileri ve/veya Google Grupları'nı belirtin. Testten sonra, Google Workspace Marketplace SDK'sındaki ayarları kullanarak Chat uygulamanızı Google Workspace kuruluşunuza yayınlayın.	Uygulama görünürlüğü'nü Gizli olarak ayarlayın. Yükleme ayarları'nı Bireysel + Yönetici olarak ayarlayın.	Google Workspace kuruluşunuzdaki herkes Google Chat'te Chat uygulamanızı bulup yükleyebilir ve uygulamanızı Google Workspace Marketplace'te görüntüleyebilir. Marketplace'ten uygulamanızı yalnızca Google Workspace yöneticileri yükleyebilir.
...Herkes için (herkese açık Chat uygulaması)	Uygulama olarak kimlik doğrulayın.	Görünürlük ayarında, Chat uygulamanızı test etmek için kişiler ve/veya Google Grupları'nı belirtin. Testten sonra, Google Workspace Marketplace'teki ayarları kullanarak Chat uygulamanızı herkese açık olarak yayınlayın.	Uygulama görünürlüğü'nü Herkese açık olarak ayarlayın. Yükleme ayarları'nı Bireysel + Yönetici olarak ayarlayın.	Tüm Google Workspace kullanıcıları, Chat uygulamanızı Google Chat'te bulup yükleyebilir ve uygulamanızı Google Workspace Marketplace'te görüntüleyebilir. Marketplace'ten uygulamanızı yalnızca Google Workspace yöneticileri yükleyebilir.

Google Chat API'yi etkinleştirme ve yapılandırma

Google API Console bölümünde uygulamanız için bir proje oluşturun ve Google Chat API'yi etkinleştirin.

1. Aşağıdaki düğmeyi kullanarak yeni bir proje oluşturun (veya mevcut bir projeyi seçin) ve bu hesaba bir hizmet hesabı ekleyin. Hizmet hesabına Proje Sahibi rolü verin.
   API'yi etkinleştirme
2. İndirilen JSON anahtarını kaydedin. Uygulamanız, alanlara eşzamansız olarak gönderdiği iletilerin kimliğini doğrulamak için bu anahtarı kullanabilir.
3. API Console bölümünde projenizi açın. API listesinde Google Chat API'yi tıklayın.
4. Yapılandırma sekmesini seçin ve uygulamayla ilgili bilgileri aşağıdaki tabloda açıklandığı şekilde girin.

Uygulama yapılandırmasını kaydettiğinizde uygulamanız Google Workspace kuruluşunuzdaki belirtilen kullanıcılar tarafından kullanılabilir hale gelir.

Google Chat API yapılandırma ayarları

Alan	Açıklama
Uygulama adı	Kullanıcıların uygulamanızla etkileşime girerken kullandığı ad.
Avatar URL'si	Uygulamanızın avatarı olarak görünecek, en az 128x128 boyutunda kare grafik resmi (ör. PNG veya JPEG) işaret eden bir HTTPS URL'si.
Açıklama	Uygulama adının altında gösterilen uygulama işlevselliği açıklaması.
İşlevler	Uygulamayı hangi etkinliklerin tetikleyebileceğini belirleyen alanlar grubudur: 1:1 mesajları alma: Kullanıcılar uygulamayı doğrudan Google Chat'te bulabilir ve mesaj gönderebilir. Yönetici kurulumundan etkinlik al: Bir Google Workspace yöneticisi, uygulamayı kuruluşuna yüklediğinde veya kaldırdığında Chat'ten ADDED_TO_SPACE ya da REMOVED_FROM_SPACE etkinlikleri alabilir. Saniye başına daha yüksek sorgularla sonuçlanabileceğinden, varsayılan olarak uygulama bu etkinlikleri almak için kaydolmadığınız sürece bu etkinlikleri almaz. Alanlara ve grup görüşmelerine katılma: Uygulama, alanlara ve grup görüşmelerine eklendiklerinde bu alana ve grup görüşmelerine katılabilir.
Bağlantı ayarları	Aşağıdakilerden biri olan, uygulamanın uç noktası: Uygulama URL'si: Uygulama uygulamasının barındırıldığı bir HTTPS uç noktasıdır. Apps Komut Dosyası projesi: Bir uygulamayı uygulayan Apps Komut Dosyası projesinin dağıtım kimliği. Cloud Pub/Sub konu adı: Uygulamanın uç nokta olarak abone olduğu Cloud Pub/Sub konusu. Dialogflow: Uygulamayı bir Dialogflow entegrasyonuyla kaydeder. Daha fazla bilgi için Google Chat entegrasyonuyla ilgili Dialogflow belgelerini inceleyin.
Slash komutları	Google Chat'te kullanıcılara gösterilebilecek komutlar. Kullanıcıların Google Chat'te uygulamanızla ilgili temel işlemleri görmesine ve etkileşim kurmak istediği belirli bir işlemi seçmesine olanak tanır.
Bağlantıyı açma	Uygulamanın tanıdığı ve kullanıcıların bağlantı gönderdiği durumlar için ek içerik sağlayan URL kalıpları Daha fazla bilgi için Bağlantıları çözme bölümünü inceleyin.
Görünürlük	Chat uygulamanızı görüntüleyip yükleyebilecek en fazla 5 kişi veya bir Google Grubu. Uygulamanızı test etmek veya uygulamayı ekibinizle paylaşmak için bu alanı kullanın. Daha fazla bilgi edinmek için Chat uygulamanız için görünürlük ve yayınlama ayarları başlıklı makaleyi inceleyin.

Uygulama yapılandırma izinleri verme

Belirli kullanıcılara uygulama yapılandırma sayfasına erişim izni verebilirsiniz. Bunu yapmak için Sohbet uygulamaları Sahibi ve Sohbet uygulamaları görüntüleyicisi IAM rollerini kullanın. Bu rollere sahip kullanıcılar, API'ler ve Hizmetler kontrol paneli aracılığıyla uygulama yapılandırma sayfasına gidemez ancak projeleri için konsola giderek aşağıdaki şekilde yapılandırma sayfasına erişebilir:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id

Proje rollerine sahip kullanıcılar da uygulama yapılandırma sayfasına erişebilir.

resourcemanager.projects.(get|update) izinlerini içeren özel rollere sahip kullanıcılar uygulama yapılandırmasına erişemez. Özel roller için bunun yerine chat.apps.(get|update) izinlerini kullanın.

Uygulamanızı Google Workspace Marketplace SDK'sı ile yayınlama

Google Workspace Marketplace SDK'sını kullanarak şunları yapabilirsiniz:

• Uygulamanızı herkese açık olarak yayınlayın ve Google Chat kullanıcılarının Chat uygulamanızı bir alana eklemesine izin verin.
• Uygulamanızı kendi alanınızda yayınlayın.
• Google Workspace yöneticilerinin uygulamayı kuruluşlarındaki kullanıcılara yükleyebilmesi için uygulamanızı görünür hale getirin. Google Workspace yöneticilerinin görebilmesi için uygulamanızda doğrudan mesajlaşma özelliği bulunmalıdır.

Uygulamanızı Google Workspace Marketplace SDK'sını kullanarak yayınlamadan önce aşağıdaki adımları izleyin:

1. Chat'ten yükleyerek Chat uygulamanızı test edin. Uygulamanızın tamamen çalışır durumda olduğundan ve devam eden bir çalışma olmadığından emin olun.
2. Yayınlama şartlarını inceleyin ve uygulamanızın tüm şartları karşıladığını doğrulayın. İnceleme alanları başlıklı makaleyi inceleyin.
3. Uygulamanızın sürüm numarasını kaydedin. Bu, Google Workspace Marketplace SDK'sını yapılandırmak için gereklidir.

Yayınlamaya hazır olduğunuzda Genel Bakış: Uygulama yayınlama başlıklı makaleyi inceleyin.

Chat uygulamanızı devre dışı bırakma

Not: Chat uygulamanızı AppSheet'in otomatik yapılandırmasını kullanarak oluşturduysanız AppSheet dokümanlarındaki Chat uygulamalarını devre dışı bırakma bölümündeki adımları uygulayarak uygulamanızı devre dışı bırakın.

Yapılandırma sayfasını kaydettikten sonra bir Uygulama Durumu alanı görünür. Bu alan, uygulamanın Canlı veya Devre dışı olup olmadığını kontrol etmenizi sağlar.

Bir Chat uygulamasını devre dışı bırakmak için:

1. Google Cloud Console'u açın.
2. Gerekirse Chat uygulamasını barındıran Google Cloud projesini seçin:
   1. "Google Cloud"un yanındaki aşağı oku tıklayın. Mevcut projeleri listeleyen bir iletişim kutusu görünür.
   2. Taşınan Chat uygulamasını barındıran projeyi seçin.
   3. Aç'ı tıklayın.
3. "Google Chat API"yi arayın ve Google Chat API'yi tıklayın.
4. Yönet'i tıklayın.
5. Yapılandırma'yı tıklayın.
6. "Uygulama durumu" bölümünde Devre dışı'nı seçin.
7. Kaydet'i tıklayın.