Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Você pode usar a API Data para acessar os dados de relatórios do Google Analytics de maneira programática. Essa API não é compatível com propriedades legadas do Universal Analytics.
Confira alguns exemplos de relatórios que você pode gerar usando a API Data v1 do Google Analytics:
Quantos usuários ativos por dia seu app Android teve na última semana.
Quantas visualizações de página as 10 principais páginas do seu site tiveram nos últimos 28 dias.
Quantos usuários ativos por país seu app iOS teve nos últimos 30 minutos.
Também é possível usar a API Data do Google Analytics v1 para:
criar painéis personalizados para exibir os dados do Google Analytics;
automatizar tarefas de relatórios complexas para economizar tempo;
integrar seus dados do Google Analytics a outros aplicativos de negócios.
Primeiros passos
Para começar, consulte o Guia
inicial da biblioteca de cliente. Há bibliotecas de cliente em Java,
Python, Node.js e outras linguagens para simplificar a implementação.
runReport: esse método retorna um relatório personalizado dos seus dados de eventos do Google Analytics e é o método preferido para consultas de relatórios simples.
batchRunReports: é uma versão em lote do método runReport, que permite gerar vários relatórios usando uma única chamada de API.
runPivotReport: esse método
retorna um relatório dinâmico personalizado dos dados de eventos do Google Analytics. Os relatórios de pivote são formatos mais avançados e expressivos do que os relatórios
normais. Cada uma delas descreve as colunas e linhas de dimensões visíveis na resposta do relatório.
batchRunPivotReports
É uma versão em lote do método runPivotReport, que permite gerar vários relatórios usando uma única chamada de API.
getMetadata Esse método retorna metadados para dimensões e métricas disponíveis nos métodos de relatórios. Usado para analisar as dimensões e métricas. A resposta desse método também inclui as dimensões e métricas personalizadas disponíveis para a propriedade do Google Analytics especificada.
checkCompatibility Este
método lista as dimensões e métricas que podem ser adicionadas a uma solicitação de relatório
e manter a compatibilidade.
runRealtimeReport: esse método retorna um relatório personalizado de dados de eventos em tempo real para sua propriedade. Os eventos aparecem nos relatórios em tempo real segundos depois de serem enviados ao Google Analytics. Os relatórios de tempo real mostram eventos e dados de uso para períodos que variam do momento atual até 30 minutos atrás (até 60 minutos para propriedades do Google Analytics 360).
properties.recurringAudienceLists(Pré-lançamento) Um grupo de métodos que permite gerenciar exportações recorrentes de público-alvo. Uma exportação recorrente de público-alvo produz novas listas de público-alvo
todos os dias.
runFunnelReport(Pré-lançamento): esse método retorna um relatório de funil personalizado dos dados de eventos do Google Analytics. Com a análise detalhada de funil, você pode conferir as etapas que os usuários seguem até concluir uma tarefa e saber se eles estão tendo sucesso ou falhando em cada uma delas.
Dimensões e métricas compatíveis
Para conferir uma lista de todas as dimensões e métricas compatíveis com a API Data, consulte a
documentação do esquema da API.
[null,null,["Última atualização 2025-03-10 UTC."],[[["\u003cp\u003eThe Google Analytics Data API (v1) allows programmatic access to Google Analytics report data, excluding Universal Analytics properties.\u003c/p\u003e\n"],["\u003cp\u003eThis API offers methods for retrieving various report types, including standard, pivot, realtime, and funnel reports, and enables tasks like building custom dashboards and automating reporting.\u003c/p\u003e\n"],["\u003cp\u003eUsers can leverage client libraries in Java, Python, Node.js, and other languages for streamlined implementation.\u003c/p\u003e\n"],["\u003cp\u003eThe API is currently in Alpha and Beta stages with potential for breaking changes, particularly in Alpha features.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive documentation, including API schema, quickstart guides, and reference materials, are available to aid developers in utilizing the API effectively.\u003c/p\u003e\n"]]],["The Google Analytics Data API allows programmatic access to report data, excluding legacy Universal Analytics properties. It offers Alpha and Beta channels with varying stability. Key actions include generating reports (simple, pivot, funnel, real-time), batching reports, retrieving metadata, and checking compatibility. The API can build dashboards, automate reporting, and integrate data with other apps. Client libraries simplify implementation. Methods include `runReport`, `runPivotReport`, `runFunnelReport`, and managing audience exports, among others.\n"],null,["# Google Analytics Data API Overview\n\nYou can use the [Data API](/analytics/devguides/reporting/data/v1/rest) to\nprogrammatically access Google Analytics (Google Analytics) report data. This\nAPI isn't compatible with legacy Universal Analytics properties.\n\n[Learn more about Google Analytics\nproperties](//support.google.com/analytics/answer/9325020).\n| This API provides features in Alpha and Beta channels. Alpha and Beta products may have limited support, and changes to these products may not be compatible with other Alpha and Beta versions.\n|\n| **Alpha**:\n| Features are in an early preview stage. While we try to notify you of\n| upcoming changes, expect to encounter breaking changes before the API is publicly released.\n|\n| **Beta**:\n| No breaking changes are expected in this channel.\n|\n| For official Google Analytics API announcements, subscribe to the\n| [Google Analytics API Notify Group](https://groups.google.com/forum/#!forum/google-analytics-api-notify).\n\nHere are some examples you might report on using the Google Analytics Data API v1:\n\n- How many daily active users has your Android app had in the last week.\n- How many page views the top 10 pages on your site had in the last 28 days.\n- How many active users per country your iOS app had in the last 30 minutes.\n\nYou can also use the Google Analytics Data API v1 to do the following:\n\n- Build custom dashboards to display Google Analytics data.\n- Automate complex reporting tasks to save time.\n- Integrate your Google Analytics data with other business applications.\n\nGet started\n-----------\n\nTo get started, see the [client library\nquickstart](/analytics/devguides/reporting/data/v1/quickstart-client-libraries). There are client libraries in Java,\nPython, Node.js, and other languages to simplify your implementation.\n\nAvailable methods\n-----------------\n\nHere's a list of the Data API methods. For more details, see the [reference\ndocumentation](/analytics/devguides/reporting/data/v1/rest).\n\n- [`runReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport) This method returns a customized report of your Google Analytics event data and is the preferred method for [simple report queries](/analytics/devguides/reporting/data/v1/basics).\n- [`batchRunReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunReports) This is a batch version of the runReport method which lets you generate multiple reports using a single API call.\n- [`runPivotReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runPivotReport) This method returns a customized [pivot report](/analytics/devguides/reporting/data/v1/pivots) of you Google Analytics event data. Pivot reports are more advanced and expressive formats than regular reports. Each pivot describes the visible dimension columns and rows in the report response.\n- [`batchRunPivotReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunPivotReports) This is a batch version of the runPivotReport method which lets you generate multiple reports using a single API call.\n- [`getMetadata`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) This method returns metadata for dimensions and metrics available in reporting methods. Used to explore the dimensions and metrics. The response of this method also includes the Custom dimensions and metrics available for the specified Google Analytics property.\n- [`checkCompatibility`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/checkCompatibility) This method lists dimensions and metrics that can be added to a report request and maintain compatibility.\n- [`runRealtimeReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) This method returns a customized [report of realtime event data](/analytics/devguides/reporting/data/v1/realtime-basics) for your property. Events appear in realtime reports seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods of time ranging from the present moment to 30 minutes ago (up to 60 minutes for Google Analytics 360 properties).\n- [`properties.audienceExports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports) A group of methods that let you [generate Audience\n Exports](/analytics/devguides/reporting/data/v1/audience-export-basics), which include a snapshot of the users in an audience.\n- [`properties.recurringAudienceLists`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists) **(Early preview)** A group of methods that let you manage recurring Audience Exports. A recurring audience export produces new audience lists each day.\n- [`runFunnelReport`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runFunnelReport) **(Early preview)** This method returns a customized [funnel\n report](/analytics/devguides/reporting/data/v1/funnels) of your Google Analytics event data. Funnel exploration lets you visualize the steps your users take to complete a task and quickly see how well they are succeeding or failing at each step.\n\nSupported dimensions and metrics\n--------------------------------\n\nFor a list of all the dimensions and metrics supported by the Data API, see the\n[API schema documentation](/analytics/devguides/reporting/data/v1/api-schema)."]]
