Technical setup

Before you begin

Before starting, you need the following:

  • Super admin access to your reseller domain. For more information, see how to access the Cloud Channel API.

  • Access to the Google Cloud Console and the Channel Services Console.

Step 1: Prepare the Channel Services Console

Before you can use the API, you must accept the terms and conditions of the Channel Services platform.

Log in to the Channel Services Console at least once as an administrator of the reseller domain. The first time you sign in, you must accept the reseller terms of service, if applicable. If you accepted specific terms of service offline, this step isn't applicable to you.

You can accept additional terms of service on the Terms page of the Channel Services Console.

Step 2: Configure your Cloud project

To use any Google API, you must have a Google Cloud project.

Create a Cloud project

To create a project, navigate to the Projects area of your Google Cloud Console and click Create Project.

For more detailed instructions on creating a project, and for a list of best practices, see our Creating and managing projects guide.

Most resellers create Google Cloud projects under their main Google Cloud organization instead of under the reseller domain. Accessing data from the reseller domain is granted by setting up domain-wide delegation to let a service account access data from the reseller domain.

Give the project a descriptive name. The project ID is an arbitrary identifier that does not affect your ability to call the Cloud Channel API.

Enable the API

Navigate to the API Library section in the Google Cloud Console and enable the Cloud Channel API.

Create a service account

To create your service account, go to the Service accounts page.

Go to Service accounts

  1. Click Create Service Account.
  2. Enter the Service account name (and optional Service account description) then click Create.
  3. Click Continue to skip the Grant service account access to project option.
  4. Skip the Grant users access to this service account section and click Done to finish account creation.

After you create your account, select Create key from theActions menu. Select JSON and click Create to generate a private key for that service account.

You can delete and create private key files from the Service accounts page.

Step 3: Authorize the service account for the reseller domain

You need your service account's Client ID for this section. From the Actions menu, select Manage details and copy your Unique ID.

Go to the Domain-wide delegation page using your reseller domain's super-admin account.

  • Click Add new and enter your service account's ID in the Client ID field.
  • Enter https://www.googleapis.com/auth/apps.order in the OAuth Scopes field.
  • Click Authorize to allow your service account to use the Cloud Channel API in the context of your Channel Services account.

Then click Authorize so your service account can use the Cloud Channel API in the context of your Channel Services account.

Next steps

Now that you have an initial technical integration, you can discover the API by reading the Cloud Channel API documentation.