Skip to main content

Google Keep

The Google Keep modules allow you to create and modify notes, update permissions, and make API calls.

Getting Started with Google Keep

Prerequisites

  • A Google Cloud Platform account

  • Google Cloud Credentials (OAuth Client ID and Client Secret)

In order to use Google Keep with Make, it is necessary to have a Google Cloud Platform account. If you do not have one, you can create one at console.cloud.google.com.

Note

The Google Keep API is an enterprise-only API, so you must use a Google Cloud Platform service account with domain-wide delegation enabled.

Connect Google Keep to Make

To connect Google Keep to Make, you must first connect your Google Cloud Platform account to Make. To do so, you must provide the Client ID and Client Secret.

Obtain OAuth Client ID and Client Secret

  1. Open your Google Cloud Console.

  2. Create a new project.

    google_keep_1.png

  3. Go to the APIs & Services > Credentials and configure the OAuth consent screen.

  4. Add make.com to the Authorized domains field.

    google_keep_3.png

  5. Click Save and Continue until the process is complete.

  6. Create the OAuth client ID. Click Create credentials, then OAuth client ID.

    google_keep_4.png

    Use https://www.integromat.com/oauth/cb/google-custom as a redirect URI.

  7. Now, you can copy the Client ID and the Client Secret.

    google-keep-2.png

  8. Go to the Google Admin.

  9. From the left menu, navigate to Security > Access and data control > API controls.

  10. Click Manage Domain-Wide Delegation.

  11. Click Add new, in the Client ID field, paste the client ID from step 7, and click Authorize.

You have now obtained client credentials.

Connect Google Keep to Make

To connect to the Google Keep app:

  1. Log in to your Make account, insert a Google Keep module scenario, and click the Add button next to the Connection field.

    google-keep-8.png

  2. Optional: In the Connection name field, enter a name for the connection.

  3. In the Client ID and Client Secret fields, enter the client credentials retrieved in the section, Obtain OAuth Client ID and Client Secret.

  4. Optional: Click Show Advanced Settings and add the required additional scopes for the connection.

  5. Click Sign in with Google to sign in to your Google account and connect the app or click Close to cancel the connection.

You have successfully established the connection. You can now edit your scenario and add more Google Keep modules. If your connection needs reauthorization at any point, follow the connection renewal steps here.

Other

Watch Notes

Triggers when a note is created or updated.

Connection

Establish a connection to your Google Keep account.

Event Type

Select whether the webhook triggers when a note is Created or Updated.

Note

If you select Updated, the module triggers for both created and updated segments.

Limit

Set the maximum number of results Make delivers during one scenario execution cycle.

Make an API Call

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Google Keep account.

URL

Enter a path relative to https://developers.google.com/keep/api/. For example: /v3/files.

Note

For the list of available endpoints, refer to the Google Keep API Documentation.

Method

Select the HTTP method you want to use:

  • GET to retrieve information for an entry.

  • POST to create a new entry.

  • PUT to update/replace an existing entry.

  • PATCH to make a partial entry update.

  • DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List All Notes

The following API call returns all notes in your Google Keep:

URL:

/v1/notes

Method:

GET

google_keep_5.png

The result can be found in the module's Output under Bundle > Body > notes. Our example returned 10 notes:

google_keep_6.png

Notes

Create a Note

Creates a new note.

Connection

Establish a connection to your Google Keep account.

Title

Enter the title of your note. The length must be less than 1,000 characters.

Body

Select the type of content of your note.

  • Text

    Enter the text for your note. The length of the text must be less than 20,000 characters.

  • List

    Add the list items for your note. The number of items must be less than 1,000.

List Notes

Lists notes.

Connection

Establish a connection to your Google Keep account.

Filter

Add a filter for for the list results. If you don't supply a filter, the trashed filter applies by default. The valid fields to filter by are: createTime, updateTime, trashTime, and trashed.

Note

Filter syntax follows the Google AIP filtering spec.

Body

Set the maximum number of notes Make delivers during one scenario execution cycle.

Get a Note

Returns a note.

Connection

Establish a connection to your Google Keep account.

Name

Select or enter the name of the note you want to retrieve.

Delete a Note

Deletes a note.

Connection

Establish a connection to your Google Keep account.

Name

Select or enter the name of the note you want to delete.

Permissions

Create a Permission

Creates one or more permissions on the note.

Note

You can only create permissions with the Writer role. If you add any permission fails, then the entire request fails and no changes are made.

Connection

Establish a connection to your Google Keep account.

Name

Select or enter the name of the note you want to create a permission for.

Permissions

Enter the email address associated with the member you want to create a permission for.

Delete a Permission

Deletes one or more permissions on the note.

Note

The specified entities will immediately lose access. You can't remove the Owner role.

Connection

Establish a connection to your Google Keep account.

Note

Select or enter the name of the note you want to delete a permission for.

Permissions

Select or enter the names of the permissions you want to delete.

Permissions Information for Google Keep

  • Create a Note - https://www.googleapis.com/auth/keep

  • Create a Permission - https://www.googleapis.com/auth/keep

  • Delete a Note - https://www.googleapis.com/auth/keep

  • Delete a Permission - https://www.googleapis.com/auth/keep

  • Get a Note - https://www.googleapis.com/auth/keep.readonly

  • List Notes - https://www.googleapis.com/auth/keep.readonly

  • Make an API Call - https://www.googleapis.com/auth/keep, https://www.googleapis.com/auth/keep.readonly

  • Watch Notes - https://www.googleapis.com/auth/keep.readonly

In this section: