Mesajları listeleme

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

Mesajları listeleme

Mesajları şununla listelemek için: kullanıcı kimlik doğrulaması, isteğinizde aşağıdakileri iletin:

  • chat.messages.readonly veya chat.messages yetkilendirme kapsamını belirtin.
  • Şunu çağırın: list yöntem uygulamasında Message kaynak.

Aşağıdaki örnekte, bir Chat alanında şu tarihten sonra gönderilen mesajlar listelenmektedir: 16 Mart 2023:

Python

  1. Çalışma dizininizde chat_messages_list.py adlı bir dosya oluşturun.

  2. 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()

  3. Kodda, SPACE öğesini bir alan adıyla değiştirin. şuradan edinebilirsiniz: spaces.list yöntem API'den veya bir alanın URL'sinden.

  4. Ç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.