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

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