Method: customers.uploadCallConversions

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

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

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

POST https://googleads.googleapis.com/v15/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)

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

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

नीचे दिए गए 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".