Using Google API

If you want to use the Google Drive and Sheets APIs directly instead of using our hosted service, you will need to create a project in the Google Developers Console and generate an OAuth Client ID.

Generating an OAuth Client ID

1. Open the Google Developers Console and login
2. Create a new project (you can name it whatever you want, for example git-housekeeper)
3. Select the OAuth Consent Screen tab on the Credentials page
4. Select an Email address, enter a Product name if not already set, and click the Save button
5. Select the Credentials tab, click the Create credentials button and select OAuth client ID.
6. Select the application type Other, enter a name and click the Create button.
7. Click OK to dismiss the resulting dialog.
8. Click the Download JSON icon to the right of the client ID. You will need this JSON later
9. Go to the Library page using the navigation on the left
10. Search for and enable the Google Drive API and Google Sheets API
11. Rename the JSON downloaded in step 8 to google_client_secret.json and move it to one of the following locations:
    • <user home directory>/.credentials/
    • the working directory from which you run git-housekeeper

Using the key in git-housekeeper

1. Make sure you completed the instructions for generating an OAuth Client ID above
2. Run the git-housekeeper tool on your repository
3. Select "review branches on remote" in the main menu
4. Choose "review branches collaboratively using Google Sheets"
5. Choose "no, I'd rather use the Google API directly"
6. Follow the on-screen instructions