Advanced Chat hizmeti, Apps Komut Dosyası'nda Google Chat API'yi kullanmanızı sağlar. Bu API, komut dosyalarının Chat alanlarını bulmasına, oluşturmasına ve değiştirmesine, alanlara üye ekleyip kaldırmasına ve metin, kart, ek ve tepkiler içeren mesajları okumasına ya da yayınlamasına olanak tanır.
Ön koşullar
- Google Cloud Console'daki Chat API yapılandırma sayfasında yapılandırılan bir Apps Komut Dosyası Google Chat uygulaması. Uygulamanın Apps Komut Dosyası projesi, Apps Komut Dosyası projeleri için otomatik olarak oluşturulan varsayılan proje yerine standart bir Google Cloud projesi kullanmalıdır. Uyumlu bir Google Chat uygulaması oluşturmak için Apps Komut Dosyası ile Google Chat uygulaması oluşturma başlıklı makaleyi inceleyin.
- Chat uygulaması için kimlik doğrulaması yapılandırıldı. Kullanıcı adına işlem yapılabilmesi için kullanıcı kimlik doğrulaması gerekir. Chat uygulamasında bir işlemin gerçekleştirilmesi için bir hizmet hesabıyla uygulama kimlik doğrulaması gerekir. Chat API yönteminin hangi kimlik doğrulama biçimini desteklediğini öğrenmek için Google Chat API çağrıları için gerekli kimlik doğrulama türleri başlıklı makaleyi inceleyin.
Referans
Bu hizmet hakkında daha fazla bilgi edinmek için Chat API referans belgelerini inceleyin. Apps Komut Dosyası'ndaki tüm gelişmiş hizmetler gibi Chat hizmeti de genel API ile aynı nesneleri, yöntemleri ve parametreleri kullanır.
Örnek kod
Bu örnekler, gelişmiş hizmeti kullanarak sık yapılan Google Chat API işlemlerini nasıl gerçekleştireceğinizi gösterir.
Kullanıcı kimlik bilgilerini içeren bir mesaj yayınlayın
Aşağıdaki örnek, kullanıcı adına bir Chat alanında nasıl mesaj gönderileceğini göstermektedir.
chat.messages.create
yetkilendirme kapsamını, Apps Komut Dosyası projesininappsscript.json
dosyasına ekleyin:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.create" ]
Apps Komut Dosyası projesinin koduna şunun gibi bir işlev ekleyin:
Uygulama kimlik bilgileriyle mesaj yayınlayın
Aşağıdaki örnek, uygulama adına bir Chat alanında nasıl mesaj gönderileceğini göstermektedir. Gelişmiş Chat hizmetini bir hizmet hesabıyla kullanmak, appsscript.json
ürününde yetkilendirme kapsamlarını belirtmenizi gerektirmez. Hizmet hesaplarıyla kimlik doğrulama hakkında ayrıntılı bilgi için Google Chat uygulaması olarak kimlik doğrulama başlıklı makaleyi inceleyin.
Alan al
Aşağıdaki örnekte, bir Chat alanı hakkında nasıl bilgi edinileceği gösterilmektedir.
chat.spaces.readonly
yetkilendirme kapsamını, Apps Komut Dosyası projesininappsscript.json
dosyasına ekleyin:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.readonly" ]
Apps Komut Dosyası projesinin koduna şunun gibi bir işlev ekleyin:
Alan oluşturma
Aşağıdaki örnekte, Chat alanı oluşturma işlemi gösterilmektedir.
chat.spaces.create
yetkilendirme kapsamını, Apps Komut Dosyası projesininappsscript.json
dosyasına ekleyin:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.create" ]
Apps Komut Dosyası projesinin koduna şunun gibi bir işlev ekleyin:
Liste üyelikleri
Aşağıdaki örnekte, bir Chat alanındaki tüm üyelerin nasıl listeleneceği gösterilmektedir.
chat.memberships.readonly
yetkilendirme kapsamını, Apps Komut Dosyası projesininappsscript.json
dosyasına ekleyin:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships.readonly" ]
Apps Komut Dosyası projesinin koduna şunun gibi bir işlev ekleyin:
Sorun giderme
Some requested scopes cannot be shown
hata mesajıyla Error 400: invalid_scope
ile karşılaşırsanız bu, Apps Komut Dosyası projesinin appsscript.json
dosyasında herhangi bir yetkilendirme kapsamı belirtmediğiniz anlamına gelir. Çoğu durumda, Apps Komut Dosyası, bir komut dosyasının hangi kapsamlara ihtiyaç duyduğunu otomatik olarak belirler. Ancak Chat gelişmiş hizmetini kullanırken, komut dosyanızın kullandığı yetkilendirme kapsamlarını, Apps Komut Dosyası projenizin manifest dosyasına manuel olarak eklemeniz gerekir. Açık kapsamları ayarlama bölümüne bakın.
Hatayı çözmek için oauthScopes
dizisinin bir parçası olarak Apps Komut Dosyası projesinin appsscript.json
dosyasına uygun yetkilendirme kapsamlarını ekleyin. Örneğin, spaces.messages.create
yöntemini çağırmak için aşağıdakileri ekleyin:
"oauthScopes": [
"https://www.googleapis.com/auth/chat.messages.create"
]
Sınırlar ve dikkat edilmesi gereken noktalar
Gelişmiş Sohbet hizmeti şunları desteklemez:
- Chat API yöntemi
media.download
. - Geliştirici Önizlemesi'nde kullanılabilen Chat API yöntemleri
Bir mesaj ekini indirmek veya geliştirici önizleme yöntemini çağırmak için bunun yerine UrlFetchApp
kullanın.