Bu kılavuzda, setup
yönteminin Space
kaynağında nasıl kullanılacağı açıklanmaktadır.
Google Chat API'ye gidin. Alan oluşturulduğunda alan oluşturulur
ve belirtilen kullanıcıları buna ekler.
İlgili içeriği oluşturmak için kullanılan
Space
kaynak
kullanıcıların ve Chat uygulamalarının mesaj gönderebildiği,
dosya paylaşabilir ve ortak çalışabilirsiniz. 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ışma yapabilirsiniz.
Alan oluştururken aşağıdakileri göz önünde bulundurun:
- Arayan (kimliği doğrulanmış) kullanıcı, alana otomatik olarak eklenir. Böylece 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 üyeliklerden hiçbiri sağlanmamışsa başarıyla eklenmişse (örneğin, izin sorunu), ardından boş bir grup sohbeti (yalnızca arayan kullanıcı dahil) oluşturulabilir.
- Mesaj dizili yanıtlar içeren alanlar oluşturamaz veya hesabınızın dışındaki kullanıcıları ekleyemezsiniz Google Workspace
- İstekte yinelenen üyelikler (arayan kullanıcı dahil) sağlanmış filtrelendiğinden emin olun.
Ön koşullar
Python
- İş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ı.
- Şunu yükleyin: Python Google API İstemci Kitaplığı.
-
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.
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.
- 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ı.
- Şunu yükleyin: Node.js Google API İstemci Kitaplığı.
-
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.
Alan oluşturma
Alan oluşturmak için isteğinizde aşağıdakileri iletin:
chat.spaces.create
veyachat.spaces
yetkilendirme kapsamını belirtin.- Şunu çağırın:
setup
yöntemSpace
kaynağında. - Bir gerçek kullanıcıyı alan üyesi olarak eklemek için
users/{user}
değerini belirtin. Burada{user}
öğe için{person_id}
person
People API'den veya bir kullanıcınınuser
bulun. Örneğin, People APIresourceName
people/123456789
. Kullanıcıyı alana ekleyebilirsiniz:member.name
olarakusers/123456789
üyeliği de buna dahildir. - Bir grubu alan üyesi olarak eklemek için
groups/{group}
değerini belirtin. Burada{group}
kelimesi kullanılır. üyelik oluşturmak istediğiniz grup kimliğini girin. Grubun kimliği şunları yapabilir: Cloud Identity API kullanılarak alınabilir. Örneğin, Cloud Identity APIgroups/123456789
adlı bir grup döndürür, ardındanmembership.groupMember.name
-groups/123456789
. Google Grupları, ancak yalnızca adlandırılmış bir alana eklenmiş olması gerekir. - Arayan kullanıcı ile başka bir kişi arasında DM oluşturmak için kullanıcı olarak, 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ındantrue
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 alana üyelikler oluşturuluyor bir grup ve üç gerçek kullanıcı (kimliği doğrulanmış kullanıcı ve belirtilen diğer kullanıcılar).
Python
- Çalışma dizininizde
chat_space_setup.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_space_setup.py
bölümüne ekleyin:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then sets up a Chat space by creating a space and adding members. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().setup( # Details about the space to set up. body = { # Attributes of the space to set up, like space type and display name. 'space': { # To set up a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space 'displayName': 'API-setup' }, # The users and groups to add to the space. # # The authenticated user is automatically added to the space, # and doesn't need to be specified in the memberships array. 'memberships': [ { 'member': { 'name':'users/123456789', 'type': 'HUMAN' } }, { 'member': { 'name':'users/987654321', 'type': 'HUMAN' } }, { 'groupMember': { 'name': 'groups/11223344' } } ] } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_space_setup.py
Node.js
- Çalışma dizininizde
setup-space.js
adlı bir dosya oluşturun. Aşağıdaki kodu
setup-space.js
bölümüne ekleyin:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Sets up a new Chat space with users. * @return {!Promise<!Object>} */ async function setupSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.setup({ requestBody: { space: { spaceType: 'SPACE', displayName: 'API-made', }, memberships: [ {member: {name: 'users/123456789', type: 'HUMAN'}}, {member: {name: 'users/987654321', type: 'HUMAN'}}, {groupMember: {name: 'groups/11223344'}}, ] } }); } setupSpace().then(console.log);
Çalışma dizininizde örneği çalıştırın:
node setup-space.js
Bir grup ve üç gerçek kullanıcının bulunduğu, adlandırılmış sohbet alanı ayarlanmış olduğundan emin olun.
Alana gitmek için alanın kaynak kimliğini kullanarak alanın URL'sini oluşturun.
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.
- Alan güncelleme
- Alanı silebilirsiniz.
- Doğrudan mesaj alanı bulun.
- Bir alanı belirli kullanıcılar tarafından bulunabilir hale getirin.