Revision

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-drive/json-schema/google-drive-revision-schema.json",
  "title": "Revision",
  "description": "The metadata for a revision to a file. Some resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-drive-revisions-api-openapi.yml#/components/schemas/Revision",
  "type": "object",
  "properties": {
    "keepForever": {
      "type": "boolean",
      "description": "Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive."
    },
    "mimeType": {
      "type": "string",
      "description": "Output only. The MIME type of the revision."
    },
    "publishedOutsideDomain": {
      "type": "boolean",
      "description": "Whether this revision is published outside the domain. This is only applicable to Docs Editors files."
    },
    "publishAuto": {
      "type": "boolean",
      "description": "Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files."
    },
    "modifiedTime": {
      "type": "string",
      "description": "The last time the revision was modified (RFC 3339 date-time).",
      "format": "date-time"
    },
    "publishedLink": {
      "type": "string",
      "description": "Output only. A link to the published revision. This is only populated for Docs Editors files."
    },
    "size": {
      "type": "string",
      "description": "Output only. The size of the revision's content in bytes. This is only applicable to files with binary content in Drive.",
      "format": "int64"
    },
    "kind": {
      "type": "string",
      "description": "Output only. Identifies what kind of resource this is. Value: the fixed string `\"drive#revision\"`.",
      "default": "drive#revision"
    },
    "md5Checksum": {
      "type": "string",
      "description": "Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive."
    },
    "originalFilename": {
      "type": "string",
      "description": "Output only. The original filename used to create this revision. This is only applicable to files with binary content in Drive."
    },
    "lastModifyingUser": {
      "$ref": "#/$defs/User"
    },
    "exportLinks": {
      "type": "object",
      "description": "Output only. Links for exporting Docs Editors files to specific formats.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "id": {
      "type": "string",
      "description": "Output only. The ID of the revision."
    },
    "published": {
      "type": "boolean",
      "description": "Whether this revision is published. This is only applicable to Docs Editors files."
    }
  },
  "$defs": {
    "User": {
      "type": "object",
      "description": "Information about a Drive user.",
      "properties": {
        "photoLink": {
          "type": "string",
          "description": "Output only. A link to the user's profile photo, if available.",
          "readOnly": true
        },
        "emailAddress": {
          "type": "string",
          "description": "Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.",
          "readOnly": true
        },
        "me": {
          "type": "boolean",
          "description": "Output only. Whether this user is the requesting user.",
          "readOnly": true
        },
        "displayName": {
          "type": "string",
          "description": "Output only. A plain text displayable name for this user.",
          "readOnly": true
        },
        "kind": {
          "type": "string",
          "description": "Output only. Identifies what kind of resource this is. Value: the fixed string `drive#user`.",
          "default": "drive#user",
          "readOnly": true
        },
        "permissionId": {
          "type": "string",
          "description": "Output only. The user's ID as visible in Permission resources.",
          "readOnly": true
        }
      }
    }
  }
}