Skip to content

Commit 710e549

Browse files
authored
First issue troubleshooter (#775)
1 parent 9ae9007 commit 710e549

File tree

4 files changed

+66
-1
lines changed

4 files changed

+66
-1
lines changed

docs.json

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -520,7 +520,14 @@
520520
"group": "Support",
521521
"pages": [
522522
"support/request",
523-
"support/shared-responsibility"
523+
"support/shared-responsibility",
524+
{
525+
"group": "Issues",
526+
"pages": [
527+
"support/issues/overview",
528+
"support/issues/api-connector-secrets"
529+
]
530+
}
524531
]
525532
}
526533
]
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Google Drive source connectors cannot be created by using the API
3+
---
4+
5+
## Issue
6+
7+
When you try to use the [Unstructured Workflow Endpoint](/api-reference/workflow/overview) to
8+
[create a source connector](/api-reference/workflow/overview#create-a-source-connector)
9+
that connects [Google Drive](/api-reference/workflow/sources/google-drive) to Unstructured,
10+
an error similar to the following occurs, and the source connector is not created:
11+
12+
```text
13+
API error occurred: Status 412. Body: {
14+
"errors": [
15+
{
16+
"field": "access_config.service_account_key",
17+
"message": "Field is sensitive and must be wrapped in as a secret reference or new secret value"
18+
}
19+
]
20+
}
21+
```
22+
23+
## Cause
24+
25+
This error occurs because the contents of the caller's Google Drive service account's `credentials.json` file (or its
26+
equivalent JSON string representation) must be specially encrypted and formatted before these contents are sent to Unstructured, due to the contents' size.
27+
However, the Unstructured Workflow Endpoint does not support this special encryption and formatting process.
28+
29+
## Solution
30+
31+
Use the [Unstructured user interface (UI)](/ui/overview) to [create a Google Drive source connector](/ui/sources/google-drive) instead, as
32+
the Unstructured UI does support this special encryption and formatting process.
33+
34+
## Additional resources
35+
36+
To ask questions or get additional help with this issue, see [requesting support](/support/request).

support/issues/overview.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: Overview
3+
---
4+
5+
This section contains solutions to common issues that you might encounter as you use Unstructured.
6+
7+
Each issue contains the following sections:
8+
9+
- **Issue**: A description of the issue. Use this section to confirm that you are experiencing the same issue that is being described.
10+
- **Cause**: The cause of the issue. Use this section to help you understand why the issue is (or might be) occurring. In some cases,
11+
there might be multiple causes, or the causes might be indirect or dependent on other factors. In these cases, the title will be
12+
labeled as **Possible causes** instead.
13+
- **Solution**: A solution to the issue. In some cases, there might be solutions that are dependent on other factors. In these cases,
14+
the title will be labelled as **Possible solutions** instead.
15+
- **Additional resources**: Any usage notes, links, or other secondary information that might also help you to resolve the issue.
16+
17+
To ask questions or get additional help with these issues, see [requesting support](/support/request).

support/request.mdx

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22
title: Requesting support
33
---
44

5+
<Tip>
6+
If you are having an issue with Unstructured, try checking the [Issues](/support/issues/overview) section first
7+
to see if your issue has already been addressed.
8+
</Tip>
9+
510
To request support, do the following:
611

712
- If you are using the [Unstructured open source library](/open-source/introduction/overview),

0 commit comments

Comments
 (0)