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 Administrador de Google Analytics.

Advertencia: Esta es una versión preliminar de la API y está sujeta a cambios. Si bien intentaremos notificarte sobre los próximos cambios, deberías encontrar cambios rotundos antes de que se lancen públicamente las API.

Los canales Alfa y Beta de la API continúan siendo compatibles. El canal Beta contiene un subconjunto de las funciones disponibles en 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 desarrollen.

Para ver los anuncios oficiales de la API de Google Analytics, suscríbete a Notificar al grupo de la API de Google Analytics. Para informar un problema con la API, usa el Formulario de comentarios para verificadores de la API de Google Analytics.

Introducción

La API de Administrador 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. Obtenga más información sobre las propiedades GA4.

Puedes usar la API de Administrador de Google Analytics para lo siguiente:

• Aprovisiona cuentas nuevas.
• Administrar cuentas.
• Administra la configuración del uso compartido de datos.
• Enumerar resúmenes de cuenta
• Buscar 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.
• Administrar la configuración de los indicadores de Google de una propiedad (Alfa)
• Administra transmisiones.
• Administre los secretos del Protocolo de medición.
• Genere un fragmento de etiqueta de Google para flujos de datos web (Alfa).
• Administre los eventos de conversión.
• Administre dimensiones personalizadas.
• Administra métricas personalizadas.
• Administre las vinculaciones de las propiedades GA4 y los proyectos de Firebase.
• Administre las vinculaciones de las propiedades GA4 y las cuentas de Google Ads.
• Administre las propuestas de vinculación entre una propiedad GA4 y un anunciante de Display & amp; Video 360 (Alfa).
• Administre los vínculos entre una propiedad GA4 y un anunciante de Display & amp; Video 360 (Alfa)
• Administre los vínculos entre una propiedad GA4 y Search Ads 360 (Alfa)
• Administre los vínculos entre una propiedad GA4 y un proyecto de BigQuery (Alfa)
• Administre los permisos de usuario para una jerarquía de cuenta y propiedades GA4 (Alfa).
• Genera informes de acceso a los datos (Alfa).
• Administrar públicos (Alfa)
• Administrar conjuntos de datos expandidos (Alfa)
• Administre la configuración de inhabilitación automática del proceso de configuración de GA4 (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 creará una cuenta de Google Analytics (ejemplo de aprovisionamiento de cuenta).

Administración de cuentas

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

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

• accounts.getDataSharingSettings

Enumerar resúmenes de 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 la recopilación de los 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 secretos 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 de eventos de conversión

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

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 proyecto 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 & amp; 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 anunciantes de Display & amp; Video 360 (Alfa)

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

Vinculación de la cuenta de Search Ads 360 (Alfa)

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

Obtenga más información sobre cómo configurar la integración de Analytics 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.audience.create
• properties.audience.archive
• properties.audience.patch
• properties.audience.list
• properties.audience.get

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

Administración expandida de los conjuntos de datos (Alfa)

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

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

Inhabilitación automática del proceso de configuración de GA4 (Alfa)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Obtenga más información sobre cómo administrar el estado de inhabilitación del proceso automatizado de configuración de GA4 para una propiedad UA.