Setup Authentication for Google Assistant Unofficial Desktop Client

Device Registration

1. Head on to Actions Console

2. Click on the "New Project" button

3. You will see a "New Project" popup. Enter any project name and set other options accordingly and click on "Create Project button"

4. Now, after your project is created, you will see the "onboarding" page. Just scroll to the bottom and click on the "click here" link right after the text "Are you looking for device registration?" to proceed to Device Registration

5. Wait until your project is created...

6. Now, you will be landed in the "Device Registration" page. Here, click on "Register Model" button

7. You will see a "Register Model" popup, fill all the details and for device type, select any (eg: light). Then, finally click on "REGISTER MODEL"

8. Now, after you have created a model, you will be asked to download the credentials. Click on "Download OAuth 2.0 credentials"

Now, you are done with the registration process. But in order to authenticate, you have to "Configure Consent Screen"

Configure Consent Screen

1. Head on to Cloud Console

2. In the Navbar beside the logo, click on the button to select a project

3. You will see a popup titled "Select a project". Click on the "ALL" tab and select the name of the project you just created. Then, press OPEN to continue

4. Now, from the hamburger menu, select "APIs & Services"

5. Click on "ENABLE APIS AND SERVICES"

6. You will be landed in "API Library"

7. In the search bar, type "Google Assistant" and click on "Google Assistant API"

8. Press "ENABLE" button to enable the API

9. Wait until the API is enabled

10. Now, from the hamburger menu, click on "Credentials"

11. Click on the "CONFIGURE CONSENT SCREEN"

12. In the OAuth Consent Screen under User Type, select External. Then, click CREATE

13. In the next page, under "App Registration" select your email for "User Support email"

14. Scroll down to the bottom of the page. Under "Developer Contact Information", fill in your email address for "Email addresses" and click on SAVE AND CONTINUE

15. Now skip the "Scopes" screen by clicking on SAVE AND CONTINUE

16. Under "Test Users" click on "ADD USERS" button

17. Under "Add Users", type the email address of the Gmail account that you will use to authenticate (preferably your current Gmail account). You can add multiple Gmail accounts by adding a comma after each of the Gmail accounts.

Setting authentication in the app

1. Run and launch the Google Assistant Unofficial Desktop Client app

2. Click on the "Settings" button in the top-left corner of the application

3. Under the "Authentication" section, set the "Key File Path" to the path where you have kept the "OAuth 2.0 Credentials" and leave the "Saved Tokens Path" empty. Now click on "Save" button

4. You will be prompted to automatically create a path for "Saved Tokens Path". Click on "Automatically set a path"

5. You will be asked to reload the Assistant. Click on "Relaunch Assistant" button

6. Now, you will be presented with the "Get Token!" screen. An authentication page will be opened in your default browser

7. Select the preferred Gmail account to authenticate

8. You might come across the following warning: "Google hasn't verified this app". Since the project is created by you, this should be safe to proceed with. Click on "Advanced"

9. Click on "Go to project-xxxxxx (unsafe)"

10. Now grant permission to the project by clicking on "Allow"

11. You will now be presented with the authorization code screen. Click on the copy button

12. Switch to the application and paste the code in the respective field. Now click on "Submit"

13. You will be prompted to relaunch the app again. Click on "Relaunch Assistant"

Now, you are all set! You can finally use the Google Assistant Unofficial Desktop Client and customize it the way you want... 😉

Other References

Device Registration using UI:

• https://developers.google.com/assistant/sdk/guides/library/python/embed/config-dev-project-and-account

Device Registration using Command Line Tool:

• https://developers.google.com/assistant/sdk/reference/device-registration/register-device-manual