Method: customers.customerLifecycleGoal.configureCustomerLifecycleGoals

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

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

طلب HTTP

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

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

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

المعلمات
customerId

string

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

نص الطلب

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

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

object (CustomerLifecycleGoalOperation)

مطلوب. العملية التي تُجري تعديلاً على هدف مراحل نشاط العملاء.

validateOnly

boolean

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

نص الاستجابة

رسالة الردّ على [CustomerLifecycleGoalService.configureCustomerLifecycleGoals][].

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

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

object (ConfigureCustomerLifecycleGoalsResult)

نتيجة لإعداد هدف مرحلة نشاط العميل.

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

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)

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

هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"

حقل الربط operation عملية التحويل يمكن أن يكون operation واحدًا فقط مما يلي:
create

object (CustomerLifecycleGoal)

عملية الإنشاء: إنشاء هدف جديد لمراحل نشاط العميل

update

object (CustomerLifecycleGoal)

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

ConfigureCustomerLifecycleGoalsResult

نتيجة إعداد هدف مراحل نشاط العميل.

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

string

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