Method: customers.customerLifecycleGoal.configureCustomerLifecycleGoals

معالجة تكوينات مراحل نشاط العميل المحددة

قائمة الأخطاء المعروضة: AuthenticationError AuthorizationError CustomerLifecycleGoalConfigError HeaderError InternalError QuotaError RequestError

طلب HTTP

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

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

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

المَعلمات
customerId

string

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

نص الطلب

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

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

object (CustomerLifecycleGoalOperation)

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

boolean

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

نص الاستجابة

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

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

تمثيل 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)
  },
  "update": {
    object (CustomerLifecycleGoal)
  }
  // End of list of possible types for union field operation.
}
الحقول
updateMask

string (FieldMask format)

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

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

object (CustomerLifecycleGoal)

إنشاء العملية: أنشئ هدف دورة حياة عميل جديد.
update

object (CustomerLifecycleGoal)

تعديل العملية: عدِّل هدف مراحل نشاط العملاء الحاليين.

ConfigureCustomerLifecycleGoalsResult

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

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

string

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