Method: files.insert

একটি নতুন ফাইল সন্নিবেশ করান।

এই পদ্ধতিটি একটি /upload URI সমর্থন করে এবং নিম্নলিখিত বৈশিষ্ট্য সহ আপলোড করা মিডিয়া গ্রহণ করে:

  • সর্বোচ্চ ফাইলের আকার: ৫,১২০ জিবি
  • গ্রহণযোগ্য মিডিয়া MIME প্রকার: */*

দ্রষ্টব্য: আক্ষরিক */* মানের পরিবর্তে একটি বৈধ MIME প্রকার উল্লেখ করুন। আক্ষরিক */* কেবলমাত্র যেকোনো বৈধ MIME প্রকার আপলোড করা যেতে পারে তা নির্দেশ করার জন্য ব্যবহৃত হয়।

ফাইল আপলোড করার বিষয়ে আরও তথ্যের জন্য, ফাইল ডেটা আপলোড দেখুন।

files.insert দিয়ে শর্টকাট তৈরি করা অ্যাপগুলিকে অবশ্যই MIME টাইপ application/vnd.google-apps.shortcut উল্লেখ করতে হবে।

API ব্যবহার করে ফাইল সন্নিবেশ করার সময় অ্যাপগুলিকে title প্রপার্টিতে একটি ফাইল এক্সটেনশন নির্দিষ্ট করতে হবে। উদাহরণস্বরূপ, JPEG ফাইল সন্নিবেশ করার জন্য একটি অপারেশনে মেটাডেটাতে "title": "cat.jpg" এর মতো কিছু নির্দিষ্ট করতে হবে।

পরবর্তী GET অনুরোধগুলিতে শুধুমাত্র পঠনযোগ্য fileExtension বৈশিষ্ট্য অন্তর্ভুক্ত থাকে যা মূলত title বৈশিষ্ট্যে নির্দিষ্ট এক্সটেনশন দিয়ে পূর্ণ হয়। যখন কোনও গুগল ড্রাইভ ব্যবহারকারী কোনও ফাইল ডাউনলোড করার অনুরোধ করেন, অথবা যখন সিঙ্ক ক্লায়েন্টের মাধ্যমে ফাইলটি ডাউনলোড করা হয়, তখন ড্রাইভ শিরোনামের উপর ভিত্তি করে একটি সম্পূর্ণ ফাইলের নাম (এক্সটেনশন সহ) তৈরি করে। যেখানে এক্সটেনশনটি অনুপস্থিত থাকে, ড্রাইভ ফাইলের MIME ধরণের উপর ভিত্তি করে এক্সটেনশন নির্ধারণ করার চেষ্টা করে।

HTTP অনুরোধ

  • মিডিয়া আপলোড অনুরোধের জন্য URI আপলোড করুন:
    POST https://www.googleapis.com/upload/drive/v2/files
  • মেটাডেটা-শুধুমাত্র অনুরোধের জন্য মেটাডেটা URI:
    POST https://www.googleapis.com/drive/v2/files

URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

কোয়েরি প্যারামিটার

পরামিতি
convert

boolean

এই ফাইলটিকে সংশ্লিষ্ট ডক্স এডিটর ফর্ম্যাটে রূপান্তর করা হবে কিনা।

enforceSingleParent
(deprecated)

boolean

বন্ধ করা হয়েছে: একাধিক ফোল্ডারে ফাইল তৈরি করা আর সমর্থিত নয়।

ocr

boolean

.jpg, .png, .gif, অথবা .pdf আপলোডে OCR ব্যবহার করার চেষ্টা করবেন কিনা।

ocrLanguage

string

যদি ocr সত্য হয়, তাহলে ব্যবহারের ভাষা নির্দেশ করে। বৈধ মান হল BCP 47 কোড।

pinned

boolean

আপলোড করা ফাইলের হেড রিভিশন পিন করা হবে কিনা। একটি ফাইলে সর্বাধিক ২০০টি পিন করা রিভিশন থাকতে পারে।

supportsAllDrives

boolean

অনুরোধ করা অ্যাপ্লিকেশনটি আমার ড্রাইভ এবং শেয়ার্ড ড্রাইভ উভয়কেই সমর্থন করে কিনা।

supportsTeamDrives
(deprecated)

boolean

বন্ধ করা হয়েছে: এর পরিবর্তে supportsAllDrives ব্যবহার করুন।

timedTextLanguage

string

সময় নির্ধারিত লেখার ভাষা।

timedTextTrackName

string

সময় নির্ধারিত টেক্সট ট্র্যাকের নাম।

uploadType

string

/upload URI-তে আপলোড অনুরোধের ধরণ। যদি আপনি /upload URI দিয়ে ডেটা আপলোড করেন, তাহলে এই ক্ষেত্রটি প্রয়োজন। যদি আপনি একটি মেটাডেটা-কেবল ফাইল তৈরি করেন, তাহলে এই ক্ষেত্রটি প্রয়োজন হয় না। অতিরিক্তভাবে, "এই পদ্ধতিটি ব্যবহার করে দেখুন" উইজেটে এই ক্ষেত্রটি দেখানো হয় না কারণ উইজেটটি ডেটা আপলোড সমর্থন করে না।

গ্রহণযোগ্য মানগুলি হল:

  • media - সহজ আপলোড । কোনও মেটাডেটা ছাড়াই কেবল মিডিয়া আপলোড করুন।
  • multipart - মাল্টিপার্ট আপলোড । একটি একক অনুরোধে মিডিয়া এবং এর মেটাডেটা উভয়ই আপলোড করুন।
  • resumable - পুনঃসূচনাযোগ্য আপলোড । ফাইলটি পুনঃসূচনাযোগ্য পদ্ধতিতে আপলোড করুন, কমপক্ষে দুটি অনুরোধের একটি সিরিজ ব্যবহার করে যেখানে প্রথম অনুরোধে মেটাডেটা অন্তর্ভুক্ত থাকে।
useContentAsIndexableText

boolean

কন্টেন্টটিকে ইনডেক্সেবল টেক্সট হিসেবে ব্যবহার করবেন কিনা।

visibility

enum ( Visibility )

নতুন ফাইলের দৃশ্যমানতা। অনুমতিগুলি এখনও প্যারেন্ট ফোল্ডার থেকে উত্তরাধিকারসূত্রে পাওয়া যায়। এই প্যারামিটারটি শুধুমাত্র convert=false এর ক্ষেত্রেই প্রাসঙ্গিক।

includePermissionsForView

string

প্রতিক্রিয়ায় কোন অতিরিক্ত ভিউয়ের অনুমতি অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করে। শুধুমাত্র published সমর্থিত।

includeLabels

string

প্রতিক্রিয়ার labelInfo অংশে অন্তর্ভুক্ত করার জন্য লেবেলের আইডিগুলির একটি কমা দ্বারা পৃথক তালিকা।

অনুরোধের মূল অংশ

অনুরোধের বডিতে File এর একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে রেসপন্স বডিতে File এর একটি উদাহরণ থাকবে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file

কিছু স্কোপ সীমাবদ্ধ এবং আপনার অ্যাপের সেগুলি ব্যবহারের জন্য একটি নিরাপত্তা মূল্যায়ন প্রয়োজন। আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।