Method: files.list

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

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

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

HTTP অনুরোধ

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

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

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

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

string

যেসব আইটেমের (ফাইল/ডকুমেন্ট) উপর কোয়েরিটি প্রযোজ্য, সেগুলোর বডি। সমর্থিত বডিগুলো হলো default , domain , drive এবং allDrives । অধিক কার্যকারিতার জন্য allDrives পরিবর্তে default বা drive ব্যবহার করা শ্রেয়।

corpus
(deprecated)

enum ( Corpus )

অপ্রচলিত: আইটেমগুলোর (ফাইল/ডকুমেন্ট) মূল অংশ, যার উপর কোয়েরিটি প্রযোজ্য। এর পরিবর্তে corpora ব্যবহার করুন।

driveId

string

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

includeItemsFromAllDrives

boolean

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

includeTeamDriveItems
(deprecated)

boolean

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

maxResults

integer

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

orderBy

string

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

  • createdDate : ফাইলটি কখন তৈরি করা হয়েছিল।
  • folder : ফোল্ডার আইডি। এই ফিল্ডটি বর্ণানুক্রমিকভাবে সাজানো থাকে।
  • lastViewedByMeDate : ব্যবহারকারী শেষবার ফাইলটি দেখার তারিখ।
  • modifiedByMeDate : ব্যবহারকারী কর্তৃক ফাইলটি সর্বশেষ পরিবর্তনের তারিখ।
  • modifiedDate : ফাইলটি সর্বশেষ কবে পরিবর্তন করা হয়েছিল।
  • quotaBytesUsed : ফাইলটি দ্বারা ব্যবহৃত স্টোরেজ কোটা বাইটের সংখ্যা।
  • recency : ফাইলটির তারিখ-সময় ক্ষেত্র থেকে প্রাপ্ত সর্বশেষ সময়চিহ্ন।
  • sharedWithMeDate : ফাইলটি ব্যবহারকারীর সাথে কখন শেয়ার করা হয়েছিল, যদি প্রযোজ্য হয়।
  • starred : ব্যবহারকারী ফাইলটিকে তারকাচিহ্নিত করেছেন কিনা।
  • title : ফাইলটির শিরোনাম। এই ক্ষেত্রটি বর্ণানুক্রমিকভাবে সাজানো থাকে, যেমন ১, ১২, ২, ২২।
  • title_natural : ফাইলটির শিরোনাম। এই ফিল্ডটি স্বাভাবিক ক্রম অনুসারে সাজানো হয়, যেমন ১, ২, ১২, ২২।

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

উল্লেখ্য যে, বর্তমানে প্রায় দশ লক্ষ ফাইল থাকা ব্যবহারকারীদের জন্য একটি সীমাবদ্ধতা রয়েছে, যেখানে অনুরোধ করা সাজানোর ক্রমটি উপেক্ষা করা হয়।

pageToken

string

ফাইলগুলির জন্য পৃষ্ঠা টোকেন।

projection
(deprecated)

enum ( Projection )

অপ্রচলিত: এই প্যারামিটারটির কোনো কার্যকারিতা নেই।

q

string

ফাইল অনুসন্ধানের জন্য কোয়েরি স্ট্রিং।

spaces

string

কোয়েরি করার জন্য স্পেসগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা। সমর্থিত মানগুলো হলো drive , এবং appDataFolder ।

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

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

includeLabels

string

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

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

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

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

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

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

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

object ( File )

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

nextPageToken

string

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

kind

string

এটি সর্বদা drive#fileList ।

etag

string

তালিকাটির ই-ট্যাগ।

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

নিম্নলিখিত 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
  • 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

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

কর্পাস

এনাম
DEFAULT ব্যবহারকারী যে আইটেমগুলো অ্যাক্সেস করেছেন।
DOMAIN ব্যবহারকারীর ডোমেইনে শেয়ার করা আইটেমগুলো।