Method: advertisers.lineItems.duplicate

تكرار بند إعلاني تعرض هذه الطريقة رقم تعريف العنصر الذي تم إنشاؤه في حال نجاح العملية.

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

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

طلب HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/lineItems/{lineItemId}:duplicate

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

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

المعلمات
advertiserId

string (int64 format)

الحقل مطلوب. رقم تعريف المعلِن الذي ينتمي إليه هذا البند الإعلاني

lineItemId

string (int64 format)

الحقل مطلوب. رقم تعريف البند الإعلاني المطلوب نسخه

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON
{
  "targetDisplayName": string,
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
الحقول
targetDisplayName

string

الاسم المعروض للبند الإعلاني الجديد

يجب أن يكون بترميز UTF-8 وبحدّ أقصى 240 بايت.

containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

ما إذا كان هذا العنصر سيعرض إعلانات سياسية عن الاتحاد الأوروبي

إذا تم ضبط السمة containsEuPoliticalAds على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING في المعلِن الرئيسي، سيتم تخصيص القيمة DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING لهذا الحقل ما لم يتم تحديد غير ذلك. ويمكن بعد ذلك تعديل هذا الحقل باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات أو ملفات البيانات المنظَّمة.

يجب تحديد هذا الحقل عند إنشاء تفاصيل إعلان جديد. وإلا، سيتعذّر تنفيذ طلب advertisers.lineItems.create.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "duplicateLineItemId": string
}
الحقول
duplicateLineItemId

string (int64 format)

رقم تعريف البند الإعلاني الذي تم إنشاؤه

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

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

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

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