# Leitura de entidades do Google Ads
<a name="googleads-reading-from-entities"></a>

 **Pré-requisitos** 
+  Um objeto do Google Ads do qual você deseja ler. Consulte a tabela de entidades compatíveis abaixo para verificar as entidades disponíveis. 

 **Entidades compatíveis** 


| Entidade | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \$1 | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | 
| Anúncio de grupo de anúncios | Sim | Sim | Sim | Não | Sim | 
| Grupo de anúncios | Sim | Sim | Sim | Não | Sim | 
| Orçamento da campanha | Sim | Sim | Sim | Sim | Sim | 
| Orçamento da conta | Sim | Não | Sim | Sim | Não | 
| Campaign | Sim | Sim | Sim | Sim | Sim | 
| Conta | Sim | Não | Sim | Não | Não | 

 **Exemplo** 

```
googleAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="googleads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "campaign-3467***",
        "API_VERSION": "v16"
    }
```

 **Detalhes das entidades e dos campos do Google Ads** 


| Entidade | Campo | Tipo de dado | Operadores com suporte | 
| --- | --- | --- | --- | 
| Conta | resourceName | String | \$1=, = | 
| Conta | callReportingEnabled | Booleano | \$1=, = | 
| Conta | callConversionReportingEnabled | Booleano | \$1=, = | 
| Conta | callConversionAction | String | \$1=, = | 
| Conta | conversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | crossAccountConversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | payPerConversionEligibilityFailureReasons | Lista |  | 
| Conta | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | currencyCode | String | \$1=, =, LIKE | 
| Conta | timeZone | String | \$1=, =, LIKE | 
| Conta | autoTaggingEnabled | Booleano | \$1=, = | 
| Conta | hasPartnersBadge | Booleano | \$1=, = | 
| Conta | manager | Booleano | \$1=, = | 
| Conta | testAccount | Booleano | \$1=, = | 
| Conta | date | Data | BETWEEN, =, <, >, <=, >= | 
| Conta | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | acceptedCustomerDataTerms | Booleano |  | 
| Conta | conversionTrackingStatus | String | \$1=, =, LIKE | 
| Conta | enhancedConversionsForLeadsEnabled | Booleano |  | 
| Conta | googleAdsConversionCustomer | String |  | 
| Conta | status | String | \$1=, = | 
| Conta | allConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Conta | allConversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Conta | conversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Conta | conversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Conta | valuePerAllConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Conta | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | cliques | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | costPerAllConversions | Duplo | \$1=, =, <, > | 
| Conta | costPerConversion | Duplo | \$1=, =, <, > | 
| Conta | conversões | Duplo | \$1=, =, <, > | 
| Conta | absoluteTopImpressionPercentage | Duplo | \$1=, =, <, > | 
| Conta | impressões | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | topImpressionPercentage | Duplo | \$1=, =, <, > | 
| Conta | averageCpc | Duplo | \$1=, =, <, > | 
| Conta | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Conta | averageCost | Duplo | \$1=, =, <, > | 
| Conta | ctr | Duplo | \$1=, =, <, > | 
| Conta | activeViewCtr | Duplo | \$1=, =, <, > | 
| Conta | searchImpressionShare | Duplo | \$1=, =, <, > | 
| Conta | conversionAction | String | \$1=, = | 
| Conta | conversionActionCategory | String | \$1=, = | 
| Conta | conversionActionName | String | \$1=, =, LIKE | 
| Orçamento da conta | resourceName | String | \$1=, = | 
| Orçamento da conta | status | String | \$1=, = | 
| Orçamento da conta | proposedEndTimeType | String | \$1=, = | 
| Orçamento da conta | approvedEndTimeType | String | \$1=, = | 
| Orçamento da conta | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da conta | billingSetup | String | \$1=, = | 
| Orçamento da conta | nome | String | \$1=, =, LIKE | 
| Orçamento da conta | approvedStartDateTime |  DateTime | BETWEEN, =, <, >, <=, >= | 
| Orçamento da conta | proposedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da conta | approvedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da conta | adjustedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da conta | amountServedMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | resourceName | String | \$1=, =, LIKE | 
| Grupo de anúncios | status | String | \$1=, =, LIKE | 
| Grupo de anúncios | type | String | \$1=, =, LIKE | 
| Grupo de anúncios | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | nome | String | \$1=, =, LIKE | 
| Grupo de anúncios | campaign | String | \$1=, = | 
| Grupo de anúncios | cpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | targetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | cpmBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | cpvBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | targetCpmMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | effectiveTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | date | Data | BETWEEN, =, <, >, <=, >= | 
| Grupo de anúncios | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | useAudienceGrouped | Booleano | \$1=, = | 
| Grupo de anúncios | effectiveCpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | allConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | allConversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | conversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | conversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | valuePerAllConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | valuePerConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | averageCost | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | costPerAllConversions | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | costPerConversion | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | averagePageViews | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | cliques | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | allConversions | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | averageCpc | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | absoluteTopImpressionPercentage | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | impressões | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Grupo de anúncios | topImpressionPercentage | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | activeViewCtr | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | ctr | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | searchTopImpressionShare | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | searchImpressionShare | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | searchAbsoluteTopImpressionShare | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | relativeCtr | Duplo | \$1=, =, <, > | 
| Grupo de anúncios | conversionAction | String | \$1=, = | 
| Grupo de anúncios | conversionActionCategory | String | \$1=, = | 
| Grupo de anúncios | conversionActionName | String | \$1=, =, LIKE | 
| Grupo de anúncios | updateMask | String |  | 
| Grupo de anúncios | criar | Struct |  | 
| Grupo de anúncios | atualizar | Struct |  | 
| Grupo de anúncios | primaryStatus | String | \$1=, = | 
| Grupo de anúncios | primaryStatusReasons | Lista |  | 
| Anúncio de grupo de anúncios | resourceName | String | \$1=, = | 
| Anúncio de grupo de anúncios | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Anúncio de grupo de anúncios | status | String | \$1=, = | 
| Anúncio de grupo de anúncios | rótulos | Lista |  | 
| Anúncio de grupo de anúncios | adGroup | String | \$1=, = | 
| Anúncio de grupo de anúncios | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Anúncio de grupo de anúncios | approvalStatus | String | \$1=, = | 
| Anúncio de grupo de anúncios | reviewStatus | String | \$1=, = | 
| Anúncio de grupo de anúncios | adStrength | String | \$1=, = | 
| Anúncio de grupo de anúncios | type | String | \$1=, = | 
| Anúncio de grupo de anúncios | businessName | String | \$1=, =, LIKE | 
| Anúncio de grupo de anúncios | date | Data | BETWEEN, =, <, >, <=, >= | 
| Anúncio de grupo de anúncios | allConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | allConversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | conversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | conversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | valuePerAllConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | valuePerConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Anúncio de grupo de anúncios | averageCost | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | costPerAllConversions | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | costPerConversion | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | cliques | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Anúncio de grupo de anúncios | averagePageViews | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Anúncio de grupo de anúncios | allConversions | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | averageCpc | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | topImpressionPercentage | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | impressões | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Anúncio de grupo de anúncios | absoluteTopImpressionPercentage | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | activeViewCtr | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | ctr | Duplo | \$1=, =, <, > | 
| Anúncio de grupo de anúncios | conversionAction | String | \$1=, = | 
| Anúncio de grupo de anúncios | conversionActionCategory | String | \$1=, = | 
| Anúncio de grupo de anúncios | conversionActionName | String | \$1=, =, LIKE | 
| Anúncio de grupo de anúncios | updateMask | String |  | 
| Anúncio de grupo de anúncios | criar | Struct |  | 
| Anúncio de grupo de anúncios | atualizar | Struct |  | 
| Anúncio de grupo de anúncios | policyValidationParameter | Struct |  | 
| Anúncio de grupo de anúncios | primaryStatus | String | \$1=, = | 
| Anúncio de grupo de anúncios | primaryStatusReasons | Lista |  | 
| Campaign | resourceName | String | \$1=, = | 
| Campaign | status | String | \$1=, = | 
| Campaign | baseCampaign | String | \$1=, = | 
| Campaign | nome | String | \$1=, =, LIKE | 
| Campaign | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | campaignBudget | String | \$1=, =, LIKE | 
| Campaign | startDate | Data | BETWEEN, =, <, >, <=, >= | 
| Campaign | endDate | Data | BETWEEN, =, <, >, <=, >= | 
| Campaign | adServingOptimizationStatus | String | \$1=, = | 
| Campaign | advertisingChannelType | String | \$1=, = | 
| Campaign | advertisingChannelSubType | String | \$1=, = | 
| Campaign | experimentType | String | \$1=, = | 
| Campaign | servingStatus | String | \$1=, = | 
| Campaign | biddingStrategyType | String | \$1=, = | 
| Campaign | domainName | String | \$1=, =, LIKE | 
| Campaign | languageCode | String | \$1=, =, LIKE | 
| Campaign | useSuppliedUrlsOnly | Booleano | \$1=, = | 
| Campaign | positiveGeoTargetType | String | \$1=, = | 
| Campaign | negativeGeoTargetType | String | \$1=, = | 
| Campaign | paymentMode | String | \$1=, = | 
| Campaign | optimizationGoalTypes | Lista |  | 
| Campaign | date | Data | BETWEEN, =, <, >, <=, >= | 
| Campaign | averageCost | Duplo |  | 
| Campaign | cliques | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | impressões | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | useAudienceGrouped | Booleano | \$1=, = | 
| Campaign | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | costPerAllConversions | Duplo | \$1=, =, <, > | 
| Campaign | costPerConversion | Duplo | \$1=, =, <, > | 
| Campaign | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | publisherPurchasedClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | averagePageViews | Duplo | \$1=, =, <, > | 
| Campaign | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign | allConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Campaign | allConversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Campaign | conversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Campaign | conversionsValueByConversionDate | Duplo | \$1=, =, <, > | 
| Campaign | valuePerAllConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Campaign | valuePerConversionsByConversionDate | Duplo | \$1=, =, <, > | 
| Campaign | allConversions | Duplo | \$1=, =, <, > | 
| Campaign | absoluteTopImpressionPercentage | Duplo | \$1=, =, <, > | 
| Campaign | searchAbsoluteTopImpressionShare | Duplo | \$1=, =, <, > | 
| Campaign | averageCpc | Duplo | \$1=, =, <, > | 
| Campaign | searchImpressionShare | Duplo | \$1=, =, <, > | 
| Campaign | searchTopImpressionShare | Duplo | \$1=, =, <, > | 
| Campaign | activeViewCtr | Duplo | \$1=, =, <, > | 
| Campaign | ctr | Duplo | \$1=, =, <, > | 
| Campaign | relativeCtr | Duplo | \$1=, =, <, > | 
| Campaign | updateMask | String |  | 
| Campaign | criar | Struct |  | 
| Campaign | atualizar | Struct |  | 
| Orçamento da campanha | resourceName | String | \$1=, = | 
| Orçamento da campanha | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | status | String | \$1=, = | 
| Orçamento da campanha | deliveryMethod | String | \$1=, = | 
| Orçamento da campanha | período | String | \$1=, = | 
| Orçamento da campanha | type | String | \$1=, = | 
| Orçamento da campanha | nome | String | \$1=, =, LIKE | 
| Orçamento da campanha | amountMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | explicitlyShared | Booleano | \$1=, = | 
| Orçamento da campanha | referenceCount | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | hasRecommendedBudget | Booleano | \$1=, = | 
| Orçamento da campanha | date | Data | BETWEEN, =, <, >, <=, >= | 
| Orçamento da campanha | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | startDate | Data | BETWEEN, =, <, >, <=, >= | 
| Orçamento da campanha | endDate | Data | BETWEEN, =, <, >, <=, >= | 
| Orçamento da campanha | maximizeConversionValueTargetRoas | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | maximizeConversionsTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | selectiveOptimizationConversionActions | String |  | 
| Orçamento da campanha | averageCost | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | costPerAllConversions | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | costPerConversion | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | cliques | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | allConversions | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | valuePerAllConversions | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | averageCpc | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | impressões | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Orçamento da campanha | ctr | Duplo | \$1=, =, <, > | 
| Orçamento da campanha | updateMask | String |  | 
| Orçamento da campanha | criar | Struct |  | 
| Orçamento da campanha | atualizar | Struct |  | 

 **Particionamento de consultas** 

 Podem ser fornecidas as opções adicionais do Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se você quiser utilizar a simultaneidade no Spark. Com esses parâmetros, a consulta original seria dividida em `NUM_PARTITIONS` subconsultas, que poderiam ser executadas pelas tarefas do Spark simultaneamente. 
+  `PARTITION_FIELD`: o nome do campo a ser usado para particionar a consulta. 
+  `LOWER_BOUND`: um valor limite inferior inclusivo do campo de partição escolhido. 

   Na data, aceitamos o formato de data do Spark usado em consultas SQL do Spark. Exemplo de valores válidos: `"2024-02-06"`. 
+  `UPPER_BOUND`: um valor limite superior exclusivo do campo de partição escolhido. 
+  `NUM_PARTITIONS`: número de partições. 

 Os detalhes do suporte do campo de particionamento relativo às entidades são capturados na tabela a seguir. 


| Entity Name | Campo de particionamento | Tipo de dado | 
| --- | --- | --- | 
| Anúncio de grupo de anúncios | date | Data | 
| Grupo de anúncios | date | Data | 
| Campaign | date | Data | 
| Orçamento da campanha | date | Data | 

 **Exemplo** 

```
googleads_read = glueContext.create_dynamic_frame.from_options(
    connection_type="googleads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "campaign-3467***",
        "API_VERSION": "v16",
        "PARTITION_FIELD": "date"
        "LOWER_BOUND": "2024-01-01"
        "UPPER_BOUND": "2024-06-05"
        "NUM_PARTITIONS": "10"
    }
)
```