Bu kılavuzda, Google Chat API'nin Space
kaynağındaki setUp()
yönteminin Google Chat alanı oluşturmak için nasıl kullanılacağı açıklanmaktadır. Alan oluşturduğunuzda alan oluşturulur ve belirli kullanıcılar bu alana eklenir.
Space
kaynağı, kullanıcıların ve Chat uygulamalarının mesaj gönderebileceği, dosya paylaşabileceği ve ortak çalışabileceği bir yeri temsil eder. Birkaç alan türü vardır:
- Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı arasındaki görüşmelerdir. Chat uygulaması
- Grup sohbetleri üç veya daha fazla kullanıcı ile Sohbet uygulamaları.
- Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.
Alan oluştururken aşağıdakileri göz önünde bulundurun:
- Arayan (kimliği doğrulanmış) kullanıcı alana otomatik olarak eklenir. Bu nedenle, istekte kullanıcının üyeliğini belirtmeniz gerekmez.
- Doğrudan mesaj (DM) oluştururken, iki kullanıcı arasında bir doğrudan mesaj varsa DM döndürülür. Aksi takdirde bir DM oluşturulur.
- Grup sohbeti oluştururken istekte belirtilen üyeliklerden hiçbiri grup sohbetinize başarıyla eklenemezse (ör. izin sorunu) yalnızca arayan kullanıcıyı içeren boş bir grup sohbeti oluşturulabilir.
- Konu zinciri içeren alanlar oluşturamaz veya Google Workspace dışından kullanıcı ekleyemezsiniz.
- İstekte yinelenen üyelikler (arayan kullanıcı dahil) sağlanmış filtrelendiğinden emin olun.
Ön koşullar
Node.js
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
- Ortamınızı ayarlayın:
- Bir Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Node.js Cloud İstemci Kitaplığı'nı yükleyin.
-
Bir masaüstü uygulaması için OAuth istemci kimliği kimlik bilgileri oluşturun. Bu kılavuzda yer alan örneği çalıştırmak için kimlik bilgilerini yerel dizininize
client_secrets.json
adlı bir JSON dosyası olarak kaydedin.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
Python
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Google Chat API'yi etkinleştirin ve yapılandırın. Bunun için bir ad girin, Chat uygulamanızın simgesi ve açıklaması.
- Python Cloud İstemci Kitaplığı'nı yükleyin.
- Masaüstü uygulaması için
OAuth istemci kimliği kimlik bilgileri oluşturun. Örneği bu
yoksa, kimlik bilgilerini
client_secrets.json
adlı bir JSON dosyası olarak yerel dizini oluşturun.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
Java
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
- Ortamınızı ayarlayın:
- Bir Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Google Chat API'yi etkinleştirin ve yapılandırın. Bunun için bir ad girin, Chat uygulamanızın simgesi ve açıklaması.
- Java Cloud İstemci Kitaplığı'nı yükleyin.
-
Bir masaüstü uygulaması için OAuth istemci kimliği kimlik bilgileri oluşturun. Örneği bu
yoksa, kimlik bilgilerini
client_secrets.json
adlı bir JSON dosyası olarak yerel dizini oluşturun.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
Apps Komut Dosyası
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Bir Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanız için bir ad, simge ve açıklamayla Google Chat API'yi etkinleştirip yapılandırın.
- Bağımsız bir Apps Komut Dosyası projesi oluşturun, ve Gelişmiş Sohbet Hizmeti'ni etkinleştirin.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
Alan oluşturma
Alan oluşturmak için isteğinize aşağıdakileri ekleyin:
chat.spaces.create
veyachat.spaces
yetkilendirme kapsamını belirtin.- Şunu çağırın:
SetUpSpace()
yöntemidir. space
'üdisplayName
veyaspaceType
gibi gerekli tüm alanlarla birlikteSpace
örneği olarak iletin.memberships
öğesiniMembership
örneklerinin dizisi olarak iletin. Her örnek için:- Gerçek bir kullanıcıyı alan üyesi olarak eklemek için
users/{user}
değerini belirtin. Bu durumda{user}
.person
için{person_id}
People API'den veya bir kullanıcınınuser
bulun. Örneğin, People API kişisiresourceName
people/123456789
isemember.name
olarakusers/123456789
içeren bir üyelik ekleyerek kullanıcıyı alana ekleyebilirsiniz. - Bir grubu alan üyesi olarak eklemek için
groups/{group}
değerini belirtin (burada{group}
) üyelik oluşturmak istediğiniz grup kimliğidir. Grup kimliği, Cloud Identity API kullanılarak alınabilir. Örneğin, Cloud Identity APIgroups/123456789
adlı bir grup döndürüyorsamembership.groupMember.name
değerinigroups/123456789
olarak ayarlayın. Google Grupları, ancak yalnızca adlandırılmış bir alana eklenmiş olması gerekir.
- Gerçek bir kullanıcıyı alan üyesi olarak eklemek için
Arayan kullanıcı ile başka bir gerçek kullanıcı arasında DM oluşturmak için isteğinizde gerçek kullanıcının üyeliğini belirtin.
Arayan kullanıcı ile arama uygulaması arasında DM oluşturmak için
space.singleUserBotDm
tarafından true
ile paylaşıldı ve üyelik belirtmeyin. Şunları yapabilirsiniz:
bu yöntemi yalnızca arama uygulamasıyla bir DM ayarlamak için kullanın. Görüşmeyi eklemek için
veya iki kullanıcı arasındaki mevcut bir DM'nin üyesi olarak uygulamayı görmek için
üyelik oluşturabilirsiniz.
Aşağıdaki örnekte, adlandırılmış bir alan ve bu alana iki gerçek kullanıcı (kimliği doğrulanmış kullanıcı ve başka bir kullanıcı) için bir üyelik oluşturulur.
Node.js
Python
Java
Apps Komut Dosyası
Örneği çalıştırmak için aşağıdaki kodu değiştirin:
DISPLAY_NAME
: Yeni alanın görünen adı.USER_NAME
: Üyelik eklenecek diğer kullanıcının kimliği.
Alana gitmek için alanın URL'sini oluşturmak üzere alanın kaynak kimliğini kullanın.
Google Chat yanıtında name
alanındaki kaynak kimliğini alabilirsiniz
gövde. Örneğin, alanınızın name
değeri spaces/1234567
ise gidebilirsiniz
alana ekleyin:
https://mail.google.com/chat/u/0/#chat/space/1234567
.
İlgili konular
- Alan oluşturun.
- Bir alanla ilgili ayrıntıları öğrenin.
- Alanları listeleyin.
- Alanları güncelleme
- Alanı silebilirsiniz.
- Doğrudan mesaj alanını bulun.
- Bir alanı belirli kullanıcılar tarafından bulunabilir hale getirin.