Actualiza un lote de productos por ID interno o valores de propiedad únicos

Para actualizar varios productos en una sola solicitud, usa sus ID internos o valores de propiedad únicos. Esta operación por lotes permite modificar eficazmente registros de productos especificando las propiedades que se actualizarán. Debes asegurarte de que los valores de propiedad sean coorectos, ya que las propiedades de solo lectura y las no existentes generarán un error.

POST /crm/v3/objects/products/batch/update

Actualiza un lote de productos por ID interno o valores de propiedad únicos

cURL

curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/products/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>",
      "properties": {},
      "idProperty": "my_unique_property_name",
      "objectWriteTraceId": "<string>"
    }
  ]
}
'

200

{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "archived": false,
      "createdAt": "2019-10-30T03:30:17.883Z",
      "id": "512",
      "properties": {
        "property_checkbox": "false",
        "property_date": "1572480000000",
        "property_dropdown": "choice_b",
        "property_multiple_checkboxes": "chocolate;strawberry",
        "property_number": "17",
        "property_radio": "option_1",
        "property_string": "value"
      },
      "updatedAt": "2019-12-07T16:50:06.678Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.

Marketing Hub -Gratuito

Sales Hub -Gratuito

Service Hub -Gratuito

Content Hub -Gratuito

Ámbitos Requeridos

Autorizaciones

oauth2private_apps

Authorization · string · header · requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Cuerpo

application/json

inputs · object[] · requerido

Show child attributes

Respuesta

200

application/json

successful operation

Un objeto de respuesta de lote de objetos públicos

completedAt · string<date-time> · requerido

La marca de tiempo en que se completó el procesamiento por lotes, en formato ISO 8601.

results · object[] · requerido

Show child attributes

startedAt · string<date-time> · requerido

La marca de tiempo en que comenzó el procesamiento por lotes, en formato ISO 8601.

status · enum<string> · requerido

El estado actual de la solicitud de procesamiento por lotes, puede ser "PENDIENTE", "PROCESANDO", "CANCELADO" o "COMPLETADO".

Opciones disponibles: CANCELED, COMPLETE, PENDING, PROCESSING

errors · object[]

Show child attributes

links · object

Un objeto que contiene los enlaces relacionados con la solicitud por lotes.

Show child attributes

numErrors · integer<int32>

El número total de errores que se produjeron durante la operación por lotes.

requestedAt · string<date-time>

La marca de tiempo en la que se realizó inicialmente la solicitud por lotes, en formato ISO 8601.