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.