لتعديل عناصر متعدّدة
لا يمكن تقديم الطلبات إلى نقطة النهاية هذه بالتزامن مع الطلبات التالية التي تعدِّل العنصر نفسه:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
لا يمكن إنشاء عناصر YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات.
طلب HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
advertiserId |
مطلوبة. رقم تعريف المعلن الذي ينتمي إليه هذا العنصر. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
الحقول | |
---|---|
lineItemIds[] |
مطلوبة. معرّفات العناصر المطلوب تحديثها. |
targetLineItem |
مطلوبة. يحتوي كائن العنصر على الحقول التي سيتم تعديلها والقيم الجديدة المطلوب تخصيصها لجميع العناصر المحدّدة في |
updateMask |
مطلوبة. قناع حقل يحدِّد الحقول المطلوب تعديلها. الحقول التالية فقط متاحة حاليًا: هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
نص الاستجابة
رسالة استجابة لـ LineItemService.BulkUpdateLineItems.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
الحقول | |
---|---|
updatedLineItemIds[] |
أرقام تعريف العناصر التي تم تعديلها بنجاح. |
failedLineItemIds[] |
أرقام تعريف العناصر التي تعذّر تعديلها. |
skippedLineItemIds[] |
أرقام تعريف العناصر التي يتم تخطّيها للحصول على التعديلات. على سبيل المثال، سيتم تخطّي عمليات التبديل غير الضرورية التي لن تؤدي إلى أي تغييرات في العناصر بفعالية ويمكن تتبُّع أرقام تعريف العناصر المقابلة هنا. |
errors[] |
الأخطاء الناتجة عن العناصر التي تعذّر تعديلها. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.