Descripción general de la API de Administrador de Google Analytics

Resumen: En este documento, se proporciona una descripción general de alto nivel de la versión 1.0 de la API de Admin de Google Analytics.

Advertencia: Esta es una versión preliminar anticipada de la API y está sujeta a cambios. Si bien intentaremos notificarte sobre los próximos cambios, es posible que encuentres cambios rotundos antes de que las APIs se lancen al público.

Los canales alfa y beta de la API siguen siendo compatibles. El canal beta contiene un subconjunto de las funciones disponibles en la versión alfa que se consideran estables y no se espera que experimenten un cambio significativo en el futuro. Las funciones nuevas se agregarán a la versión beta cuando se desarrollen.

Para conocer los anuncios oficiales de la API de Google Analytics, suscríbete al Grupo de notificaciones de la API de Google Analytics. Para informar un problema con la API, utiliza el formulario de comentarios para verificadores de la API de Google Analytics.

Introducción

La API de Admin de Google Analytics permite el acceso programático a los datos de configuración de Google Analytics 4 (GA4) y solo es compatible con las propiedades GA4. Obtén más información sobre las propiedades GA4.

Puedes usar la API de Google Analytics Admin para hacer lo siguiente:

• Aprovisiona cuentas nuevas.
• Administrar cuentas.
• Administra la configuración de uso compartido de datos.
• Enumerar resúmenes de la cuenta
• Busca eventos del historial de cambios.
• Administra propiedades.
• Confirma la recopilación de datos del usuario.
• Administra la configuración de retención de datos de una propiedad.
• Administra la configuración de los indicadores de Google para una propiedad (alfa).
• Administrar transmisiones.
• Administre los secretos del Protocolo de medición.
• Administra el esquema de valor de conversión de SKAdNetwork (alfa).
• Genera un fragmento de la etiqueta de Google para los flujos de datos web (alfa).
• Administra los eventos de conversión.
• Administre las dimensiones personalizadas.
• Administra métricas personalizadas.
• Administra las vinculaciones de las propiedades GA4 y los proyectos de Firebase.
• Administra las vinculaciones de las propiedades GA4 y las cuentas de Google Ads.
• Administra las propuestas de vinculación entre una propiedad GA4 y un anunciante de Display & Video 360 (alfa).
• Administra las vinculaciones entre una propiedad GA4 y un anunciante de Display & Video 360 (alfa).
• Administra las vinculaciones entre una propiedad GA4 y Search Ads 360 (alfa).
• Administra los vínculos entre una propiedad GA4 y un proyecto de BigQuery (Alfa).
• Administra los permisos de usuario de una jerarquía de cuentas y propiedades GA4 (alfa).
• Genera informes de acceso a los datos (alfa).
• Administrar públicos (alfa).
• Administra conjuntos de datos expandidos (alfa).
• Administra los parámetros para inhabilitar el proceso de configuración de GA4 automático (alfa).

Métodos disponibles

Aprovisionamiento de cuentas

• accounts.provisionAccountTicket

  Este método muestra el campo accountTicketId que debe incluirse en la URL de las Condiciones del Servicio (TOS): https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID. Una vez que un usuario visite la URL de las Condiciones del Servicio y acepte las Condiciones del Servicio, se completará la creación de una cuenta de Google Analytics (ejemplo de aprovisionamiento de cuentas).

Administración de cuentas

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

Administración de la configuración del uso compartido de datos

• accounts.getDataSharingSettings

Enumerar resúmenes de la cuenta

• accountSummaries.list

Buscar eventos del historial de cambios

• accounts.searchChangeHistoryEvents

Administración de propiedades

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

Confirmación de recopilación de datos del usuario

• properties.acknowledgeUserDataCollection

Administración de la configuración de retención de datos

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Administración de la configuración de los indicadores de Google (alfa)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

Administración de flujos de datos

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Administración de Secrets del Protocolo de medición

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

Administración del esquema de valor de conversión de SKAdNetwork (alfa)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

Administración de eventos de conversión

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.update

Administración de dimensiones personalizadas

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

Administración de métricas personalizadas

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Vinculación de proyectos de Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Vinculación de cuentas de Google Ads

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Generación de etiquetas de Google (alfa)

• properties.webDataStreams.getGlobalSiteTag

Propuestas para vincular una propiedad GA4 a un anunciante de Display & Video 360 (alfa)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

Vinculación de cuentas de anunciante de Display & Video 360 (alfa)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Vinculación de cuentas de Search Ads 360 (alfa)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

Obtén más información sobre cómo configurar la integración de Analytics en Search Ads 360 para una propiedad GA4.

Vinculación de cuentas de BigQuery (alfa)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

Obtén más información sobre cómo configurar BigQuery Export para una propiedad GA4.

Administración de permisos de usuario (alfa)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Informes de acceso a los datos (alfa)

• properties.runAccessReport

Consulta la guía de Informes de acceso a los datos para obtener más información sobre esta función.

Administración de públicos (alfa)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

Obtén más información sobre los públicos en Google Analytics.

Administración de conjuntos de datos expandidos (alfa)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

Obtén más información sobre los conjuntos de datos expandidos en Google Analytics 360.

Inhabilitación del proceso automático de configuración de GA4 (alfa)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Obtén más información para administrar el estado de inhabilitación del proceso de configuración de GA4 automatizado de una propiedad UA.