Method: advertisers.lineItems.duplicate

משכפל פריט. הפונקציה מחזירה את המזהה של הפריט שנוצר.

ה-API הזה לא מאפשר ליצור או לעדכן פריטים של YouTube והשותפים.

בשיטה הזו יש בדרך כלל זמן אחזור ארוך. כדי למנוע שגיאות, מומלץ להגדיל את זמן הקצוב לתפוגה שמוגדר כברירת מחדל.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
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. אחר כך אפשר לעדכן את השדה הזה באמצעות ממשק המשתמש, ה-API או קבצים של נתונים מובנים.

צריך להקצות את השדה הזה כשיוצרים פריט חדש. אחרת, בקשת ה-advertisers.lineItems.create תיכשל.

גוף התשובה

אם הפעולה בוצעה בהצלחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "duplicateLineItemId": string
}
שדות
duplicateLineItemId

string (int64 format)

המזהה של הפריט שנוצר.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.