Google Chat uygulamanızı taşıma

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önetici ayarlarının uygulamayı etkileyip etkilemediğini öğrenmek için kuruluşunuzun yöneticisiyle görüşün. Bir yönetim ayarını değiştirmek, Chat uygulamanızdaki tüm işlevleri 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şınması gerekip gerekmediğini belirleme başlıklı makaleyi inceleyin.

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

  1. Birleştirilen kuruluşta bir Google Cloud projesi oluşturarak, API'leri etkinleştirerek ve gerekirse OAuth 2.0 kullanıcı rızası ekranını yapılandırarak Chat uygulamanız için ortamı 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ştirilen kuruluşta Cloud projesi oluşturun ve API'leri etkinleştirin

Yeni bir Cloud projesi oluşturmak ve birleşik Google Workspace kuruluşunda Chat uygulaması için API'leri etkinleştirmek, Chat uygulamasına erişmesine izin verdiğiniz kullanıcıların ve grupların bunu hatasız bir şekilde yapmasını sağlar.

Cloud projesi oluşturma

Google Cloud konsolu

  1. Google Cloud Console'da Menü > IAM ve Yönetici > Proje Oluştur'a gidin.

    Proje Oluştur'a gidin

  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 oluşturulduktan sonra proje kimliği değiştirilemez. Bu nedenle, projenin kullanım süresi boyunca ihtiyaçlarınızı karşılayacak bir kimlik seçin.

  3. Projeniz için olası konumları görüntülemek üzere Konum alanında Göz at'ı tıklayın. Ardından Seç'i tıklayın.
  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 CLI'ye (gcloud) erişin:

  • Cloud Shell: gcloud CLI'si önceden ayarlanmış bir internet terminali kullanmak için Cloud Shell'i etkinleştirin.
    Cloud Shell'i etkinleştirme
  • Yerel Kabuk: Yerel bir geliştirme ortamı kullanmak için gcloud CLI'yi 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 değerini değiştirin.

API'leri etkinleştir

Tüm Chat uygulamalarında Google Chat API'nin etkinleştirilmesi gerekir. Chat uygulamanızın nasıl oluşturulduğuna bağlı olarak diğer API'leri etkinleştirmeniz gerekebilir. Örneğin, Chat uygulamanızı Google Cloud Functions'i kullanarak 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. Taşınan uygulamanın çalıştığından emin olmak için en iyi uygulama olarak, 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 gidin

  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. Hangi API hizmetinin etkinleştirileceğini 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.

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

  1. Google Cloud Console'da Menü > > Markalaşma'ya gidin.

    Markalama'ya gidin

  2. 'ü zaten yapılandırdıysanız Marka, Kitle ve Veri Erişimi'nde aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını yapılandırabilirsiniz. Henüz yapılandırılmadı yazan bir mesaj 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 izinleriyle ilgili soruları için 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. Son 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 diğer yetkili 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 Ekle veya Kaldır'ı tıklayın. Kapsam seçerken aşağıdaki en iyi uygulamaları uygulamanızı öneririz:

    • Uygulamanızın gerektirdiği minimum erişim düzeyini sağlayan kapsamları seçin. Mevcut kapsamların listesi için Google API'leri için OAuth 2.0 Kapsamları başlıklı makaleyi inceleyin.
    • Hassas olmayan kapsamlar, hassas kapsamlar ve kısıtlanmış kapsamlar olmak üzere üç bölümün her birinde listelenen kapsamları inceleyin. "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 Google tarafından ek inceleme gerektirir. Yalnızca Google Workspace kuruluşunuz tarafından dahili olarak kullanılan uygulamalarda, izin ekranında kapsamlar listelenmez ve kısıtlanmış veya hassas kapsamların kullanımı için Google tarafından daha fazla inceleme 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 iznini yapılandırma hakkında daha fazla bilgi için başlıklı makaleyi inceleyin.

Chat uygulamanızı yeni Cloud projesine yeniden dağıtma

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 ajanlarını da taşımanız gerekir.
  • Güvenlik duvarının 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şturulan 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 Script 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 gidin

  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 gidin

  2. Chat uygulamasının 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ı alanına Google Cloud proje numarasını yapıştırın.

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

Apps Komut Dosyası projenizin dağıtım kimliğini kopyalama

  1. Apps Script'in sağ üst kısmında Yayınla > Yayınlamaları 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: Chat uygulamanızın avatarı olarak görünen, en az 128x128 boyutunda kare bir grafik resmini (ör. PNG veya JPEG) işaret eden HTTPS URL'si.
    • Açıklama: Chat uygulamasının adının altında görünen, Chat uygulamasının amaçlanan amacının açıklaması.

  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. 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 Chat 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 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ıyorsa 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 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ı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öneticilerinin Chat uygulamalarını yükleme başlıklı makaleyi inceleyin.

Yeni Chat uygulamasına geçiş

Chat uygulaması yeni kuruluşa taşındığına göre bunu duyurmanın zamanı geldi. Botu Chat alanlarına veya doğrudan mesajlara ekleyin ve ardından kullanıcıların yalnızca taşınan Chat uygulamasına mesaj göndermesi için eski Chat uygulamasını bu alanlardan kaldırın.

Yeni Chat uygulamasını Chat alanlarına ekleme

  1. Chat'e gidin.

    Chat'e gidin

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

  3. Alanın veya kullanıcının adının yanındaki açılır menüyü tıklayın ve Uygulamalar ve entegrasyonlar'ı seçin.

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

  5. Uygulamanın 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 gidin

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

  3. Alanın veya kullanıcının adının yanındaki açılır menüyü tıklayın ve Uygulamalar ve entegrasyonlar'ı seçin.

  4. Taşınmamış eski Chat uygulamasının yanındaki Diğer seçenekler simgesini ve 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 yayından kaldırın.