[Hold][WIP] Google Drive source connector: service account key string format update

ingestion/source-connectors/google-drive.mdx

@@ -24,8 +24,4 @@ import GoogleDrivePyV2 from '/snippets/source_connectors/google_drive.v2.py.mdx'
 
 import SharedPartitionByAPIOSS from '/snippets/ingest-configuration-shared/partition-by-api-oss.mdx';
 
-<SharedPartitionByAPIOSS/>
-
-import GoogleCredentialsFileAsString from '/snippets/general-shared-text/google-credentials-file-as-string.mdx';
-
-<GoogleCredentialsFileAsString />
+<SharedPartitionByAPIOSS/>

snippets/general-shared-text/google-drive-api-placeholders.mdx

@@ -1,6 +1,6 @@
 - `<name>` (_required_) - A unique name for this connector.
 - `<drive-id>` - The ID for the target Google Drive folder or drive.
-- `<service-account-key>` - The contents of the `credentials.json` key file as a single-line string.
+- `<service-account-key>` - The contents of the `credentials.json` key file.
 - For `extensions`, set one or more `<extension>` values (such as `pdf` or `docx`) to process files with only those extensions. The default is to include all extensions.
 
   <Note>

snippets/general-shared-text/google-drive-cli-api.mdx

@@ -14,7 +14,7 @@ The following environment variables:
 - One of the following:
 
   - `GCP_SERVICE_ACCOUNT_KEY_FILEPATH` - The path to the `credentials.json` key file, represented by `--service-account-key-path` (CLI) or `service_account_key_path` (Python).
-  - `GCP_SERVICE_ACCOUNT_KEY_STRING` - The contents of the `credentials.json` key file as a string, represented by `--service-account-key` (CLI) or `service_account_key` (Python).
+  - `GCP_SERVICE_ACCOUNT_KEY_STRING` - The contents of the `credentials.json` key file, represented by `--service-account-key` (CLI) or `service_account_key` (Python).
 
 <Note>
     To use `--extensions` with a comma-separated list (CLI) or `extensions` with an array of strings (Python) to process files with only those extensions, 

snippets/general-shared-text/google-drive.mdx

@@ -15,23 +15,52 @@ allowfullscreen
   [Create a service account](https://developers.google.com/workspace/guides/create-credentials#create_a_service_account). 
   [Create credentials for a service account](https://developers.google.com/workspace/guides/create-credentials#create_credentials_for_a_service_account).
 
-  To ensure maximum compatibility across Unstructured service offerings, you should give the service account key information to Unstructured as 
-  a single-line string that contains the contents of the downloaded service account key file (and not the service account key file itself). 
-  To print this single-line string without line breaks, suitable for copying, you can run one of the following commands from your Terminal or Command Prompt. 
-  In this command, replace `<path-to-downloaded-key-file>` with the path to the `credentials.json` key file that you downloaded by following the preceding instructions.
+  To ensure maximum compatibility across Unstructured service offerings, you should give Unstructured 
+  the contents of the downloaded service account key file (and not the service account key file itself). The approach you use 
+  to give Unstructured this information depends on how you intend to call Unstructured, as well as the operating system you're using, as follows.
 
-  - For macOS or Linux: 
+  - For the [Unstructured user interface (UI)](/ui/overview):
 
-    ```text
+    Print the contents of the downloaded service account key file as a single-line string without line breaks, suitable for copying, by running one of the following commands from your Terminal or Command Prompt. 
+    In this command, replace `<path-to-downloaded-key-file>` with the path to the `credentials.json` key file that you downloaded by following the preceding instructions.
+
+    For macOS or Linux: 
+
+    ```bash Bash
     tr -d '\n' < <path-to-downloaded-key-file>
     ```
 
-  - For Windows:
+    For Windows:
 
-    ```text
+    ```powershell PowerShell
     (Get-Content -Path "<path-to-downloaded-key-file>" -Raw).Replace("`r`n", "").Replace("`n", "")
     ```
 
+    Copy the output of this command into the **Account Key** field in the Unstructured UI.
+
+  - For the [Unstructured API](/api-reference/overview) and [Unstructured Ingest](/ingestion/overview):
+
+    Save the contents of the downloaded service account key file as a Base64-encoded string, by running one of the following commands from your Terminal or Command Prompt. 
+    In this command, replace `<path-to-downloaded-key-file>` with the path to the `credentials.json` key file that you downloaded by following the preceding instructions.
+
+    For macOS or Linux:
+
+    ```bash Bash
+    base64 -i < <path-to-downloaded-key-file>
+    ```
+
+    For Windows:
+
+    ```powershell PowerShell
+    [Convert]::ToBase64String([IO.File]::ReadAllBytes("<path-to-downloaded-key-file>"))
+    ```
+
+    Set the value of the `GCP_SERVICE_ACCOUNT_KEY_STRING` environment variable to the output of this command. 
+
+    Then, in your code or script, before making your Unstructured API or Unstructured Ingest request, 
+    decode the value of this environment variable and add it to the request. In some cases, 
+    you must also escape all double quotes in the decoded string. For more information, see the following code examples.
+
 - A Google Drive [shared folder](https://support.google.com/drive/answer/2375091) or [shared drive](https://support.google.com/a/users/answer/7212025).
 - Give the service account access to the shared folder or shared drive. To do this, share the folder or drive with the service account's email address. 
   [Learn how](https://support.google.com/drive/answer/7166529). 

snippets/source_connectors/google_drive.sh.mdx

@@ -3,19 +3,24 @@
 
 # Chunking and embedding are optional.
 
+service_account_key=$(python3 -c "import base64, json, os; \
+decoded = base64.b64decode(os.environ['GCP_SERVICE_ACCOUNT_KEY_STRING']).decode('utf-8'); \
+parsed = json.loads(decoded); \
+print(parsed)" | sed "s/'/\"/g")
+
 unstructured-ingest \
   google-drive \
-    --download-dir $LOCAL_FILE_DOWNLOAD_DIR \
-    --drive-id $GOOGLE_DRIVE_FOLDER_ID \
+    --download-dir "$LOCAL_FILE_DOWNLOAD_DIR" \
     --service-account-key-path $GCP_SERVICE_ACCOUNT_KEY_FILEPATH \ # Or
-    --service-account-key $GCP_SERVICE_ACCOUNT_KEY_STRING \
+    --service-account-key "$service_account_key" \
+    --drive-id "$GOOGLE_DRIVE_FOLDER_ID" \
     --partition-by-api \
-    --api-key $UNSTRUCTURED_API_KEY \
-    --partition-endpoint $UNSTRUCTURED_API_URL \
+    --api-key "$UNSTRUCTURED_API_KEY" \
+    --partition-endpoint "$UNSTRUCTURED_API_URL" \
     --strategy hi_res \
     --chunking-strategy by_title \
     --embedding-provider huggingface \
     --additional-partition-args="{\"split_pdf_page\":\"true\", \"split_pdf_allow_failed\":\"true\", \"split_pdf_concurrency_level\": 15}" \
   local \
-    --output-dir $LOCAL_FILE_OUTPUT_DIR
+    --output-dir "$LOCAL_FILE_OUTPUT_DIR"
 ```

snippets/source_connectors/google_drive.v2.py.mdx

@@ -14,6 +14,8 @@ from unstructured_ingest.processes.chunker import ChunkerConfig
 from unstructured_ingest.processes.embedder import EmbedderConfig
 from unstructured_ingest.processes.connectors.local import LocalUploaderConfig
 
+import base64
+
 # Chunking and embedding are optional.
 
 if __name__ == "__main__":
@@ -24,7 +26,7 @@ if __name__ == "__main__":
         source_connection_config=GoogleDriveConnectionConfig(
             access_config=GoogleDriveAccessConfig(
                 service_account_key_path=os.getenv("GCP_SERVICE_ACCOUNT_KEY_FILEPATH"), # Or
-                service_account_key=os.getenv("GCP_SERVICE_ACCOUNT_KEY_STRING")
+                service_account_key=base64.b64decode(s=os.getenv("GCP_SERVICE_ACCOUNT_KEY_STRING")).decode(encoding="utf-8")
             ),
             drive_id=os.getenv("GOOGLE_DRIVE_FOLDER_ID"),
         ),

snippets/source_connectors/google_drive_sdk.mdx

@@ -9,6 +9,8 @@ from unstructured_client.models.shared import (
     GoogleDriveSourceConnectorConfigInput
 )
 
+import base64
+
 with UnstructuredClient(api_key_auth=os.getenv("UNSTRUCTURED_API_KEY")) as client:
     response = client.sources.create_source(
         request=CreateSourceRequest(
@@ -17,7 +19,7 @@ with UnstructuredClient(api_key_auth=os.getenv("UNSTRUCTURED_API_KEY")) as clien
                 type=SourceConnectorType.GOOGLE_DRIVE,
                 config=GoogleDriveSourceConnectorConfigInput(
                     drive_id="<drive-id>",
-                    service_account_key="<service-account-key>",
+                    service_account_key=base64.b64decode(s=os.getenv("GCP_SERVICE_ACCOUNT_KEY_STRING")).decode(encoding="utf-8").replace('"', '\\"'),
                     extensions=[
                         "<extension>",
                         "<extension>"