Ads API .NET library
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
Google.Api.Ads.AdManager.v202208.ReportService Class Reference

Provides methods for executing a ReportJob and retrieving performance and statistics about ad campaigns, networks, inventory and sales. More...

Inheritance diagram for Google.Api.Ads.AdManager.v202208.ReportService:
Google.Api.Ads.AdManager.v202208.IReportService Google.Api.Ads.AdManager.v202208.ReportServiceInterface

Public Member Functions

 ReportService ()
 Creates a new instance of the ReportService class. More...
 
 ReportService (string endpointConfigurationName)
 Creates a new instance of the ReportService class. More...
 
 ReportService (string endpointConfigurationName, string remoteAddress)
 Creates a new instance of the ReportService class. More...
 
 ReportService (string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress)
 Creates a new instance of the ReportService class. More...
 
 ReportService (System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress)
 Creates a new instance of the ReportService class. More...
 
virtual string getReportDownloadURL (long reportJobId, Google.Api.Ads.AdManager.v202208.ExportFormat exportFormat)
 Returns the URL at which the report file can be downloaded. More...
 
virtual
System.Threading.Tasks.Task
< string > 
getReportDownloadURLAsync (long reportJobId, Google.Api.Ads.AdManager.v202208.ExportFormat exportFormat)
 
virtual string getReportDownloadUrlWithOptions (long reportJobId, Google.Api.Ads.AdManager.v202208.ReportDownloadOptions reportDownloadOptions)
 Returns the URL at which the report file can be downloaded, and allows for customization of the downloaded report. More...
 
virtual
System.Threading.Tasks.Task
< string > 
getReportDownloadUrlWithOptionsAsync (long reportJobId, Google.Api.Ads.AdManager.v202208.ReportDownloadOptions reportDownloadOptions)
 
virtual
Google.Api.Ads.AdManager.v202208.ReportJobStatus 
getReportJobStatus (long reportJobId)
 Returns the ReportJobStatus of the report job with the specified ID. More...
 
virtual
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202208.ReportJobStatus
getReportJobStatusAsync (long reportJobId)
 
virtual
Google.Api.Ads.AdManager.v202208.SavedQueryPage 
getSavedQueriesByStatement (Google.Api.Ads.AdManager.v202208.Statement filterStatement)
 Retrieves a page of the saved queries either created by or shared with the current user. Each SavedQuery in the page, if it is compatible with the current API version, will contain a ReportQuery object which can be optionally modified and used to create a ReportJob. This can then be passed to ReportService::runReportJob. The following fields are supported for filtering: More...
 
virtual
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202208.SavedQueryPage
getSavedQueriesByStatementAsync (Google.Api.Ads.AdManager.v202208.Statement filterStatement)
 
virtual
Google.Api.Ads.AdManager.v202208.ReportJob 
runReportJob (Google.Api.Ads.AdManager.v202208.ReportJob reportJob)
 Initiates the execution of a ReportQuery on the server. More...
 
virtual
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202208.ReportJob
runReportJobAsync (Google.Api.Ads.AdManager.v202208.ReportJob reportJob)
 

Detailed Description

Provides methods for executing a ReportJob and retrieving performance and statistics about ad campaigns, networks, inventory and sales.

Follow the steps outlined below:



Test network behavior

The networks created using NetworkService::makeTestNetwork are unable to provide reports that would be comparable to the production environment because reports require traffic history. In the test networks, reports will consistently return no data for all reports.

Constructor & Destructor Documentation

Google.Api.Ads.AdManager.v202208.ReportService.ReportService ( )
inline

Creates a new instance of the ReportService class.

Google.Api.Ads.AdManager.v202208.ReportService.ReportService ( string  endpointConfigurationName)
inline

Creates a new instance of the ReportService class.

Google.Api.Ads.AdManager.v202208.ReportService.ReportService ( string  endpointConfigurationName,
string  remoteAddress 
)
inline

Creates a new instance of the ReportService class.

Google.Api.Ads.AdManager.v202208.ReportService.ReportService ( string  endpointConfigurationName,
System.ServiceModel.EndpointAddress  remoteAddress 
)
inline

Creates a new instance of the ReportService class.

Google.Api.Ads.AdManager.v202208.ReportService.ReportService ( System.ServiceModel.Channels.Binding  binding,
System.ServiceModel.EndpointAddress  remoteAddress 
)
inline

Creates a new instance of the ReportService class.

Member Function Documentation

virtual string Google.Api.Ads.AdManager.v202208.ReportService.getReportDownloadURL ( long  reportJobId,
Google.Api.Ads.AdManager.v202208.ExportFormat  exportFormat 
)
inlinevirtual

Returns the URL at which the report file can be downloaded.

The report will be generated as a gzip archive, containing the report file itself.

Parameters
reportJobIdthe ID of the ReportJob
exportFormatthe ExportFormat for the report file
Returns
the URL for report file download

Implements Google.Api.Ads.AdManager.v202208.ReportServiceInterface.

virtual System.Threading.Tasks.Task<string> Google.Api.Ads.AdManager.v202208.ReportService.getReportDownloadURLAsync ( long  reportJobId,
Google.Api.Ads.AdManager.v202208.ExportFormat  exportFormat 
)
inlinevirtual
virtual string Google.Api.Ads.AdManager.v202208.ReportService.getReportDownloadUrlWithOptions ( long  reportJobId,
Google.Api.Ads.AdManager.v202208.ReportDownloadOptions  reportDownloadOptions 
)
inlinevirtual

Returns the URL at which the report file can be downloaded, and allows for customization of the downloaded report.

By default, the report will be generated as a gzip archive, containing the report file itself. This can be changed by setting ReportDownloadOptions::useGzipCompression to false.

Parameters
reportJobIdthe ID of the ReportJob
reportDownloadOptionsthe ReportDownloadOptions for the request
Returns
the URL for report file download

Implements Google.Api.Ads.AdManager.v202208.ReportServiceInterface.

virtual System.Threading.Tasks.Task<string> Google.Api.Ads.AdManager.v202208.ReportService.getReportDownloadUrlWithOptionsAsync ( long  reportJobId,
Google.Api.Ads.AdManager.v202208.ReportDownloadOptions  reportDownloadOptions 
)
inlinevirtual
virtual Google.Api.Ads.AdManager.v202208.ReportJobStatus Google.Api.Ads.AdManager.v202208.ReportService.getReportJobStatus ( long  reportJobId)
inlinevirtual

Returns the ReportJobStatus of the report job with the specified ID.

Implements Google.Api.Ads.AdManager.v202208.ReportServiceInterface.

virtual System.Threading.Tasks.Task<Google.Api.Ads.AdManager.v202208.ReportJobStatus> Google.Api.Ads.AdManager.v202208.ReportService.getReportJobStatusAsync ( long  reportJobId)
inlinevirtual
virtual Google.Api.Ads.AdManager.v202208.SavedQueryPage Google.Api.Ads.AdManager.v202208.ReportService.getSavedQueriesByStatement ( Google.Api.Ads.AdManager.v202208.Statement  filterStatement)
inlinevirtual

Retrieves a page of the saved queries either created by or shared with the current user. Each SavedQuery in the page, if it is compatible with the current API version, will contain a ReportQuery object which can be optionally modified and used to create a ReportJob. This can then be passed to ReportService::runReportJob. The following fields are supported for filtering:

PQL Property Object Property
id SavedQuery::id
name SavedQuery::name
Parameters
filterStatementa Publisher Query Language statement used to filter which saved queries should be returned.
Returns
a SavedQueryPage that contains all SavedQuery instances which satisfy the given statement.

Implements Google.Api.Ads.AdManager.v202208.ReportServiceInterface.

virtual System.Threading.Tasks.Task<Google.Api.Ads.AdManager.v202208.SavedQueryPage> Google.Api.Ads.AdManager.v202208.ReportService.getSavedQueriesByStatementAsync ( Google.Api.Ads.AdManager.v202208.Statement  filterStatement)
inlinevirtual
virtual Google.Api.Ads.AdManager.v202208.ReportJob Google.Api.Ads.AdManager.v202208.ReportService.runReportJob ( Google.Api.Ads.AdManager.v202208.ReportJob  reportJob)
inlinevirtual

Initiates the execution of a ReportQuery on the server.

The following fields are required:

Parameters
reportJobthe report job to run
Returns
the report job with its ID filled in

Implements Google.Api.Ads.AdManager.v202208.ReportServiceInterface.

virtual System.Threading.Tasks.Task<Google.Api.Ads.AdManager.v202208.ReportJob> Google.Api.Ads.AdManager.v202208.ReportService.runReportJobAsync ( Google.Api.Ads.AdManager.v202208.ReportJob  reportJob)
inlinevirtual

The documentation for this class was generated from the following file: