處理指定的來電轉換。
擲回錯誤清單: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 將為空白。validationOnly 為 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 做為轉換動作的唯一 ID。 |
conversionDateTime |
轉換發生的日期。必須晚於通話時間。必須指定時區。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」,例如「2019-01-01 12:32:45-08:00」。 |
conversionValue |
廣告客戶的轉換價值。 |
currencyCode |
與轉換價值相關聯的貨幣。這是 ISO 4217 3 字元的貨幣代碼。例如: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」。 |