diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/common-issues.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/common-issues.md new file mode 100644 index 00000000000..b646e325db7 --- /dev/null +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/common-issues.md @@ -0,0 +1,38 @@ +--- +#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4 +title: Google Drive Trigger node common issues +description: Documentation for common issues and questions in the Google Drive Trigger node in n8n, a workflow automation platform. Includes details of the issue and suggested solutions. +contentType: integration +priority: medium +--- + +# Google Drive Trigger node common issues + +Here are some common errors and issues with the [Google Drive Trigger node](/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/) and steps to resolve or troubleshoot them. + + +## 401 unauthorized error + +The full text of the error looks like this: + +``` +401 - {"error":"unauthorized_client","error_description":"Client is unauthorized to retrieve access tokens using this method, or client not authorized for any of the scopes requested."} +``` + + +This error occurs when there's an issue with the credential you're using and its scopes or permissions. + +To resolve: + +1. For [OAuth2](/integrations/builtin/credentials/google/oauth-single-service/) credentials, make sure you've enabled the Google Drive API in **APIs & Services > Library**. Refer to [Google OAuth2 Single Service - Enable APIs](/integrations/builtin/credentials/google/oauth-single-service/#enable-apis) for more information. +2. For [Service Account](/integrations/builtin/credentials/google/service-account/) credentials: + 1. [Enable domain-wide delegation](/integrations/builtin/credentials/google/service-account/#enable-domain-wide-delegation). + 2. Make sure you add the Google Drive API as part of the domain-wide delegation configuration. + +## Handling more than one file change + +The Google Drive Trigger node polls Google Drive for changes at a set interval (once every minute by default). + +If multiple changes to the **Watch For** criteria occur during the polling interval, a single Google Drive Trigger event occurs containing the changes as items. To handle this, your workflow must account for times when the data might contain more than one item. + +You can use an [if node](/integrations/builtin/core-nodes/n8n-nodes-base.if/) or a [switch node](/integrations/builtin/core-nodes/n8n-nodes-base.switch/) to change your workflow's behavior depending on whether the data from the Google Drive Trigger node contains a single item or multiple items. diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/index.md similarity index 88% rename from docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger.md rename to docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/index.md index fa576c0df69..683c03210a8 100644 --- a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger.md +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/index.md @@ -21,3 +21,7 @@ For usage examples and templates to help you get started, refer to n8n's [Google /// note | Manual Executions vs. Activation On manual executions this node will return the last event matching its search criteria. If no event matches the criteria (for example because you are watching for files to be created but no files have been created so far), an error is thrown. Once saved and activated, the node will regularly check for any matching events and will trigger your workflow for each event found. /// + +## Common issues + +For common questions or issues and suggested solutions, refer to [Common issues](/integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/common-issues/). diff --git a/mkdocs.yml b/mkdocs.yml index 69c05b4bec2..d013f92cadc 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -784,7 +784,9 @@ nav: - Poll Mode options: integrations/builtin/trigger-nodes/n8n-nodes-base.gmailtrigger/poll-mode-options.md - Common issues: integrations/builtin/trigger-nodes/n8n-nodes-base.gmailtrigger/common-issues.md - Google Calendar Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.googlecalendartrigger.md - - Google Drive Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger.md + - Google Drive Trigger: + - Google Drive Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/index.md + - Common issues: integrations/builtin/trigger-nodes/n8n-nodes-base.googledrivetrigger/common-issues.md - Google Business Profile Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.googlebusinessprofiletrigger.md - Google Sheets Trigger: - Google Sheets Trigger: integrations/builtin/trigger-nodes/n8n-nodes-base.googlesheetstrigger/index.md