Method: advertisers.lineItems.patch

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

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

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

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

طلب HTTP

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