Method: customers.customInterests.mutate

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

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

طلب HTTP

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

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

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

المعلمات
customerId

string

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

نص الطلب

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

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

object (CustomInterestOperation)

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

boolean

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

نص الاستجابة

رسالة ردّ بشأن تغيير الاهتمامات المخصّصة.

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

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

object (MutateCustomInterestResult)

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

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

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

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

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

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)

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

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

object (CustomInterest)

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

object (CustomInterest)

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

MutateCustomInterestResult

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

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

string

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