readme.md

   1 # Google-Drive-Permission-Set
   2 Automates Setting permissions on google drive
   3 ## How to use
   4 1) Download Java if you don't have it.
   5 2) Get files from build/libs
   6 3) Run file and follow instructions
   7
   8 ### Imporant Notes
   9 At the moment this can only search 1000 files at a time. This is the restriction of the API and to bypass these issues I recommend renaming anything where you think the name is reused a lot. The program will give an error message just to make sure you do not encounter this problem and blame me. There is a fix, but unless demanded the hack solution will be done.<br/>
  10 For a similar reason, you can't set Permissions based off of the root directory to ensure you do not mess with other people's similarly named files in shared drive projects.
  11
  12 ### Tutorial
  13
  14 In google drive say you have a bunch of folders and within them identically named files.<br/>
  15 <img src="http://puu.sh/CAYYo/52a487e195.png"/>
  16 <br/>
  17 <img src="http://puu.sh/CAYZV/8bc7e3ad0e.png"/>
  18 <br/>
  19 This application will go through each of them based off of a name and a specified top level folder and give them a permission setting of Owner, Writer(an editor), a commenter, or a reader. You can specify users by their email account or, where applicable, make everyone have that permission. <br/>
  20
  21 ## FAQ
  22
  23 How to find the google drive ID for your top level folder?<br/>
  24 <ul><li><img src='http://puu.sh/CAZ4q/ed23250a23.png'> <br/> Within the URL of any google drive folder there is a set of numbers and letters that look random. This is the ID you must enter. Google drive and this application can not view folders as unique items so it must use IDs.</li></ul>
  25
  26 What if I mess up?<br/>
  27 <ul><li>Restart the program</li></ul>
  28
  29 How do I change accounts?<br/>
  30 <ul><li>In the directory containing the JAR file you should see a credential file. Delete that, rerun and you should see a new window to change accounts</li></ul>
  31
  32 This is really slow...<br/>
  33 <ul><li>The Google Drive API is not well documented so certain shortcuts have been made that are not optimal. Also the API will limit you even if you use their services within the specified restrictions. Because of this each HTTP request needs a cooldown period of a few seconds. Future fixes may involve understanding how the Java framework works to better implement the queries, but the cooldown period is nescicary for batch requests</li></ul>