Configuración técnica

Antes de comenzar

Antes de comenzar, necesitas lo siguiente:

• Tiene 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 la Partner Sales Console.

Paso 1: Prepara la Partner Sales Console

Antes de poder usar la API, debes aceptar los Términos y Condiciones de la plataforma de servicios de canal.

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

Puedes aceptar otras Condiciones del Servicio en la página de Condiciones de Partner Sales Console.

Nota: Necesitas el ID de la cuenta, que se encuentra en la página Configuración de Partner Sales Console, para la integración de la API.

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 Proyectos de la consola de Google Cloud y haz clic en Crear proyecto.

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 bajo su organización principal de Google Cloud en lugar de hacerlo con el dominio de revendedor. El acceso a los datos del dominio del revendedor se otorga mediante la configuración de la delegación de todo el dominio para permitir que una cuenta de servicio acceda a los datos desde el dominio del revendedor.

Asígnale 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.

Habilitar la API

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

Crea 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. Ingresa el Nombre de la cuenta de servicio (y la descripción opcional de la cuenta de servicio) y, luego, haz clic en Crear.
3. Haz clic en Continuar para omitir la opción Otorgar a la cuenta de servicio acceso al proyecto.
4. Omite la sección Otorga a usuarios acceso a esta cuenta de servicio y haz clic en Listo para finalizar la creación de 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. Haz 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 de 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 Permisos de OAuth.
• Haz clic en Autorizar para permitir que tu cuenta de servicio use la API de Cloud Channel en el contexto de tu cuenta de servicios de canal.

Nota: Si usas APIs adicionales en tu integración final, es posible que tengas más de un alcance 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 servicios de canal.

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

Próximos pasos

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

Nota: Si también tienes una Partner Sales Console de prueba, sigue los pasos uno a 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. Si compartes un proyecto entre varios entornos, es posible que tus cuentas de prueba afecten las cuotas de tu cuenta de producción.