এই নির্দেশিকাটি ব্যাখ্যা করে যে কিভাবে Google Drive API ফাইল এবং ফোল্ডারগুলি অনুসন্ধান করার বিভিন্ন উপায় সমর্থন করে৷
আপনি ড্রাইভ ব্যবহারকারীর সমস্ত বা কিছু ফাইল এবং ফোল্ডার ফেরত দিতে files
রিসোর্সে list
পদ্ধতি ব্যবহার করতে পারেন। list
পদ্ধতিটি কিছু সংস্থান পদ্ধতির জন্য প্রয়োজনীয় fileId
পুনরুদ্ধার করতেও ব্যবহার করা যেতে পারে (যেমন get
মেথড এবং update
) পদ্ধতি।
ক্ষেত্র প্যারামিটার ব্যবহার করুন
আপনি যদি প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলি নির্দিষ্ট করতে চান তবে আপনি files
সংস্থানের যে কোনও পদ্ধতির সাথে fields
সিস্টেম প্যারামিটার সেট করতে পারেন। আপনি যদি fields
পরামিতি বাদ দেন, সার্ভারটি পদ্ধতির জন্য নির্দিষ্ট ক্ষেত্রগুলির একটি ডিফল্ট সেট প্রদান করে। উদাহরণস্বরূপ, list
পদ্ধতিটি প্রতিটি ফাইলের জন্য শুধুমাত্র kind
, id
, name
, mimeType
, এবং resourceKey
ক্ষেত্রগুলি প্রদান করে। বিভিন্ন ক্ষেত্র ফেরত দিতে, নির্দিষ্ট ক্ষেত্র ফেরত দেখুন।
একটি ফাইল পান
একটি ফাইল পেতে, fileId
আইডি পাথ প্যারামিটার সহ files
রিসোর্সে get
পদ্ধতিটি ব্যবহার করুন। আপনি যদি ফাইল আইডি না জানেন তবে আপনি list
পদ্ধতি ব্যবহার করে সমস্ত ফাইল তালিকাভুক্ত করতে পারেন।
পদ্ধতিটি files
রিসোর্সের একটি উদাহরণ হিসাবে ফাইলটি ফেরত দেয়। আপনি যদি alt=media
ক্যোয়ারী প্যারামিটার প্রদান করেন, তাহলে প্রতিক্রিয়াটিতে প্রতিক্রিয়া বডিতে ফাইলের বিষয়বস্তু অন্তর্ভুক্ত থাকে। ফাইলটি ডাউনলোড বা রপ্তানি করতে, ফাইল ডাউনলোড এবং এক্সপোর্ট দেখুন।
পরিচিত ম্যালওয়্যার বা অন্যান্য আপত্তিজনক ফাইলগুলি ডাউনলোড করার ঝুঁকি স্বীকার করতে, acknowledgeAbuse
ক্যোয়ারী প্যারামিটারটিকে true
সেট করুন৷ এই ক্ষেত্রটি শুধুমাত্র তখনই প্রযোজ্য যখন alt=media
প্যারামিটার সেট করা থাকে এবং ব্যবহারকারী হয় ফাইলের মালিক বা শেয়ার্ড ড্রাইভের একজন সংগঠক যেখানে ফাইলটি থাকে।
বর্তমান ব্যবহারকারীর আমার ড্রাইভে সমস্ত ফাইল এবং ফোল্ডার অনুসন্ধান করুন৷
সমস্ত ফাইল এবং ফোল্ডার ফেরত দিতে কোনো পরামিতি ছাড়াই list
পদ্ধতি ব্যবহার করুন।
GET https://www.googleapis.com/drive/v3/files
বর্তমান ব্যবহারকারীর আমার ড্রাইভে নির্দিষ্ট ফাইল বা ফোল্ডার অনুসন্ধান করুন৷
ফাইল বা ফোল্ডারগুলির একটি নির্দিষ্ট সেটের জন্য অনুসন্ধান করতে, এক বা একাধিক অনুসন্ধান পদকে একত্রিত করে ফেরত পাঠানোর জন্য ফাইলগুলিকে ফিল্টার করতে list
পদ্ধতির সাথে ক্যোয়ারী স্ট্রিং q
ক্ষেত্রটি ব্যবহার করুন।
ক্যোয়ারী স্ট্রিং সিনট্যাক্সে নিম্নলিখিত তিনটি অংশ রয়েছে:
query_term operator values
কোথায়:
query_term
হল অনুসন্ধানের জন্য কোয়েরি শব্দ বা ক্ষেত্র।operator
ক্যোয়ারী শব্দের শর্ত উল্লেখ করে।values
হল নির্দিষ্ট মানগুলি যা আপনি আপনার অনুসন্ধান ফলাফলগুলি ফিল্টার করতে ব্যবহার করতে চান৷
উদাহরণস্বরূপ, নিম্নলিখিত ক্যোয়ারী স্ট্রিংটি MIME টাইপ সেট করে শুধুমাত্র ফোল্ডার ফেরাতে অনুসন্ধানটিকে ফিল্টার করে:
q: mimeType = 'application/vnd.google-apps.folder'
সমস্ত ফাইল ক্যোয়ারী শর্তাবলী দেখতে, ফাইল-নির্দিষ্ট ক্যোয়ারী শর্তাবলী দেখুন।
আপনি একটি ক্যোয়ারী তৈরি করতে ব্যবহার করতে পারেন এমন সমস্ত ক্যোয়ারী অপারেটর দেখতে, ক্যোয়ারী অপারেটর দেখুন।
প্রশ্ন স্ট্রিং উদাহরণ
নিম্নলিখিত সারণীতে কিছু মৌলিক ক্যোয়ারী স্ট্রিং এর উদাহরণ রয়েছে। আপনি আপনার অনুসন্ধানের জন্য যে ক্লায়েন্ট লাইব্রেরিটি ব্যবহার করেন তার উপর নির্ভর করে প্রকৃত কোডটি ভিন্ন হয়।
ক্যোয়ারী সঠিকভাবে কাজ করে তা নিশ্চিত করতে আপনাকে অবশ্যই আপনার ফাইলের নামের বিশেষ অক্ষরগুলি এড়িয়ে যেতে হবে। উদাহরণ স্বরূপ, যদি একটি ফাইলের নাম এপোস্ট্রফি ( '
) এবং একটি ব্যাকস্ল্যাশ ( "\"
) অক্ষর উভয়ই ধারণ করে, সেগুলি এড়াতে একটি ব্যাকস্ল্যাশ ব্যবহার করুন: name contains 'quinn\'s paper\\essay'
।
আপনি কি জিজ্ঞাসা করতে চান | উদাহরণ |
---|---|
"হ্যালো" নামের ফাইল | name = 'hello' |
"হ্যালো" এবং "বিদায়" শব্দগুলি সম্বলিত একটি নামের ফাইল | name contains 'hello' and name contains 'goodbye' |
একটি নামের ফাইল যাতে "হ্যালো" শব্দ নেই | not name contains 'hello' |
যে ফাইলগুলিতে "গুরুত্বপূর্ণ" পাঠ্য রয়েছে এবং ট্র্যাশে রয়েছে৷ | fullText contains 'important' and trashed = true |
যে ফাইলগুলিতে "হ্যালো" শব্দ রয়েছে | fullText contains 'hello' |
যে ফাইলগুলিতে "হ্যালো" শব্দটি নেই | not fullText contains 'hello' |
যে ফাইলগুলিতে "হ্যালো ওয়ার্ল্ড" সঠিক বাক্যাংশ রয়েছে | fullText contains '"hello world"' |
একটি প্রশ্ন সহ ফাইল যাতে "\" অক্ষর রয়েছে (উদাহরণস্বরূপ, "\ লেখক") | fullText contains '\\authors' |
ফোল্ডার যে ফাইল | mimeType = 'application/vnd.google-apps.folder' |
যে ফাইলগুলি ফোল্ডার নয়৷ | mimeType != 'application/vnd.google-apps.folder' |
একটি প্রদত্ত তারিখের পরে ফাইলগুলি সংশোধন করা হয়েছে (ডিফল্ট সময় অঞ্চল হল UTC) | modifiedTime > '2012-06-04T12:00:00' |
ছবি বা ভিডিও ফাইল একটি নির্দিষ্ট তারিখের পরে পরিবর্তিত হয় | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
তারকাচিহ্নিত ফাইল | starred = true |
একটি সংগ্রহের মধ্যে ফাইল (উদাহরণস্বরূপ, parents সংগ্রহে ফোল্ডার আইডি) | '1234567' in parents |
একটি সংগ্রহে একটি অ্যাপ্লিকেশন ডেটা ফোল্ডারে ফাইল | 'appDataFolder' in parents |
যে ফাইলগুলির জন্য ব্যবহারকারী "test@example.org" এর মালিক৷ | 'test@example.org' in owners |
যে ফাইলগুলির জন্য "test@example.org" ব্যবহারকারীর লেখার অনুমতি রয়েছে৷ | 'test@example.org' in writers |
যে ফাইলগুলির জন্য "group@example.org" গ্রুপের সদস্যদের লেখার অনুমতি আছে৷ | 'group@example.org' in writers |
নামে "হ্যালো" সহ অনুমোদিত ব্যবহারকারীর সাথে ফাইলগুলি ভাগ করা হয়েছে৷ | sharedWithMe and name contains 'hello' |
একটি কাস্টম ফাইল প্রপার্টি সহ ফাইল সব অ্যাপে দৃশ্যমান | properties has { key='mass' and value='1.3kg' } |
অনুরোধকারী অ্যাপের ব্যক্তিগত একটি কাস্টম ফাইল সম্পত্তি সহ ফাইল | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
যে ফাইলগুলি কারও বা ডোমেনের সাথে ভাগ করা হয়নি (শুধুমাত্র ব্যক্তিগত, বা নির্দিষ্ট ব্যবহারকারী বা গোষ্ঠীর সাথে ভাগ করা হয়েছে) | visibility = 'limited' |
একটি ক্লায়েন্ট লাইব্রেরি দিয়ে অনুসন্ধান ফলাফল ফিল্টার করুন
নিচের কোডের নমুনাটি দেখায় কিভাবে একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করে সার্চের ফলাফল ফাইলের নাম এবং JPEG ফাইলের আইডি ফিল্টার করতে হয়। এই নমুনাটি image/jpeg
টাইপের ফাইলে ফলাফল সংকুচিত করতে mimeType
ক্যোয়ারী শব্দটি ব্যবহার করে। এটি ড্রাইভ স্পেসে অনুসন্ধানকে আরও সংকীর্ণ করতে drive
জন্য spaces
সেট করে। যখন nextPageToken
null
রিটার্ন করে, তখন আর কোন ফলাফল নেই।
জাভা
পাইথন
Node.js
পিএইচপি
একটি কাস্টম ফাইল সম্পত্তি সঙ্গে ফাইল জন্য অনুসন্ধান করুন
একটি কাস্টম ফাইল বৈশিষ্ট্য সহ ফাইলগুলি অনুসন্ধান করতে, একটি কী এবং মান সহ properties
বা appProperties
অনুসন্ধান ক্যোয়ারী শব্দটি ব্যবহার করুন৷ উদাহরণস্বরূপ, 8e8aceg2af2ge72e78
মান সহ additionalID
নামক অনুরোধকারী অ্যাপের ব্যক্তিগত একটি কাস্টম ফাইল সম্পত্তি অনুসন্ধান করতে:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
আরও তথ্যের জন্য, কাস্টম ফাইল বৈশিষ্ট্য যোগ করুন দেখুন।
একটি নির্দিষ্ট লেবেল বা ক্ষেত্রের মান সহ ফাইলগুলির জন্য অনুসন্ধান করুন৷
নির্দিষ্ট লেবেল সহ ফাইলগুলি অনুসন্ধান করতে, একটি নির্দিষ্ট লেবেল আইডি সহ labels
অনুসন্ধান ক্যোয়ারী শব্দটি ব্যবহার করুন৷ উদাহরণস্বরূপ: 'labels/ LABEL_ID ' in labels
। সফল হলে, প্রতিক্রিয়া বডিতে লেবেল প্রয়োগ করা হয়েছে এমন সমস্ত ফাইল দৃষ্টান্ত থাকে।
একটি নির্দিষ্ট লেবেল আইডি ছাড়া ফাইল অনুসন্ধান করতে: Not 'labels/ LABEL_ID ' in labels
।
এছাড়াও আপনি নির্দিষ্ট ক্ষেত্রের মানগুলির উপর ভিত্তি করে ফাইলগুলি অনুসন্ধান করতে পারেন। উদাহরণস্বরূপ, একটি পাঠ্য মান সহ ফাইলগুলি অনুসন্ধান করতে: labels/ LABEL_ID .text_field_id =' TEXT '
।
আরও তথ্যের জন্য, একটি নির্দিষ্ট লেবেল বা ক্ষেত্রের মান সহ ফাইলগুলির জন্য অনুসন্ধান দেখুন।
কর্পোরা অনুসন্ধান করুন
যে অনুসন্ধানগুলিকে list
পদ্ধতি বলা হয় সেগুলি ডিফল্টরূপে user
corpora
ব্যবহার করে৷ অন্যান্য কর্পোরা অনুসন্ধান করতে, যেমন একটি domain
সাথে ভাগ করা ফাইল, corpora
প্যারামিটার সেট করুন৷
একক কোয়েরিতে একাধিক কর্পোরা অনুসন্ধান করা যেতে পারে, যদিও সম্মিলিত কর্পোরাটি খুব বড় হলে অসম্পূর্ণ ফলাফল ফেরত দেওয়া হতে পারে। যদি প্রতিক্রিয়া বডিতে incompleteSearch
true
হয়, তাহলে সমস্ত নথি ফেরত দেওয়া হয়নি। যদি এটি ঘটে থাকে, তাহলে user
বা drive
মতো একটি ভিন্ন কর্পোরা বেছে নিয়ে আপনার ক্যোয়ারীটি সংকুচিত করা উচিত।
সম্পর্কিত বিষয়
- শেয়ার্ড ড্রাইভ খুঁজুন
- অনুসন্ধান ক্যোয়ারী পদ এবং অপারেটর
- Google Workspace এবং Google Drive সমর্থিত MIME প্রকার
- ভূমিকা এবং অনুমতি
- একটি নির্দিষ্ট লেবেল বা ক্ষেত্রের মান সহ ফাইলগুলির জন্য অনুসন্ধান করুন৷