Notification

Only available in Google Ad Manager 360.

Access Data Transfer storage buckets

Access to Data Transfer storage buckets is managed through user roles in Google Ad Manager. Once you have the necessary user role permission, you can use the method of your choice to access your Data Transfer files. 

Jump to a section of the article:

About user roles for the permission

To access the storage buckets, you need to be in a role with the "View data transfer buckets" permission enabled.  

To make changes to user roles, you need to be an Administrator on your network, or have the "Edit users, roles, and teams in Admin tab" permission. Note that a user can only be associated with one role at a time.

For more details, visit Manage user role membership.

View the permission in a role

You can review the role a user is currently in and add or remove the permission as needed. 

  1. Sign in to Google Ad Manager.
  2. Click Admin, then Access & authorization.
  3. Click Roles, and then the name of a role. 
  4. Under "Reporting," locate the "View data transfer buckets" permission.
    Example of where to give user role access to view data transfer buckets in Google Ad Manager
  5. (Optional) To enable the permission for the role, check the box.

Methods to access storage buckets

Google Cloud Storage is a separate Google product that Ad Manager uses as a data repository for Data Transfer reports and batch-uploaded audience cookie IDs.

This article is intended to help you use standard Google Cloud Storage technologies to interface with Ad Manager's specific cloud storage setup. However, your primary reference for Google Cloud Storage is the Google Cloud Storage developer site.

There are three ways you can access Ad Manager cloud storage buckets. In order of complexity:

  • On the web: Visit https://console.developers.google.com/storage/gdfp-[Ad Manager network code].
  • gsutil is a Python-based command-line tool that provides Unix-like commands for interacting with the storage bucket. Bucket authentication is abstracted and handled automatically.
  • The Google Cloud Storage API is a full-featured API for manipulating the storage bucket, available through JSON or XML RESTful web interfaces. API client libraries are available for many popular programming environments, including Java, JavaScript, Python, and Objective-C. This approach is most useful if you need to manipulate the storage buckets programmatically to integrate with a Google App Engine app or a Java web app.

This article provides details on the Google Cloud Storage API. Web and gsutil access are easier to manage, so we recommend exploring these methods first. They are fully documented on the Google Cloud Storage developer site.

Use the Google Cloud Storage API

If you've determined that API access is best for your needs, we recommend that you configure a Google Cloud Storage service account.

Configure a Google Cloud Storage service account

When accessing the storage bucket via the API, it's preferable to configure a service account rather than running in the context of a user. Service accounts simplify application development by using a private key for authentication instead of a dynamically generated OAuth token. To configure a service account:

  1. Go to the Google Developer Console.

  2. Create a new project (or select an existing project) to be the parent of your application and click into it.

  3. (Optional) If you plan to copy files from the Ad Manager storage bucket to your own Google Cloud Storage account, click Billing & settings to add a billing source to your project.

  4. Create a new client ID:

    1. Click APIs & Services and then Credentials.

    2. Click Create new Client ID.

    3. Select Service account as your application type, then click Create Client ID.

    4. The email address generated takes the format [unique-id]@developer.gserviceagccount.com. Add the service account user to your Ad Manager network, and make sure they’re in a role with the "View data transfer buckets" permission. 

    5. Click Generate new P12 key. The file is saved to your computer. Use this key in the applications you develop to access the API, as shown in the code example below.

  5. Users with the "View data transfer buckets" permission will have access to your Ad Manager storage buckets.

Throttling and concurrent connections

There is no predefined limit on concurrent connections. However, to avoid abuse, Google throttles Data Transfer fetch requests.

Read the Google Cloud Storage section of the official Google Code blog for the latest news, and post questions to the Google Cloud Storage Discussion Forum. Add "Bug" or "Feature Request" to the subject line as appropriate. For further Google Cloud Storage questions, see the Google Cloud Storage FAQ.

Was this helpful?

How can we improve it?
8747727471501628999
true
Search Help Center
true
true
true
true
true
148
Search
Clear search
Close search
Main menu
false
false
false