Method: customers.customerLifecycleGoal.configureCustomerLifecycleGoals

معالجة إعدادات مراحل نشاط العميل المحدّدة

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError CustomerLifecycleGoalConfigError HeaderError InternalError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerLifecycleGoal:configureCustomerLifecycleGoals

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل الذي يُجري عملية التحميل

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "operation": {
    object (CustomerLifecycleGoalOperation)
  },
  "validateOnly": boolean
}
الحقول
operation

object (CustomerLifecycleGoalOperation)

مطلوبة. عملية تعديل هدف مراحل نشاط العميل
validateOnly

boolean

اختياريّ. إذا كانت القيمة true، يتم التحقق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج.

نص الاستجابة

رسالة الرد لـ [CustomerLifecycleGoalService.configureCustomerCustomerLifeGoals][].

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "result": {
    object (ConfigureCustomerLifecycleGoalsResult)
  }
}
الحقول
result

object (ConfigureCustomerLifecycleGoalsResult)

النهائية لتهيئة هدف دورة حياة العميل.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

CustomerLifecycleGoalOperation

عملية واحدة على هدف دورة حياة العميل.

تمثيل JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomerLifecycleGoal)
  }
  // End of list of possible types for union field operation.
}
الحقول
updateMask

string (FieldMask format)

اختياريّ. قناع FieldMask الذي يحدد حقول الموارد التي يتم تعديلها في التحديث.

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
حقل الاتحاد operation عملية التبديل. يمكن أن تكون السمة "operation" واحدة فقط مما يلي:
create

object (CustomerLifecycleGoal)

إنشاء عملية: لإنشاء هدف جديد لمراحل نشاط عميل أو تعديل هدف حالي لدورة حياة عميل عند إنشاء هدف لدورة حياة عميل جديد، يجب ضبط جميع الحقول المطلوبة. يجب أن يكون اسم المورد وقناع الحقل فارغَين. عند تعديل هدف دورة حياة عميل حالي، يجب ضبط اسم المورد وقناع الحقل. يُتاح التعديل الجزئي استنادًا إلى قناع الحقل عند تعديل هدف حالي للعميل خلال مراحل نشاطه

ConfigureCustomerLifecycleGoalsResult

نتيجة ضبط هدف دورة حياة العميل.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

تم إرجاعه للعملية الناجحة.