Install and configure the on-premises or any cloud edition of ABAP SDK for Google Cloud

This document shows how to install and configure the on-premises or any cloud edition of ABAP SDK for Google Cloud on your SAP host system on Compute Engine VM instances, on-premises, on another cloud provider, or in another environment outside of Google Cloud.

This document is intended for SAP administrators, Google Cloud administrators, and other SAP and Google Cloud security professionals.

Overview

ABAP SDK for Google Cloud provides client libraries for developers to use ABAP to programmatically access Google Cloud APIs. By encapsulating essential functions as reusable components, these client libraries reduce the amount of code that developers need to write. For a complete list of client libraries that the ABAP SDK for Google Cloud provides, see ABAP SDK for Google Cloud client libraries.

As an ABAP developer, you can build and deploy ML and AI-driven solutions using a wide range of Google Cloud services such as Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, Google Workspace APIs, and Google Maps Platform.

From version 1.8, the on-premises or any cloud edition of ABAP SDK for Google Cloud offers a dedicated tool, Vertex AI SDK for ABAP, for seamless interaction with Google Cloud's Vertex AI platform. For information about Vertex AI SDK for ABAP, see Overview of the Vertex AI SDK for ABAP.

For communication between SAP and Google Cloud APIs, the ABAP SDK for Google Cloud uses HTTPS protocol with SSL.

Before you begin

Before you install ABAP SDK for Google Cloud, do the following:

  1. If you're new to Google Cloud, then create an account on https://cloud.google.com.

  2. If you don't have a Google Cloud project already, then create a project:

    Go to project selector

  3. Make sure billing is enabled for your project. For more information, see Verify the billing status of your project.

  4. Make sure the SAP software versions you are using are supported by the ABAP SDK for Google Cloud. For more information, see SAP software version requirements.

SAP software version requirements

The ABAP SDK for Google Cloud uses the SAP User Interface (UI) Add-On for serializing ABAP data into JSON format. Make sure that the latest corrections are implemented for /UI2/CL_JSON class.

The following table explains the minimum version of components required for installing the SDK:

SAP SAP NetWeaver SAP UI Add-On
SAP ERP 6.0 (ECC) SAP_BASIS 702 or later

/UI2/CL_JSON: PL12 or later.

For more information, see the SAP Note 22798102 - /UI2/CL_JSON corrections - PL12

The SAP UI Add-On must be compatible with your SAP Netweaver version. For information about SAP UI Add-On compatibility, see:
S/4HANA 1909 or later SAP_BASIS 752 or later

Establish a network connection to Google Cloud

If your SAP workload is not running on Google Cloud, then you or a network administrator needs to establish a secure, high-bandwidth, low-latency connection to Google Cloud.

You can access Google Cloud APIs over public internet. For more information, see About Cloud APIs. If your SAP servers don't have public internet access, then connect them to Google Cloud by using one of the following methods:

To configure a connection, follow the instructions provided by the appropriate Google Cloud network connectivity product. Each product has different set of instructions for different scenarios, so review the documentation and follow the instructions for your scenario.

If your SAP workload is running on Google Cloud, then the ABAP SDK for Google Cloud uses the underlying VPC network.

Install the ABAP SDK for Google Cloud

ABAP SDK for Google Cloud is provided in the form of transport files that you install into SAP NetWeaver.

If you encounter challenges while importing the transport files of the ABAP SDK for Google Cloud into your SAP environment, such as issues with transport review by SAP or import queue management, then contact Cloud Customer Care for assistance. For information about contacting Customer Care, see Getting support for SAP on Google Cloud.

If you already have the ABAP SDK for Google Cloud installed and you need to update to latest version of the SDK, then see Update the ABAP SDK for Google Cloud.

  1. Download the installation package that contains the transport files from the download portal.

  2. Copy the ABAP SDK for Google Cloud transport files into the SAP Server transport import directories.

    The ABAP SDK for Google Cloud provides two sets of transport files:

    • For establishing connection with the supported Google Cloud APIs and authenticating with tokens or API keys, copy the following transport files into the SAP Server transport import directories:

      • /usr/sap/trans/cofiles/K900319.GM1
      • /usr/sap/trans/data/R900319.GM1

    • For authenticating with OAuth 2.0 client credentials, copy the following transport files into the SAP Server transport import directories:

      • /usr/sap/trans/cofiles/K900321.GM1

      • /usr/sap/trans/data/R900321.GM1

        These transport files do not provide additional functionality, other than the OAuth 2.0 client credentials based authentication. For OAuth 2.0 client credentials based authentication, first import the transport files for the supported Google Cloud APIs, and then import the transport files for OAuth 2.0 client credentials.

        To use OAuth 2.0 client credentials, your SAP system must support OAuth 2.0. For information about the SAP systems that support OAuth 2.0, see SAP Note 3041322 - OAuth 2.0 Client: Downport of grant type Client Credentials.

  3. In the SAP GUI, use transaction code STMS_IMPORT or STMS to import the files into the SAP system.

  4. Make sure all objects in the /GOOG/ABAP_SDK package are active and consistent:

    1. In the SAP GUI, enter transaction code SE80.
    2. In the package selector, select /GOOG/ABAP_SDK.
    3. In the Object Name field, right-click on the package /GOOG/ABAP_SDK, and then choose Check > Package Check > Package Objects (Including Subpackages).

    4. Click the Switch to List View icon.

      List view

      A green check in the Result of Package Check column indicates that all objects passed the package check.

Configure SAP security settings

Follow these steps to securely connect the ABAP SDK for Google Cloud to Google Cloud APIs.

Set up SSL certificates

Download and import the required Google certificates into STRUST.

  1. Download the following certificates from the Google Trust Services repository:

    • GTS Root R1
    • GTS CA 1C3

    PEM and DER are commonly used certificate formats. You can download the certificates in a format that is compatible with your SAP system. If the required format is not available, then refer to the SAP Note 2755238 - How to convert a certificate into the appropriate format with OpenSSL for converting the certificates to the required format.

  2. In the SAP GUI, enter transaction code STRUST.

  3. Switch to change mode.

  4. Double-click SSL client SSL Client (Standard).

  5. Click Certificate  > Import and then import the certificates that you downloaded from the Google Trust Services repository.

  6. Click the button with the green check.

  7. Click Edit  > Add to certificate list. Make sure that the certificate information is visible in the Certificate area in the lower right panel.

  8. Save the entry.

For more information from SAP about importing certificates into STRUST, see SAP Note 3238733 - How to Import a Certificate Into a STRUST PSE's Certificate List In a NetWeaver AS ABAP.

Validate HTTP and HTTPS ports in Internet Communication Manager (ICM)

For SAP systems hosted on Google Cloud, the VM metadata is stored on a metadata server, which is only accessible through an HTTP port. HTTP port activation is required for authentication. Therefore, when your SAP system is hosted on a Compute Engine VM instance, you must ensure that an HTTP port is active to access VM metadata and enable authentication. You must also ensure that an HTTPS port is active for subsequent API calls.

If your SAP system is hosted outside Google Cloud, then activation of the HTTP port is not required.

To validate the HTTP and HTTPS ports, perform the following steps:

  1. In the SAP GUI, enter transaction code SMICM.
  2. On the menu bar, click Goto > Services. A green check in the Actv column indicates that the HTTP and HTTPS ports are active.

For information about configuring the HTTP and HTTPS ports, see HTTP(S) Settings in ICM.

Ensure outbound network egress

The SAP application server must connect to Google Cloud APIs through HTTPS.

  • For your SAP host system, confirm that the firewall rules and proxies allow HTTPS connection from servers outside the Compute Engine VM instances. For more information, see Create and start a VM instance.
  • Make sure that the access to reach the Google Cloud APIs is not restricted from a networking perspective.

  • If you use a proxy server for accessing Google Cloud APIs, then add the following to your proxy's allowlist:

    • *.googleapis.com
    • *.gserviceaccount.com

Manage authorizations

To access the ABAP SDK for Google Cloud specific transactions, you need to grant users access to the SDK authorization object. The SDK transport files include the SDK authorization object ZGOOG_SDK and authorization group ZSGC.

To grant access to the SDK transactions, perform the following steps:

  1. In the SAP GUI, enter transaction code PFCG.
  2. Define a role for the SDK.
  3. For the authorization object ZGOOG_SDK, grant the role access to the authorization Activity 16.

To limit access to the SDK configuration tables, perform the following steps:

  1. In the SAP GUI, enter transaction code PFCG.
  2. Define a role for restricting access to the SDK configuration tables.
  3. To restrict the access to authorization object S_TABU_DIS, exclude the authorization group ZSGC.

Set up Google Cloud security

If your SAP system is hosted on Google Cloud, then configure the following on the host Compute Engine VM instance:

Set up authentication

To use the Google Cloud APIs, you must confirm your identity by authentication. For information about authentication options to Google Cloud and setup steps, see Authentication.

After you complete the authentication setup, you can start using the Quickstarts to create sample programs.

Configure the ABAP SDK for Google Cloud

This section explains the configurations for the ABAP SDK for Google Cloud.

Specify Google Cloud endpoint

The ABAP SDK for Google Cloud provides the following options for specifying the API endpoint when calling a Google Cloud API using the API client library class:

Default endpoints

By default, the constructor method of the API client library class contains HTTP endpoints for the supported Google Cloud APIs. The client library uses these endpoints when a method is called to perform an operation on API resources.

Use RFC destinations for endpoints

If you need to utilize any of the following features, then use RFC destinations to establish connection to Google Cloud:

  • If you use a proxy server in your SAP landscape and want to use the same to send the HTTP requests to Google Cloud.
  • If you want the SDK to access Google Cloud APIs through Private Service Connect endpoints in your VPC network.
  • If you want to use HTTP compression.
  • If you want to access region specific endpoint of an API.

The transport files of the ABAP SDK for Google Cloud contain the following sample RFC destinations for the Google Cloud API endpoints:

Sample RFC destination name Notes
GOOG_IAMCREDENTIALS This RFC destination targets the IAM API.
GOOG_OAUTH2_TOKEN This RFC destination targets Google Cloud endpoint for token based authentication.
GOOG_PUBSUB_V1 This RFC destination targets the Pub/Sub API.
GOOG_TRANSLATION_EU_V3 This RFC destination targets the Cloud Translation v3 API.

To create an RFC destination, perform the following steps:

  1. In the SAP GUI, enter transaction code SM59.

  2. Create new RFC destinations by copying the sample RFC destinations.

  3. For the RFC destinations that you created, make sure the Connection Type is set as follows: G - HTTP connection to external server.

  4. Go to the Technical Settings tab and enter the following details:

    • Target Host: enter the Google Cloud API hostname. For example, you can use translation.googleapis.com.
    • Path Prefix: enter the resource path. For example, you can use /language/translate/.

    • Service No.: enter 443. This port number used for secure communication.

      To gather the Google Cloud API specific details that you need for creating an RFC destination, see Gather details for creating an RFC destination.

  5. Go to the Logon & Security tab and make sure that the SSL Certificate field is set with the option DFAULT SSL Client (Standard).

  6. Optional: You can configure proxy settings, enable HTTP compression, and specify Private Service Connect endpoints.

  7. Save your changes.

To use RFC destinations to connect to Google Cloud APIs, you need to configure RFC destinations in the service mapping table that map RFC destinations to a client key. For more information about the service mapping table, see Table /GOOG/SERVIC_MAP.

Gather details to create an RFC destination

To get the details that you need to create an RFC destination, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Utilities > Get RFC Settings for Google Cloud Services.
  3. Specify the Google Cloud service name.
  4. Click Execute to view the details.
Configure proxy settings

When you use RFC destinations to connect to Google Cloud, you can route communication from the SDK through the proxy server that you're using in your SAP landscape.

If you do not want to use a proxy server or don't have one in your SAP landscape, then you can skip this step.

To configure proxy server settings, perform the following steps:

  1. In the SAP GUI, enter transaction code SM59.

  2. Select your RFC destination that targets the required API.

  3. Go to the Technical Settings tab, and then enter values for the fields in the HTTP Proxy Options section.

You need to configure proxy server settings for each API that you plan to access using the SDK.

Enable HTTP compression

When you use RFC destinations to connect to Google Cloud, you can enable HTTP compression.

We recommend enabling HTTP compression if your SAP system is not running on Google Cloud. Before you enable HTTP compression in your production environment, test and compare the benefits based on your landscape setup, as HTTP compression might involve compression and decompression overhead. For more information from SAP, see SAP Note 1037677 - HTTP compression compresses certain documents only.

If you do not want to enable this feature, then you can skip this step.

To enable HTTP compression, perform the following steps:

  1. In the SAP GUI, enter transaction code SM59.

  2. Select your RFC destination that targets the required API.

  3. Go to the Special Options tab.

  4. For the HTTP Version field, select HTTP 1.1.

  5. For the Compression field, select an appropriate value.

Specify Private Service Connect endpoints

If you want the ABAP SDK for Google Cloud to use Private Service Connect endpoints to allow private consumption of Google Cloud APIs and IAM, then you need to create those endpoints in your Google Cloud project and specify them in the respective RFC destinations.

If you want the SDK to continue using the default, public API endpoints to connect to Google Cloud APIs and IAM, then skip this step.

To configure the SDK to use your Private Service Connect endpoints, perform the following steps:

  1. In the SAP GUI, enter transaction code SM59.

  2. Validate that you have created new RFC destinations for required Google Cloud APIs and IAM. For instructions to create these RFC destinations, see Create RFC destinations.

  3. Select the RFC destination that targets specific Google Cloud API and then complete the following steps:

    1. Go to the Technical Settings tab.

    2. For the Target Host field, enter the name of the Private Service Connect endpoint that you created to access the API.

    3. For the Service No. field, make sure that value 443 is specified.

    4. Go to the Logon and Security tab.

    5. For the SSL Certificate field, make sure that the option DFAULT SSL Client (Standard) is selected.

  4. Select the RFC destination that targets IAM and then complete the following steps:

    1. Go to the Technical Settings tab.

    2. For the Target Host field, enter the name of the Private Service Connect endpoint that you created to access IAM.

    3. For the Service No. field, make sure that value 443 is specified.

    4. Go to the Logon and Security tab.

    5. For the SSL Certificate field, make sure that the option DFAULT SSL Client (Standard) is selected.

  5. Configure the service mapping table for IAM API, and other APIs that you plan to consume using the ABAP SDK for Google Cloud.

    1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

      Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

    2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Service Map.

    3. Click New Entries.

    4. Specify RFC destinations for IAM API and other APIs, for example, Cloud Pub/Sub API v1.

Field Description
Google Cloud Key Name Specify the name of the client key configuration.
Google Service Name Specify the Google Cloud service for which you're mapping a RFC destination.
RFC Destination Specify the name of the RFC destination.

The RFC destination specified in the service mapping table is used by the SDK when a client library class is instantiated and used by ABAP source code to call a Google Cloud API.

Application logging

To write application logs, the ABAP SDK for Google Cloud comes with an embedded logging framework. The log object ZGOOG and subobject ZABAP_SDK are shipped with the SDK transport files that you can use as default objects for log configurations. You can also add your own custom log objects and subobjects to the SDK logging framework.

You can view standard SAP application logs using transaction SLG1. For more information, see Logging.

Configure logging using the log object and subobject shipped with the SDK

You can use the log object ZGOOG and subobject ZABAP_SDK that are shipped with the SDK as default objects for log configurations.

To configure logging, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

  3. Click New Entries.

  4. Enter values for the following fields:

    Field Description
    Object Enter ZGOOG.
    Subobject Enter ZABAP_SDK.
    Log Level

    Specify the minimum log level. The supported values are:

    • I: Information, Warnings, and Errors
    • W: Warnings and Errors
    • E: Errors Only

    We recommend that you set the log level to I, so that most of the log messages are logged.
    Retention Specify the number of days logs are going to be retained.
    End At Specify the end date till which this log configuration is going to be active. The default end date is 9999/12/31.
    Is Default To set this log configuration as the default, select the checkbox.

Add custom log objects

You can also add your own custom log objects and subobjects to the SDK logging framework.

To add a custom log object and subobject, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

  3. Click New Entries.

  4. Enter values for the following fields:

    Field Description
    Object Enter a name of the log object.
    Subobject Enter a name of the log subobject.
    Log Level

    Specify the minimum log level. The possible values are:

    • I: Information, Warnings, and Errors
    • W: Warnings and Errors
    • E: Errors Only

    We recommend that you set the log level to I, so that most of the log messages are logged.
    Retention Specify the number of days logs are going to be retained.
    End At End date till which this log configuration is going to be active. The default end date is 9999/12/31.
    Is Default Specify if this is your default log configuration.

If you need to set any custom log object and subobject as default logging configuration, then clear the Is Default field for the current default entry, and then select the Is Default field for the new entry that you need to make as default.

You can keep only one log configuration as a default entry at any given time.

You can also use your custom log objects and subobjects even without making them default. To do so, once you create your custom log objects and subobjects in the logging framework, you need to pass the log objects and subobjects when instantiating the API client stubs. For more information, see Logging.

If a log configuration is no longer required, then you can disable it.

To disable a log configuration, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

  3. Set the End At field to a past date.

Key configuration tables in ABAP SDK for Google Cloud

Table /GOOG/CLIENT_KEY

For authentication and connectivity related configuration, the ABAP SDK for Google Cloud uses the table /GOOG/CLIENT_KEY. In table /GOOG/CLIENT_KEY, you configure client keys using the details specific to your authentication method. For more information about authentication methods and related client key configuration, see Authentication.

To view the table /GOOG/CLIENT_KEY table, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Client Key.

The following table explains the client key table fields:

Field Data type Description
Google Cloud Key Name String The name of the client key configuration. For example, CLIENT_KEY_API_KEY
Google Cloud Service Account Name String The name of the service account, in email address format.
Google Cloud Scope String The API access scope, https://www.googleapis.com/auth/cloud-platform. This access scope corresponds to the setting Allow full access to all Cloud APIs on the host VM.
Project ID String The ID of the Google Cloud project that contains your target APIs.
Command Name String OS command name. In general, you leave this field blank.
Authorization Class String The authorization class to use for communication with Google Cloud.
Token Caching Boolean The flag that determines whether or not the access tokens retrieved from Google Cloud are cached. We recommend that you enable token caching after you are done configuring and testing your connection to Google Cloud. For more information about token caching, see Enable token caching.
Token Refresh Seconds String The amount of time, in seconds, before an access token expires and must be refreshed. Specifying a value from 1 to 3599 overrides the default expiration time of 3500 seconds. If you specify 0, then the SDK uses the default value. The default value is 3500.
Authorization Parameter 1 String This is an additional authorization parameters that requires configuration in specific situations. In general, you leave this field blank.
Authorization Parameter 2 String This is an additional authorization parameters that requires configuration in specific situations. In general, you leave this field blank.

Table /GOOG/SERVIC_MAP

For mapping the service configuration to the RFC destinations, the ABAP SDK for Google Cloud uses the table /GOOG/SERVIC_MAP.

Depending on the authentication methods, this table contains some mandatory and recommended entries.

To view the table /GOOG/SERVIC_MAP table, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Service Mapping.

The following table explains the service mapping table fields:

Field Data type Description
Name String The name of the client key configuration.
Google Service Name String The name of the Google Cloud service. To find a service, use the search help.
RFC Destination String The name of the RFC destination. To find a relevant RFC destination, use the search help.

Search help

To find the available values for a field, click the icon as shown in the following screenshot:

Search help

Table /GOOG/LOG_CONFIG

For writing application logs, the ABAP SDK for Google Cloud uses the table /GOOG/LOG_CONFIG.

To view the table /GOOG/LOG_CONFIG, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

The following table explains the logging configuration table fields:

Field Description
Object The name of the log object.
Subobject The name of the log subobject.
Log Level

Shows the minimum log level. The possible values are:

  • I: Information, Warnings, and Errors
  • W: Warnings and Errors
  • E: Errors Only
Retention

Number of days logs are going to be retained.

After the retention period, you can consider the logs for deletion using transaction SLG2.
End At End date till which this log configuration is going to be active. The default end date is 9999/12/31.
Is Default Indicates if this is the default log configuration.
Changed by Username who changed the log configuration.
Changed on Date when the log configuration was changed.
Changed at Time when the log configuration was changed.

Token caching

If the SDK is used in a high call volume use case where multiple API method calls are performed in a short duration, then enable caching for the access token or API key that the client key configuration obtains to access Google Cloud APIs.

Enabling token caching makes sure that an access token or API Key is reused until it expires or is revoked, which in turn reduces the number of HTTP calls made to retrieve new access tokens or API keys.

To enable token caching, select the Token Caching flag in the client key table.

When you enable token caching, the access token is cached in the Shared Memory of the application server for the duration that is set for the Token Refresh Seconds field in the client key table. If Token Refresh Seconds is not specified or is set to 0, then the access token is cached for the value specified in the CMD_SECS_DEFLT parameter in advanced settings.

Clear the cached access token

When token caching is enabled and you update the roles assigned to the service account that the ABAP SDK for Google Cloud uses to access the relevant APIs, the new access token that corresponds to the updated roles is retrieved only after the existing cached token expires. In such situations, you can clear the access token manually.

To clear the cached access token, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Utilities > Clear Cache.

  3. Select an option as appropriate:

    • Clear shared memory area: to clear the entire cache.
    • Clear instance from memory: to clear cached access token for a particular instance. With this option, you also specify an instance name.

  4. Run the report.

Find IAM roles for Google Cloud APIs

For implementing the principle of least privilege, it is essential for you to know the appropriate IAM roles for the Google Cloud APIs that you plan to use in your ABAP program. By granting only the necessary roles, you can limit access for a service account. The Role Finder utility, integrated within the SDK, lets you conveniently identify the IAM roles associated with various Google Cloud APIs.

To find the IAM roles, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Utilities > Fetch API Relevant Roles.

    Alternatively, you can access the Role Finder utility by executing the transaction code /GOOG/ROLE_FINDER.

  3. In the Client key field, enter a valid client key name configured in the table /GOOG/CLIENT_KEY.

  4. In the Google Service Name field, specify the Google Cloud API for which you need to check the IAM roles.

  5. Optionally, to view the associated IAM permissions within the IAM role, select the Full Details field.

  6. Click Execute. The IAM roles are displayed.

Advanced settings

Optionally, you can modify the advanced settings parameters for the SDK in /GOOG/SDK_PARAM table. These parameter values are applied at system level and are common across all SDK components.

The SDK internally applies default values for these parameters. Use advanced settings only if you want to override the default values.

We recommend that you modify the advanced settings parameters only after a comprehensive analysis and impact of new values on SDK performance. You are responsible for ensuring that the new advanced settings do not cause failures and performance issues.

To modify advanced settings parameters, perform the following steps:

  1. In SAP GUI, execute the transaction code /GOOG/SDK_IMG.

    Alternatively, execute the transaction code SPRO, and then click SAP Reference IMG.

  2. Click ABAP SDK for Google Cloud > Basic Settings > Configure Parameters.

  3. Click New Entries.

  4. In the displayed row, specify the following settings:

    1. In the Parameter Name field, enter the name of the parameter. The parameter description is automatically populated.
    2. In the Parameter Value field, enter a value.

    To know about the Advanced settings parameters, see Advanced settings parameters.

  5. Save the new entry.

Advanced settings parameters

The following table shows the advanced settings parameters for ABAP SDK for Google Cloud.

Parameter name Description Default value Valid value
CMD_SECS_DEFLT If you have enabled token caching, then this is the duration in seconds after which the cached token expires. 3500 The value must be from 1 to 3599.

Update the ABAP SDK for Google Cloud

Google Cloud delivers new releases of the ABAP SDK for Google Cloud as SAP transports.

If you encounter challenges while importing the transport files of the ABAP SDK for Google Cloud into your SAP environment, such as issues with transport review by SAP or import queue management, then contact Cloud Customer Care for assistance. For information about contacting Customer Care, see Getting support for SAP on Google Cloud.

SAP administrators can update ABAP SDK for Google Cloud by following these steps:

  1. In your SAP environment, stop the background jobs that use any existing API client stubs of the ABAP SDK for Google Cloud.

  2. Download the installation package that contains the transport files from the download portal.

  3. Import the following SAP transport requests:

    • If you're updating the SDK from version 1, 1.5, or 1.6 to the latest version, then copy the following transport files into the SAP Server transport import directories:

      • /usr/sap/trans/cofiles/K900323.GM1

      • /usr/sap/trans/data/R900323.GM1

        These transport files remove the artifacts associated with deprecated features in ABAP SDK for Google Cloud. For information about the additions, enhancements, and deprecated features, see What's new with the on-premises or any cloud edition of ABAP SDK for Google Cloud.

        If you're updating the SDK from version 1.7 or later to the latest version, then you can skip copying these transport files.

    • For establishing connection with the supported Google Cloud APIs and authenticating with tokens or API keys, copy the following transport files into the SAP Server transport import directories:

      • /usr/sap/trans/cofiles/K900319.GM1
      • /usr/sap/trans/data/R900319.GM1

    • For authenticating with OAuth 2.0 client credentials, copy the following transport files into the SAP Server transport import directories:

      • /usr/sap/trans/cofiles/K900321.GM1

      • /usr/sap/trans/data/R900321.GM1

        These transport files do not provide additional functionality, other than the OAuth 2.0 client credentials based authentication. For OAuth 2.0 client credentials based authentication, first import the transport files for the supported Google Cloud APIs, and then import the transport files for OAuth 2.0 client credentials.

        To use OAuth 2.0 client credentials, your SAP system must support OAuth 2.0. For information about the SAP systems that support OAuth 2.0, see SAP Note 3041322 - OAuth 2.0 Client: Downport of grant type Client Credentials.

  4. After validating the successful import and object activation, resume the background jobs.

Usage metrics

The on-premises or any cloud edition of ABAP SDK for Google Cloud collects usage metrics and sends them to Google for support purposes, in compliance with Google Cloud Privacy Notice (Service Data We Collect). These usage metrics are collected every time a Google Cloud API is called from the ABAP SDK for Google Cloud.

The SDK collects the following usage metrics:

  • Authentication method: information about the authentication method used for calling Google Cloud services.
  • ABAP SDK version: version no. of the on-premises or any cloud edition of ABAP SDK for Google Cloud.
  • SAP_ABA release: version of the SAP_ABA software component.
  • Module identifier (Collected only for the Vertex AI SDK for ABAP): name of the module or feature being used within the SDK, such as Vector Search.

Licensing

The on-premises or any cloud edition of ABAP SDK for Google Cloud is made available as "Software" under the agreement governing your use of Google Cloud Platform, including the Service Specific Terms available at https://cloud.google.com/terms/service-terms. Without limiting the generality of the above terms, you may not modify or distribute ABAP SDK for Google Cloud without express written permission from Google.

ABAP SDK for Google Cloud software is offered at no cost. For clarity, your use of other "Software" and "Services" under the agreement governing your use of Google Cloud Platform, such as Cloud Translation API and Pub/Sub API may incur a cost.

ABAP SDK for Google Cloud does not include any license to SAP software, please separately procure an appropriate license to SAP software.

Language support

The ABAP SDK for Google Cloud only supports English (EN).

The SDK defaults to English (EN) for the following SAP logon languages: Chinese (CH), French (FR), German (DE), Japanese (JA), Portuguese (PT), and Russian (RU).

Any error messages that you might encounter when working with the SDK are generated in English irrespective of your current system language.

Support lifecycle

Google Cloud supports and maintains the current major version of ABAP SDK for Google Cloud for a period of at least 12 months following the publication of a notice of deprecation for the prior major version at Release Notes page for SAP on Google Cloud.

Get support

If you need help resolving problems with the ABAP SDK for Google Cloud, then do the following: