Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

يتوفّر الإصدار 5 من Display & Video 360 API حاليًا في مرحلة تجريبية.

• طلب HTTP
• مَعلمات المسار
• نص الطلب
  • تمثيل JSON
• نص الاستجابة
  • تمثيل JSON
• نطاقات الأذونات
• جرِّبه الآن

تعديلات مجمّعة لخيارات الاستهداف ضمن تفاصيل إعلانات متعددة ستؤدي هذه العملية إلى حذف خيارات الاستهداف المحدّدة المقدَّمة في BulkEditAssignedTargetingOptionsRequest.delete_requests، ثم إنشاء خيارات الاستهداف المحدّدة المقدَّمة في BulkEditAssignedTargetingOptionsRequest.create_requests.

لا يمكن إرسال طلبات إلى نقطة النهاية هذه بالتزامن مع الطلبات التالية التي تعدّل العنصر نفسه:

• lineItems.bulkUpdate
• lineItems.patch
• assignedTargetingOptions.create
• assignedTargetingOptions.delete

لا يمكن إنشاء بنود إعلانية على YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات.

طلب HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions

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

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

المعلمات
advertiserId	string (int64 format) الحقل مطلوب. رقم تعريف المعلِن الذي تنتمي إليه البنود الإعلانية

نص الطلب

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

تمثيل JSON
{ "lineItemIds": [ string ], "deleteRequests": [ { object (DeleteAssignedTargetingOptionsRequest) } ], "createRequests": [ { object (CreateAssignedTargetingOptionsRequest) } ] }

الحقول
lineItemIds[]	string (int64 format) الحقل مطلوب. رقم تعريف البنود الإعلانية التي يتم تعديل استهدافها
deleteRequests[]	object (DeleteAssignedTargetingOptionsRequest) خيارات الاستهداف المحدّدة التي تريد حذفها بشكل مجمّع، والمحدّدة كقائمة من DeleteAssignedTargetingOptionsRequest. تشمل أنواع الاستهداف المتوافقة ما يلي: TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_APP TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AUCTION_PACKAGE TARGETING_TYPE_AUDIENCE_GROUP TARGETING_TYPE_AUDIO_CONTENT_TYPE TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_BROWSER TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_CATEGORY TARGETING_TYPE_CHANNEL TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_CONTENT_STREAM_TYPE TARGETING_TYPE_DAY_AND_TIME TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_EXCHANGE TARGETING_TYPE_GENDER TARGETING_TYPE_GEO_REGION TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_INVENTORY_SOURCE_DEAL TARGETING_TYPE_INVENTORY_SOURCE_GROUP TARGETING_TYPE_KEYWORD TARGETING_TYPE_LANGUAGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_NEGATIVE_KEYWORD_LIST TARGETING_TYPE_OMID TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_POI TARGETING_TYPE_PROXIMITY_LOCATION_LIST TARGETING_TYPE_REGIONAL_LOCATION_LIST TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_THIRD_PARTY_VERIFIER TARGETING_TYPE_URL TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_TYPE_VIEWABILITY
createRequests[]	object (CreateAssignedTargetingOptionsRequest) خيارات الاستهداف المحدّدة المطلوب إنشاؤها بشكل مجمّع، والمحدّدة كقائمة من CreateAssignedTargetingOptionsRequest. تشمل أنواع الاستهداف المتوافقة ما يلي: TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_APP TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AUCTION_PACKAGE TARGETING_TYPE_AUDIENCE_GROUP TARGETING_TYPE_AUDIO_CONTENT_TYPE TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_BROWSER TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_CATEGORY TARGETING_TYPE_CHANNEL TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_CONTENT_STREAM_TYPE TARGETING_TYPE_DAY_AND_TIME TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_EXCHANGE TARGETING_TYPE_GENDER TARGETING_TYPE_GEO_REGION TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_INVENTORY_SOURCE_DEAL TARGETING_TYPE_INVENTORY_SOURCE_GROUP TARGETING_TYPE_KEYWORD TARGETING_TYPE_LANGUAGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_NEGATIVE_KEYWORD_LIST TARGETING_TYPE_OMID TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_POI TARGETING_TYPE_PROXIMITY_LOCATION_LIST TARGETING_TYPE_REGIONAL_LOCATION_LIST TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_THIRD_PARTY_VERIFIER TARGETING_TYPE_URL TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_TYPE_VIEWABILITY

نص الاستجابة

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

تمثيل JSON
{ "updatedLineItemIds": [ string ], "failedLineItemIds": [ string ], "errors": [ { object (Status) } ] }

الحقول
updatedLineItemIds[]	string (int64 format) للعرض فقط. أرقام تعريف العناصر التي تم تعديلها بنجاح
failedLineItemIds[]	string (int64 format) للعرض فقط. أرقام تعريف البنود الإعلانية التي تعذّر تنفيذها
errors[]	object (Status) معلومات الخطأ لكل بند إعلاني تعذّر تعديله

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

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

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

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