Bu kılavuzda, get
yönteminin Message
kaynağında nasıl kullanılacağı açıklanmaktadır.
Google Chat API'yi kullanarak kısa mesaj veya kart mesajıyla ilgili ayrıntıları döndürür.
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ığı.
- Google Chat API'nizde nasıl kimlik doğrulama yapmak istediğinize bağlı olarak erişim kimlik bilgilerini oluşturun
istek:
- Chat kullanıcısı olarak kimliğinizi doğrulamak için:
OAuth istemci kimliği oluştur
kimlik bilgilerini iki kez tıklayın ve kimlik bilgilerini
client_secrets.json
dosyasını yerel dizininize ekleyin. - Chat uygulaması olarak kimliğinizi doğrulamak için:
hizmet hesabı oluştur
kimlik bilgilerini iki kez tıklayın ve kimlik bilgilerini
credentials.json
.
- Chat kullanıcısı olarak kimliğinizi doğrulamak için:
OAuth istemci kimliği oluştur
kimlik bilgilerini iki kez tıklayın ve kimlik bilgilerini
- Kimlik doğrulamasını kullanıcı olarak mı yoksa Chat uygulaması.
Kullanıcı kimlik doğrulaması yapılmış bir mesaj alma
İletiyle ilgili ayrıntıları almak 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:
get
yöntem uygulamasındaMessage
kaynak. - Alınacak mesajın kaynak adına
name
değerini ayarlayın.
Aşağıdaki örnekte kullanıcı kimlik doğrulaması:
Python
- Çalışma dizininizde
chat_message_get_user.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_message_get_user.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 gets a message. ''' # 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().get( # The message to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name = 'spaces/SPACE/messages/MESSAGE' ).execute() # Prints details about the message. print(result) if __name__ == '__main__': main()
Bu kodda, aşağıdakini değiştirin:
SPACE
: şuradan alabileceğiniz bir alan adı: "the"spaces.list
yöntem API'den veya bir alanın URL'sinden.MESSAGE
: edinebileceğiniz bir mesaj adı eşzamansız olarak bir ileti oluşturduktan sonra döndürülen yanıt gövdesinden veya özel ad , oluşturma sırasında mesaja atanır.
Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_message_get_user.py
Chat API,
Message
öğesini tıklayın.
Uygulama kimlik doğrulamasını kullanarak mesaj alma
İletiyle ilgili ayrıntıları almak için uygulama kimlik doğrulaması, isteğinizde aşağıdakileri iletin:
chat.bot
yetkilendirme kapsamını belirtin.- Şunu çağırın:
get
yöntem uygulamasındaMessage
kaynak. - Alınacak mesajın kaynak adına
name
değerini ayarlayın.
Aşağıdaki örnekte uygulama kimlik doğrulaması:
Python
- Çalışma dizininizde
chat_get_message_app.py
adlı bir dosya oluşturun. Aşağıdaki kodu
chat_get_message_app.py
bölümüne ekleyin:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Get a Chat message. result = chat.spaces().messages().get( # The message to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name='spaces/SPACE/messages/MESSAGE' ).execute() # Print Chat API's response in your command line interface. print(result)
Bu kodda, aşağıdakini değiştirin:
SPACE
: alanınname
. mesajı gönderilir. Bu mesajıspaces.list
yöntemi API'den veya bir alanın URL'sinden.MESSAGE
: Edinebileceğiniz mesaj adı eşzamansız olarak bir ileti oluşturduktan sonra döndürülen yanıt gövdesinden veya özel ad , oluşturma sırasında mesaja atanır.
Çalışma dizininizde örneği derleyin ve çalıştırın:
python3 chat_get_message_app.py
Chat API,
Message
öğesini tıklayın.
İlgili konular
- İletiyi biçimlendirme
- İletiyi silme
- Bir alandaki mesajları listeleyin.
- Mesajları güncelleme
- Mesaj gönderin.