REST Resource: advertisers.adGroupAds

{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}

string

שם המשאב של המודעה.

string (int64 format)

המזהה הייחודי של המפרסם שאליו המודעה שייכת.

string (int64 format)

המזהה הייחודי של המודעה. הוקצתה על ידי המערכת.

string (int64 format)

המזהה הייחודי של קבוצת המודעות שאליה המודעה שייכת.

string

השם המוצג של המודעה.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 255 בייטים.

enum (EntityStatus)

סטטוס הישות של המודעה.

object (AdUrl)

רשימת כתובות URL שבהן המודעה משתמשת.

object (DisplayVideoSourceAd)

פרטים על מודעה שמקורה ברשת המדיה קריאייטיב של וידאו 360.

object (MastheadAd)

פרטים על מודעה שמוצגת בפיד הבית של YouTube.

object (InStreamAd)

פרטים על מודעת וידאו In-stream שניתן לדלג עליה אחרי 5 שניות, שמשמשת להגברת המוּדעוּת למותג או להשגת יעדים שיווקיים.

object (NonSkippableAd)

פרטים על מודעת וידאו In-stream קצרה שלא ניתן לדלג עליה, באורך של 6 עד 15 שניות, שמשמשת להשגת יעדים שיווקיים.

object (BumperAd)

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

object (AudioAd)

פרטים על מודעת אודיו שמשמשת להשגת יעדים שיווקיים.

object (VideoDiscoveryAd)

פרטים על מודעה שמקדמת סרטון שמוצגת במקומות שבהם משתמשים מחפשים ומגלים דברים חדשים.

object (VideoPerformanceAd)

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

{
  "creativeId": string
}

string (int64 format)

המזהה של קריאייטיב המקור.

{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}

object (YoutubeVideoDetails)

הסרטון ב-YouTube שבו המודעה מוצגת.

string

הכותרת של המודעה.

string

התיאור של המודעה.

enum (VideoAspectRatio)

יחס הגובה-רוחב של סרטון YouTube שמופעל באופן אוטומטי במודעה מסוג Masthead.

string (int64 format)

משך הזמן באלפיות השנייה שאחריו הסרטון יתחיל לפעול.

string (Duration format)

משך הזמן שבו הסרטון יופעל באופן אוטומטי.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

string

הטקסט בלחצן הקריאה לפעולה.

string

כתובת היעד של לחצן הקריאה לפעולה.

string

כתובת ה-URL למעקב של לחצן הקריאה לפעולה.

boolean

האם להציג רקע או באנר שמופיעים בחלק העליון של דף YouTube.

object (YoutubeVideoDetails)

הסרטונים שמופיעים לצד המודעה מסוג Masthead במחשב. לא יותר משתיים.

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

מזהה הסרטון ב-YouTube שניתן לחפש בדף האינטרנט של YouTube.

enum (VideoUnavailableReason)

הסיבה לכך שאין נתוני סרטון זמינים.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

מאפיינים נפוצים של מודעות.

map (key: string, value: string)

הפרמטרים המותאמים אישית שיעבירו ערכים מותאמים אישית לתבנית של כתובת ה-URL למעקב.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

כתובת דף האינטרנט שמופיעה במודעה.

string

כתובת ה-URL של הדף שאנשים מגיעים אליו אחרי שהם לוחצים על המודעה.

string

כתובת ה-URL נטענת ברקע למטרות מעקב.

string

הטקסט בלחצן הקריאה לפעולה.

string

הכותרת של באנר הקריאה לפעולה.

object (YoutubeVideoDetails)

הסרטון ב-YouTube שבו מוצגת המודעה.

object (ImageAsset)

התמונה שמוצגת לצד מודעת הווידאו.

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

סוג ה-MIME של נכס התמונות.

object (Dimensions)

מטא-נתונים של התמונה הזו בגודל המקורי שלה.

string (int64 format)

גודל הקובץ של נכס התמונות בבייטים.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

מאפיינים נפוצים של מודעות.

map (key: string, value: string)

הפרמטרים המותאמים אישית שיעבירו ערכים מותאמים אישית לתבנית של כתובת ה-URL למעקב.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}

object (CommonInStreamAttribute)

מאפיינים נפוצים של מודעות.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

כתובת דף האינטרנט שמופיעה במודעה.

string

כתובת ה-URL של הדף שאנשים מגיעים אליו אחרי שהם לוחצים על המודעה.

string

כתובת ה-URL נטענת ברקע למטרות מעקב.

object (YoutubeVideoDetails)

הסרטון ב-YouTube שבו מוצגת המודעה.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

הכותרת של המודעה.

string

שורת הטקסט הראשונה של המודעה.

string

שורת הטקסט השנייה של המודעה.

object (YoutubeVideoDetails)

הסרטון ב-YouTube שהמודעה מקדמת.

enum (Thumbnail)

תמונה ממוזערת שנעשה בה שימוש במודעה.

{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}

string

כתובת ה-URL של הדף שאנשים מגיעים אליו אחרי שהם לוחצים על המודעה.

string

כתובת ה-URL נטענת ברקע למטרות מעקב.

string

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

string

רשימת הכותרות שמוצגת בבאנר הקריאה לפעולה.

string

רשימת הכותרות הבודדות שמוצגת בבאנר הקריאה לפעולה.

string

רשימת התיאורים שמוצגת בבאנר הקריאה לפעולה.

string

החלק הראשון אחרי הדומיין בכתובת ה-URL לתצוגה.

string

החלק השני אחרי הדומיין בכתובת ה-URL לתצוגה.

string

הדומיין של כתובת ה-URL לתצוגה.

object (YoutubeVideoDetails)

רשימת נכסי וידאו ב-YouTube שנעשה בהם שימוש במודעה הזו.

map (key: string, value: string)

הפרמטרים המותאמים אישית שיעבירו ערכים מותאמים אישית לתבנית של כתובת ה-URL למעקב.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

object (ImageAsset)

רשימת מודעות הבאנר הנלוות שבהן נעשה שימוש במודעה הזו.

{
  "type": enum (AdUrlType),
  "url": string
}

enum (AdUrlType)

הסוג של כתובת ה-URL של המודעה.

string

ערך המחרוזת של כתובת ה-URL.