Method: files.list

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

এই পদ্ধতিটি q প্যারামিটার গ্রহণ করে, যা এক বা একাধিক অনুসন্ধান পদের সমন্বয়ে তৈরি একটি অনুসন্ধান কোয়েরি।

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

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 : ফাইলের নাম। এই ক্ষেত্রটি প্রাকৃতিক সাজানোর ক্রম ব্যবহার করে সাজানো হয়েছে, তাই 1, 2, 12, 22।
  • quotaBytesUsed : ফাইল দ্বারা ব্যবহৃত স্টোরেজ কোটা বাইটের সংখ্যা।
  • recency : ফাইলের তারিখ-সময় ক্ষেত্র থেকে সাম্প্রতিকতম টাইমস্ট্যাম্প।
  • sharedWithMeTime : যখন ফাইলটি ব্যবহারকারীর সাথে শেয়ার করা হয়েছিল, যদি প্রযোজ্য হয়।
  • starred : ব্যবহারকারী ফাইলটি তারকাচিহ্নিত করেছেন কিনা।
  • viewedByMeTime : ব্যবহারকারীর দ্বারা শেষবার ফাইলটি দেখা হয়েছিল।

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

pageSize

integer

প্রতি পৃষ্ঠায় সর্বাধিক কতগুলি ফাইল ফেরত পাঠানো যাবে। ফাইল তালিকার শেষের আগেও আংশিক বা খালি ফলাফল পৃষ্ঠাগুলি সম্ভব।

pageToken

string

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

q

string

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

spaces

string

কর্পোরার মধ্যে কোয়েরি করার জন্য কমা দ্বারা পৃথক করা স্থানগুলির একটি তালিকা। সমর্থিত মানগুলি হল drive এবং appDataFolder । আরও তথ্যের জন্য, File organization দেখুন।

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 ব্যবহারকারীর ডোমেনে শেয়ার করা ফাইল।