Teste o servidor MCP do Google Analytics. Instale no
GitHub e confira o
anúncio para mais detalhes.
Method: properties.reportTasks.create
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Inicia a criação de uma tarefa de relatório. Esse método retorna rapidamente uma tarefa de relatório e inicia uma solicitação assíncrona de longa duração para formar um relatório personalizado dos dados de eventos do Google Analytics.
Uma tarefa de relatório será retida e ficará disponível para consulta por 72 horas após ter sido criada.
Uma tarefa de relatório criada por um usuário pode ser listada e consultada por todos os usuários com acesso à propriedade.
Solicitação HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
parent |
string
Obrigatório. O recurso pai em que essa tarefa de relatório será criada. Formato: properties/{propertyId}
|
Corpo da solicitação
O corpo da solicitação contém uma instância de ReportTask.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eInitiates a long-running asynchronous request to create a customized report of Google Analytics event data.\u003c/p\u003e\n"],["\u003cp\u003eCreated report tasks are retained and available for querying for 72 hours.\u003c/p\u003e\n"],["\u003cp\u003eReport tasks are accessible to all users with property access.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/analytics.readonly\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/analytics\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This describes the process to create a report task for Google Analytics event data. A `POST` request is sent to `https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks`, where `parent` specifies the property. The request body must include a `ReportTask` instance. Upon success, it will respond with an `Operation` instance. Authorization requires either the `analytics.readonly` or `analytics` scope. Created tasks are retained for 72 hours and accessible to all property users.\n"],null,["# Method: properties.reportTasks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nInitiates the creation of a report task. This method quickly returns a report task and initiates a long running asynchronous request to form a customized report of your Google Analytics event data.\n\nA report task will be retained and available for querying for 72 hours after it has been created.\n\nA report task created by one user can be listed and queried by all users who have access to the property.\n\n### HTTP request\n\n`POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource where this report task will be created. Format: `properties/{propertyId}` |\n\n### Request body\n\nThe request body contains an instance of [ReportTask](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.reportTasks#ReportTask).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/analytics/devguides/reporting/data/v1/rest/Shared.Types/Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics`"]]
