Obtén inteligencia contextual sobre la API de Merchant del asistente de programación que elijas. En tu entorno de desarrollo integrado (IDE), ahora puedes acceder a la integración de la documentación para desarrolladores con el servicio del Protocolo de contexto del modelo (MCP). Este servicio acelera el desarrollo de los flujos de trabajo de integración y migración, ya que proporciona a tu asistente de programación contexto autorizado de la documentación oficial de las APIs de Google.
Para obtener más información sobre el protocolo en sí, consulta el estándar del Protocolo de Contexto del Modelo.
Descripción general
Cuando migres de Content API for Shopping a Merchant API o compiles una nueva integración, deberás comprender las nuevas estructuras de servicio, los nombres de recursos y los métodos. El servicio de MCP simplifica este proceso, ya que proporciona documentación oficial y muestras de código a tu asistente de programación.
El servicio utiliza un backend de generación aumentada por recuperación (RAG) altamente especializado. Cuando le haces una pregunta sobre la API de Merchant a tu asistente de programación del IDE habilitado para MCP, el servicio recupera los fragmentos de texto y código más relevantes de los recursos oficiales de Google y los muestra como contexto a tu asistente de programación. Esto permite que tu asistente proporcione respuestas precisas y actualizadas sin que tengas que salir de tu entorno de desarrollo.
Cómo funciona
La integración de la documentación para desarrolladores con MCP se integra en un flujo de trabajo de desarrollo moderno asistido por IA:
- Haces una pregunta en tu asistente de programación o agente compatible con MCP. Puede ser una pregunta en lenguaje natural o una solicitud de una muestra de código para la implementación de métodos de la API de Merchant.
- Tu asistente de codificación envía una solicitud de contexto al extremo de MCP.
- El servicio de MCP busca en su colección indexada de documentación, guías y muestras de código oficiales de la API de Merchant para encontrar la información más relevante.
- El servicio devuelve estos fragmentos autorizados como contexto para tu asistente de programación.
- Tu asistente de programación usa este contexto de alta calidad para generar una respuesta precisa y útil a tu pregunta original.
Cómo comenzar
Para usar MCP, necesitas un IDE o un asistente de programación que admita el Protocolo de contexto del modelo con transporte HTTP transmisible.
Configuración de extremos
Para conectar tu herramienta al servicio, usa los detalles del extremo remoto proporcionados, lo que puede requerir que ingreses la URL directa del servicio o la definición de MCP, según la configuración de tu herramienta.
La URL del servicio es la siguiente:
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
Ejemplos de situaciones de uso
El MCP puede acelerar tu flujo de trabajo en estos casos de uso comunes.
Situación 1: Migración de una llamada a la API heredada
Tienes una aplicación existente que usa Content API for Shopping y necesitas actualizarla. Puedes preguntar sobre un método heredado específico para obtener detalles sobre la nueva implementación y una muestra de código pertinente.
Instrucción del usuario:
"¿Cuál es el equivalente en la Merchant API del método accountstatuses.get de la Content API for Shopping?"
El servicio de MCP proporciona contexto a partir de las guías de migración oficiales y la documentación de referencia, lo que permite que tu asistente responda con una respuesta detallada, incluido el nuevo nombre de la API, accounts.issues.
Situación 2: Cómo encontrar una muestra de código
Estás implementando una función nueva y necesitas un ejemplo práctico para seguir.
Instrucción del usuario:
"Muéstrame un ejemplo de código en Python para agregar un nuevo servicio de envío con la API de Merchant".
El servicio de MCP recupera muestras de código relevantes de los repositorios oficiales de GitHub de Google y las guías para desarrolladores. Luego, tu asistente puede presentar un bloque de código completo y listo para adaptar.
Situación 3: Comprender los conceptos de la API
Te encuentras con un concepto nuevo o quieres comprender la estructura de un recurso o el patrón general de la API de Merchant.
Instrucción del usuario:
"¿Cómo actualizo el inventario de un producto con la API de Merchant?"
El servicio de MCP devuelve contexto de la documentación de recursos de productos y las guías pertinentes. Luego, tu asistente puede explicarte cómo usar el método accounts.productInputs.insert y proporcionar el recurso del producto parcial que contiene solo el productId y los campos relacionados con el inventario que necesitas actualizar.
"¿Cómo autorizo las llamadas de mi aplicación con la API de Merchant?"
El servicio de MCP recupera el contexto de las guías de autenticación oficiales, que abarcan diferentes métodos de autorización. Luego, tu asistente puede explicar las opciones principales disponibles, como usar una cuenta de servicio para las interacciones de servidor a servidor o un ID de cliente de OAuth 2.0 cuando actúas en nombre de un usuario.
Situación 4: Adaptación a los cambios en la API
La API de Merchant introduce nuevos patrones, como las solicitudes por lotes, que difieren de Content API for Shopping. Content API for Shopping usa métodos custombatch específicos, mientras que Merchant API usa una función de procesamiento por lotes de HTTP genérica integrada.
Instrucción del usuario:
"¿Cuál es la nueva forma de hacer un products.custombatch en la API de Merchant?"
El servicio de MCP recupera el contexto de Refactor code for concurrent requests, en el que se explica que no existen métodos custombatch dedicados en la API de Merchant.
En cambio, proporciona documentación sobre el uso del procesamiento por lotes de HTTP con un Content-Type de multipart. Luego, tu asistente puede explicarte cómo crear una sola solicitud HTTP que contenga varias llamadas a la API, que se envían al extremo https://merchantapi.googleapis.com/batch/{sub-api}/v1, y proporcionar un ejemplo de cómo estructurar la solicitud de varias partes. Esto convierte una tarea de migración potencialmente confusa en un proceso guiado.
Fuentes de la base de conocimiento
El servicio de MCP crea su base de conocimiento exclusivamente a partir de fuentes públicas y oficiales para garantizar que el contexto que proporciona sea preciso y confiable. El servicio indexa todo el contenido del sitio oficial para desarrolladores y el repositorio de muestras de código, lo que incluye lo siguiente:
- Sitio para desarrolladores de la API de Merchant: Todas las guías, el material de referencia y la documentación
- Servicio de Apps Script de la API de Merchant: Ejemplo del uso de la API de Merchant desde Apps Script.
- Muestras de código oficiales: Todas las muestras de código oficiales de la API de Merchant proporcionadas por Google desde el repositorio de GitHub.
- Bibliotecas cliente: Todas las bibliotecas cliente oficiales admitidas por el comercio