

We hope Drive shortcuts simplify how content is organized and shared, and that these changes enable your apps-and your users-to take advantage of these new features.Because scanner is part of Google Drive app, you will have to open Drive and click on the ‘+’ icon to begin. The API reference has been updated to describe the new parameters in the contexts of each affected endpoint. We have introduced pages dedicated to single-parenting behavior changes ( v2, v3) and the steps app developers need to take to migrate ( v2, v3). This affects the permissions.insert (v2) and permissions.create (v3) endpoints.įor more information, take a look at our updated developer documentation. The previous owner will always maintain editor access to the item, just as they had prior to these changes. If they choose to move the item, any access inherited from the previous parent will be lost, but access that had been directly added to the item will be preserved. When transferring ownership, the requester will be able to control whether the transferred item is moved to the new owner’s root or kept where it is. This affects the lete (v2), lete (v2 / v3), files.emptyTrash (v2 / 3), files.update (v2 / v3), and lete (v2) endpoints. This affects the children.insert (v2), files.update (v2 / v3), and parents.insert (v2) endpoints.Īny operation that would have previously resulted in an item no longer having parents will now result in the item being parented under its owner’s My Drive. Previously, the owner could add the item to any folder, causing it to become multi-parented, but this option will no longer be available. Access that was added directly on the item will be preserved. All access inherited from those parents will be removed. You can use the canMoveItemWithinDrive capability to check if the user has access to move an item.Īn item’s owner will now be able to move their item into a new location, removing all of the item’s current parents, even if they don’t have access to those parents. This affects the files.update (v2 / v3) endpoint. If the requester cannot share an item, they should create a shortcut to it instead. Previously, only read access to the item was required. Moving an item will require access to share the item. This affects the files.insert (v2), files.create (v3) and py (v2 / v3) endpoints. You can use the new canAddMyDriveParent capability to check if an item currently has no parents and if the user has sufficient access to add a parent for the item.Ī request that creates a new item can no longer specify multiple parents.

This affects the children.insert (v2), files.update (v2 / v3) and parents.insert (v2) endpoints. You can only add a parent for an item that doesn't already have one. The specific changes to the API’s behavior are: We will adaptively select the most suitable parent to keep, based on the hierarchy's properties. Any other parent-child relationships will become shortcuts in the former parent folders. 30, 2020, we will begin migrating all items in Drive to a one-parent state. If you choose to opt in ahead of time, the eventual enforcement will cause no further changes to your app’s behavior.Īfter Sept. To opt in to the new behavior, set its value to true on the requests you make to the Google Drive API. We have introduced a new enforceSingleParent request parameter on affected endpoints. This simplification of Drive's folder structure and sharing models will result in a change in the way some Google Drive API endpoints behave.ĭevelopers are now able to opt in to the new model to develop and test their apps. In the new model, shortcuts can be used to organize content in multiple hierarchies. 30, 2020, it will no longer be possible to place an item in multiple folders every item will have exactly one location. This will ensure your apps continue to work properly, and enable you to take advantage of the latest features in Drive.īeginning Sept. Shortcuts, which are now generally available, will also require those of you who build on the Google Drive API to plan for some upcoming changes. Shortcut files can be stored anywhere in Google Drive, including a shared drive or an individual user’s “My Drive.” These efforts have resulted in Drive shortcuts, which are files that act as pointers to other files in Google Drive. The G Suite team has been working hard to make it easier to organize and share content in Google Drive, and help direct users to relevant files across various drives.
