Method: customers.adGroupAssetSets.mutate

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

طلب HTTP

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

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

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

المعلمات
customerId

string

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

نص الطلب

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

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

object (AdGroupAssetSetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

إعداد نوع محتوى الردّ لتحديد ما إذا كان يجب إرجاع المورد القابل للتغيير أو اسم المورد فقط بعد إجراء عملية التحويل.

نص الاستجابة

رسالة الردّ بشأن عملية التغيير في مجموعة مواد عرض على مستوى مجموعة إعلانية

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

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

object (MutateAdGroupAssetSetResult)

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

object (Status)

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

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

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

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

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

AdGroupAssetSetOperation

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

تمثيل JSON 
{

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

object (AdGroupAssetSet)

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

string

عملية الإزالة: من المتوقّع أن يتضمّن اسم المورد لمجموعة مواد عرض المجموعة الإعلانية التي تمّت إزالتها، وذلك بالشكل التالي: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

تتغيّر نتيجة مجموعة مواد عرض المجموعة الإعلانية.

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

string

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

object (AdGroupAssetSet)

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