Lectura desde entidades de Google Ads

Requisitos previos

• Un objeto de Google Ads desde el cual le gustaría leer. Consulte la tabla de entidades compatibles que aparece a continuación para comprobar las entidades disponibles.

Entidades compatibles

Entidad	Se puede filtrar	Admite límite	Admite Ordenar por	Admite Seleccionar *	Admite Partición
Anuncio de grupo de anuncios	Sí	Sí	Sí	No	Sí
Grupo de anuncios	Sí	Sí	Sí	No	Sí
Presupuesto de campaña	Sí	Sí	Sí	Sí	Sí
Presupuesto de cuenta	Sí	No	Sí	Sí	No
Campaña	Sí	Sí	Sí	Sí	Sí
Cuenta	Sí	No	Sí	No	No

Ejemplo

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

Detalles de la entidad y el campo de Google Ads

Entidad	Campo	Tipo de datos	Operadores admitidos
Cuenta	resourceName	Cadena	!=, =
Cuenta	callReportingEnabled	Booleano	!=, =
Cuenta	callConversionReportingEnabled	Booleano	!=, =
Cuenta	callConversionAction	Cadena	!=, =
Cuenta	conversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	crossAccountConversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	payPerConversionEligibilityFailureReasons	Enumeración
Cuenta	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	currencyCode	Cadena	!=, =, LIKE
Cuenta	timeZone	Cadena	!=, =, LIKE
Cuenta	autoTaggingEnabled	Booleano	!=, =
Cuenta	hasPartnersBadge	Booleano	!=, =
Cuenta	manager	Booleano	!=, =
Cuenta	testAccount	Booleano	!=, =
Cuenta	date	Date	BETWEEN, =, <, >, <=, >=
Cuenta	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	acceptedCustomerDataTerms	Booleano
Cuenta	conversionTrackingStatus	Cadena	!=, =, LIKE
Cuenta	enhancedConversionsForLeadsEnabled	Booleano
Cuenta	googleAdsConversionCustomer	Cadena
Cuenta	status	Cadena	!=, =
Cuenta	allConversionsByConversionDate	Doble	!=, =, <, >
Cuenta	allConversionsValueByConversionDate	Doble	!=, =, <, >
Cuenta	conversionsByConversionDate	Doble	!=, =, <, >
Cuenta	conversionsValueByConversionDate	Doble	!=, =, <, >
Cuenta	valuePerAllConversionsByConversionDate	Doble	!=, =, <, >
Cuenta	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	costPerAllConversions	Doble	!=, =, <, >
Cuenta	costPerConversion	Doble	!=, =, <, >
Cuenta	conversions	Doble	!=, =, <, >
Cuenta	absoluteTopImpressionPercentage	Doble	!=, =, <, >
Cuenta	impresiones	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	topImpressionPercentage	Doble	!=, =, <, >
Cuenta	averageCpc	Doble	!=, =, <, >
Cuenta	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Cuenta	averageCost	Doble	!=, =, <, >
Cuenta	ctr	Doble	!=, =, <, >
Cuenta	activeViewCtr	Doble	!=, =, <, >
Cuenta	searchImpressionShare	Doble	!=, =, <, >
Cuenta	conversionAction	Cadena	!=, =
Cuenta	conversionActionCategory	Cadena	!=, =
Cuenta	conversionActionName	Cadena	!=, =, LIKE
Presupuesto de cuenta	resourceName	Cadena	!=, =
Presupuesto de cuenta	status	Cadena	!=, =
Presupuesto de cuenta	proposedEndTimeType	Cadena	!=, =
Presupuesto de cuenta	approvedEndTimeType	Cadena	!=, =
Presupuesto de cuenta	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de cuenta	billingSetup	Cadena	!=, =
Presupuesto de cuenta	nombre	Cadena	!=, =, LIKE
Presupuesto de cuenta	approvedStartDateTime	DateTime	BETWEEN, =, <, >, <=, >=
Presupuesto de cuenta	proposedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de cuenta	approvedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de cuenta	adjustedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de cuenta	amountServedMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	resourceName	Cadena	!=, =, LIKE
Grupo de anuncios	status	Cadena	!=, =, LIKE
Grupo de anuncios	type	Cadena	!=, =, LIKE
Grupo de anuncios	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	nombre	Cadena	!=, =, LIKE
Grupo de anuncios	campaña	Cadena	!=, =
Grupo de anuncios	cpcBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	targetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	cpmBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	cpvBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	targetCpmMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	effectiveTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	date	Date	BETWEEN, =, <, >, <=, >=
Grupo de anuncios	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	useAudienceGrouped	Booleano	!=, =
Grupo de anuncios	effectiveCpcBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	allConversionsByConversionDate	Doble	!=, =, <, >
Grupo de anuncios	allConversionsValueByConversionDate	Doble	!=, =, <, >
Grupo de anuncios	conversionsByConversionDate	Doble	!=, =, <, >
Grupo de anuncios	conversionsValueByConversionDate	Doble	!=, =, <, >
Grupo de anuncios	valuePerAllConversionsByConversionDate	Doble	!=, =, <, >
Grupo de anuncios	valuePerConversionsByConversionDate	Doble	!=, =, <, >
Grupo de anuncios	averageCost	Doble	!=, =, <, >
Grupo de anuncios	costPerAllConversions	Doble	!=, =, <, >
Grupo de anuncios	costPerConversion	Doble	!=, =, <, >
Grupo de anuncios	averagePageViews	Doble	!=, =, <, >
Grupo de anuncios	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	allConversions	Doble	!=, =, <, >
Grupo de anuncios	averageCpc	Doble	!=, =, <, >
Grupo de anuncios	absoluteTopImpressionPercentage	Doble	!=, =, <, >
Grupo de anuncios	impresiones	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Grupo de anuncios	topImpressionPercentage	Doble	!=, =, <, >
Grupo de anuncios	activeViewCtr	Doble	!=, =, <, >
Grupo de anuncios	ctr	Doble	!=, =, <, >
Grupo de anuncios	searchTopImpressionShare	Doble	!=, =, <, >
Grupo de anuncios	searchImpressionShare	Doble	!=, =, <, >
Grupo de anuncios	searchAbsoluteTopImpressionShare	Doble	!=, =, <, >
Grupo de anuncios	relativeCtr	Doble	!=, =, <, >
Grupo de anuncios	conversionAction	Cadena	!=, =
Grupo de anuncios	conversionActionCategory	Cadena	!=, =
Grupo de anuncios	conversionActionName	Cadena	!=, =, LIKE
Grupo de anuncios	updateMask	Cadena
Grupo de anuncios	crear	Struct
Grupo de anuncios	actualización	Struct
Grupo de anuncios	primaryStatus	Cadena	!=, =
Grupo de anuncios	primaryStatusReasons	Enumeración
Anuncio de grupo de anuncios	resourceName	Cadena	!=, =
Anuncio de grupo de anuncios	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anuncio de grupo de anuncios	status	Cadena	!=, =
Anuncio de grupo de anuncios	etiquetas	Enumeración
Anuncio de grupo de anuncios	adGroup	Cadena	!=, =
Anuncio de grupo de anuncios	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anuncio de grupo de anuncios	approvalStatus	Cadena	!=, =
Anuncio de grupo de anuncios	reviewStatus	Cadena	!=, =
Anuncio de grupo de anuncios	adStrength	Cadena	!=, =
Anuncio de grupo de anuncios	type	Cadena	!=, =
Anuncio de grupo de anuncios	businessName	Cadena	!=, =, LIKE
Anuncio de grupo de anuncios	date	Date	BETWEEN, =, <, >, <=, >=
Anuncio de grupo de anuncios	allConversionsByConversionDate	Doble	!=, =, <, >
Anuncio de grupo de anuncios	allConversionsValueByConversionDate	Doble	!=, =, <, >
Anuncio de grupo de anuncios	conversionsByConversionDate	Doble	!=, =, <, >
Anuncio de grupo de anuncios	conversionsValueByConversionDate	Doble	!=, =, <, >
Anuncio de grupo de anuncios	valuePerAllConversionsByConversionDate	Doble	!=, =, <, >
Anuncio de grupo de anuncios	valuePerConversionsByConversionDate	Doble	!=, =, <, >
Anuncio de grupo de anuncios	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anuncio de grupo de anuncios	averageCost	Doble	!=, =, <, >
Anuncio de grupo de anuncios	costPerAllConversions	Doble	!=, =, <, >
Anuncio de grupo de anuncios	costPerConversion	Doble	!=, =, <, >
Anuncio de grupo de anuncios	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anuncio de grupo de anuncios	averagePageViews	Doble	!=, =, <, >
Anuncio de grupo de anuncios	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anuncio de grupo de anuncios	allConversions	Doble	!=, =, <, >
Anuncio de grupo de anuncios	averageCpc	Doble	!=, =, <, >
Anuncio de grupo de anuncios	topImpressionPercentage	Doble	!=, =, <, >
Anuncio de grupo de anuncios	impresiones	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anuncio de grupo de anuncios	absoluteTopImpressionPercentage	Doble	!=, =, <, >
Anuncio de grupo de anuncios	activeViewCtr	Doble	!=, =, <, >
Anuncio de grupo de anuncios	ctr	Doble	!=, =, <, >
Anuncio de grupo de anuncios	conversionAction	Cadena	!=, =
Anuncio de grupo de anuncios	conversionActionCategory	Cadena	!=, =
Anuncio de grupo de anuncios	conversionActionName	Cadena	!=, =, LIKE
Anuncio de grupo de anuncios	updateMask	Cadena
Anuncio de grupo de anuncios	crear	Struct
Anuncio de grupo de anuncios	actualización	Struct
Anuncio de grupo de anuncios	policyValidationParameter	Struct
Anuncio de grupo de anuncios	primaryStatus	Cadena	!=, =
Anuncio de grupo de anuncios	primaryStatusReasons	Enumeración
Campaña	resourceName	Cadena	!=, =
Campaña	status	Cadena	!=, =
Campaña	baseCampaign	Cadena	!=, =
Campaña	nombre	Cadena	!=, =, LIKE
Campaña	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	campaignBudget	Cadena	!=, =, LIKE
Campaña	startDate	Date	BETWEEN, =, <, >, <=, >=
Campaña	endDate	Date	BETWEEN, =, <, >, <=, >=
Campaña	adServingOptimizationStatus	Cadena	!=, =
Campaña	advertisingChannelType	Cadena	!=, =
Campaña	advertisingChannelSubType	Cadena	!=, =
Campaña	experimentType	Cadena	!=, =
Campaña	servingStatus	Cadena	!=, =
Campaña	biddingStrategyType	Cadena	!=, =
Campaña	domainName	Cadena	!=, =, LIKE
Campaña	languageCode	Cadena	!=, =, LIKE
Campaña	useSuppliedUrlsOnly	Booleano	!=, =
Campaña	positiveGeoTargetType	Cadena	!=, =
Campaña	negativeGeoTargetType	Cadena	!=, =
Campaña	paymentMode	Cadena	!=, =
Campaña	optimizationGoalTypes	Enumeración
Campaña	date	Date	BETWEEN, =, <, >, <=, >=
Campaña	averageCost	Doble
Campaña	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	impresiones	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	useAudienceGrouped	Booleano	!=, =
Campaña	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	costPerAllConversions	Doble	!=, =, <, >
Campaña	costPerConversion	Doble	!=, =, <, >
Campaña	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	publisherPurchasedClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	averagePageViews	Doble	!=, =, <, >
Campaña	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campaña	allConversionsByConversionDate	Doble	!=, =, <, >
Campaña	allConversionsValueByConversionDate	Doble	!=, =, <, >
Campaña	conversionsByConversionDate	Doble	!=, =, <, >
Campaña	conversionsValueByConversionDate	Doble	!=, =, <, >
Campaña	valuePerAllConversionsByConversionDate	Doble	!=, =, <, >
Campaña	valuePerConversionsByConversionDate	Doble	!=, =, <, >
Campaña	allConversions	Doble	!=, =, <, >
Campaña	absoluteTopImpressionPercentage	Doble	!=, =, <, >
Campaña	searchAbsoluteTopImpressionShare	Doble	!=, =, <, >
Campaña	averageCpc	Doble	!=, =, <, >
Campaña	searchImpressionShare	Doble	!=, =, <, >
Campaña	searchTopImpressionShare	Doble	!=, =, <, >
Campaña	activeViewCtr	Doble	!=, =, <, >
Campaña	ctr	Doble	!=, =, <, >
Campaña	relativeCtr	Doble	!=, =, <, >
Campaña	updateMask	Cadena
Campaña	crear	Struct
Campaña	actualización	Struct
Presupuesto de campaña	resourceName	Cadena	!=, =
Presupuesto de campaña	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	status	Cadena	!=, =
Presupuesto de campaña	deliveryMethod	Cadena	!=, =
Presupuesto de campaña	periodo	Cadena	!=, =
Presupuesto de campaña	type	Cadena	!=, =
Presupuesto de campaña	nombre	Cadena	!=, =, LIKE
Presupuesto de campaña	amountMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	explicitlyShared	Booleano	!=, =
Presupuesto de campaña	referenceCount	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	hasRecommendedBudget	Booleano	!=, =
Presupuesto de campaña	date	Date	BETWEEN, =, <, >, <=, >=
Presupuesto de campaña	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	startDate	Date	BETWEEN, =, <, >, <=, >=
Presupuesto de campaña	endDate	Date	BETWEEN, =, <, >, <=, >=
Presupuesto de campaña	maximizeConversionValueTargetRoas	Doble	!=, =, <, >
Presupuesto de campaña	maximizeConversionsTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	selectiveOptimizationConversionActions	Cadena
Presupuesto de campaña	averageCost	Doble	!=, =, <, >
Presupuesto de campaña	costPerAllConversions	Doble	!=, =, <, >
Presupuesto de campaña	costPerConversion	Doble	!=, =, <, >
Presupuesto de campaña	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	allConversions	Doble	!=, =, <, >
Presupuesto de campaña	valuePerAllConversions	Doble	!=, =, <, >
Presupuesto de campaña	averageCpc	Doble	!=, =, <, >
Presupuesto de campaña	impresiones	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Presupuesto de campaña	ctr	Doble	!=, =, <, >
Presupuesto de campaña	updateMask	Cadena
Presupuesto de campaña	crear	Struct
Presupuesto de campaña	actualización	Struct

Consultas de partición

Puede proporcionar las opciones adicionales de Spark PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND y NUM_PARTITIONS si quiere usar 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 usará para particionar la consulta.

• LOWER_BOUND: un valor de límite inferior inclusivo del campo de partición elegido.

  Para la fecha, aceptamos el formato de fecha de Spark que se usa en las consultas de Spark SQL. Ejemplos de valores válidos: "2024-02-06".

• UPPER_BOUND: un valor límite superior exclusivo del campo de partición elegido.

• NUM_PARTITIONS: el número de particiones.

Los detalles de compatibilidad del campo de partición por entidad se capturaron en la siguiente tabla.

Nombre de la entidad	Campo de partición	Tipo de datos
Anuncio de grupo de anuncios	date	Date
Grupo de anuncios	date	Date
Campaña	date	Date
Presupuesto de campaña	date	Date

Ejemplo

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