MCP Tools Reference: drivemcp.googleapis.com

Araç: read_file_content

Bir Drive dosyasının ve isteğe bağlı olarak yorumlarının doğal dil gösterimini getirmek için bu aracı çağırın.

Dosya içeriği, çok büyük dosyalarda eksik olabilir. Metin gösterimi zaman içinde değişir. Bu nedenle, bu araç tarafından döndürülen metnin belirli biçimi hakkında varsayımlarda bulunmayın. Destekleniyorsa yorum etiketleri içeriğe dahil edilir.

Desteklenen MIME türleri:

  • 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

Dosya bulunamazsa kullanıcının istediği dosyayı anahtar kelimelerle bulmak için search_files gibi diğer araçları kullanmayı deneyin.

Aşağıdaki örnekte, read_file_content MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

Yorumları getirme desteğiyle dosya içeriğini okuma isteği.

ReadFileContentRequest

JSON gösterimi 
{
  "fileId": string,
  "includeComments": boolean
}
Alanlar
fileId

string

Zorunlu. Alınacak dosyanın kimliği.
includeComments

boolean

Yorumların yanıta dahil edilip edilmeyeceği. Yorumlar, yorum ileti dizileriyle eşleştirilerek dosyanın metin içeriğine satır içi olarak eklenir.

Çıkış Şeması

Dosya içeriğini okuma yanıtı.

ReadFileContentResponse

JSON gösterimi 
{
  "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
}
Alanlar
contentAnchoredComments[]

object (CommentThread)

Döndürülen file_content içinde referans verilen yorum ileti dizileri.
unanchoredComments[]

object (CommentThread)

Döndürülen dosyada belirli bir içeriğe sabitlenemeyen yorum ileti dizileri.

_file_content birleşik alanı.

_file_content aşağıdakilerden yalnızca biri olabilir:
fileContent

string

Drive dosya içeriği metin biçiminde döndürülür. Dosya, metin biçimlendirme için desteklenmiyorsa boş olabilir. İstek içinde include_comments doğruysa yorum referansları içerebilir.

_text_formatting_not_supported birleşik alanı.

_text_formatting_not_supported aşağıdakilerden yalnızca biri olabilir:
textFormattingNotSupported

boolean

Bu dosya için metin biçimlendirmesinin desteklenip desteklenmediği. Doğruysa file_content boş olur.

_comments_not_supported birleşik alanı.

_comments_not_supported aşağıdakilerden yalnızca biri olabilir:
commentsNotSupported

boolean

Bu dosya için yorumların döndürülmesinin desteklenip desteklenmediği. Yalnızca istekte include_comments doğruysa ve yorumlar desteklenmiyorsa bulunur.

CommentThread

JSON gösterimi 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
Alanlar
replies[]

object (Post)

Yorum dizisindeki ilk yayına verilen yanıtlar.

_comment_id birleşik alanı.

_comment_id aşağıdakilerden yalnızca biri olabilir:
commentId

string

Yorum dizisinin kimliği. Bu, ilk yorumla aynı kimliktir.

_status birleşik alanı.

_status aşağıdakilerden yalnızca biri olabilir:
status

enum (Status)

Yorum dizisinin durumu.

_head_post birleşik alanı.

_head_post aşağıdakilerden yalnızca biri olabilir:
headPost

object (Post)

Yorum dizisindeki ilk gönderi.

Gönderi

JSON gösterimi 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
Alanlar

_post_id birleşik alanı.

_post_id aşağıdakilerden yalnızca biri olabilir:
postId

string

Yayının kimliği.

_content birleşik alanı.

_content aşağıdakilerden yalnızca biri olabilir:
content

string

Yayının içeriği.

_author_name birleşik alanı.

_author_name aşağıdakilerden yalnızca biri olabilir:
authorName

string

Yayının yazarının adı.

_modified_time birleşik alanı.

_modified_time aşağıdakilerden yalnızca biri olabilir:
modifiedTime

string (Timestamp format)

Gönderinin en son değiştirildiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir) olmalıdır.
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, saniyelere alternatif olarak değil, sürenin nanosaniye kısmını belirtmek için kullanılır. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

Durum

Yorum dizisinin durumunu tanımlar.

Sıralamalar
STATUS_UNSPECIFIED
OPEN
RESOLVED

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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