Google Ads Data Manager V1 Client - Class IngestEventsRequest (0.1.0)

Reference documentation and code samples for the Google Ads Data Manager V1 Client class IngestEventsRequest.

Request to upload audience members to the provided destinations. Returns an IngestEventsResponse.

Generated from protobuf message google.ads.datamanager.v1.IngestEventsRequest

Namespace

Google \ Ads \ DataManager \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ destinations array<Destination>

Required. The list of destinations to send the events to.

↳ events array<Event>

Required. The list of events to send to the specified destinations. At most 2000 Event resources can be sent in a single request.

↳ consent 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 Event.

↳ validate_only bool

Optional. For testing purposes. If true, the request is validated but not executed. Only errors are returned, not results.

↳ encoding int

Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non UserData uploads, this field is ignored.

↳ encryption_info EncryptionInfo

Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non UserData uploads, this field is ignored.

getDestinations

Required. The list of destinations to send the events to.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setDestinations

Required. The list of destinations to send the events to.

Parameter
Name Description
var array<Destination>
Returns
Type Description
$this

getEvents

Required. The list of events to send to the specified destinations. At most 2000 Event resources can be sent in a single request.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setEvents

Required. The list of events to send to the specified destinations. At most 2000 Event resources can be sent in a single request.

Parameter
Name Description
var array<Event>
Returns
Type Description
$this

getConsent

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 Event.

Returns
Type Description
Consent|null

hasConsent

clearConsent

setConsent

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 Event.

Parameter
Name Description
var Consent
Returns
Type Description
$this

getValidateOnly

Optional. For testing purposes. If true, the request is validated but not executed. Only errors are returned, not results.

Returns
Type Description
bool

setValidateOnly

Optional. For testing purposes. If true, the request is validated but not executed. Only errors are returned, not results.

Parameter
Name Description
var bool
Returns
Type Description
$this

getEncoding

Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non UserData uploads, this field is ignored.

Returns
Type Description
int Enum of type Encoding.

setEncoding

Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non UserData uploads, this field is ignored.

Parameter
Name Description
var int

Enum of type Encoding.

Returns
Type Description
$this

getEncryptionInfo

Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted.

For non UserData uploads, this field is ignored.

Returns
Type Description
EncryptionInfo|null

hasEncryptionInfo

clearEncryptionInfo

setEncryptionInfo

Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted.

For non UserData uploads, this field is ignored.

Parameter
Name Description
var EncryptionInfo
Returns
Type Description
$this