Bu kılavuzda, upload
yönteminin Media
kaynağında nasıl kullanılacağı açıklanmaktadır.
Google Chat API'yi kullanarak medya (bir dosya) yükleyin ve ardından bunu
mesaj gönderebilirsiniz.
Kullanıcı, uygulamanıza mesaj gönderdiğinde Google Chat bir mesaj gönderir.
MESSAGE
etkileşim etkinliği.
Uygulamanızın aldığı etkileşim etkinliği, bir istek gövdesini içerir. Bu istek metni,
Etkileşim etkinliğini temsil eden JSON yükü (tüm ekler dahil). İlgili içeriği oluşturmak için kullanılan
ekteki verilerin farklı olup olmadığına bağlı olarak
yüklenen içerik (yerel dosya) veya Drive'da depolanan bir dosyadır. İlgili içeriği oluşturmak için kullanılan
Media
kaynak
Google Chat'e yüklenen resim, video ve doküman gibi bir dosyayı temsil eder.
İlgili içeriği oluşturmak için kullanılan
Attachment
kaynak
bir iletiye ekli medya örneğini (dosya) temsil eder. Attachment
kaynak, ek hakkındaki meta verileri içerir.
kaydedilmektedir.
Ö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.
Dosya eki olarak yükleyin
Medya yüklemek ve bir iletiye eklemek için istek:
chat.messages.create
veyachat.messages
yetkilendirme kapsamını belirtin.- Aşağıdaki Google Chat yöntemlerini çağırın:
- Dosyayı yüklemek için
upload
yöntemMedia
kaynağında.parent
değerini, dosyayı barındıran alanın alan adına ayarlayın.body
bölümünde (istek gövdesi)filename
öğesini yüklenen ad olarak ayarlayın. dosya ekidir.media_body
öğesini, yüklenecek dosyanın bir örneği olarak ayarlayın.
- Yüklenen dosyanın ekli olduğu bir mesaj oluşturmak için
create
yöntem uygulamasındaMessages
kaynak.attachment
öğesini,upload
yöntem uygulamasındaMedia
kaynak.attachment
alanı bir liste kabul eder.
- Dosyayı yüklemek için
Aşağıdaki örnekte bir PNG resim dosyası yüklenir ve bu dosya bir iletiye eklenir.
Python
- Çalışma dizininizde şu ada sahip bir dosya oluşturun:
chat_media_and_attachment_upload.py
Aşağıdaki kodu
chat_media_and_attachment_upload.py
bölümüne ekleyin:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build from googleapiclient.http import MediaFileUpload # 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.create"] def main(): ''' Authenticates with Chat API via user credentials, then uploads a file as media, creates a message, and attaches the file to the 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. service = build('chat', 'v1', credentials=creds) # Upload a file to Google Chat. media = MediaFileUpload('test_image.png', mimetype='image/png') # Create a message and attach the uploaded file to it. attachment_uploaded = service.media().upload( # The space to upload the attachment in. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. parent='spaces/SPACE', # The filename of the attachment, including the file extension. body={'filename': 'test_image.png'}, # Media resource of the attachment. media_body=media ).execute() print(attachment_uploaded) # Create a Chat message with attachment. result = service.spaces().messages().create( # The space to create the message in. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Must match the space name that the attachment is uploaded to. parent='spaces/SPACE', # The message to create. body={ 'text': 'Hello, world!', 'attachment': [attachment_uploaded] } ).execute() print(result) if __name__ == '__main__': main()
Kodda
SPACE
kısmını alan adıyla değiştirerek ek dosyasını yükleyin. Bu dosyayı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_media_and_attachment_upload.py
Chat API, şunu içeren bir yanıt gövdesi döndürüyor:
Yüklenen dosyayla ilgili ayrıntıları içeren attachmentDataRef
.
Sınırlamalar ve dikkat edilmesi gereken noktalar
Dosyaları yüklemeye ve iletilere eklemeye hazırlanırken şunları not edin: ve dikkat edilmesi gereken noktalar:
- 200 MB'a kadar olan dosya boyutlarını yükleyebilirsiniz.
- Bazı dosya türleri desteklenmez ve yüklenemez. Ayrıntılar için bkz. Google Chat'te engellenen dosya türleri.
- İletiniz atlanmalıdır aksesuar widget'ları oluşturun.