Method: customers.uploadCallConversions

指定された通話コンバージョンを処理します。

スローされるエラーのリスト: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。アップロードを行う顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
フィールド
conversions[]

object (CallConversion)

必須。アップロード中のコンバージョン。
partialFailure

boolean

必須。true の場合、成功したオペレーションが実行され、無効なオペレーションはエラーを返します。false の場合、すべてのオペレーションが有効な場合にのみ、1 つのトランザクションで実行されます。これは常に 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 は空になります。validateOnly が 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

コンバージョン値に関連付けられた通貨。3 文字の ISO 4217 通貨コードです。例: USD、EUR。

CallConversionResult

正常に処理された CallConversionUpload の識別情報。

JSON 表現 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
フィールド
callerId

string

この通話の発信元 ID。発信者番号は 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）。