Obter um trabalho de publicação em lote

Fornece informações sobre um trabalho criado por POST /social/bulk-posts. Consulte-o periodicamente até que status atinja um valor terminal e, então, leia results[] para descobrir o resultado de cada linha.

Caso de uso: conciliar uma carga em lote com seu próprio calendário. Depois de enviar um lote, consulte este endpoint a cada poucos segundos. Quando status estiver em um estado terminal, percorra results[] e associe o clientReference de cada entrada ao seu próprio registro, gravando socialPostId nele. As linhas com status: "FAILED" contêm o motivo em errors[]; reenvie apenas essas linhas em um novo lote.

Caso de uso: uma barra de progresso. Comparar processedCount com totalCount é suficiente para alimentar uma barra de progresso sem precisar percorrer results[], e successCount / failureCount fornecem o resumo assim que o trabalho termina.

Status do trabalho

Observações.

• clientReference é o valor que você enviou naquela linha, retornado sem alterações. É a forma mais direta de vincular o resultado aos seus próprios dados; index, a posição da linha no array que você enviou, com índice começando em 0, é a alternativa quando você não enviou nenhum valor.
• Uma linha atingir status: "CREATED" significa que a publicação existe, não que ela já tenha sido publicada — postStatus informa em que estado a própria publicação está. As linhas PUBLISH e SCHEDULE ainda passam pelo fluxo assíncrono de publicação depois disso: consulte cada socialPostId em GET /social/posts/{postId} e leia channels[] para obter o resultado real por canal.
• Um trabalho em que todas as linhas falhassem na validação nem sequer teria sido criado, porque a criação em lote rejeita o lote antes de colocá-lo na fila. Um trabalho FAILED aqui significa que o trabalho falhou depois de ser aceito.
• updatedAt muda à medida que as linhas são processadas; ele se estabiliza quando o trabalho atinge um estado terminal.