Method: media.upload

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

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

درخواست HTTP

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

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

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

مولفه های
parent

string

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

درخواست بدن

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

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

string

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

بدن پاسخگو

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

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

نمایندگی JSON
{
  "attachmentDataRef": {
    object (AttachmentDataRef)
  }
}
زمینه های
attachmentDataRef

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

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