Method: advertisers.lineItems.duplicate

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

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

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

طلب HTTP

POST https://displayvideo.googleapis.com/v4/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.