Google Chat API'yi yapılandırma

Oluşturduğunuz her Google Chat uygulaması, Chat API'nin etkin ve yapılandırılmış olduğu kendi Google Cloud projesinin kullanılmasını gerektirir. 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 kullanarak bir Google Chat uygulaması kurmanı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ında doğrudan mesaj bulup başlatın. Uygulamalar menüsünde, doğrudan mesajlar Chat uygulamasının adı ve avatarı olarak gösterilir.
  • Kullanıcılar, yazma ç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. Chat uygulaması için etkileşimli özellikleri devre dışı bırakmak üzere, Etkileşimli özellikler bölümünde Etkileşimli özellikleri etkinleştir açma/kapatma düğmesini tıklayarak kapalı konumuna getirin. Bunu daha sonra ayarlayabilirsiniz. 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, Hataları günlüğ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ının yapılandırma sayfasına gidemez ancak Chat uygulamasının barındırma Cloud projesinin Google Cloud Console'una giderek yapılandırma sayfasına aşağıdaki şekilde 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.