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.