Method: customers.userListCustomerTypes.mutate

إرفاق أنواع قوائم العملاء أو إزالتها يتم عرض حالات العملية.

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

طلب HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/userListCustomerTypes:mutate

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

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

المعلمات
customerId

string

مطلوبة. رقم تعريف العميل الذي يتم تعديل أنواع عملاء قائمة المستخدمين لديه.

نص الطلب

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

تمثيل JSON 
{
  "operations": [
    {
      object (UserListCustomerTypeOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
الحقول
operations[]

object (UserListCustomerTypeOperation)

مطلوبة. قائمة العمليات التي يتم إجراؤها على أنواع العملاء في قائمة المستخدمين.
partialFailure

boolean

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

boolean

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

نص الاستجابة

رسالة ردّ على نوع العميل في قائمة المستخدمين mutate.

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

تمثيل JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateUserListCustomerTypeResult)
    }
  ]
}
الحقول
partialFailureError

object (Status)

الأخطاء التي تتعلق بفشل التشغيل في وضع الفشل الجزئي. يُعرَض فقط عندما تكون نسبة التعذُّر الجزئي = true وتحدث جميع الأخطاء داخل العمليات. في حال حدوث أي أخطاء خارج العمليات (مثل أخطاء المصادقة)، سنعرض خطأ على مستوى استدعاء إجراء عن بُعد (RPC).
results[]

object (MutateUserListCustomerTypeResult)

جميع نتائج التغيير.

نطاقات الأذونات

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

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

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

UserListCustomerTypeOperation

عملية تغيير واحدة على نوع عميل قائمة المستخدمين.

تمثيل JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserListCustomerType)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
الحقول
حقل الاتحاد operation. عملية التبديل. يمكن أن يكون operation واحدًا فقط مما يلي:
create

object (UserListCustomerType)

أرفِق نوع عميل قائمة المستخدمين بقائمة مستخدمين. لا يُتوقَّع اسم مورد لنوع قائمة العملاء الجديدة.
remove

string

إزالة نوع حالي لعميل قائمة مستخدمين يُتوقَّع اسم مورد لنوع عميل قائمة المستخدمين التي تمت إزالتها بالتنسيق التالي:

customers/{customerId}/userListCustomerTypes/{userListId}~{customerTypeCategory}

MutateUserListCustomerTypeResult

نتيجة نوع العميل في قائمة المستخدمين mutate.

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

string

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