Batch failing opaquely - entities has no child field masks, read errors via get_operation

Two batch-processing gotchas in one: first, the entities field does not support child field masks - use the top-level entities selector, not entities.id or entities.mentionText, or the request fails. Second, the batch call swallows the real error, so when a batch fails opaquely, poll the operation with get_operation to read the full error message. Fix the mask and read errors from the operation, not the batch response.

Context: Stack Overflow 79640432 (accepted answer): a Document AI batch OCR request kept failing with an unhelpful error. The reporter found two things: the field mask was wrong, and the batch request itself hid the real error.

Matched source

Source: Published skill Original query: "Batch failing opaquely - entities has no child field masks, read errors via get_operation" Key terms: batch, child, entities, errors, failing, field, masks, opaquely, operation, read

Source: Stack Overflow 79640432 (accepted answer): a Document AI batch OCR request kept failing with an unhelpful error. The reporter found two things: the field mask was wrong, and the batch request itself hid the real error.

Verified resolution: Two batch-processing gotchas in one: first, the entities field does not support child field masks - use the top-level entities selector, not entities.id or entities.mentionText, or the request fails. Second, the batch call swallows the real error, so when a batch fails opaquely, poll the operation with get_operation to read the full error message. Fix the mask and read errors from the operation, not the batch response.

Source URL: https://stackoverflow.com/questions/79640432