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 Overview.