Comenzar

La API de Manufacturer Center (MfC) permite que las apps interactúen de forma directa con la plataforma de Manufacturer Center. Para ayudarte a comenzar, ofrecemos muestras de código en Java y .NET.

Esta guía te ayudará a crear tu primera aplicación con la API de Manufacturer Center. Antes de comenzar a programar, debes realizar algunas acciones.

Compatibilidad con REST

Nuestra API de REST admite operaciones CRUD básicas para 2 tipos diferentes de recursos:

El resto de esta documentación se escribirá principalmente para Product, pero el proceso debe ser similar para ProductCertification.

Configura tu cuenta de Manufacturer Center

  1. Crea una cuenta de Manufacturer Center.

  2. Asegúrate de recordar qué correo electrónico usaste para crear esta cuenta de Manufacturer Center, ya que lo necesitarás más adelante. En las capturas de pantalla, lo verás representado como manufacturer_user@example.com.

Realiza tu primera solicitud a la API (sin una línea de código)

  1. Ve al Explorador de APIs en nuestra documentación para desarrolladores de Accounts.Products.list.

  2. Asegúrate de que la Cuenta de Google con la que accediste aparezca en la opción “Usuarios” de la pestaña “Configuración”.

  3. En el Explorador de APIs, asegúrate de que Google OAuth 2.0 esté seleccionado en el menú desplegable Autenticación:

  4. Ingresa accounts/{account_id}, reemplaza {account_id} por el ID de fabricante de tu cuenta de Manufacturer Center en el campo “superior” del formulario y haz clic en Ejecutar.

  5. Debería ver una respuesta correcta. ¡Felicitaciones! Realizaste tu primera solicitud a la API de Manufacturer Center.

  6. Si aún no tienes productos en Manufacturer Center, no habrá ninguno en la lista. En este punto, puedes saltar a otras solicitudes y observar lo que hacen. Dado que esta es una API de RESTful, todas las solicitudes funcionan de manera similar. Una vez que tengas productos, recomendamos que pruebes Accounts.Products.get.

Cómo crear un proyecto en la Consola de APIs de Google

Las solicitudes a la API de Manufacturer Center se realizan a través de tu proyecto de la Consola de APIs. En este caso, suponemos que accederás a tu propia cuenta de Manufacturer Center, por lo que te sugerimos que uses cuentas de servicio para simplificar el flujo de autenticación. Consulta la guía de cuentas de servicio para obtener detalles sobre cómo configurar una cuenta de servicio nueva para usarla con tu cuenta de Manufacturer Center.

Tu primera solicitud a la API autorizada con Java

Ahora que ya configuraste una cuenta de servicio y agregaste el ID de la cuenta de servicio a la de Manufacturer Center, puedes acceder a ella con el Código de muestras disponible. En esta guía, se usan los ejemplos de Java para demostrar el uso de la API.

  1. Instala Apache Maven si aún no lo hiciste.

  2. Descarga nuestras muestras de Shopping desde nuestra página de GitHub.

  3. Desde el subdirectorio java, compila las muestras de Java:

    $ mvn compile

  4. Ahora ejecuta el código ProductsListSample (el ejemplo de ProductCertification sería ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Si no seguiste las instrucciones de configuración en el archivo README que acompaña los archivos de origen, aparecerá un error que indica que no se puede encontrar ninguna configuración de muestra. Sigue las instrucciones del archivo README para crear el directorio de configuración y propagarlo con la información adecuada. El archivo JSON que descargaste cuando configuraste la cuenta de servicio se debe colocar en ese directorio con el nombre de archivo service-account.json. Recuerda indicarle al código la ubicación de tu archivo mediante la configuración de la siguiente variable de entorno.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Ahora que estableciste la configuración de muestras, vuelve a ejecutar el código ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. En este punto, el programa Java debería terminar de ejecutarse e imprimir una lista de productos que encontró o un mensaje que indica que no había productos en tu cuenta. Si recibes un error como “El usuario no puede acceder a la cuenta 1234567890”, lo más probable es que se deba a que no configuraste el usuario de la cuenta de servicio como usuario autorizado en Manufacturer Center. Desde el punto de vista de la API, el proyecto de la Consola de APIs envió una solicitud en nombre de un usuario que no estaba en la lista de administradores autorizados de Manufacturer Center, por lo que, por supuesto, rechazaría esa solicitud.

  8. Puedes experimentar la ejecución de ProductsListSample tantas veces como desees, ya que es una solicitud de solo lectura. También puedes explorar las otras muestras que creamos para Java y .NET.