Method: customers.uploadCallConversions

दिए गए कॉल कन्वर्ज़न को प्रोसेस करता है.

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. अपलोड करने वाले ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
फ़ील्ड
conversions[]

object (CallConversion)

ज़रूरी है. अपलोड किए जा रहे कन्वर्ज़न.
partialFailure

boolean

ज़रूरी है. सही होने पर, सही तरीके से कार्रवाइयां की जाएंगी और अमान्य कार्रवाइयां करने पर गड़बड़ियां मिलेंगी. गलत होने पर, सभी कार्रवाइयां एक ही लेन-देन में पूरी की जाएंगी. ऐसा तब ही होगा, जब वे सभी मान्य हों. यह हमेशा सही पर सेट होना चाहिए. पेज लोड न हो पाने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures देखें.
validateOnly

boolean

सही होने पर, अनुरोध की पुष्टि की जाती है, लेकिन उसे पूरा नहीं किया जाता. सिर्फ़ गड़बड़ियां दिखती हैं, नतीजे नहीं.

जवाब का मुख्य भाग

ConversionUploadService.UploadCallConversions के लिए जवाब मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "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)

सही तरीके से प्रोसेस किए गए कन्वर्ज़न के लिए लौटाया गया. जिन पंक्तियों में गड़बड़ी मिली है उनके लिए प्रोटो खाली रहेगा. पुष्टि करने की सुविधा सही होने पर नतीजे नहीं दिखाए जाते.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

CallConversion

एक कॉल कन्वर्ज़न.

जेएसओएन के काेड में दिखाना 
{
  "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

वह कॉलर आईडी जिससे कॉल किया गया था. कॉलर आईडी, E.164 फ़ॉर्मैट में होना चाहिए. इस फ़ॉर्मैट में, '+' चिह्न से पहले का निशान होना चाहिए. जैसे, "+16502531234".
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".
conversionValue

number

विज्ञापन देने वाले के लिए कन्वर्ज़न की वैल्यू.
currencyCode

string

कन्वर्ज़न वैल्यू से जुड़ी मुद्रा. यह ISO 4217 का तीन वर्ण वाला मुद्रा कोड है. उदाहरण के लिए: USD, EUR.

CallConversionResult

सही तरीके से प्रोसेस किए गए CallconversionUpload की जानकारी की पहचान करना.

जेएसओएन के काेड में दिखाना 
{
  "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".