type SavedQuery (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
A saved ReportQuery representing the selection criteria for running a report.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
id
|
xsd:long
The ID of the saved query.
|
name
|
xsd:string
The name of the saved query.
|
reportQuery
|
ReportQuery
The ReportQuery representing the selection criteria for the saved query. This will be
non-null if and only if SavedQuery.isCompatibleWithApiVersion is true .
|
isCompatibleWithApiVersion
|
xsd:boolean
Whether or not the saved query is compatible with the current API version. This will be true if and only if SavedQuery.reportQuery is non-null. A saved query will be
incompatible with the API if it uses columns, dimensions, or other reporting features from the
UI that are not available in the ReportQuery entity.
|
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-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eA SavedQuery stores selection criteria for running a report, essentially a saved ReportQuery.\u003c/p\u003e\n"],["\u003cp\u003eIt is identified by a unique ID and has a descriptive name.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereportQuery\u003c/code\u003e field contains the actual query definition but is only populated if the saved query is compatible with the current API version.\u003c/p\u003e\n"],["\u003cp\u003eCompatibility is indicated by the \u003ccode\u003eisCompatibleWithApiVersion\u003c/code\u003e field and hinges on whether the saved query utilizes features supported by the ReportQuery entity in the API.\u003c/p\u003e\n"]]],["The `SavedQuery` within the `ReportService` defines the criteria for running a report, represented by a `ReportQuery`. Key fields include the `id` and `name` of the saved query. The `reportQuery` specifies the selection criteria and is present only if the query is compatible with the current API version. `isCompatibleWithApiVersion` indicates whether the saved query works with the current API; this field is true only if `reportQuery` is defined.\n"],null,["# type SavedQuery (v202408)\n\n**Service** \n**ReportService** **Dependencies** \n[SavedQueryPage](/ad-manager/api/reference/v202408/ReportService.SavedQueryPage) \n▼\n**SavedQuery**\n\nA saved [ReportQuery](/ad-manager/api/reference/v202408/ReportService.ReportQuery) representing the selection criteria for running a report.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `id` | ` `xsd:`long` The ID of the saved query. |\n| ### `name` | ` `xsd:`string` The name of the saved query. |\n| ### `reportQuery` | ` `[ReportQuery](/ad-manager/api/reference/v202408/ReportService.ReportQuery)` ` The [ReportQuery](/ad-manager/api/reference/v202408/ReportService.ReportQuery) representing the selection criteria for the saved query. This will be non-null if and only if [SavedQuery.isCompatibleWithApiVersion](/ad-manager/api/reference/v202408/ReportService.SavedQuery#isCompatibleWithApiVersion) is `true`. |\n| ### `isCompatibleWithApiVersion` | ` `xsd:`boolean` Whether or not the saved query is compatible with the current API version. This will be `true` if and only if [SavedQuery.reportQuery](/ad-manager/api/reference/v202408/ReportService.SavedQuery#reportQuery) is non-null. A saved query will be incompatible with the API if it uses columns, dimensions, or other reporting features from the UI that are not available in the [ReportQuery](/ad-manager/api/reference/v202408/ReportService.ReportQuery) entity. |"]]