Crear publicaciones en bloque

Crea muchas publicaciones en redes sociales en una sola solicitud. Las filas se envían en el cuerpo de la solicitud: no se sube ningún archivo ni se usa CSV, solo un array de los mismos objetos que POST /social/posts acepta de uno en uno. Hasta 500 filas por solicitud.

Caso de uso: cargar el contenido de un trimestre en una sola llamada. Tu herramienta de planificación tiene todo el calendario de contenido del cliente. Crea una fila por cada espacio del calendario, etiqueta cada una con tu propio clientReference y envíalas juntas. El lote se procesa correctamente como una unidad o te indica exactamente qué filas debes corregir. Guarda el job.id devuelto y consulta periódicamente GET /social/bulk-posts/{bulkJobId} hasta que status alcance un estado final; después, coteja cada resultado mediante su clientReference.

Todo el lote se valida de antemano

Se validan todas las filas antes de crear nada, y el lote es atómico en esa etapa:

• Si alguna fila no es válida, no se crea nada. success es false, se devuelve SY95050 en error y cada fila incorrecta aparece en job.results[] con su index con base 0, su clientReference y el motivo en errors[]. Corrige esas filas y vuelve a enviar todo el lote.
• Si todas las filas son válidas, se pone un trabajo en cola, success es true y recibes un job.id. Las filas individuales aún pueden fallar más adelante, cuando la plataforma las rechace en el momento de la publicación; esto se refleja en el trabajo, no aquí.

Coteja los resultados mediante clientReference cuando puedas y mediante index en los demás casos: las filas en sí no se devuelven, por lo que esos dos campos son el único vínculo con tus propios datos.

Notas.

• El cuerpo de la solicitud debe estar dentro de un objeto input, con las filas en input.posts.
• Comprueba success, no el estado HTTP. Un rechazo de todo el lote es un HTTP 200 con success: false y SY95050 en error.
• Máximo de 500 filas por solicitud. Un array más grande se rechaza de inmediato con SY95048 y no se crea nada; divídelo y envía varios lotes.
• La marca de cada fila es socialProfileId. brandId solo se usa como token de la ruta de la URL, y esta ruta no tiene ningún token de ruta.
• Las filas pueden estar destinadas a marcas diferentes. Los platforms de cada fila se comprueban con respecto a la marca de esa misma fila, por lo que una plataforma conectada a una marca pero no a otra solo hace que fallen las filas que la necesitan.
• Cada fila sigue las mismas reglas de programación que una publicación individual: scheduledAt o scheduleDate + scheduleTime, nunca ambas opciones, y scheduleDate / scheduleTime se interpretan en la zona horaria de la marca de esa fila. Puedes combinar las dos formas en filas diferentes de un mismo lote.
• Los límites de frecuencia se aplican a la solicitud, no a las filas: un lote de 500 filas consume una solicitud de tu cuota. Consulta Límites de frecuencia.

Operación de escritura: no se ha ejecutado en la cuenta real. La solicitud y la respuesta que se muestran se han generado a partir del esquema de la API; al ejecutarse, esta operación publica en cuentas reales de redes sociales.