Google Chat uygulamanızı taşıma

Google Workspace kuruluşlarını birleştirirseniz Chat uygulamanızın çalışmaya devam etmesi için uygulamayı taşımanız gerekebilir.

Chat uygulamanızı taşımadan önce, yönetici ayarlarının uygulamayı etkileyip etkilemediğini öğrenmek için kuruluşunuzun yöneticisine danışın. Yönetim ayarlarından birini değiştirmek, 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ı 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ı birleştirildikten sonra Google Chat uygulamalarının taşınıp taşınması gerektiğini belirleme başlıklı makaleyi inceleyin.

Chat uygulamanızı taşımanız gerektiğine karar verdikten sonra aşağıdaki üç adımlı süreci tamamlayın:

1. Birleştirilmiş kuruluşta Google Cloud projesi oluşturarak, API'leri etkinleştirerek ve OAuth 2.0 kullanıcı rızası ekranını yapılandırarak Chat uygulamanızın ortamını ayarlayın.
2. Chat uygulamanızı yeni Cloud projesinden yeniden dağıtın.
3. Yeniden oluşturulan Chat uygulamasını Chat alanlarına veya görüşmelerine ekleyin ve orijinal Chat uygulamasını devre dışı bırakın.

Birleştirilmiş kuruluşta Cloud projesi oluşturma ve API'leri etkinleştirme

Birleştirilmiş Google Workspace kuruluşunda yeni bir Cloud projesi oluşturmak ve Chat uygulaması için API'leri etkinleştirmek, Chat uygulamasına erişmesine izin verdiğiniz kullanıcıların ve grupların bu uygulamaya hatasız bir şekilde erişebilmesini sağlar.

Cloud projesi oluşturma

Google Cloud konsolu

1. Google Cloud Console'da Menü > IAM & Admin > Proje Oluştur'a gidin.

   Proje oluşturma sayfasına gitme

2. Proje Adı alanına projeniz için açıklayıcı bir ad girin.

   İsteğe bağlı: Proje kimliğini düzenlemek için Düzenle'yi tıklayın. Proje kimliği, proje oluşturulduktan sonra değiştirilemez. Bu nedenle, projenin kullanım ömrü boyunca ihtiyaçlarınızı karşılayacak bir kimlik seçin.

3. Konum alanında, projeniz için olası konumları görüntülemek üzere Göz at'ı tıklayın. Ardından Seç'i tıklayın.
   Dikkat: Google Workspace kuruluşunuzu bulamıyor musunuz?
   Bu, bir Google Workspace hesabında oturum açmadığınız anlamına gelir. Google Workspace geliştirici dokümanlarında açıklanan bazı özellikler yalnızca bir kuruluşla ilişkili projelerde kullanılabilir.
4. Oluştur'u 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: gcloud KSA'nın önceden ayarlandığı bir online terminal kullanmak için Cloud Shell'i etkinleştirin.
  Cloud Shell'i etkinleştirin.
• Yerel kabuk: Yerel geliştirme ortamı kullanmak için gcloud CLI'yı yükleyin ve başlatın.
  Cloud projesi oluşturmak için gcloud projects create komutunu kullanın:

  gcloud projects create PROJECT_ID

  Oluşturmak istediğiniz projenin kimliğini ayarlayarak PROJECT_ID kısmını değiştirin.

API'leri etkinleştir

Tüm Chat uygulamalarında Google Chat API'sinin etkinleştirilmesi gerekir. Chat uygulamanızın nasıl oluşturulduğuna bağlı olarak başka API'leri de etkinleştirmeniz gerekebilir. Örneğin, Google Cloud Functions'ı kullanarak bir sohbet uygulaması 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ışmasını sağlamak için yeni Cloud projesinde eski Cloud projesinde etkinleştirilen API'leri etkinleştirin.

Bir API'yi etkinleştirmek için aşağıdakileri yapın:

Google Cloud konsolu

1. Google Cloud Console'da Menü > Diğer ürünler > Google Workspace > Ürün Kitaplığı'na gidin.

   Ürün Kitaplığı'na gitme

2. Etkinleştirmek istediğiniz API'yi tıklayın.
3. Etkinleştir'i tıklayın.
4. Daha fazla API'yi etkinleştirmek için bu adımları tekrarlayın.

Google Cloud CLI

1. Google Cloud Komut Satırı Arayüzü'nü (KSA) yükleyin veya açın.

2. Etkinleştirilecek API hizmetini belirterek services enable komutunu çalıştırın.

   gcloud services enable API_SERVICE_ID

Chat API'yi yapılandırma

Yeni Cloud projenizde Chat uygulamanızın adını, açıklamasını ve simgesini belirtmek için Chat API'yi kullanmanız gerekir. Bu ayrıntıları yapılandırmak için Chat API'yi yapılandırma başlıklı makaleyi inceleyin.

OAuth onay ekranını yapılandırma

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 erişim kapsamlarını kullanın.

1. Google Cloud Console'da Menü > > Markalama'ya gidin.

   Markalama'ya gidin

2. özelliğini zaten yapılandırdıysanız Markalama, Kitle ve Veri Erişimi'nde aşağıdaki OAuth izin ekranı ayarlarını yapılandırabilirsiniz. henüz yapılandırılmadı mesajını görürseniz Başlayın'ı tıklayın:
1. Uygulama Bilgileri bölümündeki Uygulama adı alanına bir Uygulama adı girin.
2. Kullanıcı destek e-postası bölümünde, kullanıcıların rızalarıyla ilgili soruları olduğunda sizinle iletişime geçebileceği bir destek e-posta adresi seçin.
3. İleri'yi tıklayın.
4. Kitle bölümünde uygulamanızın kullanıcı türünü seçin.
5. İleri'yi tıklayın.
6. İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirim alabileceğiniz bir e-posta adresi girin.
7. İleri'yi tıklayın.
8. Bitir bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
9. Devam'ı tıklayın.
10. Oluştur'u tıklayın.
11. Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
    1. Kitle'yi tıklayın.
    2. Test kullanıcıları bölümünde Kullanıcı ekle'yi tıklayın.
    3. E-posta adresinizi ve yetkili diğer test kullanıcılarını girip Kaydet'i tıklayın.

3. Google Workspace kuruluşunuzun dışında kullanılacak bir uygulama oluşturuyorsanız Veri Erişimi > Kapsam Ekleme veya Kaldırma'yı tıklayın. Kapsam seçerken aşağıdaki en iyi uygulamaları öneririz:

   • Uygulamanızın ihtiyaç duyduğu 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ı başlıklı makaleyi inceleyin.
   • Üç bölümde 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 kapsamlar için gereksiz ek incelemelerden kaçınmak amacıyla hassas olmayan alternatif kapsamlar belirlemeye çalışın.
   • Bazı kapsamlar için Google tarafından ek inceleme yapılması gerekir. Yalnızca Google Workspace kuruluşunuz tarafından dahili olarak kullanılan uygulamalarda kapsamlar izin ekranında listelenmez ve kısıtlanmış veya hassas kapsamların kullanılması için Google tarafından daha fazla inceleme yapılması gerekmez. Daha fazla bilgi için Kapsam kategorileri başlıklı makaleyi inceleyin.
4. Uygulamanızın gerektirdiği kapsamları seçtikten sonra Kaydet'i tıklayın.

OAuth kullanıcı rızası ekranını yapılandırma hakkında daha fazla bilgi için başlıklı makaleyi inceleyin.

Chat uygulamanızı yeni Cloud projesine yeniden dağıtın.

Chat uygulamanızın Apps Komut Dosyası, AppSheet veya Python ya da Java gibi başka bir bağlantı türüyle oluşturulup oluşturulmadığına bağlı olarak Chat uygulamanızı yeniden dağıtma işlemi biraz farklılık gösterir. Her iki durumda da kodunuzun tamamını yeniden oluşturmanız gerekmez ancak bazı değişiklikler yapmanız gerekir.

Chat uygulaması mantığını taşıma

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 sohbet uygulamaları için Dialogflow aracılarını da taşımanız gerekir.
• Güvenlik duvarı arkasında oluşturulan Chat uygulamaları için Pub/Sub konularını da taşımanız gerekir.

Yeni Cloud projesinde etkileşimli özellikleri yapılandırma

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.

Etkileşimli özellikleri yapılandırmak için Kullanıcı etkileşimlerini alma ve yanıtlama başlıklı makaleyi inceleyin.

Apps Komut Dosyası Chat uygulamasını yeniden dağıtma

Apps Komut Dosyası ile oluşturulan Chat uygulamanızı yeniden dağıtmak için Apps Komut Dosyası projesinin ilişkili olduğu Cloud projesi 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ı kopyalama

1. Google Cloud Console'da Menü > IAM ve Yönetici > Ayarlar'a gidin.

   IAM ve Yönetici Ayarları'na gitme

2. Proje numarası alanındaki değeri kopyalayın.

Apps Komut Dosyası projenizde Google Cloud proje numaranızı ayarlama

1. Apps Komut Dosyası'na gidin.

   Apps Komut Dosyası'na gitme

2. Chat uygulaması Apps Komut Dosyası projesinde, Proje Ayarları'nı tıklayın.

3. Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.

4. GCP proje numarası bölümüne Google Cloud proje numarasını yapıştırın.

5. Projeyi ayarla'yı tıklayın.

Apps Komut Dosyası projenizin dağıtım kimliğini kopyalayın.

1. Apps Komut Dosyası'nın sağ üst kısmında Dağıt > Dağıtımları yönet'i tıklayın.
2. Dağıtım kimliği bölümünde Kopyala'yı tıklayın.
3. Bitti'yi tıklayın.

Chat uygulamanızı yeniden yapılandırma ve yeniden dağıtma

1. Google Cloud Console'da "Google Chat API"yi arayın ve Google Chat API'yi, ardından Yönet'i tıklayın.

   Chat API'ye gitme

2. Yapılandırma sekmesini tıklayın ve aşağıdaki zorunlu bilgileri girin:

   • Uygulama adı: Kullanıcıların Chat uygulamanızla etkileşimde bulunurken kullandığı ad.
   • Avatar URL'si: En az 128x128 boyutlarında, kare grafik resmine (ör. PNG veya JPEG) yönlendiren bir HTTPS URL'si. Bu resim, sohbet uygulamanızın avatarı olarak görünür.
   • Açıklama: Chat uygulamasının amaçlanan kullanım alanının açıklaması. Bu açıklama, Chat uygulamanızın adının altında gösterilir.

3. Etkileşimli özellikleri etkinleştirmek için kullanıcıların Chat uygulamanızla etkileşim kurmasına olanak tanıyan Etkileşimli özellikleri etkinleştir açma/kapatma düğmesini tıklayın:

4. Bağlantı ayarları bölümünde Apps Komut Dosyası projesi'ni seçin.

5. Deployment ID (Dağıtım Kimliği) alanına, daha önce kopyaladığınız dağıtım kimliğini yapıştırın.

6. Yapılandırmanın geri kalanını tamamlamak için Yeni Cloud projesinde Sohbet uygulamasını yapılandırma başlıklı makaledeki tabloya bakın.

7. Kaydet'i tıklayın.

AppSheet Chat uygulamasını yeniden dağıtma

AppSheet ile oluşturulan Chat uygulamanızı yeni Cloud projenizde 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ıyorsa ve Google API'lerine çağrı yapmak için hizmet hesabı kullanıyorsa Chat uygulamasının hizmet hesabı ayrıntılarını güncelleyin. Daha fazla bilgi için Chat uygulaması olarak kimlik doğrulama başlıklı makaleyi inceleyin.

Chat uygulamanızı paylaşma

Chat uygulamanız yeni kuruluştaki kullanıcılar tarafından kullanılabilir hale gelmeden önce yöneticinizin Chat uygulamasına erişimi manuel olarak etkinleştirmesi gerekebilir. Daha fazla bilgi için Google Workspace Marketplace belgelerindeki Google Workspace kuruluşları için erişimi yapılandırma başlıklı makaleyi inceleyin.

Yeni Chat uygulamasına geçiş yapma

Chat uygulaması yeni kuruluşa taşındığına göre artık uygulamayı duyurabilirsiniz. Botu Chat alanlarına veya doğrudan mesajlara ekleyin, ardından eski Chat uygulamasını bu alanlardan veya mesajlardan kaldırın. Böylece kullanıcılar yalnızca taşınan Chat uygulamasına mesaj gönderebilir.

En iyi uygulama: Taşınan Chat uygulamasının kullanılmaya başlanmasına yardımcı olmak için kullanıcılarınıza taşıma işlemini duyurun ve taşınan Chat uygulamasını Chat alanlarına ve görüşmelerine yüklemelerini teşvik edin.

Yeni Chat uygulamasını Chat alanlarına ekleme

1. Chat'e gidin.

   Chat'e gitme

2. Bir doğrudan mesajı veya alanı tıklayın.

3. Alan veya kişi adının yanındaki açılır listeyi tıklayın ve Uygulamalar ve entegrasyonlar'ı seçin.

4. Uygulama ekle'yi tıklayın.

5. Uygulama adını girin, listeden uygulamayı seçin ve Ekle'yi tıklayın.

6. 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

1. Chat'e gidin.

   Chat'e gitme

2. Bir doğrudan mesajı veya alanı tıklayın.

3. Alan veya kişi adının yanındaki açılır listeyi tıklayın ve Uygulamalar ve entegrasyonlar'ı seçin.

4. Eski, taşınmamış Chat uygulamasının yanındaki Diğer seçenekler'i , ardından Alandan kaldır'ı tıklayın.

5. 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ı önlemek ve yeni Chat uygulamasını kullanmaya teşvik etmek için eski Chat uygulamasını devre dışı bırakın ve Google Workspace Marketplace'ten kaldırın.