Method: media.upload

رسانه ها را برای نمایه سازی آپلود می کند.

نقطه پایانی آپلود از پروتکل‌های آپلود مستقیم و قابل ازسرگیری پشتیبانی می‌کند و برای موارد بزرگی در نظر گرفته شده است که نمی‌توان آنها را در طول درخواست‌های نمایه خط‌بندی کرد . برای ایندکس کردن محتوای بزرگ:

  1. برای شروع جلسه آپلود و بازیابی UploadItemRef ، indexing.datasources.items.upload با نام مورد فراخوانی کنید.
  2. با media.upload تماس بگیرید تا محتوا را به عنوان درخواست پخش جریانی با استفاده از همان نام منبع از UploadItemRef از مرحله 1 آپلود کنید.
  3. برای ایندکس کردن مورد indexing.datasources.items.index را فراخوانی کنید. ItemContent را با UploadItemRef از مرحله 1 پر کنید.

برای اطلاعات بیشتر، به ایجاد رابط محتوا با استفاده از REST API مراجعه کنید.

توجه: این API برای اجرا به یک حساب سرویس نیاز دارد.

درخواست HTTP

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

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

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

پارامترها
resourceName

string

نام رسانه ای که در حال دانلود است. ReadRequest.resource_name ببینید.

درخواست بدن

بدنه درخواست شامل یک نمونه از Media است.

بدن پاسخگو

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

منبع رسانه ای

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

string

نام منبع رسانه ای

محدوده مجوز

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

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

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