MCP Tools Reference: drivemcp.googleapis.com

Outil : read_file_content

Appelez cet outil pour récupérer une représentation en langage naturel d'un fichier Drive et, éventuellement, de ses commentaires.

Le contenu des fichiers très volumineux peut être incomplet. La représentation textuelle changera au fil du temps. Ne faites donc pas d'hypothèses sur le format spécifique du texte renvoyé par cet outil. Si les tags de commentaires sont acceptés, ils seront inclus dans le contenu.

Types MIME acceptés :

  • 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

Si le fichier est introuvable, essayez d'utiliser d'autres outils tels que search_files pour trouver le fichier demandé par l'utilisateur à l'aide de mots clés.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP read_file_content.

Requête curl 
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
}'

Schéma d'entrée

Demande de lecture du contenu d'un fichier avec prise en charge de la récupération des commentaires.

ReadFileContentRequest

Représentation JSON 
{
  "fileId": string,
  "includeComments": boolean
}
Champs
fileId

string

Obligatoire. ID du fichier à récupérer.
includeComments

boolean

Indique si la réponse doit inclure des commentaires. Les commentaires seront insérés dans le contenu textuel du fichier, avec un mappage vers les fils de commentaires.

Schéma de sortie

Réponse pour lire le contenu du fichier.

ReadFileContentResponse

Représentation 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
}
Champs
contentAnchoredComments[]

object (CommentThread)

Fils de commentaires référencés dans le contenu du fichier renvoyé.
unanchoredComments[]

object (CommentThread)

Fils de commentaires qui n'ont pas pu être ancrés à un contenu spécifique dans le fichier renvoyé.

Champ d'union _file_content.

_file_content ne peut être qu'un des éléments suivants :
fileContent

string

Contenu du fichier Drive renvoyé au format texte. Peut être vide si le fichier n'est pas compatible avec la mise en forme du texte. Peut inclure des références de commentaires si include_comments est défini sur "true" dans la requête.

Champ d'union _text_formatting_not_supported.

_text_formatting_not_supported ne peut être qu'un des éléments suivants :
textFormattingNotSupported

boolean

Indique si la mise en forme du texte est acceptée pour ce fichier. Si la valeur est "true", file_content sera vide.

Champ d'union _comments_not_supported.

_comments_not_supported ne peut être qu'un des éléments suivants :
commentsNotSupported

boolean

Indique si le renvoi de commentaires est pris en charge pour ce fichier. Présent uniquement si include_comments est défini sur "true" dans la requête et que les commentaires ne sont pas acceptés.

CommentThread

Représentation JSON 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

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

object (Post)

Réponses au premier post du fil de commentaires.

Champ d'union _comment_id.

_comment_id ne peut être qu'un des éléments suivants :
commentId

string

ID du fil de discussion. Il s'agit du même ID que celui du commentaire initial.

Champ d'union _status.

_status ne peut être qu'un des éléments suivants :
status

enum (Status)

État du fil de commentaires.

Champ d'union _head_post.

_head_post ne peut être qu'un des éléments suivants :
headPost

object (Post)

Premier post du fil de commentaires.

Publier

Représentation JSON 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
Champs

Champ d'union _post_id.

_post_id ne peut être qu'un des éléments suivants :
postId

string

Identifiant du post.

Champ d'union _content.

_content ne peut être qu'un des éléments suivants :
content

string

Contenu du post.

Champ d'union _author_name.

_author_name ne peut être qu'un des éléments suivants :
authorName

string

Nom de l'auteur du post.

Champ d'union _modified_time.

_modified_time ne peut être qu'un des éléments suivants :
modifiedTime

string (Timestamp format)

Heure de la dernière modification du post.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

État

Définit l'état d'un fil de commentaires.

Enums
STATUS_UNSPECIFIED
OPEN
RESOLVED

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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