Prerequisites

• Access to the Google Cloud console.
• SoftExpert Suite environment hosted in the cloud.
• Access to the Configuration > Integration center (COP010) menu.
• "AI features'' permission enabled in Configuration > Access group (CM011) > Other permissions > AI features.

Introduction

The Google v2 API is used for machine text translation, while v3 is used for machine text and file translation.

To configure the Google v2 or v3 integration API, it is necessary to generate the credentials in advance in the Google Cloud console.

The Google Cloud console does not require prior installation or configuration and can be accessed directly through a browser.

This article provides step-by-step instructions for generating the necessary credentials, both for the Google v2 and Google v3 versions.

Generating credentials for Google v2 API (text translation)

1. Access the Google Cloud console via a browser.

2. On the home screen, click on Navigation menu > APIs & Services > Credentials.

3. Click on Create credentials and select the API key option.

4. Provide the necessary data for the creation of the key:

• Name: use an exclusive first name to identify your API key.
• Authenticate API calls through a service account: select this option if you wish to authenticate the API calls through the service account and link an account.
• Application/API restrictions: select an application type and/or specific APIs to restrict access.

5. Click on Create.

6. The key will be generated; copy it and store it somewhere safe, as it will be used later.

7. Access the Configuration component > Integration center (COP010) > Integration API.

8. Click on the button to add a new API of the Google v2 type.

9. Enter the title and, in the API key field, enter the key generated in the Google Cloud console.

10. Click on the button.

11. Still in the Integration center (COP010) menu, Translation tab, Text section, select the previously registered Google v2 API.

12. Click on the button.

Generating credentials for the Google v3 API (text and file translation)

1. Access the Google Cloud console via a browser.

2. On the home screen, click on Navigation menu > APIs & Services > Credentials.

3. Click on Create credentials and select the Service account option.

4. In Step 1, Create service account, enter the name and ID of the service account.

5. Click on Create and continue.

6. In step 2, Permissions, select the Cloud Translation API User option in the Select a role field.

7. Click on Continue.

8. In step 3, Principals with access, specify the users who will have the role of user or administrator of the service account.

9. Click on Done.

10. Back to the home screen of the console, in Service accounts, select the created account and click on Edit service account.

11. On the screen that will be displayed, access the Keys tab, click on Add keys, and then on Create new key.

12. In Key type, select the JSON option.

13. Click on Create. The JSON file will be downloaded automatically.

14. Access the Configuration component > Integration center (COP010) > Integration API.

15. Click on the button to add a new API of the Google v3 type and fill in the fields according to the information contained in the downloaded JSON file:

• E-mail: client_email.
• Project ID #: project_id.
• Private key: private_key.

16. Click on the button.

17. Still in the Integration center (COP010) menu, access the Translation tab.

18. In the Text section, select the previously registered Google v3 API. In Files, also select the same Google v3 API.

19. Click on thebutton.

Conclusion

With the credentials generated, it is possible to continue configuring the integration API for the Google v2 and Google v3 options.