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

**Requisito previo**

Un objeto de Anuncios de Facebook 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 | 
| Adaccounts | 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:**

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

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

Para obtener más información acerca de las entidades y los detalles de los campos, consulte:
+ [Cuenta de anuncios](https://developers.facebook.com/docs/marketing-api/reference/ad-account)
+ [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)
+ [Información: cuenta de anuncios](https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights)
+ [Información: anuncios](https://developers.facebook.com/docs/marketing-api/reference/adgroup/insights/)
+ [Información: conjunto de anuncios](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/insights)
+ [Información: campañas](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="facebook-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-01"
  ```
+ `UPPER_BOUND`: un valor límite superior **exclusivo** del campo de partición elegido.
+ `NUM_PARTITIONS`: el número de particiones.

Ejemplo:

```
FacebookADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="FacebookAds",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01"
        "UPPER_BOUND": "2024-01-02"
        "NUM_PARTITIONS": "10"
    }
```