Bu kılavuzda, patch
yönteminin Space
kaynağında nasıl kullanılacağı açıklanmaktadır.
Google Chat API'yi kullanarak alanı güncelleyebilirsiniz. Bir alanla ilgili özellikleri değiştirmek için
alanı (kullanıcı tarafından görülebilen görünen ad, açıklama ve yönergeler gibi) içerir.
İ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.
Ön koşullar
Python
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
- Python 3.6 veya sonraki sürümler
- pip paket yönetim aracı
- En yeni Google istemci kitaplıkları. Bu uygulamaları 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
- 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ı.
-
Bir masaüstü uygulaması için OAuth istemci kimliği kimlik bilgileri oluşturun. Örneği bu
yoksa kimlik bilgilerini JSON dosyası (
client_secrets.json
) 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.
- Node.js 14 veya sonraki sürümler
- npm paket yönetim aracı
- En yeni Google istemci kitaplıkları. Bu uygulamaları yüklemek veya güncellemek 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
- 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ı.
-
Bir masaüstü uygulaması için OAuth istemci kimliği kimlik bilgileri oluşturun. Örneği bu
yoksa kimlik bilgilerini JSON dosyası (
client_secrets.json
) olarak yerel dizini oluşturun.
- Kullanıcı kimlik doğrulamasını destekleyen bir yetkilendirme kapsamı seçin.
Alanı güncelleme
Google Chat'te mevcut bir alanı güncellemek için aşağıdaki adımları uygulayın: talebinizde:
chat.spaces
yetkilendirme kapsamını belirtin.- Şunu çağırın:
patch
yöntemSpace
kaynağında. İçinde isteğiniz için, boşlukname
alanınıupdateMask
Güncellenecek bir veya daha fazla alan ve bir Güncellenen alan bilgileriylebody
.
Görünen ad, alan türü, geçmiş durumu ve daha fazla. Güncelleyebileceğiniz tüm alanları görmek için referans belgelerini inceleyin.
Mevcut bir alanın spaceDetails
alanını güncellemek için:
Python
- Çalışma dizininizde
chat_space_update.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_space_update.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"] def main(): ''' Authenticates with Chat API via user credentials, then updates the specified space description and guidelines. ''' # 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().patch( # The space to update, and the updated space details. # # Replace {space} with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. name='spaces/SPACE', updateMask='spaceDetails', body={ 'spaceDetails': { 'description': 'This description was updated with Chat API!', 'guidelines': 'These guidelines were updated with Chat API!' } } ).execute() # Prints details about the updated space. print(result) if __name__ == '__main__': main()
Kodda,
SPACE
öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_space_update.py
Node.js
- Çalışma dizininizde
update-space.js
adlı bir dosya oluşturun. Aşağıdaki kodu
update-space.js
bölümüne ekleyin:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Updates a Chat space with the description and guidelines. * @return {!Promise<!Object>} */ async function updateSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.patch({ name: 'spaces/SPACE', updateMask: 'spaceDetails', requestBody: { spaceDetails: { description: 'This description was updated with Chat API!', guidelines: 'These guidelines were updated with Chat API!' }, } }); } updateSpace().then(console.log);
Kodda,
SPACE
öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz:spaces.list
yöntem API'den veya bir alanın URL'sinden.Çalışma dizininizde örneği çalıştırın:
node update-space.js
Google Chat API,
Güncellemeleri yansıtan Space
kaynağı.
İlgili konular
- Bir alanla ilgili ayrıntıları öğrenin.
- Alanları listeleyin.
- Alanı silebilirsiniz.
- Alan oluşturun.
- Doğrudan mesaj alanı bulun.
- Bir alanı belirli kullanıcılar tarafından bulunabilir hale getirin.