安裝及設定 ABAP SDK for Google Cloud 的 SAP BTP 版本

SAP BTP edition v1.1keyboard_arrow_down

• SAP BTP 版本 v1.1
• 地端部署或任何雲端版本 v1.10

本文說明如何在 SAP BTP、ABAP 環境中，安裝及設定 Google Cloud 適用的 SAP BTP 版 ABAP SDK。

本文件適用於 SAP 管理員、 Google Cloud 管理員，以及其他 SAP 和 Google Cloud 安全專家。

總覽

ABAP SDK for Google Cloud 提供 ABAP 類別形式的用戶端程式庫，方便開發人員以程式輔助方式存取 API。 Google Cloud 這些用戶端程式庫會封裝安全性、驗證、資料序列化和反序列化等重要功能，並將錯誤處理作業做為可重複使用的元件，藉此減少開發人員需要編寫的程式碼數量。如需 ABAP SDK for Google Cloud 提供的用戶端程式庫完整清單，請參閱「ABAP SDK for Google Cloud 用戶端程式庫」。

身為 ABAP 開發人員，您可以使用各種 Google Cloud服務建構及部署機器學習和 AI 驅動解決方案，例如 Vertex AI、Document AI Warehouse、BigQuery、Dataproc、Pub/Sub、Google Workspace API 和 Google 地圖平台。

自 1.1 版起，Google Cloud 適用的 SAP BTP 版 ABAP SDK 提供專用工具 Vertex AI SDK for ABAP，可與 Google Cloud的 Vertex AI 平台順暢互動。如要瞭解 ABAP 適用的 Vertex AI SDK，請參閱「ABAP 適用的 Vertex AI SDK 總覽」。

針對 SAP 和 Google Cloud API 之間的通訊，Google Cloud 的 ABAP SDK 會使用 HTTPS 通訊協定搭配 SSL。

事前準備

安裝 Google Cloud 適用的 ABAP SDK SAP BTP 版本前，請先執行下列操作：

1. 訂閱 SAP BTP 環境入口網站。如要瞭解如何訂閱景觀入口網站，請參閱「在 SAP BTP Cockpit 中訂閱景觀入口網站」。

2. 您擁有有效的 S-User ID，且與具備有效 SAP 支援合約的客戶編號相關聯。

3. 如果您是 Google Cloud新手，請前往 https://cloud.google.com 建立帳戶。

4. 如果您還沒有 Google Cloud 專案，請建立專案：

   前往專案選取器

5. 請確認您已啟用專案的計費功能。詳情請參閱「確認專案的帳單狀態」。

6. 啟用您打算使用 SDK 存取的支援的 API。如要瞭解如何啟用Google Cloud API，請參閱「啟用 API」。

上傳 Google 憑證

為確保 SAP BTP、ABAP 環境與 Google 伺服器之間的通訊安全，您必須將必要的 Google 憑證上傳至 SAP BTP、ABAP 環境的 Maintain Certificate Trust List 應用程式。

如要將憑證上傳至 SAP Maintain Certificate Trust List 應用程式，您必須具備 SAP_CORE_BC_SEC 的業務目錄存取權。此商家目錄包含在預先定義的商家角色 SAP_BR_ADMINISTRATOR 中。

如要上傳 Google 憑證，請執行下列步驟：

1. 請從 Google Trust Services 存放區下載下列憑證：

   • GTS Root R1
   • GTS CA 1C3

2. 登入 SAP BTP Cockpit。詳情請參閱 SAP 頁面「存取 Cockpit」。

3. 選取 ABAP 環境的子帳戶。

4. 依序前往「Instances and Subscriptions」>「Instances」，然後按一下 ABAP 執行個體。

5. 在開啟的 ABAP 環境中，依序前往「所有空間」>「管理」>「安全性」。

6. 開啟「Maintain Certificate Trust List」應用程式。

7. 按一下「新增」。

8. 選取從 Google Trust Services 存放區下載的憑證。

9. 按一下 [上傳]。系統會將憑證新增至信任清單。

安裝 Google Cloud 適用的 ABAP SDK 的 SAP BTP 版本

您可以使用 SAP BTP Landscape Portal 安裝 Google Cloud 專用的 ABAP SDK 適用於 SAP BTP 版本。

如要為 Google Cloud 安裝 SAP BTP 版 ABAP SDK，請執行下列步驟：

1. 在 Landscape Portal 中取得 ABAP SDK for Google Cloud 產品。

   1. 在 BC-CP-ABA 元件下，使用下列任一選項向 SAP 開啟中等優先順序案件：

      • 透過 SAP for Me 應用程式建立案件。如需建立案件的指南，請參閱 SAP 頁面「提交案件」。

        

      • 透過 Landscape Portal 開立案件。如需建立案件的相關指南，請參閱 SAP 頁面「Create Support Tickets」。

        

   2. 在案件說明中輸入下列詳細資料：

      We would like the following product registered to our Landscape Portal:
      * Product: /GOOG/ABAP_SDK
      * Publisher: Google
      

   3. 視需要提供其他詳細資料，然後提交案件。

   在 SAP 確認產品已註冊至 Landscape Portal 後，請繼續進行下一個步驟。

   在 Landscape Portal 中註冊 Google Cloud 專用的 ABAP SDK 可能需要 3 個工作天。如果 SDK 在這個時間過後仍未註冊，請與 Cloud Customer Care 團隊聯絡尋求協助。如要瞭解如何與客戶服務團隊聯絡，請參閱「取得 SAP 支援 Google Cloud」一文。

2. 部署 ABAP SDK for Google Cloud 產品：

   1. 在 Landscape Portal 中，開啟「Deploy」應用程式。
   2. 在「Product」(產品) 欄位中，選取 /GOOG/ABAP_SDK。
   3. 在「Target version」欄位中選取 1.1.0。
   4. 在「Available systems」下方，選取需要安裝 SDK 的 ABAP 例項。
   5. 按一下「Deploy」。「產品版本部署狀態」部分會顯示部署完成狀態。

將 Fiori 應用程式新增至啟動工具

自 1.1 版起，Google Cloud 適用的 SAP BTP 版 ABAP SDK 會與 SAP Fiori 應用程式一併封裝，以便進行 SDK 設定和應用程式記錄。管理員或開發人員可使用這些 Fiori 應用程式設定 SDK 和應用程式記錄。SDK 也提供專屬的 Fiori 應用程式，僅供查看驗證設定、記錄設定，以及分析 SDK 記錄。

設定 SDK 和記錄的管理員或開發人員，或是只需要查看 SDK 設定和記錄的使用者，都必須具備相關 Fiori 應用程式的存取權。如要授予 SDK Fiori 應用程式的存取權，您必須將 ABAP SDK for Google Cloud 的業務目錄新增至執行 SDK 設定或需要查看設定和記錄的使用者業務角色。SAP BTP 版的 ABAP SDK for Google Cloud 包含業務角色範本，其中包含存取 Fiori 應用程式所需的業務目錄。

下表列出業務角色範本和相關 Fiori 應用程式，以及這些項目提供的存取權。

業務角色範本	應用程式名稱	說明
/GOOG/BRT_SDK	Google SDK：主要設定	使用這個應用程式設定驗證機制，以便安全地連線至 Google Cloud API。
	Google SDK：應用程式記錄設定	使用這個應用程式設定記錄功能，將錯誤、警告和資訊訊息擷取到 SAP 應用程式記錄中。
	Google SDK：顯示應用程式記錄	使用這個應用程式查看 SDK 應用程式記錄。
	Vertex AI SDK：設定模型生成參數	使用這個應用程式設定模型產生參數。
	Vertex AI SDK：向量搜尋設定	使用這個應用程式設定向量搜尋參數。
/GOOG/BRT_SDK_DISPLAY	Google SDK：顯示主要設定	使用這個應用程式查看 SDK 設定。
	Google SDK：顯示記錄設定	使用這個應用程式查看應用程式記錄設定。
	Google SDK：顯示應用程式記錄	使用這個應用程式查看 SDK 應用程式記錄。
	Vertex AI SDK：顯示模型生成參數	使用這個應用程式查看模型產生參數。
	Vertex AI SDK：顯示向量搜尋設定	使用這個應用程式查看向量搜尋參數設定。

如要使用提供的業務角色範本，將 ABAP SDK for Google Cloud 的業務目錄新增至使用者的業務角色，您必須有權存取業務目錄 SAP_CORE_BC_SEC。這個商家目錄包含預先定義的商家角色 SAP_BR_ADMINISTRATOR。

建立商家角色並指派給使用者

自 1.1 版起，Google Cloud 適用的 SAP BTP 版 ABAP SDK 會隨附預先定義的空間 /GOOG/SDK_CONFIG_SPACE 和預先定義的頁面 /GOOG/SDK_CONFIG_PAGE，讓您更輕鬆地為使用者提供 SAP Fiori 應用程式的存取權。

如要建立商家角色並指派給使用者，請執行下列步驟：

1. 在 ABAP 環境中，依序前往「所有空間」>「管理」>「身分和存取權管理」。
2. 開啟「維護商家角色」應用程式。
3. 按一下「Create from template」。
4. 在隨即顯示的「Create Business Role from Template」對話方塊中，輸入下列欄位的值：
   1. 範本：輸入 /GOOG/BRT_SDK。
   2. 新業務角色 ID：輸入業務角色 ID。
   3. 新商家角色說明：輸入商家角色的說明。
   4. 聊天室選項：確認已選取「使用預先定義的聊天室」。
   5. 按一下 [確定]。
5. 在「存取類別」下方，針對「Read, Write, Value Help」欄位選取「Unrestricted」。
6. 前往「商家使用者」分頁，然後依序點選「編輯」和「新增」。
7. 在隨即顯示的「Add Business Users」對話方塊中，搜尋並選取需要存取 SDK Fiori 應用程式的必要使用者。
8. 按一下 [確定]。使用者可以透過 SDK Fiori 應用程式查看指派的空間和頁面。
9. 按一下 [儲存]。
10. 如果您想讓部分使用者僅能查看 SDK Fiori 應用程式，請使用下列詳細資料重複執行本節中的步驟：
    • 使用 /GOOG/BRT_SDK_DISPLAY 範本建立業務角色。
    • 在「存取類別」下方，針對「Read, Write, Value Help」欄位，選取「No access」。

設定驗證機制

如要使用 Google Cloud API，您必須透過驗證確認身分。如要瞭解Google Cloud 的驗證選項和設定步驟，請參閱「驗證」。

設定記錄功能

Google Cloud 適用的 ABAP SDK 的 SAP BTP 版本會使用 SAP 應用程式記錄，儲存執行用戶端程式庫類別時產生的所有訊息。定義預設記錄設定後，SDK 就會開始記錄訊息。

記錄物件 /GOOG/LOG_OBJECT 和子物件 /GOOG/LOG_SUBOBJECT 會隨 SDK 一併提供，您可以用來建立預設記錄設定。

您可以使用 Google SDK：應用程式記錄設定應用程式建立記錄設定。

您可以使用 Google SDK：應用程式記錄顯示應用程式查看應用程式記錄。詳情請參閱「查看記錄」。

如要建立記錄設定，請執行下列步驟：

1. 前往 SAP Fiori 發射台。
2. 前往含有 Fiori 應用程式的空間，設定 SDK。
3. 開啟「Google SDK：應用程式記錄設定」應用程式。
4. 按一下 [建立]。

5. 在隨即顯示的「Create」對話方塊中，輸入下列欄位的值：

   • 記錄設定類型：選取 OBJ_SUBOBJ。
   • 物件：選取 /GOOG/LOG_OBJECT。
   • 子物件：選取 /GOOG/LOG_SUBOBJECT。

6. 按一下「繼續」。

7. 請提供下列詳細資料：

   • 保留天數：指定記錄檔的保留天數。

   • 記錄層級：指定最低記錄層級。支援的值如下：

     • I：資訊、警告和錯誤
     • W：警告和錯誤
     • E：僅記錄錯誤 建議您將記錄層級設為 I，以便記錄大部分的記錄訊息。

   • End at：指定此記錄設定的結束日期。預設結束日期為 9999/12/31。

   • 是否為預設：如要將此設定設為預設記錄設定，請勾選核取方塊。

8. 按一下 [建立]。

管理記錄設定

如果您不再需要某個記錄設定，可以停用該設定。

如要停用記錄設定，請執行下列步驟：

1. 開啟「Google SDK：應用程式記錄設定」應用程式。
2. 在「編輯狀態」欄位中選取適當的狀態，然後按一下「前往」。
3. 按一下要停用的記錄設定項目。
4. 按一下 [編輯]。
5. 將「End At」設為過去的日期。
6. 按一下 [儲存]。

指定 Google Cloud API 端點

SAP BTP 版的 ABAP SDK for Google Cloud 提供下列選項，可在使用 API 用戶端程式庫類別呼叫 Google Cloud API 時，指定 API 端點：

• 預設端點
• 自訂端點

預設端點

根據預設，每個 API 類別都會將全域端點硬式編碼為常數值。當呼叫方法來執行 API 資源作業時，用戶端程式庫會使用這些端點。如要使用預設端點，您不需要進行額外設定。

自訂端點

如果您需要靈活定義端點，可以建立自訂端點。舉例來說，如果您需要執行下列操作，請建立自訂端點，以便連線至 Google Cloud ：

• 存取 API 的區域專屬端點，以便用於受法規管制或對延遲敏感的應用程式。
• 使用特定 API，例如僅提供區域端點的 Vertex AI。

如要建立自訂端點，請使用 Google Cloud 專用的 ABAP SDK 隨附的通訊情境 /GOOG/COM_SDK_SRV。

以下程序說明如何建立 Pub/Sub API 的區域端點。您可以按照相同的程序，為其他支援的 Google Cloud 服務建立自訂端點。

1. 存取已安裝 ABAP SDK for Google Cloud 的 BTP ABAP 系統 SAP Fiori 發布工具。
2. 依序前往「所有聊天室」>「管理」>「通訊管理」。
3. 建立通訊系統：
   1. 開啟「通訊系統」應用程式。
   2. 按一下 [New]。
   3. 在隨即顯示的「New Communication System」對話方塊中，輸入下列欄位的值：
      • 系統 ID：輸入系統 ID。
      • 系統名稱：輸入系統名稱。
   4. 按一下 [建立]。
   5. 在「主機名稱」欄位中輸入自訂端點，舉例來說，請輸入 Pub/Sub 服務的區域端點：https://asia-east1-pubsub.googleapis.com。
   6. 在「Port」欄位中輸入 443。
   7. 在「可外撥電話的使用者」分頁中，按一下「新增」。
   8. 在「Authentication method」欄位中，選取「None」。
   9. 按一下 [建立]。
   10. 如要儲存通訊系統，請按一下「儲存」。

4. 建立溝通安排：

   1. 開啟「通訊安排」應用程式。
   2. 按一下 [New]。

   3. 在隨即顯示的「New Communication Arrangement」對話方塊中，輸入下列詳細資料：

      • 情境：選取「任何 API 的傳出通訊」 (/GOOG/COM_SDK_SRV)。
      • 安排名稱：輸入通訊安排的名稱。

   4. 按一下 [建立]。

   5. 針對顯示的通訊安排，在「通訊系統」欄位中，選取您在上一個步驟中建立的通訊系統。

   6. 在「Outbound communication」(傳出通訊) 下方的「User name」(使用者名稱) 欄位中，選取「None」(無)。

   7. 按一下 [儲存]。

5. 為 API 服務建立通訊對應：

   1. 前往含有 Fiori 應用程式的空間，進行 SDK 設定。
   2. 開啟「Google SDK：主要設定」應用程式。
   3. 選取要為其建立自訂端點的用戶端金鑰。本文假設您已建立用於驗證的用戶端金鑰和通訊對應項目。如果沒有，請建立用於驗證的用戶端金鑰和通訊對應圖。詳情請參閱「驗證」。
   4. 按一下 [建立]。
   5. 在隨即顯示的「Create」對話方塊中，選取服務名稱。例如選取 pubsub:v1。
   6. 按一下「繼續」。
   7. 針對顯示的通訊圖表，在「通訊安排」欄位中，選取您在先前步驟中建立的通訊安排。系統會自動填入其他通訊構件。
   8. 按一下 [套用]。
   9. 按一下 [儲存]。
   10. 如要驗證自訂端點設定，請按一下「檢查連線」。如果項目顯示綠色勾號，即表示設定成功。如果發生任何錯誤，請參閱疑難排解頁面，瞭解如何解決常見錯誤。

用量指標

根據《Google Cloud 隱私權聲明 (我們收集的服務資料)》規定，Google Cloud 適用的 ABAP SDK 適用於 SAP BTP 版本，可收集使用率指標並傳送給 Google 以提供支援。每次從 ABAP SDK for Google Cloud 呼叫 API 時，系統就會收集這些使用量指標。 Google Cloud

SDK 會收集下列用量指標：

• 驗證方法：用於呼叫 Google Cloud 服務的驗證方法相關資訊。
• ABAP SDK 版本：Google Cloud 適用的 ABAP SDK SAP BTP 版本。
• SAP_ABA 版本：SAP_ABA 軟體元件的版本。

授權

在您使用 Google Cloud Platform 時，SAP BTP 版的 ABAP SDK for Google Cloud 會以「軟體」形式提供，並遵循相關協議，包括可在 https://cloud.google.com/terms/service-terms 查看的《服務專屬條款》。在不影響前述條款一般性原則的情況下，您必須取得 Google 明確的書面許可，才能修改或發布 Google Cloud 專用的 ABAP SDK。

我們提供免費的 ABAP SDK for Google Cloud 軟體。為清楚說明，您在使用 Google Cloud Platform 時，根據相關協議使用其他「軟體」和「服務」(例如 Cloud Translation API 和 Pub/Sub API) 可能會產生費用。

Google Cloud 適用的 ABAP SDK 不含任何 SAP 軟體授權，您必須另外購買適當的 SAP 軟體授權。

支援生命週期

Google Cloud 在 SAP 在 Google Cloud 上的發布版本說明頁面發布舊版主要版本的停用通知後，至少 12 個月內，Google Cloud 會支援並維護 Google Cloud 適用的 SAP BTP 版 ABAP SDK 的目前主要版本。 Google Cloud

取得支援

如需協助解決 ABAP SDK for Google Cloud 的問題，請按照下列步驟操作：

• 請參閱 ABAP SDK for Google Cloud 疑難排解指南。

• 在 Cloud 論壇上向社群提問，並討論 ABAP 適用的 Google Cloud SDK。

• 收集所有可用的診斷資訊，並與 Cloud Customer Care 團隊聯絡。如要瞭解如何與 Customer Care 聯絡，請參閱「取得 SAP 支援 Google Cloud」一文。