Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

تعديل خيارات الاستهداف بشكل مجمّع لعدة مجموعات إعلانية

سيتم تطبيق المجموعة نفسها من طلبات الحذف والإنشاء على جميع المجموعات الإعلانية المحدّدة. على وجه التحديد، ستؤدي العملية إلى حذف خيارات الاستهداف المُسنَدة المقدَّمة في BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests من كل مجموعة إعلانية، ثم إنشاء خيارات الاستهداف المُسنَدة المقدَّمة في BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

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

طلب HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

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

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

المعلمات
advertiserId

string (int64 format)

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
الحقول
adGroupIds[]

string (int64 format)

الحقل مطلوب. أرقام تعريف المجموعات الإعلانية التي ستنتمي إليها خيارات الاستهداف المُسنَدة يمكن تحديد 25 رقم تعريف كحد أقصى للمجموعة الإعلانية.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

اختياريّ. خيارات الاستهداف المُسنَدة التي سيتم حذفها بشكل مجمّع، والمحدّدة كقائمة من DeleteAssignedTargetingOptionsRequest

أنواع الاستهداف المتوافقة:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

اختياريّ. خيارات الاستهداف المُسنَدة التي سيتم إنشاؤها بشكل مجمّع، والمحدّدة كقائمة من CreateAssignedTargetingOptionRequest

أنواع الاستهداف المتوافقة:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

نص الاستجابة

رسالة الاستجابة لطلب adGroups.bulkEditAssignedTargetingOptions

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

تمثيل JSON 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
الحقول
updatedAdGroupIds[]

string (int64 format)

نتائج فقط. أرقام تعريف المجموعات الإعلانية التي تم تعديلها بنجاح
failedAdGroupIds[]

string (int64 format)

نتائج فقط. أرقام تعريف المجموعات الإعلانية التي تعذّر تعديلها
errors[]

object (Status)

نتائج فقط. معلومات الخطأ لكل مجموعة إعلانية تعذّر تعديلها

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

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

  • https://www.googleapis.com/auth/display-video

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