Method: media.upload

یک پیوست را آپلود می کند. برای مثال، آپلود رسانه به عنوان پیوست فایل را ببینید.

نیاز به احراز هویت کاربر دارد.

می توانید فایل های پیوست را تا 200 مگابایت آپلود کنید. انواع خاصی از فایل پشتیبانی نمی شوند. برای جزئیات، انواع فایل مسدود شده توسط Google Chat را ببینید.

درخواست HTTP

  • URI آپلود، برای درخواست های آپلود رسانه:
    POST https://chat.googleapis.com/upload/v1/{parent=spaces/*}/attachments:upload

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
parent

string

مورد نیاز. نام منبع فضای چت که پیوست در آن آپلود شده است. فرمت "space/{space}".

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "filename": string
}
فیلدها
filename

string

مورد نیاز. نام فایل پیوست، از جمله پسوند فایل.

بدن پاسخگو

پاسخ آپلود یک پیوست.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "attachmentDataRef": {
    object (AttachmentDataRef)
  }
}
فیلدها
attachment Data Ref

object ( AttachmentDataRef )

ارجاع به پیوست بارگذاری شده

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages.create
  • https://www.googleapis.com/auth/chat.messages

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.