Manage Cloud APIs and Cloud Client Libraries in Cloud Code for Cloud Shell

To access Google Cloud products and services programmatically, you use Cloud APIs. These APIs expose a simple JSON REST interface. The recommended way to access the Cloud APIs is to use the Cloud Client Libraries.

Cloud Code makes it easy to add the Cloud Client Libraries for the Cloud APIs and language you're using to your project. In the same view, you can search for samples for each API and easily incorporate samples into your application.

Browsing Cloud APIs

To explore all available Google Cloud APIs:

  1. Click Cloud Code and then expand the Cloud APIs section.

    The Cloud APIs view groups Cloud APIs by category.

  2. To view details of an API, click the API name. Details such as the service name, status, installation instructions for client libraries, documentation, and code samples are displayed.

Enabling Cloud APIs

To enable Cloud APIs for a project using the API details page, follow these steps:
  • On the Cloud API details page, choose the project to enable the Cloud API for.
  • Click Enable API. After the API is enabled, a message is displayed to confirm the change.
  • Adding client libraries to your project

    In addition to exploring and enabling Cloud APIs using Cloud Code, you can add a language-specific client library to your project.

    To install a client library, follow the instructions on the API details page for your language.

    Using API samples

    You can search for and use code samples for each API in the API browser.

    1. Click Cloud Code and then expand the Cloud APIs section.

    2. To open the detail view, click the name of an API.

    3. To view code samples for the API, click Code Samples.

    4. To filter the list of samples, type text to search for or choose a programming language from the Language list.

    5. To view a sample, click the name of the sample. There are also options to copy the sample to your clipboard or view the sample in GitHub.

    Setting up authentication

    After you've enabled the required APIs and added the necessary client libraries, you need to configure your application for it to be successfully authenticated. Your configuration depends on your type of development and the platform you're running on.

    After you complete the authentication steps, your application can authenticate and is ready to be deployed.

    Local development

    The Cloud Shell VM instance uses the Compute Engine default service account (the service account Google Kubernetes Engine uses by default) as its default service account. This means that when developing with Cloud Code on Cloud Shell, you don't need to set up any additional configuration when working with client libraries. Your application is authenticated and ready to run locally.

    Local development with APIs that require a service account

    Some APIs, such as the Cloud Translation API, require a service account with appropriate permissions to authenticate your requests. For more information, see Creating and managing service accounts.

    1. To open a terminal, click Terminal > New Terminal.

    2. Create a service account to authenticate your API requests:

      gcloud iam service-accounts create \
      SERVICE_ACCOUNT_ID \
      --project PROJECT_ID

      Replace the following values:

      To find these IDs, in Google Cloud, click the Navigation menu at the top-left of the screen, hold your pointer over IAM & Admin and click Service Accounts.

      The Email column shows the unique SERVICE_ACCOUNT_ID and PROJECT_ID for each of your service accounts in the following format:

      SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com

      For example: A service account email address of my-service-account@my-project.iam.gserviceaccount.com has the following values:

    3. Grant your service account the appropriate role. The following sample command grants the Cloud Translation API User role. To determine the role to grant, see the documentation for the Cloud API you're using.

      gcloud projects \
      add-iam-policy-binding \
      PROJECT_ID \
      --member='serviceAccount:SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com' \
      --role='roles/cloudtranslate.user'
    4. Create a service account key:

      gcloud iam service-accounts keys \
      create key.json --iam-account \
      SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com
    5. Set the key as your default credentials:

      export \
       GOOGLE_APPLICATION_CREDENTIALS=key.json
      
    6. Optional: To permit users to impersonate the service account, run the gcloud iam service-accounts add-iam-policy-binding command to grant a user the Service Account User role (roles/iam.serviceAccountUser) on the service account:

      gcloud iam service-accounts add-iam-policy-binding \
          SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com \
          --member="user:USER_EMAIL" \
          --role="roles/iam.serviceAccountUser"

      Replace the following values:

    Remote development

    GKE

    Depending on the scope of your project, you can choose how you authenticate Google Cloud services on GKE:

    Cloud Run

    1. To create a new unique service account for deploying your Cloud Run application, navigate to the Service Accounts page and then select the project that your secret is stored in.

      Go to the Service Accounts page

    2. Click Create service account.
    3. In the Create service account dialog, enter a descriptive name for the service account.
    4. Change the Service account ID to a unique, recognizable value and then click Create.
    5. If the Google Cloud service you're trying to access requires additional roles, grant the roles, click Continue, and then click Done.
    6. To add your service account to your deploy configuration:
      1. Using the Cloud Code status bar, choose the Cloud Run: Deploy command.
      2. In the Cloud Run Deployment UI, under Revision Settings, in the Service Account field, specify your service account.
      Advanced revision settings section expanded in Cloud Run: Deploy and Service Account field filled in with service account name of the format service-account-name@project-name.iam.gserviceaccount.com

    Cloud Run

    Depending on the scope of your project, you can choose how you authenticate Google Cloud services on GKE:

    Remote development with Secret Manager permissions enabled

    If you're developing remotely, using a service account for authentication, and your application uses secrets, you need to complete a few more steps in addition to the remote development instructions. These steps assign your Google service account the role required to access a particular Secret Manager secret:

    1. Click Cloud Code and then expand the Secret Manager section.

      Secret Manager in Cloud Code open with two secrets listed

    2. Right-click the secret and select Edit Permissions in Cloud console. This launches the Secret Manager configuration page for that secret in your web browser.

      Right-clicked secret in Secret Manager panel

    3. In Google Cloud console, click Permissions and then click Add.

    4. In the New principals field, enter the name of your service account.

    5. In the Select a role field, choose the Secret Manager Secret Accessor role.

    6. Click Save.

      Your service account now has permission to access this particular secret.