Plantillas de nombres de archivo

Aprende a especificar nombres de archivo para los resultados entregados a tu almacenamiento en la nube.

De forma predeterminada, los archivos de resultados entregados a tu almacenamiento en la nube usan la {{ job_id }}.{{ extension }} plantilla de nombres (p. ej., 7346445033316311041.json). Puedes especificar una plantilla personalizada para nombrar archivos para los resultados entregados a tu almacenamiento en la nube.

Aquí tienes por qué podrías querer hacerlo:

• Los nombres de los archivos de resultados pueden ser más informativos
• Los resultados pueden organizarse automáticamente en diferentes directorios.

Variables de plantilla

Puedes usar cualquier parámetro de entrada que proporciones al crear un trabajo, así como cualquier variable del objeto job devuelto con tus resultados (por ejemplo job_id, source, created_at) en tu plantilla de nombres de archivos. El storage_url campo de la respuesta del job muestra la ruta resuelta, así que puedes comprobar una plantilla sin esperar a la carga.

Uso

1

Ejemplo 1: Nombre de archivo personalizado con múltiples variables

Escribe el resultado en oxylabs.test/google_search_test_7336001481897673729.json

{
    "source": "google_search",
    "query": "test",
    "storage_type": "s3",
    "storage_url": "oxylabs.test/{{ source }}_{{ query }}_{{ job_id }}.{{ extension }}"
}

2

Ejemplo 2: Organización de directorios

Escribe el resultado en oxylabs.test/google_search/7336001481897673729.json

{
    "source": "google_search",
    "query": "test",
    "storage_type": "s3",
    "storage_url": "oxylabs.test/{{ source }}/"
}

3

Ejemplo 3: Directorio personalizado con nombre de archivo personalizado

Escribe el resultado en oxylabs.test/google_search/oxylabs_test_7336001481897673729.json

{
    "source": "google_search",
    "query": "test",
    "storage_type": "s3",
    "storage_url": "oxylabs.test/{{ source }}/oxylabs_{{ query }}_{{ job_id }}.{{ extension }}"
}