Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Lettura da entità di Google Ads
<a name="googleads-reading-from-entities"></a>

 **Prerequisiti** 
+  Un oggetto di Google Ads da cui si desidera leggere. Consulta la tabella delle entità supportate qui di seguito per verificare le entità disponibili. 

 **Entità supportate** 


| Entità | Può essere Filtrato | Supporta Limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | 
| --- | --- | --- | --- | --- | --- | 
| Annuncio gruppo di annunci | Sì  | Sì | Sì | No | Sì | 
| Gruppo di annunci | Sì  | Sì | Sì | No | Sì | 
| Budget campagna | Sì  | Sì | Sì | Sì | Sì | 
| Budget account | Sì | No | Sì | Sì | No | 
| Campagna | Sì  | Sì | Sì | Sì | Sì | 
| Account | Sì | No | Sì | No | No | 

 **Esempio** 

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

 **Dettagli sull'entità e sul campo di Google Ads** 


| Entità | Campo | Tipo di dati | Operatori supportati | 
| --- | --- | --- | --- | 
| Account | resourceName | Stringa | \$1=, = | 
| Account | callReportingEnabled | Booleano | \$1=, = | 
| Account | callConversionReportingAbilitato | Booleano | \$1=, = | 
| Account | callConversionAction | Stringa | \$1=, = | 
| Account | conversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | crossAccountConversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | payPerConversionEligibilityFailureReasons | List |  | 
| Account | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | currencyCode | Stringa | \$1=, =, LIKE | 
| Account | timezone | Stringa | \$1=, =, LIKE | 
| Account | autoTaggingEnabled | Booleano | \$1=, = | 
| Account | hasPartnersBadge | Booleano | \$1=, = | 
| Account | manager | Booleano | \$1=, = | 
| Account | testAccount | Booleano | \$1=, = | 
| Account | data | Data | BETWEEN, =, <, >, <=, >= | 
| Account | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | acceptedCustomerDataTermini | Booleano |  | 
| Account | conversionTrackingStatus | Stringa | \$1=, =, LIKE | 
| Account | enhancedConversionsForLeadsEnabled | Booleano |  | 
| Account | googleAdsConversionCliente | Stringa |  | 
| Account | status | Stringa | \$1=, = | 
| Account | allConversionsByConversionDate | Double | \$1=, =, <, > | 
| Account | allConversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Account | conversionsByConversionData | Double | \$1=, =, <, > | 
| Account | conversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Account | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > | 
| Account | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | clic | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | costPerAllConversioni | Double | \$1=, =, <, > | 
| Account | costPerConversion | Double | \$1=, =, <, > | 
| Account | conversions | Double | \$1=, =, <, > | 
| Account | absoluteTopImpressionPercentuale | Double | \$1=, =, <, > | 
| Account | impression | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | topImpressionPercentage | Double | \$1=, =, <, > | 
| Account | averageCpc | Double | \$1=, =, <, > | 
| Account | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | averageCost | Double | \$1=, =, <, > | 
| Account | ctr | Double | \$1=, =, <, > | 
| Account | activeViewCtr | Double | \$1=, =, <, > | 
| Account | searchImpressionShare | Double | \$1=, =, <, > | 
| Account | conversionAction | Stringa | \$1=, = | 
| Account | conversionActionCategory | Stringa | \$1=, = | 
| Account | conversionActionName | Stringa | \$1=, =, LIKE | 
| Budget account | resourceName | Stringa | \$1=, = | 
| Budget account | status | Stringa | \$1=, = | 
| Budget account | proposedEndTimeTipo | Stringa | \$1=, = | 
| Budget account | approvedEndTimeTipo | Stringa | \$1=, = | 
| Budget account | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget account | billingSetup | Stringa | \$1=, = | 
| Budget account | nome | Stringa | \$1=, =, LIKE | 
| Budget account | approvedStartDateOra |  DateTime | BETWEEN, =, <, <=, >, >= | 
| Budget account | proposedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget account | approvedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget account | adjustedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget account | amountServedMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | resourceName | Stringa | \$1=, =, LIKE | 
| Gruppo di annunci | status | Stringa | \$1=, =, LIKE | 
| Gruppo di annunci | tipo | Stringa | \$1=, =, LIKE | 
| Gruppo di annunci | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | nome | Stringa | \$1=, =, LIKE | 
| Gruppo di annunci | campaign | Stringa | \$1=, = | 
| Gruppo di annunci | cpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | targetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | cpmBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | cpvBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | targetCpmMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | effectiveTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | data | Data | BETWEEN, =, <, >, <=, >= | 
| Gruppo di annunci | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | useAudienceGrouped | Booleano | \$1=, = | 
| Gruppo di annunci | effectiveCpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | allConversionsByConversionDate | Double | \$1=, =, <, > | 
| Gruppo di annunci | allConversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Gruppo di annunci | conversionsByConversionData | Double | \$1=, =, <, > | 
| Gruppo di annunci | conversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Gruppo di annunci | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > | 
| Gruppo di annunci | valuePerConversionsByConversionDate | Double | \$1=, =, <, > | 
| Gruppo di annunci | averageCost | Double | \$1=, =, <, > | 
| Gruppo di annunci | costPerAllConversioni | Double | \$1=, =, <, > | 
| Gruppo di annunci | costPerConversion | Double | \$1=, =, <, > | 
| Gruppo di annunci | averagePageViews | Double | \$1=, =, <, > | 
| Gruppo di annunci | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | clic | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | allConversions | Double | \$1=, =, <, > | 
| Gruppo di annunci | averageCpc | Double | \$1=, =, <, > | 
| Gruppo di annunci | absoluteTopImpressionPercentuale | Double | \$1=, =, <, > | 
| Gruppo di annunci | impression | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Gruppo di annunci | topImpressionPercentage | Double | \$1=, =, <, > | 
| Gruppo di annunci | activeViewCtr | Double | \$1=, =, <, > | 
| Gruppo di annunci | ctr | Double | \$1=, =, <, > | 
| Gruppo di annunci | searchTopImpressionCondividere | Double | \$1=, =, <, > | 
| Gruppo di annunci | searchImpressionShare | Double | \$1=, =, <, > | 
| Gruppo di annunci | searchAbsoluteTopImpressionShare | Double | \$1=, =, <, > | 
| Gruppo di annunci | relativeCtr | Double | \$1=, =, <, > | 
| Gruppo di annunci | conversionAction | Stringa | \$1=, = | 
| Gruppo di annunci | conversionActionCategory | Stringa | \$1=, = | 
| Gruppo di annunci | conversionActionName | Stringa | \$1=, =, LIKE | 
| Gruppo di annunci | updateMask | Stringa |  | 
| Gruppo di annunci | creazione | Struct |  | 
| Gruppo di annunci | aggiorna | Struct |  | 
| Gruppo di annunci | primaryStatus | Stringa | \$1=, = | 
| Gruppo di annunci | primaryStatusReasons | List |  | 
| Annuncio gruppo di annunci | resourceName | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Annuncio gruppo di annunci | status | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | labels | List |  | 
| Annuncio gruppo di annunci | adGroup | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Annuncio gruppo di annunci | approvalStatus | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | reviewStatus | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | adStrength | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | tipo | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | businessName | Stringa | \$1=, =, LIKE | 
| Annuncio gruppo di annunci | data | Data | BETWEEN, =, <, >, <=, >= | 
| Annuncio gruppo di annunci | allConversionsByConversionDate | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | allConversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | conversionsByConversionData | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | conversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | valuePerConversionsByConversionDate | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Annuncio gruppo di annunci | averageCost | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | costPerAllConversioni | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | costPerConversion | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | clic | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Annuncio gruppo di annunci | averagePageViews | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Annuncio gruppo di annunci | allConversions | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | averageCpc | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | topImpressionPercentage | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | impression | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Annuncio gruppo di annunci | absoluteTopImpressionPercentuale | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | activeViewCtr | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | ctr | Double | \$1=, =, <, > | 
| Annuncio gruppo di annunci | conversionAction | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | conversionActionCategory | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | conversionActionName | Stringa | \$1=, =, LIKE | 
| Annuncio gruppo di annunci | updateMask | Stringa |  | 
| Annuncio gruppo di annunci | creazione | Struct |  | 
| Annuncio gruppo di annunci | aggiorna | Struct |  | 
| Annuncio gruppo di annunci | policyValidationParameter | Struct |  | 
| Annuncio gruppo di annunci | primaryStatus | Stringa | \$1=, = | 
| Annuncio gruppo di annunci | primaryStatusReasons | List |  | 
| Campagna | resourceName | Stringa | \$1=, = | 
| Campagna | status | Stringa | \$1=, = | 
| Campagna | baseCampaign | Stringa | \$1=, = | 
| Campagna | nome | Stringa | \$1=, =, LIKE | 
| Campagna | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | campaignBudget | Stringa | \$1=, =, LIKE | 
| Campagna | startDate | Data | BETWEEN, =, <, >, <=, >= | 
| Campagna | endDate | Data | BETWEEN, =, <, >, <=, >= | 
| Campagna | adServingOptimizationStato | Stringa | \$1=, = | 
| Campagna | advertisingChannelType | Stringa | \$1=, = | 
| Campagna | advertisingChannelSubTipo | Stringa | \$1=, = | 
| Campagna | experimentType | Stringa | \$1=, = | 
| Campagna | servingStatus | Stringa | \$1=, = | 
| Campagna | biddingStrategyType | Stringa | \$1=, = | 
| Campagna | domainName | Stringa | \$1=, =, LIKE | 
| Campagna | languageCode | Stringa | \$1=, =, LIKE | 
| Campagna | useSuppliedUrlsSolo | Booleano | \$1=, = | 
| Campagna | positiveGeoTargetTipo | Stringa | \$1=, = | 
| Campagna | negativeGeoTargetTipo | Stringa | \$1=, = | 
| Campagna | paymentMode | Stringa | \$1=, = | 
| Campagna | optimizationGoalTypes | List |  | 
| Campagna | data | Data | BETWEEN, =, <, >, <=, >= | 
| Campagna | averageCost | Double |  | 
| Campagna | clic | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | impression | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | useAudienceGrouped | Booleano | \$1=, = | 
| Campagna | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | costPerAllConversioni | Double | \$1=, =, <, > | 
| Campagna | costPerConversion | Double | \$1=, =, <, > | 
| Campagna | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | publisherPurchasedClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | averagePageViews | Double | \$1=, =, <, > | 
| Campagna | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campagna | allConversionsByConversionDate | Double | \$1=, =, <, > | 
| Campagna | allConversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Campagna | conversionsByConversionData | Double | \$1=, =, <, > | 
| Campagna | conversionsValueByConversionDate | Double | \$1=, =, <, > | 
| Campagna | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > | 
| Campagna | valuePerConversionsByConversionDate | Double | \$1=, =, <, > | 
| Campagna | allConversions | Double | \$1=, =, <, > | 
| Campagna | absoluteTopImpressionPercentuale | Double | \$1=, =, <, > | 
| Campagna | searchAbsoluteTopImpressionShare | Double | \$1=, =, <, > | 
| Campagna | averageCpc | Double | \$1=, =, <, > | 
| Campagna | searchImpressionShare | Double | \$1=, =, <, > | 
| Campagna | searchTopImpressionCondividere | Double | \$1=, =, <, > | 
| Campagna | activeViewCtr | Double | \$1=, =, <, > | 
| Campagna | ctr | Double | \$1=, =, <, > | 
| Campagna | relativeCtr | Double | \$1=, =, <, > | 
| Campagna | updateMask | Stringa |  | 
| Campagna | creazione | Struct |  | 
| Campagna | aggiorna | Struct |  | 
| Budget campagna | resourceName | Stringa | \$1=, = | 
| Budget campagna | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | status | Stringa | \$1=, = | 
| Budget campagna | deliveryMethod | Stringa | \$1=, = | 
| Budget campagna | punto | Stringa | \$1=, = | 
| Budget campagna | tipo | Stringa | \$1=, = | 
| Budget campagna | nome | Stringa | \$1=, =, LIKE | 
| Budget campagna | amountMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | explicitlyShared | Booleano | \$1=, = | 
| Budget campagna | referenceCount | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | hasRecommendedBudget | Booleano | \$1=, = | 
| Budget campagna | data | Data | BETWEEN, =, <, >, <=, >= | 
| Budget campagna | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | startDate | Data | BETWEEN, =, <, >, <=, >= | 
| Budget campagna | endDate | Data | BETWEEN, =, <, >, <=, >= | 
| Budget campagna | maximizeConversionValueTargetRoas | Double | \$1=, =, <, > | 
| Budget campagna | maximizeConversionsTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | selectiveOptimizationConversionAzioni | Stringa |  | 
| Budget campagna | averageCost | Double | \$1=, =, <, > | 
| Budget campagna | costPerAllConversioni | Double | \$1=, =, <, > | 
| Budget campagna | costPerConversion | Double | \$1=, =, <, > | 
| Budget campagna | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | allConversions | Double | \$1=, =, <, > | 
| Budget campagna | valuePerAllConversioni | Double | \$1=, =, <, > | 
| Budget campagna | averageCpc | Double | \$1=, =, <, > | 
| Budget campagna | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Budget campagna | ctr | Double | \$1=, =, <, > | 
| Budget campagna | updateMask | Stringa |  | 
| Budget campagna | creazione | Struct |  | 
| Budget campagna | aggiorna | Struct |  | 

 **Query di partizionamento** 

 Se si desidera utilizzare la simultaneità in Spark, possono essere fornite opzioni Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND`, `NUM_PARTITIONS` aggiuntive. Con questi parametri, la query originale viene suddivisa in `NUM_PARTITIONS` query secondarie che possono essere eseguite contemporaneamente dalle attività Spark. 
+  `PARTITION_FIELD`: il nome del campo da utilizzare per partizionare la query. 
+  `LOWER_BOUND`: un valore limite inferiore inclusivo del campo di partizione scelto. 

   Per la data, accettiamo il formato di data di Spark utilizzato nelle query di Spark SQL. Esempio di valori validi: `"2024-02-06"`. 
+  `UPPER_BOUND`: un valore limite superiore esclusivo del campo di partizione scelto. 
+  `NUM_PARTITIONS`: numero di partizioni. 

 I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella seguente. 


| Nome entità | Campo di partizionamento | Tipo di dati | 
| --- | --- | --- | 
| Annuncio gruppo di annunci | data | Data | 
| Gruppo di annunci | data | Data | 
| Campagna | data | Data | 
| Budget campagna | data | Data | 

 **Esempio** 

```
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"
    }
)
```