# Lectura desde entidades de Anuncios de Instagram
<a name="instagram-ads-reading-from-entities"></a>

**Requisito previo**

Un objeto de Anuncios de Instagram desde el cual le gustaría leer. Necesitará el nombre del objeto. En las siguientes tablas se muestran las entidades admitidas.

**Entidades compatibles como origen:**


| Entidad | Se puede filtrar | Admite límite | Admite Ordenar por | Admite Seleccionar \$1 | Admite partición | 
| --- | --- | --- | --- | --- | --- | 
| Campaña | Sí | Sí | No | Sí | Sí | 
| Conjunto de anuncios | Sí | Sí | No | Sí | Sí | 
| Anuncios | Sí | Sí | No | Sí | Sí | 
| Creatividad de anuncios | No | Sí | No | Sí | No | 
| Información: cuenta | No | Sí | No | Sí | No | 
| Imagen del anuncio | Sí | Sí | No | Sí | No | 
| Información: anuncio | Sí | Sí | No | Sí | Sí | 
| Información: conjunto de anuncios | Sí | Sí | No | Sí | Sí | 
| Información: campaña | Sí | Sí | No | Sí | Sí | 

**Ejemplo:**

```
instagramAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0"
    }
```

## Detalles de la entidad y el campo de Anuncios de Instagram
<a name="instagram-ads-reading-entity-and-field-details"></a>

Para obtener más información acerca de las entidades y los detalles de los campos, consulte:
+ [Campaña](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group)
+ [Conjunto de anuncios](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign)
+ [Anuncio](https://developers.facebook.com/docs/marketing-api/reference/adgroup)
+ [Creatividad de anuncios](https://developers.facebook.com/docs/marketing-api/reference/ad-creative)
+ [Ad Account Insight](https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights)
+ [Ad Image](https://developers.facebook.com/docs/marketing-api/reference/ad-image)
+ [Ad Insights](https://developers.facebook.com/docs/marketing-api/reference/adgroup/insights/)
+ [AdSets Insights](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/insights)
+ [Campaigns Insights](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/insights)

Para obtener más información, consulte [API de marketing](https://developers.facebook.com/docs/marketing-api/reference/v21.0).

**nota**  
Los tipos de datos de estructura y lista se convierten en tipos de datos de cadena en respuesta a los conectores.

## Consultas de particionamiento
<a name="instagram-ads-reading-partitioning-queries"></a>

Puede proporcionar las opciones adicionales de Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` y `NUM_PARTITIONS` si quiere utilizar la simultaneidad en Spark. Con estos parámetros, la consulta original se dividiría en un número `NUM_PARTITIONS` de subconsultas que las tareas de Spark pueden ejecutar simultáneamente.
+ `PARTITION_FIELD`: el nombre del campo que se utilizará para particionar la consulta.
+ `LOWER_BOUND`: un valor de límite inferior **inclusivo** del campo de partición elegido.

  En el campo DateTime, aceptamos el formato de marca de tiempo de Spark que se utiliza en las consultas de Spark SQL.

  Ejemplo de valor válido:

  ```
  "2022-01-01T00:00:00.000Z"
  ```
+ `UPPER_BOUND`: un valor límite superior **exclusivo** del campo de partición elegido.

  Ejemplo de valor válido:

  ```
  "2024-01-02T00:00:00.000Z"
  ```
+ `NUM_PARTITIONS`: el número de particiones.

Ejemplo:

```
instagramADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01T00:00:00.000Z"
        "UPPER_BOUND": "2024-01-02T00:00:00.000Z"
        "NUM_PARTITIONS": "10"
    }
```