Google Takeout API

takeout-discovery.json

{
  "title": "Takeout API",
  "discoveryVersion": "v1",
  "ownerName": "Google",
  "version_module": true,
  "resources": {
    "exports": {
      "methods": {
        "get": {
          "flatPath": "v2/{service}/exports/{exportId}",
          "path": "v2/{service}/exports/{exportId}",
          "id": "takeout_pa.exports.get",
          "description": "Gets the status of a single export job.",
          "response": {
            "$ref": "GetExportResponse"
          },
          "parameterOrder": [
            "service",
            "exportId"
          ],
          "httpMethod": "GET",
          "scopes": [
            "https://www.googleapis.com/auth/drive.readonly"
          ],
          "parameters": {
            "service": {
              "location": "path",
              "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
              "required": true,
              "type": "string"
            },
            "exportId": {
              "location": "path",
              "description": "The ID of the export to get.",
              "required": true,
              "type": "string"
            }
          }
        },
        "create": {
          "request": {
            "$ref": "ExportRequest"
          },
          "description": "Creates a new Export Job for the user.  This will return immediately,\nthe ID in the response can then be used to poll GetExport to tell when\nthe job is done.",
          "response": {
            "$ref": "CreateExportResponse"
          },
          "parameterOrder": [
            "service"
          ],
          "httpMethod": "POST",
          "scopes": [
            "https://www.googleapis.com/auth/drive.readonly"
          ],
          "parameters": {
            "service": {
              "location": "path",
              "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
              "required": true,
              "type": "string"
            }
          },
          "flatPath": "v2/{service}/exports",
          "path": "v2/{service}/exports",
          "id": "takeout_pa.exports.create"
        },
        "cancel": {
          "path": "v2/{service}/exports/{exportId}:cancel",
          "id": "takeout_pa.exports.cancel",
          "description": "Cancels a running export job.",
          "response": {
            "$ref": "CancelExportResponse"
          },
          "parameterOrder": [
            "service",
            "exportId"
          ],
          "httpMethod": "POST",
          "scopes": [
            "https://www.googleapis.com/auth/drive.readonly"
          ],
          "parameters": {
            "exportId": {
              "location": "path",
              "description": "The ID of the export to cancel.",
              "required": true,
              "type": "string"
            },
            "service": {
              "required": true,
              "type": "string",
              "location": "path",
              "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java."
            }
          },
          "flatPath": "v2/{service}/exports/{exportId}:cancel"
        }
      }
    }
  },
  "parameters": {
    "key": {
      "location": "query",
      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
      "type": "string"
    },
    "access_token": {
      "location": "query",
      "description": "OAuth access token.",
      "type": "string"
    },
    "upload_protocol": {
      "type": "string",
      "location": "query",
      "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")."
    },
    "prettyPrint": {
      "type": "boolean",
      "default": "true",
      "location": "query",
      "description": "Returns response with indentations and line breaks."
    },
    "quotaUser": {
      "location": "query",
      "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
      "type": "string"
    },
    "fields": {
      "location": "query",
      "description": "Selector specifying which fields to include in a partial response.",
      "type": "string"
    },
    "uploadType": {
      "location": "query",
      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
      "type": "string"
    },
    "$.xgafv": {
      "location": "query",
      "enum": [
        "1",
        "2"
      ],
      "description": "V1 error format.",
      "type": "string",
      "enumDescriptions": [
        "v1 error format",
        "v2 error format"
      ]
    },
    "oauth_token": {
      "type": "string",
      "location": "query",
      "description": "OAuth 2.0 token for the current user."
    },
    "callback": {
      "location": "query",
      "description": "JSONP",
      "type": "string"
    },
    "alt": {
      "enumDescriptions": [
        "Responses with Content-Type of application/json",
        "Media download with context-dependent Content-Type",
        "Responses with Content-Type of application/x-protobuf"
      ],
      "location": "query",
      "description": "Data format for response.",
      "default": "json",
      "enum": [
        "json",
        "media",
        "proto"
      ],
      "type": "string"
    }
  },
  "schemas": {
    "ErrorProto": {
      "description": "Describes one specific error.",
      "type": "object",
      "properties": {
        "location": {
          "type": "string",
          "description": "Location of the error, as specified by the location type.\n\nIf location_type is PATH, this should be a path to a field that's\nrelative to the request, using FieldPath notation\n(net/proto2/util/public/field_path.h).\n\nExamples:\n  authenticated_user.gaia_id\n  resource.address[2].country"
        },
        "debugInfo": {
          "description": "Debugging information, which should not be\nshared externally.",
          "type": "string"
        },
        "code": {
          "description": "Error code in the error domain. This should correspond to\na value of the enum type whose name is in domain. See\nthe core error domain in error_domain.proto.",
          "type": "string"
        },
        "locationType": {
          "type": "string",
          "enumDescriptions": [
            "location is an xpath-like path pointing\nto the request field that caused the error.",
            "other location type which can safely be shared\nexternally.",
            "Location is request paramater. This maps to the {@link PARAMETERS} in\n{@link MessageLocation}."
          ],
          "enum": [
            "PATH",
            "OTHER",
            "PARAMETER"
          ]
        },
        "argument": {
          "description": "Error arguments, to be used when building user-friendly error messages\ngiven the error domain and code.  Different error codes require different\narguments.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "externalErrorMessage": {
          "description": "A short explanation for the error, which can be shared outside Google.\n\nPlease set domain, code and arguments whenever possible instead of this\nerror message so that external APIs can build safe error messages\nthemselves.\n\nExternal messages built in a RoSy interface will most likely refer to\ninformation and concepts that are not available externally and should not\nbe exposed. It is safer if external APIs can understand the errors and\ndecide what the error message should look like.",
          "type": "string"
        },
        "domain": {
          "type": "string",
          "description": "Error domain. RoSy services can define their own\ndomain and error codes. This should normally be\nthe name of an enum type, such as: gdata.CoreErrorDomain"
        }
      },
      "id": "ErrorProto"
    },
    "Errors": {
      "description": "Request Error information.\n\nThe presence of an error field signals that the operation\nhas failed.",
      "type": "object",
      "properties": {
        "error": {
          "description": "Specific error description and codes",
          "type": "array",
          "items": {
            "$ref": "ErrorProto"
          }
        },
        "code": {
          "description": "Global error code. Deprecated and ignored.\nSet custom error codes in ErrorProto.domain and ErrorProto.code\ninstead.",
          "type": "string",
          "enumDescriptions": [
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            ""
          ],
          "enum": [
            "BAD_REQUEST",
            "FORBIDDEN",
            "NOT_FOUND",
            "CONFLICT",
            "GONE",
            "PRECONDITION_FAILED",
            "INTERNAL_ERROR",
            "SERVICE_UNAVAILABLE"
          ]
        },
        "requestId": {
          "type": "string",
          "description": "Request identifier generated by the service, which can be\nused to identify the error in the logs"
        }
      },
      "id": "Errors"
    },
    "ExportJob": {
      "type": "object",
      "properties": {
        "failedItemInfos": {
          "description": "The set of items that couldn't be included in the archive.\nIf a directory was specified in ExportRequest.items and items in that\ndirectory failed, each individual file that failed will have an entry in\nfailed_item_infos.",
          "type": "array",
          "items": {
            "$ref": "FailedItemInfo"
          }
        },
        "status": {
          "enumDescriptions": [
            "The export is in an unknown state, this value should never be set\nif received it may indicate you client doesn't have the latest set\nof enum values.",
            "The export has been submitted but an archiver hasn't started working\non it yet.",
            "An archiver is working on this export, it is currently enumerating\nall the resources so we know how much work there is to do.",
            "The export is currently in the process of being built.",
            "The export is finished and completed successfully.  This will be\nthe result even if some individual files failed. failed_items will\nbe populated with id of any items that failed to be included in the\narchive.",
            "The export is finished and failed.  This represents a catastrophic\nfailure in the infrastructure and not a failure to fetch individual\nitems. failed_items will not be populated in this case.\ndebug_failure_info will contain more info about the failure."
          ],
          "enum": [
            "UNKNOWN",
            "QUEUED",
            "COUNTING",
            "BUILDING",
            "SUCCEEDED",
            "FAILED"
          ],
          "description": "The current status of this export job.",
          "type": "string"
        },
        "failedItems": {
          "description": "Use failed_item_info instead.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "debugFailureInfo": {
          "description": "Detailed information about what failed in the case status = FAILED.\nThis information is for internal debugging only and should not be shared\nwith user.",
          "type": "string"
        },
        "archives": {
          "type": "array",
          "items": {
            "$ref": "Archive"
          },
          "description": "A set of records that contain information about the completed archives\ncreated by this job.  This will only be present if status = SUCCEEDED."
        },
        "items": {
          "type": "array",
          "items": {
            "$ref": "TakeoutItem"
          },
          "description": "The items being exported. If a directory is present all\nitems under that directory will be included."
        },
        "id": {
          "description": "The ID of this job. Can be used to get or cancel this job.",
          "type": "string"
        }
      },
      "id": "ExportJob",
      "description": "The representation of an export job.  Used for creating new jobs\nand reporting the state of existing jobs."
    },
    "ExportRequest": {
      "type": "object",
      "properties": {
        "locale": {
          "type": "string",
          "description": "Allows the client to specify a locale for the request.\nThe format of the string is an IETF\nlanguage tag, such as \"en-US\", as defined in\nBCP 47 (http://tools.ietf.org/html/bcp47). More practically, the content\nof the string should be one that is appropriate for creating a java\nLocale object.  Defaults to \"en-US\" if not specified."
        },
        "items": {
          "description": "The requested items to export. If a directory is specified, all\nitems under that directory will be exported, but only top-level\nitems are captured in this field.",
          "type": "array",
          "items": {
            "$ref": "TakeoutItem"
          }
        },
        "initiatingClientService": {
          "enum": [
            "UNKNOWN_SERVICE",
            "ACCOUNT_CENTRAL",
            "LIS",
            "DASHER",
            "PATRONUS",
            "PROBATE",
            "DRIVE_SERVICE",
            "TAKEDOWN",
            "DASHER_SUPPLEMENTAL",
            "LRTOOL_SOCIAL_RETENTION",
            "ACCOUNT_MIGRATION_UI",
            "NEST_SERVICE",
            "ACCOUNT_CENTRAL_SCHEDULED",
            "TRANSFER",
            "PHOTOS_DOWNLOAD_SERVICE",
            "TAKEOUT_INTERNAL"
          ],
          "type": "string",
          "enumDescriptions": [
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "Used for Dasher Russia and China Flume jobs",
            "Used for legal removal of social data / long term retention exports",
            "",
            "",
            "Used to differentiate scheduled jobs that come from the UI",
            "DTP Jobs",
            "",
            "Used by takeout for troubleshooting"
          ]
        },
        "archivePrefix": {
          "description": "Optional prefix for the archive filename. Will be followed by a '-'\n& an ISO standard timestamp in yyyyMMdd'T'HHmmssZ format. Prefix\ndefaults to \"takeout\" if none specified, resulting in an archive\nname like \"takeout-20150924T221439Z.zip\".",
          "type": "string"
        },
        "service": {
          "type": "string",
          "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java."
        }
      },
      "id": "ExportRequest",
      "description": "A request to create a new export."
    },
    "CreateExportResponse": {
      "id": "CreateExportResponse",
      "description": "The result of a request to create a new export.",
      "type": "object",
      "properties": {
        "exportJob": {
          "$ref": "ExportJob",
          "description": "Details about the created export."
        },
        "errors": {
          "description": "If present provides details on any errors that occurred.",
          "$ref": "Errors"
        }
      }
    },
    "FailedItemInfo": {
      "id": "FailedItemInfo",
      "description": "Info about a failed item (file or folder) in an export.",
      "type": "object",
      "properties": {
        "title": {
          "description": "The user visible title of the item that failed, empty if the failure was\ndue to permissions.",
          "type": "string"
        },
        "cause": {
          "enumDescriptions": [
            "The default value for the enum, isn't expected in production.",
            "A failure that we weren't able to assign a specific cause to.",
            "The specified ID was not found.",
            "This item was marked as prevent colaborators from downloading.",
            "This item failed the virus check."
          ],
          "enum": [
            "UNKNOWN",
            "GENERIC",
            "ITEM_NOT_FOUND",
            "DOWNLOAD_PROHIBITED",
            "CONTAINS_VIRUS"
          ],
          "description": "The cause of the failure, if known.",
          "type": "string"
        },
        "relativePath": {
          "description": "The path to the failed item from one of the root items specified when\nstarting the export.  The path includes the file name.\nIf this item is reachable via multiple paths (e.g. the individual item\nwas selected as well as the parent folder or the item is multi-included\nin several folders) it is undefined (and non-deterministic) which root\nnode this path will be relative to.",
          "type": "string"
        },
        "docId": {
          "description": "The document ID of the item that failed.",
          "type": "string"
        },
        "mediaType": {
          "type": "string",
          "description": "The mime type of the file."
        }
      }
    },
    "Archive": {
      "description": "A completed archive file (e.g. zip or tgz).",
      "type": "object",
      "properties": {
        "storagePath": {
          "description": "The downloadable url of the completed archive.",
          "type": "string"
        },
        "compressedSize": {
          "description": "The size, in bytes, of the compressed archive.",
          "format": "uint64",
          "type": "string"
        },
        "fileName": {
          "description": "The full name of the archive file, including extension (but not\nincluding path).",
          "type": "string"
        },
        "sizeOfContents": {
          "description": "The size, in bytes, of all the items in the archive.",
          "format": "uint64",
          "type": "string"
        }
      },
      "id": "Archive"
    },
    "GetExportResponse": {
      "id": "GetExportResponse",
      "description": "Details about a given export.",
      "type": "object",
      "properties": {
        "exportJob": {
          "$ref": "ExportJob",
          "description": "Details on the requested export."
        },
        "percentDone": {
          "description": "Percent done (# completed files) / (# total files).\nIncluded for BUILDING exports only.",
          "format": "int32",
          "type": "integer"
        },
        "numFetchedFiles": {
          "type": "integer",
          "description": "Total number of fetched files. Set for completed exports only.\nIf a folder containing 2 files was downloaded, num_fetched_files = 2.",
          "format": "int32"
        },
        "errors": {
          "$ref": "Errors",
          "description": "If present provides details on any errors that occurred."
        }
      }
    },
    "TakeoutItem": {
      "description": "Represents an item (file/folder/album) in the product.",
      "type": "object",
      "properties": {
        "id": {
          "description": "The ID of the item, must line up with the id that that service's\nTakeout integration produces.",
          "type": "string"
        }
      },
      "id": "TakeoutItem"
    },
    "CancelExportResponse": {
      "id": "CancelExportResponse",
      "description": "The result of a request to cancel a given export.",
      "type": "object",
      "properties": {
        "errors": {
          "description": "If present provides details on any errors that occurred.",
          "$ref": "Errors"
        },
        "succeeded": {
          "description": "Whether the export was successfully cancelled",
          "type": "boolean"
        }
      }
    }
  },
  "icons": {
    "x32": "http://www.google.com/images/icons/product/search-32.gif",
    "x16": "http://www.google.com/images/icons/product/search-16.gif"
  },
  "protocol": "rest",
  "version": "v2",
  "baseUrl": "https://takeout-pa.googleapis.com/",
  "auth": {
    "oauth2": {
      "scopes": {
        "https://www.googleapis.com/auth/drive.readonly": {
          "description": "See and download all your Google Drive files"
        }
      }
    }
  },
  "description": "",
  "servicePath": "",
  "kind": "discovery#restDescription",
  "rootUrl": "https://takeout-pa.googleapis.com/",
  "basePath": "",
  "ownerDomain": "google.com",
  "name": "takeout_pa",
  "batchPath": "batch",
  "revision": "20191219",
  "documentationLink": "",
  "id": "takeout_pa:v2"
}

takeout.md

f.req

Creating a Google Takeout export (specifically for Google Drive) requires this POST variable to be set.

[[["U5lrKc","[\"ac.t.st\",[[[\"drive\",[],[\"1AO8SZZvP1XJUPWk8iKMcT44heFqaHcjy\"],[]]],\"TGZ\",null,5,null,4294967295,1]]",null,"generic"]]]

The above is an example of a drive export. The [\"1AO8SZZvP1XJUPWk8iKMcT44heFqaHcjy\"] is clearly a list of Drive ID's, \"TGZ\" is the archive format (either 'TGZ' or 'ZIP') and 4294967295 is the size of the single archives.

Possible Archive Sizes

["1073741824", "2147483648", "4294967295", "10737418240", "53687091200"]

Response from Google Takeout

)]}'

504
[["wrb.fr","U5lrKc","[\"ac.t.star\",[\"ac.t.ta\",\"e6be7f48-cdb1-4f9a-8c96-ba104e447b7b\",\"28 December 2019\",null,\"\",null,0,[[\"drive\",\"Drive\",\"https://www.gstatic.com/images/branding/product/1x/drive_32dp.png\",null,null,null,null,null,\"https://www.gstatic.com/images/branding/product/1x/drive_64dp.png\"]\n]\n,null,***0***,null,false,null,null,null,null,null,false,5,null,null,false,1577822939583,null,0]\n]\n",null,null,null,"generic"]
,["di",3352]
,["af.httprm",3351,"-3990804138194223976",29]
]
26
[["e",4,null,null,541]
]

The progress of your archive is given by the number surrounded by *** in the above JSON. You can check on the status of the archive by polling:

https://takeout.google.com/u/1/_/TakeoutUi/data/batchexecute?rpcids=xxxxxx&f.sid=-xxxxxxxxxxxxxxxxxx&bl=boq_identityfrontenduiserver_20191215.19_p0&hl=en-GB&_reqid=xxxxxxx&rt=c

Zipping via Google Drive

When you right-click and Download a folder in Drive, a request is made to the takeout endpoint. The JSON payload is:

POST https://takeout-pa.clients6.google.com/v1/exports?key=xxxxxxxxxxxxxxxxxxxxxxxxx

{"archiveFormat":"TGZ","archivePrefix":"6 prefix","conversions":null,"items":[{"id":"1Km3S2ZK3c_FRR1RHz2rvPJ1rEc21T1Hm"}],"locale":null}

Attempting to find the parameter which allows us to specify the archive size was a lot of brute forcing, with mostly these errors:

{
  "error": {
    "code": 400,
    "message": "Invalid JSON payload received. Unknown name \"compressedSize\" at 'export_request': Cannot find field.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "export_request",
            "description": "Invalid JSON payload received. Unknown name \"compressedSize\" at 'export_request': Cannot find field."
          }
        ]
      }
    ]
  }
}

Would it be too much of a bother to ask for a little more information on how to use this? The first block looks like some kind of service discovery schema, but beyond that I'm not able to discern how to use this. Any help would be appreciated!

@ScottG489
There are some docs on it here:

https://developers.google.com/discovery/v1/using
https://developers.google.com/discovery/v1/getting_started

Thanks @AlexDev404. Will read those docs over and try to make sense of the above discovery file.

Were you able to get this working?

I'm also just realizing this seems taylored to download/request all your files from Google Drive? I was particularly interested in being able to request any or all available services from Google Takeout.

Thanks @AlexDev404. Will read those docs over and try to make sense of the above discovery file.

Were you able to get this working?

I'm also just realizing this seems taylored to download/request all your files from Google Drive? I was particularly interested in being able to request any or all available services from Google Takeout.

@ScottG489 Yeah I was. After much searching I came upon this document here which describes the usage of Discovery Documents

Also, it needs access to drive.readonly since all userdata is saved in Google Drive

{
  "swagger": "2.0",
  "info": {
    "title": "Takeout API",
    "description": "",
    "contact": {
      "name": "Google",
      "url": "https://google.com"
    },
    "version": "v2"
  },
  "host": "takeout-pa.googleapis.com",
  "basePath": "/",
  "schemes": [
    "https"
  ],
  "definitions": {
    "ErrorProto": {
      "description": "Describes one specific error.",
      "type": "object",
      "properties": {
        "location": {
          "type": "string",
          "description": "Location of the error, as specified by the location type.\n\nIf location_type is PATH, this should be a path to a field that's\nrelative to the request, using FieldPath notation\n(net/proto2/util/public/field_path.h).\n\nExamples:\n  authenticated_user.gaia_id\n  resource.address[2].country"
        },
        "debugInfo": {
          "description": "Debugging information, which should not be\nshared externally.",
          "type": "string"
        },
        "code": {
          "description": "Error code in the error domain. This should correspond to\na value of the enum type whose name is in domain. See\nthe core error domain in error_domain.proto.",
          "type": "string"
        },
        "locationType": {
          "type": "string",
          "enum": [
            "PATH",
            "OTHER",
            "PARAMETER"
          ]
        },
        "argument": {
          "description": "Error arguments, to be used when building user-friendly error messages\ngiven the error domain and code.  Different error codes require different\narguments.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "externalErrorMessage": {
          "description": "A short explanation for the error, which can be shared outside Google.\n\nPlease set domain, code and arguments whenever possible instead of this\nerror message so that external APIs can build safe error messages\nthemselves.\n\nExternal messages built in a RoSy interface will most likely refer to\ninformation and concepts that are not available externally and should not\nbe exposed. It is safer if external APIs can understand the errors and\ndecide what the error message should look like.",
          "type": "string"
        },
        "domain": {
          "type": "string",
          "description": "Error domain. RoSy services can define their own\ndomain and error codes. This should normally be\nthe name of an enum type, such as: gdata.CoreErrorDomain"
        }
      }
    },
    "Errors": {
      "description": "Request Error information.\n\nThe presence of an error field signals that the operation\nhas failed.",
      "type": "object",
      "properties": {
        "error": {
          "description": "Specific error description and codes",
          "type": "array",
          "items": {
            "$ref": "#/definitions/ErrorProto"
          }
        },
        "code": {
          "description": "Global error code. Deprecated and ignored.\nSet custom error codes in ErrorProto.domain and ErrorProto.code\ninstead.",
          "type": "string",
          "enum": [
            "BAD_REQUEST",
            "FORBIDDEN",
            "NOT_FOUND",
            "CONFLICT",
            "GONE",
            "PRECONDITION_FAILED",
            "INTERNAL_ERROR",
            "SERVICE_UNAVAILABLE"
          ]
        },
        "requestId": {
          "type": "string",
          "description": "Request identifier generated by the service, which can be\nused to identify the error in the logs"
        }
      }
    },
    "ExportJob": {
      "type": "object",
      "properties": {
        "failedItemInfos": {
          "description": "The set of items that couldn't be included in the archive.\nIf a directory was specified in ExportRequest.items and items in that\ndirectory failed, each individual file that failed will have an entry in\nfailed_item_infos.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/FailedItemInfo"
          }
        },
        "status": {
          "enum": [
            "UNKNOWN",
            "QUEUED",
            "COUNTING",
            "BUILDING",
            "SUCCEEDED",
            "FAILED"
          ],
          "description": "The current status of this export job.",
          "type": "string"
        },
        "failedItems": {
          "description": "Use failed_item_info instead.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "debugFailureInfo": {
          "description": "Detailed information about what failed in the case status = FAILED.\nThis information is for internal debugging only and should not be shared\nwith user.",
          "type": "string"
        },
        "archives": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Archive"
          },
          "description": "A set of records that contain information about the completed archives\ncreated by this job.  This will only be present if status = SUCCEEDED."
        },
        "items": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/TakeoutItem"
          },
          "description": "The items being exported. If a directory is present all\nitems under that directory will be included."
        },
        "id": {
          "description": "The ID of this job. Can be used to get or cancel this job.",
          "type": "string"
        }
      },
      "description": "The representation of an export job.  Used for creating new jobs\nand reporting the state of existing jobs."
    },
    "ExportRequest": {
      "type": "object",
      "properties": {
        "locale": {
          "type": "string",
          "description": "Allows the client to specify a locale for the request.\nThe format of the string is an IETF\nlanguage tag, such as \"en-US\", as defined in\nBCP 47 (http://tools.ietf.org/html/bcp47). More practically, the content\nof the string should be one that is appropriate for creating a java\nLocale object.  Defaults to \"en-US\" if not specified."
        },
        "items": {
          "description": "The requested items to export. If a directory is specified, all\nitems under that directory will be exported, but only top-level\nitems are captured in this field.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/TakeoutItem"
          }
        },
        "initiatingClientService": {
          "enum": [
            "UNKNOWN_SERVICE",
            "ACCOUNT_CENTRAL",
            "LIS",
            "DASHER",
            "PATRONUS",
            "PROBATE",
            "DRIVE_SERVICE",
            "TAKEDOWN",
            "DASHER_SUPPLEMENTAL",
            "LRTOOL_SOCIAL_RETENTION",
            "ACCOUNT_MIGRATION_UI",
            "NEST_SERVICE",
            "ACCOUNT_CENTRAL_SCHEDULED",
            "TRANSFER",
            "PHOTOS_DOWNLOAD_SERVICE",
            "TAKEOUT_INTERNAL"
          ],
          "type": "string"
        },
        "archivePrefix": {
          "description": "Optional prefix for the archive filename. Will be followed by a '-'\n& an ISO standard timestamp in yyyyMMdd'T'HHmmssZ format. Prefix\ndefaults to \"takeout\" if none specified, resulting in an archive\nname like \"takeout-20150924T221439Z.zip\".",
          "type": "string"
        },
        "service": {
          "type": "string",
          "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java."
        }
      },
      "description": "A request to create a new export."
    },
    "CreateExportResponse": {
      "description": "The result of a request to create a new export.",
      "type": "object",
      "properties": {
        "exportJob": {
          "$ref": "#/definitions/ExportJob",
          "description": "Details about the created export."
        },
        "errors": {
          "description": "If present provides details on any errors that occurred.",
          "$ref": "#/definitions/Errors"
        }
      }
    },
    "FailedItemInfo": {
      "description": "Info about a failed item (file or folder) in an export.",
      "type": "object",
      "properties": {
        "title": {
          "description": "The user visible title of the item that failed, empty if the failure was\ndue to permissions.",
          "type": "string"
        },
        "cause": {
          "enum": [
            "UNKNOWN",
            "GENERIC",
            "ITEM_NOT_FOUND",
            "DOWNLOAD_PROHIBITED",
            "CONTAINS_VIRUS"
          ],
          "description": "The cause of the failure, if known.",
          "type": "string"
        },
        "relativePath": {
          "description": "The path to the failed item from one of the root items specified when\nstarting the export.  The path includes the file name.\nIf this item is reachable via multiple paths (e.g. the individual item\nwas selected as well as the parent folder or the item is multi-included\nin several folders) it is undefined (and non-deterministic) which root\nnode this path will be relative to.",
          "type": "string"
        },
        "docId": {
          "description": "The document ID of the item that failed.",
          "type": "string"
        },
        "mediaType": {
          "type": "string",
          "description": "The mime type of the file."
        }
      }
    },
    "Archive": {
      "description": "A completed archive file (e.g. zip or tgz).",
      "type": "object",
      "properties": {
        "storagePath": {
          "description": "The downloadable url of the completed archive.",
          "type": "string"
        },
        "compressedSize": {
          "description": "The size, in bytes, of the compressed archive.",
          "format": "uint64",
          "type": "string"
        },
        "fileName": {
          "description": "The full name of the archive file, including extension (but not\nincluding path).",
          "type": "string"
        },
        "sizeOfContents": {
          "description": "The size, in bytes, of all the items in the archive.",
          "format": "uint64",
          "type": "string"
        }
      }
    },
    "GetExportResponse": {
      "description": "Details about a given export.",
      "type": "object",
      "properties": {
        "exportJob": {
          "$ref": "#/definitions/ExportJob",
          "description": "Details on the requested export."
        },
        "percentDone": {
          "description": "Percent done (# completed files) / (# total files).\nIncluded for BUILDING exports only.",
          "format": "int32",
          "type": "integer"
        },
        "numFetchedFiles": {
          "type": "integer",
          "description": "Total number of fetched files. Set for completed exports only.\nIf a folder containing 2 files was downloaded, num_fetched_files = 2.",
          "format": "int32"
        },
        "errors": {
          "$ref": "#/definitions/Errors",
          "description": "If present provides details on any errors that occurred."
        }
      }
    },
    "TakeoutItem": {
      "description": "Represents an item (file/folder/album) in the product.",
      "type": "object",
      "properties": {
        "id": {
          "description": "The ID of the item, must line up with the id that that service's\nTakeout integration produces.",
          "type": "string"
        }
      }
    },
    "CancelExportResponse": {
      "description": "The result of a request to cancel a given export.",
      "type": "object",
      "properties": {
        "errors": {
          "description": "If present provides details on any errors that occurred.",
          "$ref": "#/definitions/Errors"
        },
        "succeeded": {
          "description": "Whether the export was successfully cancelled",
          "type": "boolean"
        }
      }
    }
  },
  "parameters": {
    "key": {
      "name": "key",
      "in": "query",
      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
      "type": "string"
    },
    "access_token": {
      "name": "access_token",
      "in": "query",
      "description": "OAuth access token.",
      "type": "string"
    },
    "upload_protocol": {
      "name": "upload_protocol",
      "in": "query",
      "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
      "type": "string"
    },
    "prettyPrint": {
      "name": "prettyPrint",
      "in": "query",
      "description": "Returns response with indentations and line breaks.",
      "default": true,
      "type": "boolean"
    },
    "quotaUser": {
      "name": "quotaUser",
      "in": "query",
      "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
      "type": "string"
    },
    "fields": {
      "name": "fields",
      "in": "query",
      "description": "Selector specifying which fields to include in a partial response.",
      "type": "string"
    },
    "uploadType": {
      "name": "uploadType",
      "in": "query",
      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
      "type": "string"
    },
    "$.xgafv": {
      "name": "$.xgafv",
      "in": "query",
      "description": "V1 error format.",
      "type": "string",
      "enum": [
        "1",
        "2"
      ]
    },
    "oauth_token": {
      "name": "oauth_token",
      "in": "query",
      "description": "OAuth 2.0 token for the current user.",
      "type": "string"
    },
    "callback": {
      "name": "callback",
      "in": "query",
      "description": "JSONP",
      "type": "string"
    },
    "alt": {
      "name": "alt",
      "in": "query",
      "description": "Data format for response.",
      "default": "json",
      "type": "string",
      "enum": [
        "json",
        "media",
        "proto"
      ]
    }
  },
  "securityDefinitions": {
    "Oauth2": {
      "type": "oauth2",
      "description": "Oauth 2.0 authentication",
      "flow": "implicit",
      "authorizationUrl": "https://accounts.google.com/o/oauth2/auth",
      "scopes": {
        "https://www.googleapis.com/auth/drive.readonly": "See and download all your Google Drive files"
      }
    }
  },
  "paths": {
    "/v2/{service}/exports/{exportId}": {
      "get": {
        "description": "Gets the status of a single export job.",
        "operationId": "takeout_pa.exports.get",
        "responses": {
          "200": {
            "description": "Successful response",
            "schema": {
              "$ref": "#/definitions/GetExportResponse"
            }
          }
        },
        "parameters": [
          {
            "name": "service",
            "in": "path",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
            "required": true,
            "type": "string"
          },
          {
            "name": "exportId",
            "in": "path",
            "description": "The ID of the export to get.",
            "required": true,
            "type": "string"
          }
        ],
        "security": [
          {
            "Oauth2": [
              "https://www.googleapis.com/auth/drive.readonly"
            ]
          }
        ],
        "tags": [
          "exports"
        ]
      },
      "parameters": [
        {
          "$ref": "#/parameters/key"
        },
        {
          "$ref": "#/parameters/access_token"
        },
        {
          "$ref": "#/parameters/upload_protocol"
        },
        {
          "$ref": "#/parameters/prettyPrint"
        },
        {
          "$ref": "#/parameters/quotaUser"
        },
        {
          "$ref": "#/parameters/fields"
        },
        {
          "$ref": "#/parameters/uploadType"
        },
        {
          "$ref": "#/parameters/$.xgafv"
        },
        {
          "$ref": "#/parameters/oauth_token"
        },
        {
          "$ref": "#/parameters/callback"
        },
        {
          "$ref": "#/parameters/alt"
        }
      ]
    },
    "/v2/{service}/exports": {
      "post": {
        "description": "Creates a new Export Job for the user.  This will return immediately,\nthe ID in the response can then be used to poll GetExport to tell when\nthe job is done.",
        "operationId": "takeout_pa.exports.create",
        "responses": {
          "200": {
            "description": "Successful response",
            "schema": {
              "$ref": "#/definitions/CreateExportResponse"
            }
          }
        },
        "parameters": [
          {
            "name": "service",
            "in": "path",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
            "required": true,
            "type": "string"
          },
          {
            "name": "body",
            "in": "body",
            "schema": {
              "$ref": "#/definitions/ExportRequest"
            }
          }
        ],
        "security": [
          {
            "Oauth2": [
              "https://www.googleapis.com/auth/drive.readonly"
            ]
          }
        ],
        "tags": [
          "exports"
        ]
      },
      "parameters": [
        {
          "$ref": "#/parameters/key"
        },
        {
          "$ref": "#/parameters/access_token"
        },
        {
          "$ref": "#/parameters/upload_protocol"
        },
        {
          "$ref": "#/parameters/prettyPrint"
        },
        {
          "$ref": "#/parameters/quotaUser"
        },
        {
          "$ref": "#/parameters/fields"
        },
        {
          "$ref": "#/parameters/uploadType"
        },
        {
          "$ref": "#/parameters/$.xgafv"
        },
        {
          "$ref": "#/parameters/oauth_token"
        },
        {
          "$ref": "#/parameters/callback"
        },
        {
          "$ref": "#/parameters/alt"
        }
      ]
    },
    "/v2/{service}/exports/{exportId}:cancel": {
      "post": {
        "description": "Cancels a running export job.",
        "operationId": "takeout_pa.exports.cancel",
        "responses": {
          "200": {
            "description": "Successful response",
            "schema": {
              "$ref": "#/definitions/CancelExportResponse"
            }
          }
        },
        "parameters": [
          {
            "name": "service",
            "in": "path",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
            "required": true,
            "type": "string"
          },
          {
            "name": "exportId",
            "in": "path",
            "description": "The ID of the export to cancel.",
            "required": true,
            "type": "string"
          }
        ],
        "security": [
          {
            "Oauth2": [
              "https://www.googleapis.com/auth/drive.readonly"
            ]
          }
        ],
        "tags": [
          "exports"
        ]
      },
      "parameters": [
        {
          "$ref": "#/parameters/key"
        },
        {
          "$ref": "#/parameters/access_token"
        },
        {
          "$ref": "#/parameters/upload_protocol"
        },
        {
          "$ref": "#/parameters/prettyPrint"
        },
        {
          "$ref": "#/parameters/quotaUser"
        },
        {
          "$ref": "#/parameters/fields"
        },
        {
          "$ref": "#/parameters/uploadType"
        },
        {
          "$ref": "#/parameters/$.xgafv"
        },
        {
          "$ref": "#/parameters/oauth_token"
        },
        {
          "$ref": "#/parameters/callback"
        },
        {
          "$ref": "#/parameters/alt"
        }
      ]
    }
  },
  "tags": [
    {
      "name": "exports"
    }
  ]
}

Swagger version of Google Takeout API

@ScottG489 You can copy and paste it into https://editor.swagger.io/ to view the API better

Also, you can test the API using this service mentioned above (Swagger.io) using the Swagger version I provided

Documentation generator https://nordicapis.com/7-open-source-openapi-documentation-generators/

{
  "openapi": "3.0.1",
  "info": {
    "title": "Takeout API",
    "description": "",
    "contact": {
      "name": "Google",
      "url": "https://google.com"
    },
    "version": "v2"
  },
  "servers": [
    {
      "url": "https://takeout-pa.googleapis.com/"
    }
  ],
  "tags": [
    {
      "name": "exports"
    }
  ],
  "paths": {
    "/v2/{service}/exports/{exportId}": {
      "get": {
        "tags": [
          "exports"
        ],
        "description": "Gets the status of a single export job.",
        "operationId": "takeout_pa.exports.get",
        "parameters": [
          {
            "name": "key",
            "in": "query",
            "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "access_token",
            "in": "query",
            "description": "OAuth access token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "upload_protocol",
            "in": "query",
            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prettyPrint",
            "in": "query",
            "description": "Returns response with indentations and line breaks.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "quotaUser",
            "in": "query",
            "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "description": "Selector specifying which fields to include in a partial response.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uploadType",
            "in": "query",
            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "$.xgafv",
            "in": "query",
            "description": "V1 error format.",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "2"
              ]
            }
          },
          {
            "name": "oauth_token",
            "in": "query",
            "description": "OAuth 2.0 token for the current user.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "callback",
            "in": "query",
            "description": "JSONP",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "alt",
            "in": "query",
            "description": "Data format for response.",
            "schema": {
              "type": "string",
              "default": "json",
              "enum": [
                "json",
                "media",
                "proto"
              ]
            }
          },
          {
            "name": "service",
            "in": "path",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exportId",
            "in": "path",
            "description": "The ID of the export to get.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/GetExportResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "Oauth2": [
              "https://www.googleapis.com/auth/drive.readonly"
            ]
          }
        ]
      }
    },
    "/v2/{service}/exports": {
      "post": {
        "tags": [
          "exports"
        ],
        "description": "Creates a new Export Job for the user.  This will return immediately,\nthe ID in the response can then be used to poll GetExport to tell when\nthe job is done.",
        "operationId": "takeout_pa.exports.create",
        "parameters": [
          {
            "name": "key",
            "in": "query",
            "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "access_token",
            "in": "query",
            "description": "OAuth access token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "upload_protocol",
            "in": "query",
            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prettyPrint",
            "in": "query",
            "description": "Returns response with indentations and line breaks.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "quotaUser",
            "in": "query",
            "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "description": "Selector specifying which fields to include in a partial response.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uploadType",
            "in": "query",
            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "$.xgafv",
            "in": "query",
            "description": "V1 error format.",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "2"
              ]
            }
          },
          {
            "name": "oauth_token",
            "in": "query",
            "description": "OAuth 2.0 token for the current user.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "callback",
            "in": "query",
            "description": "JSONP",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "alt",
            "in": "query",
            "description": "Data format for response.",
            "schema": {
              "type": "string",
              "default": "json",
              "enum": [
                "json",
                "media",
                "proto"
              ]
            }
          },
          {
            "name": "service",
            "in": "path",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "*/*": {
              "schema": {
                "$ref": "#/components/schemas/ExportRequest"
              }
            }
          },
          "required": false
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/CreateExportResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "Oauth2": [
              "https://www.googleapis.com/auth/drive.readonly"
            ]
          }
        ],
        "x-codegen-request-body-name": "body"
      }
    },
    "/v2/{service}/exports/{exportId}:cancel": {
      "post": {
        "tags": [
          "exports"
        ],
        "description": "Cancels a running export job.",
        "operationId": "takeout_pa.exports.cancel",
        "parameters": [
          {
            "name": "key",
            "in": "query",
            "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "access_token",
            "in": "query",
            "description": "OAuth access token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "upload_protocol",
            "in": "query",
            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prettyPrint",
            "in": "query",
            "description": "Returns response with indentations and line breaks.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "quotaUser",
            "in": "query",
            "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "description": "Selector specifying which fields to include in a partial response.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uploadType",
            "in": "query",
            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "$.xgafv",
            "in": "query",
            "description": "V1 error format.",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "2"
              ]
            }
          },
          {
            "name": "oauth_token",
            "in": "query",
            "description": "OAuth 2.0 token for the current user.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "callback",
            "in": "query",
            "description": "JSONP",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "alt",
            "in": "query",
            "description": "Data format for response.",
            "schema": {
              "type": "string",
              "default": "json",
              "enum": [
                "json",
                "media",
                "proto"
              ]
            }
          },
          {
            "name": "service",
            "in": "path",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exportId",
            "in": "path",
            "description": "The ID of the export to cancel.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/CancelExportResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "Oauth2": [
              "https://www.googleapis.com/auth/drive.readonly"
            ]
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorProto": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "Location of the error, as specified by the location type.\n\nIf location_type is PATH, this should be a path to a field that's\nrelative to the request, using FieldPath notation\n(net/proto2/util/public/field_path.h).\n\nExamples:\n  authenticated_user.gaia_id\n  resource.address[2].country"
          },
          "debugInfo": {
            "type": "string",
            "description": "Debugging information, which should not be\nshared externally."
          },
          "code": {
            "type": "string",
            "description": "Error code in the error domain. This should correspond to\na value of the enum type whose name is in domain. See\nthe core error domain in error_domain.proto."
          },
          "locationType": {
            "type": "string",
            "enum": [
              "PATH",
              "OTHER",
              "PARAMETER"
            ]
          },
          "argument": {
            "type": "array",
            "description": "Error arguments, to be used when building user-friendly error messages\ngiven the error domain and code.  Different error codes require different\narguments.",
            "items": {
              "type": "string"
            }
          },
          "externalErrorMessage": {
            "type": "string",
            "description": "A short explanation for the error, which can be shared outside Google.\n\nPlease set domain, code and arguments whenever possible instead of this\nerror message so that external APIs can build safe error messages\nthemselves.\n\nExternal messages built in a RoSy interface will most likely refer to\ninformation and concepts that are not available externally and should not\nbe exposed. It is safer if external APIs can understand the errors and\ndecide what the error message should look like."
          },
          "domain": {
            "type": "string",
            "description": "Error domain. RoSy services can define their own\ndomain and error codes. This should normally be\nthe name of an enum type, such as: gdata.CoreErrorDomain"
          }
        },
        "description": "Describes one specific error."
      },
      "Errors": {
        "type": "object",
        "properties": {
          "error": {
            "type": "array",
            "description": "Specific error description and codes",
            "items": {
              "$ref": "#/components/schemas/ErrorProto"
            }
          },
          "code": {
            "type": "string",
            "description": "Global error code. Deprecated and ignored.\nSet custom error codes in ErrorProto.domain and ErrorProto.code\ninstead.",
            "enum": [
              "BAD_REQUEST",
              "FORBIDDEN",
              "NOT_FOUND",
              "CONFLICT",
              "GONE",
              "PRECONDITION_FAILED",
              "INTERNAL_ERROR",
              "SERVICE_UNAVAILABLE"
            ]
          },
          "requestId": {
            "type": "string",
            "description": "Request identifier generated by the service, which can be\nused to identify the error in the logs"
          }
        },
        "description": "Request Error information.\n\nThe presence of an error field signals that the operation\nhas failed."
      },
      "ExportJob": {
        "type": "object",
        "properties": {
          "failedItemInfos": {
            "type": "array",
            "description": "The set of items that couldn't be included in the archive.\nIf a directory was specified in ExportRequest.items and items in that\ndirectory failed, each individual file that failed will have an entry in\nfailed_item_infos.",
            "items": {
              "$ref": "#/components/schemas/FailedItemInfo"
            }
          },
          "status": {
            "type": "string",
            "description": "The current status of this export job.",
            "enum": [
              "UNKNOWN",
              "QUEUED",
              "COUNTING",
              "BUILDING",
              "SUCCEEDED",
              "FAILED"
            ]
          },
          "failedItems": {
            "type": "array",
            "description": "Use failed_item_info instead.",
            "items": {
              "type": "string"
            }
          },
          "debugFailureInfo": {
            "type": "string",
            "description": "Detailed information about what failed in the case status = FAILED.\nThis information is for internal debugging only and should not be shared\nwith user."
          },
          "archives": {
            "type": "array",
            "description": "A set of records that contain information about the completed archives\ncreated by this job.  This will only be present if status = SUCCEEDED.",
            "items": {
              "$ref": "#/components/schemas/Archive"
            }
          },
          "items": {
            "type": "array",
            "description": "The items being exported. If a directory is present all\nitems under that directory will be included.",
            "items": {
              "$ref": "#/components/schemas/TakeoutItem"
            }
          },
          "id": {
            "type": "string",
            "description": "The ID of this job. Can be used to get or cancel this job."
          }
        },
        "description": "The representation of an export job.  Used for creating new jobs\nand reporting the state of existing jobs."
      },
      "ExportRequest": {
        "type": "object",
        "properties": {
          "locale": {
            "type": "string",
            "description": "Allows the client to specify a locale for the request.\nThe format of the string is an IETF\nlanguage tag, such as \"en-US\", as defined in\nBCP 47 (http://tools.ietf.org/html/bcp47). More practically, the content\nof the string should be one that is appropriate for creating a java\nLocale object.  Defaults to \"en-US\" if not specified."
          },
          "items": {
            "type": "array",
            "description": "The requested items to export. If a directory is specified, all\nitems under that directory will be exported, but only top-level\nitems are captured in this field.",
            "items": {
              "$ref": "#/components/schemas/TakeoutItem"
            }
          },
          "initiatingClientService": {
            "type": "string",
            "enum": [
              "UNKNOWN_SERVICE",
              "ACCOUNT_CENTRAL",
              "LIS",
              "DASHER",
              "PATRONUS",
              "PROBATE",
              "DRIVE_SERVICE",
              "TAKEDOWN",
              "DASHER_SUPPLEMENTAL",
              "LRTOOL_SOCIAL_RETENTION",
              "ACCOUNT_MIGRATION_UI",
              "NEST_SERVICE",
              "ACCOUNT_CENTRAL_SCHEDULED",
              "TRANSFER",
              "PHOTOS_DOWNLOAD_SERVICE",
              "TAKEOUT_INTERNAL"
            ]
          },
          "archivePrefix": {
            "type": "string",
            "description": "Optional prefix for the archive filename. Will be followed by a '-'\n& an ISO standard timestamp in yyyyMMdd'T'HHmmssZ format. Prefix\ndefaults to \"takeout\" if none specified, resulting in an archive\nname like \"takeout-20150924T221439Z.zip\"."
          },
          "service": {
            "type": "string",
            "description": "The Takeout service, from jcg/dataliberation/common/model/Service.java."
          }
        },
        "description": "A request to create a new export."
      },
      "CreateExportResponse": {
        "type": "object",
        "properties": {
          "exportJob": {
            "$ref": "#/components/schemas/ExportJob"
          },
          "errors": {
            "$ref": "#/components/schemas/Errors"
          }
        },
        "description": "The result of a request to create a new export."
      },
      "FailedItemInfo": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "The user visible title of the item that failed, empty if the failure was\ndue to permissions."
          },
          "cause": {
            "type": "string",
            "description": "The cause of the failure, if known.",
            "enum": [
              "UNKNOWN",
              "GENERIC",
              "ITEM_NOT_FOUND",
              "DOWNLOAD_PROHIBITED",
              "CONTAINS_VIRUS"
            ]
          },
          "relativePath": {
            "type": "string",
            "description": "The path to the failed item from one of the root items specified when\nstarting the export.  The path includes the file name.\nIf this item is reachable via multiple paths (e.g. the individual item\nwas selected as well as the parent folder or the item is multi-included\nin several folders) it is undefined (and non-deterministic) which root\nnode this path will be relative to."
          },
          "docId": {
            "type": "string",
            "description": "The document ID of the item that failed."
          },
          "mediaType": {
            "type": "string",
            "description": "The mime type of the file."
          }
        },
        "description": "Info about a failed item (file or folder) in an export."
      },
      "Archive": {
        "type": "object",
        "properties": {
          "storagePath": {
            "type": "string",
            "description": "The downloadable url of the completed archive."
          },
          "compressedSize": {
            "type": "string",
            "description": "The size, in bytes, of the compressed archive.",
            "format": "uint64"
          },
          "fileName": {
            "type": "string",
            "description": "The full name of the archive file, including extension (but not\nincluding path)."
          },
          "sizeOfContents": {
            "type": "string",
            "description": "The size, in bytes, of all the items in the archive.",
            "format": "uint64"
          }
        },
        "description": "A completed archive file (e.g. zip or tgz)."
      },
      "GetExportResponse": {
        "type": "object",
        "properties": {
          "exportJob": {
            "$ref": "#/components/schemas/ExportJob"
          },
          "percentDone": {
            "type": "integer",
            "description": "Percent done (# completed files) / (# total files).\nIncluded for BUILDING exports only.",
            "format": "int32"
          },
          "numFetchedFiles": {
            "type": "integer",
            "description": "Total number of fetched files. Set for completed exports only.\nIf a folder containing 2 files was downloaded, num_fetched_files = 2.",
            "format": "int32"
          },
          "errors": {
            "$ref": "#/components/schemas/Errors"
          }
        },
        "description": "Details about a given export."
      },
      "TakeoutItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the item, must line up with the id that that service's\nTakeout integration produces."
          }
        },
        "description": "Represents an item (file/folder/album) in the product."
      },
      "CancelExportResponse": {
        "type": "object",
        "properties": {
          "errors": {
            "$ref": "#/components/schemas/Errors"
          },
          "succeeded": {
            "type": "boolean",
            "description": "Whether the export was successfully cancelled"
          }
        },
        "description": "The result of a request to cancel a given export."
      }
    },
    "parameters": {
      "key": {
        "name": "key",
        "in": "query",
        "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
        "schema": {
          "type": "string"
        }
      },
      "access_token": {
        "name": "access_token",
        "in": "query",
        "description": "OAuth access token.",
        "schema": {
          "type": "string"
        }
      },
      "upload_protocol": {
        "name": "upload_protocol",
        "in": "query",
        "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
        "schema": {
          "type": "string"
        }
      },
      "prettyPrint": {
        "name": "prettyPrint",
        "in": "query",
        "description": "Returns response with indentations and line breaks.",
        "schema": {
          "type": "boolean",
          "default": true
        }
      },
      "quotaUser": {
        "name": "quotaUser",
        "in": "query",
        "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
        "schema": {
          "type": "string"
        }
      },
      "fields": {
        "name": "fields",
        "in": "query",
        "description": "Selector specifying which fields to include in a partial response.",
        "schema": {
          "type": "string"
        }
      },
      "uploadType": {
        "name": "uploadType",
        "in": "query",
        "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
        "schema": {
          "type": "string"
        }
      },
      "$.xgafv": {
        "name": "$.xgafv",
        "in": "query",
        "description": "V1 error format.",
        "schema": {
          "type": "string",
          "enum": [
            "1",
            "2"
          ]
        }
      },
      "oauth_token": {
        "name": "oauth_token",
        "in": "query",
        "description": "OAuth 2.0 token for the current user.",
        "schema": {
          "type": "string"
        }
      },
      "callback": {
        "name": "callback",
        "in": "query",
        "description": "JSONP",
        "schema": {
          "type": "string"
        }
      },
      "alt": {
        "name": "alt",
        "in": "query",
        "description": "Data format for response.",
        "schema": {
          "type": "string",
          "default": "json",
          "enum": [
            "json",
            "media",
            "proto"
          ]
        }
      }
    },
    "securitySchemes": {
      "Oauth2": {
        "type": "oauth2",
        "description": "Oauth 2.0 authentication",
        "flows": {
          "implicit": {
            "authorizationUrl": "https://accounts.google.com/o/oauth2/auth",
            "scopes": {
              "https://www.googleapis.com/auth/drive.readonly": "See and download all your Google Drive files"
            }
          }
        }
      }
    }
  }
}

@ScottG489 Also the OpenAPI 3 file if you're interested.

@ScottG489 Also take a look at this. It's another playground

I've uploaded my photos and videos to google drive (uploaded in original quality), and I want to download those medias in original quality with intact metadata. I'm looking for an api that does this and zips files which are not already zipped, and zips in chronological order.

@AlexDev404 Thanks, that was really helpful. So I finally got around to playing with this.

Does this still work? I was able to make some progress and get my creds set up and authed (via the API viewer you linked), but I got this error eventually:

"message": "Takeout API has not been used in project abc123 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/takeout-pa.googleapis.com/overview?project=abc123 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.",

However, this is problematic because obviously there is no such thing as the Takeout API. What are your thoughts on this?

@stewartmcgown @ScottG489 @AlexDev404 : Silly question, but does this actually work or is it conceptual? I think I have this setup. I am targeting the endpoint directly, but am getting a 404 error. Let me know if I am missing something.

Not silly at all. I wasn't ever able to get this to work and I don't understand how it would ever work since there's no official Takeout API that would be available to be enabled in the dev console.

If you make any progress with this I'd be very interested to hear.

You can send POST requests to the endpoint and initiate takeout requests. It is the same format that Google Drive uses to initiate downloads of folders. I've included in the gist my attempts to use the API. This is not a supported API, rather, this is an internal API which had a discovery.json exposed via Google's Discovery Service, which lists service schemas. I've never used this for anything, just found it!

…

On Tue, 12 Dec 2023, 17:32 Scott Giminiani, ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ Not silly at all. I wasn't ever able to get this to work and I don't understand how it would ever work since there's no official Takeout API that would be available to be enabled in the dev console. If you make any progress with this I'd be very interested to hear. — Reply to this email directly, view it on GitHub <https://gist.github.com/stewartmcgown/7f5dcbf4ccd385637786f9581b620e6a#gistcomment-4790671> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAIVNFGZXZN4RHTBWKC6XHDYJCIKNBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTAMBTGE4DQMJZU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you authored the thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

Hey @stewartmcgown, appreciate you responding :)

Would you mind posting something like an example curl request to demonstrate how to actually make that POST request? I spent quite a bit of time on this and wasn't able to figure it out. Or maybe go into a bit more detail on how to use it otherwise?