Method: customers.customInterests.mutate

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

قائمة الأخطاء المُطروحة: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

طلب HTTP

POST https://googleads.googleapis.com/v16/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.

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

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