Method: files.list

ব্যবহারকারীর ফাইলগুলোর তালিকা দেখায়। আরও তথ্যের জন্য, ফাইল ও ফোল্ডার অনুসন্ধান দেখুন।

এই পদ্ধতিতে q প্যারামিটারটি গৃহীত হয়, যা এক বা একাধিক সার্চ টার্মের সমন্বয়ে গঠিত একটি সার্চ কোয়েরি।

এই মেথডটি ডিফল্টরূপে ট্র্যাশ করা ফাইলসহ সমস্ত ফাইল রিটার্ন করে। যদি আপনি তালিকায় ট্র্যাশ করা ফাইলগুলো দেখতে না চান, তাহলে ফলাফল থেকে ট্র্যাশ করা ফাইলগুলো বাদ দিতে trashed=false কোয়েরি প্যারামিটারটি ব্যবহার করুন।

HTTP অনুরোধ

GET https://www.googleapis.com/drive/v3/files

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

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

প্যারামিটার
corpora

string

আইটেমগুলির (ফাইল বা নথি) একটি সংগ্রহ নির্দিষ্ট করে, যার উপর কোয়েরিটি প্রযোজ্য। সমর্থিত আইটেমগুলির মধ্যে রয়েছে:

  • user
  • domain
  • drive
  • allDrives

দক্ষতার জন্য allDrives পরিবর্তে user বা drive কে প্রাধান্য দিন। ডিফল্টরূপে, corpora user এ সেট করা থাকে। তবে, q প্যারামিটারের মাধ্যমে সেট করা ফিল্টারের উপর নির্ভর করে এটি পরিবর্তিত হতে পারে। আরও তথ্যের জন্য, ফাইল অর্গানাইজেশন (File organization ) দেখুন।

corpus
(deprecated)

enum ( Corpus )

অপ্রচলিত: তালিকাভুক্ত করার জন্য ফাইলগুলির উৎস। এর পরিবর্তে corpora ব্যবহার করুন।

driveId

string

অনুসন্ধান করার জন্য শেয়ার্ড ড্রাইভের আইডি।

includeItemsFromAllDrives

boolean

ফলাফলে মাই ড্রাইভ এবং শেয়ার্ড ড্রাইভ উভয়ের আইটেম অন্তর্ভুক্ত করা হবে কিনা।

includeTeamDriveItems
(deprecated)

boolean

অপ্রচলিত: এর পরিবর্তে includeItemsFromAllDrives ব্যবহার করুন।

orderBy

string

সর্ট কী-গুলোর একটি কমা দ্বারা পৃথক করা তালিকা। বৈধ কী-গুলো হলো:

  • createdTime : ফাইলটি কখন তৈরি করা হয়েছিল। বড় আইটেম কালেকশনের কোয়েরির জন্য এই কী-টি ব্যবহার করা থেকে বিরত থাকুন, কারণ এর ফলে টাইমআউট বা অন্যান্য সমস্যা হতে পারে। বড় আইটেম কালেকশনে সময়-ভিত্তিক সর্টিংয়ের জন্য এর পরিবর্তে modifiedTime ব্যবহার করুন।
  • folder : ফোল্ডার আইডি। এই ফিল্ডটি বর্ণানুক্রমিকভাবে সাজানো থাকে।
  • modifiedByMeTime : ব্যবহারকারী কর্তৃক ফাইলটি সর্বশেষ পরিবর্তনের সময়।
  • modifiedTime : ফাইলটি সর্বশেষ কখন পরিবর্তন করা হয়েছিল।
  • name : ফাইলের নাম। এই ক্ষেত্রটি বর্ণানুক্রমিকভাবে সাজানো থাকে, যেমন ১, ১২, ২, ২২।
  • name_natural : ফাইলের নাম। এই ফিল্ডটি স্বাভাবিক ক্রম অনুসারে সাজানো হয়, যেমন ১, ২, ১২, ২২।
  • quotaBytesUsed : ফাইলটি দ্বারা ব্যবহৃত স্টোরেজ কোটা বাইটের সংখ্যা।
  • recency : ফাইলটির তারিখ-সময় ক্ষেত্র থেকে প্রাপ্ত সর্বশেষ সময়চিহ্ন।
  • sharedWithMeTime : ফাইলটি ব্যবহারকারীর সাথে কখন শেয়ার করা হয়েছিল, যদি প্রযোজ্য হয়।
  • starred : ব্যবহারকারী ফাইলটিকে তারকাচিহ্নিত করেছেন কিনা।
  • viewedByMeTime : ব্যবহারকারী কর্তৃক ফাইলটি সর্বশেষ দেখার সময়।

ডিফল্টরূপে প্রতিটি কী আরোহী ক্রমে সাজানো হয়, কিন্তু desc মডিফায়ার ব্যবহার করে এটি বিপরীত করা যায়। ব্যবহারের উদাহরণ: ?orderBy=folder,modifiedTime desc,name .

pageSize

integer

প্রতি পৃষ্ঠায় ফেরত দেওয়া ফাইলের সর্বোচ্চ সংখ্যা। ফাইলের তালিকার শেষ প্রান্তে পৌঁছানোর আগেও আংশিক বা খালি ফলাফল পৃষ্ঠা দেখা যেতে পারে।

pageToken

string

পরবর্তী পৃষ্ঠায় পূর্ববর্তী তালিকার অনুরোধ চালিয়ে যাওয়ার জন্য টোকেন। এটি পূর্ববর্তী প্রতিক্রিয়া থেকে nextPageToken এর মানে সেট করতে হবে।

q

string

ফাইল ফলাফল ফিল্টার করার জন্য একটি কোয়েরি। সমর্থিত সিনট্যাক্সের জন্য, ফাইল ও ফোল্ডার অনুসন্ধান দেখুন।

spaces

string

কর্পোরাগুলোর মধ্যে কোয়েরি করার জন্য স্পেসগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা। সমর্থিত ভ্যালুগুলো হলো drive এবং appDataFolder । আরও তথ্যের জন্য, ফাইল অর্গানাইজেশন দেখুন।

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

অপ্রচলিত: এর পরিবর্তে supportsAllDrives ব্যবহার করুন।

teamDriveId
(deprecated)

string

অপ্রচলিত: এর পরিবর্তে driveId ব্যবহার করুন।

includePermissionsForView

string

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

includeLabels

string

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

ফাইলগুলোর একটি তালিকা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "files": [
    {
      object (File)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "incompleteSearch": boolean
}
ক্ষেত্র
files[]

object ( File )

ফাইলগুলির তালিকা। যদি nextPageToken পূরণ করা থাকে, তাহলে এই তালিকাটি অসম্পূর্ণ হতে পারে এবং ফলাফলের জন্য অতিরিক্ত একটি পৃষ্ঠা আনতে হবে।

nextPageToken

string

ফাইলগুলির পরবর্তী পৃষ্ঠার জন্য পেজ টোকেন। ফাইলের তালিকার শেষে পৌঁছে গেলে এটি অনুপস্থিত থাকবে। যদি কোনো কারণে টোকেনটি প্রত্যাখ্যাত হয়, তবে তা বাতিল করে ফলাফলের প্রথম পৃষ্ঠা থেকে পেজিনেশন পুনরায় শুরু করা উচিত। পেজ টোকেনটি সাধারণত কয়েক ঘণ্টার জন্য বৈধ থাকে। তবে, নতুন আইটেম যোগ বা অপসারণ করা হলে আপনার প্রত্যাশিত ফলাফল ভিন্ন হতে পারে।

kind

string

এটি কী ধরনের রিসোর্স তা শনাক্ত করে। মান: নির্দিষ্ট স্ট্রিং "drive#fileList" ।

অনুমোদনের পরিধি

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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

কর্পাস

এনাম
user ব্যবহারকারীর মালিকানাধীন বা তার সাথে শেয়ার করা ফাইলসমূহ।
domain ব্যবহারকারীর ডোমেইনে ফাইলগুলো শেয়ার করা হয়েছে।