处理指定的来电转化。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。执行上传的客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"conversions": [
{
object ( |
字段 | |
---|---|
conversions[] |
必需。要上传的转化数据。 |
partialFailure |
必需。如果为 true,则会执行成功的操作,并且无效操作将返回错误。如果为 false,则当且仅当所有操作均有效时,所有操作都将在一个事务中执行。此字段应始终设为 true。如需详细了解部分失败,请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。 |
validateOnly |
如果为 true,则对请求进行验证,但不会执行该请求。系统只会返回错误,不会返回结果。 |
响应正文
ConversionUploadService.UploadCallConversions
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "partialFailureError": { object ( |
字段 | |
---|---|
partialFailureError |
与部分失败模式下的转化失败相关的错误。当转化中的所有错误都发生时,系统会返回此错误代码。如果转化之外发生任何错误(例如身份验证错误),我们将返回 RPC 级错误。如需详细了解部分失败,请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。 |
results[] |
针对成功处理的转化返回。对于收到错误的行,Proto 将为空。当 verifyOnly 为 true 时,不返回结果。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
CallConversion
来电转化。
JSON 表示法 |
---|
{ "customVariables": [ { object ( |
字段 | |
---|---|
customVariables[] |
与此转化相关联的自定义变量。 |
consent |
事件的用户意见征求设置。 |
callerId |
接到此来电的来电显示。来电显示应采用 E.164 格式,且前面带有“+”符号,例如“+16502531234”。 |
callStartDateTime |
来电发生的日期时间。必须指定时区。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
conversionAction |
与此转化相关联的转化操作的资源名称。注意:虽然此资源名称由客户 ID 和转化操作 ID 组成,但验证时会忽略客户 ID,并将转化操作 ID 用作转化操作的唯一标识符。 |
conversionDateTime |
转化的发生日期。必须晚于通话时间。必须指定时区。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
conversionValue |
广告客户的转化价值。 |
currencyCode |
与转化价值相关联的币种。这是由 3 个字符组成的 ISO 4217 货币代码。例如:USD、EUR。 |
CallConversionResult
成功处理的 CallConversionUpload 的标识信息。
JSON 表示法 |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
字段 | |
---|---|
callerId |
接到此来电的来电显示。来电显示应采用 E.164 格式,且前面带有“+”。 |
callStartDateTime |
来电发生的日期时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
conversionAction |
与此转化相关联的转化操作的资源名称。 |
conversionDateTime |
转化的发生日期。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |