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.

Connecting 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.

How to retrieve the 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.

    61f26f4a09de2.png
  8. In Make, choose the Google Keep module you would like to use.

  9. Enter these credentials in the Create a connection dialog box.

You have now connected Google Keep to Make.

Other

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.

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.

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

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.

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: createTimeupdateTimetrashTime, 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.

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.

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

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.

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.