Índice
IngestionService(interfaz)MarketingDataInsightsService(interfaz)PartnerLinkService(interfaz)UserListDirectLicenseService(interfaz)UserListGlobalLicenseService(interfaz)UserListService(interfaz)AdIdentifiers(mensaje)AddressInfo(mensaje)AgeRange(enumeración)AudienceMember(mensaje)AwsWrappedKeyInfo(mensaje)AwsWrappedKeyInfo.KeyType(enumeración)Baseline(mensaje)Baseline.Location(mensaje)CartData(mensaje)Consent(mensaje)ConsentStatus(enumeración)ContactIdInfo(mensaje)CreatePartnerLinkRequest(mensaje)CreateUserListDirectLicenseRequest(mensaje)CreateUserListGlobalLicenseRequest(mensaje)CreateUserListRequest(mensaje)CustomVariable(mensaje)CustomerType(enumeración)CustomerValueBucket(enumeración)DataSourceType(enumeración)DeletePartnerLinkRequest(mensaje)DeleteUserListRequest(mensaje)Destination(mensaje)DeviceInfo(mensaje)Encoding(enumeración)EncryptionInfo(mensaje)ErrorCount(mensaje)ErrorInfo(mensaje)ErrorReason(enumeración)Event(mensaje)EventParameter(mensaje)EventSource(enumeración)ExperimentalField(mensaje)GcpWrappedKeyInfo(mensaje)GcpWrappedKeyInfo.KeyType(enumeración)Gender(enumeración)GetUserListDirectLicenseRequest(mensaje)GetUserListGlobalLicenseRequest(mensaje)GetUserListRequest(mensaje)IngestAudienceMembersRequest(mensaje)IngestAudienceMembersResponse(mensaje)IngestEventsRequest(mensaje)IngestEventsResponse(mensaje)IngestedUserListInfo(mensaje)IngestedUserListInfo.UploadKeyType(enumeración)Item(mensaje)ItemParameter(mensaje)ListUserListDirectLicensesRequest(mensaje)ListUserListDirectLicensesResponse(mensaje)ListUserListGlobalLicenseCustomerInfosRequest(mensaje)ListUserListGlobalLicenseCustomerInfosResponse(mensaje)ListUserListGlobalLicensesRequest(mensaje)ListUserListGlobalLicensesResponse(mensaje)ListUserListsRequest(mensaje)ListUserListsResponse(mensaje)MatchRateRange(enumeración)MobileData(mensaje)MobileIdInfo(mensaje)MobileIdInfo.KeySpace(enumeración)PairData(mensaje)PairIdInfo(mensaje)PartnerAudienceInfo(mensaje)PartnerAudienceInfo.PartnerAudienceSource(enumeración)PartnerLink(mensaje)PpidData(mensaje)ProcessingErrorReason(enumeración)ProcessingWarningReason(enumeración)Product(enumerado) (obsoleto)ProductAccount(mensaje)ProductAccount.AccountType(enumeración)PseudonymousIdInfo(mensaje)PseudonymousIdInfo.SyncStatus(enumeración)RemoveAudienceMembersRequest(mensaje)RemoveAudienceMembersResponse(mensaje)RequestStatusPerDestination(mensaje)RequestStatusPerDestination.IngestAudienceMembersStatus(mensaje)RequestStatusPerDestination.IngestEventsStatus(mensaje)RequestStatusPerDestination.IngestMobileDataStatus(mensaje)RequestStatusPerDestination.IngestPairDataStatus(mensaje)RequestStatusPerDestination.IngestPpidDataStatus(mensaje)RequestStatusPerDestination.IngestUserDataStatus(mensaje)RequestStatusPerDestination.IngestUserIdDataStatus(mensaje)RequestStatusPerDestination.RemoveAudienceMembersStatus(mensaje)RequestStatusPerDestination.RemoveMobileDataStatus(mensaje)RequestStatusPerDestination.RemovePairDataStatus(mensaje)RequestStatusPerDestination.RemovePpidDataStatus(mensaje)RequestStatusPerDestination.RemoveUserDataStatus(mensaje)RequestStatusPerDestination.RemoveUserIdDataStatus(mensaje)RequestStatusPerDestination.RequestStatus(enumeración)RetrieveInsightsRequest(mensaje)RetrieveInsightsResponse(mensaje)RetrieveInsightsResponse.MarketingDataInsight(mensaje)RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension(enumeración)RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute(mensaje)RetrieveRequestStatusRequest(mensaje)RetrieveRequestStatusResponse(mensaje)SearchPartnerLinksRequest(mensaje)SearchPartnerLinksResponse(mensaje)SizeInfo(mensaje)TargetNetworkInfo(mensaje)TermsOfService(mensaje)TermsOfServiceStatus(enumeración)UpdateUserListDirectLicenseRequest(mensaje)UpdateUserListGlobalLicenseRequest(mensaje)UpdateUserListRequest(mensaje)UserData(mensaje)UserIdData(mensaje)UserIdInfo(mensaje)UserIdentifier(mensaje)UserList(mensaje)UserList.AccessReason(enumeración)UserList.AccessStatus(enumeración)UserList.ClosingReason(enumeración)UserList.MembershipStatus(enumeración)UserListDirectLicense(mensaje)UserListGlobalLicense(mensaje)UserListGlobalLicenseCustomerInfo(mensaje)UserListGlobalLicenseType(enumeración)UserListLicenseClientAccountType(enumeración)UserListLicenseMetrics(mensaje)UserListLicensePricing(mensaje)UserListLicensePricing.UserListPricingBuyerApprovalState(enumeración)UserListLicensePricing.UserListPricingCostType(enumeración)UserListLicenseStatus(enumeración)UserProperties(mensaje)UserProperty(mensaje)WarningCount(mensaje)WarningInfo(mensaje)
IngestionService
Servicio para enviar datos de público a destinos compatibles.
| IngestAudienceMembers |
|---|
|
Sube una lista de recursos
|
| IngestEvents |
|---|
|
Sube una lista de recursos
|
| RemoveAudienceMembers |
|---|
|
Quita una lista de recursos
|
| RetrieveRequestStatus |
|---|
|
Obtiene el estado de una solicitud según su ID.
|
MarketingDataInsightsService
Servicio para devolver estadísticas sobre los datos de marketing.
Esta función solo está disponible para los socios de datos.
| RetrieveInsights |
|---|
|
Recupera estadísticas de datos de marketing para una lista de usuarios determinada. Esta función solo está disponible para los socios de datos. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
PartnerLinkService
Servicio para administrar vínculos de socios.
| CreatePartnerLink |
|---|
|
Crea un vínculo de socio para la cuenta especificada. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
| DeletePartnerLink |
|---|
|
Borra un vínculo de socio para la cuenta especificada. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
| SearchPartnerLinks |
|---|
|
Busca todos los vínculos de socio hacia y desde una cuenta determinada. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
UserListDirectLicenseService
Servicio para administrar licencias directas de listas de usuarios. La operación de eliminación no es compatible con UserListDirectLicenses. Los llamadores deben actualizar el estado de la licencia a DISABLED para desactivarla.
Esta función solo está disponible para los socios de datos.
| CreateUserListDirectLicense |
|---|
|
Crea una licencia directa de lista de usuarios. Esta función solo está disponible para los socios de datos.
|
| GetUserListDirectLicense |
|---|
|
Recupera una licencia directa de la lista de usuarios. Esta función solo está disponible para los socios de datos.
|
| ListUserListDirectLicenses |
|---|
|
Enumera todas las licencias directas de listas de usuarios que posee la cuenta principal. Esta función solo está disponible para los socios de datos.
|
| UpdateUserListDirectLicense |
|---|
|
Actualiza una licencia directa de la lista de usuarios. Esta función solo está disponible para los socios de datos.
|
UserListGlobalLicenseService
Servicio para administrar licencias globales de listas de usuarios. La operación de eliminación no es compatible con UserListGlobalLicenses. Los llamadores deben actualizar el estado de la licencia a DISABLED para desactivarla.
Esta función solo está disponible para los socios de datos.
| CreateUserListGlobalLicense |
|---|
|
Crea una licencia global de lista de usuarios. Esta función solo está disponible para los socios de datos.
|
| GetUserListGlobalLicense |
|---|
|
Recupera una licencia global de lista de usuarios. Esta función solo está disponible para los socios de datos.
|
| ListUserListGlobalLicenseCustomerInfos |
|---|
|
Enumera toda la información del cliente para una licencia global de la lista de usuarios. Esta función solo está disponible para los socios de datos.
|
| ListUserListGlobalLicenses |
|---|
|
Enumera todas las licencias globales de listas de usuarios que posee la cuenta principal. Esta función solo está disponible para los socios de datos.
|
| UpdateUserListGlobalLicense |
|---|
|
Actualiza una licencia global de la lista de usuarios. Esta función solo está disponible para los socios de datos.
|
UserListService
Servicio para administrar recursos de UserList.
| CreateUserList |
|---|
|
Crea un UserList. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
| DeleteUserList |
|---|
|
Borra una UserList. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
| GetUserList |
|---|
|
Obtiene un objeto UserList. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
| ListUserLists |
|---|
|
Enumera UserLists. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
| UpdateUserList |
|---|
|
Actualiza un objeto UserList. Encabezados de autorización: Este método admite los siguientes encabezados opcionales para definir cómo la API autoriza el acceso a la solicitud:
|
AdIdentifiers
Identificadores y otra información que se utilizan para correlacionar el evento de conversión con otra actividad en línea (como los clics en anuncios)
| Campos | |
|---|---|
session_attributes |
Opcional. Son los atributos de sesión para el modelado y la atribución de eventos. |
gclid |
Opcional. Es el ID de clic de Google (GCLID) asociado con este evento. |
gbraid |
Opcional. Es el identificador de clics para los clics asociados con los eventos de aplicaciones y que provienen de dispositivos iOS a partir de iOS 14. |
wbraid |
Opcional. Es el identificador de clics para los clics asociados con los eventos web y que provienen de dispositivos iOS a partir de iOS 14. |
landing_page_device_info |
Opcional. Es la información recopilada sobre el dispositivo que se usa (si corresponde) en el momento de acceder al sitio del anunciante después de interactuar con el anuncio. |
AddressInfo
Es la información de la dirección del usuario.
| Campos | |
|---|---|
given_name |
Obligatorio. Nombre (primero) del usuario, todo en minúsculas, sin signos de puntuación, sin espacios en blanco iniciales o finales, y con codificación hash como SHA-256. |
family_name |
Obligatorio. Apellido del usuario, todo en minúsculas, sin signos de puntuación, sin espacios en blanco iniciales o finales, y con codificación hash como SHA-256. |
region_code |
Obligatorio. Es el código de región de 2 letras según ISO-3166-1 alpha-2 de la dirección del usuario. |
postal_code |
Obligatorio. Es el código postal de la dirección del usuario. |
Rango de edades
Son los rangos de edad demográficos.
| Enums | |
|---|---|
AGE_RANGE_UNSPECIFIED |
No se especifica. |
AGE_RANGE_UNKNOWN |
Desconocido. |
AGE_RANGE_18_24 |
Tener entre 18 y 24 años |
AGE_RANGE_25_34 |
Entre 25 y 34 años |
AGE_RANGE_35_44 |
Entre 35 y 44 años |
AGE_RANGE_45_54 |
Entre 45 y 54 años |
AGE_RANGE_55_64 |
Tener entre 55 y 64 años |
AGE_RANGE_65_UP |
65 años y más |
AudienceMember
Es el miembro del público sobre el que se realizará la operación.
| Campos | |
|---|---|
destination_references[] |
Opcional. Define a qué |
consent |
Opcional. Es el parámetro de configuración de consentimiento del usuario. |
Campo de unión data. Es el tipo de datos de identificación con los que se operará. data puede ser solo uno de los parámetros siguientes: |
|
user_data |
Son los datos proporcionados por el usuario que lo identifican. |
pair_data |
IDs de la Conciliación de Identidades de Publicador y Anunciante (PAIR) Esta función solo está disponible para los socios de datos. |
mobile_data |
Son los datos que identifican los dispositivos móviles del usuario. |
user_id_data |
Son los datos relacionados con los identificadores únicos de un usuario, según lo define el anunciante. |
ppid_data |
Son los datos relacionados con los identificadores proporcionados por el publicador. Esta función solo está disponible para los socios de datos. |
AwsWrappedKeyInfo
Es una clave de encriptación de datos unida por una clave de KMS de AWS.
| Campos | |
|---|---|
key_type |
Obligatorio. Es el tipo de algoritmo que se usa para encriptar los datos. |
role_arn |
Obligatorio. Nombre de recurso de Amazon del rol de IAM que se debe asumir para el acceso de desencriptación de KMS. Debe tener el formato |
kek_uri |
Obligatorio. Es el URI de la clave de AWS KMS que se usa para desencriptar la DEK. Debe tener el formato |
encrypted_dek |
Obligatorio. Es la clave de encriptación de datos encriptada y codificada en Base64. |
KeyType
Es el tipo de algoritmo que se usa para encriptar los datos.
| Enums | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Es un tipo de clave sin especificar. No debe usarse nunca. |
XCHACHA20_POLY1305 |
Algoritmo XChaCha20-Poly1305 |
Modelo de referencia
Son los criterios de referencia con los que se comparan las estadísticas.
| Campos | |
|---|---|
Campo de unión baseline. Es la ubicación de referencia con la que se comparan las estadísticas. baseline puede ser solo uno de los parámetros siguientes: |
|
baseline_location |
Es la ubicación de referencia de la solicitud. La ubicación de referencia es una lista OR de las regiones solicitadas. |
location_auto_detection_enabled |
Si se establece como verdadero, el servicio intentará detectar automáticamente la ubicación de referencia para las estadísticas. |
Ubicación
Es la ubicación de referencia de la solicitud. La ubicación de referencia se encuentra en la lista OR de códigos de región ISO 3166-1 alpha-2 de las regiones solicitadas.
| Campos | |
|---|---|
region_codes[] |
Es una lista de códigos de región ISO 3166-1 alpha-2. |
CartData
Son los datos del carrito asociados con el evento.
| Campos | |
|---|---|
merchant_id |
Opcional. Es el ID de Merchant Center asociado con los artículos. |
merchant_feed_label |
Opcional. Es la etiqueta de feed de Merchant Center asociada al feed de los artículos. |
merchant_feed_language_code |
Opcional. Es el código de idioma en ISO 639-1 asociado al feed de Merchant Center de los artículos en el que se suben tus artículos. |
transaction_discount |
Opcional. Es la suma de todos los descuentos asociados con la transacción. |
items[] |
Opcional. Es la lista de elementos asociados con el evento. |
Consentimiento
Es la configuración del consentimiento de la Ley de Mercados Digitales (DMA) para el usuario.
| Campos | |
|---|---|
ad_user_data |
Opcional. Representa si el usuario da su consentimiento para el uso de datos del usuario de anuncios. |
ad_personalization |
Opcional. Representa si el usuario da su consentimiento para la personalización de anuncios. |
ConsentStatus
Representa si el usuario otorgó, rechazó o no especificó el consentimiento.
| Enums | |
|---|---|
CONSENT_STATUS_UNSPECIFIED |
No se especifica. |
CONSENT_GRANTED |
Se otorgó el permiso. |
CONSENT_DENIED |
Se rechazó. |
ContactIdInfo
Es información adicional cuando CONTACT_ID es uno de los upload_key_types.
| Campos | |
|---|---|
match_rate_percentage |
Solo salida. Es el porcentaje de coincidencias de las listas de usuarios de segmentación por clientes. |
data_source_type |
Opcional. Inmutable. Fuente de los datos de carga |
CreatePartnerLinkRequest
Es la solicitud para crear un recurso PartnerLink. Devuelve un PartnerLink.
| Campos | |
|---|---|
parent |
Obligatorio. Es el elemento superior, que es propietario de esta colección de vínculos de socios. Formato: accountTypes/{account_type}/accounts/{account} |
partner_link |
Obligatorio. Es el vínculo de socio que se creará. |
CreateUserListDirectLicenseRequest
Es la solicitud para crear un recurso UserListDirectLicense.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta propietaria de la lista de usuarios para la que se otorga la licencia. Debe tener el formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_direct_license |
Obligatorio. Es la licencia directa de la lista de usuarios que se creará. |
CreateUserListGlobalLicenseRequest
Es la solicitud para crear un recurso UserListGlobalLicense.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta propietaria de la lista de usuarios para la que se otorga la licencia. Debe tener el formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_global_license |
Obligatorio. Es la licencia global de la lista de usuarios que se creará. |
CreateUserListRequest
Es el mensaje de solicitud para CreateUserList.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta principal en la que se creará esta lista de usuarios. Formato: accountTypes/{account_type}/accounts/{account} |
user_list |
Obligatorio. Es la lista de usuarios que se creará. |
validate_only |
Opcional. Si es verdadero, la solicitud se valida, pero no se ejecuta. |
CustomVariable
Es la variable personalizada para las conversiones de anuncios.
| Campos | |
|---|---|
variable |
Opcional. Nombre de la variable personalizada que se establecerá. Si no se encuentra la variable para el destino determinado, se ignorará. |
value |
Opcional. Es el valor que se almacenará para la variable personalizada. |
destination_references[] |
Opcional. Es la cadena de referencia que se usa para determinar a cuál de los objetos |
CustomerType
Es el tipo de cliente asociado al evento.
| Enums | |
|---|---|
CUSTOMER_TYPE_UNSPECIFIED |
CustomerType no especificado. No debe usarse nunca. |
NEW |
El cliente es nuevo para el anunciante. |
RETURNING |
El cliente regresa al anunciante. |
REENGAGED |
El cliente volvió a interactuar con el anunciante. |
CustomerValueBucket
Es el valor del cliente según la evaluación del anunciante.
| Enums | |
|---|---|
CUSTOMER_VALUE_BUCKET_UNSPECIFIED |
Es el CustomerValueBucket no especificado. No debe usarse nunca. |
LOW |
El cliente es de bajo valor. |
MEDIUM |
El cliente tiene un valor medio. |
HIGH |
El cliente es valioso. |
DataSourceType
Indica la fuente de los datos de carga.
| Enums | |
|---|---|
DATA_SOURCE_TYPE_UNSPECIFIED |
No se especifica. |
DATA_SOURCE_TYPE_FIRST_PARTY |
Los datos subidos son datos de origen. |
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU |
Los datos subidos provienen de una agencia de informes crediticios externa. |
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE |
Los datos subidos provienen de un archivo de votantes externo. |
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA |
Los datos subidos son datos de socios externos. |
DeletePartnerLinkRequest
Es la solicitud para borrar un recurso PartnerLink. Devuelve un google.protobuf.Empty.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del vínculo del socio que se borrará. Formato: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
DeleteUserListRequest
Es el mensaje de solicitud para DeleteUserList.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre de la lista de usuarios que se borrará. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
validate_only |
Opcional. Si es verdadero, la solicitud se valida, pero no se ejecuta. |
Destino
Producto de Google al que envías datos. Por ejemplo, una cuenta de Google Ads.
| Campos | |
|---|---|
reference |
Opcional. Es el ID de este recurso |
login_account |
Opcional. Es la cuenta que se usó para realizar esta llamada a la API. Para agregar o quitar datos del |
linked_account |
Opcional. Es una cuenta a la que el |
operating_account |
Obligatorio. Es la cuenta a la que se enviarán los datos o de la que se quitarán. |
product_destination_id |
Obligatorio. Es el objeto dentro de la cuenta de productos en el que se realizará la transferencia de datos. Por ejemplo, un ID de público de Google Ads, un ID de público de Display & Video 360 o un ID de acción de conversión de Google Ads. |
DeviceInfo
Es la información sobre el dispositivo que se usaba (si corresponde) cuando ocurrió el evento.
| Campos | |
|---|---|
user_agent |
Opcional. Es la cadena de usuario-agente del dispositivo para el contexto determinado. |
ip_address |
Opcional. Es la dirección IP del dispositivo para el contexto determinado. Nota: Google Ads no admite la correlación de direcciones IP de los usuarios finales del Espacio Económico Europeo (EEE), el Reino Unido (UK) ni Suiza (CH). Agrega lógica para excluir de forma condicional la divulgación de direcciones IP de los usuarios de estas regiones y asegúrate de proporcionarles información clara y completa sobre los datos que recopilas en tus sitios, aplicaciones y otras propiedades, así como de obtener el consentimiento cuando lo exija la ley o las políticas aplicables de Google. Consulta la página Acerca de las importaciones de conversiones sin conexión para obtener más detalles. |
Codificación
Es el tipo de codificación de la información de identificación hasheada.
| Enums | |
|---|---|
ENCODING_UNSPECIFIED |
Tipo de codificación sin especificar. No debe usarse nunca. |
HEX |
Es la codificación hexadecimal. |
BASE64 |
Codificación en Base64. |
EncryptionInfo
Es la información de encriptación de los datos que se transfieren.
| Campos | |
|---|---|
Campo de unión wrapped_key. Es la clave unida que se usa para encriptar los datos. wrapped_key puede ser solo uno de los siguientes: |
|
gcp_wrapped_key_info |
Es la información de la clave encapsulada de Google Cloud. |
aws_wrapped_key_info |
Es la información de la clave unida de Amazon Web Services. |
ErrorCount
Es el recuento de errores para un motivo de error determinado.
| Campos | |
|---|---|
record_count |
Es el recuento de los registros que no se pudieron subir por un motivo determinado. |
reason |
Es el motivo del error de los registros fallidos. |
ErrorInfo
Recuentos de errores para cada tipo de error.
| Campos | |
|---|---|
error_counts[] |
Es una lista de errores y recuentos por motivo de error. Es posible que no se complete en todos los casos. |
ErrorReason
Son los motivos de error de la API de Data Manager. NOTA: Este enum no está congelado y es posible que se agreguen valores nuevos en el futuro.
| Enums | |
|---|---|
ERROR_REASON_UNSPECIFIED |
No uses este valor predeterminado. |
INTERNAL_ERROR |
Se produjo un error interno. |
DEADLINE_EXCEEDED |
La solicitud tardó demasiado en responder. |
RESOURCE_EXHAUSTED |
Hay demasiadas solicitudes. |
NOT_FOUND |
No se encontró el recurso. |
PERMISSION_DENIED |
El usuario no tiene permiso o no se encontró el recurso. |
INVALID_ARGUMENT |
Se produjo un problema con la solicitud. |
REQUIRED_FIELD_MISSING |
Falta un campo obligatorio. |
INVALID_FORMAT |
El formato no es válido. |
INVALID_HEX_ENCODING |
El valor codificado en HEX tiene errores de formato. |
INVALID_BASE64_ENCODING |
El valor codificado en base64 tiene errores de formato. |
INVALID_SHA256_FORMAT |
El valor codificado en SHA256 tiene errores de formato. |
INVALID_POSTAL_CODE |
El código postal no es válido. |
INVALID_COUNTRY_CODE |
El código de país no es válido. |
INVALID_ENUM_VALUE |
No se puede usar el valor de enumeración. |
INVALID_USER_LIST_TYPE |
El tipo de lista de usuarios no se puede aplicar a esta solicitud. |
INVALID_AUDIENCE_MEMBER |
Este miembro del público no es válido. |
TOO_MANY_AUDIENCE_MEMBERS |
La cantidad máxima de miembros del público permitida por solicitud es de 10,000. |
TOO_MANY_USER_IDENTIFIERS |
La cantidad máxima de identificadores de usuario permitidos por miembro del público es de 10. |
TOO_MANY_DESTINATIONS |
La cantidad máxima de destinos permitidos por solicitud es de 10. |
INVALID_DESTINATION |
Este destino no es válido. |
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED |
El socio de datos no tiene acceso a la lista de usuarios de la cuenta operativa. |
INVALID_MOBILE_ID_FORMAT |
El formato del ID del dispositivo móvil no es válido. |
INVALID_USER_LIST_ID |
La lista de usuarios no es válida. |
MULTIPLE_DATA_TYPES_NOT_ALLOWED |
No se permite la transferencia de varios tipos de datos en una sola solicitud. |
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER |
Los parámetros de configuración de destino que contienen una cuenta de acceso de socio de datos deben tener la misma cuenta de acceso en todos los parámetros de configuración de destino. |
TERMS_AND_CONDITIONS_NOT_SIGNED |
No se aceptaron los Términos y Condiciones obligatorios. |
INVALID_NUMBER_FORMAT |
El formato de número no es válido. |
INVALID_CONVERSION_ACTION_ID |
El ID de acción de conversión no es válido. |
INVALID_CONVERSION_ACTION_TYPE |
El tipo de acción de conversión no es válido. |
INVALID_CURRENCY_CODE |
No se admite el código de moneda. |
INVALID_EVENT |
Este evento no es válido. |
TOO_MANY_EVENTS |
La cantidad máxima de eventos permitidos por solicitud es de 10,000. |
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
La cuenta de destino no está habilitada para las conversiones avanzadas de clientes potenciales. |
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
No se pueden usar las conversiones avanzadas para la cuenta de destino debido a las políticas de datos del cliente de Google. Comunícate con tu representante de Google. |
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
La cuenta de destino no aceptó las condiciones de las conversiones avanzadas. |
DUPLICATE_DESTINATION_REFERENCE |
Dos o más destinos en la solicitud tienen la misma referencia. |
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER |
Cuenta operativa no admitida para la autorización del socio de datos. |
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER |
No se admite la cuenta vinculada para la autorización del socio de datos. |
NO_IDENTIFIERS_PROVIDED |
Los datos de eventos no contienen identificadores de usuario ni de anuncios. |
INVALID_PROPERTY_TYPE |
No se admite el tipo de propiedad. |
INVALID_STREAM_TYPE |
No se admite el tipo de transmisión. |
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT |
La cuenta vinculada solo se admite cuando la cuenta de acceso es una cuenta de DATA_PARTNER. |
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH |
La cuenta de acceso debe ser la misma que la cuenta operativa para el caso de uso determinado. |
EVENT_TIME_INVALID |
El evento no ocurrió dentro del período aceptable. |
RESERVED_NAME_USED |
El parámetro usa un nombre reservado. |
INVALID_EVENT_NAME |
No se admite el nombre del evento. |
NOT_ALLOWLISTED |
La cuenta no está incluida en la lista de entidades permitidas para la función especificada. |
INVALID_REQUEST_ID |
El ID de solicitud que se usó para recuperar el estado de una solicitud no es válido. El estado solo se puede recuperar para las solicitudes que se realizan correctamente y no tienen validate_only=true. |
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT |
Un evento tenía 2 o más destinos de Google Analytics. |
FIELD_VALUE_TOO_LONG |
El valor del campo es demasiado largo. |
TOO_MANY_ELEMENTS |
Hay demasiados elementos en una lista de la solicitud. |
ALREADY_EXISTS |
El recurso ya existe. |
IMMUTABLE_FIELD_FOR_UPDATE |
Se intentó establecer un campo inmutable para una solicitud de actualización. |
INVALID_RESOURCE_NAME |
El nombre del recurso no es válido. |
INVALID_FILTER |
El filtro de la consulta no es válido. |
INVALID_UPDATE_MASK |
La máscara de actualización no es válida. |
INVALID_PAGE_TOKEN |
El token de página no es válido. |
CANNOT_UPDATE_DISABLED_LICENSE |
No se puede actualizar una licencia que se inhabilitó. |
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST |
Las listas de usuarios sensibles no se pueden licenciar para este cliente. |
INSUFFICIENT_COST |
El costo es demasiado bajo para esta licencia. |
CANNOT_DISABLE_LICENSE |
No se puede inhabilitar la licencia de revendedor porque está en uso. |
INVALID_CLIENT_ACCOUNT_ID |
El ID de la cuenta del cliente no es válido. |
PRICING_ONLY_ZERO_COST_ALLOWED |
No se permite un costo distinto de cero para esta cuenta de cliente. |
PRICE_TOO_HIGH |
El costo es demasiado alto para esta licencia. |
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE |
El cliente no tiene permiso para crear licencias. |
INVALID_PRICING_END_DATE |
La fecha de finalización del precio no es válida para esta licencia. |
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT |
No se puede otorgar licencia a la lista lógica de usuarios con un segmento compartido o con licencia. |
MISMATCHED_ACCOUNT_TYPE |
El tipo de cuenta del cliente en la solicitud no coincide con el tipo de cuenta real del cliente. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE |
El tipo de licencia no admite el costo de la participación en los medios. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER |
El tipo de cliente del cliente no admite el costo de la participación de medios. |
INVALID_MEDIA_SHARE_COST |
El costo de la participación en los medios no es válido. |
INVALID_COST_TYPE |
El tipo de costo no es válido. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST |
El tipo UserList no admite el costo de la participación de medios. |
MAX_COST_NOT_ALLOWED |
El costo máximo solo se permite para el tipo de costo MEDIA_SHARE. |
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED |
El público de comercio solo se puede obtener con una licencia directa. |
INVALID_DESCRIPTION |
La descripción no es válida. |
INVALID_DISPLAY_NAME |
El nombre visible no es válido. |
DISPLAY_NAME_ALREADY_USED |
El nombre visible ya se está usando para otra lista de usuarios de la cuenta. |
OWNERSHIP_REQUIRED_FOR_UPDATE |
Se requiere la propiedad para modificar la lista de usuarios. |
USER_LIST_MUTATION_NOT_SUPPORTED |
El tipo de lista de usuarios es de solo lectura y no admite mutaciones. |
SENSITIVE_USER_LIST_IMMUTABLE |
Los usuarios externos no pueden modificar una lista de usuarios que sea sensible a la privacidad o que se haya rechazado por motivos legales. |
BILLABLE_RECORD_COUNT_IMMUTABLE |
El campo de registro facturable de la lista de usuarios de remarketing no se puede modificar una vez que se configura. |
USER_LIST_NAME_RESERVED |
El nombre de la lista de usuarios está reservado para las listas del sistema. |
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA |
El anunciante debe estar en la lista de entidades permitidas para usar las listas de remarketing creadas a partir de los datos que subió el anunciante. |
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE |
La fuente de público del socio no es compatible con el tipo de lista de usuarios. |
COMMERCE_PARTNER_NOT_ALLOWED |
La configuración del campo commerce_partner solo se admite si partner_audience_source es COMMERCE_AUDIENCE. |
UNSUPPORTED_PARTNER_AUDIENCE_INFO |
El campo partner_audience_info no se admite para el tipo de lista de usuarios. |
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED |
Las cuentas de administrador no pueden crear listas de usuarios de la Segmentación por socios. |
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
El socio de datos no está en la lista de entidades permitidas para THIRD_PARTY_PARTNER_DATA. |
ADVERTISER_TOS_NOT_ACCEPTED |
El anunciante no aceptó las condiciones del servicio del socio. |
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
El anunciante no está incluido en la lista de usuarios permitidos para THIRD_PARTY_PARTNER_DATA. |
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT |
Este tipo de lista de usuarios no se admite en esta cuenta. |
INVALID_COMMERCE_PARTNER |
El campo commerce_partner no es válido. |
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE |
El proveedor de datos no está en la lista de usuarios permitidos para crear públicos de comercio. |
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES |
No se admiten los tipos de claves de carga de la lista de usuarios. |
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG |
No se admite la configuración de información de la lista de usuarios transferida. |
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE |
Los tipos de cuenta no son compatibles con el tipo de lista de usuarios. |
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK |
Los tipos de cuenta no son compatibles con la vinculación de socio. |
Evento
Es un evento que representa la interacción de un usuario con el sitio web o la aplicación de un anunciante.
| Campos | |
|---|---|
destination_references[] |
Opcional. Es la cadena de referencia que se usa para determinar el destino. Si está vacío, el evento se enviará a todos los |
transaction_id |
Opcional. Es el identificador único de este evento. Se requiere para las conversiones que utilizan varias fuentes de datos. |
event_timestamp |
Obligatorio. La hora en que ocurrió el evento. |
last_updated_timestamp |
Opcional. Es la última vez que se actualizó el evento. |
user_data |
Opcional. Son fragmentos de datos proporcionados por el usuario que representan al usuario con el que se asocia el evento. |
consent |
Opcional. Es información sobre si el usuario asociado proporcionó diferentes tipos de consentimiento. |
ad_identifiers |
Opcional. Identificadores y otra información que se utilizan para correlacionar el evento de conversión con otra actividad en línea (como los clics en anuncios) |
currency |
Opcional. Es el código de moneda asociado con todos los valores monetarios de este evento. |
event_source |
Opcional. Es un indicador del lugar donde ocurrió el evento (Web, aplicación, en la tienda, etc.). |
event_device_info |
Opcional. Es la información recopilada sobre el dispositivo que se usaba (si corresponde) cuando ocurrió el evento. |
cart_data |
Opcional. Es la información sobre la transacción y los elementos asociados al evento. |
custom_variables[] |
Opcional. Es información adicional de pares clave-valor que se envía a los contenedores de conversiones (acción de conversión o actividad de FL). |
experimental_fields[] |
Opcional. Es una lista de pares clave-valor para los campos experimentales que, eventualmente, podrían promoverse para formar parte de la API. |
user_properties |
Opcional. Es la información sobre el usuario que evaluó el anunciante en el momento en que ocurrió el evento. |
event_name |
Opcional. El nombre del evento Es obligatorio para los eventos de GA4. |
client_id |
Opcional. Es un identificador único para la instancia del usuario de un cliente web de este flujo web de GA4. |
user_id |
Opcional. Es un identificador único para un usuario, según lo define el anunciante. |
additional_event_parameters[] |
Opcional. Es un bucket de cualquier parámetro del evento que se incluirá en el evento y que no se especificó con otros campos estructurados. |
conversion_value |
Opcional. Es el valor de conversión asociado al evento para las conversiones basadas en el valor. |
EventParameter
Es el parámetro del evento para los eventos de GA4.
| Campos | |
|---|---|
parameter_name |
Obligatorio. Es el nombre del parámetro que se usará. |
value |
Obligatorio. Es la representación de cadena del valor del parámetro que se establecerá. |
EventSource
Es la fuente del evento.
| Enums | |
|---|---|
EVENT_SOURCE_UNSPECIFIED |
EventSource no especificado. No debe usarse nunca. |
WEB |
El evento se generó desde un navegador web. |
APP |
El evento se generó a partir de una app. |
IN_STORE |
El evento se generó a partir de una transacción en la tienda. |
PHONE |
El evento se generó a partir de una llamada telefónica. |
OTHER |
El evento se generó a partir de otras fuentes. |
ExperimentalField
Es un campo experimental que representa campos no oficiales.
| Campos | |
|---|---|
field |
Opcional. Es el nombre del campo que se usará. |
value |
Opcional. Es el valor que se establecerá en el campo. |
GcpWrappedKeyInfo
Es información sobre la clave encapsulada de Google Cloud Platform.
| Campos | |
|---|---|
key_type |
Obligatorio. Es el tipo de algoritmo que se usa para encriptar los datos. |
wip_provider |
Obligatorio. Es el proveedor del grupo de Workload Identity que se requiere para usar la KEK. |
kek_uri |
Obligatorio. ID del recurso de Cloud Key Management Service de Google Cloud Platform. Debe tener el formato |
encrypted_dek |
Obligatorio. Es la clave de encriptación de datos encriptada y codificada en Base64. |
KeyType
Es el tipo de algoritmo que se usa para encriptar los datos.
| Enums | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Es un tipo de clave sin especificar. No debe usarse nunca. |
XCHACHA20_POLY1305 |
Algoritmo XChaCha20-Poly1305 |
Género
Es el tipo de género demográfico (por ejemplo, femenino).
| Enums | |
|---|---|
GENDER_UNSPECIFIED |
No se especifica. |
GENDER_UNKNOWN |
Desconocido. |
GENDER_MALE |
Hombre. |
GENDER_FEMALE |
Mujer. |
GetUserListDirectLicenseRequest
Es una solicitud para obtener un recurso UserListDirectLicense.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso de la licencia directa de la lista de usuarios. |
GetUserListGlobalLicenseRequest
Es una solicitud para obtener un recurso UserListGlobalLicense.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso de la licencia global de la lista de usuarios. |
GetUserListRequest
Es el mensaje de solicitud de GetUserList.
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso de UserList que se recuperará. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
IngestAudienceMembersRequest
Solicita subir miembros del público a los destinos proporcionados. Devuelve un IngestAudienceMembersResponse.
| Campos | |
|---|---|
destinations[] |
Obligatorio. Es la lista de destinos a los que se enviarán los miembros del público. |
audience_members[] |
Obligatorio. Es la lista de usuarios a los que se enviará el mensaje a los destinos especificados. Se pueden enviar como máximo 10,000 recursos |
consent |
Opcional. Es el consentimiento a nivel de la solicitud que se aplica a todos los usuarios incluidos en la solicitud. El consentimiento a nivel del usuario anula el consentimiento a nivel de la solicitud y se puede especificar en cada |
validate_only |
Opcional. Solo con fines de prueba. Si es |
encoding |
Opcional. Es obligatorio para las cargas de |
encryption_info |
Opcional. Es la información de encriptación para las cargas de |
terms_of_service |
Opcional. Son las condiciones del servicio que el usuario aceptó o rechazó. |
IngestAudienceMembersResponse
Respuesta de IngestAudienceMembersRequest.
| Campos | |
|---|---|
request_id |
Es el ID generado automáticamente de la solicitud. |
IngestEventsRequest
Solicita subir miembros del público a los destinos proporcionados. Devuelve un IngestEventsResponse.
| Campos | |
|---|---|
destinations[] |
Obligatorio. Es la lista de destinos a los que se enviarán los eventos. |
events[] |
Obligatorio. Es la lista de eventos que se enviarán a los destinos especificados. Se pueden enviar como máximo 2,000 recursos |
consent |
Opcional. Es el consentimiento a nivel de la solicitud que se aplica a todos los usuarios incluidos en la solicitud. El consentimiento a nivel del usuario anula el consentimiento a nivel de la solicitud y se puede especificar en cada |
validate_only |
Opcional. Solo con fines de prueba. Si es |
encoding |
Opcional. Es obligatorio para las cargas de |
encryption_info |
Opcional. Es la información de encriptación para las cargas de |
IngestEventsResponse
Respuesta de IngestEventsRequest.
| Campos | |
|---|---|
request_id |
Es el ID generado automáticamente de la solicitud. |
IngestedUserListInfo
Representa una lista de usuarios que se completa con datos proporcionados por el usuario.
| Campos | |
|---|---|
upload_key_types[] |
Obligatorio. Inmutable. Son los tipos de claves de carga de esta lista de usuarios. |
contact_id_info |
Opcional. Es información adicional cuando |
mobile_id_info |
Opcional. Es información adicional cuando |
user_id_info |
Opcional. Es información adicional cuando |
pair_id_info |
Opcional. Es información adicional cuando Esta función solo está disponible para los socios de datos. |
pseudonymous_id_info |
Opcional. La información adicional para |
partner_audience_info |
Opcional. Es información adicional para los públicos de socios. Esta función solo está disponible para los socios de datos. |
UploadKeyType
Es una enumeración que contiene los posibles tipos de claves de carga de una lista de usuarios.
| Enums | |
|---|---|
UPLOAD_KEY_TYPE_UNSPECIFIED |
No se especifica. |
CONTACT_ID |
Información del cliente, como la dirección de correo electrónico, el número de teléfono o la dirección física |
MOBILE_ID |
Son los IDs de publicidad para dispositivos móviles. |
USER_ID |
Son los IDs de usuario proporcionados por terceros. |
PAIR_ID |
Son los IDs de conciliación de la identidad del publicador y el anunciante. |
PSEUDONYMOUS_ID |
IDs de la plataforma de administración de datos: - ID de usuario de Google - ID proporcionado por el socio - ID proporcionado por el publicador - IDFA de iOS - ID de publicidad de Android - ID de Roku - ID de Amazon Fire TV - ID de Xbox o Microsoft |
Elemento
Representa un artículo del carrito asociado al evento.
| Campos | |
|---|---|
merchant_product_id |
Opcional. Es el ID del producto en la cuenta de Merchant Center. |
quantity |
Opcional. Es la cantidad de este elemento asociado con el evento. |
unit_price |
Opcional. Es el precio por unidad sin impuestos, envío ni descuentos a nivel de la transacción. |
item_id |
Opcional. Es un identificador único para hacer referencia al elemento. |
additional_item_parameters[] |
Opcional. Es un bucket de cualquier parámetro del evento relacionado con un elemento que se incluirá en el evento y que no se especificó con otros campos estructurados. |
ItemParameter
Es un bucket de cualquier parámetro del evento relacionado con un elemento que se incluirá en el evento y que no se especificó con otros campos estructurados.
| Campos | |
|---|---|
parameter_name |
Obligatorio. Es el nombre del parámetro que se usará. |
value |
Obligatorio. Es la representación de cadena del valor del parámetro que se establecerá. |
ListUserListDirectLicensesRequest
Es una solicitud para enumerar todos los recursos UserListDirectLicense de una cuenta determinada.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta cuyas licencias se consultan. Debe tener el formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Opcional. Son los filtros que se aplicarán a la solicitud de lista. Todos los campos deben estar a la izquierda de cada condición (por ejemplo, user_list_id = 123). Operaciones admitidas:
Campos no admitidos:
|
page_size |
Opcional. Es la cantidad máxima de licencias que se devolverán por página. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 licencias. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_token |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListUserListDirectLicensesResponse
Respuesta de ListUserListDirectLicensesRequest.
| Campos | |
|---|---|
user_list_direct_licenses[] |
Son las licencias de la lista de usuarios determinada en la solicitud. |
next_page_token |
Un token, que se puede enviar como |
ListUserListGlobalLicenseCustomerInfosRequest
Solicita enumerar todos los recursos UserListGlobalLicenseCustomerInfo para una licencia global de lista de usuarios determinada.
| Campos | |
|---|---|
parent |
Obligatorio. Es la licencia global cuya información del cliente se consulta. Debe tener el formato |
filter |
Opcional. Son los filtros que se aplicarán a la solicitud de lista. Todos los campos deben estar a la izquierda de cada condición (por ejemplo, user_list_id = 123). Operaciones admitidas:
Campos no admitidos:
|
page_size |
Opcional. Es la cantidad máxima de licencias que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 licencias. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_token |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListUserListGlobalLicenseCustomerInfosResponse
Es la respuesta de [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].
| Campos | |
|---|---|
user_list_global_license_customer_infos[] |
Es la información del cliente para la licencia determinada en la solicitud. |
next_page_token |
Un token, que se puede enviar como |
ListUserListGlobalLicensesRequest
Es una solicitud para enumerar todos los recursos UserListGlobalLicense de una cuenta determinada.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta cuyas licencias se consultan. Debe tener el formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Opcional. Son los filtros que se aplicarán a la solicitud de lista. Todos los campos deben estar a la izquierda de cada condición (por ejemplo, user_list_id = 123). Operaciones admitidas:
Campos no admitidos:
|
page_size |
Opcional. Es la cantidad máxima de licencias que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 licencias. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_token |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListUserListGlobalLicensesResponse
Respuesta de ListUserListGlobalLicensesRequest.
| Campos | |
|---|---|
user_list_global_licenses[] |
Son las licencias de la lista de usuarios determinada en la solicitud. |
next_page_token |
Un token, que se puede enviar como |
ListUserListsRequest
Es el mensaje de solicitud de ListUserLists.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta principal que posee esta colección de listas de usuarios. Formato: accountTypes/{account_type}/accounts/{account} |
page_size |
Opcional. Es la cantidad máxima de listas de usuarios que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 listas de usuarios. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_token |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
filter |
Opcional. Es una cadena de filtro. Todos los campos deben estar a la izquierda de cada condición (por ejemplo, Operaciones admitidas:
Campos admitidos:
|
ListUserListsResponse
Es el mensaje de respuesta para ListUserLists.
| Campos | |
|---|---|
user_lists[] |
Son las listas de usuarios de la cuenta especificada. |
next_page_token |
Un token, que se puede enviar como |
MatchRateRange
Es el rango del porcentaje de coincidencias de la carga o la lista de usuarios.
| Enums | |
|---|---|
MATCH_RATE_RANGE_UNKNOWN |
Se desconoce el rango de la tasa de coincidencias. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
El rango de porcentaje de coincidencias no es apto. |
MATCH_RATE_RANGE_LESS_THAN_20 |
El rango del porcentaje de coincidencias es inferior al 20% (en el intervalo [0, 20)). |
MATCH_RATE_RANGE_20_TO_30 |
El rango del porcentaje de coincidencias se encuentra entre el 20% y el 30% (en el intervalo [20, 31)). |
MATCH_RATE_RANGE_31_TO_40 |
El rango del porcentaje de coincidencias se encuentra entre el 31% y el 40% (en el intervalo [31, 41)). |
MATCH_RATE_RANGE_41_TO_50 |
El rango del porcentaje de coincidencias se encuentra entre el 41% y el 50% (en el intervalo [41, 51)). |
MATCH_RATE_RANGE_51_TO_60 |
El rango del porcentaje de coincidencias está entre el 51% y el 60% (en el intervalo [51, 61)). |
MATCH_RATE_RANGE_61_TO_70 |
El rango de porcentaje de coincidencias está entre el 61% y el 70% (en el intervalo [61, 71)). |
MATCH_RATE_RANGE_71_TO_80 |
El rango del porcentaje de coincidencias se encuentra entre el 71% y el 80% (en el intervalo [71, 81)). |
MATCH_RATE_RANGE_81_TO_90 |
El rango de porcentaje de coincidencias se encuentra entre el 81% y el 90% (en el intervalo [81, 91)). |
MATCH_RATE_RANGE_91_TO_100 |
El rango del porcentaje de coincidencias se encuentra entre el 91% y el 100% (en el intervalo |
MobileData
Son los IDs de dispositivos móviles del público. Se requiere al menos un ID de dispositivo móvil.
| Campos | |
|---|---|
mobile_ids[] |
Obligatorio. Es la lista de IDs de dispositivos móviles (ID de publicidad o IDFA). Se pueden proporcionar hasta 10 |
MobileIdInfo
Es información adicional cuando MOBILE_ID es uno de los upload_key_types.
| Campos | |
|---|---|
data_source_type |
Opcional. Inmutable. Es la fuente de los datos de carga. |
key_space |
Obligatorio. Inmutable. Es el espacio de claves de los IDs de dispositivos móviles. |
app_id |
Obligatorio. Inmutable. Es una cadena que identifica de forma única una aplicación para dispositivos móviles desde la que se recopilaron los datos. |
KeySpace
Es el espacio de claves para el ID de dispositivo móvil.
| Enums | |
|---|---|
KEY_SPACE_UNSPECIFIED |
No se especifica. |
IOS |
Es el espacio de claves de iOS. |
ANDROID |
Es el espacio de claves de Android. |
PairData
Son los IDs de PAIR del público. Se requiere al menos un ID de PAIR.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
pair_ids[] |
Obligatorio. Son los datos de PII proporcionados por la sala limpia, codificados con hash con SHA256 y encriptados con un cifrado conmutativo de EC que usa la clave del publicador para la lista de usuarios de PAIR. Se pueden proporcionar hasta 10 |
PairIdInfo
Es información adicional cuando PAIR_ID es uno de los upload_key_types.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
match_rate_percentage |
Solo salida. Este campo indica el porcentaje de coincidencia de membresía de esta lista de usuarios con los datos de origen del publicador correspondiente. Debe estar comprendido entre 0 y 100, ambos incluidos. |
advertiser_identifier_count |
Solo salida. Es el recuento de los registros de datos de origen del anunciante que se subieron a un proveedor de salas limpias. Esto no indica el tamaño de una lista de usuarios de PAIR. |
publisher_id |
Obligatorio. Inmutable. Identifica al publicador con el que se concilia la lista de usuarios de la Conciliación de la identidad del anunciante y el publicador. El proveedor de la sala limpia proporciona este campo, y solo es único en el alcance de esa sala limpia. No se puede usar como identificador global en varias salas limpias. |
publisher_name |
Opcional. Es el nombre descriptivo del publicador que se mostrará en la IU para brindar una mejor experiencia de segmentación. |
clean_room_identifier |
Obligatorio. Inmutable. Identifica una relación única entre el publicador y el anunciante con un proveedor de sala limpia o con varios. |
PartnerAudienceInfo
Es información adicional para los públicos de socios.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
partner_audience_source |
Obligatorio. Inmutable. Es la fuente de datos del público del socio. |
commerce_partner |
Opcional. Es el nombre del socio comercial. Solo se permite si |
PartnerAudienceSource
Es la fuente de datos del público del socio.
| Enums | |
|---|---|
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED |
No se especifica. |
COMMERCE_AUDIENCE |
La fuente de datos del público del socio es un público de comercio. |
LINEAR_TV_AUDIENCE |
La fuente de datos del público del socio es el público de la TV lineal. |
AGENCY_PROVIDER_AUDIENCE |
La fuente de datos del público de socios es un público de agencias o proveedores. |
PartnerLink
Es un vínculo de socio entre una cuenta propietaria y una cuenta de socio.
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del vínculo de socio. Formato: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
partner_link_id |
Solo salida. Es el ID del vínculo de socio. |
owning_account |
Obligatorio. Es la cuenta propietaria que otorga acceso a la cuenta de socio. |
partner_account |
Obligatorio. Es la cuenta de socio a la que la cuenta propietaria otorgó acceso. |
PpidData
Son los datos de los identificadores proporcionados por el publicador que contienen los PPID. Se requiere al menos un PPID.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
ppids[] |
Obligatorio. Es la lista de identificadores proporcionados por el publicador para un usuario. |
ProcessingErrorReason
Es el motivo del error de procesamiento.
| Enums | |
|---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
Se desconoce el motivo del error de procesamiento. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
La variable personalizada no es válida. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
El estado de la variable personalizada no está habilitado. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
La conversión es anterior a la antigüedad máxima admitida. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
Se rechazan los datos del usuario del anuncio, ya sea por el usuario o en la configuración predeterminada del anunciante. |
PROCESSING_ERROR_REASON_NO_CONSENT |
El anunciante no dio su consentimiento a terceros para los servicios de la plataforma principal de Google Ads. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
No se pudo determinar el consentimiento general (determinado a partir del consentimiento a nivel de la fila, el consentimiento a nivel de la solicitud y la configuración de la cuenta) para este usuario. |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
Ya existe una conversión con el mismo GCLID y horario de conversión en el sistema. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
Ya se subió una conversión con la misma combinación de ID de pedido y acción de conversión. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
No se pudo decodificar el gbraid. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
No se pudo decodificar el ID de clic de Google. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
El ID de comercio contiene caracteres que no son dígitos. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
No se pudo decodificar el wbraid. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Error interno. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
No se firmaron las condiciones de las conversiones avanzadas en la cuenta de destino. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
El evento no es válido. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
Las transacciones coincidentes son inferiores al umbral mínimo. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
Las transacciones son inferiores al umbral mínimo. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
El evento tiene un error de formato. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
El evento tiene un error de desencriptación. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
No se pudo desencriptar la DEK. |
PROCESSING_ERROR_REASON_INVALID_WIP |
El WIP tiene un formato incorrecto o no existe. |
PROCESSING_ERROR_REASON_INVALID_KEK |
La KEK no puede desencriptar los datos porque es incorrecta o no existe. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
No se pudo usar el WIP porque se rechazó por su condición de certificación. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
El sistema no tenía los permisos necesarios para acceder a la KEK. |
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED |
El sistema no pudo autenticarse con AWS. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
No se pudieron desencriptar los datos de UserIdentifier con la DEK. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
El usuario intentó transferir eventos con un identificador de publicidad que no proviene de los anuncios de la cuenta operativa. |
ProcessingWarningReason
Es el motivo de la advertencia de procesamiento.
| Enums | |
|---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
Se desconoce el motivo de la advertencia de procesamiento. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
El sistema no tenía los permisos necesarios para acceder a la KEK. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
No se pudo desencriptar la DEK. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
El evento tiene un error de desencriptación. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
No se pudo usar el WIP porque se rechazó por su condición de certificación. |
PROCESSING_WARNING_REASON_INVALID_WIP |
El WIP tiene un formato incorrecto o no existe. |
PROCESSING_WARNING_REASON_INVALID_KEK |
La KEK no puede desencriptar los datos porque es incorrecta o no existe. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
No se pudieron desencriptar los datos de UserIdentifier con la DEK. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Error interno. |
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED |
El sistema no pudo autenticarse con AWS. |
Producto
Obsoleta. Usa AccountType
| Enums | |
|---|---|
PRODUCT_UNSPECIFIED |
Producto no especificado. No debe usarse nunca. |
GOOGLE_ADS |
Google Ads. |
DISPLAY_VIDEO_PARTNER |
Socio de Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
Ser anunciante de Display & Video 360 |
DATA_PARTNER |
Socio de datos. |
ProductAccount
Representa una cuenta específica.
| Campos | |
|---|---|
product |
Obsoleta. Usa |
account_id |
Obligatorio. Es el ID de la cuenta. Por ejemplo, el ID de tu cuenta de Google Ads. |
account_type |
Opcional. Es el tipo de cuenta. Por ejemplo, |
AccountType
Representa los tipos de cuentas de Google. Se usa para ubicar cuentas y destinos.
| Enums | |
|---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Producto no especificado. No debe usarse nunca. |
GOOGLE_ADS |
Google Ads. |
DISPLAY_VIDEO_PARTNER |
Socio de Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
Ser anunciante de Display & Video 360 |
DATA_PARTNER |
Socio de datos. |
GOOGLE_ANALYTICS_PROPERTY |
Google Analytics. |
GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Es la vinculación del público de Google Ad Manager. |
PseudonymousIdInfo
Es información adicional cuando PSEUDONYMOUS_ID es uno de los upload_key_types.
| Campos | |
|---|---|
sync_status |
Solo salida. Es el estado de sincronización de la lista de usuarios. |
billable_record_count |
Opcional. Inmutable. Es la cantidad de registros facturables (p.ej., subidos o coincidentes). |
SyncStatus
Es el estado de sincronización de la lista de usuarios.
| Enums | |
|---|---|
SYNC_STATUS_UNSPECIFIED |
No se especifica. |
CREATED |
Se creó la lista de usuarios como marcador de posición. Aún se están sincronizando el contenido y los metadatos de la lista. La lista de usuarios no está lista para usarse. |
READY_FOR_USE |
La lista de usuarios está lista para usarse. El contenido y las cookies se sincronizaron correctamente. |
FAILED |
Se produjo un error al sincronizar el contenido o los metadatos de la lista de usuarios. No se puede usar la lista de usuarios. |
RemoveAudienceMembersRequest
Solicita quitar usuarios de un público en los destinos proporcionados. Muestra un objeto RemoveAudienceMembersResponse.
| Campos | |
|---|---|
destinations[] |
Obligatorio. Es la lista de destinos de los que se quitarán los usuarios. |
audience_members[] |
Obligatorio. Es la lista de usuarios que se quitarán. |
validate_only |
Opcional. Solo con fines de prueba. Si es |
encoding |
Opcional. Es obligatorio para las cargas de |
encryption_info |
Opcional. Es la información de encriptación para las cargas de |
RemoveAudienceMembersResponse
Respuesta de RemoveAudienceMembersRequest.
| Campos | |
|---|---|
request_id |
Es el ID generado automáticamente de la solicitud. |
RequestStatusPerDestination
Es el estado de la solicitud por destino.
| Campos | |
|---|---|
destination |
Es un destino dentro de una solicitud a la API de DM. |
request_status |
Es el estado de la solicitud del destino. |
error_info |
Es un error de información de error que contiene el motivo del error y los recuentos de errores relacionados con la carga. |
warning_info |
Es información de advertencia que contiene el motivo y la cantidad de advertencias relacionadas con la carga. |
Campo de unión status. Es el estado del destino. status puede ser solo uno de los parámetros siguientes: |
|
audience_members_ingestion_status |
Es el estado de la solicitud de miembros del público de la transferencia. |
events_ingestion_status |
Es el estado de la solicitud de eventos de transferencia. |
audience_members_removal_status |
Es el estado de la solicitud para quitar miembros del público. |
IngestAudienceMembersStatus
Es el estado de la solicitud de miembros del público de la transferencia.
| Campos | |
|---|---|
Campo de unión status. Es el estado de la transferencia de los miembros del público al destino. status puede ser solo uno de los parámetros siguientes: |
|
user_data_ingestion_status |
Es el estado de la transferencia de datos del usuario al destino. |
mobile_data_ingestion_status |
Es el estado de la transferencia de datos móviles al destino. |
pair_data_ingestion_status |
Es el estado de la transferencia de datos de pares al destino. |
user_id_data_ingestion_status |
Es el estado de la transferencia de datos del ID de usuario al destino. |
ppid_data_ingestion_status |
Es el estado de la transferencia de datos de PPID al destino. |
IngestEventsStatus
Es el estado de la transferencia de volúmenes altos de eventos al destino.
| Campos | |
|---|---|
record_count |
Es el recuento total de eventos enviados en la solicitud de carga. Incluye todos los eventos de la solicitud, independientemente de si se procesaron correctamente o no. |
IngestMobileDataStatus
Es el estado de la transferencia de datos móviles al destino que contiene estadísticas relacionadas con la transferencia.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público que se enviaron en la solicitud de carga para el destino. Incluye a todos los miembros del público incluidos en la solicitud, independientemente de si se incorporaron correctamente o no. |
mobile_id_count |
Es el recuento total de IDs de dispositivos móviles enviados en la solicitud de carga para el destino. Incluye todos los IDs de dispositivos móviles de la solicitud, independientemente de si se incorporaron correctamente o no. |
IngestPairDataStatus
Es el estado de la transferencia de datos de pares al destino que contiene estadísticas relacionadas con la transferencia.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público que se enviaron en la solicitud de carga para el destino. Incluye a todos los miembros del público incluidos en la solicitud, independientemente de si se incorporaron correctamente o no. |
pair_id_count |
Es el recuento total de los IDs de pares enviados en la solicitud de carga para el destino. Incluye todos los IDs de pares en la solicitud, independientemente de si se procesaron correctamente o no. |
IngestPpidDataStatus
Es el estado de la transferencia de datos de PPID al destino que contiene estadísticas relacionadas con la transferencia.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público que se enviaron en la solicitud de carga para el destino. Incluye a todos los miembros del público incluidos en la solicitud, independientemente de si se incorporaron correctamente o no. |
ppid_count |
Es el recuento total de los PPIDs enviados en la solicitud de carga para el destino. Incluye todos los PPIDs de la solicitud, independientemente de si se procesaron correctamente o no. |
IngestUserDataStatus
Es el estado de la transferencia de datos del usuario al destino que contiene estadísticas relacionadas con la transferencia.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público que se enviaron en la solicitud de carga para el destino. Incluye a todos los miembros del público incluidos en la solicitud, independientemente de si se incorporaron correctamente o no. |
user_identifier_count |
Es el recuento total de identificadores de usuario enviados en la solicitud de carga para el destino. Incluye todos los identificadores de usuario en la solicitud, independientemente de si se incorporaron correctamente o no. |
upload_match_rate_range |
Es el rango del porcentaje de coincidencias de la carga. |
IngestUserIdDataStatus
Es el estado de la transferencia de datos del ID de usuario al destino que contiene estadísticas relacionadas con la transferencia.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público que se enviaron en la solicitud de carga para el destino. Incluye a todos los miembros del público incluidos en la solicitud, independientemente de si se incorporaron correctamente o no. |
user_id_count |
Es el recuento total de los IDs de usuario enviados en la solicitud de carga para el destino. Incluye todos los IDs de usuario de la solicitud, independientemente de si se incorporaron correctamente o no. |
RemoveAudienceMembersStatus
Es el estado de la solicitud para quitar miembros del público.
| Campos | |
|---|---|
Campo de unión status. Es el estado de la eliminación de los miembros del público del destino. status puede ser solo uno de los parámetros siguientes: |
|
user_data_removal_status |
Es el estado de la eliminación de los datos del usuario del destino. |
mobile_data_removal_status |
Es el estado de la eliminación de los datos móviles del destino. |
pair_data_removal_status |
Es el estado de la eliminación de los datos de pares del destino. |
user_id_data_removal_status |
Es el estado de la eliminación de los datos del ID de usuario del destino. |
ppid_data_removal_status |
Es el estado de la eliminación de los datos de PPID del destino. |
RemoveMobileDataStatus
Es el estado de la eliminación de los datos móviles del destino.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público incluidos en la solicitud de eliminación. Incluye a todos los miembros del público en la solicitud, independientemente de si se quitaron correctamente o no. |
mobile_id_count |
Es el recuento total de IDs de dispositivos móviles enviados en la solicitud de eliminación. Incluye todos los IDs de dispositivos móviles en la solicitud, independientemente de si se quitaron correctamente o no. |
RemovePairDataStatus
Es el estado de la eliminación de los datos de pares del destino.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público incluidos en la solicitud de eliminación. Incluye a todos los miembros del público en la solicitud, independientemente de si se quitaron correctamente o no. |
pair_id_count |
Es el recuento total de los IDs de pares enviados en la solicitud de eliminación. Incluye todos los IDs de pares en la solicitud, independientemente de si se quitaron correctamente o no. |
RemovePpidDataStatus
Es el estado de la eliminación de los datos de PPID del destino.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público incluidos en la solicitud de eliminación. Incluye a todos los miembros del público en la solicitud, independientemente de si se quitaron correctamente o no. |
ppid_count |
Es el recuento total de los PPIDs enviados en la solicitud de eliminación. Incluye todos los PPIDs de la solicitud, independientemente de si se quitaron correctamente o no. |
RemoveUserDataStatus
Es el estado de la eliminación de los datos del usuario del destino.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público incluidos en la solicitud de eliminación. Incluye a todos los miembros del público en la solicitud, independientemente de si se quitaron correctamente o no. |
user_identifier_count |
Es el recuento total de identificadores de usuario enviados en la solicitud de eliminación. Incluye todos los identificadores de usuario en la solicitud, independientemente de si se quitaron correctamente o no. |
RemoveUserIdDataStatus
Es el estado de la eliminación de los datos del ID de usuario del destino.
| Campos | |
|---|---|
record_count |
Es el recuento total de los miembros del público incluidos en la solicitud de eliminación. Incluye a todos los miembros del público en la solicitud, independientemente de si se quitaron correctamente o no. |
user_id_count |
Es el recuento total de los IDs de usuario enviados en la solicitud de eliminación. Incluye todos los IDs de usuario de la solicitud, independientemente de si se quitaron correctamente o no. |
RequestStatus
Es el estado de la solicitud.
| Enums | |
|---|---|
REQUEST_STATUS_UNKNOWN |
Se desconoce el estado de la solicitud. |
SUCCESS |
La solicitud se realizó correctamente. |
PROCESSING |
Se está procesando la solicitud. |
FAILED |
Se produjo un error en la solicitud. |
PARTIAL_SUCCESS |
La solicitud se realizó correctamente de forma parcial. |
RetrieveInsightsRequest
Es el mensaje de solicitud para el método RetrieveInsights de la API de DM MarketingDataInsightsService.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta principal que posee la lista de usuarios. Formato: |
baseline |
Obligatorio. Es el modelo de referencia para las estadísticas solicitadas. |
user_list_id |
Obligatorio. Es el ID de la lista de usuarios para la que se solicitan estadísticas. |
RetrieveInsightsResponse
Es el mensaje de respuesta para la API de DM de MarketingDataInsightsService.RetrieveInsights.
| Campos | |
|---|---|
marketing_data_insights[] |
Contiene las estadísticas de los datos de marketing. |
MarketingDataInsight
Son estadísticas sobre los datos de marketing.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
dimension |
Dimensión a la que pertenece la estadística. |
attributes[] |
Son estadísticas sobre los valores de una dimensión determinada. |
AudienceInsightsDimension
Son las dimensiones posibles para generar estadísticas.
| Enums | |
|---|---|
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED |
No se especifica. |
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN |
El valor es desconocido en esta versión. |
AFFINITY_USER_INTEREST |
Es un objeto Affinity UserInterest. |
IN_MARKET_USER_INTEREST |
Es un objeto In-Market UserInterest. |
AGE_RANGE |
Es un rango de edad. |
GENDER |
Es un género. |
MarketingDataInsightsAttribute
Son las estadísticas sobre una colección de atributos relacionados de la misma dimensión.
| Campos | |
|---|---|
user_interest_id |
Es el ID del interés del usuario. |
lift |
Es la medida de efectividad que tiene el público para el valor del atributo en comparación con el modelo de referencia. Rango [0-1]. |
age_range |
Es el rango de edad del público para el que se proporciona la efectividad. |
gender |
Es el género del público para el que se proporciona la efectividad. |
RetrieveRequestStatusRequest
Es una solicitud para obtener el estado de la solicitud realizada a la API de DM para un ID de solicitud determinado. Muestra un objeto RetrieveRequestStatusResponse.
| Campos | |
|---|---|
request_id |
Obligatorio. Obligatorio. Es el ID de la solicitud a la API de Data Manager. |
RetrieveRequestStatusResponse
Respuesta de RetrieveRequestStatusRequest.
| Campos | |
|---|---|
request_status_per_destination[] |
Es una lista de estados de solicitudes por destino. El orden de los estados coincide con el orden de los destinos en la solicitud original. |
SearchPartnerLinksRequest
Es una solicitud para buscar recursos PartnerLink. Devuelve un SearchPartnerLinksResponse.
| Campos | |
|---|---|
parent |
Obligatorio. Es la cuenta en la que se buscarán vínculos de socios. Si no se especifica ningún Formato: |
page_size |
Es la cantidad máxima de vínculos de socios que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 10 vínculos de socios. El valor máximo es 100, y los valores superiores se convertirán a 100. |
page_token |
Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
filter |
Opcional. Es una cadena de filtro. Todos los campos deben estar a la izquierda de cada condición (por ejemplo, Operaciones admitidas:
Campos admitidos:
Ejemplo: |
SearchPartnerLinksResponse
Respuesta de SearchPartnerLinksRequest.
| Campos | |
|---|---|
partner_links[] |
Son los vínculos de socio de la cuenta especificada. |
next_page_token |
Un token, que se puede enviar como |
SizeInfo
Es la cantidad estimada de miembros en esta lista de usuarios en diferentes redes de segmentación.
| Campos | |
|---|---|
display_network_members_count |
Solo salida. Es la cantidad estimada de miembros en esta lista de usuarios, en la Red de Display de Google. |
search_network_members_count |
Solo salida. Es la cantidad estimada de miembros en esta lista de usuarios en el dominio google.com. Estos son los miembros disponibles para la segmentación en las campañas de Búsqueda. |
TargetNetworkInfo
Es información sobre la elegibilidad para diferentes redes objetivo.
| Campos | |
|---|---|
eligible_for_display |
Solo salida. Indica que esta lista de usuarios es apta para la Red de Display de Google. |
eligible_for_search |
Opcional. Indica si esta lista de usuarios es apta para la Red de Búsqueda de Google. |
TermsOfService
Son las condiciones del servicio que el usuario aceptó o rechazó.
| Campos | |
|---|---|
customer_match_terms_of_service_status |
Opcional. Las condiciones del servicio de Segmentación por clientes: https://support.google.com/adspolicy/answer/6299717 Se debe aceptar cuando se ingieren |
TermsOfServiceStatus
Representa la decisión del llamador de aceptar o rechazar las condiciones del servicio.
| Enums | |
|---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
No se especifica. |
ACCEPTED |
Es el estado que indica que el llamante eligió aceptar las condiciones del servicio. |
REJECTED |
Es el estado que indica que el llamador eligió rechazar las condiciones del servicio. |
UpdateUserListDirectLicenseRequest
Es la solicitud para actualizar un recurso UserListDirectLicense.
| Campos | |
|---|---|
user_list_direct_license |
Obligatorio. El campo |
update_mask |
Opcional. La lista de campos que se deben actualizar. No se admite el carácter especial |
UpdateUserListGlobalLicenseRequest
Es la solicitud para actualizar un recurso UserListGlobalLicense.
| Campos | |
|---|---|
user_list_global_license |
Obligatorio. El campo |
update_mask |
Opcional. La lista de campos que se deben actualizar. No se admite el carácter especial |
UpdateUserListRequest
Es el mensaje de solicitud para UpdateUserList.
| Campos | |
|---|---|
user_list |
Obligatorio. Es la lista de usuarios que se actualizará. El campo |
update_mask |
Opcional. La lista de campos que se deben actualizar. |
validate_only |
Opcional. Si es verdadero, la solicitud se valida, pero no se ejecuta. |
UserData
Son los datos que identifican al usuario. Se requiere al menos un identificador.
| Campos | |
|---|---|
user_identifiers[] |
Obligatorio. Son los identificadores del usuario. Es posible proporcionar varias instancias del mismo tipo de datos (por ejemplo, varias direcciones de correo electrónico). Para aumentar las probabilidades de obtener una coincidencia, proporciona la mayor cantidad posible de identificadores. Se pueden proporcionar hasta 10 |
UserIdData
Son los datos del ID de usuario que contienen el ID del usuario.
| Campos | |
|---|---|
user_id |
Obligatorio. Es un identificador único para un usuario, según lo define el anunciante. |
UserIdInfo
Es información adicional cuando USER_ID es uno de los upload_key_types.
| Campos | |
|---|---|
data_source_type |
Opcional. Inmutable. Es la fuente de los datos de carga. |
UserIdentifier
Es un identificador único para el usuario.
| Campos | |
|---|---|
Campo de unión identifier. Se debe especificar exactamente uno. identifier puede ser solo uno de los parámetros siguientes: |
|
email_address |
Dirección de correo electrónico con codificación hash que utiliza la función hash SHA-256 después de la normalización. |
phone_number |
Número de teléfono con codificación hash que utiliza la función hash SHA-256 después de la normalización (estándar E164). |
address |
Son los componentes conocidos de la dirección de un usuario. Contiene una agrupación de identificadores que se correlacionan todos a la vez. |
UserList
Es un recurso de lista de usuarios.
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del recurso de la lista de usuarios. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
id |
Solo salida. Es el ID único de la lista de usuarios. |
read_only |
Solo salida. Es una opción que indica si un usuario puede editar una lista. |
membership_duration |
Opcional. Es la duración durante la que un usuario permanece en la lista de usuarios. Las duraciones válidas son múltiplos exactos de 24 horas (86,400 segundos). Si se proporciona un valor que no es un múltiplo exacto de 24 horas, se producirá un error INVALID_ARGUMENT. |
access_reason |
Solo salida. Es el motivo por el que se le otorgó acceso a esta cuenta a la lista. |
size_info |
Solo salida. Es la cantidad estimada de miembros en esta lista de usuarios en diferentes redes de segmentación. |
target_network_info |
Opcional. Es información sobre la elegibilidad para diferentes redes objetivo. |
display_name |
Obligatorio. Es el nombre visible de la lista de usuarios. |
description |
Opcional. Es una descripción de la lista de usuarios. |
membership_status |
Opcional. Es el estado de membresía de esta lista de usuarios. |
integration_code |
Opcional. Es un ID de un sistema externo. Los vendedores de listas de usuarios lo utilizan para correlacionar los IDs en sus sistemas. |
closing_reason |
Solo salida. Es el motivo por el que se cerró este estado de membresía de la lista de usuarios. |
account_access_status |
Opcional. Indica si este uso compartido aún está habilitado. Cuando se comparte una lista de usuarios con la cuenta, este campo se establece en |
Campo de unión user_list_info. Es información adicional sobre la lista de usuarios. user_list_info puede ser solo uno de los parámetros siguientes: |
|
ingested_user_list_info |
Opcional. Representa una lista de usuarios que se completa con los datos que se transfieren del usuario. |
AccessReason
Es una enumeración que describe los posibles motivos de acceso.
| Enums | |
|---|---|
ACCESS_REASON_UNSPECIFIED |
No se especifica. |
OWNED |
El usuario es propietario del recurso. |
SHARED |
El recurso se comparte con el usuario. |
LICENSED |
El recurso tiene licencia para el usuario. |
SUBSCRIBED |
El usuario se suscribió al recurso. |
AFFILIATED |
El usuario puede acceder al recurso. |
AccessStatus
Indica si este cliente aún tiene acceso a la lista.
| Enums | |
|---|---|
ACCESS_STATUS_UNSPECIFIED |
No se especifica. |
ENABLED |
El acceso está habilitado. |
DISABLED |
El acceso está inhabilitado. |
ClosingReason
Indica el motivo por el que se cerró la lista de usuarios. Este enum solo se usa cuando el sistema cierra automáticamente una lista.
| Enums | |
|---|---|
CLOSING_REASON_UNSPECIFIED |
No se especifica. |
UNUSED |
Se cerró la lista de usuarios porque no se usó para la segmentación recientemente. Consulta https://support.google.com/google-ads/answer/2472738 para obtener más detalles. |
MembershipStatus
Es el estado de la lista de usuarios.
| Enums | |
|---|---|
MEMBERSHIP_STATUS_UNSPECIFIED |
No se especifica. |
OPEN |
Estado abierto: La lista de usuarios está acumulando miembros y se puede segmentar para ella. |
CLOSED |
Estado cerrado: No se agregan miembros nuevos. |
UserListDirectLicense
Es una licencia directa de lista de usuarios.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del recurso de la licencia directa de la lista de usuarios. |
user_list_display_name |
Solo salida. Es el nombre de la lista de usuarios para la que se otorga la licencia. Este campo es de solo lectura. |
client_account_display_name |
Solo salida. Es el nombre del cliente del cliente para el que se otorga la licencia de la lista de usuarios. Este campo es de solo lectura. |
pricing |
Opcional. Es el precio de la licencia directa de UserList. |
historical_pricings[] |
Solo salida. Es el historial de precios de la licencia de esta lista de usuarios. Este campo es de solo lectura. |
metrics |
Solo salida. Métricas relacionadas con esta licencia Este campo es de solo lectura y solo se completa si se configuran las fechas de inicio y finalización en la llamada ListUserListDirectLicenses. |
user_list_id |
Inmutable. Es el ID de la lista de usuarios a la que se le otorga la licencia. |
client_account_type |
Inmutable. Es el tipo de cuenta del cliente para el que se otorga la licencia de la lista de usuarios. |
client_account_id |
Inmutable. Es el ID del cliente del cliente para el que se otorga la licencia de la lista de usuarios. |
status |
Opcional. Es el estado de UserListDirectLicense: HABILITADO o INHABILITADO. |
UserListGlobalLicense
Es una licencia global de lista de usuarios.
Esta función solo está disponible para los socios de datos.
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del recurso de la licencia global de la lista de usuarios. |
user_list_display_name |
Solo salida. Es el nombre de la lista de usuarios para la que se otorga la licencia. Este campo es de solo lectura. |
pricing |
Opcional. Es el precio de la licencia global de UserList. |
historical_pricings[] |
Solo salida. Es el historial de precios de la licencia de esta lista de usuarios. Este campo es de solo lectura. |
metrics |
Solo salida. Métricas relacionadas con esta licencia Este campo es de solo lectura y solo se completa si se establecen las fechas de inicio y finalización en la llamada a ListUserListGlobalLicenses. |
user_list_id |
Inmutable. Es el ID de la lista de usuarios a la que se le otorga la licencia. |
license_type |
Inmutable. Es el tipo de producto del cliente para el que se otorga la licencia de la lista de usuarios. |
status |
Opcional. Es el estado de UserListGlobalLicense: HABILITADO o INHABILITADO. |
UserListGlobalLicenseCustomerInfo
Es la información sobre un cliente de una licencia global de la lista de usuarios. El sistema lo creará automáticamente cuando un cliente compre una licencia global.
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del recurso del cliente de la licencia global de la lista de usuarios. |
user_list_id |
Solo salida. Es el ID de la lista de usuarios a la que se le otorga la licencia. |
user_list_display_name |
Solo salida. Es el nombre de la lista de usuarios para la que se otorga la licencia. |
license_type |
Solo salida. Es el tipo de producto del cliente para el que se otorga la licencia de la lista de usuarios. |
status |
Solo salida. Es el estado de UserListDirectLicense: HABILITADO o INHABILITADO. |
pricing |
Solo salida. Es el precio de la licencia directa de UserList. |
client_account_type |
Solo salida. Es el tipo de producto del cliente para el que se otorga la licencia de la lista de usuarios. |
client_account_id |
Solo salida. Es el ID del cliente del cliente para el que se otorga la licencia de la lista de usuarios. |
client_account_display_name |
Solo salida. Es el nombre del cliente del cliente para el que se otorga la licencia de la lista de usuarios. |
historical_pricings[] |
Solo salida. Es el historial de precios de la licencia de esta lista de usuarios. |
metrics |
Solo salida. Métricas relacionadas con esta licencia Este campo solo se propaga si se configuran las fechas de inicio y finalización en la llamada ListUserListGlobalLicenseCustomerInfos. |
UserListGlobalLicenseType
Son los tipos de licencias globales de las listas de usuarios.
| Enums | |
|---|---|
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED |
SIN ESPECIFICAR. |
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER |
Licencia de revendedor. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE |
Es una licencia de DataMart Sell Side. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE |
Es una licencia de DataMart Buy Side. |
UserListLicenseClientAccountType
Es el posible producto de una cuenta de cliente para una licencia de lista de usuarios.
| Enums | |
|---|---|
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN |
Desconocido. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS |
Cliente de Google Ads. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER |
Socio de Display & Video 360. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER |
Ser anunciante de Display & Video 360 |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Es la vinculación del público de Google Ad Manager. |
UserListLicenseMetrics
Son métricas relacionadas con una licencia de lista de usuarios.
| Campos | |
|---|---|
click_count |
Solo salida. Es la cantidad de clics para la licencia de la lista de usuarios. |
impression_count |
Solo salida. Es la cantidad de impresiones de la licencia de la lista de usuarios. |
revenue_usd_micros |
Solo salida. Son los ingresos por la licencia de la lista de usuarios en micrones de USD. |
start_date |
Solo salida. Fecha de inicio (inclusive) de las métricas en formato AAAAMMDD. Por ejemplo, 20260102 representa el 2 de enero de 2026. Si se usa |
end_date |
Solo salida. Fecha de finalización (inclusive) de las métricas en formato AAAAMMDD. Por ejemplo, 20260102 representa el 2 de enero de 2026. Si se usa |
UserListLicensePricing
Precios de licencias de listas de usuarios.
| Campos | |
|---|---|
pricing_id |
Solo salida. Es el ID de este precio. |
start_time |
Solo salida. Es la hora de inicio del precio. |
end_time |
Opcional. Es la hora de finalización del precio. |
pricing_active |
Solo salida. Indica si este precio está activo. |
buyer_approval_state |
Solo salida. Es el estado de aprobación del comprador de este precio. Este campo es de solo lectura. |
cost_micros |
Opcional. Es el costo asociado al modelo, en microunidades (10^-6), en la moneda especificada por el campo currency_code. Por ejemplo, 2000000 significa USD 2 si |
currency_code |
Opcional. Es la moneda en la que se especifican el costo y el max_cost. Debe ser un código de moneda de tres letras definido en la norma ISO 4217. |
cost_type |
Inmutable. Es el tipo de costo de este precio. Solo se puede configurar en la operación |
max_cost_micros |
Opcional. Es el CPM máximo que se puede cobrar a un público de comercio cuando se usa el tipo de costo MEDIA_SHARE. El valor está en microunidades (10^-6) y en la moneda especificada en el campo currency_code. Por ejemplo, 2000000 significa USD 2 si Esto solo es relevante cuando cost_type es MEDIA_SHARE. Cuando cost_type no es MEDIA_SHARE y se configura este campo, se mostrará un error MAX_COST_NOT_ALLOWED. Si no se establece o se establece en |
UserListPricingBuyerApprovalState
Es el estado de aprobación del comprador del precio de la lista de usuarios.
| Enums | |
|---|---|
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED |
SIN ESPECIFICAR. |
PENDING |
El cliente de la lista de usuarios aún no aceptó las condiciones de precios establecidas por el propietario de la lista de usuarios. |
APPROVED |
El cliente de la lista de usuarios aceptó las condiciones de precios establecidas por el propietario de la lista de usuarios. |
REJECTED |
El cliente de la lista de usuarios rechazó las condiciones de precios establecidas por el propietario de la lista de usuarios. |
UserListPricingCostType
Es el tipo de costo de precios de la lista de usuarios.
| Enums | |
|---|---|
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED |
Sin especificar. |
CPC |
Es el costo por clic. |
CPM |
Es el costo por cada mil impresiones. |
MEDIA_SHARE |
Compartir contenido multimedia |
UserListLicenseStatus
Es el estado de la licencia de la lista de usuarios.
| Enums | |
|---|---|
USER_LIST_LICENSE_STATUS_UNSPECIFIED |
Desconocido. |
USER_LIST_LICENSE_STATUS_ENABLED |
Estado activo: Se sigue otorgando la licencia de la lista de usuarios. |
USER_LIST_LICENSE_STATUS_DISABLED |
Estado inactivo: Ya no se otorga la licencia de la lista de usuarios. |
UserProperties
Es la información sobre el usuario que evaluó el anunciante en el momento en que ocurrió el evento. Consulta https://support.google.com/google-ads/answer/14007601 para obtener más detalles.
| Campos | |
|---|---|
customer_type |
Opcional. Es el tipo de cliente asociado al evento. |
customer_value_bucket |
Opcional. Es el valor del cliente según la evaluación del anunciante. |
additional_user_properties[] |
Opcional. Es un bucket de las propiedades del usuario adicionales del usuario asociado a este evento. |
UserProperty
Es un bucket de las propiedades del usuario adicionales del usuario asociado a este evento.
| Campos | |
|---|---|
property_name |
Obligatorio. Nombre de la propiedad del usuario que se usará. |
value |
Obligatorio. Es la representación de cadena del valor de la propiedad del usuario que se usará. |
WarningCount
Es el recuento de advertencias para un motivo de advertencia determinado.
| Campos | |
|---|---|
record_count |
Es el recuento de registros que tienen una advertencia. |
reason |
Es el motivo de la advertencia. |
WarningInfo
Son los recuentos de advertencias para cada tipo de advertencia.
| Campos | |
|---|---|
warning_counts[] |
Es una lista de advertencias y recuentos por motivo de advertencia. |