Method: customers.uploadCallConversions

處理指定的來電轉換。

擲回錯誤清單：AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP 要求

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。執行上傳作業的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
欄位
conversions[]

object (CallConversion)

必要欄位。正在上傳的轉換資料。
partialFailure

boolean

必要欄位。若為 true，將會執行成功的作業，而且無效的作業也會傳回錯誤。如為 false，則只有在所有作業都有效時，才會在一筆交易中執行所有作業。這個欄位必須一律設為 true。如要進一步瞭解部分失敗，請參閱 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。
validateOnly

boolean

如果為 true，表示要求會完成驗證，但尚未執行。系統只會傳回錯誤，不會傳回結果。

回應主體

「ConversionUploadService.UploadCallConversions」的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
欄位
partialFailureError

object (Status)

部分失敗模式下的轉換失敗相關錯誤。轉換內發生所有錯誤時，系統會傳回這個錯誤代碼。如果在轉換之外發生任何錯誤 (例如驗證錯誤)，系統會傳回遠端程序呼叫 (RPC) 層級錯誤。如要進一步瞭解部分失敗，請參閱 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。
results[]

object (CallConversionResult)

已成功處理的轉換傳回。如果出現收到錯誤的資料列，Proto 會是空白的。VerifyOnly 為 true 時，不會傳回結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

CallConversion

來電轉換。

JSON 表示法 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
欄位
customVariables[]

object (CustomVariable)

與這項轉換相關聯的自訂變數。
consent

object (Consent)

事件的同意聲明設定。
callerId

string

撥打這通電話的來電顯示。來電顯示 ID 必須是 E.164 格式，前面加上「+」符號，例如「+16502531234」。
callStartDateTime

string

發生呼叫的日期。必須指定時區。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」，例如「2019-01-01 12:32:45-08:00」。
conversionAction

string

與此轉換相關聯的轉換動作資源名稱。注意：雖然這個資源名稱是由客戶 ID 和轉換動作 ID 組成，但驗證程序會忽略客戶 ID，並使用轉換動作 ID 做為轉換動作的唯一 ID。
conversionDateTime

string

轉換發生的日期。必須晚於通話時間。必須指定時區。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」，例如「2019-01-01 12:32:45-08:00」。
conversionValue

number

廣告客戶的轉換價值。
currencyCode

string

與轉換價值相關聯的幣別。此為 ISO 4217 3 個字元的貨幣代碼。例如 USD、EUR。

CallConversionResult

針對成功處理的 CallConversionUpload 識別資訊。

JSON 表示法 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
欄位
callerId

string

撥打這通電話的來電顯示。來電顯示應採用 E.164 格式，並在前面加上「+」符號。
callStartDateTime

string

發生呼叫的日期。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」，例如「2019-01-01 12:32:45-08:00」。
conversionAction

string

與此轉換相關聯的轉換動作資源名稱。
conversionDateTime

string

轉換發生的日期。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」，例如「2019-01-01 12:32:45-08:00」。