Consultar el estado de una carga masiva de fotos

Consulta el estado de una carga masiva asíncrona de fotos. Cuando un lote es lo suficientemente grande, añadir fotos de la ubicación lo procesa en segundo plano y devuelve un requestId en el objeto request en lugar de los archivos multimedia ya procesados. El tamaño del lote que activa este comportamiento depende de la configuración del servidor, no de una constante publicada, así que determina qué caso se aplica comprobando si se ha devuelto request.requestId, no contando tus propias imágenes. Consulta periódicamente este endpoint con ese requestId hasta que el trabajo alcance un estado final.

Caso de uso: actualizar una barra de progreso de carga. Después de cargar un lote grande, consulta el estado cada pocos segundos mientras status sea PROCESSING. Cuando cambie a SUCCESS o ERROR, lee el array photos para obtener el resultado de cada imagen: cada entrada incluye el mediaId resultante (si se procesa correctamente) junto con un par status/errorMessage para que puedas mostrar exactamente qué archivos se rechazaron y por qué (dimensiones incorrectas, formato no compatible, etc.), en lugar de hacer que falle todo el lote.

Valores de estado: PROCESSING (el procesamiento sigue en curso: vuelve a consultar), SUCCESS (el trabajo terminó de procesarse), ERROR (el propio trabajo falló; examina photos[].errorMessage).

El estado status del trabajo solo indica que el procesamiento terminó, no que todas las imágenes se procesaron correctamente. Un trabajo con estado SUCCESS puede contener fotos rechazadas, como en el ejemplo anterior. Cuando el trabajo deje de estar en PROCESSING, recorre photos[] y lee los valores status y errorMessage de cada entrada para averiguar qué imágenes se cargaron correctamente.

Precaución al consultar periódicamente: deja un tiempo de espera entre consultas: un bucle sin pausas contra este endpoint puede hacer que alcances 429 rápidamente. Respeta el encabezado Retry-After y opta por un intervalo de unos pocos segundos. Un requestId desconocido o caducado no se podrá resolver, así que consulta únicamente los IDs devueltos por una llamada de carga reciente.