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.