Comienza a usar los Servicios de comparación de productos (CSS)

Realizar operaciones básicas con la API es una buena manera de comenzar a usarla.

Requisitos previos

Antes de comenzar, completa los siguientes pasos:

  • Asegúrate de tener una cuenta de CSS Center válida.
  • Registra un desarrollador de API.
  • Verifica que la configuración de permisos sea correcta.
  • Verifica que hayas habilitado la API de CSS.
  • Verifica que hayas instalado las bibliotecas cliente para tu entorno.

Para obtener más información, consulta la guía de inicio rápido.

Habilita la API de CSS

Para registrarte como desarrollador y usar la API de CSS, debes vincular tu cuenta de CSS Center y tu proyecto de Google Cloud con el método de registro de desarrollador, de la siguiente manera:

Vincula CSS Center y tu proyecto de Google Cloud: La vinculación se establece automáticamente, ya que el llamador tiene acceso al proyecto de Google Cloud según el token de acceso o la clave de API, y es un usuario autorizado de la cuenta de CSS Center.

Registra un desarrollador de API

Agrega un usuario desarrollador de la API a la cuenta de CSS Center: Si ya existe un usuario, solo se le otorgará el nuevo tipo de acceso "Desarrollador de la API". En el caso de un usuario nuevo, este recibe una invitación por correo electrónico de CSS Center.

Después del registro, puedes ver el estado con GetDeveloperRegistration o cancelar el registro con UnregisterGCP. Puedes usar la siguiente llamada de registro:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Después de que la solicitud se ejecute correctamente, espera la siguiente respuesta:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Productos de CSS

Al igual que la sub-API de Products, la API de CSS distingue entre CssProductInput y ListCssProduct. Inserta un producto con InsertCssProductInput.

Una vez que nuestros sistemas internos hayan procesado el producto (lo que puede tardar unos minutos), recupéralo con ListCssProducts.

Identifica tus productos con raw_provided_id. Te recomendamos que uses un identificador que ya utilices en tu propio sistema. Como alternativa, los métodos comunes para crear uno incluyen el uso de uno de los siguientes elementos:

  • Identificadores únicos globales (GUID)
  • Identificadores únicos universales (UUID)
  • Atributos de producto únicos concatenados (por ejemplo, marca_modelo_color_tamaño)

Para obtener más información, consulta Cómo insertar, enumerar, actualizar o borrar un producto.

Operaciones básicas

Estas son algunas solicitudes básicas que puedes probar.

  1. Inserta un producto de prueba con InsertCssProductInput. Para obtener ayuda sobre los atributos que debes enviar, revisa este código de muestra.

  2. Enumera todos tus productos con ListCssProducts. Ten en cuenta que hay una pequeña demora en el procesamiento entre la inserción de un producto y su aparición en la ficha. Si no ves uno de inmediato, vuelve a intentarlo después de unos segundos.

  3. Actualiza un solo producto con UpdateCssProductInput usando tu cssproductinput.name. Solo debes enviar los atributos que se deben actualizar. Para ver un ejemplo, consulta el código de muestra.

  4. Borra el producto de prueba con DeleteCssProductInpu y proporciona el raw_provided_id.

Limitaciones

Insertar o borrar un producto individual puede ser un proceso lento. Para mejorar el rendimiento, utiliza Async para mejorar el rendimiento. Esto permite llamar a la API en paralelo.

Enumera y etiqueta tus cuentas

La administración de etiquetas en la API de CSS te permite organizar de forma programática tus cuentas de cliente de Merchant Center con etiquetas personalizadas. Esta función te ayuda a categorizar a los clientes de manera eficiente (por ejemplo, por tipo o estrategia), lo que permite una mejor organización y operaciones optimizadas. Puedes usar la API para realizar las siguientes funciones en las etiquetas: