Bu kılavuzda, adlandırılmış alan oluşturmak için Google Chat API'nin Space
kaynağında create
yönteminin nasıl kullanılacağı açıklanmaktadır.
Space
kaynağı, kullanıcıların ve Chat uygulamalarının mesaj gönderebileceği, dosya paylaşabileceği ve ortak çalışma yapabileceği bir yeri temsil eder. Birkaç alan türü vardır:
- Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı ile bir 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.
Adlandırılmış alan, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalışmalar yaptığı bir yerdir. Adlandırılmış alanlar Chat uygulamalarını içerebilir. Adlandırılmış alanlarda, yönetim ayarlarını ve açıklamaları uygulayabilen, kullanıcı ve uygulama ekleyip kaldırabilen alan yöneticileri gibi adsız grup görüşmelerinde ve doğrudan mesajlarda bulunmayan ek özellikler bulunur. Adlandırılmış alan oluşturulduktan sonra alanın tek üyesi kimliği doğrulanmış kullanıcıdır. Alanda başka kullanıcılar veya uygulamalar yer almaz, alanı oluşturan Chat uygulaması dahil değildir. Kullanıcı eklemek için Member
kaynağındaki create
yöntemini çağırarak alanda üyelik oluşturun.
Bunu nasıl yapacağınızı öğrenmek için Üyelik oluşturma başlıklı makaleyi inceleyin.
Birden çok üyeli adlandırılmış alan (üç veya daha fazla kişi arasındaki adsız grup sohbeti, iki kişi arasındaki doğrudan mesaj görüşmesi veya bir kişi ile Chat API'yi çağıran Chat uygulaması) oluşturmak için alan oluşturun.
Ön koşullar
Python
- Python 3.6 veya sonraki sürümler
- pip paket yönetimi aracı
Python için en yeni Google istemci kitaplıkları. Bunları yüklemek veya güncellemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Google Chat API'nin etkinleştirildiği ve yapılandırıldığı bir Google Cloud projesi Adımlar için Google Chat uygulaması oluşturma başlıklı makaleyi inceleyin.
Chat uygulaması için yetkilendirme yapılandırıldı. Alan oluşturmak için
chat.spaces.create
veyachat.spaces
yetkilendirme kapsamıyla kullanıcı kimlik doğrulaması gerekir.
Node.js
- Node.js ve npm
Node.js için en yeni Google istemci kitaplıkları. Bunları yüklemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:
npm install @google-cloud/local-auth @googleapis/chat
- Google Chat API'nin etkinleştirildiği ve yapılandırıldığı bir Google Cloud projesi Adımlar için Google Chat uygulaması oluşturma başlıklı makaleyi inceleyin.
Chat uygulaması için yetkilendirme yapılandırıldı. Alan oluşturmak için
chat.spaces.create
veyachat.spaces
yetkilendirme kapsamıyla kullanıcı kimlik doğrulaması gerekir.
Adlandırılmış alan oluşturma
Adlandırılmış alan oluşturmak için isteğinizde aşağıdakileri iletin:
chat.spaces.create
veyachat.spaces
yetkilendirme kapsamını belirtin.Space
kaynağındacreate
yöntemini çağırın.spaceType
değeriniSPACE
olarak ayarlayın.displayName
alanını, kullanıcının görebildiği alan adına ayarlayın. Aşağıdaki örnektedisplayName
,API-made
olarak ayarlanmıştır.- İsteğe bağlı olarak
spaceDetails
gibi diğer alan özelliklerini (kullanıcının görebileceği bir açıklama ve alan için bir dizi yönerge) ayarlayın.
Adlandırılmış alan oluşturmak için aşağıdaki adımları uygulayın:
Python
- Çalışma dizininizde
chat_space_create_named.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_space_create_named.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 creates a Chat space. ''' # 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().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).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_create_named.py
Node.js
- Çalışma dizininizde
create-space.js
adlı bir dosya oluşturun. Aşağıdaki kodu
create-space.js
bölümüne ekleyin:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { 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.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
Çalışma dizininizde örneği çalıştırın:
node create-space.js
Adlandırılmış bir alan oluşturulur. Alana gitmek için alanın kaynak kimliğini kullanarak alanın URL'sini oluşturun. name
alanındaki kaynak kimliğini Google Chat yanıt gövdesinde bulabilirsiniz. Ö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
- Üye oluşturarak alana kullanıcı ve uygulama ekleyin.
- Bir mesaj oluşturarak alanda mesaj yayınlayın.
- Bir alanla ilgili ayrıntıları öğrenin.
- Alanları listeleyin.
- Alan güncelleme
- Alanı silebilirsiniz.
- Alan oluşturun.
- Doğrudan mesaj alanı bulun.
- Bir alanı belirli kullanıcılar tarafından bulunabilir hale getirin.