Method: advertisers.lineItems.patch

تعديلات على بند إعلاني حالي تعرض هذه الطريقة البند الإعلاني المعدَّل في حال نجاحها.

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

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

تتسم هذه الطريقة عادةً بوقت استجابة طويل. ننصحك بزيادة المهلة التلقائية لتجنُّب الأخطاء.

طلب HTTP

PATCH https://displayvideo.googleapis.com/v5/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}

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

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

المعلمات
lineItem.advertiserId

string (int64 format)

للعرض فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه البند الإعلاني
lineItem.lineItemId

string (int64 format)

للعرض فقط. المعرّف الفريد للبند الإعلاني. يتم تخصيصه من قِبل النظام.

مَعلمات طلب البحث

المعلمات
updateMask

string (FieldMask format)

الحقل مطلوب. القناع الذي يتحكّم في الحقول التي سيتم تعديلها.

هذه قائمة بأسماء الحقول المؤهَّلة بالكامل، وتكون مفصولة بفواصل. مثال: "user.displayName,photo"

نص الطلب

يحتوي نص الطلب على مثال LineItem.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال LineItem.

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

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

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

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