Overview
Stay organized with collections
Save and categorize content based on your preferences.
This guide leads you through using the Bid Manager API to create and run a query,
then downloading the resulting report.
Prerequisites
Before you start this guide, complete the following tasks:
- Generate credentials and configure your client.
Ensure your Display & Video 360 user has one of the following user
roles for each Partner or Advertiser that you pull report data
for:
- Admin
- Standard
- Read only
- Reporting only
- Reporting only -- limited
Note that the Reporting only -- limited user role greatly limits the type
of reporting data that you can retrieve. If you don't have one of these user
roles, contact an Admin user on your team to grant you these permissions.
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-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis guide provides step-by-step instructions for utilizing the Bid Manager API to create queries, execute them, and download the resulting reports.\u003c/p\u003e\n"],["\u003cp\u003eBefore proceeding, ensure you have generated credentials, configured your client, and verified your Display & Video 360 user role has sufficient permissions to access and retrieve report data.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nThis guide leads you through using the Bid Manager API to create and run a query,\nthen downloading the resulting report.\n\nPrerequisites\n-------------\n\nBefore you start this guide, complete the following tasks:\n\n1. [Generate credentials](/bid-manager/guides/get-started/generate-credentials) and [configure your client](/bid-manager/guides/get-started/install-configure).\n2. Ensure your Display \\& Video 360 user has one of the following [user\n roles](//support.google.com/displayvideo/answer/2723011) for each Partner or Advertiser that you pull report data\n for:\n\n - **Admin**\n - **Standard**\n - **Read only**\n - **Reporting only**\n - **Reporting only -- limited**\n\n Note that the **Reporting only -- limited** user role greatly limits the type\n of reporting data that you can retrieve. If you don't have one of these user\n roles, contact an **Admin** user on your team to grant you these permissions."]]
