MCP Tools Reference: drivemcp.googleapis.com

টুল: read_file_content

ড্রাইভ ফাইলের স্বাভাবিক ভাষার উপস্থাপনা এবং ঐচ্ছিকভাবে, এর মন্তব্যগুলো পেতে এই টুলটি ব্যবহার করুন।

খুব বড় ফাইলের ক্ষেত্রে ফাইলের বিষয়বস্তু অসম্পূর্ণ থাকতে পারে। সময়ের সাথে সাথে টেক্সটের উপস্থাপনা পরিবর্তিত হবে, তাই এই টুল দ্বারা প্রাপ্ত টেক্সটের নির্দিষ্ট ফরম্যাট সম্পর্কে কোনো অনুমান করবেন না। সমর্থিত হলে, বিষয়বস্তুর মধ্যে কমেন্ট ট্যাগ অন্তর্ভুক্ত করা হবে।

সমর্থিত মাইম টাইপসমূহ:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

যদি ফাইলটি খুঁজে না পাওয়া যায়, তাহলে কীওয়ার্ড ব্যবহার করে ব্যবহারকারীর অনুরোধ করা ফাইলটি খুঁজে বের করার জন্য search_files এর মতো অন্যান্য টুল ব্যবহার করে দেখুন।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` read_file_content MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "read_file_content",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

মন্তব্য আনার সুবিধাসহ ফাইলের বিষয়বস্তু পড়ার অনুরোধ।

ReadFileContentRequest

JSON উপস্থাপনা 
{
  "fileId": string,
  "includeComments": boolean
}
ক্ষেত্র
fileId

string

প্রয়োজনীয়। যে ফাইলটি পুনরুদ্ধার করতে হবে তার আইডি।

includeComments

boolean

উত্তরে মন্তব্য অন্তর্ভুক্ত করা হবে কিনা। মন্তব্যগুলো ফাইলের টেক্সট কন্টেন্টের মধ্যেই কমেন্ট থ্রেডের সাথে ম্যাপ করে যুক্ত করা হবে।

আউটপুট স্কিমা

ফাইলের বিষয়বস্তু পড়ার প্রতিক্রিয়া।

ReadFileContentResponse

JSON উপস্থাপনা 
{
  "contentAnchoredComments": [
    {
      object (CommentThread)
    }
  ],
  "unanchoredComments": [
    {
      object (CommentThread)
    }
  ],

  "fileContent": string

  "textFormattingNotSupported": boolean
  // End of list of possible types for union field
  // _text_formatting_not_supported.

  "commentsNotSupported": boolean
}
ক্ষেত্র
contentAnchoredComments[]

object ( CommentThread )

ফেরত আসা file_content-এ উল্লেখিত মন্তব্য থ্রেডগুলো।

unanchoredComments[]

object ( CommentThread )

মন্তব্য থ্রেডগুলো যা ফেরত আসা ফাইলের নির্দিষ্ট বিষয়বস্তুর সাথে সংযুক্ত করা যায়নি।

ইউনিয়ন ফিল্ড _file_content .

_file_content নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

fileContent

string

ড্রাইভ ফাইলের বিষয়বস্তু টেক্সট ফরম্যাটে ফেরত দেওয়া হয়। ফাইলটি টেক্সট ফরম্যাটিংয়ের জন্য সমর্থিত না হলে এটি খালি থাকতে পারে। অনুরোধে include_comments true হলে মন্তব্যের রেফারেন্স অন্তর্ভুক্ত করা যেতে পারে।

ইউনিয়ন ফিল্ড _text_formatting_not_supported .

_text_formatting_not_supported কারণ নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

textFormattingNotSupported

boolean

এই ফাইলটির জন্য টেক্সট ফরম্যাটিং সমর্থিত কিনা। যদি সত্য হয়, তাহলে file_content খালি থাকবে।

ইউনিয়ন ফিল্ড _comments_not_supported .

_comments_not_supported কারণ নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

commentsNotSupported

boolean

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

মন্তব্য থ্রেড

JSON উপস্থাপনা 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
ক্ষেত্র
replies[]

object ( Post )

কমেন্ট থ্রেডের প্রথম পোস্টের উত্তরগুলো।

ইউনিয়ন ফিল্ড _comment_id .

_comment_id নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

commentId

string

মন্তব্য থ্রেডের আইডি। এই আইডিটি প্রাথমিক মন্তব্যের আইডির অনুরূপ।

ইউনিয়ন ফিল্ড _status .

_status নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

status

enum ( Status )

মন্তব্য থ্রেডটির অবস্থা।

ইউনিয়ন ফিল্ড _head_post .

_head_post নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

headPost

object ( Post )

মন্তব্য থ্রেডের প্রথম পোস্ট।

পোস্ট

JSON উপস্থাপনা 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _post_id .

_post_id নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

postId

string

পোস্টটির আইডি।

ইউনিয়ন ফিল্ড _content .

_content নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

content

string

পোস্টের বিষয়বস্তু।

ইউনিয়ন ফিল্ড _author_name .

_author_name নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

authorName

string

পোস্টটির লেখকের নাম।

ইউনিয়ন ফিল্ড _modified_time .

_modified_time নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

modifiedTime

string ( Timestamp format)

পোস্টটি সর্বশেষ পরিবর্তন করার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

টাইমস্ট্যাম্প

JSON উপস্থাপনা 
{
  "seconds": string,
  "nanos": integer
}
ক্ষেত্র
seconds

string ( int64 format)

এটি ইউনিক্স ইপক 1970-01-01T00:00:00Z থেকে UTC সময়ের সেকেন্ড নির্দেশ করে। এর মান অবশ্যই -62135596800 থেকে 253402300799 (উভয় মানসহ) এর মধ্যে হতে হবে (যা 0001-01-01T00:00:00Z থেকে 9999-12-31T23:59:59Z পর্যন্ত সময়কালের সমতুল্য)।

nanos

integer

ন্যানোসেকেন্ড রেজোলিউশনে সেকেন্ডের অঋণাত্মক ভগ্নাংশ। এই ক্ষেত্রটি হলো সময়কালের ন্যানোসেকেন্ড অংশ, সেকেন্ডের বিকল্প নয়। ভগ্নাংশসহ ঋণাত্মক সেকেন্ডের মানগুলোর ক্ষেত্রেও ন্যানোর মান অবশ্যই অঋণাত্মক হতে হবে, যা সময়ের সাথে সাথে গণনা করে। এর মান অবশ্যই ০ থেকে ৯৯৯,৯৯৯,৯৯৯-এর মধ্যে হতে হবে (উভয় সংখ্যাসহ)।

অবস্থা

একটি মন্তব্য থ্রেডের অবস্থা নির্ধারণ করে।

এনাম
STATUS_UNSPECIFIED
OPEN
RESOLVED

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌

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

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