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.

İ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

  • 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

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

Google Chat API, belirtilen alanda şu tarihten sonra gönderilen mesajların listesini döndürür: 16 Mart 2023.