Guides API Reference XML Reference Support

Reports API v2.0

The Reports API lets you get various reports for your account or sub accounts.

Path

base_path/api_version/account_id/reports[/report_type][/report_date]

Where:

Path Parameter Description
base_path https://www.googleapis.com/travelpartner
api_version v2.0
account_id A parent account or sub account ID. If you specify a parent account, then data for all sub accounts in addition to the parent account is included.
report_type The type of report that you want. This query string parameter is optional. If you do not specify a value, then the Reports API returns a list of available reports.
report_date The date of the report, in YYYYMMDD format, where YYYY is the year, MM is the month, and DD is the day. If you do not specify the date, then the Reports API returns a list of dates for which the report is available.

Query String Parameters

Parameter Description
include_subaccounts Determines whether to include data about sub accounts in the report.
end_date The end date for a date range, in the format YYYYMMDD.

Supported Methods

HTTP Method Description
GET Gets either a list of reports, a list of dates for which the specified report is available, or the report, depending on which path parameters you specify.

Examples

Gets a list of reports for the specified account:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports

Gets a list of valid dates for the price accuracy reports:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports/price_accuracy

Gets the price accuracy report for 5/31/2016:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports/price_accuracy/20160531

Gets a price accuracy report starting on 5/31/2016 and ending 6/2/2016:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports/price_accuracy/20160531?end_date=20160602

Gets a price accuracy report that includes sub account data, starting on 5/31/2016 and ending 6/2/2016:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports/price_accuracy/20160531?end_date=20160602&include_subaccounts=true

Listing available report types

You can use the Reports API to get a list of valid report types.

To get a list of report types, use the following syntax:

GET https://www.googleapis.com/travelpartner/v2.0/account_id/reports

The following example gets a list of available report types for account 4200042:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports

The response includes a list of reports in a report_types object.

The following example response shows a list of reports types that can be retrieved:

{
  "kind": "travelpartner#reportsListTypes",
  "report_types": [
    "bid_simulation",
    "bid_simulation_cpc_fixed",
    "bid_simulation_cpc_percentage",
    "bid_simulation_target_roas",
    "bid_simulation_commission_guest_stay",
    "book_on_google",
    "booking",
    "budget",
    "click_to_call",
    "commissions_guest_stay",
    "cross_device_conversions",
    "fenced_rates",
    "performance",
    "performance_with_click_type",
    "performance_with_date_type",
    "price_accuracy",
    "price_competitiveness",
    "top_opportunity_7_day"
  ]
}

The following table describes the possible values for report_type:

Report Type Description More Information
bid_simulation Gives you a quick view of the overall bidding landscape and helps you determine what bids to make. This is the same report as the Bid Simulation CPC Percentage Report. Bid Simulation Report
bid_simulation_cpc_fixed Gives you a quick view of the overall CPC fixed bidding landscape and helps you determine what bids to make. Bid Simulation CPC Fixed Report
bid_simulation_cpc_percentage Gives you a quick view of the overall CPC percentage bidding landscape and helps you determine what bids to make. Bid Simulation CPC Percentage Report
bid_simulation_target_roas Gives you a quick view of the overall target ROAS bidding landscape and helps you determine what bids to make. Bid Simulation Target ROAS Report
bid_simulation_commission_guest_stay Gives you a quick view of the overall commission guest stay bidding landscape and helps you determine what bids to make. Bid Simulation Commission Guest Stay Report
book_on_google Gives you performance data about your direct booking flow. Book on Google Mini Report
booking Lists the bookings received through conversion tracking. Bookings Report
budget Lists budget performance metrics and estimated missed opportunities. Budget Report
click_to_call Shows conversion data and other metrics related to Click to Call campaigns. Click to Call Mini Report
cross_device_conversions Shows conversions when a customer clicked on a hotel ad using one device and booked the hotel using another device. Cross Device Conversions report
commissions_guest_stay Provides commissions net of guest stay and other details about billing. Commissions Mini Report
fenced_rates Provides details on the traffic received from each offer which is based on the end-user's device and domain (if you implement fenced rates). Fenced Rates Performance Report
performance Includes the performance report, plus additional conversion tracking-specific fields. If no report_type value is provided, the Reports API returns the dates that are available for this report type. Performance Report with Conversion Metrics
performance_with_date_type The same as the performance report, but includes the date type (either "default" or "selected"). Performance Report with Conversion Metrics
performance_with_click_type Includes the same information as the performance report, but also includes the click type, which is either "standard" (for the standard booking module) or "room booking module." Performance Report with Conversion Metrics
price_accuracy Lists a sample set of itineraries and the date/times when prices for those itineraries were fetched and cached. Price Accuracy Report
price_competitiveness Provides insights into how your prices compare to competitors' prices on the same hotel itineraries. Price Competitiveness Report
top_opportunity_7_day Lists opportunities you might have missed per hotel over a 7-day period. Includes breakdowns of missed opportunities by type. Opportunity Report

Listing available dates for a report

To get a list of available dates for a particular report, submit a GET request with the following syntax:

GET https://www.googleapis.com/travelpartner/v2.0/account_id/reports/report_type

You must include report_type, and it must be one of the values listed in Listing report types.

The following example gets a list of dates for which the account's price accuracy report is available:

GET https://www.googleapis.com/travelpartner/v2.0/420042/reports/price_accuracy

The response includes a list of dates in a date object. The dates are in an array in YYYYMMDD format, where YYYY is the year, MM is the month, and DD is the day. Each date in the array represents a different report that contains data for that day.

The following example response shows a list of dates for which the report is available:

{
  "kind": "travelpartner#reportsList",
  "date": [
    "20160601",
    "20160531",
    "20160530",
    "20160529",
    "20160528",
    "20160527",
    "20160526",
  ]
}

After executing a request for dates, you typically follow up with a second request to get a report for a certain date, as shown in Getting a report.

Getting a report

To get a report, submit a GET request with the following syntax:

GET https://www.googleapis.com/travelpartner/v2.0/account_id/reports/report_type/report_date

report_type and report_date (YYYYMMDD format) are required.

The following example gets the price accuracy report for 5/31/2016 for account 4200042:

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports/price_accuracy/20160531

The Reports API returns a CSV file for the report attached to the response. CSV files returned by the Reports API include the column names as the first row in the response.

Including sub account data

You can include data for sub accounts in your reports.

To include data about sub accounts in the report, set the include_subaccounts query string parameter to "true".

The following example gets the price accuracy report for the parent account (4200042) and all its sub accounts: 

GET https://www.googleapis.com/travelpartner/v2.0/4200042/reports/price_accuracy/20160531?
  include_subaccounts=true

When you set include_subaccounts to "true", the report aggregates the data of the specified parent account in addition to the data for all its sub accounts. If you set include_subaccounts to "false", then the report includes only data about the specified account.

The default value of include_subaccounts is "false".

Reports API Changes

Changes to v2.0 of the Reports API include the following:

  • The Reports API uses the new RESTful syntax.
  • Lets you include sub-account data in the report.
  • Removed the Room Types report.
  • Replaced the Top Opportunity 7 Day report with the breakdown version of the report. The original Top Opportunity Report has been deprecated.
  • There is a new report type, cross_device_conversions, that you can request.
  • You can now request a performance_with_click_type report.