Google Chat API'yi yapılandırma

Oluşturduğunuz her Google Chat uygulaması, Chat API'nin etkinleştirilip yapılandırıldığı kendi Google Cloud projesi gerektirir. Bu sayfada, Chat API'yi nasıl yapılandıracağınız gösterilmektedir.

Ön koşullar

Chat API'yi yapılandırma

  1. Google Cloud konsolunda "Google Chat API" araması yapıp Google Chat API'yi, ardından Yönet'i tıklayın.

    Chat API'ye git

  2. 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 piksellik kare bir grafik resmi (ör. 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 amacının açıklaması.

  3. Etkileşimli özellikleri açmak için kullanıcıların Chat uygulamanızla etkileşim kurmasına olanak tanıyan Etkileşimli özellikleri etkinleştir seçeneğini 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şimde bulunabileceğini belirleyen alanlar:
    • Bire bir mesajlar alma: Kullanıcılar, Chat uygulamasını doğrudan Google Chat'te bulup 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ı Aşağıdakilerden biri olan Chat uygulaması için uç nokta:
    • Uygulama URL'si: Chat uygulamasının uygulanmasını barındıran 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ı bir Dialogflow entegrasyonuyla kaydeder. Daha fazla bilgi için Doğal dili anlayan bir Dialogflow Google Chat uygulaması oluşturma bölümüne bakın.
    Slash komutları Google Chat'te kullanıcılara gösterilebilen komutlar. Kullanıcıların Google Chat'te Chat uygulamanızla ilgili temel işlemleri görmesine ve etkileşimde bulunmak istedikleri belirli bir işlemi seçmesine izin verir. Daha fazla bilgi edinmek için Eğik çizgi komutlarını Chat uygulaması olarak yanıtlama başlıklı makaleye bakın.
    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ı başlıklı makaleyi inceleyin.
    Görünürlük Chat uygulamanızı görüntüleyebilecek ve yükleyebilecek 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 edinmek için Chat uygulamanızın görünürlüğü ve yayınlama ayarları başlıklı makaleyi inceleyin.

  4. Chat uygulaması her hata döndürdüğünde 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 hata günlüklerini sorgulama bölümünü inceleyin.

  5. Kaydet'i tıklayın. Chat uygulaması yapılandırmasını kaydettiğinizde Chat uygulamanız, Google Workspace kuruluşunuzda belirtilen kullanıcılar tarafından kullanılabilir.

Diğer kullanıcılara 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ının yapılandırma sayfasına erişemez ancak Chat uygulamasının ana makine Cloud projesinin Google Cloud konsoluna aşağıdaki şekilde 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.