Google Chat API'yi yapılandırma

Oluşturduğunuz her Google Chat uygulaması için Chat API'nin etkinleştirildiği ve yapılandırıldığı kendi Google Cloud projesi gerekir. Bu sayfada, Chat API'nin nasıl yapılandırılacağı gösterilmektedir.

Ön koşullar

Chat uygulamanız için görünen ad, avatar ve açıklama seçme

Chat API'yi çağırmak için aşağıdaki bilgileri içeren bir Google Chat uygulaması oluşturmanız gerekir:

Alan Açıklama Biçim
Uygulama adı Chat uygulamasının görünen adı. En fazla 25 alfanümerik karakter
Avatar URL'si Chat uygulamanızın avatarı olarak gösterilen resim. Kare bir grafik resmine (PNG veya JPEG) yönlendiren bir HTTPS URL'si. Önerilen boyut 256x256 piksel veya daha büyüktür.
Açıklama Chat uygulamasının amacının kısa bir açıklaması. En fazla 40 alfanümerik karakter

Chat uygulamasının adı, avatarı ve açıklaması, Chat kullanıcı arayüzünde kullanıcılara gösterilir. Chat, bazı Chat API yazma isteklerinde bir Chat uygulamasının Chat'te gerçekleştirdiği işlemleri ilişkilendirmek için bu bilgileri kullanır.

Örneğin, spaces.create() yöntemini çağırırsanız Chat, alanı kimin oluşturduğunun açıklamasına Chat uygulamasının adını ekler (aşağıdaki resimde gösterildiği gibi):

Google Chat uygulaması, bir kullanıcı için alan oluşturur.
Şekil 1. Bir kullanıcı adına alan oluşturmak için spaces.create() yöntemi kullanıldığında Chat'in gösterdiği ilişkilendirme mesajı.

Kullanıcılar, Chat uygulamalarıyla etkileşimde bulunmak için bu bilgileri aşağıdaki şekillerde de görebilir veya kullanabilir:

  • Adını @işaretiyle belirterek Chat uygulamasını çağırın.
  • Chat uygulamasıyla doğrudan mesaj bulup başlatın. Uygulamalar menüsünde, doğrudan mesajlarda Chat uygulamasının adı ve avatarı gösterilir.
  • Kullanıcılar, oluşturma çubuğundan Chat uygulamalarına göz atabilir ve adlarını, avatarlarını ve açıklamalarını görebilir.

Google Cloud Console'da Chat uygulamanızı yapılandırma

Chat uygulaması ayrıntılarınız hazır olduğunda Cloud projenizi açıp Chat API'yi yapılandırın:

  1. Google Cloud Console'da Chat API sayfasına gidin ve Yapılandırma sayfasını tıklayın:

    Chat API Yapılandırması sayfasına gidin

  2. Uygulama bilgileri bölümünde Uygulama adı, Avatar URL'si ve Açıklama alanlarını doldurun.

  3. Etkileşimli özellikler bölümünde, Chat uygulamasının etkileşimli özelliklerini devre dışı bırakmak için Etkileşimli özellikleri etkinleştir açma/kapatma düğmesini kapalı konuma getirin. Bu ayarı daha sonra da yapabilirsiniz. Etkileşimli özellikleri yapılandırma ve oluşturma hakkında bilgi edinmek için Kullanıcı etkileşimlerini alma ve yanıtlama başlıklı makaleyi inceleyin.

  4. İsteğe bağlı: Google Cloud Logging'i kullanmak için Günlükler bölümünde Hata günlüklerini Logging'e kaydet onay kutusunu işaretleyin. Daha fazla bilgi için Chat uygulamaları için sorgu hatası günlükleri başlıklı makaleyi inceleyin.

  5. Kaydet'i tıklayın.

Diğer kullanıcılara Chat API'yi yapılandırma izni verme

Google Cloud Identity Access Management (IAM) rolü olan Chat uygulamaları Sahibi veya Chat uygulamaları Görüntüleyicisi rolünü vererek belirli kullanıcılara Chat uygulaması yapılandırma sayfasına erişim izni verebilirsiniz. Bu rollere sahip kullanıcılar, API'ler ve Hizmetler kontrol panelini kullanarak Chat uygulamaları yapılandırma sayfasına gidemez ancak Chat uygulamasının barındırma Cloud projesinin Google Cloud Console'una 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=PROJECT_ID

Burada PROJECT_ID, Chat uygulamasını barındıran Google Cloud projesinin proje kimliğidir.