UploadClickConversionsRequest

  • The UploadClickConversionsRequest message is used for uploading click conversions via the ConversionUploadService.

  • It requires the customer_id and an array of ClickConversion objects.

  • The partial_failure field must be set to true to ensure successful operations are carried out even if some are invalid.

  • The validate_only field can be set to true to validate the request without execution.

  • An optional job_id can be provided, otherwise, the API will generate one.

Request message for ConversionUploadService.UploadClickConversions.

Fields

customer_id

string

Required. The ID of the customer performing the upload.

conversions[]

ClickConversion

Required. The conversions that are being uploaded.

partial_failure

bool

Required. If true, successful operations will be carried out and invalid operations will return errors. If false, all operations will be carried out in one transaction if and only if they are all valid. This should always be set to true. See https://developers.google.com/google-ads/api/docs/best-practices/partial-failures for more information about partial failure.

validate_only

bool

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

job_id

int32

Optional. Optional input to set job ID. Must be a non-negative number that is less than 2^31 if provided. If this field is not provided, the API will generate a job ID in the range [2^31, (2^63)-1]. The API will return the value for this request in the job_id field of the UploadClickConversionsResponse.