Data Manager API

  • The unified ingestion API allows data partners, agencies, and advertisers to connect first-party data across Google advertising products.

  • The API provides REST resources for managing audience members, ingesting events, and retrieving request status.

  • Google recommends using their provided client libraries to call the datamanager.googleapis.com service.

  • A Discovery Document and a service endpoint are available for developers building their own client libraries.

  • The v1.audienceMembers resource supports ingesting and removing audience members.

  • The v1.events resource supports ingesting events.

  • The v1.requestStatus resource allows retrieving the status of a request by its ID.

A unified ingestion API for data partners, agencies and advertisers to connect first-party data across Google advertising products.

Service: datamanager.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://datamanager.googleapis.com

REST Resource: v1.accountTypes.accounts.insights

Methods
retrieve POST /v1/{parent=accountTypes/*/accounts/*}/insights:retrieve
Retrieves marketing data insights for a given user list.

REST Resource: v1.accountTypes.accounts.userListDirectLicenses

Methods
create POST /v1/{parent=accountTypes/*/accounts/*}/userListDirectLicenses
Creates a user list direct license.
get GET /v1/{name=accountTypes/*/accounts/*/userListDirectLicenses/*}
Retrieves a user list direct license.
list GET /v1/{parent=accountTypes/*/accounts/*}/userListDirectLicenses
Lists all user list direct licenses owned by the parent account.
patch PATCH /v1/{userListDirectLicense.name=accountTypes/*/accounts/*/userListDirectLicenses/*}
Updates a user list direct license.

REST Resource: v1.accountTypes.accounts.userListGlobalLicenses

Methods
create POST /v1/{parent=accountTypes/*/accounts/*}/userListGlobalLicenses
Creates a user list global license.
get GET /v1/{name=accountTypes/*/accounts/*/userListGlobalLicenses/*}
Retrieves a user list global license.
list GET /v1/{parent=accountTypes/*/accounts/*}/userListGlobalLicenses
Lists all user list global licenses owned by the parent account.
patch PATCH /v1/{userListGlobalLicense.name=accountTypes/*/accounts/*/userListGlobalLicenses/*}
Updates a user list global license.

REST Resource: v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos

Methods
list GET /v1/{parent=accountTypes/*/accounts/*/userListGlobalLicenses/*}/userListGlobalLicenseCustomerInfos
Lists all customer info for a user list global license.

REST Resource: v1.accountTypes.accounts.userLists

Methods
create POST /v1/{parent=accountTypes/*/accounts/*}/userLists
Creates a UserList.
delete DELETE /v1/{name=accountTypes/*/accounts/*/userLists/*}
Deletes a UserList.
get GET /v1/{name=accountTypes/*/accounts/*/userLists/*}
Gets a UserList.
list GET /v1/{parent=accountTypes/*/accounts/*}/userLists
Lists UserLists.
patch PATCH /v1/{userList.name=accountTypes/*/accounts/*/userLists/*}
Updates a UserList.

REST Resource: v1.audienceMembers

Methods
ingest POST /v1/audienceMembers:ingest
Uploads a list of AudienceMember resources to the provided Destination.
remove POST /v1/audienceMembers:remove
Removes a list of AudienceMember resources from the provided Destination.

REST Resource: v1.events

Methods
ingest POST /v1/events:ingest
Uploads a list of Event resources from the provided Destination.

REST Resource: v1.requestStatus

Methods
retrieve GET /v1/requestStatus:retrieve
Gets the status of a request given request id.