A Drive API shortcut is a file that references an existing target rather than duplicating its contents. Create it with the shortcut MIME type and target ID, then verify target access separately from the shortcut’s parent-folder visibility.
Build the intended metadata
Use files.create with mimeType set to application/vnd.google-apps.shortcut and shortcutDetails.targetId set to the authorized original. Supply a suitable name and permitted parent when the application needs a specific location.
Use the current v3 resource field names, not a copied sample’s accidental capitalization or another API version’s shape. A target ID should come from a verified item, not a filename guess.
Check visibility and authorization
Google documents that the shortcut inherits its parent’s access controls and its own ACL cannot be changed directly. The target has its separate permissions. Someone seeing the shortcut can still be unable to open the original.
The shortcut name can differ from the target and can disclose information to people who can see its folder. Choose a destination and name consistent with the target’s confidentiality.
Verify and maintain the reference
Inspect the returned shortcut ID and target details and confirm the intended authorized opening behavior. A deleted or inaccessible target breaks the reference; recreating another shortcut does not restore that content or permission. Google also notes that a shortcut’s stored target type or name can become stale relative to later target changes. Keep the authoritative target clear and do not delete it as part of shortcut cleanup. On a create timeout, reconcile the operation before repeating it so the app does not produce unnecessary duplicate navigation items.
References
- Create a shortcut to a Drive file | Google Drive | Google for Developers
- Share files, folders, and drives | Google Drive | Google for Developers
Reviewed against the linked official product guidance on November 3, 2026. Features, limits, screen labels, and access can vary by account, platform, region, and organization policy.