Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

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

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

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

طلب HTTP

POST https://displayvideo.googleapis.com/v5/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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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.