Method: accounts.reports.saved.generate
Stay organized with collections
Save and categorize content based on your preferences.
Generates a saved report.
HTTP request
GET https://adsense.googleapis.com/v2/{name=accounts/*/reports/*}/saved:generate
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. Name of the saved report. Format: accounts/{account}/reports/{report}
|
Query parameters
| Parameters |
dateRange |
enum (ReportingDateRange)
Date range of the report, if unset the range will be considered CUSTOM.
|
startDate |
object (Date)
Start of the date range to report on, inclusive. Only needed when dateRange is CUSTOM or unspecified.
|
endDate |
object (Date)
End of the date range to report on, inclusive. Only needed when dateRange is CUSTOM or unspecified.
|
languageCode |
string
The language to use for translating report output. If unspecified, this defaults to English ("en"). If the given language is not supported, report output will be returned in English. The language is specified as an IETF BCP-47 language code.
|
currencyCode |
string
The ISO-4217 currency code to use when reporting on monetary metrics. Defaults to the account's currency if not set.
|
reportingTimeZone |
enum (ReportingTimeZone)
Timezone in which to generate the report. If unspecified, this defaults to the account timezone. For more information, see changing the time zone of your reports.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of ReportResult.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-28 UTC.
[null,null,["Last updated 2025-02-28 UTC."],[[["\u003cp\u003eGenerates a saved report based on specified criteria, such as date range, language, and currency.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ename\u003c/code\u003e path parameter which represents the saved report to generate in the format \u003ccode\u003eaccounts/{account}/reports/{report}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAccepts optional query parameters for customizing the report output like \u003ccode\u003edateRange\u003c/code\u003e, \u003ccode\u003elanguageCode\u003c/code\u003e, and \u003ccode\u003ecurrencyCode\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eGET\u003c/code\u003e HTTP method and requires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/adsense\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/adsense.readonly\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eReturns a \u003ccode\u003eReportResult\u003c/code\u003e object in the response body upon successful execution.\u003c/p\u003e\n"]]],["This document details the process for generating a saved report via a `GET` HTTP request to `https://adsense.googleapis.com/v2/{name=accounts/*/reports/*}/saved:generate`. The `name` path parameter is required, specifying the report's location. Optional query parameters include `dateRange`, `startDate`, `endDate`, `languageCode`, `currencyCode`, and `reportingTimeZone`. The request body must be empty, and a successful response returns a `ReportResult`. Authorization requires either the `adsense` or `adsense.readonly` OAuth scope.\n"],null,["# Method: accounts.reports.saved.generate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGenerates a saved report.\n\n### HTTP request\n\n`GET https://adsense.googleapis.com/v2/{name=accounts/*/reports/*}/saved:generate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Name of the saved report. Format: accounts/{account}/reports/{report} |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dateRange` | `enum (`[ReportingDateRange](/adsense/management/reference/rest/v2/ReportingDateRange)`)` Date range of the report, if unset the range will be considered CUSTOM. |\n| `startDate` | `object (`[Date](/adsense/management/reference/rest/v2/Date)`)` Start of the date range to report on, inclusive. Only needed when dateRange is CUSTOM or unspecified. |\n| `endDate` | `object (`[Date](/adsense/management/reference/rest/v2/Date)`)` End of the date range to report on, inclusive. Only needed when dateRange is CUSTOM or unspecified. |\n| `languageCode` | `string` The language to use for translating report output. If unspecified, this defaults to English (\"en\"). If the given language is not supported, report output will be returned in English. The language is specified as an [IETF BCP-47 language code](https://en.wikipedia.org/wiki/IETF_language_tag). |\n| `currencyCode` | `string` The [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) to use when reporting on monetary metrics. Defaults to the account's currency if not set. |\n| `reportingTimeZone` | `enum (`[ReportingTimeZone](/adsense/management/reference/rest/v2/ReportingTimeZone)`)` Timezone in which to generate the report. If unspecified, this defaults to the account timezone. For more information, see [changing the time zone of your reports](https://support.google.com/adsense/answer/9830725). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ReportResult](/adsense/management/reference/rest/v2/ReportResult).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/adsense`\n- `\n https://www.googleapis.com/auth/adsense.readonly`"]]
