Method: customers.userLists.addRecipients

AI-generated Key Takeaways

• Entities like Google Ads Customer, DV360 Partner, and DV360 Advertiser can be added as recipients to an Ads Data Hub-managed user list using the addRecipients method.

• The addRecipients method uses an HTTP POST request to the specified URL, including the user list resource name as a path parameter.

• The request body contains a JSON object with an array of recipientAdsDataLinks strings, representing the linked entities to be added.

• A successful response returns an instance of the UserList object.

• Authorization for this action requires the https://www.googleapis.com/auth/adsdatahub OAuth scope.

• HTTP request
• Path parameters
• Request body
  • JSON representation
• Response body
• Authorization scopes

Add entities to an Ads Data Hub-managed user list’s recipients. Supported entities are: - Google Ads Customer - DV360 Partner - DV360 Advertiser These entities must be linked to the ads data customer associated with the UserList.

HTTP request

POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addRecipients

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
userList	string Required. Full resource name of the user list to be updated. Has the form of customers/[customerId]/userLists/[userlist_id]

Request body

The request body contains data with the following structure:

JSON representation
{ "recipientAdsDataLinks": [ string ] }

Fields
recipientAdsDataLinks[]	string Add these linked entities to the specified userList’s recipients. eg. customers/[customerId]/adsDataLinks/[resource_id]

Response body

If successful, the response body contains an instance of UserList.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/adsdatahub