Google Workspace kuruluşlarını birleştirirseniz Chat uygulamanızın çalışmaya devam etmesi için taşımanız gerekebilir.
Chat uygulamanızı taşımadan önce, yönetim ayarlarının uygulamayı etkileyip etkilemediğini öğrenmek için kuruluşunuzun yöneticisiyle iletişime geçin. Bir yönetim ayarının değiştirilmesi, Chat uygulamanızın tüm işlevlerini geri yükleyebilir ve taşıma işlemini gereksiz hale getirebilir. Örneğin, Google Workspace yöneticinizin Chat uygulamanızı bir izin verilenler listesine eklemesi veya kullanıcıların Chat uygulamalarını yüklemesine izin vermesi gerekebilir. Daha fazla bilgi için Google Workspace kuruluşlarını birleştirdikten sonra Google Chat uygulamalarının taşınması gerekip gerekmediğini belirleme başlıklı makaleyi inceleyin.
Chat uygulamanızı taşımanız gerektiğine karar verdikten sonra, aşağıdaki üç adımlı işlemi tamamlayın:
- Birleştirilmiş kuruluşta bir Google Cloud projesi oluşturarak, API'leri etkinleştirerek ve OAuth 2.0 izin ekranını yapılandırarak Chat uygulamanızın ortamını ayarlayın.
- Yeni Cloud projesinden Chat uygulamanızı yeniden dağıtın.
- Yeniden oluşturulan Chat uygulamasını Chat alanlarına veya görüşmelerine ekleyip orijinal Chat uygulamasını kapatın.
Birleştirilmiş kuruluşta bir Cloud projesi oluşturun ve API'leri etkinleştirin
Birleştirilen Google Workspace kuruluşunda yeni bir Cloud projesinin oluşturulması ve Chat uygulaması için API'lerin etkinleştirilmesi, Chat uygulamasına erişmesine izin verdiğiniz kullanıcıların ve grupların bu işlemi hatasız olarak yapabilmesini sağlar.
Bulut projesi oluşturma
Google Cloud Console
- Google Cloud konsolunda Menü > IAM ve Yönetici > Proje oluştur'a gidin.
-
Proje Adı alanına projeniz için açıklayıcı bir ad girin.
İsteğe bağlı: Proje Kimliği'ni düzenlemek için Düzenle'yi tıklayın. Proje kimliği, proje oluşturulduktan sonra değiştirilemez. Bu nedenle, projenin ömrü boyunca ihtiyaçlarınızı karşılayan bir kimlik seçin.
- Konum alanında projeniz için potansiyel konumları görüntülemek üzere Göz at'ı tıklayın. Ardından Seç'i tıklayın.
- Create'i (Oluştur) tıklayın. Google Cloud Console, Kontrol Paneli sayfasına gider ve projeniz birkaç dakika içinde oluşturulur.
gcloud CLI
Aşağıdaki geliştirme ortamlarından birinde Google Cloud KSA'ya ("gcloud") erişin:
-
Cloud Shell: Halihazırda gcloud KSA bulunan bir online terminal kullanmak için Cloud Shell'i etkinleştirin.
Cloud Shell'i etkinleştir -
Yerel Kabuk: Yerel bir geliştirme ortamı kullanmak için gcloud KSA'yı yükleyin ve initialize.
Bulut projesi oluşturmak için "gcloud projects create" komutunu kullanın:
Oluşturmak istediğiniz projenin kimliğini ayarlayarak PROJECT_ID komutunu değiştirin.gcloud projects create PROJECT_ID
API'leri etkinleştir
Tüm Chat uygulamalarında Google Chat API'nin etkinleştirilmiş olması gerekir. Chat uygulamanızın nasıl oluşturulduğuna bağlı olarak başka API'leri etkinleştirmeniz gerekebilir. Örneğin, Google Cloud Functions'ı kullanarak Chat uygulamanızı oluşturduysanız Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API ve Cloud Run API'yi etkinleştirin. En iyi uygulama olarak, taşınan uygulamanın çalıştığından emin olmak için eski Cloud projesinde etkinleştirilen API'lerin aynılarını yeni Cloud projesinde de etkinleştirin.
Bir API'yi etkinleştirmek için şunları yapın:
Google Cloud Console
- Google Cloud Console'da Menü > Diğer ürünler > Google Workspace > Ürün Kitaplığı'na gidin.
- Etkinleştirmek istediğiniz API'yi tıklayın.
- Etkinleştir'i tıklayın.
- Daha fazla API etkinleştirmek için bu adımları tekrarlayın.
Google Cloud CLI
- Google Cloud Komut Satırı Arayüzünü (CLI) yükleyin veya açın.
-
Hangi API hizmetinin etkinleştirileceğini belirterek
services enablekomutunu çalıştırın.gcloud services enable API_SERVICE_ID
OAuth izin ekranını yapılandırın
Cloud projeniz için OAuth izin ekranını yapılandırmanız gerekebilir. Daha önce yetkilendirme için OAuth 2.0'ı kullandıysanız aynı yetkilendirme kapsamlarını kullanın.
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.
- Uygulamanızın kullanıcı türünü seçin, ardından Oluştur'u tıklayın.
- Uygulama kayıt formunu doldurun, ardından Kaydet ve Devam Et'i tıklayın.
Google Workspace kuruluşunuzun dışında kullanmak için bir uygulama oluşturuyorsanız Kapsam Ekle veya Kaldır'ı tıklayın. Kapsamları seçerken aşağıdaki en iyi uygulamaları izlemenizi öneririz:
- Uygulamanızın gerektirdiği minimum erişim düzeyini sağlayan kapsamları seçin. Kullanılabilir kapsamların listesi için Google API'leri için OAuth 2.0 Kapsamları bölümüne bakın.
- Şu üç bölümün her birinde listelenen kapsamları inceleyin: hassas olmayan kapsamlar, hassas kapsamlar ve kısıtlanmış kapsamlar. "Hassas kapsamlarınız" veya "Kısıtlanmış kapsamlarınız" bölümlerinde listelenen tüm kapsamlar için gereksiz ek incelemelerden kaçınmak amacıyla hassas olmayan alternatif kapsamlar belirlemeye çalışın.
- Bazı kapsamlar için Google'ın ek incelemesi gerekir. Yalnızca Google Workspace kuruluşunuz tarafından kullanılan uygulamalar için kapsamlar izin ekranında listelenmez. Kısıtlanmış veya hassas kapsamların kullanımı için Google'ın daha fazla inceleme yapması gerekmez. Daha fazla bilgi için Kapsam kategorileri bölümüne bakın.
- Uygulamanızın gerektirdiği kapsamları seçtikten sonra Kaydet ve Devam Et'i tıklayın.
- Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
- Test kullanıcıları'nın altında Kullanıcı ekle'yi tıklayın.
- E-posta adresinizi ve diğer yetkili test kullanıcılarını girip Kaydet ve Devam Et'i tıklayın.
- Uygulama kaydı özetinizi inceleyin. Değişiklik yapmak için Düzenle'yi tıklayın. Uygulama kaydı sorunsuz görünüyorsa Kontrol Paneline Dön'ü tıklayın.
Chat uygulamanızı yeni Cloud projesine yeniden dağıtma
Chat uygulamanızın Apps Komut Dosyası, AppSheet veya başka bir bağlantı türüyle (ör. Python ya da Java) derlenmiş olmasına bağlı olarak Chat uygulamanızın yeniden dağıtımı biraz farklılık gösterir. Her iki durumda da tüm kodunuzu yeniden oluşturmanız gerekmez ancak bazı değişiklikler yapmanız gerekir.
Chat uygulaması mantığını taşıyın
Chat uygulamanızın mimarisine bağlı olarak diğer hizmetleri yeni Cloud projesine taşımanız gerekebilir:
- HTTP uygulamaları için Cloud Functions, Cloud Run veya App Engine kullanılarak oluşturulan uygulama mantığının geri kalanını da taşımanız gerekir.
- Doğal dil kullanan etkileşimli Chat uygulamaları için Dialogflow aracılarını da taşımanız gerekir.
- Güvenlik duvarı arkasında derlenen Chat uygulamaları için Pub/Sub konularını da taşımanız gerekir.
Yeni Cloud projesinde Chat uygulamasını yapılandırın
Python veya Java gibi bir dille oluşturulmuş Chat uygulamanızı yeniden dağıtmak için yeni Cloud projenizde Chat uygulamasını yapılandırın.
Google Cloud konsolunda "Google Chat API" araması yapıp Google Chat API'yi, ardından Yönet'i tıklayın.
Configuration (Yapılandırma) sekmesini tıklayın ve aşağıdaki gerekli bilgileri girin:
- Uygulama adı: Kullanıcıların Chat uygulamanızla etkileşimde bulunurken kullandıkları ad.
- Avatar URL'si: Chat uygulamanızın avatarı olarak görünen ve en az 128x128 piksellik kare bir grafik resmi (ör. PNG veya JPEG) işaret eden bir HTTPS URL'si.
- Açıklama: Chat uygulamanızın adının altında görünen, Chat uygulamasının amaçlanan amacının açıklaması.
Etkileşimli özellikleri açmak için kullanıcıların Chat uygulamanızla etkileşim kurmasına olanak tanıyan Etkileşimli özellikleri etkinleştir seçeneğini tıklayın ve yapılandırmayı tamamlamak için aşağıdaki tabloyu kullanın:
Alan Açıklama İşlevler Chat uygulamasının kullanıcılarla nasıl etkileşimde bulunabileceğini belirleyen alanlar: - Bire bir mesajlar alma: Kullanıcılar, Chat uygulamasını doğrudan Google Chat'te bulup mesaj gönderebilir.
- Alanlara ve grup görüşmelerine katılma: Kullanıcılar, Chat uygulamasını alanlara ve grup görüşmelerine ekleyebilir.
Bağlantı ayarları Aşağıdakilerden biri olan Chat uygulaması için uç nokta: - Uygulama URL'si: Chat uygulamasının uygulanmasını barındıran HTTPS uç noktası.
- Apps Komut Dosyası projesi: Bir Chat uygulamasını uygulayan Apps Komut Dosyası projesinin dağıtım kimliği.
- Cloud Pub/Sub konu adı: Chat uygulamasının uç nokta olarak abone olduğu bir Pub/Sub konusu.
- Dialogflow: Chat uygulamasını bir Dialogflow entegrasyonuyla kaydeder. Daha fazla bilgi için Doğal dili anlayan bir Dialogflow Google Chat uygulaması oluşturma bölümüne bakın.
Slash komutları Google Chat'te kullanıcılara gösterilebilen komutlar. Kullanıcıların Google Chat'te Chat uygulamanızla ilgili temel işlemleri görmesine ve etkileşimde bulunmak istedikleri belirli bir işlemi seçmesine izin verir. Daha fazla bilgi edinmek için Eğik çizgi komutlarını Chat uygulaması olarak yanıtlama başlıklı makaleye bakın. Bağlantı önizlemeleri Kullanıcılar bağlantı gönderdiğinde Chat uygulamasının tanıdığı ve ek içerik sağladığı URL kalıpları. Daha fazla bilgi için Önizleme bağlantıları başlıklı makaleyi inceleyin. Görünürlük Chat uygulamanızı görüntüleyebilecek ve yükleyebilecek en fazla 5 kişi veya bir ya da daha fazla Google Grubu. Chat uygulamanızı test etmek veya Chat uygulamasını ekibinizle paylaşmak için bu alanı kullanın. Daha fazla bilgi edinmek için Chat uygulamanızın görünürlüğü ve yayınlama ayarları başlıklı makaleyi inceleyin. Chat uygulaması her hata döndürdüğünde hataları Cloud Logging'e kaydetmek için Hataları Logging'e kaydet onay kutusunu işaretleyin. Daha fazla bilgi edinmek için Chat uygulamaları için hata günlüklerini sorgulama bölümünü inceleyin.
Kaydet'i tıklayın. Chat uygulaması yapılandırmasını kaydettiğinizde Chat uygulamanız, Google Workspace kuruluşunuzda belirtilen kullanıcılar tarafından kullanılabilir.
Apps Komut Dosyası Chat uygulamasını yeniden dağıtma
Apps Komut Dosyası ile derlenen Chat uygulamanızı yeniden dağıtmak için Apps Komut Dosyası projesinin ilişkili olduğu Cloud proje numarasını, yeni Cloud projenize ait proje numarasıyla değiştirin. Ardından, Apps Komut Dosyası dağıtım kimliğinizi kopyalayıp Google Cloud Console'daki Chat uygulaması yapılandırma sayfasına yapıştırın.
Cloud proje numaranızı kopyalayın
- Google Cloud konsolunda Menü > IAM ve Yönetici > Ayarlar'a gidin.
- Proje numarası alanına değeri kopyalayın.
Apps Komut Dosyası projenizde Google Cloud proje numaranızı ayarlayın
Apps Komut Dosyası'na gidin.
Chat uygulamasının Apps Komut Dosyası projesinde Proje Ayarları'nı tıklayın.
Google Cloud Platform (GCP) Project (Google Cloud Platform (GCP) Projesi) bölümünde Change project (Projeyi değiştir) seçeneğini tıklayın.
GCP proje numarası alanına Google Cloud proje numarasını yapıştırın.
Proje ayarla'yı tıklayın.
Apps Komut Dosyası projenizin dağıtım kimliğini kopyalayın
- Apps Komut Dosyası'nın sağ üst tarafında Dağıt > Dağıtımları yönet'i tıklayın.
- Deployment ID (Dağıtım Kimliği) altında Kopyala'yı tıklayın.
- Done'ı (Bitti) tıklayın.
Chat uygulamanızı yeniden yapılandırma ve yeniden dağıtma
Google Cloud konsolunda "Google Chat API" araması yapıp Google Chat API'yi, ardından Yönet'i tıklayın.
Configuration (Yapılandırma) sekmesini tıklayın ve aşağıdaki gerekli bilgileri girin:
- Uygulama adı: Kullanıcıların Chat uygulamanızla etkileşimde bulunurken kullandıkları ad.
- Avatar URL'si: Chat uygulamanızın avatarı olarak görünen ve en az 128x128 piksellik kare bir grafik resmi (ör. PNG veya JPEG) işaret eden bir HTTPS URL'si.
- Açıklama: Chat uygulamanızın adının altında görünen, Chat uygulamasının amaçlanan amacının açıklaması.
Etkileşimli özellikleri açmak için, kullanıcıların Chat uygulamanızla etkileşim kurmasına olanak tanıyan Etkileşimli özellikleri etkinleştir seçeneğini tıklayın:
Bağlantı ayarları bölümünde Apps Komut Dosyası projesi'ni seçin.
Deployment ID (Dağıtım Kimliği) alanına, daha önce kopyaladığınız dağıtım kimliğini yapıştırın.
Yapılandırmanın geri kalanını tamamlamak için Chat uygulamasını yeni Cloud projesinde yapılandırma başlıklı makaledeki tabloya göz atın.
Kaydet'i tıklayın.
AppSheet Chat uygulamalarını yeniden dağıtma
AppSheet ile derlenmiş olan Chat uygulamanızı yeni Cloud projenize yeniden dağıtmak için uygulamayı yeni Cloud projesine kopyalayın.
Hizmet hesabını güncelleme
Chat uygulamanız uygulama olarak kimlik doğrulaması yapıyor ve Google API'lerine çağrı yapmak için bir hizmet hesabı kullanıyorsa Chat uygulamasının hizmet hesabı ayrıntılarını güncelleyin. Daha fazla bilgi edinmek için Chat uygulaması olarak kimlik doğrulama başlıklı makaleye göz atın.
Chat uygulamanızı paylaşın
Chat uygulamanız yeni kuruluştaki kullanıcıların kullanımına sunulmadan önce, yöneticinizin Chat uygulamasına erişime manuel olarak izin vermesi gerekebilir. Daha fazla bilgi için Google Workspace yöneticileri Chat uygulamalarını nasıl yükler? başlıklı makaleyi inceleyin.
Yeni Chat uygulamasına geçin
Chat uygulaması yeni kuruluşa taşındığına göre artık bu uygulamayı tanıtma zamanı geldi. Bunu Chat alanlarına veya doğrudan mesajlara ekleyin. Ardından eski Chat uygulamasını eski uygulamadan kaldırın. Böylece kullanıcılar yalnızca taşınan Chat uygulamasına mesaj gönderebilir.
Yeni Chat uygulamasını Chat alanlarına ekleme
Chat'e gidin.
Bir doğrudan mesajı veya alanı tıklayın.
Alanın veya kullanıcının adının yanındaki açılır menüyü tıklayıp Uygulamalar ve entegrasyonlar'ı seçin.
Uygulama ekle'yi tıklayın.
Uygulamanın adını girin, listeden uygulamayı seçin ve ardından Ekle'yi tıklayın.
Chat uygulamasını eklemek istediğiniz her alan veya doğrudan mesaj için bu adımları tekrarlayın.
Eski Chat uygulamasını Chat alanlarından kaldırma
Chat'e gidin.
Bir doğrudan mesajı veya alanı tıklayın.
Alanın veya kullanıcının adının yanındaki açılır menüyü tıklayıp Uygulamalar ve entegrasyonlar'ı seçin.
Taşınmamış eski Chat uygulamasının yanındaki Diğer seçenekler simgesini ve ardından Alandan kaldır'ı tıklayın.
Eski Chat uygulamasını kaldırmak istediğiniz her alan veya doğrudan mesaj için bu adımları tekrarlayın.
Eski Chat uygulamasını devre dışı bırakma
Kullanıcıların eski Chat uygulamasını kullanmasını engellemek ve yeni Chat uygulamasını kullanmaya teşvik etmek için eski Chat uygulamasını devre dışı bırakın ve Google Workspace Marketplace'te yayından kaldırın.