Method: advertisers.lineItems.patch

تعديل سلعة حالية تعرِض هذه الدالة العنصر المعدَّل في حال نجاح العملية.

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

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

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

طلب HTTP

PATCH https://displayvideo.googleapis.com/v3/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.