Method: customers.customInterests.mutate

إنشاء اهتمامات مخصّصة أو تعديلها يتم عرض حالات العمليات.

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

طلب HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/customInterests:mutate

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

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

المعلمات
customerId

string

مطلوب. رقم تعريف العميل الذي يتم تعديل اهتماماته المخصّصة.

نص الطلب

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

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

object (CustomInterestOperation)

مطلوب. قائمة العمليات التي يجب تنفيذها على الاهتمامات المخصّصة الفردية
validateOnly

boolean

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

نص الاستجابة

رسالة الردّ على تغيير الاهتمام المخصّص

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

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

object (MutateCustomInterestResult)

جميع نتائج التحويل

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

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

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

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

CustomInterestOperation

عملية واحدة (إنشاء أو تعديل) على اهتمام مخصّص

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

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

string (FieldMask format)

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

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

object (CustomInterest)

عملية الإنشاء: لا يُتوقّع ظهور اسم مورد للاهتمام المخصّص الجديد.
update

object (CustomInterest)

عملية التعديل: من المتوقّع أن يكون للاهتمام المخصّص اسم مورد صالح.

MutateCustomInterestResult

تتغيّر نتيجة الاهتمام المخصّص.

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

string

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