本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連接 Google Drive 資料來源
<a name="kb-managed-ds-googledrive-connect"></a>

設定身分驗證並將登入資料存放在 AWS Secrets Manager 秘密之後，請在知識庫中建立 Google Drive 資料來源。此頁面說明如何使用 AWS 管理主控台 或 API 建立資料來源，後面接著您可以設定的連接器參數參考。

**注意**  
請先完成身分驗證設定。請參閱 [設定 Google Drive 的服務帳戶身分驗證](kb-managed-googledrive-service-account-setup.md)（建議） 或 [設定 Google Drive 的 OAuth 2.0 身分驗證](kb-managed-googledrive-oauth2-setup.md)。您需要秘密 ARN。

## 建立資料來源
<a name="kb-managed-ds-googledrive-create"></a>

------
#### [ Console ]

**將 Google Drive 連線至您的受管知識庫**

1. 在**資料來源**下，提供資料來源的名稱。

1. 從資料來源下拉式清單中選取 **Google Drive**。

1. 在**身分驗證**下，選取 **Google 服務帳戶**或 **OAuth 2.0 身分驗證。**

1. 選取或建立 AWS Secrets Manager 秘密以存放您的登入資料。

1. （選用，僅限服務帳戶） 若要啟用文件層級存取控制，請選取**使用 ACLs 控制文件存取**。此選項無法在建立後變更。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-googledrive-acl.md)。

1. （選用） 展開**同步範圍**以選擇要爬取的磁碟機 （我的磁碟機、與我共用、共用磁碟機）。

1. （選用） 展開**共用磁碟機**以新增要包含或排除IDs。

1. （選用，僅限 OAuth 2.0) 展開**特定資料夾和檔案**以新增要包含的資料夾或檔案 IDs。

1. （選用） 展開 **Mime 類型 regex 模式**，以包含或排除特定 MIME 類型。

1. （選用） 展開**日期型實體同步**以指定日期篩選條件。

------
#### [ API ]

若要建立 Google Drive 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 請求。下列 AWS Command Line Interface 範例會建立使用服務帳戶身分驗證的資料來源。若要使用 OAuth 2.0，請將 `authType`變更為 `OAUTH2`。若要啟用文件層級存取控制，請將 `aclEnabled`設定為 `true`。如需每個欄位的說明，請參閱以下連接器參數參考。

```
aws bedrock-agent create-data-source \
 --name "{{GoogleDrive-connector}}" \
 --knowledge-base-id "{{your-knowledge-base-id}}" \
 --data-source-configuration file://googledrive-managed-connector.json
```

`googledrive-managed-connector.json` 檔案包含下列項目：

```
{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "GOOGLEDRIVE",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-google-drive-sa-creds}}",
                "authType": "SERVICE_ACCOUNT"
            },
            "dataEntityConfiguration": {
                "crawlMyDrive": true,
                "crawlSharedWithMe": true,
                "crawlSharedDrives": false
            },
            "filterConfiguration": {
                "inclusionMimeTypes": ["application/pdf"]
            }
        }
    }
}
```

對於受管知識庫， `CreateDataSource`是非同步的：當操作完成`CREATING``AVAILABLE`時，資料來源狀態會從 轉換為 。

------

## 連接器參數
<a name="kb-managed-config-googledrive"></a>

資料來源組態使用下列連接器參數。若要連線至 Google Drive，請在 中指定 `GOOGLEDRIVE`做為連接器類型`connectorParameters`。如需包裝的欄位 `connectorParameters`（例如 `deletionProtectionConfiguration`和 `mediaExtractionConfiguration`)，請參閱 [連接資料來源](kb-managed-connect-ds.md)。

**`aclEnabled` 明確設定**  
如果您省略 `aclEnabled`，預設值取決於 `authType`：`SERVICE_ACCOUNT`預設值為 `true`，`OAUTH2`預設值為 `false`。由於 ACL 組態在資料來源建立後是永久的，因此`aclEnabled`請明確設定 ，讓資料來源具有您想要的存取控制行為。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-googledrive-acl.md)。


**connectionConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| secretArn | 是 | 包含 Google Drive 登入資料的 AWS Secrets Manager 秘密 ARN。 | 
| authType | 是 | 身分驗證類型： SERVICE\_ACCOUNT（建議） 或 OAUTH2。請參閱 [身分驗證方法](kb-managed-ds-googledrive.md#kb-managed-googledrive-auth-methods)。 | 


**dataEntityConfiguration （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| crawlMyDrive | 否 | 是否編目已驗證使用者的個人磁碟機。 | 
| crawlSharedWithMe | 否 | 是否編目與已驗證使用者共用的檔案。 | 
| crawlSharedDrives | 否 | 是否要爬取共用磁碟機。 | 


**filterConfiguration （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| inclusionSharedDriveIds | 否 | 要包含IDs。 | 
| exclusionSharedDriveIds | 否 | 要排除IDs。 | 
| inclusionMimeTypes | 否 | 要包含的 MIME 類型。 | 
| exclusionMimeTypes | 否 | 要排除的 MIME 類型。 | 
| inclusionFolderIds | 否 | 要包含IDs。僅適用於身分OAUTH2驗證。 | 
| inclusionFileIds | 否 | 要包含的檔案 IDs。僅適用於身分OAUTH2驗證。 | 
| inclusionSharedFolderIds | 否 | 要包含IDs。僅適用於身分OAUTH2驗證。 | 
| inclusionSharedFileIds | 否 | 要包含IDs。僅適用於身分OAUTH2驗證。 | 
| modifiedDateBefore | 否 | 僅包含在此日期之前修改的內容 (ISO 8601)。 | 
| modifiedDateAfter | 否 | 僅包含在此日期之後修改的內容 (ISO 8601)。如果 modifiedDateBefore 早於 modifiedDateAfter，則沒有任何內容符合視窗。 | 
| maxFileSizeInMegaBytes | 否 | 連接器擷取之任何單一檔案的大小上限，以 MB 為單位。提供 做為數值字串 （例如，"500")。預設為 "500"。 | 


**aclEnabled （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| aclEnabled | 否 | 文件層級存取控制是否已啟用。設定為 true 以啟用，或false設定為停用。如果您省略此欄位，預設值取決於 authType：SERVICE\_ACCOUNT預設值為 true；OAUTH2預設值為 false。ACL 需要SERVICE\_ACCOUNT身分驗證。您無法在建立資料來源後變更此設定。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-googledrive-acl.md)。 | 

## 變更身分驗證方法
<a name="kb-managed-ds-googledrive-change-auth"></a>

您可以使用 [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) 操作或 ，將資料來源的身分驗證方法 （例如，從 OAuth 2.0 更新為服務帳戶） 更新為包含相符憑證的新 `authType`和秘密 AWS 管理主控台。文件層級存取控制設定會在您建立資料來源時修正，因此若要新增或移除 ACLs，您必須建立新的資料來源。

## 後續步驟
<a name="kb-managed-ds-googledrive-connect-next"></a>

建立資料來源之後，請同步資料來源，以將內容擷取到您的知識庫。如需詳細資訊，請參閱[同步資料來源](kb-managed-sync.md)。若要依使用者許可篩選查詢結果，請參閱 [文件層級存取控制](kb-managed-ds-googledrive-acl.md)。