- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- CallConversion
- CallConversionResult
- جرِّبه الآن
معالجة إحالات ناجحة المكالمات المحددة.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadCallConversions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل الذي يُجري عملية التحميل |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"conversions": [
{
object ( |
الحقول | |
---|---|
conversions[] |
مطلوبة. الإحالات الناجحة التي يتم تحميلها. |
partialFailure |
مطلوبة. في حال ضبط هذه السياسة على "صحيح"، سيتم تنفيذ عمليات ناجحة، وستعرض العمليات غير الصالحة أخطاء. وفي حال اختيار القيمة "false"، سيتم تنفيذ جميع العمليات في معاملة واحدة فقط إذا كانت كلها صالحة. يجب ضبط هذه السياسة دائمًا على "صحيح". يمكنك الانتقال إلى 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 فارغًا للصفوف التي تتلقى خطأ. لا يتم عرض النتائج عندما تكون قيمة annotate Only صحيحة. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
CallConversion
إحالة ناجحة عبر الاتصال الهاتفي.
تمثيل JSON |
---|
{
"customVariables": [
{
object ( |
الحقول | |
---|---|
customVariables[] |
المتغيّرات المخصّصة المرتبطة بهذه الإحالة الناجحة. |
callerId |
رقم المتّصل الذي تم إجراء هذه المكالمة منه. من المتوقع أن يكون رقم تعريف المتصل بالتنسيق E.164 مع علامة "+" السابقة، على سبيل المثال، " +16502531234". |
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". |
conversionValue |
قيمة الإحالة الناجحة للمعلِن. |
currencyCode |
العملة المرتبطة بقيمة الإحالة الناجحة. هذا هو رمز العملة المكوّن من 3 أحرف بتنسيق ISO 4217. على سبيل المثال: SAR أو EUR. |
CallConversionResult
تحديد معلومات تحميل إحالة ناجحة عبر الاتصال الهاتفي الذي تمت معالجته بنجاح.
تمثيل 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". |