Method: files.create

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

عامل URL یا باینری فایل و (به صورت اختیاری) URL فایل تصویر کوچک مربوطه را ارائه می کند.

مهم: برای حفظ حریم خصوصی و امنیت کاربر، پلتفرم RBM فایل‌های رسانه‌ای و PDF را قبل از تحویل به کاربر از URL‌های ارائه‌شده دانلود و پردازش می‌کند. این از ردیابی عامل توسط URL های منحصر به فرد جلوگیری می کند. بنابراین، حجم بالایی از URL های منحصر به فرد را ارسال نکنید. پلتفرم RBM از این پشتیبانی نمی‌کند، چه URLها به فایل‌های مشابه یا متفاوتی اشاره کنند. از همان URL برای فایل های یکسان استفاده کنید.

پلت فرم RBM فایل را به مدت 60 روز در حافظه پنهان نگه می دارد و یک نام منحصر به فرد را برمی گرداند که می توانید برای شناسایی فایل هنگام ارسال پیام های نماینده استفاده کنید.

برای آپلود یک فایل باینری، یک درخواست HTTP POST به URI آپلود کنید، فیلد fileUrl را از بدنه درخواست JSON حذف کنید و باینری را به عنوان بدنه درخواست POST مشخص کنید. برای مثال، از پرچم --upload-file cURL با مسیر فایل کاملا واجد شرایط فایل باینری استفاده کنید.

درخواست HTTP

  • URI آپلود، برای درخواست های آپلود رسانه:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI فراداده، برای درخواست‌های فقط فراداده:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

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

درخواست بدن

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

نمایندگی JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
فیلدها
fileUrl

string

اختیاری. URL فایل در دسترس عموم. هنگام واکشی فایل، پلتفرم RBM نوع MIME فایل را از قسمت نوع محتوا در هدرهای HTTP تعیین می کند. RBM از تصویر، صدا، ویدئو و pdf پشتیبانی می کند.

انواع محتوای تصویر پشتیبانی شده: image/jpeg، image/jpg، image/gif، image/png.

انواع محتوای صوتی پشتیبانی شده: audio/aac، audio/mp3، audio/mpeg، audio/mpg، audio/mp4، audio/mp4-latm، audio/3gpp، application/ogg، audio/ogg.

انواع محتوای ویدیویی پشتیبانی شده: video/h263، video/m4v، video/mp4، video/mpeg، video/mpeg4، video/webm.

انواع محتوای pdf پشتیبانی شده: برنامه/pdf.

thumbnailUrl

string

اختیاری. URL تصویر کوچک مربوط به فایل به صورت عمومی در دسترس است. اگر این فیلد تنظیم نشده باشد، پلت فرم RBM به طور خودکار یک تصویر کوچک از فایل ایجاد می کند. هنگام واکشی فایل، پلتفرم RBM نوع MIME فایل را از قسمت نوع محتوا در هدرهای HTTP تعیین می کند.

انواع محتوای تصویر پشتیبانی شده: image/jpeg، image/jpg، image/gif، image/png.

agentId

string

مورد نیاز. شناسه منحصر به فرد عامل.

بدن پاسخگو

یک منبع فایل با یک نام منحصر به فرد که یک نماینده می تواند برای شناسایی فایل هنگام ارسال پیام استفاده کند.

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

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

string

نام منحصر به فرد منبع فایل اختصاص داده شده به سرور، که یک عامل می تواند برای شناسایی فایل هنگام ارسال پیام استفاده کند. قالب "files/{uid}" است، که در آن {uid} یک شناسه منحصر به فرد است.

محدوده مجوز

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

  • https://www.googleapis.com/auth/rcsbusinessmessaging

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .