Configure Google Cloud Platform

Note: This article applies to the Google data actions integration.

To use the Google data actions integration, configure your Google Cloud Platform account to link Google APIs to the integration.

  1. Create a service account.

    This service account must be in a Google Cloud Platform project that contains APIs that you want data actions to call. For more information, see Creating and managing service accounts in the Google Cloud documentation.

    If you want to use multiple APIs, make sure that the service account contains all the APIs that you want to use. If the APIs that you want to use span service accounts, then add a separate integration for each service account. For more information, see Add a data actions integration.

  2. Create a private key file for the service account.

    This file contains items that you add to the integration credentials. For more information, see Creating and managing service account keys in the Google Cloud documentation.

Special configurations for Google Cloud Functions

To use Google Cloud Functions, you must also configure functions, roles, and permissions in Google Cloud Platform.

The following table lists the names of items used in our examples and describes their relationship to each other.

Google item Name in example Description Notes
Project BusinessCallingAPI This project contains our service account and functions.
Service Account jwt-testing

This service account belongs to the BusinessCallingAPI project. 

Function function-test-action This function exists in the project BusinessCallingAPI. The service account jwt-testing is assigned to this function. Assign the service account to each function that you want the Google data actions integration to execute.
Custom role Custom CloudFunction Function Call This custom role with the permission cloudfunctions.functions.call is assigned to the function function-test-action for the service account jwt-testing. Assign the custom role to the service account for each function that you want the Google data actions integration to execute. 
Permission cloudfunctions.functions.call This permission is added to the custom role Custom CloudFunction Function Call.
  1. Create or review existing Google Cloud Functions.
    1. Make sure that the functions return JSON as their responses.
    2. Gather the project name, function locations, and function names.

      You will use this information to create the Request URL Template for the data action, which calls the function. For more information, see Add configuration to custom actions for integrations

    For a working example, see Example Google Cloud Function with a data action.

    The following image shows a list of functions. The function function-test-action is assigned the role Custom CloudFunction Function Call. The role exists in the service account jwt-testing.

    Click image to enlarge.Google Cloud Function with an assigned role in Google Cloud Platform

  2. Create a custom role and assign the cloudfunctions.functions.call permission to the role.

    The role now has permission to access functions. For more information, see Understanding IAM custom roles in the Google Cloud documentation.

    The following image shows the custom role Custom CloudFunction Function Call with the assigned permission cloudfunctions.functions.call.

    Click image to enlarge.Role assigned to a function in Google Cloud Platform

  3. Assign the service account to each function.

    Repeat for each function that you want the data actions integration to execute. For more information, see Function Identity in the Google Cloud documentation.

    The following image shows details about the function function-test-action. The service account jwt-testing is assigned to the function.

    Important: The Trigger URL only works if you assign public access to the permission. Genesys does not recommend assigning public access for data actions because public access is insecure.

    Click image to enlarge.Assign service account to function in Google Cloud Platform

You are now ready to add a Google data actions integration to your Genesys Cloud organization.

Next, add the integration.

For more information about the integration, see About the Google data actions integration.