Comenzar

La API de Manufacturer Center (MfC) permite que las apps interactúen directamente 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 codificar, debes hacer algunas acciones.

Asistencia de 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.

Configure su 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 línea de código).

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

  2. Asegúrate de que la Cuenta de Google a la que accediste esté en la lista de la configuración de los usuarios de la pestaña Configuración.

  3. En el Explorador de API, 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 ver lo que hacen. Como esta es una API de RESTful, todas las solicitudes funcionan de manera similar. Un buen paso siguiente, una vez que tengas productos, es probar Accounts.Products.get.

Crea un proyecto en la Consola de API de Google

Las solicitudes a la API de Manufacturer Center se realizan mediante el proyecto de la consola de la API. Aquí suponemos que accederás a tu propia cuenta de Manufacturer Center, por lo que te sugerimos usar las cuentas de servicio para simplificar el flujo de autenticación. Consulta la guía de cuentas de servicio a fin de obtener detalles sobre cómo configurar una nueva cuenta de servicio para usar con tu cuenta de Manufacturer Center.

Tu primera solicitud a la API autorizada con Java

Ahora que configuraste una cuenta de servicio y agregaste el ID de la cuenta de servicio a tu cuenta de Manufacturer Center, puedes acceder a ella con el código de muestras disponible. En esta guía, se usan las muestras 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 del archivo README que acompaña a los archivos de origen, recibirás un error que indica que no se pudo encontrar ninguna configuración de muestra. Sigue las instrucciones en el 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 debería colocarse en ese directorio con el nombre de archivo service-account.json. Recuerda indicar la ubicación del archivo con 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 de Java debería terminar de ejecutarse y, además, imprimir una lista de productos o un mensaje que indique que no había productos en tu cuenta. Si recibes un error como “El usuario no puede acceder a la cuenta 1234567890”, es probable que se deba a que no configuraste al usuario como usuario autorizado en Manufacturer Center. Desde el punto de vista de la API, el proyecto de la Consola de API 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, la rechazaría.

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