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 permisos de usuario para una jerarquía de cuenta y propiedades GA4 (Alfa).
• Auditar los permisos del usuario, incluidos los implícitos que provengan de permisos efectivos otorgados por grupos o funciones de administrador de la organización (Alfa)
• Genera informes de acceso a los datos (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.getDataSharingSettingsSettings.

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 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 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

Vínculos entre una propiedad GA4 y un anunciante de Display & amp; Video 360 (Alfa)

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

Administración de permisos de usuario (Alfa)

• accounts.userLinks.create
• accounts.userLinks.get
• accounts.userLinks.list
• accounts.userLinks.patch
• accounts.userLinks.delete
• accounts.userLinks.batchCreate.
• accounts.userLinks.batchGet.
• accounts.userLinks.batchUpdate.

• accounts.userLinks.batchDelete

• properties.userLinks.create

• properties.userLinks.get

• properties.userLinks.list

• properties.userLinks.delete

• properties.userLinks.patch

• properties.userLinks.batchCreate

• properties.userLinks.batchGet

• properties.userLinks.batchUpdate

• properties.userLinks.batchDelete

Auditoría de permisos de usuario (Alfa)

• accounts.userLinks.audit
• properties.userLinks.audit

Informes de acceso a los datos (Alfa)

• properties.runAccessReport Consulte la guía de informes de acceso a los datos para obtener más información acerca de esta función.