AI-generated Key Takeaways
-
The content provides reference information for the
audienceMembers:ingest
method, which is used to upload a list of AudienceMember resources to specified Destinations. -
The HTTP request method is POST to the specified endpoint using gRPC Transcoding syntax.
-
The request body requires
destinations
andaudienceMembers
, with optional fields likeconsent
,validateOnly
,encoding
,encryptionInfo
, andtermsOfService
. -
A successful response body contains the auto-generated
requestId
. -
The method requires the
https://www.googleapis.com/auth/datamanager
OAuth scope for authorization.
- HTTP request
- Request body
- Response body
- Authorization scopes
- TermsOfService
- TermsOfServiceStatus
- Try it!
Uploads a list of AudienceMember
resources to the provided Destination
.
HTTP request
POST https://datamanager.googleapis.com/v1/audienceMembers:ingest
The URL uses gRPC Transcoding syntax.
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "destinations": [ { object ( |
Fields | |
---|---|
destinations[] |
Required. The list of destinations to send the audience members to. |
audienceMembers[] |
Required. The list of users to send to the specified destinations. At most 10000 |
consent |
Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each |
validateOnly |
Optional. For testing purposes. If |
encoding |
Optional. Required for |
encryptionInfo |
Optional. Encryption information for |
termsOfService |
Optional. The terms of service that the user has accepted/rejected. |
Response body
Response from the IngestAudienceMembersRequest
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "requestId": string } |
Fields | |
---|---|
requestId |
The auto-generated ID of the request. |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/datamanager
TermsOfService
The terms of service that the user has accepted/rejected.
JSON representation |
---|
{
"customerMatchTermsOfServiceStatus": enum ( |
Fields | |
---|---|
customerMatchTermsOfServiceStatus |
Optional. The Customer Match terms of service: https://support.google.com/adspolicy/answer/6299717. This must be accepted when ingesting |
TermsOfServiceStatus
Represents the caller's decision to accept or reject the terms of service.
Enums | |
---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
Not specified. |
ACCEPTED |
Status indicating the caller has chosen to accept the terms of service. |
REJECTED |
Status indicating the caller has chosen to reject the terms of service. |