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şturma işlemi, bir alan oluşturur ve belirtilen kullanıcıları bu alana ekler.
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ı ile Chat uygulaması arasındaki görüşmelerdir.
- Grup sohbetleri, üç veya daha fazla kullanıcı ile Chat uygulamaları arasındaki görüşmelerdir.
- 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 DM 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 sağlanan yinelenen üyelikler (arayan kullanıcı dahil), istek hatasına neden olmak yerine filtrelenir.
Ön koşullar
Node.js
- 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.
- Node.js Cloud İstemci Kitaplığı'nı yükleyin.
- 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
- 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.
- Python Cloud İstemci Kitaplığı'nı yükleyin.
- Masaüstü uygulaması için
OAuth istemci kimliği kimlik bilgileri oluşturun. Bu kılavuzdaki örneği çalıştırmak için kimlik bilgilerini
client_secrets.json
adlı bir JSON dosyası olarak yerel dizininize kaydedin.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
Java
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- Google Cloud projesi oluşturun.
- OAuth izin ekranını yapılandırın.
- Chat uygulamanızın bir adı, simgesi ve açıklamasıyla Google Chat API'yi etkinleştirin ve yapılandırın.
- Java Cloud İstemci Kitaplığı'nı yükleyin.
- 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.
Apps Komut Dosyası
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Ortamınızı ayarlayın:
- 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ş Chat 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.SetUpSpace()
yöntemini çağırın.space
'üdisplayName
veyaspaceType
gibi gerekli tüm alanlarla birlikteSpace
örneği olarak iletin.memberships
öğesini birMembership
örnek 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}
, People API'dekiperson
için{person_id}
veya Directory API'dekiuser
kimliğidir. Örneğin, People API kişisiresourceName
people/123456789
isemember.name
olarakusers/123456789
içeren bir üyelik ekleyerek kullanıcıyı alana ekleyebilirsiniz. - Alan üyesi olarak grup eklemek için
groups/{group}
değerini belirtin.{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ı, grup sohbetlerine veya DM'lere değil, yalnızca adlandırılmış alanlara eklenebilir.
- 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 arayan uygulama arasında DM oluşturmak için space.singleUserBotDm
değerini true
olarak ayarlayın ve herhangi bir üyelik belirtmeyin. Bu yöntemi yalnızca arama uygulamasıyla DM oluşturmak için kullanabilirsiniz. Arama uygulamasını bir alanın üyesi olarak veya iki gerçek kullanıcı arasındaki mevcut bir DM'ye eklemek için üyelik oluşturma bölümüne bakın.
Aşağıdaki örnekte bir adlandırılmış alan oluşturulur ve iki gerçek kullanıcı (kimliği doğrulanmış kullanıcı ve bir diğer kullanıcı) için alana bir üyelik oluşturulur.
Node.js
Python
Java
Apps Komut Dosyası
Sana Özel örneğini çalıştırmak için aşağıdakileri 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 kaynak kimliğini kullanarak alanın URL'sini oluşturun.
Kaynak kimliğini, Google Chat yanıt metnindeki name
alanından alabilirsiniz. Örneğin, alanınızın name
değeri spaces/1234567
ise şu URL'yi kullanarak alana gidebilirsiniz:
https://mail.google.com/chat/u/0/#chat/space/1234567
.
İlgili konular
- Alan oluşturun.
- Bir alanla ilgili ayrıntıları öğrenme.
- Alanları listele.
- Alanları güncelleyin.
- Alan silme.
- Doğrudan mesaj alanını bulun.
- Alanları belirli kullanıcılar tarafından bulunabilir hale getirme