Comprar con Google para la Búsqueda y Shopping dejará de estar disponible a partir del 26 de septiembre de 2023. Puedes recuperar pedidos existentes hasta el 31 de octubre de 2024. Consulte Cómo comenzar a usar Comprar con Google para obtener más detalles.

Se usó la API de Cloud Translation para traducir esta página.

Switch to English

Baja de Comprar con Google

A continuación, te presentamos el programa de desactivación de Comprar con Google para la Búsqueda y Shopping. Después de las siguientes fechas, estas funciones ya no estarán disponibles.

28 de junio de 2023:

30 de septiembre de 2023:

31 de octubre de 2023:

Todas las funciones de orders excepto list y get
orderinvoices
orderreports
orderreturns

31 de octubre de 2024:

Comenzar

El recurso orders permite que los comercios procesen los pedidos que reciben a través de Comprar con Google.

Puedes usar el recurso orders para hacer lo siguiente:

Recibe y confirma pedidos nuevos.
Actualiza los estados de los pedidos.
Administra las devoluciones.
Proporcionar reembolsos.

Este es un resumen de cómo usar el recurso orders:

Inscribe tu cuenta de Merchant Center en Comprar con Google: Esto se suma a tu inscripción en Merchant Center. Comunícate con nosotros para asegurarte de que tus Cuentas de Google estén inscritas.
Acepta las condiciones de Comprar con Google: Se encuentran en Merchant Center > Comprar con Google durante la etapa de integración o en el submenú Acerca de.
Configura un proyecto nuevo: Descarga una clave de cuenta de servicio JSON que es posible que debas editar como se describe en Clave de cuenta de servicio.
Precaución: Almacena el archivo de claves de forma segura y realiza un seguimiento de su ubicación. Si lo pierdes, no podrás volver a descargarlo, pero puedes repetir este paso para crear un proyecto nuevo y obtener un archivo de claves nuevo.

Si deseas obtener información adicional, consulta Cómo configurar un proyecto de Google Console.
Asigna el rol Administrador de pedidos de Comprar con Google: Consulta Asigna la función de administrador de pedidos. Agrega esto a la cuenta de servicio de Google (GSA) que creaste en el paso anterior. Hazlo con cualquier otra cuenta que necesite usar el recurso orders o acceder a la vista Pedidos en Merchant Center.
(Opcional) Descarga las bibliotecas cliente de Content API para tu app.
Modifica la clave de API: Solo debes hacerlo si realizas llamadas a través de un servicio web y no desde una biblioteca. Consulta Clave de cuenta de servicio.
Implementa la autenticación OAuth 2.0: Consulta Autoriza solicitudes. Como alternativa, puedes obtener un token de acceso para incluirlo en las solicitudes RESTful, según se describe en Cómo obtener un token de acceso.
Llama al recurso orders: Consulta Cómo usar el recurso de pedidos para obtener más información o este instructivo rápido para probar el recurso. Usa el modo de zona de pruebas para probar la implementación de tu recurso orders antes de implementarla en producción.

Asigne el rol Administrador de pedidos.

Antes de usar el recurso orders, debes asignar el rol de administrador de pedidos de Comprar con Google a tu cuenta de servicio de Google (GSA) y a cualquier otra cuenta que necesite acceso al recurso orders o a la vista Pedidos en Merchant Center.

Para asignar el rol Administrador de pedidos, sigue estos pasos:

Abre Merchant Center.
Haga clic en el ícono de herramientas que se encuentra en la esquina superior derecha y seleccione Acceso a la cuenta:

Merchant Center muestra una lista de usuarios y sus roles.

Si no ves la opción Acceso a la cuenta en la lista desplegable, significa que la cuenta no tiene privilegios de administrador.
Haga clic en la fila de un usuario para editarla.
Aparecerá la vista Preferencias del usuario.

Si una cuenta no está en la lista de usuarios, haz clic en + para agregarla.
En la sección Acceso de usuario, marca la casilla de verificación Administrador de pedidos:
Haz clic en Guardar para guardar los cambios.

El rol de administrador de pedidos de Comprar con Google debe aparecer junto al usuario en la lista de usuarios. Repite este proceso con todas las cuentas que accederán al recurso orders o a la vista Pedidos en Merchant Center.

Modos de zona de pruebas y producción

Puedes usar el recurso orders de dos maneras:

Modo de zona de pruebas: Compilar y probar tu implementación en una zona de pruebas A veces, las funciones nuevas están disponibles aquí primero.
Modo de producción: Para implementar tu implementación en un entorno de producción, sigue estos pasos:

Tú indicas qué versión quieres utilizar en la URL:

https://www.googleapis.com/content/mode/merchant_ID/orders/

En el ejemplo anterior, merchant_ID es tu ID de Merchant Center y mode especifica qué modo usar:

Modo de zona de pruebas (v2.1sandbox)

Para experimentar y emitir solicitudes de prueba, usa el modo de zona de pruebas especificando v2.1sandbox para el mode en tus URLs. Por ejemplo:

      GET 'https://www.googleapis.com/content/v2.1sandbox/42/orders/'

El modo de zona de pruebas admite los siguientes métodos adicionales que el modo de producción no admite:

Modo de producción (v2.1)

Usa el modo de producción para procesar pedidos en tiempo real. Para ello, especifica v2.1 para mode en tus URLs. Por ejemplo:

 GET 'https://www.googleapis.com/content/v2.1/42/orders/'

Usa Probar esta API

Para crear pedidos de prueba en el modo de zona de pruebas, usa el cuadro Probar esta API en el lado derecho de la página createtestorder. Probar la API funciona en todas las páginas de documentación de la API.

Para crear un pedido de prueba con Prueba esta API, sigue estos pasos:

Abre la página Referencia de la API > createtestorder.
Ten en cuenta que Prueba esta API llama al método de la página que estás viendo actualmente. Por ejemplo, si estás viendo la página de referencia de createtestorder, Prueba esta API llama a createtestorder. Para llamar a get, navega a la página de referencia de get.
Ingresa tu ID del comerciante en el campo merchantId del parámetro de solicitud.
Agrega el campo templateName al cuerpo de la solicitud y establécelo en una de las plantillas descritas a continuación; por ejemplo, template1.
En el siguiente ejemplo, se muestra una llamada con el ID de Merchant Center 42:
Haz clic en Ejecutar.
El recurso orders crea un pedido de prueba nuevo y responde con un error HTTP 200. La respuesta incluirá el ID del pedido recién creado:
Copia el orderId de la respuesta. Lo necesitarás para los próximos pasos.

Próximos pasos

Después de crear un pedido de prueba, puedes completar el proceso de pedido y actualizar su estado en cada paso:

Visualiza el contenido del pedido recién creado con el método get.
Obtén una lista de todos los pedidos de tu cuenta con el método list.
Avanza el estado de tu pedido a pendingShipment con advancetestorder.
Confirma el pedido con acknowledge.
De manera opcional, asigna un ID de pedido del comercio con updatemerchantorderid.
Crea un envío y cambia el estado del pedido a shipped con shiplineitems.
De manera opcional, usa captureOrder para cobrarle al cliente antes de enviar el pedido.
Establecer el estado del envío en delivered con updateshipment.

Consulta Cómo usar el recurso de pedidos para obtener más información.

Plantillas de pedidos

Google proporciona las siguientes plantillas de pedidos:

template1: Dos productos o SKU, cantidades de 2 y 1, sin promoción
template1a: Dos productos o SKU, cantidades de 2 y 1, sin promoción
template1b: Dos productos o SKU, cantidades de 2 y 1, promoción específica de producto
template2: Un producto o SKU, cantidad de 2, sin promoción
template3: Un producto o SKU, cantidad de 2, sin promoción, punto de retiro (solo en Francia)

Puedes establecer una plantilla con el parámetro templateName en el método createtestorder.

El recurso orders admite el envío de pedidos con varios productos o SKU en diferentes cantidades.

Para ver el formato de la plantilla, llama a gettestordertemplate con tu ID del comerciante y el nombre de la plantilla que deseas ver.