Configuración técnica

Antes de comenzar

Antes de comenzar, necesitas lo siguiente:

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

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

Paso 1: Prepara Partner Sales Console

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

Accede a Partner Sales Console al menos una vez como administrador del dominio del distribuidor. La primera vez que accedas, debes aceptar las Condiciones del Servicio del distribuidor, si corresponde. Si aceptaste condiciones del servicio específicas sin conexión, este paso no se aplica a tu caso.

Puedes aceptar condiciones del servicio adicionales en la página Condiciones de Partner Sales Console.

Nota: Para la integración de la API, necesitas el ID de tu cuenta, que se encuentra en la página de configuración de Partner Sales Console.

Paso 2: Configura tu proyecto de Google Cloud

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

Crea un proyecto de Google Cloud

Para crear un proyecto, navega al área Projects de la consola de Google Cloud y haz clic en Create Project.

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

La mayoría de los revendedores crean proyectos de Google Cloud en su organización principal de Google Cloud en lugar de hacerlo en el dominio del revendedor. Para acceder a los datos del dominio del revendedor, se debe configurar la delegación en todo el dominio para permitir que una cuenta de servicio acceda a los datos del dominio del revendedor.

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

Habilita la API

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

Cree una cuenta de servicio

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

Ir a Cuentas de servicio

Nota: Las claves de cuenta de servicio son un riesgo de seguridad si no se administran de forma adecuada. Debes elegir una alternativa más segura a las claves de la cuenta de servicio siempre que sea posible. Si te debes autenticar con una clave de cuenta de servicio, eres responsable de la seguridad de la clave privada y de otras operaciones que se describen en Prácticas recomendadas para administrar claves de cuenta de servicio. Si no se te permite crear una clave de cuenta de servicio, es posible que la creación de claves de cuentas de servicio esté inhabilitada para tu organización. Para obtener más información, consulta Administra los recursos de la organización con seguridad de forma predeterminada.

1. Haz clic en Crear cuenta de servicio.
2. Ingresa el Nombre de la cuenta de servicio (y la Descripción de la cuenta de servicio opcional) y, luego, haz clic en Crear.
3. Haz clic en Continuar para omitir la opción Otorgar acceso de la cuenta de servicio al proyecto.
4. Omite la sección Otorga a los usuarios acceso a esta cuenta de servicio y haz clic en Listo para terminar de crear la cuenta.

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

1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
2. Haga clic en Claves.
3. Haz clic en Agregar clave, luego haz clic en Crear clave nueva.

4. Haz clic en Crear. Se descargará un archivo de claves JSON en tu computadora.

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

5. Haz clic en Cerrar.

Puedes borrar y crear archivos de claves privadas desde la página Cuentas de servicio.

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

Necesitas el ID de cliente de tu cuenta de servicio para esta sección. En el menú Acciones, selecciona Administrar detalles y copia tu ID único.

Ve a la página de delegación de todo el dominio con la cuenta de administrador avanzado de tu dominio de revendedor.

• Haz clic en Agregar nuevo y, luego, ingresa el ID de tu cuenta de servicio en el campo ID de cliente.
• Ingresa https://www.googleapis.com/auth/apps.order en el campo OAuth Scopes.
• Haz clic en Autorizar para permitir que tu cuenta de servicio use la API de Cloud Channel en el contexto de tu cuenta de Channel Services.

Nota: Si usas APIs adicionales en tu integración final, es posible que tengas más de un permiso para el cliente de tu cuenta de servicio.

Luego, haz clic en Autorizar para que tu cuenta de servicio pueda usar la API de Cloud Channel en el contexto de tu cuenta de los servicios de canal.

Nota: Es posible que debas habilitar más APIs y agregar más permisos en otros codelabs. Es posible que tu integración final tenga más de un permiso para el cliente de tu cuenta de servicio.

Próximos pasos

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

Nota: Si también tienes una Partner Sales Console de prueba, sigue los pasos del uno al cuatro con tu dominio de revendedor de prueba. Asegúrate de crear un proyecto independiente, ya que las APIs de Google tienen cuotas por proyecto. Compartir un proyecto en varios entornos puede hacer que tus cuentas de prueba afecten las cuotas de tu cuenta de producción.