Method: advertisers.lineItems.duplicate

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

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

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

בקשת HTTP

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