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.
Chat API'de bir Chat mesajı
Message
kaynak.
Chat kullanıcıları yalnızca metin içeren mesajlar gönderebilir.
Chat uygulamaları, aşağıdakiler de dahil olmak üzere pek çok mesajlaşma özelliğini kullanabilir:
statik veya etkileşimli kullanıcı arayüzleri gösterme,
ve mesajları gizli olarak teslim edebilirsiniz. Mesajlaşma hakkında daha fazla bilgi edinmek için
özellikleri hakkında daha fazla bilgi için
Google Chat mesajlarına genel bakış
Ö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.
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
Chat API, belirtilen alanda gönderilen mesajların listesini döndürür
%20'ye ulaştı. İstekte herhangi bir mesaj yoksa
Chat API yanıtı boş bir nesne döndürüyor.
REST/HTTP arayüzünde, yanıt boş bir JSON nesnesi ({}
) içeriyor.
İlgili konular
- İletiyi biçimlendirme
- İletiyi silme
- Bir mesajla ilgili ayrıntıları öğrenme
- Mesajları güncelleme
- Mesaj gönderin.