Custom Connector to import Google Sheets with OAuth2 authentication in PowerBI

EDIT 17th August 2019: Added instructions for the newly added consent screen below..

Recently I came across the need to connect to Google Sheets with a secure authentication process quite often, so I will share with you how and to what extend I got the custom connector working that I found here. It uses OAuth2 authentication, so you can share your workbook with selected colleagues and they will be prompted to enter their credentials in Power BI if they try to access these files.

Edit: As it turns out, the credentials work for all Google accounts. So you can download my .mez  and simply paste it into your Custom Connectors-path without touching Visual studio ( create path: [My Documents]\Microsoft Power BI Desktop\Custom Connectors ). I believe this will work for the 1st 100 users and then you have to create you own. But if you want to use it in production, I’d strongly recommend to create your own anyway (otherwise continue with section “Use Google Sheets Data Connector in Power BI Desktop”) :

Setup Google API

Go to the Google Developer API and if you don’t have a project yet, just create one:

NEW: A OAuth consent screen will pop up and you have to give your app a name and fill in “” into the “Authorized Domains”:

Next go to “Credentials” -> Create credentials and choose “OAuth client ID”:

Choose “Web application”, adjust the “Name” if you like and paste the redirect-url into “Authorized redirect URLs”:

This will return the client ID and secret for your connector:


Adjust the connector in Visual Studio

Next clone the project and open in Visual Studio:

“PQGoogleSpreadsheet.pq” is the file you need to edit:

The documentation says “To make it run add client_id.txt and client_secret.txt containing your Google API client credentials”, but I didn’t find out where to store these file to make it work, so I replaced the green strings with the hardcoded Google OAuth values:

It would be nice being able to treat these strings as variables, so that one could use one connector for content from different users: So if you know how to get this working, please give a shout.

Then build the project and move the .mez-file from the bin-folder of your project to your custom connector folder ( its “C:\Users\imkef\Documents\Microsoft Power BI Desktop\Custom Connectors” in my case).

Use Google Sheets Data Connector in Power BI Desktop

Close PBID and re-open so you will see the new connectors in your data sources:


Authentication in PBID

Enter the URL for your file into the next dialogue:

and this warning will show:

Click “Edit Credentials” and this dialogue will pop up:

Check “Sign in” and a Google authentication window will appear:

Enter credentials and the data of the sheet will appear in a clean format.

If data connectors are new to you, check out this article to get you started.

Edit: This is currently only supported for the Desktop version. But implementation for the service is planned.

Enjoy & stay queryious 🙂

Comments (26) Write a comment

  1. I was able to get to work in the PowerBI Desktop, thanks! Has anyone been able to get this to work in the PowerBI online service in terms of automated refresh? In the service I get a message that tells me this is not a supported connector.


    • No, it’s currently just supported for the Desktop-version.
      It will definitely not work in the service now, but should come for the service later as well.


      • We are hoping sooner as this is a big requirement for us and a lot of other companies. We keep lobbying Microsoft but it does not seem to be a priority.


        • I don’t know a timeline for this, but my impression is that the connectors have a high priority for Microsoft. So wouldn’t be too pessimistic about it.


          • Microsoft has implemented custom connector ability in the On-Premise Gateway (personal mode). This means it will work to refresh google sheet data in the service soon. I say soon as I am not able to get this to work yet. Has anyone had any luck?

          • Hi Robert,
            no I haven’t had the chance to test it yet.
            Cheers, Imke

  2. HI,

    I’m trying to use this great custom connector, but without successes.

    After adding the spreadsheet url i get the error below:

    [Details: “We cannot convert the value null to type Text.”]

    Any help will be highly appreciated,

    Thanks in Advanced,


    • Did you build it yourself or did you use my .mez that you can download from github?
      If you created the .mez yourself, please compare it with my version from github.version from github (unzip the files and open the .m-files with an editor of your choice, or directly in Visual Studio).
      Cheers, Imke


  3. I’m totally beginner, So I followed each step accurately.

    I’ve used your .mez file and just change the client_id and the client_secret.
    It seems that the connector is working, but after i entered the spreadshhet url,
    it did not log in and the written error below appeared.

    Unable to connect
    We encountered an error while trying to connect.
    Details: “We cannot convert the value null to type Text.”


  4. Hi Imke,

    I managed to solve it
    It turned out that another connector caused the problem.

    Thank you for your help, and for your great connector.

    Best Regrades,


    • Not yet. Custom connectors are currently supported only for Power BI Desktop unfortunately.


  5. 1) Does the URL have to be in any particular format for the step “Enter the URL for your file into the next dialogue”?

    2) When I try to Refresh All in PBID, I’m sometimes but not always getting errors that random columns cannot be found, even though individual query Refresh Previews succeed without errors (i.e. there are no problems with the underlying columns). I’ve seen this type of error mentioned on other search results for Power BI + Google Sheets, which makes me wonder whether ongoing/stable/refreshable connections to Google Sheets are still not possible as of July 2018. Have you not encountered this kind of error?



    • Hi PR,
      I’m not using this in practice, so no further experience here.
      URL has to be simple text.


  6. Hi! I am following along, and got a little stuck at the Visual Studio part, as its a program im not all that familiar with.

    I opened the project in VS without problem, even used the GitHub extension. I applied the changes as expected, but I dont have an option to build, nor do I have any .mez files.

    Is there anything im missing?


  7. Hello,

    I am following the above steps but I am unable to add Authorized redirect URIs as it shows me this error: “Invalid Redirect: domain must be added to the authorized domains list before submitting.”. Please guide me as soon as possible.

    Thanks in advance.


    • Very sorry, but the solution doesn’t seem to work any more.
      Just included a disclaimer in the post so that other users don’t waste their time on this.

      Will update once I’ve got it working again.


  8. This worked for me! Not sure if I did anything different, but happy to help if I can. Only thing I noticed was that I had to press enter after pasting in the redirect URL. Also, I put the id and secret into two files I created in the project folder called “client_id.txt” and “client_secret.txt”, then set their Build Action to “Compile” in Visual Studio.


  9. I only use it with a manual monthly-ish refresh, so I’m not sure about the service – sorry!
    Also, I was unable to reply to your comment – Firefox just kept trying to download wp-comments-post.


  10. Hi All

    Does this also work with Power BI Report Server as well? In the document you put ; is it for t the service address or could I use the company domain?

    Many thanks in advance


  11. Hi Admin,

    I was able to create this connector thanks to your awesome post although slight complications in the process. I was trying to configure scheduled refresh for this connector using Personal Gateway as listed by this blog

    This article says to include a test connection handler function to “update your Custom Connector to be refreshable on the cloud.” I was having trouble setting this function up in my code file as I’m not that good of a programmer. Can you show how to integrate this with your provided code?


Leave a Reply

Die Datenschutzbestimmungen finden Sie hier: / Please find the privacy policy here: