Method: customers.customerAssetSets.mutate

إنشاء مجموعات مواد عرض العملاء أو إزالتها يتم عرض حالات العملية.

طلب HTTP

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

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

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

المعلمات
customerId

string

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

نص الطلب

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

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

object (CustomerAssetSetOperation)

مطلوبة. قائمة العمليات التي سيتم تنفيذها على مجموعات مواد العرض الفردية للعملاء.
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

خيار "نوع محتوى الردّ": يحدِّد هذا الإعداد ما إذا كان يجب عرض المورد القابل للتغيير أو اسم المورد فقط بعد التغيير.

نص الاستجابة

رسالة ردّ بشأن عملية التبديل الخاصة بمجموعة مواد عرض العميل.

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

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

object (MutateCustomerAssetSetResult)

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

object (Status)

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

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

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

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

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

CustomerAssetSetOperation

عملية واحدة (إنشاء أو إزالة) على مجموعة مواد عرض العميل.

تمثيل JSON 
{

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

object (CustomerAssetSet)

عملية الإنشاء: لا يُتوقَّع اسم مورد لمجموعة مواد العرض للعملاء الجدد.
remove

string

عملية الإزالة: يُتوقَّع اسم مورد لمجموعة مواد عرض العميل التي تمت إزالتها، بالتنسيق التالي: customers/{customerId}/customerAssetSets/{asset_set_id}.

MutateCustomerAssetSetResult

نتيجة دالة mutate لمجموعة مواد العرض للعميل.

تمثيل JSON 
{
  "resourceName": string,
  "customerAssetSet": {
    object (CustomerAssetSet)
  }
}
الحقول
resourceName

string

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

object (CustomerAssetSet)

مجموعة مواد عرض العميل التي تم تبديلها وتحتوي على حقول قابلة للتغيير فقط بعد عملية التبديل. لن يتم عرض الحقل إلا عند ضبط responseContentType على "MUTABLE_ري".