Bu kılavuzda, list
yönteminin Message
kaynağında nasıl kullanılacağı açıklanmaktadır.
Google Chat API'yi kullanarak alandaki mesajların sayfalara ayrılmış ve filtrelenebilir bir listesini görüntüleyebilirsiniz.
İlgili içeriği oluşturmak için kullanılan
Message
kaynak
temsil eder
metin
veya
kart
mesajı görebilirsiniz. Şunları yapabilirsiniz:
Şu numarayı arayarak Google Chat API'de bir mesaj: create
, get
, update
veya delete
yöntemler. Kısa mesajlar ve kart mesajları hakkında daha fazla bilgi edinmek için bkz.
Google Chat mesajlarına genel bakış
Ö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.
Mesajları listeleme
Mesajları şununla listelemek için: kullanıcı kimlik doğrulaması, isteğinizde aşağıdakileri iletin:
chat.messages.readonly
veyachat.messages
yetkilendirme kapsamını belirtin.- Şunu çağırın:
list
yöntem uygulamasındaMessage
kaynak.
Aşağıdaki örnekte, bir Chat alanında şu tarihten sonra gönderilen mesajlar listelenmektedir: 16 Mart 2023:
Python
- Çalışma dizininizde
chat_messages_list.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_messages_list.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.messages.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then lists messages in a space sent after March 16, 2023. ''' # 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().messages().list( # The space for which to list messages. parent = 'spaces/SPACE', # An optional filter that returns messages # created after March 16, 2023. filter = 'createTime > "2023-03-16T00:00:00-00:00"' ).execute() # Prints the list of messages. 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_messages_list.py
Google Chat API, belirtilen alanda şu tarihten sonra gönderilen mesajların listesini döndürür: 16 Mart 2023.
İlgili konular
- İletiyi biçimlendirme
- İletiyi silme
- Bir mesajla ilgili ayrıntıları öğrenme
- Mesajları güncelleme
- Mesaj gönderin.