Method: files.insert

একটি নতুন ফাইল যুক্ত করে।

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

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

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

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

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

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

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

HTTP অনুরোধ

  • মিডিয়া আপলোড অনুরোধের জন্য আপলোড ইউআরআই:
    POST https://www.googleapis.com/upload/drive/v2/files
  • মেটাডেটা ইউআরআই, শুধুমাত্র মেটাডেটা-সংক্রান্ত অনুরোধের জন্য:
    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

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