Configuración técnica

Antes de empezar

Antes de empezar, necesitas lo siguiente:

  • Acceso de superadministrador a tu dominio de distribuidor. Para obtener más información, consulta cómo acceder a la API Cloud Channel.

  • Acceso a la consola de Google Cloud y a Partner Sales Console.

Paso 1: Prepara la consola de Partner Sales

Para poder usar la API, debes aceptar los términos y condiciones de la plataforma Channel Services.

Inicia sesión en la consola de Partner Sales al menos una vez como administrador del dominio del distribuidor. La primera vez que inicies sesión, debes aceptar los términos del servicio del distribuidor, si procede. Si has aceptado términos del servicio específicos sin conexión, este paso no es aplicable en tu caso.

Puedes aceptar términos del servicio adicionales en la página Términos de la consola de Partner Sales.

Paso 2: Configura tu Google Cloud proyecto

Para usar cualquier API de Google, debes tener un Google Cloud proyecto.

Crea un Google Cloud proyecto

Para crear un proyecto, ve a la sección Proyectos de tu consola Google Cloud y haz clic en Crear proyecto.

Para obtener instrucciones más detalladas sobre cómo crear un proyecto y consultar una lista de prácticas recomendadas, consulta nuestra guía Crear y gestionar proyectos.

La mayoría de los distribuidores crean Google Cloud proyectos en su organización principalGoogle Cloud en lugar de en el dominio de distribuidor. Para acceder a los datos del dominio del distribuidor, se debe configurar la delegación en todo el dominio, de forma que una cuenta de servicio pueda acceder a los datos del dominio del distribuidor.

Asigna un nombre descriptivo al proyecto. El ID de proyecto es un identificador arbitrario que no afecta a tu capacidad para llamar a la API Cloud Channel.

Activar la API

Ve a la sección Biblioteca de APIs de la consola Google Cloud y habilita la API Cloud Channel.

Crear una cuenta de servicio

Para crear tu cuenta de servicio, ve a la página Cuentas de servicio.

Ir a Cuentas de servicio

  1. Haz clic en Crear cuenta de servicio.
  2. Introduce el Nombre de cuenta de servicio (y, si quieres, la Descripción de cuenta de servicio) y, a continuación, haz clic en Crear.
  3. Haz clic en Continuar para saltarte la opción Conceder acceso a la cuenta de servicio al proyecto.
  4. Omite la sección Conceder a los usuarios acceso a esta cuenta de servicio y haz clic en Hecho para terminar de crear la cuenta.

Después de crear tu cuenta, crea una clave de cuenta de servicio:

  1. En la Google Cloud consola, haz clic en la dirección de correo de la cuenta de servicio que has creado.
  2. Haz clic en Teclas.
  3. Haz clic en Añadir clave y, a continuación, en Crear clave.

  4. Haz clic en Crear. Se descargará un archivo de clave JSON en tu ordenador.

    Asegúrate de almacenar el archivo de claves de forma segura, ya que se puede usar para autenticarte como tu cuenta de servicio. Puedes mover y cambiar el nombre de este archivo como quieras.

  5. Haz clic en Cerrar.

Puedes eliminar y crear archivos de clave privada en la página Cuentas de servicio.

Paso 3: Autoriza la cuenta de servicio para el dominio del distribuidor

Necesitas el ID de cliente de tu cuenta de servicio para esta sección. En el menú Acciones, seleccione Gestionar detalles y copie su ID único.

Ve a la página Delegación en todo el dominio con la cuenta de superadministrador de tu dominio de distribuidor.

  • Haz clic en Añadir nuevo e introduce el ID de tu cuenta de servicio en el campo ID de cliente.
  • Introduce https://www.googleapis.com/auth/apps.order en el campo Permisos de OAuth.
  • Haz clic en Autorizar para permitir que tu cuenta de servicio use la API Cloud Channel en el contexto de tu cuenta de Channel Services.

A continuación, haz clic en Autorizar para que tu cuenta de servicio pueda usar la API Cloud Channel en el contexto de tu cuenta de Channel Services.

Pasos siguientes

Ahora que tienes una integración técnica inicial, puedes descubrir la API leyendo la documentación de la API Cloud Channel.