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'yi nasıl yapılandıracağınız gösterilmektedir.
Ön koşullar
- Google Chat'e erişimi olan bir Google Workspace hesabı.
- Bir Google Cloud projesi.
- OAuth izin ekranını yapılandırın.
- Google Chat API'yi etkinleştirme
Chat API'yi yapılandırma
Google Cloud konsolunda "Google Chat API" araması yapın, Google Chat API'yi ve 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 boyutunda kare grafikli bir resmi (örneğin, 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 bir açıklaması.
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 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şim kurabileceğini belirleyen bir dizi alan: - Bire bir mesaj alma: Kullanıcılar, Chat uygulamasını doğrudan Google Chat'te bulabilir ve bu uygulamaya 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ı Chat uygulaması için uç nokta. Bu sınır aşağıdakilerden biridir: - Uygulama URL'si: Chat uygulamasının uygulamasını barındıran bir 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ı Dialogflow entegrasyonuyla kaydeder. Daha fazla bilgi için Doğal dili anlayan bir Dialogflow Google Chat uygulaması derleme başlıklı makaleyi inceleyin.
Slash komutları Google Chat'te kullanıcılara gösterilebilecek komutlar. Kullanıcıların, Google Chat'te Chat uygulamanızın temel işlemlerini görmesine ve etkileşim kurmak istedikleri belirli bir işlemi seçmesine olanak tanır. Daha fazla bilgi için Eğik çizgi komutlarına Chat uygulaması olarak yanıt verme başlıklı makaleyi inceleyin. 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ı konusuna bakın. Görünürlük Chat uygulamanızı görüntüleyebilen ve yükleyebilen 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 için Chat uygulamanız için görünürlük ve yayınlama ayarları başlıklı makaleyi inceleyin. Chat uygulaması her hata verdiğinde 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 sorgu hatası günlükleri bölümüne bakın.
Kaydet'i tıklayın. Chat uygulaması yapılandırmasını kaydettiğinizde Chat uygulamanız, Google Workspace kuruluşunuzdaki belirtilen kullanıcılar tarafından kullanılabilir.
Diğer kullanıcılara bir Chat uygulamasını yapılandırma izni verme
Chat uygulaması yapılandırma sayfasında belirli kullanıcılara erişim izni verebilirsiniz. Chat Uygulamaları Sahibi ve Chat Uygulamaları Görüntüleyici IAM rollerini kullanın. Bu rollere sahip kullanıcılar, API'ler ve Hizmetler kontrol panelini kullanarak Chat uygulamaları yapılandırma sayfasına gidemez. Ancak aşağıdaki şekilde Chat uygulamasının ana makine Cloud projesine ait Google Cloud konsoluna giderek 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.